From 5f9d48b06a974b8883521ae27b214b350afa2ab1 Mon Sep 17 00:00:00 2001
From: schwarze <schwarze@openbsd.org>
Date: Wed, 24 Nov 2021 13:18:08 +0000
Subject: [PATCH] document ASN1_item_ndef_i2d(3)

---
 lib/libcrypto/man/ASN1_item_d2i.3 | 26 ++++++++++++++++++++++----
 1 file changed, 22 insertions(+), 4 deletions(-)

diff --git a/lib/libcrypto/man/ASN1_item_d2i.3 b/lib/libcrypto/man/ASN1_item_d2i.3
index 8f716f6f365..dbad1351a6a 100644
--- a/lib/libcrypto/man/ASN1_item_d2i.3
+++ b/lib/libcrypto/man/ASN1_item_d2i.3
@@ -1,10 +1,10 @@
-.\"     $OpenBSD: ASN1_item_d2i.3,v 1.12 2021/11/15 11:51:09 schwarze Exp $
+.\"     $OpenBSD: ASN1_item_d2i.3,v 1.13 2021/11/24 13:18:08 schwarze Exp $
 .\"     OpenSSL doc/man3/d2i_X509.pod b97fdb57 Nov 11 09:33:09 2016 +0100
 .\"
 .\" This file is a derived work.
 .\" The changes are covered by the following Copyright and license:
 .\"
-.\" Copyright (c) 2016 Ingo Schwarze <schwarze@openbsd.org>
+.\" Copyright (c) 2016, 2021 Ingo Schwarze <schwarze@openbsd.org>
 .\"
 .\" Permission to use, copy, modify, and distribute this software for any
 .\" purpose with or without fee is hereby granted, provided that the above
@@ -65,7 +65,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
 .\" OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: November 15 2021 $
+.Dd $Mdocdate: November 24 2021 $
 .Dt ASN1_ITEM_D2I 3
 .Os
 .Sh NAME
@@ -76,6 +76,7 @@
 .Nm ASN1_item_i2d ,
 .Nm ASN1_item_i2d_bio ,
 .Nm ASN1_item_i2d_fp ,
+.Nm ASN1_item_ndef_i2d ,
 .Nm i2d_ASN1_TYPE ,
 .Nm ASN1_item_dup ,
 .Nm ASN1_item_print
@@ -126,6 +127,12 @@
 .Fa "void *val_in"
 .Fc
 .Ft int
+.Fo ASN1_item_ndef_i2d
+.Fa "ASN1_VALUE *val_in"
+.Fa "unsigned char **der_out"
+.Fa "const ASN1_ITEM *it"
+.Fc
+.Ft int
 .Fo i2d_ASN1_TYPE
 .Fa "ASN1_TYPE *val_in"
 .Fa "unsigned char **der_out"
@@ -262,6 +269,12 @@ or
 .Vt FILE ,
 respectively.
 .Pp
+.Fn ASN1_item_ndef_i2d
+is similar to
+.Fn ASN1_item_i2d
+except that it encodes using BER rather than DER,
+using the indefinite length form where appropriate.
+.Pp
 .Fn i2d_ASN1_TYPE
 is similar to
 .Fn ASN1_item_i2d
@@ -295,7 +308,8 @@ If an error occurs,
 .Dv NULL
 is returned.
 .Pp
-.Fn ASN1_item_i2d
+.Fn ASN1_item_i2d ,
+.Fn ASN1_item_ndef_i2d ,
 and
 .Fn i2d_ASN1_TYPE
 return the number of bytes written
@@ -386,6 +400,10 @@ and
 first appeared in OpenSSL 0.9.7 and have been available since
 .Ox 3.2 .
 .Pp
+.Fn ASN1_item_ndef_i2d
+first appeared in OpenSSL 0.9.8 and has been available since
+.Ox 4.5 .
+.Pp
 .Fn ASN1_item_print
 first appeared in OpenSSL 1.0.0 and has been available since
 .Ox 4.9 .
-- 
2.20.1