From 756b89f52b27d14dbe297ad7defa2b0f47b36994 Mon Sep 17 00:00:00 2001 From: tb <> Date: Sat, 8 Mar 2025 16:38:13 +0000 Subject: Remove EC_GFp_* and EC_METHOD_get_field_type docs --- src/lib/libcrypto/man/EC_GFp_simple_method.3 | 136 --------------------------- src/lib/libcrypto/man/EC_GROUP_copy.3 | 5 +- src/lib/libcrypto/man/EC_GROUP_new.3 | 9 +- src/lib/libcrypto/man/EC_KEY_new.3 | 5 +- src/lib/libcrypto/man/EC_POINT_add.3 | 5 +- src/lib/libcrypto/man/EC_POINT_new.3 | 5 +- src/lib/libcrypto/man/Makefile | 3 +- 7 files changed, 12 insertions(+), 156 deletions(-) delete mode 100644 src/lib/libcrypto/man/EC_GFp_simple_method.3 (limited to 'src') 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 @@ -.\" $OpenBSD: EC_GFp_simple_method.3,v 1.12 2023/04/27 08:47:04 tb Exp $ -.\" OpenSSL b97fdb57 Nov 11 09:33:09 2016 +0100 -.\" -.\" This file was written by Matt Caswell . -.\" Copyright (c) 2013 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: April 27 2023 $ -.Dt EC_GFP_SIMPLE_METHOD 3 -.Os -.Sh NAME -.Nm EC_GFp_simple_method , -.Nm EC_GFp_mont_method , -.Nm EC_METHOD_get_field_type -.Nd obtain EC_METHOD objects -.Sh SYNOPSIS -.In openssl/ec.h -.Ft const EC_METHOD * -.Fn EC_GFp_simple_method void -.Ft const EC_METHOD * -.Fn EC_GFp_mont_method void -.Ft int -.Fo EC_METHOD_get_field_type -.Fa "const EC_METHOD *meth" -.Fc -.Sh DESCRIPTION -The elliptic curve library provides a number of different -implementations through a single common interface. -Each implementation is optimised for different scenarios. -An implementation is represented by an -.Vt EC_METHOD -structure. -.Pp -When constructing a curve using -.Xr EC_GROUP_new 3 , -an implementation method must be provided. -The functions described here all return a const pointer to an -.Sy EC_METHOD -structure that can be passed to -.Xr EC_GROUP_new 3 . -It is important that the correct implementation type for the form -of curve selected is used. -.Pp -For Fp curves the lowest common denominator implementation is the -.Fn EC_GFp_simple_method -implementation. -All other implementations are based on this one. -.Fn EC_GFp_mont_method -adds the use of Montgomery multiplication (see -.Xr BN_mod_mul_montgomery 3 ) . -.Pp -.Fn EC_METHOD_get_field_type -identifies what type of field the -.Vt EC_METHOD -structure supports. -If the field type is Fp, then the value -.Dv NID_X9_62_prime_field -is returned. -If the field type is F2^m, then the value -.Dv NID_X9_62_characteristic_two_field -is returned. -These values are defined in the -.In openssl/objects.h -header file. -.Sh RETURN VALUES -All -.Fn EC_GFp* -functions always return a const pointer to an -.Vt EC_METHOD -structure. -.Pp -.Fn EC_METHOD_get_field_type -returns an integer that identifies the type of field the -.Vt EC_METHOD -structure supports. -.Sh SEE ALSO -.Xr BN_mod_mul_montgomery 3 , -.Xr d2i_ECPKParameters 3 , -.Xr EC_GROUP_copy 3 , -.Xr EC_GROUP_new 3 , -.Xr EC_KEY_new 3 , -.Xr EC_POINT_add 3 , -.Xr EC_POINT_new 3 -.Sh HISTORY -.Fn EC_GFp_simple_method -and -.Fn EC_GFp_mont_method -first appeared in OpenSSL 0.9.7 and have been available since -.Ox 3.2 . -.Pp -.Fn EC_METHOD_get_field_type -first appeared in OpenSSL 0.9.8 and has been available since -.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 @@ -.\" $OpenBSD: EC_GROUP_copy.3,v 1.14 2023/06/28 18:07:07 tb Exp $ +.\" $OpenBSD: EC_GROUP_copy.3,v 1.15 2025/03/08 16:38:13 tb Exp $ .\" full merge up to: OpenSSL d900a015 Oct 8 14:40:42 2015 +0200 .\" selective merge up to: OpenSSL 24c23e1f Aug 22 10:51:25 2019 +0530 .\" @@ -51,7 +51,7 @@ .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED .\" OF THE POSSIBILITY OF SUCH DAMAGE. .\" -.Dd $Mdocdate: June 28 2023 $ +.Dd $Mdocdate: March 8 2025 $ .Dt EC_GROUP_COPY 3 .Os .Sh NAME @@ -472,7 +472,6 @@ or -1 on error. always returns 0. .Sh SEE ALSO .Xr d2i_ECPKParameters 3 , -.Xr EC_GFp_simple_method 3 , .Xr EC_GROUP_new 3 , .Xr EC_KEY_new 3 , .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 @@ -.\" $OpenBSD: EC_GROUP_new.3,v 1.17 2024/04/27 07:41:47 tb Exp $ +.\" $OpenBSD: EC_GROUP_new.3,v 1.18 2025/03/08 16:38:13 tb Exp $ .\" OpenSSL 6328d367 Sat Jul 4 21:58:30 2020 +0200 .\" .\" This file was written by Matt Caswell . @@ -48,7 +48,7 @@ .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED .\" OF THE POSSIBILITY OF SUCH DAMAGE. .\" -.Dd $Mdocdate: April 27 2024 $ +.Dd $Mdocdate: March 8 2025 $ .Dt EC_GROUP_NEW 3 .Os .Sh NAME @@ -154,9 +154,7 @@ structure is used to represent the definition of an elliptic curve. A new curve can be constructed by calling .Fn EC_GROUP_new , using the implementation provided by -.Fa meth -(see -.Xr EC_GFp_simple_method 3 ) . +.Fa meth . It is then necessary to call .Fn EC_GROUP_set_curve to set the curve parameters. @@ -320,7 +318,6 @@ return 1 on success or 0 on error. .Sh SEE ALSO .Xr crypto 3 , .Xr d2i_ECPKParameters 3 , -.Xr EC_GFp_simple_method 3 , .Xr EC_GROUP_copy 3 , .Xr EC_KEY_new 3 , .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 @@ -.\" $OpenBSD: EC_KEY_new.3,v 1.20 2024/07/14 05:53:09 jsg Exp $ +.\" $OpenBSD: EC_KEY_new.3,v 1.21 2025/03/08 16:38:13 tb Exp $ .\" full merge up to: OpenSSL 3aef36ff Jan 5 13:06:03 2016 -0500 .\" partial merge up to: OpenSSL e9b77246 Jan 20 19:58:49 2017 +0100 .\" @@ -49,7 +49,7 @@ .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED .\" OF THE POSSIBILITY OF SUCH DAMAGE. .\" -.Dd $Mdocdate: July 14 2024 $ +.Dd $Mdocdate: March 8 2025 $ .Dt EC_KEY_NEW 3 .Os .Sh NAME @@ -488,7 +488,6 @@ returns the point_conversion_form for the .Vt EC_KEY . .Sh SEE ALSO .Xr d2i_ECPKParameters 3 , -.Xr EC_GFp_simple_method 3 , .Xr EC_GROUP_copy 3 , .Xr EC_GROUP_new 3 , .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 @@ -.\" $OpenBSD: EC_POINT_add.3,v 1.12 2023/04/12 09:55:22 jsg Exp $ +.\" $OpenBSD: EC_POINT_add.3,v 1.13 2025/03/08 16:38:13 tb Exp $ .\" OpenSSL b97fdb57 Nov 11 09:33:09 2016 +0100 .\" .\" This file was written by Matt Caswell . @@ -48,7 +48,7 @@ .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED .\" OF THE POSSIBILITY OF SUCH DAMAGE. .\" -.Dd $Mdocdate: April 12 2023 $ +.Dd $Mdocdate: March 8 2025 $ .Dt EC_POINT_ADD 3 .Os .Sh NAME @@ -283,7 +283,6 @@ returns 1 if the points are not equal, 0 if they are, or -1 on error. returns 1 if a precomputation has been done or 0 if not. .Sh SEE ALSO .Xr d2i_ECPKParameters 3 , -.Xr EC_GFp_simple_method 3 , .Xr EC_GROUP_copy 3 , .Xr EC_GROUP_new 3 , .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 @@ -.\" $OpenBSD: EC_POINT_new.3,v 1.14 2023/04/27 09:39:52 tb Exp $ +.\" $OpenBSD: EC_POINT_new.3,v 1.15 2025/03/08 16:38:13 tb Exp $ .\" full merge up to: OpenSSL 50db8163 Jul 30 16:56:41 2018 +0100 .\" .\" This file was written by Matt Caswell . @@ -48,7 +48,7 @@ .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED .\" OF THE POSSIBILITY OF SUCH DAMAGE. .\" -.Dd $Mdocdate: April 27 2023 $ +.Dd $Mdocdate: March 8 2025 $ .Dt EC_POINT_NEW 3 .Os .Sh NAME @@ -485,7 +485,6 @@ supplied or on error. .Sh SEE ALSO .Xr d2i_ECPKParameters 3 , -.Xr EC_GFp_simple_method 3 , .Xr EC_GROUP_copy 3 , .Xr EC_GROUP_new 3 , .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 @@ -# $OpenBSD: Makefile,v 1.305 2024/12/27 15:30:17 schwarze Exp $ +# $OpenBSD: Makefile,v 1.306 2025/03/08 16:38:13 tb Exp $ .include @@ -133,7 +133,6 @@ MAN= \ DSA_size.3 \ ECDH_compute_key.3 \ ECDSA_SIG_new.3 \ - EC_GFp_simple_method.3 \ EC_GROUP_copy.3 \ EC_GROUP_new.3 \ EC_KEY_METHOD_new.3 \ -- cgit v1.2.3-55-g6feb