From: tb <tb@openbsd.org>
Date: Mon, 12 Sep 2022 14:33:47 +0000 (+0000)
Subject: Stop documenting i2c_ASN1_INTEGER.
X-Git-Url: http://artulab.com/gitweb/?a=commitdiff_plain;h=cc09e15c6f36b8e538bec18b1227fa3f935af3cd;p=openbsd

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.
---

diff --git a/lib/libcrypto/man/d2i_ASN1_OBJECT.3 b/lib/libcrypto/man/d2i_ASN1_OBJECT.3
index 913140b30fc..a555490f659 100644
--- a/lib/libcrypto/man/d2i_ASN1_OBJECT.3
+++ b/lib/libcrypto/man/d2i_ASN1_OBJECT.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: d2i_ASN1_OBJECT.3,v 1.12 2022/03/29 17:41:20 schwarze Exp $
+.\" $OpenBSD: d2i_ASN1_OBJECT.3,v 1.13 2022/09/12 14:33:47 tb Exp $
 .\"
 .\" Copyright (c) 2017, 2022 Ingo Schwarze <schwarze@openbsd.org>
 .\"
@@ -14,14 +14,12 @@
 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 .\"
-.Dd $Mdocdate: March 29 2022 $
+.Dd $Mdocdate: September 12 2022 $
 .Dt D2I_ASN1_OBJECT 3
 .Os
 .Sh NAME
 .Nm d2i_ASN1_OBJECT ,
 .Nm i2d_ASN1_OBJECT
-.\" c2i_ASN1_OBJECT is intentionally undocumented because it is unused
-.\" in real-world software and was removed from the OpenSSL 1.1.1 API
 .Nd decode and encode ASN.1 object identifiers
 .Sh SYNOPSIS
 .In openssl/asn1.h
diff --git a/lib/libcrypto/man/d2i_ASN1_OCTET_STRING.3 b/lib/libcrypto/man/d2i_ASN1_OCTET_STRING.3
index a5d2eadb20d..e7694111eb7 100644
--- a/lib/libcrypto/man/d2i_ASN1_OCTET_STRING.3
+++ b/lib/libcrypto/man/d2i_ASN1_OCTET_STRING.3
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: d2i_ASN1_OCTET_STRING.3,v 1.17 2022/03/29 14:27:59 naddy Exp $
+.\"	$OpenBSD: d2i_ASN1_OCTET_STRING.3,v 1.18 2022/09/12 14:33:47 tb Exp $
 .\"
 .\" Copyright (c) 2017 Ingo Schwarze <schwarze@openbsd.org>
 .\"
@@ -14,7 +14,7 @@
 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 .\"
-.Dd $Mdocdate: March 29 2022 $
+.Dd $Mdocdate: September 12 2022 $
 .Dt D2I_ASN1_OCTET_STRING 3
 .Os
 .Sh NAME
@@ -24,7 +24,6 @@
 .Nm i2d_ASN1_BIT_STRING ,
 .Nm d2i_ASN1_INTEGER ,
 .Nm i2d_ASN1_INTEGER ,
-.Nm i2c_ASN1_INTEGER ,
 .Nm d2i_ASN1_UINTEGER ,
 .Nm d2i_ASN1_ENUMERATED ,
 .Nm i2d_ASN1_ENUMERATED ,
@@ -56,9 +55,6 @@
 .Nm i2d_ASN1_UTCTIME ,
 .Nm d2i_ASN1_TIME ,
 .Nm i2d_ASN1_TIME
-.\" i2c_ASN1_BIT_STRING, c2i_ASN1_BIT_STRING, and c2i_ASN1_INTEGER
-.\" are intentionally undocumented because they are unused in
-.\" real-world software and were removed from the OpenSSL 1.1.1 API
 .Nd decode and encode ASN1_STRING objects
 .Sh SYNOPSIS
 .In openssl/asn1.h
@@ -95,11 +91,6 @@
 .Fa "ASN1_INTEGER *val_in"
 .Fa "unsigned char **der_out"
 .Fc
-.Ft int
-.Fo i2c_ASN1_INTEGER
-.Fa "ASN1_INTEGER *val_in"
-.Fa "unsigned char **der_out"
-.Fc
 .Ft ASN1_INTEGER *
 .Fo d2i_ASN1_UINTEGER
 .Fa "ASN1_INTEGER **val_out"
@@ -301,27 +292,6 @@ The identifier bytes and corresponding ASN.1 types are as follows:
 .It Vt ASN1_UTCTIME         Ta 0x17 Ta UTCTime
 .El
 .Pp
-.Fn i2c_ASN1_INTEGER
-writes only the content bytes of
-.Fa val_in
-to
-.Pf * Fa der_out
-and advances
-.Pf * Fa der_out
-to the byte after the last one written.
-The identifier and content length bytes are not written.
-It is the responsibility of the caller to make sure that the buffer
-pointed to by
-.Pf * Fa der_out
-is long enough, such that no buffer overflow can occur.
-This function does not support automatic memory allocation.
-If
-.Fa der_out
-is a
-.Dv NULL
-pointer, the function only calculates the number of content bytes
-that would be written, without writing them anywhere.
-.Pp
 .Fn d2i_DIRECTORYSTRING
 and
 .Fn i2d_DIRECTORYSTRING
@@ -419,14 +389,6 @@ The
 encoding functions return the number of bytes successfully encoded
 or a negative value if an error occurs.
 .Pp
-.Fn i2c_ASN1_INTEGER
-returns the number of content bytes that were or would be written or 0 if
-.Fa val_in
-is a
-.Dv NULL
-pointer or if its
-.Xr ASN1_STRING_length 3
-is negative.
 .Sh SEE ALSO
 .Xr ASN1_item_d2i 3 ,
 .Xr ASN1_STRING_new 3
@@ -484,10 +446,6 @@ first appeared in OpenSSL 0.9.3.
 These functions have been available since
 .Ox 2.6 .
 .Pp
-.Fn i2c_ASN1_INTEGER
-first appeared in OpenSSL 0.9.6 and has been available since
-.Ox 2.9 .
-.Pp
 .Fn d2i_ASN1_UNIVERSALSTRING ,
 .Fn i2d_ASN1_UNIVERSALSTRING ,
 .Fn d2i_ASN1_GENERALSTRING ,