summaryrefslogtreecommitdiff
path: root/src
diff options
context:
space:
mode:
authortb <>2023-04-27 06:57:10 +0000
committertb <>2023-04-27 06:57:10 +0000
commit2572842c6a478ad9e96bb2421ffaf5bd4d6eb9a5 (patch)
tree11981bcb1c43d3124329270088385a7d16613d36 /src
parent0f4c267500308d182635a809a3b6696354f22dea (diff)
downloadopenbsd-2572842c6a478ad9e96bb2421ffaf5bd4d6eb9a5.tar.gz
openbsd-2572842c6a478ad9e96bb2421ffaf5bd4d6eb9a5.tar.bz2
openbsd-2572842c6a478ad9e96bb2421ffaf5bd4d6eb9a5.zip
Remove NIST prime documentation
Diffstat (limited to 'src')
-rw-r--r--src/lib/libcrypto/man/BN_get0_nist_prime_521.389
-rw-r--r--src/lib/libcrypto/man/BN_nist_mod_521.3113
2 files changed, 0 insertions, 202 deletions
diff --git a/src/lib/libcrypto/man/BN_get0_nist_prime_521.3 b/src/lib/libcrypto/man/BN_get0_nist_prime_521.3
deleted file mode 100644
index eb95c42210..0000000000
--- a/src/lib/libcrypto/man/BN_get0_nist_prime_521.3
+++ /dev/null
@@ -1,89 +0,0 @@
1.\" $OpenBSD: BN_get0_nist_prime_521.3,v 1.5 2018/03/23 00:09:11 schwarze Exp $
2.\" OpenSSL 99d63d46 Oct 26 13:56:48 2016 -0400
3.\"
4.\" This file was written by Rich Salz <rsalz@openssl.org>.
5.\" Copyright (c) 2016 The OpenSSL Project. All rights reserved.
6.\"
7.\" Redistribution and use in source and binary forms, with or without
8.\" modification, are permitted provided that the following conditions
9.\" are met:
10.\"
11.\" 1. Redistributions of source code must retain the above copyright
12.\" notice, this list of conditions and the following disclaimer.
13.\"
14.\" 2. Redistributions in binary form must reproduce the above copyright
15.\" notice, this list of conditions and the following disclaimer in
16.\" the documentation and/or other materials provided with the
17.\" distribution.
18.\"
19.\" 3. All advertising materials mentioning features or use of this
20.\" software must display the following acknowledgment:
21.\" "This product includes software developed by the OpenSSL Project
22.\" for use in the OpenSSL Toolkit. (http://www.openssl.org/)"
23.\"
24.\" 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
25.\" endorse or promote products derived from this software without
26.\" prior written permission. For written permission, please contact
27.\" openssl-core@openssl.org.
28.\"
29.\" 5. Products derived from this software may not be called "OpenSSL"
30.\" nor may "OpenSSL" appear in their names without prior written
31.\" permission of the OpenSSL Project.
32.\"
33.\" 6. Redistributions of any form whatsoever must retain the following
34.\" acknowledgment:
35.\" "This product includes software developed by the OpenSSL Project
36.\" for use in the OpenSSL Toolkit (http://www.openssl.org/)"
37.\"
38.\" THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY
39.\" EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
40.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
41.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR
42.\" ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
43.\" SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
44.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
45.\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
46.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
47.\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
48.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
49.\" OF THE POSSIBILITY OF SUCH DAMAGE.
50.\"
51.Dd $Mdocdate: March 23 2018 $
52.Dt BN_GET0_NIST_PRIME_521 3
53.Os
54.Sh NAME
55.Nm BN_get0_nist_prime_192 ,
56.Nm BN_get0_nist_prime_224 ,
57.Nm BN_get0_nist_prime_256 ,
58.Nm BN_get0_nist_prime_384 ,
59.Nm BN_get0_nist_prime_521
60.Nd create standardized public primes or DH pairs
61.Sh SYNOPSIS
62.In openssl/bn.h
63.Ft const BIGNUM *
64.Fn BN_get0_nist_prime_192 void
65.Ft const BIGNUM *
66.Fn BN_get0_nist_prime_224 void
67.Ft const BIGNUM *
68.Fn BN_get0_nist_prime_256 void
69.Ft const BIGNUM *
70.Fn BN_get0_nist_prime_384 void
71.Ft const BIGNUM *
72.Fn BN_get0_nist_prime_521 void
73.Sh DESCRIPTION
74The
75.Fn BN_get0_nist_prime_192 ,
76.Fn BN_get0_nist_prime_224 ,
77.Fn BN_get0_nist_prime_256 ,
78.Fn BN_get0_nist_prime_384 ,
79and
80.Fn BN_get0_nist_prime_521
81functions return a
82.Vt BIGNUM
83for the specific NIST prime curve (e.g. P-256).
84.Sh SEE ALSO
85.Xr BN_new 3
86.Sh HISTORY
87These functions first appeared in OpenSSL 0.9.8
88and have been available since
89.Ox 4.5 .
diff --git a/src/lib/libcrypto/man/BN_nist_mod_521.3 b/src/lib/libcrypto/man/BN_nist_mod_521.3
deleted file mode 100644
index 72dd4a7124..0000000000
--- a/src/lib/libcrypto/man/BN_nist_mod_521.3
+++ /dev/null
@@ -1,113 +0,0 @@
1.\" $OpenBSD: BN_nist_mod_521.3,v 1.1 2022/11/21 22:04:04 schwarze Exp $
2.\"
3.\" Copyright (c) 2022 Ingo Schwarze <schwarze@openbsd.org>
4.\"
5.\" Permission to use, copy, modify, and distribute this software for any
6.\" purpose with or without fee is hereby granted, provided that the above
7.\" copyright notice and this permission notice appear in all copies.
8.\"
9.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
10.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
11.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
12.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
13.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
14.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
15.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
16.\"
17.Dd $Mdocdate: November 21 2022 $
18.Dt BN_NIST_MOD_521 3
19.Os
20.Sh NAME
21.Nm BN_nist_mod_192 ,
22.Nm BN_nist_mod_224 ,
23.Nm BN_nist_mod_256 ,
24.Nm BN_nist_mod_384 ,
25.Nm BN_nist_mod_521
26.Nd reduction modulo NIST-recommended primes
27.Sh SYNOPSIS
28.In openssl/bn.h
29.Ft int
30.Fo BN_nist_mod_192
31.Fa "BIGNUM *r"
32.Fa "const BIGNUM *a"
33.Fa "const BIGNUM *m"
34.Fa "BN_CTX *ctx"
35.Fc
36.Ft int
37.Fo BN_nist_mod_224
38.Fa "BIGNUM *r"
39.Fa "const BIGNUM *a"
40.Fa "const BIGNUM *m"
41.Fa "BN_CTX *ctx"
42.Fc
43.Ft int
44.Fo BN_nist_mod_256
45.Fa "BIGNUM *r"
46.Fa "const BIGNUM *a"
47.Fa "const BIGNUM *m"
48.Fa "BN_CTX *ctx"
49.Fc
50.Ft int
51.Fo BN_nist_mod_384
52.Fa "BIGNUM *r"
53.Fa "const BIGNUM *a"
54.Fa "const BIGNUM *m"
55.Fa "BN_CTX *ctx"
56.Fc
57.Ft int
58.Fo BN_nist_mod_521
59.Fa "BIGNUM *r"
60.Fa "const BIGNUM *a"
61.Fa "const BIGNUM *m"
62.Fa "BN_CTX *ctx"
63.Fc
64.Sh DESCRIPTION
65These functions are optimized versions of
66.Xr BN_nnmod 3
67using precomputed tables.
68They ignore their
69.Fa m
70argument and use the following moduli instead:
71.Pp
72.Bl -tag -width BN_nist_mod_521() -offset indent -compact
73.It Fn BN_nist_mod_192
74.Xr BN_get0_nist_prime_192 3
75.It Fn BN_nist_mod_224
76.Xr BN_get0_nist_prime_224 3
77.It Fn BN_nist_mod_256
78.Xr BN_get0_nist_prime_256 3
79.It Fn BN_nist_mod_384
80.Xr BN_get0_nist_prime_384 3
81.It Fn BN_nist_mod_521
82.Xr BN_get0_nist_prime_521 3
83.El
84.Pp
85They reduce
86.Fa a
87modulo the respective prime number and place the non-negative remainder in
88.Fa r .
89.Pp
90These functions are designed to save time when performing multiplications
91in prime fields of these specific orders.
92Consequently, if
93.Fa a
94is negative or larger than the square of the modulus being used, they call
95.Xr BN_nnmod 3
96instead of attempting any optimization.
97.Sh RETURN VALUES
98These functions return 1 on success or 0 on error.
99.Sh SEE ALSO
100.Xr BN_get0_nist_prime_521 3 ,
101.Xr BN_nnmod 3 ,
102.Xr EC_GFp_nist_method 3
103.Sh STANDARDS
104.Rs
105.%T Digital Signature Standard (DSS)
106.%I National Institute of Standards and Technology
107.%R FIPS PUB 186-4
108.%U https://doi.org/10.6028/NIST.FIPS.186-4
109.%Q Information Technology Laboratory
110.%C Gaithersburg, Maryland
111.%D July 2013
112.%O Appendix D.1.2 Curves over Prime Fields
113.Re
generated by cgit v1.2.3-55-g6feb (git 2.39.1) at 2025-03-23 12:43:17 +0000