Lines Matching +full:3 +full:- +full:point
18 .\" Set up some character translations and predefined strings. \*(-- will
24 .tr \(*W-
27 . ds -- \(*W-
29 . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
30 . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
37 . ds -- \|\(em\|
71 .\" Fear. Run. Save yourself. No user-serviceable parts.
76 . ds #F .3m
81 . ds #H ((1u-(\\\\n(.fu%2u))*.13m)
97 . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
98 . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
99 . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
100 . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
101 . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
102 . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
104 . \" troff and (daisy-wheel) nroff accents
123 . ds d- d\h'-1'\(ga
124 . ds D- D\h'-1'\(hy
133 .IX Title "EC_POINT_NEW 3ossl"
134 .TH EC_POINT_NEW 3ossl "2023-09-19" "3.0.11" "OpenSSL"
165 \&\- Functions for creating, destroying and manipulating EC_POINT objects
172 \& void EC_POINT_free(EC_POINT *point);
173 \& void EC_POINT_clear_free(EC_POINT *point);
176 \& int EC_POINT_set_to_infinity(const EC_GROUP *group, EC_POINT *point);
188 \& size_t EC_POINT_point2buf(const EC_GROUP *group, const EC_POINT *point,
200 hidden entirely by defining \fB\s-1OPENSSL_API_COMPAT\s0\fR with a suitable version value,
204 \& const EC_METHOD *EC_POINT_method_of(const EC_POINT *point);
241 An \fB\s-1EC_POINT\s0\fR structure represents a point on a curve. A new point is
243 \&\fBgroup\fR object that the point relates to.
245 \&\fBEC_POINT_free()\fR frees the memory associated with the \fB\s-1EC_POINT\s0\fR.
246 if \fBpoint\fR is \s-1NULL\s0 nothing is done.
248 \&\fBEC_POINT_clear_free()\fR destroys any sensitive data held within the \s-1EC_POINT\s0 and
249 then frees its memory. If \fBpoint\fR is \s-1NULL\s0 nothing is done.
251 \&\fBEC_POINT_copy()\fR copies the point \fBsrc\fR into \fBdst\fR. Both \fBsrc\fR and \fBdst\fR
252 must use the same \fB\s-1EC_METHOD\s0\fR.
254 \&\fBEC_POINT_dup()\fR creates a new \fB\s-1EC_POINT\s0\fR object and copies the content from
255 \&\fBsrc\fR to the newly created \fB\s-1EC_POINT\s0\fR object.
257 \&\fBEC_POINT_method_of()\fR obtains the \fB\s-1EC_METHOD\s0\fR associated with \fBpoint\fR.
258 This function was deprecated in OpenSSL 3.0, since \s-1EC_METHOD\s0 is no longer a
261 A valid point on a curve is the special point at infinity. A point is set to
264 The affine coordinates for a point describe a point in terms of its x and y
266 coordinates for the point \fBp\fR defined over the curve given in \fBgroup\fR. The
268 may be \s-1NULL,\s0 to the corresponding coordinates of \fBp\fR.
280 As well as the affine coordinates, a point can alternatively be described in
283 this coordinate system provides more efficient point multiplication
286 as an affine coordinate as (x/(z^2), y/(z^3)). Conversion to Jacobian
297 point (x, y), for any given value for x such that the point is on the curve
298 there will only ever be two possible values for y. Therefore, a point can be set
308 In addition \fB\s-1EC_POINT\s0\fR can be converted to and from various external
310 structure (as defined in \s-1RFC5480\s0 and used in certificates and \s-1TLS\s0 records):
311 only the content octets are present, the \fB\s-1OCTET STRING\s0\fR tag and length are
312 not included. \fB\s-1BIGNUM\s0\fR form is the octet form interpreted as a big endian
313 integer converted to a \fB\s-1BIGNUM\s0\fR structure. Hexadecimal form is the octet
314 form converted to a \s-1NULL\s0 terminated character string where each character
315 is one of the printable values 0\-9 or A\-F (or a\-f).
319 and to EC_POINTs for the formats: octet, \s-1BIGNUM\s0 and hexadecimal respectively.
321 The function \fBEC_POINT_point2oct()\fR encodes the given curve point \fBp\fR as an
324 The encoding conforms with Sec. 2.3.3 of the \s-1SECG SEC 1\s0 (\*(L"Elliptic Curve
326 Similarly the function \fBEC_POINT_oct2point()\fR decodes a curve point into \fBp\fR from
328 to Sec. 2.3.4 of the \s-1SECG SEC 1\s0 (\*(L"Elliptic Curve Cryptography\*(R") standard.
330 The functions \fBEC_POINT_point2hex()\fR and \fBEC_POINT_point2bn()\fR convert a point \fBp\fR,
331 respectively, to the hexadecimal or \s-1BIGNUM\s0 representation of the same
335 \&\s-1BIGNUM\s0 representation into the \s-1EC_POINT\s0 \fBp\fR.
337 Notice that, according to the standard, the octet string encoding of the point
339 vice versa, a single octet of size zero is decoded as the point at infinity.
343 Calling the function with a \s-1NULL\s0 buffer will not perform the conversion but
347 writes an \s-1EC_POINT\s0 to it in octet format. The allocated buffer is written to
350 written to \fB*pbuf\fR the \fBpbuf\fR parameter \fB\s-1MUST NOT\s0\fR be \fB\s-1NULL\s0\fR.
357 \&\fBEC_POINT_new()\fR and \fBEC_POINT_dup()\fR return the newly allocated \s-1EC_POINT\s0 or \s-1N…
368 EC_POINT_method_of returns the \s-1EC_METHOD\s0 associated with the supplied \s-1EC_POINT.\s0
373 \&\fBEC_POINT_point2bn()\fR returns the pointer to the \s-1BIGNUM\s0 supplied, or \s-1NULL\s0 on
376 \&\fBEC_POINT_bn2point()\fR returns the pointer to the \s-1EC_POINT\s0 supplied, or \s-1NULL\s0 on
379 \&\fBEC_POINT_point2hex()\fR returns a pointer to the hex string, or \s-1NULL\s0 on error.
381 \&\fBEC_POINT_hex2point()\fR returns the pointer to the \s-1EC_POINT\s0 supplied, or \s-1NULL\s0 on
385 \&\fBcrypto\fR\|(7), \fBEC_GROUP_new\fR\|(3), \fBEC_GROUP_copy\fR\|(3),
386 \&\fBEC_POINT_add\fR\|(3), \fBEC_KEY_new\fR\|(3),
387 \&\fBEC_GFp_simple_method\fR\|(3), \fBd2i_ECPKParameters\fR\|(3)
404 Copyright 2013\-2023 The OpenSSL Project Authors. All Rights Reserved.
408 in the file \s-1LICENSE\s0 in the source distribution or at