Mark BN_mod_exp2_mont() as intentionally undocumented.
authorschwarze <schwarze@openbsd.org>
Wed, 16 Nov 2022 14:19:22 +0000 (14:19 +0000)
committerschwarze <schwarze@openbsd.org>
Wed, 16 Nov 2022 14:19:22 +0000 (14:19 +0000)
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 <openssl/bn.h>,
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

index ab2d343..c875147 100644 (file)
@@ -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
 .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 <openssl/bn.h>.
 .Nm BN_gcd
 .Nd arithmetic operations on BIGNUMs