diff options
Diffstat (limited to 'src')
| -rw-r--r-- | src/lib/libcrypto/man/EC_POINT_new.3 | 90 |
1 files changed, 70 insertions, 20 deletions
diff --git a/src/lib/libcrypto/man/EC_POINT_new.3 b/src/lib/libcrypto/man/EC_POINT_new.3 index 94ab9054bf..718d041a13 100644 --- a/src/lib/libcrypto/man/EC_POINT_new.3 +++ b/src/lib/libcrypto/man/EC_POINT_new.3 | |||
| @@ -1,5 +1,5 @@ | |||
| 1 | .\" $OpenBSD: EC_POINT_new.3,v 1.11 2019/08/19 13:08:26 schwarze Exp $ | 1 | .\" $OpenBSD: EC_POINT_new.3,v 1.12 2021/05/10 20:00:58 tb Exp $ |
| 2 | .\" full merge up to: OpenSSL ddc1caac Mar 6 14:00:24 2018 -0500 | 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>. |
| 5 | .\" Copyright (c) 2013, 2016 The OpenSSL Project. All rights reserved. | 5 | .\" Copyright (c) 2013, 2016 The OpenSSL Project. All rights reserved. |
| @@ -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: August 19 2019 $ | 51 | .Dd $Mdocdate: May 10 2021 $ |
| 52 | .Dt EC_POINT_NEW 3 | 52 | .Dt EC_POINT_NEW 3 |
| 53 | .Os | 53 | .Os |
| 54 | .Sh NAME | 54 | .Sh NAME |
| @@ -59,12 +59,15 @@ | |||
| 59 | .Nm EC_POINT_dup , | 59 | .Nm EC_POINT_dup , |
| 60 | .Nm EC_POINT_method_of , | 60 | .Nm EC_POINT_method_of , |
| 61 | .Nm EC_POINT_set_to_infinity , | 61 | .Nm EC_POINT_set_to_infinity , |
| 62 | .Nm EC_POINT_set_affine_coordinates , | ||
| 62 | .Nm EC_POINT_set_affine_coordinates_GFp , | 63 | .Nm EC_POINT_set_affine_coordinates_GFp , |
| 63 | .Nm EC_POINT_set_affine_coordinates_GF2m , | 64 | .Nm EC_POINT_set_affine_coordinates_GF2m , |
| 65 | .Nm EC_POINT_get_affine_coordinates , | ||
| 64 | .Nm EC_POINT_get_affine_coordinates_GFp , | 66 | .Nm EC_POINT_get_affine_coordinates_GFp , |
| 65 | .Nm EC_POINT_get_affine_coordinates_GF2m , | 67 | .Nm EC_POINT_get_affine_coordinates_GF2m , |
| 66 | .Nm EC_POINT_set_Jprojective_coordinates_GFp , | 68 | .Nm EC_POINT_set_Jprojective_coordinates_GFp , |
| 67 | .Nm EC_POINT_get_Jprojective_coordinates_GFp , | 69 | .Nm EC_POINT_get_Jprojective_coordinates_GFp , |
| 70 | .Nm EC_POINT_set_compressed_coordinates , | ||
| 68 | .Nm EC_POINT_set_compressed_coordinates_GFp , | 71 | .Nm EC_POINT_set_compressed_coordinates_GFp , |
| 69 | .Nm EC_POINT_set_compressed_coordinates_GF2m , | 72 | .Nm EC_POINT_set_compressed_coordinates_GF2m , |
| 70 | .Nm EC_POINT_point2oct , | 73 | .Nm EC_POINT_point2oct , |
| @@ -109,6 +112,14 @@ | |||
| 109 | .Fa "EC_POINT *point" | 112 | .Fa "EC_POINT *point" |
| 110 | .Fc | 113 | .Fc |
| 111 | .Ft int | 114 | .Ft int |
| 115 | .Fo EC_POINT_set_affine_coordinates | ||
| 116 | .Fa "const EC_GROUP *group" | ||
| 117 | .Fa "EC_POINT *p" | ||
| 118 | .Fa "const BIGNUM *x" | ||
| 119 | .Fa "const BIGNUM *y" | ||
| 120 | .Fa "BN_CTX *ctx" | ||
| 121 | .Fc | ||
| 122 | .Ft int | ||
| 112 | .Fo EC_POINT_set_affine_coordinates_GFp | 123 | .Fo EC_POINT_set_affine_coordinates_GFp |
| 113 | .Fa "const EC_GROUP *group" | 124 | .Fa "const EC_GROUP *group" |
| 114 | .Fa "EC_POINT *p" | 125 | .Fa "EC_POINT *p" |
| @@ -125,6 +136,14 @@ | |||
| 125 | .Fa "BN_CTX *ctx" | 136 | .Fa "BN_CTX *ctx" |
| 126 | .Fc | 137 | .Fc |
| 127 | .Ft int | 138 | .Ft int |
| 139 | .Fo EC_POINT_get_affine_coordinates | ||
| 140 | .Fa "const EC_GROUP *group" | ||
| 141 | .Fa "const EC_POINT *p" | ||
| 142 | .Fa "BIGNUM *x" | ||
| 143 | .Fa "BIGNUM *y" | ||
| 144 | .Fa "BN_CTX *ctx" | ||
| 145 | .Fc | ||
| 146 | .Ft int | ||
| 128 | .Fo EC_POINT_get_affine_coordinates_GFp | 147 | .Fo EC_POINT_get_affine_coordinates_GFp |
| 129 | .Fa "const EC_GROUP *group" | 148 | .Fa "const EC_GROUP *group" |
| 130 | .Fa "const EC_POINT *p" | 149 | .Fa "const EC_POINT *p" |
| @@ -159,6 +178,14 @@ | |||
| 159 | .Fa "BN_CTX *ctx" | 178 | .Fa "BN_CTX *ctx" |
| 160 | .Fc | 179 | .Fc |
| 161 | .Ft int | 180 | .Ft int |
| 181 | .Fo EC_POINT_set_compressed_coordinates | ||
| 182 | .Fa "const EC_GROUP *group" | ||
| 183 | .Fa "EC_POINT *p" | ||
| 184 | .Fa "const BIGNUM *x" | ||
| 185 | .Fa "int y_bit" | ||
| 186 | .Fa "BN_CTX *ctx" | ||
| 187 | .Fc | ||
| 188 | .Ft int | ||
| 162 | .Fo EC_POINT_set_compressed_coordinates_GFp | 189 | .Fo EC_POINT_set_compressed_coordinates_GFp |
| 163 | .Fa "const EC_GROUP *group" | 190 | .Fa "const EC_GROUP *group" |
| 164 | .Fa "EC_POINT *p" | 191 | .Fa "EC_POINT *p" |
| @@ -290,11 +317,9 @@ The affine coordinates for a point describe a point in terms of its | |||
| 290 | and | 317 | and |
| 291 | .Fa y | 318 | .Fa y |
| 292 | position. | 319 | position. |
| 293 | The functions | 320 | The function |
| 294 | .Fn EC_POINT_set_affine_coordinates_GFp | 321 | .Fn EC_POINT_set_affine_coordinates |
| 295 | and | 322 | sets the |
| 296 | .Fn EC_POINT_set_affine_coordinates_GF2m | ||
| 297 | set the | ||
| 298 | .Fa x | 323 | .Fa x |
| 299 | and | 324 | and |
| 300 | .Fa y | 325 | .Fa y |
| @@ -302,11 +327,9 @@ coordinates for the point | |||
| 302 | .Fa p | 327 | .Fa p |
| 303 | defined over the curve given in | 328 | defined over the curve given in |
| 304 | .Fa group . | 329 | .Fa group . |
| 305 | The functions | 330 | The function |
| 306 | .Fn EC_POINT_get_affine_coordinates_GFp | 331 | .Fn EC_POINT_get_affine_coordinates |
| 307 | and | 332 | sets |
| 308 | .Fn EC_POINT_get_affine_coordinates_GF2m | ||
| 309 | set | ||
| 310 | .Fa x | 333 | .Fa x |
| 311 | and | 334 | and |
| 312 | .Fa y , | 335 | .Fa y , |
| @@ -315,6 +338,19 @@ either of which may be | |||
| 315 | to the corresponding coordinates of | 338 | to the corresponding coordinates of |
| 316 | .Fa p . | 339 | .Fa p . |
| 317 | .Pp | 340 | .Pp |
| 341 | The functions | ||
| 342 | .Fn EC_POINT_set_affine_coordinates_GFp | ||
| 343 | and | ||
| 344 | .Fn EC_POINT_set_affine_coordinates_GF2m | ||
| 345 | are deprecated synonyms for | ||
| 346 | .Fn EC_POINT_set_affine_coordinates | ||
| 347 | and the functions | ||
| 348 | .Fn EC_POINT_get_affine_coordinates_GFp | ||
| 349 | and | ||
| 350 | .Fn EC_POINT_get_affine_coordinates_GF2m | ||
| 351 | are deprecated synonyms for | ||
| 352 | .Fn EC_POINT_get_affine_coordinates . | ||
| 353 | .Pp | ||
| 318 | As well as the affine coordinates, a point can alternatively be | 354 | As well as the affine coordinates, a point can alternatively be |
| 319 | described in terms of its Jacobian projective coordinates (for Fp | 355 | described in terms of its Jacobian projective coordinates (for Fp |
| 320 | curves only). | 356 | curves only). |
| @@ -352,17 +388,22 @@ for any given value for | |||
| 352 | such that the point is on the curve, there will only ever be two | 388 | such that the point is on the curve, there will only ever be two |
| 353 | possible values for | 389 | possible values for |
| 354 | .Fa y . | 390 | .Fa y . |
| 355 | Therefore a point can be set using the | 391 | Therefore, a point can be set using the |
| 356 | .Fn EC_POINT_set_compressed_coordinates_GFp | 392 | .Fn EC_POINT_set_compressed_coordinates |
| 357 | and | 393 | function where |
| 358 | .Fn EC_POINT_set_compressed_coordinates_GF2m | ||
| 359 | functions where | ||
| 360 | .Fa x | 394 | .Fa x |
| 361 | is the x coordinate and | 395 | is the x coordinate and |
| 362 | .Fa y_bit | 396 | .Fa y_bit |
| 363 | is a value 0 or 1 to identify which of the two possible values for y | 397 | is a value 0 or 1 to identify which of the two possible values for y |
| 364 | should be used. | 398 | should be used. |
| 365 | .Pp | 399 | .Pp |
| 400 | The functions | ||
| 401 | .Fn EC_POINT_set_compressed_coordinates_GFp | ||
| 402 | and | ||
| 403 | .Fn EC_POINT_set_compressed_coordinates_GF2m | ||
| 404 | are deprecated synonyms for | ||
| 405 | .Fn EC_POINT_set_compressed_coordinates . | ||
| 406 | .Pp | ||
| 366 | In addition | 407 | In addition |
| 367 | .Vt EC_POINT Ns s | 408 | .Vt EC_POINT Ns s |
| 368 | can be converted to and from various external representations. | 409 | can be converted to and from various external representations. |
| @@ -433,11 +474,14 @@ The following functions return 1 on success or 0 on error: | |||
| 433 | .Fn EC_POINT_set_to_infinity , | 474 | .Fn EC_POINT_set_to_infinity , |
| 434 | .Fn EC_POINT_set_Jprojective_coordinates_GFp , | 475 | .Fn EC_POINT_set_Jprojective_coordinates_GFp , |
| 435 | .Fn EC_POINT_get_Jprojective_coordinates_GFp , | 476 | .Fn EC_POINT_get_Jprojective_coordinates_GFp , |
| 477 | .Fn EC_POINT_set_affine_coordinates , | ||
| 436 | .Fn EC_POINT_set_affine_coordinates_GFp , | 478 | .Fn EC_POINT_set_affine_coordinates_GFp , |
| 437 | .Fn EC_POINT_get_affine_coordinates_GFp , | ||
| 438 | .Fn EC_POINT_set_compressed_coordinates_GFp , | ||
| 439 | .Fn EC_POINT_set_affine_coordinates_GF2m , | 479 | .Fn EC_POINT_set_affine_coordinates_GF2m , |
| 480 | .Fn EC_POINT_get_affine_coordinates , | ||
| 481 | .Fn EC_POINT_get_affine_coordinates_GFp , | ||
| 440 | .Fn EC_POINT_get_affine_coordinates_GF2m , | 482 | .Fn EC_POINT_get_affine_coordinates_GF2m , |
| 483 | .Fn EC_POINT_set_compressed_coordinates , | ||
| 484 | .Fn EC_POINT_set_compressed_coordinates_GFp , | ||
| 441 | .Fn EC_POINT_set_compressed_coordinates_GF2m , | 485 | .Fn EC_POINT_set_compressed_coordinates_GF2m , |
| 442 | and | 486 | and |
| 443 | .Fn EC_POINT_oct2point . | 487 | .Fn EC_POINT_oct2point . |
| @@ -513,3 +557,9 @@ and | |||
| 513 | .Fn EC_POINT_hex2point | 557 | .Fn EC_POINT_hex2point |
| 514 | first appeared in OpenSSL 0.9.8 and have been available since | 558 | first appeared in OpenSSL 0.9.8 and have been available since |
| 515 | .Ox 4.5 . | 559 | .Ox 4.5 . |
| 560 | .Fn EC_POINT_set_affine_coordinates , | ||
| 561 | .Fn EC_POINT_get_affine_coordinates , | ||
| 562 | and | ||
| 563 | .Fn EC_POINT_set_compressed_coordinates | ||
| 564 | first appeared in OpenSSL 1.1.1 and have been available since | ||
| 565 | .Ox 7.0 . | ||
