diff options
Diffstat (limited to 'src/lib/libcrypto/man/ECDSA_SIG_new.3')
-rw-r--r-- | src/lib/libcrypto/man/ECDSA_SIG_new.3 | 100 |
1 files changed, 9 insertions, 91 deletions
diff --git a/src/lib/libcrypto/man/ECDSA_SIG_new.3 b/src/lib/libcrypto/man/ECDSA_SIG_new.3 index 61815128a8..d278fcaaa7 100644 --- a/src/lib/libcrypto/man/ECDSA_SIG_new.3 +++ b/src/lib/libcrypto/man/ECDSA_SIG_new.3 | |||
@@ -1,4 +1,4 @@ | |||
1 | .\" $OpenBSD: ECDSA_SIG_new.3,v 1.17 2023/03/07 06:12:27 tb Exp $ | 1 | .\" $OpenBSD: ECDSA_SIG_new.3,v 1.18 2023/07/20 09:28:30 tb Exp $ |
2 | .\" full merge up to: OpenSSL e9b77246 Jan 20 19:58:49 2017 +0100 | 2 | .\" full merge up to: OpenSSL e9b77246 Jan 20 19:58:49 2017 +0100 |
3 | .\" selective merge up to: OpenSSL da4ea0cf Aug 5 16:13:24 2019 +0100 | 3 | .\" selective merge up to: OpenSSL da4ea0cf Aug 5 16:13:24 2019 +0100 |
4 | .\" | 4 | .\" |
@@ -50,7 +50,7 @@ | |||
50 | .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED | 50 | .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED |
51 | .\" OF THE POSSIBILITY OF SUCH DAMAGE. | 51 | .\" OF THE POSSIBILITY OF SUCH DAMAGE. |
52 | .\" | 52 | .\" |
53 | .Dd $Mdocdate: March 7 2023 $ | 53 | .Dd $Mdocdate: July 20 2023 $ |
54 | .Dt ECDSA_SIG_NEW 3 | 54 | .Dt ECDSA_SIG_NEW 3 |
55 | .Os | 55 | .Os |
56 | .Sh NAME | 56 | .Sh NAME |
@@ -63,12 +63,9 @@ | |||
63 | .Nm i2d_ECDSA_SIG , | 63 | .Nm i2d_ECDSA_SIG , |
64 | .Nm d2i_ECDSA_SIG , | 64 | .Nm d2i_ECDSA_SIG , |
65 | .Nm ECDSA_size , | 65 | .Nm ECDSA_size , |
66 | .Nm ECDSA_sign_setup , | ||
67 | .Nm ECDSA_sign , | 66 | .Nm ECDSA_sign , |
68 | .Nm ECDSA_sign_ex , | ||
69 | .Nm ECDSA_verify , | 67 | .Nm ECDSA_verify , |
70 | .Nm ECDSA_do_sign , | 68 | .Nm ECDSA_do_sign , |
71 | .Nm ECDSA_do_sign_ex , | ||
72 | .Nm ECDSA_do_verify , | 69 | .Nm ECDSA_do_verify , |
73 | .Nm ECDSA_OpenSSL , | 70 | .Nm ECDSA_OpenSSL , |
74 | .Nm ECDSA_get_default_method , | 71 | .Nm ECDSA_get_default_method , |
@@ -121,13 +118,6 @@ | |||
121 | .Fa "const EC_KEY *eckey" | 118 | .Fa "const EC_KEY *eckey" |
122 | .Fc | 119 | .Fc |
123 | .Ft int | 120 | .Ft int |
124 | .Fo ECDSA_sign_setup | ||
125 | .Fa "EC_KEY *eckey" | ||
126 | .Fa "BN_CTX *ctx" | ||
127 | .Fa "BIGNUM **kinv" | ||
128 | .Fa "BIGNUM **rp" | ||
129 | .Fc | ||
130 | .Ft int | ||
131 | .Fo ECDSA_sign | 121 | .Fo ECDSA_sign |
132 | .Fa "int type" | 122 | .Fa "int type" |
133 | .Fa "const unsigned char *dgst" | 123 | .Fa "const unsigned char *dgst" |
@@ -137,17 +127,6 @@ | |||
137 | .Fa "EC_KEY *eckey" | 127 | .Fa "EC_KEY *eckey" |
138 | .Fc | 128 | .Fc |
139 | .Ft int | 129 | .Ft int |
140 | .Fo ECDSA_sign_ex | ||
141 | .Fa "int type" | ||
142 | .Fa "const unsigned char *dgst" | ||
143 | .Fa "int dgstlen" | ||
144 | .Fa "unsigned char *sig" | ||
145 | .Fa "unsigned int *siglen" | ||
146 | .Fa "const BIGNUM *kinv" | ||
147 | .Fa "const BIGNUM *rp" | ||
148 | .Fa "EC_KEY *eckey" | ||
149 | .Fc | ||
150 | .Ft int | ||
151 | .Fo ECDSA_verify | 130 | .Fo ECDSA_verify |
152 | .Fa "int type" | 131 | .Fa "int type" |
153 | .Fa "const unsigned char *dgst" | 132 | .Fa "const unsigned char *dgst" |
@@ -162,14 +141,6 @@ | |||
162 | .Fa "int dgst_len" | 141 | .Fa "int dgst_len" |
163 | .Fa "EC_KEY *eckey" | 142 | .Fa "EC_KEY *eckey" |
164 | .Fc | 143 | .Fc |
165 | .Ft ECDSA_SIG* | ||
166 | .Fo ECDSA_do_sign_ex | ||
167 | .Fa "const unsigned char *dgst" | ||
168 | .Fa "int dgstlen" | ||
169 | .Fa "const BIGNUM *kinv" | ||
170 | .Fa "const BIGNUM *rp" | ||
171 | .Fa "EC_KEY *eckey" | ||
172 | .Fc | ||
173 | .Ft int | 144 | .Ft int |
174 | .Fo ECDSA_do_verify | 145 | .Fo ECDSA_do_verify |
175 | .Fa "const unsigned char *dgst" | 146 | .Fa "const unsigned char *dgst" |
@@ -284,45 +255,13 @@ returns the maximum length of a DER-encoded ECDSA signature created with | |||
284 | the private EC key | 255 | the private EC key |
285 | .Fa eckey . | 256 | .Fa eckey . |
286 | .Pp | 257 | .Pp |
287 | .Fn ECDSA_sign_setup | ||
288 | may be used to precompute parts of the signing operation. | ||
289 | .Fa eckey | ||
290 | is the private EC key and | ||
291 | .Fa ctx | ||
292 | is a pointer to a | ||
293 | .Vt BN_CTX | ||
294 | structure (or | ||
295 | .Dv NULL ) . | ||
296 | The precomputed values are returned in | ||
297 | .Fa kinv | ||
298 | and | ||
299 | .Fa rp | ||
300 | and can be used in a later call to | ||
301 | .Fa ECDSA_sign_ex | ||
302 | or | ||
303 | .Fa ECDSA_do_sign_ex . | ||
304 | .Pp | ||
305 | .Fn ECDSA_sign | 258 | .Fn ECDSA_sign |
306 | is a wrapper function for | ||
307 | .Fa ECDSA_sign_ex | ||
308 | with | ||
309 | .Fa kinv | ||
310 | and | ||
311 | .Fa rp | ||
312 | set to | ||
313 | .Dv NULL . | ||
314 | .Pp | ||
315 | .Fn ECDSA_sign_ex | ||
316 | computes a digital signature of the | 259 | computes a digital signature of the |
317 | .Fa dgstlen | 260 | .Fa dgstlen |
318 | bytes hash value | 261 | bytes hash value |
319 | .Fa dgst | 262 | .Fa dgst |
320 | using the private EC key | 263 | using the private EC key |
321 | .Fa eckey | 264 | .Fa eckey . |
322 | and the optional pre-computed values | ||
323 | .Fa kinv | ||
324 | and | ||
325 | .Fa rp . | ||
326 | The DER-encoded signature is stored in | 265 | The DER-encoded signature is stored in |
327 | .Fa sig | 266 | .Fa sig |
328 | and its length is returned in | 267 | and its length is returned in |
@@ -352,26 +291,12 @@ The parameter | |||
352 | is ignored. | 291 | is ignored. |
353 | .Pp | 292 | .Pp |
354 | .Fn ECDSA_do_sign | 293 | .Fn ECDSA_do_sign |
355 | is a wrapper function for | ||
356 | .Fn ECDSA_do_sign_ex | ||
357 | with | ||
358 | .Fa kinv | ||
359 | and | ||
360 | .Fa rp | ||
361 | set to | ||
362 | .Dv NULL . | ||
363 | .Pp | ||
364 | .Fn ECDSA_do_sign_ex | ||
365 | computes a digital signature of the | 294 | computes a digital signature of the |
366 | .Fa dgst_len | 295 | .Fa dgst_len |
367 | bytes hash value | 296 | bytes hash value |
368 | .Fa dgst | 297 | .Fa dgst |
369 | using the private key | 298 | using the private key |
370 | .Fa eckey | 299 | .Fa eckey . |
371 | and the optional pre-computed values | ||
372 | .Fa kinv | ||
373 | and | ||
374 | .Fa rp . | ||
375 | The signature is returned in a newly allocated | 300 | The signature is returned in a newly allocated |
376 | .Vt ECDSA_SIG | 301 | .Vt ECDSA_SIG |
377 | structure (or | 302 | structure (or |
@@ -418,17 +343,13 @@ object if it has been set or | |||
418 | .Dv NULL | 343 | .Dv NULL |
419 | otherwise. | 344 | otherwise. |
420 | .Pp | 345 | .Pp |
421 | .Fn ECDSA_SIG_set0 , | 346 | .Fn ECDSA_SIG_set0 |
422 | .Fn ECDSA_sign , | ||
423 | .Fn ECDSA_sign_ex , | ||
424 | and | 347 | and |
425 | .Fn ECDSA_sign_setup | 348 | .Fn ECDSA_sign |
426 | return 1 if successful or 0 on error. | 349 | return 1 if successful or 0 on error. |
427 | .Pp | 350 | .Pp |
428 | .Fn ECDSA_do_sign | 351 | .Fn ECDSA_do_sign |
429 | and | 352 | returns a pointer to an allocated |
430 | .Fn ECDSA_do_sign_ex | ||
431 | return a pointer to an allocated | ||
432 | .Vt ECDSA_SIG | 353 | .Vt ECDSA_SIG |
433 | structure or | 354 | structure or |
434 | .Dv NULL | 355 | .Dv NULL |
@@ -516,12 +437,12 @@ if (ret == -1) { | |||
516 | .Xr EC_GROUP_new 3 , | 437 | .Xr EC_GROUP_new 3 , |
517 | .Xr EC_KEY_METHOD_new 3 , | 438 | .Xr EC_KEY_METHOD_new 3 , |
518 | .Xr EC_KEY_new 3 , | 439 | .Xr EC_KEY_new 3 , |
519 | .Xr ECDSA_set_ex_data 3 , | 440 | .Xr EC_KEY_set_ex_data 3 , |
520 | .Xr EVP_DigestSignInit 3 , | 441 | .Xr EVP_DigestSignInit 3 , |
521 | .Xr EVP_DigestVerifyInit 3 , | 442 | .Xr EVP_DigestVerifyInit 3 , |
522 | .Xr RSA_new 3 | 443 | .Xr RSA_new 3 |
523 | .Sh STANDARDS | 444 | .Sh STANDARDS |
524 | ANSI X9.62, US Federal Information Processing Standard FIPS 186-2 | 445 | ANSI X9.62, US Federal Information Processing Standard FIPS 186-5 |
525 | (Digital Signature Standard, DSS) | 446 | (Digital Signature Standard, DSS) |
526 | .Sh HISTORY | 447 | .Sh HISTORY |
527 | .Fn ECDSA_SIG_new , | 448 | .Fn ECDSA_SIG_new , |
@@ -529,12 +450,9 @@ ANSI X9.62, US Federal Information Processing Standard FIPS 186-2 | |||
529 | .Fn i2d_ECDSA_SIG , | 450 | .Fn i2d_ECDSA_SIG , |
530 | .Fn d2i_ECDSA_SIG , | 451 | .Fn d2i_ECDSA_SIG , |
531 | .Fn ECDSA_size , | 452 | .Fn ECDSA_size , |
532 | .Fn ECDSA_sign_setup , | ||
533 | .Fn ECDSA_sign , | 453 | .Fn ECDSA_sign , |
534 | .Fn ECDSA_sign_ex , | ||
535 | .Fn ECDSA_verify , | 454 | .Fn ECDSA_verify , |
536 | .Fn ECDSA_do_sign , | 455 | .Fn ECDSA_do_sign , |
537 | .Fn ECDSA_do_sign_ex , | ||
538 | .Fn ECDSA_do_verify , | 456 | .Fn ECDSA_do_verify , |
539 | .Fn ECDSA_OpenSSL , | 457 | .Fn ECDSA_OpenSSL , |
540 | .Fn ECDSA_get_default_method , | 458 | .Fn ECDSA_get_default_method , |