summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authortb <>2025-03-08 16:38:13 +0000
committertb <>2025-03-08 16:38:13 +0000
commit756b89f52b27d14dbe297ad7defa2b0f47b36994 (patch)
tree53b568df012d739829b024dfde0fa22c7656f6cd
parent1e07089babecfe48429157576c9b04908a399a45 (diff)
downloadopenbsd-756b89f52b27d14dbe297ad7defa2b0f47b36994.tar.gz
openbsd-756b89f52b27d14dbe297ad7defa2b0f47b36994.tar.bz2
openbsd-756b89f52b27d14dbe297ad7defa2b0f47b36994.zip
Remove EC_GFp_* and EC_METHOD_get_field_type docs
-rw-r--r--src/lib/libcrypto/man/EC_GFp_simple_method.3136
-rw-r--r--src/lib/libcrypto/man/EC_GROUP_copy.35
-rw-r--r--src/lib/libcrypto/man/EC_GROUP_new.39
-rw-r--r--src/lib/libcrypto/man/EC_KEY_new.35
-rw-r--r--src/lib/libcrypto/man/EC_POINT_add.35
-rw-r--r--src/lib/libcrypto/man/EC_POINT_new.35
-rw-r--r--src/lib/libcrypto/man/Makefile3
7 files changed, 12 insertions, 156 deletions
diff --git a/src/lib/libcrypto/man/EC_GFp_simple_method.3 b/src/lib/libcrypto/man/EC_GFp_simple_method.3
deleted file mode 100644
index fd9f71e7f4..0000000000
--- a/src/lib/libcrypto/man/EC_GFp_simple_method.3
+++ /dev/null
@@ -1,136 +0,0 @@
1.\" $OpenBSD: EC_GFp_simple_method.3,v 1.12 2023/04/27 08:47:04 tb Exp $
2.\" OpenSSL b97fdb57 Nov 11 09:33:09 2016 +0100
3.\"
4.\" This file was written by Matt Caswell <matt@openssl.org>.
5.\" Copyright (c) 2013 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: April 27 2023 $
52.Dt EC_GFP_SIMPLE_METHOD 3
53.Os
54.Sh NAME
55.Nm EC_GFp_simple_method ,
56.Nm EC_GFp_mont_method ,
57.Nm EC_METHOD_get_field_type
58.Nd obtain EC_METHOD objects
59.Sh SYNOPSIS
60.In openssl/ec.h
61.Ft const EC_METHOD *
62.Fn EC_GFp_simple_method void
63.Ft const EC_METHOD *
64.Fn EC_GFp_mont_method void
65.Ft int
66.Fo EC_METHOD_get_field_type
67.Fa "const EC_METHOD *meth"
68.Fc
69.Sh DESCRIPTION
70The elliptic curve library provides a number of different
71implementations through a single common interface.
72Each implementation is optimised for different scenarios.
73An implementation is represented by an
74.Vt EC_METHOD
75structure.
76.Pp
77When constructing a curve using
78.Xr EC_GROUP_new 3 ,
79an implementation method must be provided.
80The functions described here all return a const pointer to an
81.Sy EC_METHOD
82structure that can be passed to
83.Xr EC_GROUP_new 3 .
84It is important that the correct implementation type for the form
85of curve selected is used.
86.Pp
87For Fp curves the lowest common denominator implementation is the
88.Fn EC_GFp_simple_method
89implementation.
90All other implementations are based on this one.
91.Fn EC_GFp_mont_method
92adds the use of Montgomery multiplication (see
93.Xr BN_mod_mul_montgomery 3 ) .
94.Pp
95.Fn EC_METHOD_get_field_type
96identifies what type of field the
97.Vt EC_METHOD
98structure supports.
99If the field type is Fp, then the value
100.Dv NID_X9_62_prime_field
101is returned.
102If the field type is F2^m, then the value
103.Dv NID_X9_62_characteristic_two_field
104is returned.
105These values are defined in the
106.In openssl/objects.h
107header file.
108.Sh RETURN VALUES
109All
110.Fn EC_GFp*
111functions always return a const pointer to an
112.Vt EC_METHOD
113structure.
114.Pp
115.Fn EC_METHOD_get_field_type
116returns an integer that identifies the type of field the
117.Vt EC_METHOD
118structure supports.
119.Sh SEE ALSO
120.Xr BN_mod_mul_montgomery 3 ,
121.Xr d2i_ECPKParameters 3 ,
122.Xr EC_GROUP_copy 3 ,
123.Xr EC_GROUP_new 3 ,
124.Xr EC_KEY_new 3 ,
125.Xr EC_POINT_add 3 ,
126.Xr EC_POINT_new 3
127.Sh HISTORY
128.Fn EC_GFp_simple_method
129and
130.Fn EC_GFp_mont_method
131first appeared in OpenSSL 0.9.7 and have been available since
132.Ox 3.2 .
133.Pp
134.Fn EC_METHOD_get_field_type
135first appeared in OpenSSL 0.9.8 and has been available since
136.Ox 4.5 .
diff --git a/src/lib/libcrypto/man/EC_GROUP_copy.3 b/src/lib/libcrypto/man/EC_GROUP_copy.3
index c83ee3d5b1..c3333ad343 100644
--- a/src/lib/libcrypto/man/EC_GROUP_copy.3
+++ b/src/lib/libcrypto/man/EC_GROUP_copy.3
@@ -1,4 +1,4 @@
1.\" $OpenBSD: EC_GROUP_copy.3,v 1.14 2023/06/28 18:07:07 tb Exp $ 1.\" $OpenBSD: EC_GROUP_copy.3,v 1.15 2025/03/08 16:38:13 tb Exp $
2.\" full merge up to: OpenSSL d900a015 Oct 8 14:40:42 2015 +0200 2.\" full merge up to: OpenSSL d900a015 Oct 8 14:40:42 2015 +0200
3.\" selective merge up to: OpenSSL 24c23e1f Aug 22 10:51:25 2019 +0530 3.\" selective merge up to: OpenSSL 24c23e1f Aug 22 10:51:25 2019 +0530
4.\" 4.\"
@@ -51,7 +51,7 @@
51.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED 51.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
52.\" OF THE POSSIBILITY OF SUCH DAMAGE. 52.\" OF THE POSSIBILITY OF SUCH DAMAGE.
53.\" 53.\"
54.Dd $Mdocdate: June 28 2023 $ 54.Dd $Mdocdate: March 8 2025 $
55.Dt EC_GROUP_COPY 3 55.Dt EC_GROUP_COPY 3
56.Os 56.Os
57.Sh NAME 57.Sh NAME
@@ -472,7 +472,6 @@ or -1 on error.
472always returns 0. 472always returns 0.
473.Sh SEE ALSO 473.Sh SEE ALSO
474.Xr d2i_ECPKParameters 3 , 474.Xr d2i_ECPKParameters 3 ,
475.Xr EC_GFp_simple_method 3 ,
476.Xr EC_GROUP_new 3 , 475.Xr EC_GROUP_new 3 ,
477.Xr EC_KEY_new 3 , 476.Xr EC_KEY_new 3 ,
478.Xr EC_POINT_add 3 , 477.Xr EC_POINT_add 3 ,
diff --git a/src/lib/libcrypto/man/EC_GROUP_new.3 b/src/lib/libcrypto/man/EC_GROUP_new.3
index e6cfb9a73b..83e3e4c870 100644
--- a/src/lib/libcrypto/man/EC_GROUP_new.3
+++ b/src/lib/libcrypto/man/EC_GROUP_new.3
@@ -1,4 +1,4 @@
1.\" $OpenBSD: EC_GROUP_new.3,v 1.17 2024/04/27 07:41:47 tb Exp $ 1.\" $OpenBSD: EC_GROUP_new.3,v 1.18 2025/03/08 16:38:13 tb Exp $
2.\" OpenSSL 6328d367 Sat Jul 4 21:58:30 2020 +0200 2.\" OpenSSL 6328d367 Sat Jul 4 21:58:30 2020 +0200
3.\" 3.\"
4.\" This file was written by Matt Caswell <matt@openssl.org>. 4.\" This file was written by Matt Caswell <matt@openssl.org>.
@@ -48,7 +48,7 @@
48.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED 48.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
49.\" OF THE POSSIBILITY OF SUCH DAMAGE. 49.\" OF THE POSSIBILITY OF SUCH DAMAGE.
50.\" 50.\"
51.Dd $Mdocdate: April 27 2024 $ 51.Dd $Mdocdate: March 8 2025 $
52.Dt EC_GROUP_NEW 3 52.Dt EC_GROUP_NEW 3
53.Os 53.Os
54.Sh NAME 54.Sh NAME
@@ -154,9 +154,7 @@ structure is used to represent the definition of an elliptic curve.
154A new curve can be constructed by calling 154A new curve can be constructed by calling
155.Fn EC_GROUP_new , 155.Fn EC_GROUP_new ,
156using the implementation provided by 156using the implementation provided by
157.Fa meth 157.Fa meth .
158(see
159.Xr EC_GFp_simple_method 3 ) .
160It is then necessary to call 158It is then necessary to call
161.Fn EC_GROUP_set_curve 159.Fn EC_GROUP_set_curve
162to set the curve parameters. 160to set the curve parameters.
@@ -320,7 +318,6 @@ return 1 on success or 0 on error.
320.Sh SEE ALSO 318.Sh SEE ALSO
321.Xr crypto 3 , 319.Xr crypto 3 ,
322.Xr d2i_ECPKParameters 3 , 320.Xr d2i_ECPKParameters 3 ,
323.Xr EC_GFp_simple_method 3 ,
324.Xr EC_GROUP_copy 3 , 321.Xr EC_GROUP_copy 3 ,
325.Xr EC_KEY_new 3 , 322.Xr EC_KEY_new 3 ,
326.Xr EC_POINT_add 3 , 323.Xr EC_POINT_add 3 ,
diff --git a/src/lib/libcrypto/man/EC_KEY_new.3 b/src/lib/libcrypto/man/EC_KEY_new.3
index 500db339ac..c24cb080ef 100644
--- a/src/lib/libcrypto/man/EC_KEY_new.3
+++ b/src/lib/libcrypto/man/EC_KEY_new.3
@@ -1,4 +1,4 @@
1.\" $OpenBSD: EC_KEY_new.3,v 1.20 2024/07/14 05:53:09 jsg Exp $ 1.\" $OpenBSD: EC_KEY_new.3,v 1.21 2025/03/08 16:38:13 tb Exp $
2.\" full merge up to: OpenSSL 3aef36ff Jan 5 13:06:03 2016 -0500 2.\" full merge up to: OpenSSL 3aef36ff Jan 5 13:06:03 2016 -0500
3.\" partial merge up to: OpenSSL e9b77246 Jan 20 19:58:49 2017 +0100 3.\" partial merge up to: OpenSSL e9b77246 Jan 20 19:58:49 2017 +0100
4.\" 4.\"
@@ -49,7 +49,7 @@
49.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED 49.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
50.\" OF THE POSSIBILITY OF SUCH DAMAGE. 50.\" OF THE POSSIBILITY OF SUCH DAMAGE.
51.\" 51.\"
52.Dd $Mdocdate: July 14 2024 $ 52.Dd $Mdocdate: March 8 2025 $
53.Dt EC_KEY_NEW 3 53.Dt EC_KEY_NEW 3
54.Os 54.Os
55.Sh NAME 55.Sh NAME
@@ -488,7 +488,6 @@ returns the point_conversion_form for the
488.Vt EC_KEY . 488.Vt EC_KEY .
489.Sh SEE ALSO 489.Sh SEE ALSO
490.Xr d2i_ECPKParameters 3 , 490.Xr d2i_ECPKParameters 3 ,
491.Xr EC_GFp_simple_method 3 ,
492.Xr EC_GROUP_copy 3 , 491.Xr EC_GROUP_copy 3 ,
493.Xr EC_GROUP_new 3 , 492.Xr EC_GROUP_new 3 ,
494.Xr EC_KEY_METHOD_new 3 , 493.Xr EC_KEY_METHOD_new 3 ,
diff --git a/src/lib/libcrypto/man/EC_POINT_add.3 b/src/lib/libcrypto/man/EC_POINT_add.3
index 6c19f6d270..c9f0a61226 100644
--- a/src/lib/libcrypto/man/EC_POINT_add.3
+++ b/src/lib/libcrypto/man/EC_POINT_add.3
@@ -1,4 +1,4 @@
1.\" $OpenBSD: EC_POINT_add.3,v 1.12 2023/04/12 09:55:22 jsg Exp $ 1.\" $OpenBSD: EC_POINT_add.3,v 1.13 2025/03/08 16:38:13 tb Exp $
2.\" OpenSSL b97fdb57 Nov 11 09:33:09 2016 +0100 2.\" OpenSSL b97fdb57 Nov 11 09:33:09 2016 +0100
3.\" 3.\"
4.\" This file was written by Matt Caswell <matt@openssl.org>. 4.\" This file was written by Matt Caswell <matt@openssl.org>.
@@ -48,7 +48,7 @@
48.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED 48.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
49.\" OF THE POSSIBILITY OF SUCH DAMAGE. 49.\" OF THE POSSIBILITY OF SUCH DAMAGE.
50.\" 50.\"
51.Dd $Mdocdate: April 12 2023 $ 51.Dd $Mdocdate: March 8 2025 $
52.Dt EC_POINT_ADD 3 52.Dt EC_POINT_ADD 3
53.Os 53.Os
54.Sh NAME 54.Sh NAME
@@ -283,7 +283,6 @@ returns 1 if the points are not equal, 0 if they are, or -1 on error.
283returns 1 if a precomputation has been done or 0 if not. 283returns 1 if a precomputation has been done or 0 if not.
284.Sh SEE ALSO 284.Sh SEE ALSO
285.Xr d2i_ECPKParameters 3 , 285.Xr d2i_ECPKParameters 3 ,
286.Xr EC_GFp_simple_method 3 ,
287.Xr EC_GROUP_copy 3 , 286.Xr EC_GROUP_copy 3 ,
288.Xr EC_GROUP_new 3 , 287.Xr EC_GROUP_new 3 ,
289.Xr EC_KEY_new 3 , 288.Xr EC_KEY_new 3 ,
diff --git a/src/lib/libcrypto/man/EC_POINT_new.3 b/src/lib/libcrypto/man/EC_POINT_new.3
index decfd3383d..a203dabf5d 100644
--- a/src/lib/libcrypto/man/EC_POINT_new.3
+++ b/src/lib/libcrypto/man/EC_POINT_new.3
@@ -1,4 +1,4 @@
1.\" $OpenBSD: EC_POINT_new.3,v 1.14 2023/04/27 09:39:52 tb Exp $ 1.\" $OpenBSD: EC_POINT_new.3,v 1.15 2025/03/08 16:38:13 tb Exp $
2.\" full merge up to: OpenSSL 50db8163 Jul 30 16:56:41 2018 +0100 2.\" full merge up to: OpenSSL 50db8163 Jul 30 16:56:41 2018 +0100
3.\" 3.\"
4.\" This file was written by Matt Caswell <matt@openssl.org>. 4.\" This file was written by Matt Caswell <matt@openssl.org>.
@@ -48,7 +48,7 @@
48.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED 48.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
49.\" OF THE POSSIBILITY OF SUCH DAMAGE. 49.\" OF THE POSSIBILITY OF SUCH DAMAGE.
50.\" 50.\"
51.Dd $Mdocdate: April 27 2023 $ 51.Dd $Mdocdate: March 8 2025 $
52.Dt EC_POINT_NEW 3 52.Dt EC_POINT_NEW 3
53.Os 53.Os
54.Sh NAME 54.Sh NAME
@@ -485,7 +485,6 @@ supplied or
485on error. 485on error.
486.Sh SEE ALSO 486.Sh SEE ALSO
487.Xr d2i_ECPKParameters 3 , 487.Xr d2i_ECPKParameters 3 ,
488.Xr EC_GFp_simple_method 3 ,
489.Xr EC_GROUP_copy 3 , 488.Xr EC_GROUP_copy 3 ,
490.Xr EC_GROUP_new 3 , 489.Xr EC_GROUP_new 3 ,
491.Xr EC_KEY_new 3 , 490.Xr EC_KEY_new 3 ,
diff --git a/src/lib/libcrypto/man/Makefile b/src/lib/libcrypto/man/Makefile
index 8df75fe284..8330fe11a3 100644
--- a/src/lib/libcrypto/man/Makefile
+++ b/src/lib/libcrypto/man/Makefile
@@ -1,4 +1,4 @@
1# $OpenBSD: Makefile,v 1.305 2024/12/27 15:30:17 schwarze Exp $ 1# $OpenBSD: Makefile,v 1.306 2025/03/08 16:38:13 tb Exp $
2 2
3.include <bsd.own.mk> 3.include <bsd.own.mk>
4 4
@@ -133,7 +133,6 @@ MAN= \
133 DSA_size.3 \ 133 DSA_size.3 \
134 ECDH_compute_key.3 \ 134 ECDH_compute_key.3 \
135 ECDSA_SIG_new.3 \ 135 ECDSA_SIG_new.3 \
136 EC_GFp_simple_method.3 \
137 EC_GROUP_copy.3 \ 136 EC_GROUP_copy.3 \
138 EC_GROUP_new.3 \ 137 EC_GROUP_new.3 \
139 EC_KEY_METHOD_new.3 \ 138 EC_KEY_METHOD_new.3 \