diff options
author | tb <> | 2022-09-12 14:33:47 +0000 |
---|---|---|
committer | tb <> | 2022-09-12 14:33:47 +0000 |
commit | bcb7b4e5e449696d120da6237349071e8b72767a (patch) | |
tree | 21c88dbc84819aad6a8846e29cb2fbbd13d2b892 | |
parent | efa6d2fe42f5eb1296915dcd7b56cac3045e92bc (diff) | |
download | openbsd-bcb7b4e5e449696d120da6237349071e8b72767a.tar.gz openbsd-bcb7b4e5e449696d120da6237349071e8b72767a.tar.bz2 openbsd-bcb7b4e5e449696d120da6237349071e8b72767a.zip |
Stop documenting i2c_ASN1_INTEGER.
This is no longer public API. Also remove some comments about i2c and c2i
functions being intentionally undocumented since they are no longer public.
-rw-r--r-- | src/lib/libcrypto/man/d2i_ASN1_OBJECT.3 | 6 | ||||
-rw-r--r-- | src/lib/libcrypto/man/d2i_ASN1_OCTET_STRING.3 | 46 |
2 files changed, 4 insertions, 48 deletions
diff --git a/src/lib/libcrypto/man/d2i_ASN1_OBJECT.3 b/src/lib/libcrypto/man/d2i_ASN1_OBJECT.3 index 913140b30f..a555490f65 100644 --- a/src/lib/libcrypto/man/d2i_ASN1_OBJECT.3 +++ b/src/lib/libcrypto/man/d2i_ASN1_OBJECT.3 | |||
@@ -1,4 +1,4 @@ | |||
1 | .\" $OpenBSD: d2i_ASN1_OBJECT.3,v 1.12 2022/03/29 17:41:20 schwarze Exp $ | 1 | .\" $OpenBSD: d2i_ASN1_OBJECT.3,v 1.13 2022/09/12 14:33:47 tb Exp $ |
2 | .\" | 2 | .\" |
3 | .\" Copyright (c) 2017, 2022 Ingo Schwarze <schwarze@openbsd.org> | 3 | .\" Copyright (c) 2017, 2022 Ingo Schwarze <schwarze@openbsd.org> |
4 | .\" | 4 | .\" |
@@ -14,14 +14,12 @@ | |||
14 | .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF | 14 | .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF |
15 | .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. | 15 | .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. |
16 | .\" | 16 | .\" |
17 | .Dd $Mdocdate: March 29 2022 $ | 17 | .Dd $Mdocdate: September 12 2022 $ |
18 | .Dt D2I_ASN1_OBJECT 3 | 18 | .Dt D2I_ASN1_OBJECT 3 |
19 | .Os | 19 | .Os |
20 | .Sh NAME | 20 | .Sh NAME |
21 | .Nm d2i_ASN1_OBJECT , | 21 | .Nm d2i_ASN1_OBJECT , |
22 | .Nm i2d_ASN1_OBJECT | 22 | .Nm i2d_ASN1_OBJECT |
23 | .\" c2i_ASN1_OBJECT is intentionally undocumented because it is unused | ||
24 | .\" in real-world software and was removed from the OpenSSL 1.1.1 API | ||
25 | .Nd decode and encode ASN.1 object identifiers | 23 | .Nd decode and encode ASN.1 object identifiers |
26 | .Sh SYNOPSIS | 24 | .Sh SYNOPSIS |
27 | .In openssl/asn1.h | 25 | .In openssl/asn1.h |
diff --git a/src/lib/libcrypto/man/d2i_ASN1_OCTET_STRING.3 b/src/lib/libcrypto/man/d2i_ASN1_OCTET_STRING.3 index a5d2eadb20..e7694111eb 100644 --- a/src/lib/libcrypto/man/d2i_ASN1_OCTET_STRING.3 +++ b/src/lib/libcrypto/man/d2i_ASN1_OCTET_STRING.3 | |||
@@ -1,4 +1,4 @@ | |||
1 | .\" $OpenBSD: d2i_ASN1_OCTET_STRING.3,v 1.17 2022/03/29 14:27:59 naddy Exp $ | 1 | .\" $OpenBSD: d2i_ASN1_OCTET_STRING.3,v 1.18 2022/09/12 14:33:47 tb Exp $ |
2 | .\" | 2 | .\" |
3 | .\" Copyright (c) 2017 Ingo Schwarze <schwarze@openbsd.org> | 3 | .\" Copyright (c) 2017 Ingo Schwarze <schwarze@openbsd.org> |
4 | .\" | 4 | .\" |
@@ -14,7 +14,7 @@ | |||
14 | .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF | 14 | .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF |
15 | .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. | 15 | .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. |
16 | .\" | 16 | .\" |
17 | .Dd $Mdocdate: March 29 2022 $ | 17 | .Dd $Mdocdate: September 12 2022 $ |
18 | .Dt D2I_ASN1_OCTET_STRING 3 | 18 | .Dt D2I_ASN1_OCTET_STRING 3 |
19 | .Os | 19 | .Os |
20 | .Sh NAME | 20 | .Sh NAME |
@@ -24,7 +24,6 @@ | |||
24 | .Nm i2d_ASN1_BIT_STRING , | 24 | .Nm i2d_ASN1_BIT_STRING , |
25 | .Nm d2i_ASN1_INTEGER , | 25 | .Nm d2i_ASN1_INTEGER , |
26 | .Nm i2d_ASN1_INTEGER , | 26 | .Nm i2d_ASN1_INTEGER , |
27 | .Nm i2c_ASN1_INTEGER , | ||
28 | .Nm d2i_ASN1_UINTEGER , | 27 | .Nm d2i_ASN1_UINTEGER , |
29 | .Nm d2i_ASN1_ENUMERATED , | 28 | .Nm d2i_ASN1_ENUMERATED , |
30 | .Nm i2d_ASN1_ENUMERATED , | 29 | .Nm i2d_ASN1_ENUMERATED , |
@@ -56,9 +55,6 @@ | |||
56 | .Nm i2d_ASN1_UTCTIME , | 55 | .Nm i2d_ASN1_UTCTIME , |
57 | .Nm d2i_ASN1_TIME , | 56 | .Nm d2i_ASN1_TIME , |
58 | .Nm i2d_ASN1_TIME | 57 | .Nm i2d_ASN1_TIME |
59 | .\" i2c_ASN1_BIT_STRING, c2i_ASN1_BIT_STRING, and c2i_ASN1_INTEGER | ||
60 | .\" are intentionally undocumented because they are unused in | ||
61 | .\" real-world software and were removed from the OpenSSL 1.1.1 API | ||
62 | .Nd decode and encode ASN1_STRING objects | 58 | .Nd decode and encode ASN1_STRING objects |
63 | .Sh SYNOPSIS | 59 | .Sh SYNOPSIS |
64 | .In openssl/asn1.h | 60 | .In openssl/asn1.h |
@@ -95,11 +91,6 @@ | |||
95 | .Fa "ASN1_INTEGER *val_in" | 91 | .Fa "ASN1_INTEGER *val_in" |
96 | .Fa "unsigned char **der_out" | 92 | .Fa "unsigned char **der_out" |
97 | .Fc | 93 | .Fc |
98 | .Ft int | ||
99 | .Fo i2c_ASN1_INTEGER | ||
100 | .Fa "ASN1_INTEGER *val_in" | ||
101 | .Fa "unsigned char **der_out" | ||
102 | .Fc | ||
103 | .Ft ASN1_INTEGER * | 94 | .Ft ASN1_INTEGER * |
104 | .Fo d2i_ASN1_UINTEGER | 95 | .Fo d2i_ASN1_UINTEGER |
105 | .Fa "ASN1_INTEGER **val_out" | 96 | .Fa "ASN1_INTEGER **val_out" |
@@ -301,27 +292,6 @@ The identifier bytes and corresponding ASN.1 types are as follows: | |||
301 | .It Vt ASN1_UTCTIME Ta 0x17 Ta UTCTime | 292 | .It Vt ASN1_UTCTIME Ta 0x17 Ta UTCTime |
302 | .El | 293 | .El |
303 | .Pp | 294 | .Pp |
304 | .Fn i2c_ASN1_INTEGER | ||
305 | writes only the content bytes of | ||
306 | .Fa val_in | ||
307 | to | ||
308 | .Pf * Fa der_out | ||
309 | and advances | ||
310 | .Pf * Fa der_out | ||
311 | to the byte after the last one written. | ||
312 | The identifier and content length bytes are not written. | ||
313 | It is the responsibility of the caller to make sure that the buffer | ||
314 | pointed to by | ||
315 | .Pf * Fa der_out | ||
316 | is long enough, such that no buffer overflow can occur. | ||
317 | This function does not support automatic memory allocation. | ||
318 | If | ||
319 | .Fa der_out | ||
320 | is a | ||
321 | .Dv NULL | ||
322 | pointer, the function only calculates the number of content bytes | ||
323 | that would be written, without writing them anywhere. | ||
324 | .Pp | ||
325 | .Fn d2i_DIRECTORYSTRING | 295 | .Fn d2i_DIRECTORYSTRING |
326 | and | 296 | and |
327 | .Fn i2d_DIRECTORYSTRING | 297 | .Fn i2d_DIRECTORYSTRING |
@@ -419,14 +389,6 @@ The | |||
419 | encoding functions return the number of bytes successfully encoded | 389 | encoding functions return the number of bytes successfully encoded |
420 | or a negative value if an error occurs. | 390 | or a negative value if an error occurs. |
421 | .Pp | 391 | .Pp |
422 | .Fn i2c_ASN1_INTEGER | ||
423 | returns the number of content bytes that were or would be written or 0 if | ||
424 | .Fa val_in | ||
425 | is a | ||
426 | .Dv NULL | ||
427 | pointer or if its | ||
428 | .Xr ASN1_STRING_length 3 | ||
429 | is negative. | ||
430 | .Sh SEE ALSO | 392 | .Sh SEE ALSO |
431 | .Xr ASN1_item_d2i 3 , | 393 | .Xr ASN1_item_d2i 3 , |
432 | .Xr ASN1_STRING_new 3 | 394 | .Xr ASN1_STRING_new 3 |
@@ -484,10 +446,6 @@ first appeared in OpenSSL 0.9.3. | |||
484 | These functions have been available since | 446 | These functions have been available since |
485 | .Ox 2.6 . | 447 | .Ox 2.6 . |
486 | .Pp | 448 | .Pp |
487 | .Fn i2c_ASN1_INTEGER | ||
488 | first appeared in OpenSSL 0.9.6 and has been available since | ||
489 | .Ox 2.9 . | ||
490 | .Pp | ||
491 | .Fn d2i_ASN1_UNIVERSALSTRING , | 449 | .Fn d2i_ASN1_UNIVERSALSTRING , |
492 | .Fn i2d_ASN1_UNIVERSALSTRING , | 450 | .Fn i2d_ASN1_UNIVERSALSTRING , |
493 | .Fn d2i_ASN1_GENERALSTRING , | 451 | .Fn d2i_ASN1_GENERALSTRING , |