From a61051167899b338d7c8a7edf8491419b15c25c1 Mon Sep 17 00:00:00 2001 From: schwarze Date: Wed, 16 Nov 2022 14:19:22 +0000 Subject: [PATCH] Mark BN_mod_exp2_mont() as intentionally undocumented. It appears to be intended for internal use by DSA_do_verify(3) and using codesearch.debian.net, i found nothing outside OpenSSL/LibreSSL using it. In April 2018, jsing@ questioned whether the five related functions BN_mod_exp_mont() and friends should even be exposed by , so we decided to not document them. Now tb@ agrees that there is no reason to document BN_mod_exp2_mont() as long as we don't want to document BN_mod_exp_mont(). --- lib/libcrypto/man/BN_add.3 | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/lib/libcrypto/man/BN_add.3 b/lib/libcrypto/man/BN_add.3 index ab2d3433218..c87514721a9 100644 --- a/lib/libcrypto/man/BN_add.3 +++ b/lib/libcrypto/man/BN_add.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: BN_add.3,v 1.16 2021/12/20 15:02:13 schwarze Exp $ +.\" $OpenBSD: BN_add.3,v 1.17 2022/11/16 14:19:22 schwarze Exp $ .\" full merge up to: OpenSSL e9b77246 Jan 20 19:58:49 2017 +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: December 20 2021 $ +.Dd $Mdocdate: November 16 2022 $ .Dt BN_ADD 3 .Os .Sh NAME @@ -92,11 +92,12 @@ .Nm BN_exp , .Nm BN_mod_exp , .\" The following are public, but intentionally undocumented for now: +.\" .Nm BN_mod_exp_mont , r \(== a ^ p (mod m) .\" .Nm BN_mod_exp_mont_consttime , -.\" .Nm BN_mod_exp_mont , .\" .Nm BN_mod_exp_mont_word , .\" .Nm BN_mod_exp_recp , .\" .Nm BN_mod_exp_simple , +.\" .Nm BN_mod_exp2_mont r \(== (a1 ^ p1) * (a2 ^ p2) (mod m) .\" Maybe they should be deleted from . .Nm BN_gcd .Nd arithmetic operations on BIGNUMs -- 2.20.1