Link the new manual page EVP_PKEY_new_CMAC_key(3) to the build

and purge the superseded information from the algorithm-independent
page EVP_PKEY_new(3).

2 files changed, 5 insertions, 29 deletions

diff --git a/lib/libcrypto/man/EVP_PKEY_new.3 b/lib/libcrypto/man/EVP_PKEY_new.3
index ea22b5eb088..aae1ab3f918 100644
--- a/lib/libcrypto/man/EVP_PKEY_new.3
+++ b/lib/libcrypto/man/EVP_PKEY_new.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: EVP_PKEY_new.3,v 1.20 2024/08/24 09:15:36 tb Exp $
+.\" $OpenBSD: EVP_PKEY_new.3,v 1.21 2024/11/12 20:15:24 schwarze Exp $
 .\" full merge up to: OpenSSL 4dcfdfce May 27 11:50:05 2020 +0100
 .\"
 .\" This file is a derived work.
@@ -66,7 +66,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
 .\" OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: August 24 2024 $
+.Dd $Mdocdate: November 12 2024 $
 .Dt EVP_PKEY_NEW 3
 .Os
 .Sh NAME
@@ -75,7 +75,6 @@
 .Nm EVP_PKEY_free ,
 .Nm EVP_PKEY_new_raw_private_key ,
 .Nm EVP_PKEY_new_raw_public_key ,
-.Nm EVP_PKEY_new_CMAC_key ,
 .Nm EVP_PKEY_new_mac_key ,
 .Nm EVP_PKEY_get_raw_private_key ,
 .Nm EVP_PKEY_get_raw_public_key
@@ -107,13 +106,6 @@
 .Fa "size_t rawlen"
 .Fc
 .Ft EVP_PKEY *
-.Fo EVP_PKEY_new_CMAC_key
-.Fa "ENGINE *engine"
-.Fa "const unsigned char *rawpriv"
-.Fa "size_t rawlen"
-.Fa "const EVP_CIPHER *cipher"
-.Fc
-.Ft EVP_PKEY *
 .Fo EVP_PKEY_new_mac_key
 .Fa "int type"
 .Fa "ENGINE *engine"
@@ -198,19 +190,6 @@ Algorithm types that support raw public keys are
 and
 .Dv EVP_PKEY_ED25519 .
 .Pp
-.Fn EVP_PKEY_new_CMAC_key
-works in the same way as
-.Fn EVP_PKEY_new_raw_private_key
-except that it only handles the
-.Dv EVP_PKEY_CMAC
-algorithm type.
-The additional
-.Fa cipher
-argument specifies the cipher algorithm
-to be used during the creation of the CMAC.
-It should be a standard encryption only cipher.
-For example, AEAD and XTS ciphers should not be used.
-.Pp
 .Fn EVP_PKEY_new_mac_key
 is a deprecated function that works in the same way as
 .Fn EVP_PKEY_new_raw_private_key .
@@ -250,7 +229,6 @@ and
 .Fn EVP_PKEY_new ,
 .Fn EVP_PKEY_new_raw_private_key ,
 .Fn EVP_PKEY_new_raw_public_key ,
-.Fn EVP_PKEY_new_CMAC_key ,
 and
 .Fn EVP_PKEY_new_mac_key
 return either the newly allocated
@@ -275,6 +253,7 @@ return 1 for success or 0 for failure.
 .Xr EVP_PKEY_CTX_new 3 ,
 .Xr EVP_PKEY_get_default_digest_nid 3 ,
 .Xr EVP_PKEY_meth_new 3 ,
+.Xr EVP_PKEY_new_CMAC_key 3 ,
 .Xr EVP_PKEY_print_private 3 ,
 .Xr EVP_PKEY_set1_RSA 3 ,
 .Xr EVP_PKEY_size 3 ,
@@ -286,10 +265,6 @@ and
 first appeared in SSLeay 0.6.0 and have been available since
 .Ox 2.4 .
 .Pp
-.Fn EVP_PKEY_new_CMAC_key
-first appeared in OpenSSL 1.1.1 and has been available since
-.Ox 6.9 .
-.Pp
 .Fn EVP_PKEY_new_mac_key
 first appeared in OpenSSL 1.0.0 and has been available since
 .Ox 4.9 .
diff --git a/lib/libcrypto/man/Makefile b/lib/libcrypto/man/Makefile
index 1519b3daca0..5d791d183e8 100644
--- a/lib/libcrypto/man/Makefile
+++ b/lib/libcrypto/man/Makefile
@@ -1,4 +1,4 @@
-# $OpenBSD: Makefile,v 1.295 2024/10/22 22:41:01 jsg Exp $
+# $OpenBSD: Makefile,v 1.296 2024/11/12 20:15:24 schwarze Exp $
 
 .include <bsd.own.mk>
 
@@ -189,6 +189,7 @@ MAN=	\
 	EVP_PKEY_meth_get0_info.3 \
 	EVP_PKEY_meth_new.3 \
 	EVP_PKEY_new.3 \
+	EVP_PKEY_new_CMAC_key.3 \
 	EVP_PKEY_print_private.3 \
 	EVP_PKEY_set1_RSA.3 \
 	EVP_PKEY_sign.3 \