summaryrefslogtreecommitdiff
path: root/src/lib/libcrypto/man/ASN1_INTEGER_get.3
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--src/lib/libcrypto/man/ASN1_INTEGER_get.341
1 files changed, 6 insertions, 35 deletions
diff --git a/src/lib/libcrypto/man/ASN1_INTEGER_get.3 b/src/lib/libcrypto/man/ASN1_INTEGER_get.3
index 1ed993efa6..df5a3bc821 100644
--- a/src/lib/libcrypto/man/ASN1_INTEGER_get.3
+++ b/src/lib/libcrypto/man/ASN1_INTEGER_get.3
@@ -1,11 +1,11 @@
1.\" $OpenBSD: ASN1_INTEGER_get.3,v 1.4 2021/11/20 13:06:26 schwarze Exp $ 1.\" $OpenBSD: ASN1_INTEGER_get.3,v 1.5 2021/11/23 13:52:27 schwarze Exp $
2.\" selective merge up to: 2.\" selective merge up to:
3.\" OpenSSL man3/ASN1_INTEGER_get_int64 df75c2bf Dec 9 01:02:36 2018 +0100 3.\" OpenSSL man3/ASN1_INTEGER_get_int64 24a535ea Sep 22 13:14:20 2020 +0100
4.\" 4.\"
5.\" This file is a derived work. 5.\" This file is a derived work.
6.\" The changes are covered by the following Copyright and license: 6.\" The changes are covered by the following Copyright and license:
7.\" 7.\"
8.\" Copyright (c) 2018, 2019, 2021 Ingo Schwarze <schwarze@openbsd.org> 8.\" Copyright (c) 2018, 2021 Ingo Schwarze <schwarze@openbsd.org>
9.\" 9.\"
10.\" Permission to use, copy, modify, and distribute this software for any 10.\" Permission to use, copy, modify, and distribute this software for any
11.\" purpose with or without fee is hereby granted, provided that the above 11.\" purpose with or without fee is hereby granted, provided that the above
@@ -66,7 +66,7 @@
66.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED 66.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
67.\" OF THE POSSIBILITY OF SUCH DAMAGE. 67.\" OF THE POSSIBILITY OF SUCH DAMAGE.
68.\" 68.\"
69.Dd $Mdocdate: November 20 2021 $ 69.Dd $Mdocdate: November 23 2021 $
70.Dt ASN1_INTEGER_GET 3 70.Dt ASN1_INTEGER_GET 3
71.Os 71.Os
72.Sh NAME 72.Sh NAME
@@ -76,7 +76,6 @@
76.Nm ASN1_INTEGER_dup , 76.Nm ASN1_INTEGER_dup ,
77.Nm BN_to_ASN1_INTEGER , 77.Nm BN_to_ASN1_INTEGER ,
78.Nm ASN1_INTEGER_to_BN , 78.Nm ASN1_INTEGER_to_BN ,
79.Nm i2a_ASN1_INTEGER ,
80.Nm ASN1_ENUMERATED_get , 79.Nm ASN1_ENUMERATED_get ,
81.Nm ASN1_ENUMERATED_set , 80.Nm ASN1_ENUMERATED_set ,
82.Nm BN_to_ASN1_ENUMERATED , 81.Nm BN_to_ASN1_ENUMERATED ,
@@ -112,11 +111,6 @@
112.Fa "const ASN1_INTEGER *ai" 111.Fa "const ASN1_INTEGER *ai"
113.Fa "BIGNUM *bn" 112.Fa "BIGNUM *bn"
114.Fc 113.Fc
115.Ft int
116.Fo i2a_ASN1_INTEGER
117.Fa "BIO *out_bio"
118.Fa "const ASN1_INTEGER *a"
119.Fc
120.Ft long 114.Ft long
121.Fo ASN1_ENUMERATED_get 115.Fo ASN1_ENUMERATED_get
122.Fa "const ASN1_ENUMERATED *a" 116.Fa "const ASN1_ENUMERATED *a"
@@ -212,16 +206,6 @@ Otherwise, the existing object
212.Fa bn 206.Fa bn
213is used instead. 207is used instead.
214.Pp 208.Pp
215.Fn i2a_ASN1_INTEGER
216writes a hexadecimal representation of
217.Fa a
218to
219.Fa out_bio .
220The output optionally starts with a minus sign,
221followed by an even number of upper case ASCII hexadecimal digits.
222After each group of 70 digits, a backslash and a linefeed
223are inserted before the next digit.
224.Pp
225.Fn ASN1_ENUMERATED_get , 209.Fn ASN1_ENUMERATED_get ,
226.Fn ASN1_ENUMERATED_set , 210.Fn ASN1_ENUMERATED_set ,
227.Fn BN_to_ASN1_ENUMERATED , 211.Fn BN_to_ASN1_ENUMERATED ,
@@ -294,17 +278,6 @@ object of
294if an error occurs. 278if an error occurs.
295They can fail if the passed type is incorrect (due to a programming error) 279They can fail if the passed type is incorrect (due to a programming error)
296or due to memory allocation failures. 280or due to memory allocation failures.
297.Pp
298In case of success,
299.Fn i2a_ASN1_INTEGER
300returns the total number of bytes written, which is at least 2.
301It returns 0 if
302.Fa a
303is
304.Dv NULL
305or -1 if
306.Xr BIO_write 3
307fails.
308.Sh SEE ALSO 281.Sh SEE ALSO
309.Xr ASN1_INTEGER_new 3 , 282.Xr ASN1_INTEGER_new 3 ,
310.Xr ASN1_STRING_length 3 283.Xr ASN1_STRING_length 3
@@ -313,9 +286,8 @@ fails.
313first appeared in SSLeay 0.5.1. 286first appeared in SSLeay 0.5.1.
314.Fn ASN1_INTEGER_get , 287.Fn ASN1_INTEGER_get ,
315.Fn BN_to_ASN1_INTEGER , 288.Fn BN_to_ASN1_INTEGER ,
316.Fn ASN1_INTEGER_to_BN ,
317and 289and
318.Fn i2a_ASN1_INTEGER 290.Fn ASN1_INTEGER_to_BN
319first appeared in SSLeay 0.6.0. 291first appeared in SSLeay 0.6.0.
320.Fn ASN1_INTEGER_cmp 292.Fn ASN1_INTEGER_cmp
321and 293and
@@ -348,9 +320,8 @@ imply that these functions should be avoided if possible.
348.Sh BUGS 320.Sh BUGS
349.Fn ASN1_INTEGER_cmp , 321.Fn ASN1_INTEGER_cmp ,
350.Fn ASN1_INTEGER_dup , 322.Fn ASN1_INTEGER_dup ,
351.Fn ASN1_INTEGER_to_BN ,
352and 323and
353.Fn i2a_ASN1_INTEGER 324.Fn ASN1_INTEGER_to_BN
354do not check whether their arguments are really of the type 325do not check whether their arguments are really of the type
355.Dv V_ASN1_INTEGER 326.Dv V_ASN1_INTEGER
356or 327or