diff options
| author | tb <> | 2022-09-12 14:33:47 +0000 |
|---|---|---|
| committer | tb <> | 2022-09-12 14:33:47 +0000 |
| commit | afa32a688a05314cc1b6eec8c3ec695173e1459d (patch) | |
| tree | 21c88dbc84819aad6a8846e29cb2fbbd13d2b892 /src/lib/libcrypto/man | |
| parent | 77e0dc143cbead5de7825f59dfee9ce1f58bc6c1 (diff) | |
| download | openbsd-afa32a688a05314cc1b6eec8c3ec695173e1459d.tar.gz openbsd-afa32a688a05314cc1b6eec8c3ec695173e1459d.tar.bz2 openbsd-afa32a688a05314cc1b6eec8c3ec695173e1459d.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.
Diffstat (limited to 'src/lib/libcrypto/man')
| -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 , |
