summaryrefslogtreecommitdiff
path: root/src
diff options
context:
space:
mode:
Diffstat (limited to 'src')
-rw-r--r--src/lib/libcrypto/man/EC_POINT_new.354
1 files changed, 1 insertions, 53 deletions
diff --git a/src/lib/libcrypto/man/EC_POINT_new.3 b/src/lib/libcrypto/man/EC_POINT_new.3
index a203dabf5d..f3a44822d8 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.15 2025/03/08 16:38:13 tb Exp $ 1.\" $OpenBSD: EC_POINT_new.3,v 1.16 2025/03/08 16:51:34 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>.
@@ -63,8 +63,6 @@
63.Nm EC_POINT_set_affine_coordinates_GFp , 63.Nm EC_POINT_set_affine_coordinates_GFp ,
64.Nm EC_POINT_get_affine_coordinates , 64.Nm EC_POINT_get_affine_coordinates ,
65.Nm EC_POINT_get_affine_coordinates_GFp , 65.Nm EC_POINT_get_affine_coordinates_GFp ,
66.Nm EC_POINT_set_Jprojective_coordinates_GFp ,
67.Nm EC_POINT_get_Jprojective_coordinates_GFp ,
68.Nm EC_POINT_set_compressed_coordinates , 66.Nm EC_POINT_set_compressed_coordinates ,
69.Nm EC_POINT_set_compressed_coordinates_GFp , 67.Nm EC_POINT_set_compressed_coordinates_GFp ,
70.Nm EC_POINT_point2oct , 68.Nm EC_POINT_point2oct ,
@@ -141,24 +139,6 @@
141.Fa "BN_CTX *ctx" 139.Fa "BN_CTX *ctx"
142.Fc 140.Fc
143.Ft int 141.Ft int
144.Fo EC_POINT_set_Jprojective_coordinates_GFp
145.Fa "const EC_GROUP *group"
146.Fa "EC_POINT *p"
147.Fa "const BIGNUM *x"
148.Fa "const BIGNUM *y"
149.Fa "const BIGNUM *z"
150.Fa "BN_CTX *ctx"
151.Fc
152.Ft int
153.Fo EC_POINT_get_Jprojective_coordinates_GFp
154.Fa "const EC_GROUP *group"
155.Fa "const EC_POINT *p"
156.Fa "BIGNUM *x"
157.Fa "BIGNUM *y"
158.Fa "BIGNUM *z"
159.Fa "BN_CTX *ctx"
160.Fc
161.Ft int
162.Fo EC_POINT_set_compressed_coordinates 142.Fo EC_POINT_set_compressed_coordinates
163.Fa "const EC_GROUP *group" 143.Fa "const EC_GROUP *group"
164.Fa "EC_POINT *p" 144.Fa "EC_POINT *p"
@@ -320,34 +300,6 @@ and the function
320is a deprecated synonym for 300is a deprecated synonym for
321.Fn EC_POINT_get_affine_coordinates . 301.Fn EC_POINT_get_affine_coordinates .
322.Pp 302.Pp
323As well as the affine coordinates, a point can alternatively be
324described in terms of its Jacobian projective coordinates.
325Jacobian projective coordinates are expressed as three values
326.Fa x ,
327.Fa y ,
328and
329.Fa z .
330Working in this coordinate system provides more efficient point
331multiplication operations.
332A mapping exists between Jacobian projective coordinates and affine
333coordinates.
334A Jacobian projective coordinate
335.Pq Fa x , y , z
336can be written as an affine coordinate as
337.Pp
338.Dl (x/(z^2), y/(z^3)) .
339.Pp
340Conversion to Jacobian projective from affine coordinates is simple.
341The coordinate
342.Pq Fa x , y
343is mapped to
344.Pq Fa x , y , No 1 .
345To set or get the projective coordinates use
346.Fn EC_POINT_set_Jprojective_coordinates_GFp
347and
348.Fn EC_POINT_get_Jprojective_coordinates_GFp ,
349respectively.
350.Pp
351Points can also be described in terms of their compressed coordinates. 303Points can also be described in terms of their compressed coordinates.
352For a point 304For a point
353.Pq Fa x , y , 305.Pq Fa x , y ,
@@ -438,8 +390,6 @@ on error.
438The following functions return 1 on success or 0 on error: 390The following functions return 1 on success or 0 on error:
439.Fn EC_POINT_copy , 391.Fn EC_POINT_copy ,
440.Fn EC_POINT_set_to_infinity , 392.Fn EC_POINT_set_to_infinity ,
441.Fn EC_POINT_set_Jprojective_coordinates_GFp ,
442.Fn EC_POINT_get_Jprojective_coordinates_GFp ,
443.Fn EC_POINT_set_affine_coordinates , 393.Fn EC_POINT_set_affine_coordinates ,
444.Fn EC_POINT_set_affine_coordinates_GFp , 394.Fn EC_POINT_set_affine_coordinates_GFp ,
445.Fn EC_POINT_get_affine_coordinates , 395.Fn EC_POINT_get_affine_coordinates ,
@@ -499,8 +449,6 @@ on error.
499.Fn EC_POINT_set_to_infinity , 449.Fn EC_POINT_set_to_infinity ,
500.Fn EC_POINT_set_affine_coordinates_GFp , 450.Fn EC_POINT_set_affine_coordinates_GFp ,
501.Fn EC_POINT_get_affine_coordinates_GFp , 451.Fn EC_POINT_get_affine_coordinates_GFp ,
502.Fn EC_POINT_set_Jprojective_coordinates_GFp ,
503.Fn EC_POINT_get_Jprojective_coordinates_GFp ,
504.Fn EC_POINT_set_compressed_coordinates_GFp , 452.Fn EC_POINT_set_compressed_coordinates_GFp ,
505.Fn EC_POINT_point2oct , 453.Fn EC_POINT_point2oct ,
506and 454and