summaryrefslogtreecommitdiff
path: root/src/lib/libcrypto/man/EC_POINT_add.3
diff options
context:
space:
mode:
Diffstat (limited to 'src/lib/libcrypto/man/EC_POINT_add.3')
-rw-r--r--src/lib/libcrypto/man/EC_POINT_add.3216
1 files changed, 0 insertions, 216 deletions
diff --git a/src/lib/libcrypto/man/EC_POINT_add.3 b/src/lib/libcrypto/man/EC_POINT_add.3
deleted file mode 100644
index cc35499c0e..0000000000
--- a/src/lib/libcrypto/man/EC_POINT_add.3
+++ /dev/null
@@ -1,216 +0,0 @@
1.\" $OpenBSD: EC_POINT_add.3,v 1.15 2025/03/08 16:48:22 tb Exp $
2.\" OpenSSL b97fdb57 Nov 11 09:33:09 2016 +0100
3.\"
4.\" This file was written by Matt Caswell <matt@openssl.org>.
5.\" Copyright (c) 2013 The OpenSSL Project. All rights reserved.
6.\"
7.\" Redistribution and use in source and binary forms, with or without
8.\" modification, are permitted provided that the following conditions
9.\" are met:
10.\"
11.\" 1. Redistributions of source code must retain the above copyright
12.\" notice, this list of conditions and the following disclaimer.
13.\"
14.\" 2. Redistributions in binary form must reproduce the above copyright
15.\" notice, this list of conditions and the following disclaimer in
16.\" the documentation and/or other materials provided with the
17.\" distribution.
18.\"
19.\" 3. All advertising materials mentioning features or use of this
20.\" software must display the following acknowledgment:
21.\" "This product includes software developed by the OpenSSL Project
22.\" for use in the OpenSSL Toolkit. (http://www.openssl.org/)"
23.\"
24.\" 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
25.\" endorse or promote products derived from this software without
26.\" prior written permission. For written permission, please contact
27.\" openssl-core@openssl.org.
28.\"
29.\" 5. Products derived from this software may not be called "OpenSSL"
30.\" nor may "OpenSSL" appear in their names without prior written
31.\" permission of the OpenSSL Project.
32.\"
33.\" 6. Redistributions of any form whatsoever must retain the following
34.\" acknowledgment:
35.\" "This product includes software developed by the OpenSSL Project
36.\" for use in the OpenSSL Toolkit (http://www.openssl.org/)"
37.\"
38.\" THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY
39.\" EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
40.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
41.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR
42.\" ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
43.\" SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
44.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
45.\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
46.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
47.\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
48.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
49.\" OF THE POSSIBILITY OF SUCH DAMAGE.
50.\"
51.Dd $Mdocdate: March 8 2025 $
52.Dt EC_POINT_ADD 3
53.Os
54.Sh NAME
55.Nm EC_POINT_add ,
56.Nm EC_POINT_dbl ,
57.Nm EC_POINT_invert ,
58.Nm EC_POINT_is_at_infinity ,
59.Nm EC_POINT_is_on_curve ,
60.Nm EC_POINT_cmp ,
61.Nm EC_POINT_make_affine ,
62.Nm EC_POINT_mul
63.Nd perform mathematical operations and tests on EC_POINT objects
64.Sh SYNOPSIS
65.In openssl/ec.h
66.In openssl/bn.h
67.Ft int
68.Fo EC_POINT_add
69.Fa "const EC_GROUP *group"
70.Fa "EC_POINT *r"
71.Fa "const EC_POINT *a"
72.Fa "const EC_POINT *b"
73.Fa "BN_CTX *ctx"
74.Fc
75.Ft int
76.Fo EC_POINT_dbl
77.Fa "const EC_GROUP *group"
78.Fa "EC_POINT *r"
79.Fa "const EC_POINT *a"
80.Fa "BN_CTX *ctx"
81.Fc
82.Ft int
83.Fo EC_POINT_invert
84.Fa "const EC_GROUP *group"
85.Fa "EC_POINT *a"
86.Fa "BN_CTX *ctx"
87.Fc
88.Ft int
89.Fo EC_POINT_is_at_infinity
90.Fa "const EC_GROUP *group"
91.Fa "const EC_POINT *p"
92.Fc
93.Ft int
94.Fo EC_POINT_is_on_curve
95.Fa "const EC_GROUP *group"
96.Fa "const EC_POINT *point"
97.Fa "BN_CTX *ctx"
98.Fc
99.Ft int
100.Fo EC_POINT_cmp
101.Fa "const EC_GROUP *group"
102.Fa "const EC_POINT *a"
103.Fa "const EC_POINT *b"
104.Fa "BN_CTX *ctx"
105.Fc
106.Ft int
107.Fo EC_POINT_make_affine
108.Fa "const EC_GROUP *group"
109.Fa "EC_POINT *point"
110.Fa "BN_CTX *ctx"
111.Fc
112.Ft int
113.Fo EC_POINT_mul
114.Fa "const EC_GROUP *group"
115.Fa "EC_POINT *r"
116.Fa "const BIGNUM *n"
117.Fa "const EC_POINT *q"
118.Fa "const BIGNUM *m"
119.Fa "BN_CTX *ctx"
120.Fc
121.Sh DESCRIPTION
122These functions operate on
123.Vt EC_POINT
124objects created by
125.Xr EC_POINT_new 3 .
126.Pp
127.Fn EC_POINT_add
128adds the two points
129.Fa a
130and
131.Fa b
132and places the result in
133.Fa r .
134Similarly
135.Fn EC_POINT_dbl
136doubles the point
137.Fa a
138and places the result in
139.Fa r .
140In both cases it is valid for
141.Fa r
142to be one of
143.Fa a
144or
145.Fa b .
146.Pp
147.Fn EC_POINT_invert
148calculates the inverse of the supplied point
149.Fa a .
150The result is placed back in
151.Fa a .
152.Pp
153The function
154.Fn EC_POINT_is_at_infinity
155tests whether the supplied point is at infinity or not.
156.Pp
157.Fn EC_POINT_is_on_curve
158tests whether the supplied point is on the curve or not.
159.Pp
160.Fn EC_POINT_cmp
161compares the two supplied points and tests whether or not they are
162equal.
163.Pp
164.Fn EC_POINT_mul
165calculates the value
166.Pp
167.D1 generator * n + q * m
168.Pp
169and stores the result in
170.Fa r .
171The value
172.Fa n
173may be
174.Dv NULL ,
175in which case the result is just
176.Pp
177.Dl q * m.
178.Pp
179See
180.Xr EC_GROUP_copy 3
181for information about the generator.
182.Sh RETURN VALUES
183The following functions return 1 on success or 0 on error:
184.Fn EC_POINT_add ,
185.Fn EC_POINT_dbl ,
186.Fn EC_POINT_invert ,
187.Fn EC_POINT_make_affine ,
188and
189.Fn EC_POINT_mul
190.Pp
191.Fn EC_POINT_is_at_infinity
192returns 1 if the point is at infinity or 0 otherwise.
193.Pp
194.Fn EC_POINT_is_on_curve
195returns 1 if the point is on the curve, 0 if not, or -1 on error.
196.Pp
197.Fn EC_POINT_cmp
198returns 1 if the points are not equal, 0 if they are, or -1 on error.
199.Sh SEE ALSO
200.Xr d2i_ECPKParameters 3 ,
201.Xr EC_GROUP_copy 3 ,
202.Xr EC_GROUP_new 3 ,
203.Xr EC_KEY_new 3 ,
204.Xr EC_POINT_new 3
205.Sh HISTORY
206.Fn EC_POINT_add ,
207.Fn EC_POINT_dbl ,
208.Fn EC_POINT_invert ,
209.Fn EC_POINT_is_at_infinity ,
210.Fn EC_POINT_is_on_curve ,
211.Fn EC_POINT_cmp ,
212.Fn EC_POINT_make_affine ,
213and
214.Fn EC_POINT_mul
215first appeared in OpenSSL 0.9.7 and have been available since
216.Ox 3.2 .
generated by cgit v1.2.3-55-g6feb (git 2.39.1) at 2025-12-23 16:50:40 +0000