+++ /dev/null
-.\" $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 <rsalz@openssl.org>.
-.\" 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 .
+++ /dev/null
-.\" $OpenBSD: BN_nist_mod_521.3,v 1.1 2022/11/21 22:04:04 schwarze Exp $
-.\"
-.\" Copyright (c) 2022 Ingo Schwarze <schwarze@openbsd.org>
-.\"
-.\" 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
projects / openbsd / commitdiff