/usr/share/doc/libgcrypt20-doc/html/Comparisons.html is in libgcrypt20-doc 1.6.5-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 | <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- This manual is for Libgcrypt
(version 1.6.5, 9 February 2016),
which is GNU's library of cryptographic building blocks.
Copyright (C) 2000, 2002, 2003, 2004, 2006, 2007, 2008, 2009, 2011, 2012 Free Software Foundation, Inc.
Copyright (C) 2012, 2013 g10 Code GmbH
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU General Public License as published by the
Free Software Foundation; either version 2 of the License, or (at your
option) any later version. The text of the license can be found in the
section entitled "GNU General Public License". -->
<!-- Created by GNU Texinfo 6.0, http://www.gnu.org/software/texinfo/ -->
<head>
<title>The Libgcrypt Reference Manual: Comparisons</title>
<meta name="description" content="The Libgcrypt Reference Manual: Comparisons">
<meta name="keywords" content="The Libgcrypt Reference Manual: Comparisons">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link href="index.html#Top" rel="start" title="Top">
<link href="Concept-Index.html#Concept-Index" rel="index" title="Concept Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="MPI-library.html#MPI-library" rel="up" title="MPI library">
<link href="Bit-manipulations.html#Bit-manipulations" rel="next" title="Bit manipulations">
<link href="Calculations.html#Calculations" rel="prev" title="Calculations">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smalllisp {margin-left: 3.2em}
kbd {font-style: oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nocodebreak {white-space: nowrap}
span.nolinebreak {white-space: nowrap}
span.roman {font-family: serif; font-weight: normal}
span.sansserif {font-family: sans-serif; font-weight: normal}
ul.no-bullet {list-style: none}
-->
</style>
</head>
<body lang="en">
<a name="Comparisons"></a>
<div class="header">
<p>
Next: <a href="Bit-manipulations.html#Bit-manipulations" accesskey="n" rel="next">Bit manipulations</a>, Previous: <a href="Calculations.html#Calculations" accesskey="p" rel="prev">Calculations</a>, Up: <a href="MPI-library.html#MPI-library" accesskey="u" rel="up">MPI library</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Concept-Index.html#Concept-Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="Comparisons-1"></a>
<h3 class="section">12.5 Comparisons</h3>
<p>The next 2 functions are used to compare MPIs:
</p>
<dl>
<dt><a name="index-gcry_005fmpi_005fcmp"></a>Function: <em>int</em> <strong>gcry_mpi_cmp</strong> <em>(const <span class="nolinebreak">gcry_mpi_t</span> <var>u</var><!-- /@w -->, const <span class="nolinebreak">gcry_mpi_t</span> <var>v</var><!-- /@w -->)</em></dt>
<dd>
<p>Compare the multi-precision-integers number <var>u</var> and <var>v</var>
returning 0 for equality, a positive value for <var>u</var> > <var>v</var> and a
negative for <var>u</var> < <var>v</var>. If both numbers are opaque values
(cf, gcry_mpi_set_opaque) the comparison is done by checking the bit
sizes using memcmp. If only one number is an opaque value, the opaque
value is less than the other number.
</p></dd></dl>
<dl>
<dt><a name="index-gcry_005fmpi_005fcmp_005fui"></a>Function: <em>int</em> <strong>gcry_mpi_cmp_ui</strong> <em>(const <span class="nolinebreak">gcry_mpi_t</span> <var>u</var><!-- /@w -->, unsigned long <var>v</var><!-- /@w -->)</em></dt>
<dd>
<p>Compare the multi-precision-integers number <var>u</var> with the unsigned
integer <var>v</var> returning 0 for equality, a positive value for <var>u</var> >
<var>v</var> and a negative for <var>u</var> < <var>v</var>.
</p></dd></dl>
<dl>
<dt><a name="index-gcry_005fmpi_005fis_005fneg"></a>Function: <em>int</em> <strong>gcry_mpi_is_neg</strong> <em>(const <span class="nolinebreak">gcry_mpi_t</span> <var>a</var><!-- /@w -->)</em></dt>
<dd>
<p>Return 1 if <var>a</var> is less than zero; return 0 if zero or positive.
</p></dd></dl>
</body>
</html>
|