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.

1 files changed, 14 insertions, 3 deletions

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