1EC_POINT_add(3)                     OpenSSL                    EC_POINT_add(3)
2
3
4

NAME

6       EC_POINT_add, EC_POINT_dbl, EC_POINT_invert, EC_POINT_is_at_infinity,
7       EC_POINT_is_on_curve, EC_POINT_cmp, EC_POINT_make_affine,
8       EC_POINTs_make_affine, EC_POINTs_mul, EC_POINT_mul,
9       EC_GROUP_precompute_mult, EC_GROUP_have_precompute_mult - Functions for
10       performing mathematical operations and tests on EC_POINT objects.
11

SYNOPSIS

13        #include <openssl/ec.h>
14        #include <openssl/bn.h>
15
16        int EC_POINT_add(const EC_GROUP *group, EC_POINT *r, const EC_POINT *a, const EC_POINT *b, BN_CTX *ctx);
17        int EC_POINT_dbl(const EC_GROUP *group, EC_POINT *r, const EC_POINT *a, BN_CTX *ctx);
18        int EC_POINT_invert(const EC_GROUP *group, EC_POINT *a, BN_CTX *ctx);
19        int EC_POINT_is_at_infinity(const EC_GROUP *group, const EC_POINT *p);
20        int EC_POINT_is_on_curve(const EC_GROUP *group, const EC_POINT *point, BN_CTX *ctx);
21        int EC_POINT_cmp(const EC_GROUP *group, const EC_POINT *a, const EC_POINT *b, BN_CTX *ctx);
22        int EC_POINT_make_affine(const EC_GROUP *group, EC_POINT *point, BN_CTX *ctx);
23        int EC_POINTs_make_affine(const EC_GROUP *group, size_t num, EC_POINT *points[], BN_CTX *ctx);
24        int EC_POINTs_mul(const EC_GROUP *group, EC_POINT *r, const BIGNUM *n, size_t num, const EC_POINT *p[], const BIGNUM *m[], BN_CTX *ctx);
25        int EC_POINT_mul(const EC_GROUP *group, EC_POINT *r, const BIGNUM *n, const EC_POINT *q, const BIGNUM *m, BN_CTX *ctx);
26        int EC_GROUP_precompute_mult(EC_GROUP *group, BN_CTX *ctx);
27        int EC_GROUP_have_precompute_mult(const EC_GROUP *group);
28

DESCRIPTION

30       EC_POINT_add adds the two points a and b and places the result in r.
31       Similarly EC_POINT_dbl doubles the point a and places the result in r.
32       In both cases it is valid for r to be one of a or b.
33
34       EC_POINT_invert calculates the inverse of the supplied point a. The
35       result is placed back in a.
36
37       The function EC_POINT_is_at_infinity tests whether the supplied point
38       is at infinity or not.
39
40       EC_POINT_is_on_curve tests whether the supplied point is on the curve
41       or not.
42
43       EC_POINT_cmp compares the two supplied points and tests whether or not
44       they are equal.
45
46       The functions EC_POINT_make_affine and EC_POINTs_make_affine force the
47       internal representation of the EC_POINT(s) into the affine co-ordinate
48       system. In the case of EC_POINTs_make_affine the value num provides the
49       number of points in the array points to be forced.
50
51       EC_POINT_mul calculates the value generator * n + q * m and stores the
52       result in r. The value n may be NULL in which case the result is just q
53       * m.
54
55       EC_POINTs_mul calculates the value generator * n + q[0] * m[0] + ... +
56       q[num-1] * m[num-1]. As for EC_POINT_mul the value n may be NULL.
57
58       The function EC_GROUP_precompute_mult stores multiples of the generator
59       for faster point multiplication, whilst EC_GROUP_have_precompute_mult
60       tests whether precomputation has already been done. See
61       EC_GROUP_copy(3) for information about the generator.
62

RETURN VALUES

64       The following functions return 1 on success or 0 on error:
65       EC_POINT_add, EC_POINT_dbl, EC_POINT_invert, EC_POINT_make_affine,
66       EC_POINTs_make_affine, EC_POINTs_make_affine, EC_POINT_mul,
67       EC_POINTs_mul and EC_GROUP_precompute_mult.
68
69       EC_POINT_is_at_infinity returns 1 if the point is at infinity, or 0
70       otherwise.
71
72       EC_POINT_is_on_curve returns 1 if the point is on the curve, 0 if not,
73       or -1 on error.
74
75       EC_POINT_cmp returns 1 if the points are not equal, 0 if they are, or
76       -1 on error.
77
78       EC_GROUP_have_precompute_mult return 1 if a precomputation has been
79       done, or 0 if not.
80

SEE ALSO

82       crypto(3), ec(3), EC_GROUP_new(3), EC_GROUP_copy(3), EC_POINT_new(3),
83       EC_KEY_new(3), EC_GFp_simple_method(3), d2i_ECPKParameters(3)
84
85
86
871.0.2o                            2020-08-01                   EC_POINT_add(3)
Impressum