From d56b9af6a4e7dba02d2b4dc0f383e2834209caa7 Mon Sep 17 00:00:00 2001
From: schwarze <>
Date: Sun, 13 May 2018 15:53:30 +0000
Subject: Document EVP_PKEY_bits(3). It is clearly public because it is
 declared in <openssl/evp.h>, refenced from EVP_PKEY_asn1_set_public(3), and
 similar to the documented functions DH_bits(3) and RSA_bits(3). Triggered by
 tb@ adding a const qualifier to its argument.

---
 src/lib/libcrypto/man/EVP_PKEY_asn1_new.3 |  8 ++++----
 src/lib/libcrypto/man/EVP_SignInit.3      | 17 ++++++++++++++---
 2 files changed, 18 insertions(+), 7 deletions(-)

(limited to 'src')

diff --git a/src/lib/libcrypto/man/EVP_PKEY_asn1_new.3 b/src/lib/libcrypto/man/EVP_PKEY_asn1_new.3
index a0839bd16a..2af7a8248f 100644
--- a/src/lib/libcrypto/man/EVP_PKEY_asn1_new.3
+++ b/src/lib/libcrypto/man/EVP_PKEY_asn1_new.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: EVP_PKEY_asn1_new.3,v 1.2 2018/03/23 04:34:23 schwarze Exp $
+.\" $OpenBSD: EVP_PKEY_asn1_new.3,v 1.3 2018/05/13 15:53:30 schwarze Exp $
 .\" selective merge up to:
 .\" OpenSSL man3/EVP_PKEY_ASN1_METHOD b0004708 Nov 1 00:45:24 2017 +0800
 .\"
@@ -49,7 +49,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
 .\" OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: March 23 2018 $
+.Dd $Mdocdate: May 13 2018 $
 .Dt EVP_PKEY_ASN1_METHOD 3
 .Os
 .Sh NAME
@@ -256,8 +256,8 @@ It is called by
 The
 .Fn pkey_bits
 method returns the key size in bits.
-It's called by
-.Fn EVP_PKEY_bits .
+It is called by
+.Xr EVP_PKEY_bits 3 .
 .Bd -unfilled
 .Ft int Fo (*param_decode)
 .Fa "EVP_PKEY *pkey"
diff --git a/src/lib/libcrypto/man/EVP_SignInit.3 b/src/lib/libcrypto/man/EVP_SignInit.3
index e1dcccabab..613cf623be 100644
--- a/src/lib/libcrypto/man/EVP_SignInit.3
+++ b/src/lib/libcrypto/man/EVP_SignInit.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: EVP_SignInit.3,v 1.9 2018/03/29 21:26:51 schwarze Exp $
+.\" $OpenBSD: EVP_SignInit.3,v 1.10 2018/05/13 15:53:30 schwarze Exp $
 .\" full merge up to: OpenSSL b97fdb57 Nov 11 09:33:09 2016 +0100
 .\" selective merge up to: OpenSSL 79b49fb0 Mar 20 10:03:10 2018 +1000
 .\"
@@ -50,7 +50,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
 .\" OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: March 29 2018 $
+.Dd $Mdocdate: May 13 2018 $
 .Dt EVP_SIGNINIT 3
 .Os
 .Sh NAME
@@ -58,7 +58,8 @@
 .Nm EVP_SignUpdate ,
 .Nm EVP_SignFinal ,
 .Nm EVP_SignInit ,
-.Nm EVP_PKEY_size
+.Nm EVP_PKEY_size ,
+.Nm EVP_PKEY_bits
 .Nd EVP signing functions
 .Sh SYNOPSIS
 .In openssl/evp.h
@@ -90,6 +91,10 @@
 .Fo EVP_PKEY_size
 .Fa "EVP_PKEY *pkey"
 .Fc
+.Ft int
+.Fo EVP_PKEY_bits
+.Fa "const EVP_PKEY *pkey"
+.Fc
 .Sh DESCRIPTION
 The EVP signature routines are a high level interface to digital
 signatures.
@@ -178,6 +183,10 @@ return 1 for success and 0 for failure.
 .Fn EVP_PKEY_size
 returns the maximum size of a signature in bytes.
 .Pp
+.Fn EVP_PKEY_bits
+returns the number of significant bits in the key
+or 0 if an error occurs.
+.Pp
 The error codes can be obtained by
 .Xr ERR_get_error 3 .
 .Sh SEE ALSO
@@ -194,6 +203,8 @@ and
 first appeared in SSLeay 0.5.1.
 .Fn EVP_PKEY_size
 first appeared in SSLeay 0.6.0.
+.Fn EVP_PKEY_bits
+first appeared in SSLeay 0.9.0.
 These functions have been available since
 .Ox 2.4 .
 .Pp
-- 
cgit v1.2.3-55-g6feb