From: schwarze <schwarze@openbsd.org>
Date: Tue, 26 Oct 2021 10:50:08 +0000 (+0000)
Subject: document X509_REQ_dup(3)
X-Git-Url: http://artulab.com/gitweb/?a=commitdiff_plain;h=3e2159df230771cb9bc61edd2afc284caab055d0;p=openbsd

document X509_REQ_dup(3)
---

diff --git a/lib/libcrypto/man/X509_REQ_new.3 b/lib/libcrypto/man/X509_REQ_new.3
index 26460048d3a..76d3d352779 100644
--- a/lib/libcrypto/man/X509_REQ_new.3
+++ b/lib/libcrypto/man/X509_REQ_new.3
@@ -1,6 +1,6 @@
-.\"	$OpenBSD: X509_REQ_new.3,v 1.6 2019/06/06 01:06:59 schwarze Exp $
+.\" $OpenBSD: X509_REQ_new.3,v 1.7 2021/10/26 10:50:08 schwarze Exp $
 .\"
-.\" 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
@@ -14,11 +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: June 6 2019 $
+.Dd $Mdocdate: October 26 2021 $
 .Dt X509_REQ_NEW 3
 .Os
 .Sh NAME
 .Nm X509_REQ_new ,
+.Nm X509_REQ_dup ,
 .Nm X509_REQ_free ,
 .Nm X509_REQ_INFO_new ,
 .Nm X509_REQ_INFO_free
@@ -27,6 +28,8 @@
 .In openssl/x509.h
 .Ft X509_REQ *
 .Fn X509_REQ_new void
+.Ft X509_REQ *
+.Fn X509_REQ_dup "X509_REQ *req"
 .Ft void
 .Fn X509_REQ_free "X509_REQ *req"
 .Ft X509_REQ_INFO *
@@ -44,6 +47,14 @@ It can hold a pointer to an
 .Vt X509_REQ_INFO
 object discussed below together with a cryptographic signature and
 information about the signature algorithm used.
+.Pp
+.Fn X509_REQ_dup
+creates a deep copy of
+.Fa req
+using
+.Xr ASN1_item_dup 3 ,
+setting the reference count of the copy to 1.
+.Pp
 .Fn X509_REQ_free
 frees
 .Fa req .
@@ -72,7 +83,8 @@ is a
 .Dv NULL
 pointer, no action occurs.
 .Sh RETURN VALUES
-.Fn X509_REQ_new
+.Fn X509_REQ_new ,
+.Fn X509_REQ_dup ,
 and
 .Fn X509_REQ_INFO_new
 return the new
@@ -101,5 +113,8 @@ RFC 2986: PKCS #10: Certification Request Syntax Specification
 .Fn X509_REQ_INFO_new ,
 and
 .Fn X509_REQ_INFO_free
-first appeared in SSLeay 0.4.4 and have been available since
+first appeared in SSLeay 0.4.4 and
+.Fn X509_REQ_dup
+in SSLeay 0.5.1.
+These functions have been available since
 .Ox 2.4 .