In x509.h rev. 1.29 2018/02/17 15:50:42, jsing@ provided

X509_get0_signature(3).  Merge the documentation from OpenSSL.
Rename the file from X509_get_signature_nid.3 to X509_get0_signature.3
for consistency because we are not losing any history yet.

2 files changed, 32 insertions, 5 deletions

diff --git a/lib/libcrypto/man/Makefile b/lib/libcrypto/man/Makefile
index 431285c7e0c..8d15d6121c4 100644
--- a/lib/libcrypto/man/Makefile
+++ b/lib/libcrypto/man/Makefile
@@ -1,4 +1,4 @@
-# $OpenBSD: Makefile,v 1.131 2018/02/17 23:24:38 schwarze Exp $
+# $OpenBSD: Makefile,v 1.132 2018/02/19 08:20:26 schwarze Exp $
 
 .include <bsd.own.mk>
 
@@ -241,10 +241,10 @@ MAN=	\
 	X509_digest.3 \
 	X509_get_pubkey.3 \
 	X509_get_serialNumber.3 \
-	X509_get_signature_nid.3 \
 	X509_get_subject_name.3 \
 	X509_get_version.3 \
 	X509_get0_notBefore.3 \
+	X509_get0_signature.3 \
 	X509_new.3 \
 	X509_sign.3 \
 	X509_verify_cert.3 \
diff --git a/lib/libcrypto/man/X509_get_signature_nid.3 b/lib/libcrypto/man/X509_get0_signature.3
index 837b392bcc8..4c6c3f1e4f0 100644
--- a/lib/libcrypto/man/X509_get_signature_nid.3
+++ b/lib/libcrypto/man/X509_get0_signature.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: X509_get_signature_nid.3,v 1.1 2018/02/14 18:50:47 schwarze Exp $
+.\" $OpenBSD: X509_get0_signature.3,v 1.1 2018/02/19 08:20:26 schwarze Exp $
 .\" selective merge up to:
 .\" OpenSSL man3/X509_get0_signature 2f7a2520 Apr 25 17:28:08 2017 +0100
 .\"
@@ -49,22 +49,47 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
 .\" OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: February 14 2018 $
-.Dt X509_GET_SIGNATURE_NID 3
+.Dd $Mdocdate: February 19 2018 $
+.Dt X509_GET0_SIGNATURE 3
 .Os
 .Sh NAME
+.Nm X509_get0_signature ,
 .Nm X509_get_signature_nid
 .Nd signature information
 .Sh SYNOPSIS
 .In openssl/x509.h
+.Ft void
+.Fo X509_get0_signature
+.Fa "const ASN1_BIT_STRING **psig"
+.Fa "const X509_ALGOR **palg"
+.Fa "const X509 *x"
+.Fc
 .Ft int
 .Fo X509_get_signature_nid
 .Fa "const X509 *x"
 .Fc
 .Sh DESCRIPTION
+.Fn X509_get0_signature
+sets
+.Pf * Fa psig
+to the signature of
+.Fa x
+and
+.Pf * Fa palg
+to the signature algorithm of
+.Fa x .
+The values returned are internal pointers
+that must not be freed by the caller.
+.Pp
 .Fn X509_get_signature_nid
 returns the NID corresponding to the signature algorithm of
 .Fa x .
+.Pp
+These functions provide lower level access to the signature
+for cases where an application wishes to analyse or generate a
+signature in a form where
+.Xr X509_sign 3
+is not appropriate, for example in a non-standard or unsupported format.
 .Sh SEE ALSO
 .Xr OBJ_obj2nid 3 ,
 .Xr X509_get_pubkey 3 ,
@@ -74,5 +99,7 @@ returns the NID corresponding to the signature algorithm of
 .Xr X509_sign 3 ,
 .Xr X509_verify_cert 3
 .Sh HISTORY
+.Fn X509_get0_signature
+and
 .Fn X509_get_signature_nid
 first appeared in OpenSSL 1.0.2.