From c821d52c2fb2479ab2d5eff463b622fb9a605e66 Mon Sep 17 00:00:00 2001
From: Ingo Schwarze <schwarze@cvs.openbsd.org>
Date: Wed, 14 Dec 2016 17:26:36 +0000
Subject: Document X509_NAME_dup(3) and X509_NAME_ENTRY_dup(3) listed in
 OpenSSL doc/man3/X509_dup.pod and d2i_X509_NAME_ENTRY(3) and
 i2d_X509_NAME_ENTRY(3) listed in OpenSSL doc/man3/d2i_X509.pod. Also add a
 RETURN VALUES section.

---
 lib/libcrypto/man/d2i_X509_NAME.3 | 86 ++++++++++++++++++++++++++++++++++++++-
 1 file changed, 84 insertions(+), 2 deletions(-)

diff --git a/lib/libcrypto/man/d2i_X509_NAME.3 b/lib/libcrypto/man/d2i_X509_NAME.3
index 1f1836abafa..0dacb648c75 100644
--- a/lib/libcrypto/man/d2i_X509_NAME.3
+++ b/lib/libcrypto/man/d2i_X509_NAME.3
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: d2i_X509_NAME.3,v 1.5 2016/12/14 16:18:31 schwarze Exp $
+.\"	$OpenBSD: d2i_X509_NAME.3,v 1.6 2016/12/14 17:26:35 schwarze Exp $
 .\"	OpenSSL d900a015 Oct 8 14:40:42 2015 +0200
 .\"
 .\" Copyright (c) 2016 Ingo Schwarze <schwarze@openbsd.org>
@@ -20,7 +20,11 @@
 .Os
 .Sh NAME
 .Nm d2i_X509_NAME ,
-.Nm i2d_X509_NAME
+.Nm i2d_X509_NAME ,
+.Nm X509_NAME_dup ,
+.Nm d2i_X509_NAME_ENTRY ,
+.Nm i2d_X509_NAME_ENTRY ,
+.Nm X509_NAME_ENTRY_dup
 .\" In the following line, "X.501" and "Name" are not typos.
 .\" The "Name" type is defined in X.501, not in X.509.
 .\" The type in called "Name" with capital "N", not "name".
@@ -38,6 +42,25 @@
 .Fa "X509_NAME *name"
 .Fa "unsigned char **out"
 .Fc
+.Ft X509_NAME *
+.Fo X509_NAME_dup
+.Fa "X509_NAME *name"
+.Fc
+.Ft X509_NAME_ENTRY *
+.Fo d2i_X509_NAME_ENTRY
+.Fa "X509_NAME_ENTRY **ne"
+.Fa "unsigned char **in"
+.Fa "long length"
+.Fc
+.Ft int
+.Fo i2d_X509_NAME_ENTRY
+.Fa "X509_NAME_ENTRY *ne"
+.Fa "unsigned char **out"
+.Fc
+.Ft X509_NAME_ENTRY *
+.Fo X509_NAME_ENTRY_dup
+.Fa "X509_NAME_ENTRY *ne"
+.Fc
 .Sh DESCRIPTION
 .Fn d2i_X509_NAME
 decodes
@@ -53,6 +76,36 @@ encodes
 into DER format and stores the result to
 .Pf * Fa out .
 .Pp
+.Fn X509_NAME_dup
+copies
+.Fa name
+by calling
+.Fn i2d_X509_NAME
+and
+.Fn d2i_X509_NAME .
+.Pp
+.Fn d2i_X509_NAME_ENTRY
+decodes
+.Fa length
+bytes of the DER-encoded string
+.Pf * Fa in
+and stores the resulting RelativeDistinguishedName object in
+.Pf * Fa ne .
+.Pp
+.Fn i2d_X509_NAME_ENTRY
+encodes
+.Fa ne
+into DER format and stores the result to
+.Pf * Fa out .
+.Pp
+.Fn X509_NAME_ENTRY_dup
+copies
+.Fa ne
+by calling
+.Fn i2d_X509_NAME_ENTRY
+and
+.Fn d2i_X509_NAME_ENTRY .
+.Pp
 For details of the behaviour, see
 .Xr d2i_X509 3 .
 .Pp
@@ -60,8 +113,37 @@ Regarding
 .Vt X509_NAME
 objects, see
 .Xr X509_NAME_new 3 .
+Regarding
+.Vt X509_NAME_ENTRY
+objects, see
+.Xr X509_NAME_ENTRY_new 3 .
+.Sh RETURN VALUES
+.Fn d2i_X509_NAME
+and
+.Fn X509_NAME_dup
+return the new
+.Vt X509_NAME
+object or
+.Dv NULL
+if an error occurs.
+.Pp
+.Fn d2i_X509_NAME_ENTRY
+and
+.Fn X509_NAME_ENTRY_dup
+return the new
+.Vt X509_NAME_ENTRY
+object or
+.Dv NULL
+if an error occurs.
+.Pp
+.Fn i2d_X509_NAME
+and
+.Fn i2d_X509_NAME_ENTRY
+returns the number of bytes successfully encoded or a negative value
+if an error occurs.
 .Sh SEE ALSO
 .Xr d2i_X509 3 ,
+.Xr X509_NAME_ENTRY_new 3 ,
 .Xr X509_NAME_new 3 ,
 .Xr X509_NAME_print_ex 3
 .Sh STANDARDS
-- 
cgit v1.2.3