From: tb Date: Thu, 27 Apr 2023 06:57:10 +0000 (+0000) Subject: Remove NIST prime documentation X-Git-Url: http://artulab.com/gitweb/?a=commitdiff_plain;h=af5efd5647c7c05d494f8290cb1fc88c45b87e76;p=openbsd Remove NIST prime documentation --- diff --git a/lib/libcrypto/man/BN_get0_nist_prime_521.3 b/lib/libcrypto/man/BN_get0_nist_prime_521.3 deleted file mode 100644 index eb95c422100..00000000000 --- a/lib/libcrypto/man/BN_get0_nist_prime_521.3 +++ /dev/null @@ -1,89 +0,0 @@ -.\" $OpenBSD: BN_get0_nist_prime_521.3,v 1.5 2018/03/23 00:09:11 schwarze Exp $ -.\" OpenSSL 99d63d46 Oct 26 13:56:48 2016 -0400 -.\" -.\" This file was written by Rich Salz . -.\" Copyright (c) 2016 The OpenSSL Project. All rights reserved. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in -.\" the documentation and/or other materials provided with the -.\" distribution. -.\" -.\" 3. All advertising materials mentioning features or use of this -.\" software must display the following acknowledgment: -.\" "This product includes software developed by the OpenSSL Project -.\" for use in the OpenSSL Toolkit. (http://www.openssl.org/)" -.\" -.\" 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to -.\" endorse or promote products derived from this software without -.\" prior written permission. For written permission, please contact -.\" openssl-core@openssl.org. -.\" -.\" 5. Products derived from this software may not be called "OpenSSL" -.\" nor may "OpenSSL" appear in their names without prior written -.\" permission of the OpenSSL Project. -.\" -.\" 6. Redistributions of any form whatsoever must retain the following -.\" acknowledgment: -.\" "This product includes software developed by the OpenSSL Project -.\" for use in the OpenSSL Toolkit (http://www.openssl.org/)" -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY -.\" EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR -.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR -.\" ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, -.\" SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT -.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; -.\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) -.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, -.\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) -.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED -.\" OF THE POSSIBILITY OF SUCH DAMAGE. -.\" -.Dd $Mdocdate: March 23 2018 $ -.Dt BN_GET0_NIST_PRIME_521 3 -.Os -.Sh NAME -.Nm BN_get0_nist_prime_192 , -.Nm BN_get0_nist_prime_224 , -.Nm BN_get0_nist_prime_256 , -.Nm BN_get0_nist_prime_384 , -.Nm BN_get0_nist_prime_521 -.Nd create standardized public primes or DH pairs -.Sh SYNOPSIS -.In openssl/bn.h -.Ft const BIGNUM * -.Fn BN_get0_nist_prime_192 void -.Ft const BIGNUM * -.Fn BN_get0_nist_prime_224 void -.Ft const BIGNUM * -.Fn BN_get0_nist_prime_256 void -.Ft const BIGNUM * -.Fn BN_get0_nist_prime_384 void -.Ft const BIGNUM * -.Fn BN_get0_nist_prime_521 void -.Sh DESCRIPTION -The -.Fn BN_get0_nist_prime_192 , -.Fn BN_get0_nist_prime_224 , -.Fn BN_get0_nist_prime_256 , -.Fn BN_get0_nist_prime_384 , -and -.Fn BN_get0_nist_prime_521 -functions return a -.Vt BIGNUM -for the specific NIST prime curve (e.g. P-256). -.Sh SEE ALSO -.Xr BN_new 3 -.Sh HISTORY -These functions first appeared in OpenSSL 0.9.8 -and have been available since -.Ox 4.5 . diff --git a/lib/libcrypto/man/BN_nist_mod_521.3 b/lib/libcrypto/man/BN_nist_mod_521.3 deleted file mode 100644 index 72dd4a71248..00000000000 --- a/lib/libcrypto/man/BN_nist_mod_521.3 +++ /dev/null @@ -1,113 +0,0 @@ -.\" $OpenBSD: BN_nist_mod_521.3,v 1.1 2022/11/21 22:04:04 schwarze Exp $ -.\" -.\" Copyright (c) 2022 Ingo Schwarze -.\" -.\" Permission to use, copy, modify, and distribute this software for any -.\" purpose with or without fee is hereby granted, provided that the above -.\" copyright notice and this permission notice appear in all copies. -.\" -.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES -.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF -.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR -.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES -.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN -.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF -.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. -.\" -.Dd $Mdocdate: November 21 2022 $ -.Dt BN_NIST_MOD_521 3 -.Os -.Sh NAME -.Nm BN_nist_mod_192 , -.Nm BN_nist_mod_224 , -.Nm BN_nist_mod_256 , -.Nm BN_nist_mod_384 , -.Nm BN_nist_mod_521 -.Nd reduction modulo NIST-recommended primes -.Sh SYNOPSIS -.In openssl/bn.h -.Ft int -.Fo BN_nist_mod_192 -.Fa "BIGNUM *r" -.Fa "const BIGNUM *a" -.Fa "const BIGNUM *m" -.Fa "BN_CTX *ctx" -.Fc -.Ft int -.Fo BN_nist_mod_224 -.Fa "BIGNUM *r" -.Fa "const BIGNUM *a" -.Fa "const BIGNUM *m" -.Fa "BN_CTX *ctx" -.Fc -.Ft int -.Fo BN_nist_mod_256 -.Fa "BIGNUM *r" -.Fa "const BIGNUM *a" -.Fa "const BIGNUM *m" -.Fa "BN_CTX *ctx" -.Fc -.Ft int -.Fo BN_nist_mod_384 -.Fa "BIGNUM *r" -.Fa "const BIGNUM *a" -.Fa "const BIGNUM *m" -.Fa "BN_CTX *ctx" -.Fc -.Ft int -.Fo BN_nist_mod_521 -.Fa "BIGNUM *r" -.Fa "const BIGNUM *a" -.Fa "const BIGNUM *m" -.Fa "BN_CTX *ctx" -.Fc -.Sh DESCRIPTION -These functions are optimized versions of -.Xr BN_nnmod 3 -using precomputed tables. -They ignore their -.Fa m -argument and use the following moduli instead: -.Pp -.Bl -tag -width BN_nist_mod_521() -offset indent -compact -.It Fn BN_nist_mod_192 -.Xr BN_get0_nist_prime_192 3 -.It Fn BN_nist_mod_224 -.Xr BN_get0_nist_prime_224 3 -.It Fn BN_nist_mod_256 -.Xr BN_get0_nist_prime_256 3 -.It Fn BN_nist_mod_384 -.Xr BN_get0_nist_prime_384 3 -.It Fn BN_nist_mod_521 -.Xr BN_get0_nist_prime_521 3 -.El -.Pp -They reduce -.Fa a -modulo the respective prime number and place the non-negative remainder in -.Fa r . -.Pp -These functions are designed to save time when performing multiplications -in prime fields of these specific orders. -Consequently, if -.Fa a -is negative or larger than the square of the modulus being used, they call -.Xr BN_nnmod 3 -instead of attempting any optimization. -.Sh RETURN VALUES -These functions return 1 on success or 0 on error. -.Sh SEE ALSO -.Xr BN_get0_nist_prime_521 3 , -.Xr BN_nnmod 3 , -.Xr EC_GFp_nist_method 3 -.Sh STANDARDS -.Rs -.%T Digital Signature Standard (DSS) -.%I National Institute of Standards and Technology -.%R FIPS PUB 186-4 -.%U https://doi.org/10.6028/NIST.FIPS.186-4 -.%Q Information Technology Laboratory -.%C Gaithersburg, Maryland -.%D July 2013 -.%O Appendix D.1.2 Curves over Prime Fields -.Re