summaryrefslogtreecommitdiff
path: root/lib/libcrypto/man/BN_cmp.3
blob: b0a03b25ced6c4b8d4b686d2222b9c88e286df2f (plain)
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
.Dd $Mdocdate: February 23 2015 $
.Dt BN_CMP 3
.Os
.Sh NAME
.Nm BN_cmp ,
.Nm BN_ucmp ,
.Nm BN_is_zero ,
.Nm BN_is_one ,
.Nm BN_is_word ,
.Nm BN_is_odd
.Nd BIGNUM comparison and test functions
.Sh SYNOPSIS
.In openssl/bn.h
.Ft int
.Fo BN_cmp
.Fa "BIGNUM *a"
.Fa "BIGNUM *b"
.Fc
.Ft int
.Fo BN_ucmp
.Fa "BIGNUM *a"
.Fa "BIGNUM *b"
.Fc
.Ft int
.Fo BN_is_zero
.Fa "BIGNUM *a"
.Fc
.Ft int
.Fo BN_is_one
.Fa "BIGNUM *a"
.Fc
.Ft int
.Fo BN_is_word
.Fa "BIGNUM *a"
.Fa "BN_ULONG w"
.Fc
.Ft int
.Fo BN_is_odd
.Fa "BIGNUM *a"
.Fc
.Sh DESCRIPTION
.Fn BN_cmp
compares the numbers
.Fa a
and
.Fa b .
.Fn BN_ucmp
compares their absolute values.
.Pp
.Fn BN_is_zero ,
.Fn BN_is_one
and
.Fn BN_is_word
test if
.Fa a
equals 0, 1, or
.Fa w
respectively.
.Fn BN_is_odd
tests if a is odd.
.Pp
.Fn BN_is_zero ,
.Fn BN_is_one ,
.Fn BN_is_word ,
and
.Fn BN_is_odd
are macros.
.Sh RETURN VALUES
.Fn BN_cmp
returns -1 if
.Fa a Ns < Ns Fa b ,
0 if
.Fa a Ns == Ns Fa b ,
and 1 if
.Fa a Ns > Ns Fa b .
.Fn BN_ucmp
is the same using the absolute values of
.Fa a
and
.Fa b .
.Pp
.Fn BN_is_zero ,
.Fn BN_is_one ,
.Fn BN_is_word ,
and
.Fn BN_is_odd
return 1 if the condition is true, 0 otherwise.
.Sh SEE ALSO
.Xr bn 3
.Sh HISTORY
.Fn BN_cmp ,
.Fn BN_ucmp ,
.Fn BN_is_zero ,
.Fn BN_is_one
and
.Fn BN_is_word
are available in all versions of SSLeay and OpenSSL.
.Fn BN_is_odd
was added in SSLeay 0.8.