Commit 5ebffe48b5 for openssl.org
commit 5ebffe48b5c723565f3c3f26adee905d562770df
Author: kovan <xaum.io@gmail.com>
Date: Tue Jan 27 06:01:51 2026 +0100
doc: add missing DH_check_pub_key documentation and fix typo
Add DH_check_pub_key to NAME and SYNOPSIS sections. Fix typo where
DH_check_params() was incorrectly written instead of DH_check_params_ex()
in the description of the _ex functions.
Also remove DH_check_pub_key from util/missingcrypto.txt since it is
now documented.
Fixes #8473
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Reviewed-by: Matt Caswell <matt@openssl.org>
Reviewed-by: Nikola Pajkovsky <nikolap@openssl.org>
Reviewed-by: Paul Dale <paul.dale@oracle.com>
(Merged from https://github.com/openssl/openssl/pull/29768)
diff --git a/doc/man3/DH_generate_parameters.pod b/doc/man3/DH_generate_parameters.pod
index e677885597..1dda2e8510 100644
--- a/doc/man3/DH_generate_parameters.pod
+++ b/doc/man3/DH_generate_parameters.pod
@@ -3,7 +3,7 @@
=head1 NAME
DH_generate_parameters_ex, DH_generate_parameters,
-DH_check, DH_check_params,
+DH_check, DH_check_params, DH_check_pub_key,
DH_check_ex, DH_check_params_ex, DH_check_pub_key_ex
- generate and check Diffie-Hellman
parameters
@@ -20,6 +20,7 @@ see L<openssl_user_macros(7)>:
int DH_check(DH *dh, int *codes);
int DH_check_params(DH *dh, int *codes);
+ int DH_check_pub_key(const DH *dh, const BIGNUM *pub_key, int *codes);
int DH_check_ex(const DH *dh);
int DH_check_params_ex(const DH *dh);
@@ -132,10 +133,10 @@ If 0 is returned or B<*codes> is set to a nonzero value the supplied
parameters should not be used for Diffie-Hellman operations otherwise
the security properties of the key exchange are not guaranteed.
-DH_check_ex(), DH_check_params() and DH_check_pub_key_ex() are similar to
-DH_check() and DH_check_params() respectively, but the error reasons are added
-to the thread's error queue instead of provided as return values from the
-function.
+DH_check_ex(), DH_check_params_ex() and DH_check_pub_key_ex() are similar to
+DH_check(), DH_check_params() and DH_check_pub_key() respectively, but the
+error reasons are added to the thread's error queue instead of provided as
+return values from the function.
=head1 RETURN VALUES
diff --git a/util/missingcrypto.txt b/util/missingcrypto.txt
index 49765d4f7e..b0cc4e9214 100644
--- a/util/missingcrypto.txt
+++ b/util/missingcrypto.txt
@@ -413,7 +413,6 @@ DES_encrypt2(3)
DES_encrypt3(3)
DES_options(3)
DH_KDF_X9_42(3)
-DH_check_pub_key(3)
DH_up_ref(3)
DHparams_dup(3)
DHparams_it(3)