summaryrefslogtreecommitdiff
path: root/src
diff options
context:
space:
mode:
authorschwarze <>2024-12-06 13:10:43 +0000
committerschwarze <>2024-12-06 13:10:43 +0000
commitf86b82fe933b5698893ec827e2c05c6e54522e7d (patch)
tree1ce8e51eea0dc53cd903ab4b6dbd7303ff467f8c /src
parent1f4a0f25fae63c118c3bfa63b3a130d45c788288 (diff)
downloadopenbsd-f86b82fe933b5698893ec827e2c05c6e54522e7d.tar.gz
openbsd-f86b82fe933b5698893ec827e2c05c6e54522e7d.tar.bz2
openbsd-f86b82fe933b5698893ec827e2c05c6e54522e7d.zip
Delete the manual page EVP_PKEY_check(3).
All three functions documented in this page were deleted from the API by tb@ in evp.h rev. 1.136 on August 31 this year.
Diffstat (limited to 'src')
-rw-r--r--src/lib/libcrypto/man/EVP_PKEY_CTX_new.35
-rw-r--r--src/lib/libcrypto/man/EVP_PKEY_check.3149
-rw-r--r--src/lib/libcrypto/man/EVP_PKEY_new.33
-rw-r--r--src/lib/libcrypto/man/Makefile3
-rw-r--r--src/lib/libcrypto/man/evp.33
5 files changed, 5 insertions, 158 deletions
diff --git a/src/lib/libcrypto/man/EVP_PKEY_CTX_new.3 b/src/lib/libcrypto/man/EVP_PKEY_CTX_new.3
index cc0f5f16dc..6d9a94d108 100644
--- a/src/lib/libcrypto/man/EVP_PKEY_CTX_new.3
+++ b/src/lib/libcrypto/man/EVP_PKEY_CTX_new.3
@@ -1,4 +1,4 @@
1.\" $OpenBSD: EVP_PKEY_CTX_new.3,v 1.14 2024/07/21 08:36:43 tb Exp $ 1.\" $OpenBSD: EVP_PKEY_CTX_new.3,v 1.15 2024/12/06 13:10:43 schwarze Exp $
2.\" full merge up to: OpenSSL df75c2bf Dec 9 01:02:36 2018 +0100 2.\" full merge up to: OpenSSL df75c2bf Dec 9 01:02:36 2018 +0100
3.\" 3.\"
4.\" This file is a derived work. 4.\" This file is a derived work.
@@ -65,7 +65,7 @@
65.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED 65.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
66.\" OF THE POSSIBILITY OF SUCH DAMAGE. 66.\" OF THE POSSIBILITY OF SUCH DAMAGE.
67.\" 67.\"
68.Dd $Mdocdate: July 21 2024 $ 68.Dd $Mdocdate: December 6 2024 $
69.Dt EVP_PKEY_CTX_NEW 3 69.Dt EVP_PKEY_CTX_NEW 3
70.Os 70.Os
71.Sh NAME 71.Sh NAME
@@ -154,7 +154,6 @@ if an error occurred.
154.Xr EVP_DigestSignInit 3 , 154.Xr EVP_DigestSignInit 3 ,
155.Xr EVP_DigestVerifyInit 3 , 155.Xr EVP_DigestVerifyInit 3 ,
156.Xr EVP_PKEY_base_id 3 , 156.Xr EVP_PKEY_base_id 3 ,
157.Xr EVP_PKEY_check 3 ,
158.Xr EVP_PKEY_CTX_ctrl 3 , 157.Xr EVP_PKEY_CTX_ctrl 3 ,
159.Xr EVP_PKEY_CTX_get_operation 3 , 158.Xr EVP_PKEY_CTX_get_operation 3 ,
160.Xr EVP_PKEY_CTX_hkdf_mode 3 , 159.Xr EVP_PKEY_CTX_hkdf_mode 3 ,
diff --git a/src/lib/libcrypto/man/EVP_PKEY_check.3 b/src/lib/libcrypto/man/EVP_PKEY_check.3
deleted file mode 100644
index 5a78e3512e..0000000000
--- a/src/lib/libcrypto/man/EVP_PKEY_check.3
+++ /dev/null
@@ -1,149 +0,0 @@
1.\" $OpenBSD: EVP_PKEY_check.3,v 1.2 2022/07/14 14:49:09 tb 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: July 14 2022 $
18.Dt EVP_PKEY_CHECK 3
19.Os
20.Sh NAME
21.Nm EVP_PKEY_check ,
22.Nm EVP_PKEY_public_check ,
23.Nm EVP_PKEY_param_check
24.Nd key and parameter check functions
25.Sh SYNOPSIS
26.In openssl/evp.h
27.Ft int
28.Fn EVP_PKEY_check "EVP_PKEY_CTX *ctx"
29.Ft int
30.Fn EVP_PKEY_public_check "EVP_PKEY_CTX *ctx"
31.Ft int
32.Fn EVP_PKEY_param_check "EVP_PKEY_CTX *ctx"
33.Sh DESCRIPTION
34.Fn EVP_PKEY_check
35performs various sanity checks on the key contained in
36.Fa ctx
37but only supports a small number of key types by default.
38It preferably uses the function
39.Fa check
40configured for
41.Fa ctx
42with
43.Xr EVP_PKEY_meth_set_check 3 .
44It falls back to the function
45.Fa pkey_check
46configured for the private key contained in
47.Fa ctx
48with
49.Xr EVP_PKEY_asn1_set_check 3 .
50If that wasn't configured either, it attempts to use the following
51check functions:
52.Pp
53.Bl -tag -width 3n -compact -offset -indent
54.It DH
55not supported, return value \-2
56.It EC
57.Xr EC_KEY_check_key 3
58.It RSA
59.Xr RSA_check_key 3
60.El
61.Pp
62.Fn EVP_PKEY_public_check
63performs various sanity checks on the public key contained in
64.Fa ctx
65but only supports a small number of key types by default.
66It preferably uses the function
67.Fa public_check
68configured for
69.Fa ctx
70with
71.Xr EVP_PKEY_meth_set_public_check 3 .
72It falls back to the function
73.Fa pkey_public_check
74configured for the private key contained in
75.Fa ctx
76with
77.Xr EVP_PKEY_asn1_set_public_check 3 .
78If that wasn't configured either, it attempts to use the following
79check functions:
80.Pp
81.Bl -tag -width 3n -compact -offset -indent
82.It DH
83.Xr DH_check_pub_key 3
84.It EC
85.Xr EC_KEY_check_key 3
86.It RSA
87not supported, return value \-2
88.El
89.Pp
90.Fn EVP_PKEY_param_check
91performs various sanity checks on the key parameters contained in
92.Fa ctx
93but only supports a small number of key types by default.
94It preferably uses the function
95.Fa check
96configured for
97.Fa ctx
98with
99.Xr EVP_PKEY_meth_set_param_check 3 .
100It falls back to the function
101.Fa pkey_check
102configured for the private key contained in
103.Fa ctx
104with
105.Xr EVP_PKEY_asn1_set_param_check 3 .
106If that wasn't configured either, it attempts to use the following
107check functions:
108.Pp
109.Bl -tag -width 3n -compact -offset -indent
110.It DH
111.Xr DH_check 3
112.It EC
113.Xr EC_GROUP_check 3
114.It RSA
115not supported, return value \-2
116.El
117.Sh RETURN VALUES
118These functions return 1 if the check was performed and no problem
119was found, 0 if a problem was found or if the check could not be
120performed, for example because
121.Fa ctx
122does not contain an
123.Vt EVP_PKEY
124object, or \-2 if the required check function is neither configured for
125.Fa ctx
126nor for the
127.Vt PKEY
128contained therein, and the check in question is not supported by default
129for the algorithm in question either.
130.Sh SEE ALSO
131.Xr DH_check 3 ,
132.Xr EC_GROUP_check 3 ,
133.Xr EC_KEY_new 3 ,
134.Xr EVP_PKEY_asn1_new 3 ,
135.Xr EVP_PKEY_CTX_new 3 ,
136.Xr EVP_PKEY_meth_new 3 ,
137.Xr EVP_PKEY_new 3 ,
138.Xr RSA_check_key 3
139.Sh HISTORY
140These functions first appeared in OpenSSL 1.1.1
141and have been available since
142.Ox 7.1 .
143.Sh BUGS
144For EC keys,
145.Fn EVP_PKEY_public_check
146also checks the
147.Em private
148key and fails if there is a problem with any of the private
149components, even if no problem is found with the public key.
diff --git a/src/lib/libcrypto/man/EVP_PKEY_new.3 b/src/lib/libcrypto/man/EVP_PKEY_new.3
index 4090db990b..d21f177ca8 100644
--- a/src/lib/libcrypto/man/EVP_PKEY_new.3
+++ b/src/lib/libcrypto/man/EVP_PKEY_new.3
@@ -1,4 +1,4 @@
1.\" $OpenBSD: EVP_PKEY_new.3,v 1.23 2024/12/06 12:51:13 schwarze Exp $ 1.\" $OpenBSD: EVP_PKEY_new.3,v 1.24 2024/12/06 13:10:43 schwarze Exp $
2.\" full merge up to: OpenSSL 4dcfdfce May 27 11:50:05 2020 +0100 2.\" full merge up to: OpenSSL 4dcfdfce May 27 11:50:05 2020 +0100
3.\" 3.\"
4.\" This file is a derived work. 4.\" This file is a derived work.
@@ -311,7 +311,6 @@ with
311.Xr d2i_PrivateKey 3 , 311.Xr d2i_PrivateKey 3 ,
312.Xr evp 3 , 312.Xr evp 3 ,
313.Xr EVP_PKCS82PKEY 3 , 313.Xr EVP_PKCS82PKEY 3 ,
314.Xr EVP_PKEY_check 3 ,
315.Xr EVP_PKEY_cmp 3 , 314.Xr EVP_PKEY_cmp 3 ,
316.Xr EVP_PKEY_CTX_new 3 , 315.Xr EVP_PKEY_CTX_new 3 ,
317.Xr EVP_PKEY_get_default_digest_nid 3 , 316.Xr EVP_PKEY_get_default_digest_nid 3 ,
diff --git a/src/lib/libcrypto/man/Makefile b/src/lib/libcrypto/man/Makefile
index da93f14a43..22cf0ad171 100644
--- a/src/lib/libcrypto/man/Makefile
+++ b/src/lib/libcrypto/man/Makefile
@@ -1,4 +1,4 @@
1# $OpenBSD: Makefile,v 1.297 2024/12/06 12:51:13 schwarze Exp $ 1# $OpenBSD: Makefile,v 1.298 2024/12/06 13:10:43 schwarze Exp $
2 2
3.include <bsd.own.mk> 3.include <bsd.own.mk>
4 4
@@ -178,7 +178,6 @@ MAN= \
178 EVP_PKEY_CTX_set_hkdf_md.3 \ 178 EVP_PKEY_CTX_set_hkdf_md.3 \
179 EVP_PKEY_CTX_set_tls1_prf_md.3 \ 179 EVP_PKEY_CTX_set_tls1_prf_md.3 \
180 EVP_PKEY_asn1_get_count.3 \ 180 EVP_PKEY_asn1_get_count.3 \
181 EVP_PKEY_check.3 \
182 EVP_PKEY_cmp.3 \ 181 EVP_PKEY_cmp.3 \
183 EVP_PKEY_decrypt.3 \ 182 EVP_PKEY_decrypt.3 \
184 EVP_PKEY_derive.3 \ 183 EVP_PKEY_derive.3 \
diff --git a/src/lib/libcrypto/man/evp.3 b/src/lib/libcrypto/man/evp.3
index 0168d95875..4f05cc2b2a 100644
--- a/src/lib/libcrypto/man/evp.3
+++ b/src/lib/libcrypto/man/evp.3
@@ -1,4 +1,4 @@
1.\" $OpenBSD: evp.3,v 1.34 2024/12/06 12:51:13 schwarze Exp $ 1.\" $OpenBSD: evp.3,v 1.35 2024/12/06 13:10:43 schwarze Exp $
2.\" full merge up to: OpenSSL man7/evp 24a535ea Sep 22 13:14:20 2020 +0100 2.\" full merge up to: OpenSSL man7/evp 24a535ea Sep 22 13:14:20 2020 +0100
3.\" 3.\"
4.\" This file was written by Ulf Moeller <ulf@openssl.org>, 4.\" This file was written by Ulf Moeller <ulf@openssl.org>,
@@ -204,7 +204,6 @@ family of functions provides base64 encoding and decoding.
204.Xr EVP_OpenInit 3 , 204.Xr EVP_OpenInit 3 ,
205.Xr EVP_PKCS82PKEY 3 , 205.Xr EVP_PKCS82PKEY 3 ,
206.Xr EVP_PKEY_asn1_get_count 3 , 206.Xr EVP_PKEY_asn1_get_count 3 ,
207.Xr EVP_PKEY_check 3 ,
208.Xr EVP_PKEY_cmp 3 , 207.Xr EVP_PKEY_cmp 3 ,
209.Xr EVP_PKEY_CTX_ctrl 3 , 208.Xr EVP_PKEY_CTX_ctrl 3 ,
210.Xr EVP_PKEY_CTX_get_operation 3 , 209.Xr EVP_PKEY_CTX_get_operation 3 ,