]> git.ipfire.org Git - thirdparty/openssl.git/blame - crypto/ec/ec_lib.c
Use the new non-curve type specific EC functions internally
[thirdparty/openssl.git] / crypto / ec / ec_lib.c
CommitLineData
35b73a1f 1/*
3c7d0945 2 * Copyright 2001-2018 The OpenSSL Project Authors. All Rights Reserved.
aa8f3d76 3 * Copyright (c) 2002, Oracle and/or its affiliates. All rights reserved
65e81670 4 *
aa6bb135
RS
5 * Licensed under the OpenSSL license (the "License"). You may not use
6 * this file except in compliance with the License. You can obtain a copy
7 * in the file LICENSE in the source distribution or at
8 * https://www.openssl.org/source/license.html
65e81670 9 */
aa6bb135 10
c4b36ff4
BM
11#include <string.h>
12
0657bf9c 13#include <openssl/err.h>
bb62a8b0 14#include <openssl/opensslv.h>
0657bf9c 15
65e81670 16#include "ec_lcl.h"
0657bf9c 17
0657bf9c
BM
18/* functions for EC_GROUP objects */
19
20EC_GROUP *EC_GROUP_new(const EC_METHOD *meth)
0f113f3e
MC
21{
22 EC_GROUP *ret;
23
24 if (meth == NULL) {
25 ECerr(EC_F_EC_GROUP_NEW, EC_R_SLOT_FULL);
26 return NULL;
27 }
28 if (meth->group_init == 0) {
29 ECerr(EC_F_EC_GROUP_NEW, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
30 return NULL;
31 }
32
64b25758 33 ret = OPENSSL_zalloc(sizeof(*ret));
0f113f3e
MC
34 if (ret == NULL) {
35 ECerr(EC_F_EC_GROUP_NEW, ERR_R_MALLOC_FAILURE);
36 return NULL;
37 }
38
39 ret->meth = meth;
6903e2e7
DSH
40 if ((ret->meth->flags & EC_FLAGS_CUSTOM_CURVE) == 0) {
41 ret->order = BN_new();
42 if (ret->order == NULL)
43 goto err;
44 ret->cofactor = BN_new();
45 if (ret->cofactor == NULL)
46 goto err;
47 }
86f300d3 48 ret->asn1_flag = OPENSSL_EC_NAMED_CURVE;
0f113f3e 49 ret->asn1_form = POINT_CONVERSION_UNCOMPRESSED;
0f113f3e
MC
50 if (!meth->group_init(ret))
51 goto err;
0f113f3e 52 return ret;
64b25758 53
0f113f3e 54 err:
23a1d5e9
RS
55 BN_free(ret->order);
56 BN_free(ret->cofactor);
0f113f3e
MC
57 OPENSSL_free(ret);
58 return NULL;
59}
0657bf9c 60
2c52ac9b 61void EC_pre_comp_free(EC_GROUP *group)
3aef36ff
RS
62{
63 switch (group->pre_comp_type) {
f3b3d7f0 64 case PCT_none:
3aef36ff 65 break;
66117ab0 66 case PCT_nistz256:
f3b3d7f0 67#ifdef ECP_NISTZ256_ASM
3aef36ff 68 EC_nistz256_pre_comp_free(group->pre_comp.nistz256);
e69aa800 69#endif
f3b3d7f0 70 break;
3aef36ff 71#ifndef OPENSSL_NO_EC_NISTP_64_GCC_128
66117ab0 72 case PCT_nistp224:
3aef36ff
RS
73 EC_nistp224_pre_comp_free(group->pre_comp.nistp224);
74 break;
66117ab0 75 case PCT_nistp256:
3aef36ff
RS
76 EC_nistp256_pre_comp_free(group->pre_comp.nistp256);
77 break;
66117ab0 78 case PCT_nistp521:
3aef36ff
RS
79 EC_nistp521_pre_comp_free(group->pre_comp.nistp521);
80 break;
f3b3d7f0
RS
81#else
82 case PCT_nistp224:
83 case PCT_nistp256:
84 case PCT_nistp521:
85 break;
3aef36ff 86#endif
66117ab0 87 case PCT_ec:
3aef36ff
RS
88 EC_ec_pre_comp_free(group->pre_comp.ec);
89 break;
90 }
91 group->pre_comp.ec = NULL;
92}
93
0657bf9c 94void EC_GROUP_free(EC_GROUP *group)
0f113f3e
MC
95{
96 if (!group)
97 return;
7711de24 98
0f113f3e
MC
99 if (group->meth->group_finish != 0)
100 group->meth->group_finish(group);
df9cc153 101
2c52ac9b 102 EC_pre_comp_free(group);
23a1d5e9 103 BN_MONT_CTX_free(group->mont_data);
8fdc3734 104 EC_POINT_free(group->generator);
0f113f3e
MC
105 BN_free(group->order);
106 BN_free(group->cofactor);
25aaa98a 107 OPENSSL_free(group->seed);
0f113f3e
MC
108 OPENSSL_free(group);
109}
0657bf9c
BM
110
111void EC_GROUP_clear_free(EC_GROUP *group)
0f113f3e
MC
112{
113 if (!group)
114 return;
df9cc153 115
0f113f3e
MC
116 if (group->meth->group_clear_finish != 0)
117 group->meth->group_clear_finish(group);
118 else if (group->meth->group_finish != 0)
119 group->meth->group_finish(group);
df9cc153 120
2c52ac9b 121 EC_pre_comp_free(group);
23a1d5e9 122 BN_MONT_CTX_free(group->mont_data);
8fdc3734 123 EC_POINT_clear_free(group->generator);
0f113f3e
MC
124 BN_clear_free(group->order);
125 BN_clear_free(group->cofactor);
4b45c6e5 126 OPENSSL_clear_free(group->seed, group->seed_len);
b4faea50 127 OPENSSL_clear_free(group, sizeof(*group));
0f113f3e 128}
0657bf9c
BM
129
130int EC_GROUP_copy(EC_GROUP *dest, const EC_GROUP *src)
0f113f3e 131{
0f113f3e
MC
132 if (dest->meth->group_copy == 0) {
133 ECerr(EC_F_EC_GROUP_COPY, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
134 return 0;
135 }
136 if (dest->meth != src->meth) {
137 ECerr(EC_F_EC_GROUP_COPY, EC_R_INCOMPATIBLE_OBJECTS);
138 return 0;
139 }
140 if (dest == src)
141 return 1;
142
b14e6015
MC
143 dest->curve_name = src->curve_name;
144
3aef36ff
RS
145 /* Copy precomputed */
146 dest->pre_comp_type = src->pre_comp_type;
147 switch (src->pre_comp_type) {
f3b3d7f0 148 case PCT_none:
3aef36ff
RS
149 dest->pre_comp.ec = NULL;
150 break;
66117ab0 151 case PCT_nistz256:
f3b3d7f0 152#ifdef ECP_NISTZ256_ASM
3aef36ff 153 dest->pre_comp.nistz256 = EC_nistz256_pre_comp_dup(src->pre_comp.nistz256);
e69aa800 154#endif
f3b3d7f0 155 break;
3aef36ff 156#ifndef OPENSSL_NO_EC_NISTP_64_GCC_128
66117ab0 157 case PCT_nistp224:
3aef36ff
RS
158 dest->pre_comp.nistp224 = EC_nistp224_pre_comp_dup(src->pre_comp.nistp224);
159 break;
66117ab0 160 case PCT_nistp256:
3aef36ff
RS
161 dest->pre_comp.nistp256 = EC_nistp256_pre_comp_dup(src->pre_comp.nistp256);
162 break;
66117ab0 163 case PCT_nistp521:
3aef36ff
RS
164 dest->pre_comp.nistp521 = EC_nistp521_pre_comp_dup(src->pre_comp.nistp521);
165 break;
f3b3d7f0
RS
166#else
167 case PCT_nistp224:
168 case PCT_nistp256:
169 case PCT_nistp521:
170 break;
3aef36ff 171#endif
66117ab0 172 case PCT_ec:
3aef36ff
RS
173 dest->pre_comp.ec = EC_ec_pre_comp_dup(src->pre_comp.ec);
174 break;
0f113f3e
MC
175 }
176
177 if (src->mont_data != NULL) {
178 if (dest->mont_data == NULL) {
179 dest->mont_data = BN_MONT_CTX_new();
180 if (dest->mont_data == NULL)
181 return 0;
182 }
183 if (!BN_MONT_CTX_copy(dest->mont_data, src->mont_data))
184 return 0;
185 } else {
186 /* src->generator == NULL */
23a1d5e9
RS
187 BN_MONT_CTX_free(dest->mont_data);
188 dest->mont_data = NULL;
0f113f3e 189 }
0657bf9c 190
0f113f3e
MC
191 if (src->generator != NULL) {
192 if (dest->generator == NULL) {
193 dest->generator = EC_POINT_new(dest);
194 if (dest->generator == NULL)
195 return 0;
196 }
197 if (!EC_POINT_copy(dest->generator, src->generator))
198 return 0;
199 } else {
200 /* src->generator == NULL */
8fdc3734
RS
201 EC_POINT_clear_free(dest->generator);
202 dest->generator = NULL;
0f113f3e
MC
203 }
204
6903e2e7
DSH
205 if ((src->meth->flags & EC_FLAGS_CUSTOM_CURVE) == 0) {
206 if (!BN_copy(dest->order, src->order))
207 return 0;
208 if (!BN_copy(dest->cofactor, src->cofactor))
209 return 0;
210 }
0f113f3e 211
0f113f3e
MC
212 dest->asn1_flag = src->asn1_flag;
213 dest->asn1_form = src->asn1_form;
214
215 if (src->seed) {
b548a1f1 216 OPENSSL_free(dest->seed);
cdb10bae
RS
217 if ((dest->seed = OPENSSL_malloc(src->seed_len)) == NULL) {
218 ECerr(EC_F_EC_GROUP_COPY, ERR_R_MALLOC_FAILURE);
0f113f3e 219 return 0;
cdb10bae 220 }
0f113f3e
MC
221 if (!memcpy(dest->seed, src->seed, src->seed_len))
222 return 0;
223 dest->seed_len = src->seed_len;
224 } else {
b548a1f1 225 OPENSSL_free(dest->seed);
0f113f3e
MC
226 dest->seed = NULL;
227 dest->seed_len = 0;
228 }
229
230 return dest->meth->group_copy(dest, src);
231}
0657bf9c 232
7793f30e 233EC_GROUP *EC_GROUP_dup(const EC_GROUP *a)
0f113f3e
MC
234{
235 EC_GROUP *t = NULL;
236 int ok = 0;
7793f30e 237
0f113f3e
MC
238 if (a == NULL)
239 return NULL;
7793f30e 240
0f113f3e 241 if ((t = EC_GROUP_new(a->meth)) == NULL)
26a7d938 242 return NULL;
0f113f3e
MC
243 if (!EC_GROUP_copy(t, a))
244 goto err;
7793f30e 245
0f113f3e 246 ok = 1;
7793f30e 247
0f113f3e
MC
248 err:
249 if (!ok) {
8fdc3734 250 EC_GROUP_free(t);
0f113f3e 251 return NULL;
8fdc3734 252 }
0f113f3e
MC
253 return t;
254}
7793f30e 255
48fe4d62 256const EC_METHOD *EC_GROUP_method_of(const EC_GROUP *group)
0f113f3e
MC
257{
258 return group->meth;
259}
48fe4d62 260
458c2917 261int EC_METHOD_get_field_type(const EC_METHOD *meth)
0f113f3e
MC
262{
263 return meth->field_type;
264}
265
eb791696
AP
266static int ec_precompute_mont_data(EC_GROUP *);
267
0f113f3e
MC
268int EC_GROUP_set_generator(EC_GROUP *group, const EC_POINT *generator,
269 const BIGNUM *order, const BIGNUM *cofactor)
270{
271 if (generator == NULL) {
272 ECerr(EC_F_EC_GROUP_SET_GENERATOR, ERR_R_PASSED_NULL_PARAMETER);
273 return 0;
274 }
275
276 if (group->generator == NULL) {
277 group->generator = EC_POINT_new(group);
278 if (group->generator == NULL)
279 return 0;
280 }
281 if (!EC_POINT_copy(group->generator, generator))
282 return 0;
283
284 if (order != NULL) {
285 if (!BN_copy(group->order, order))
286 return 0;
287 } else
288 BN_zero(group->order);
289
290 if (cofactor != NULL) {
291 if (!BN_copy(group->cofactor, cofactor))
292 return 0;
293 } else
294 BN_zero(group->cofactor);
295
296 /*
3a6a4a93 297 * Some groups have an order with
0f113f3e
MC
298 * factors of two, which makes the Montgomery setup fail.
299 * |group->mont_data| will be NULL in this case.
300 */
3a6a4a93
BB
301 if (BN_is_odd(group->order)) {
302 return ec_precompute_mont_data(group);
303 }
0f113f3e 304
3a6a4a93
BB
305 BN_MONT_CTX_free(group->mont_data);
306 group->mont_data = NULL;
0f113f3e
MC
307 return 1;
308}
bb62a8b0 309
9dd84053 310const EC_POINT *EC_GROUP_get0_generator(const EC_GROUP *group)
0f113f3e
MC
311{
312 return group->generator;
313}
bb62a8b0 314
f54be179 315BN_MONT_CTX *EC_GROUP_get_mont_data(const EC_GROUP *group)
0f113f3e
MC
316{
317 return group->mont_data;
318}
bb62a8b0 319
b6db386f 320int EC_GROUP_get_order(const EC_GROUP *group, BIGNUM *order, BN_CTX *ctx)
0f113f3e 321{
be2e334f
DSH
322 if (group->order == NULL)
323 return 0;
0f113f3e
MC
324 if (!BN_copy(order, group->order))
325 return 0;
0657bf9c 326
0f113f3e
MC
327 return !BN_is_zero(order);
328}
0657bf9c 329
be2e334f
DSH
330const BIGNUM *EC_GROUP_get0_order(const EC_GROUP *group)
331{
332 return group->order;
333}
334
335int EC_GROUP_order_bits(const EC_GROUP *group)
336{
77470e98 337 return group->meth->group_order_bits(group);
be2e334f
DSH
338}
339
0f113f3e
MC
340int EC_GROUP_get_cofactor(const EC_GROUP *group, BIGNUM *cofactor,
341 BN_CTX *ctx)
342{
be2e334f
DSH
343
344 if (group->cofactor == NULL)
345 return 0;
0f113f3e
MC
346 if (!BN_copy(cofactor, group->cofactor))
347 return 0;
48fe4d62 348
0f113f3e
MC
349 return !BN_is_zero(group->cofactor);
350}
48fe4d62 351
be2e334f
DSH
352const BIGNUM *EC_GROUP_get0_cofactor(const EC_GROUP *group)
353{
354 return group->cofactor;
355}
356
7dc17a6c 357void EC_GROUP_set_curve_name(EC_GROUP *group, int nid)
0f113f3e
MC
358{
359 group->curve_name = nid;
360}
b6db386f 361
7dc17a6c 362int EC_GROUP_get_curve_name(const EC_GROUP *group)
0f113f3e
MC
363{
364 return group->curve_name;
365}
b6db386f 366
458c2917 367void EC_GROUP_set_asn1_flag(EC_GROUP *group, int flag)
0f113f3e
MC
368{
369 group->asn1_flag = flag;
370}
458c2917
BM
371
372int EC_GROUP_get_asn1_flag(const EC_GROUP *group)
0f113f3e
MC
373{
374 return group->asn1_flag;
375}
458c2917 376
0f113f3e 377void EC_GROUP_set_point_conversion_form(EC_GROUP *group,
254ef80d 378 point_conversion_form_t form)
0f113f3e
MC
379{
380 group->asn1_form = form;
381}
254ef80d 382
0f113f3e
MC
383point_conversion_form_t EC_GROUP_get_point_conversion_form(const EC_GROUP
384 *group)
385{
386 return group->asn1_form;
387}
254ef80d 388
5f3d6f70 389size_t EC_GROUP_set_seed(EC_GROUP *group, const unsigned char *p, size_t len)
0f113f3e 390{
b548a1f1
RS
391 OPENSSL_free(group->seed);
392 group->seed = NULL;
393 group->seed_len = 0;
5f3d6f70 394
0f113f3e
MC
395 if (!len || !p)
396 return 1;
5f3d6f70 397
f06080cb
F
398 if ((group->seed = OPENSSL_malloc(len)) == NULL) {
399 ECerr(EC_F_EC_GROUP_SET_SEED, ERR_R_MALLOC_FAILURE);
0f113f3e 400 return 0;
f06080cb 401 }
0f113f3e
MC
402 memcpy(group->seed, p, len);
403 group->seed_len = len;
5f3d6f70 404
0f113f3e
MC
405 return len;
406}
5f3d6f70
BM
407
408unsigned char *EC_GROUP_get0_seed(const EC_GROUP *group)
0f113f3e
MC
409{
410 return group->seed;
411}
5f3d6f70
BM
412
413size_t EC_GROUP_get_seed_len(const EC_GROUP *group)
0f113f3e
MC
414{
415 return group->seed_len;
416}
417
8e3cced7
MC
418int EC_GROUP_set_curve(EC_GROUP *group, const BIGNUM *p, const BIGNUM *a,
419 const BIGNUM *b, BN_CTX *ctx)
0f113f3e
MC
420{
421 if (group->meth->group_set_curve == 0) {
8e3cced7 422 ECerr(EC_F_EC_GROUP_SET_CURVE, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
0f113f3e
MC
423 return 0;
424 }
425 return group->meth->group_set_curve(group, p, a, b, ctx);
426}
427
8e3cced7
MC
428int EC_GROUP_get_curve(const EC_GROUP *group, BIGNUM *p, BIGNUM *a, BIGNUM *b,
429 BN_CTX *ctx)
0f113f3e 430{
8e3cced7
MC
431 if (group->meth->group_get_curve == NULL) {
432 ECerr(EC_F_EC_GROUP_GET_CURVE, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
0f113f3e
MC
433 return 0;
434 }
435 return group->meth->group_get_curve(group, p, a, b, ctx);
436}
7793f30e 437
8e3cced7
MC
438int EC_GROUP_set_curve_GFp(EC_GROUP *group, const BIGNUM *p, const BIGNUM *a,
439 const BIGNUM *b, BN_CTX *ctx)
440{
441 return EC_GROUP_set_curve(group, p, a, b, ctx);
442}
443
444int EC_GROUP_get_curve_GFp(const EC_GROUP *group, BIGNUM *p, BIGNUM *a,
445 BIGNUM *b, BN_CTX *ctx)
446{
447 return EC_GROUP_get_curve(group, p, a, b, ctx);
448}
449
b3310161 450#ifndef OPENSSL_NO_EC2M
0f113f3e
MC
451int EC_GROUP_set_curve_GF2m(EC_GROUP *group, const BIGNUM *p, const BIGNUM *a,
452 const BIGNUM *b, BN_CTX *ctx)
453{
8e3cced7 454 return EC_GROUP_set_curve(group, p, a, b, ctx);
0f113f3e
MC
455}
456
457int EC_GROUP_get_curve_GF2m(const EC_GROUP *group, BIGNUM *p, BIGNUM *a,
458 BIGNUM *b, BN_CTX *ctx)
459{
8e3cced7 460 return EC_GROUP_get_curve(group, p, a, b, ctx);
0f113f3e 461}
b3310161 462#endif
7793f30e
BM
463
464int EC_GROUP_get_degree(const EC_GROUP *group)
0f113f3e
MC
465{
466 if (group->meth->group_get_degree == 0) {
467 ECerr(EC_F_EC_GROUP_GET_DEGREE, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
468 return 0;
469 }
470 return group->meth->group_get_degree(group);
471}
48fe4d62 472
17d6bb81 473int EC_GROUP_check_discriminant(const EC_GROUP *group, BN_CTX *ctx)
0f113f3e
MC
474{
475 if (group->meth->group_check_discriminant == 0) {
476 ECerr(EC_F_EC_GROUP_CHECK_DISCRIMINANT,
477 ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
478 return 0;
479 }
480 return group->meth->group_check_discriminant(group, ctx);
481}
af28dd6c 482
ada0e717 483int EC_GROUP_cmp(const EC_GROUP *a, const EC_GROUP *b, BN_CTX *ctx)
0f113f3e
MC
484{
485 int r = 0;
486 BIGNUM *a1, *a2, *a3, *b1, *b2, *b3;
487 BN_CTX *ctx_new = NULL;
488
489 /* compare the field types */
490 if (EC_METHOD_get_field_type(EC_GROUP_method_of(a)) !=
491 EC_METHOD_get_field_type(EC_GROUP_method_of(b)))
492 return 1;
493 /* compare the curve name (if present in both) */
494 if (EC_GROUP_get_curve_name(a) && EC_GROUP_get_curve_name(b) &&
495 EC_GROUP_get_curve_name(a) != EC_GROUP_get_curve_name(b))
496 return 1;
6903e2e7
DSH
497 if (a->meth->flags & EC_FLAGS_CUSTOM_CURVE)
498 return 0;
0f113f3e 499
90945fa3 500 if (ctx == NULL)
0f113f3e 501 ctx_new = ctx = BN_CTX_new();
90945fa3 502 if (ctx == NULL)
0f113f3e
MC
503 return -1;
504
505 BN_CTX_start(ctx);
506 a1 = BN_CTX_get(ctx);
507 a2 = BN_CTX_get(ctx);
508 a3 = BN_CTX_get(ctx);
509 b1 = BN_CTX_get(ctx);
510 b2 = BN_CTX_get(ctx);
511 b3 = BN_CTX_get(ctx);
90945fa3 512 if (b3 == NULL) {
0f113f3e 513 BN_CTX_end(ctx);
23a1d5e9 514 BN_CTX_free(ctx_new);
0f113f3e
MC
515 return -1;
516 }
517
518 /*
519 * XXX This approach assumes that the external representation of curves
520 * over the same field type is the same.
521 */
522 if (!a->meth->group_get_curve(a, a1, a2, a3, ctx) ||
523 !b->meth->group_get_curve(b, b1, b2, b3, ctx))
524 r = 1;
525
526 if (r || BN_cmp(a1, b1) || BN_cmp(a2, b2) || BN_cmp(a3, b3))
527 r = 1;
528
529 /* XXX EC_POINT_cmp() assumes that the methods are equal */
530 if (r || EC_POINT_cmp(a, EC_GROUP_get0_generator(a),
531 EC_GROUP_get0_generator(b), ctx))
532 r = 1;
533
534 if (!r) {
be2e334f 535 const BIGNUM *ao, *bo, *ac, *bc;
0f113f3e 536 /* compare the order and cofactor */
be2e334f
DSH
537 ao = EC_GROUP_get0_order(a);
538 bo = EC_GROUP_get0_order(b);
539 ac = EC_GROUP_get0_cofactor(a);
540 bc = EC_GROUP_get0_cofactor(b);
541 if (ao == NULL || bo == NULL) {
0f113f3e 542 BN_CTX_end(ctx);
23a1d5e9 543 BN_CTX_free(ctx_new);
0f113f3e
MC
544 return -1;
545 }
be2e334f 546 if (BN_cmp(ao, bo) || BN_cmp(ac, bc))
0f113f3e
MC
547 r = 1;
548 }
549
550 BN_CTX_end(ctx);
23a1d5e9 551 BN_CTX_free(ctx_new);
ada0e717 552
0f113f3e
MC
553 return r;
554}
ada0e717 555
0657bf9c
BM
556/* functions for EC_POINT objects */
557
558EC_POINT *EC_POINT_new(const EC_GROUP *group)
0f113f3e
MC
559{
560 EC_POINT *ret;
561
562 if (group == NULL) {
563 ECerr(EC_F_EC_POINT_NEW, ERR_R_PASSED_NULL_PARAMETER);
564 return NULL;
565 }
f06080cb 566 if (group->meth->point_init == NULL) {
0f113f3e
MC
567 ECerr(EC_F_EC_POINT_NEW, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
568 return NULL;
569 }
570
1b4cf96f 571 ret = OPENSSL_zalloc(sizeof(*ret));
0f113f3e
MC
572 if (ret == NULL) {
573 ECerr(EC_F_EC_POINT_NEW, ERR_R_MALLOC_FAILURE);
574 return NULL;
575 }
576
577 ret->meth = group->meth;
b14e6015 578 ret->curve_name = group->curve_name;
0f113f3e
MC
579
580 if (!ret->meth->point_init(ret)) {
581 OPENSSL_free(ret);
582 return NULL;
583 }
584
585 return ret;
586}
0657bf9c
BM
587
588void EC_POINT_free(EC_POINT *point)
0f113f3e
MC
589{
590 if (!point)
591 return;
7711de24 592
0f113f3e
MC
593 if (point->meth->point_finish != 0)
594 point->meth->point_finish(point);
595 OPENSSL_free(point);
596}
0657bf9c
BM
597
598void EC_POINT_clear_free(EC_POINT *point)
0f113f3e
MC
599{
600 if (!point)
601 return;
602
603 if (point->meth->point_clear_finish != 0)
604 point->meth->point_clear_finish(point);
605 else if (point->meth->point_finish != 0)
606 point->meth->point_finish(point);
b4faea50 607 OPENSSL_clear_free(point, sizeof(*point));
0f113f3e 608}
0657bf9c
BM
609
610int EC_POINT_copy(EC_POINT *dest, const EC_POINT *src)
0f113f3e
MC
611{
612 if (dest->meth->point_copy == 0) {
613 ECerr(EC_F_EC_POINT_COPY, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
614 return 0;
615 }
b14e6015
MC
616 if (dest->meth != src->meth
617 || (dest->curve_name != src->curve_name
618 && dest->curve_name != 0
619 && src->curve_name != 0)) {
0f113f3e
MC
620 ECerr(EC_F_EC_POINT_COPY, EC_R_INCOMPATIBLE_OBJECTS);
621 return 0;
622 }
623 if (dest == src)
624 return 1;
625 return dest->meth->point_copy(dest, src);
626}
0657bf9c 627
7793f30e 628EC_POINT *EC_POINT_dup(const EC_POINT *a, const EC_GROUP *group)
0f113f3e
MC
629{
630 EC_POINT *t;
631 int r;
632
633 if (a == NULL)
634 return NULL;
635
636 t = EC_POINT_new(group);
637 if (t == NULL)
26a7d938 638 return NULL;
0f113f3e
MC
639 r = EC_POINT_copy(t, a);
640 if (!r) {
641 EC_POINT_free(t);
642 return NULL;
8fdc3734
RS
643 }
644 return t;
0f113f3e 645}
7793f30e 646
48fe4d62 647const EC_METHOD *EC_POINT_method_of(const EC_POINT *point)
0f113f3e
MC
648{
649 return point->meth;
650}
48fe4d62 651
226cc7de 652int EC_POINT_set_to_infinity(const EC_GROUP *group, EC_POINT *point)
0f113f3e
MC
653{
654 if (group->meth->point_set_to_infinity == 0) {
655 ECerr(EC_F_EC_POINT_SET_TO_INFINITY,
656 ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
657 return 0;
658 }
659 if (group->meth != point->meth) {
660 ECerr(EC_F_EC_POINT_SET_TO_INFINITY, EC_R_INCOMPATIBLE_OBJECTS);
661 return 0;
662 }
663 return group->meth->point_set_to_infinity(group, point);
664}
665
666int EC_POINT_set_Jprojective_coordinates_GFp(const EC_GROUP *group,
667 EC_POINT *point, const BIGNUM *x,
668 const BIGNUM *y, const BIGNUM *z,
669 BN_CTX *ctx)
670{
671 if (group->meth->point_set_Jprojective_coordinates_GFp == 0) {
672 ECerr(EC_F_EC_POINT_SET_JPROJECTIVE_COORDINATES_GFP,
673 ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
674 return 0;
675 }
b14e6015 676 if (!ec_point_is_compat(point, group)) {
0f113f3e
MC
677 ECerr(EC_F_EC_POINT_SET_JPROJECTIVE_COORDINATES_GFP,
678 EC_R_INCOMPATIBLE_OBJECTS);
679 return 0;
680 }
681 return group->meth->point_set_Jprojective_coordinates_GFp(group, point, x,
682 y, z, ctx);
683}
684
685int EC_POINT_get_Jprojective_coordinates_GFp(const EC_GROUP *group,
686 const EC_POINT *point, BIGNUM *x,
687 BIGNUM *y, BIGNUM *z,
688 BN_CTX *ctx)
689{
690 if (group->meth->point_get_Jprojective_coordinates_GFp == 0) {
691 ECerr(EC_F_EC_POINT_GET_JPROJECTIVE_COORDINATES_GFP,
692 ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
693 return 0;
694 }
b14e6015 695 if (!ec_point_is_compat(point, group)) {
0f113f3e
MC
696 ECerr(EC_F_EC_POINT_GET_JPROJECTIVE_COORDINATES_GFP,
697 EC_R_INCOMPATIBLE_OBJECTS);
698 return 0;
699 }
700 return group->meth->point_get_Jprojective_coordinates_GFp(group, point, x,
701 y, z, ctx);
702}
703
8e3cced7
MC
704int EC_POINT_set_affine_coordinates(const EC_GROUP *group, EC_POINT *point,
705 const BIGNUM *x, const BIGNUM *y,
706 BN_CTX *ctx)
0f113f3e 707{
8e3cced7
MC
708 if (group->meth->point_set_affine_coordinates == NULL) {
709 ECerr(EC_F_EC_POINT_SET_AFFINE_COORDINATES,
0f113f3e
MC
710 ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
711 return 0;
712 }
b14e6015 713 if (!ec_point_is_compat(point, group)) {
8e3cced7 714 ECerr(EC_F_EC_POINT_SET_AFFINE_COORDINATES, EC_R_INCOMPATIBLE_OBJECTS);
0f113f3e
MC
715 return 0;
716 }
1e2012b7
EK
717 if (!group->meth->point_set_affine_coordinates(group, point, x, y, ctx))
718 return 0;
719
720 if (EC_POINT_is_on_curve(group, point, ctx) <= 0) {
8e3cced7 721 ECerr(EC_F_EC_POINT_SET_AFFINE_COORDINATES, EC_R_POINT_IS_NOT_ON_CURVE);
1e2012b7
EK
722 return 0;
723 }
724 return 1;
0f113f3e 725}
226cc7de 726
8e3cced7
MC
727int EC_POINT_set_affine_coordinates_GFp(const EC_GROUP *group,
728 EC_POINT *point, const BIGNUM *x,
729 const BIGNUM *y, BN_CTX *ctx)
730{
731 return EC_POINT_set_affine_coordinates(group, point, x, y, ctx);
732}
733
b3310161 734#ifndef OPENSSL_NO_EC2M
0f113f3e
MC
735int EC_POINT_set_affine_coordinates_GF2m(const EC_GROUP *group,
736 EC_POINT *point, const BIGNUM *x,
737 const BIGNUM *y, BN_CTX *ctx)
738{
8e3cced7
MC
739 return EC_POINT_set_affine_coordinates(group, point, x, y, ctx);
740}
741#endif
742
743int EC_POINT_get_affine_coordinates(const EC_GROUP *group,
744 const EC_POINT *point, BIGNUM *x, BIGNUM *y,
745 BN_CTX *ctx)
746{
747 if (group->meth->point_get_affine_coordinates == NULL) {
748 ECerr(EC_F_EC_POINT_GET_AFFINE_COORDINATES,
0f113f3e
MC
749 ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
750 return 0;
751 }
b14e6015 752 if (!ec_point_is_compat(point, group)) {
8e3cced7 753 ECerr(EC_F_EC_POINT_GET_AFFINE_COORDINATES, EC_R_INCOMPATIBLE_OBJECTS);
1e2012b7
EK
754 return 0;
755 }
8e3cced7 756 return group->meth->point_get_affine_coordinates(group, point, x, y, ctx);
0f113f3e 757}
7793f30e 758
0f113f3e
MC
759int EC_POINT_get_affine_coordinates_GFp(const EC_GROUP *group,
760 const EC_POINT *point, BIGNUM *x,
761 BIGNUM *y, BN_CTX *ctx)
762{
8e3cced7 763 return EC_POINT_get_affine_coordinates(group, point, x, y, ctx);
0f113f3e 764}
7793f30e 765
b3310161 766#ifndef OPENSSL_NO_EC2M
0f113f3e
MC
767int EC_POINT_get_affine_coordinates_GF2m(const EC_GROUP *group,
768 const EC_POINT *point, BIGNUM *x,
769 BIGNUM *y, BN_CTX *ctx)
770{
8e3cced7 771 return EC_POINT_get_affine_coordinates(group, point, x, y, ctx);
0f113f3e 772}
b3310161 773#endif
7793f30e 774
0f113f3e
MC
775int EC_POINT_add(const EC_GROUP *group, EC_POINT *r, const EC_POINT *a,
776 const EC_POINT *b, BN_CTX *ctx)
777{
778 if (group->meth->add == 0) {
779 ECerr(EC_F_EC_POINT_ADD, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
780 return 0;
781 }
b14e6015
MC
782 if (!ec_point_is_compat(r, group) || !ec_point_is_compat(a, group)
783 || !ec_point_is_compat(b, group)) {
0f113f3e
MC
784 ECerr(EC_F_EC_POINT_ADD, EC_R_INCOMPATIBLE_OBJECTS);
785 return 0;
786 }
787 return group->meth->add(group, r, a, b, ctx);
788}
789
790int EC_POINT_dbl(const EC_GROUP *group, EC_POINT *r, const EC_POINT *a,
791 BN_CTX *ctx)
792{
793 if (group->meth->dbl == 0) {
794 ECerr(EC_F_EC_POINT_DBL, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
795 return 0;
796 }
b14e6015 797 if (!ec_point_is_compat(r, group) || !ec_point_is_compat(a, group)) {
0f113f3e
MC
798 ECerr(EC_F_EC_POINT_DBL, EC_R_INCOMPATIBLE_OBJECTS);
799 return 0;
800 }
801 return group->meth->dbl(group, r, a, ctx);
802}
0657bf9c 803
1d5bd6cf 804int EC_POINT_invert(const EC_GROUP *group, EC_POINT *a, BN_CTX *ctx)
0f113f3e
MC
805{
806 if (group->meth->invert == 0) {
807 ECerr(EC_F_EC_POINT_INVERT, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
808 return 0;
809 }
b14e6015 810 if (!ec_point_is_compat(a, group)) {
0f113f3e
MC
811 ECerr(EC_F_EC_POINT_INVERT, EC_R_INCOMPATIBLE_OBJECTS);
812 return 0;
813 }
814 return group->meth->invert(group, a, ctx);
815}
1d5bd6cf 816
0657bf9c 817int EC_POINT_is_at_infinity(const EC_GROUP *group, const EC_POINT *point)
0f113f3e
MC
818{
819 if (group->meth->is_at_infinity == 0) {
820 ECerr(EC_F_EC_POINT_IS_AT_INFINITY,
821 ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
822 return 0;
823 }
b14e6015 824 if (!ec_point_is_compat(point, group)) {
0f113f3e
MC
825 ECerr(EC_F_EC_POINT_IS_AT_INFINITY, EC_R_INCOMPATIBLE_OBJECTS);
826 return 0;
827 }
828 return group->meth->is_at_infinity(group, point);
829}
830
68886be7
MC
831/*
832 * Check whether an EC_POINT is on the curve or not. Note that the return
833 * value for this function should NOT be treated as a boolean. Return values:
834 * 1: The point is on the curve
835 * 0: The point is not on the curve
836 * -1: An error occurred
837 */
0f113f3e
MC
838int EC_POINT_is_on_curve(const EC_GROUP *group, const EC_POINT *point,
839 BN_CTX *ctx)
840{
841 if (group->meth->is_on_curve == 0) {
842 ECerr(EC_F_EC_POINT_IS_ON_CURVE, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
843 return 0;
844 }
b14e6015 845 if (!ec_point_is_compat(point, group)) {
0f113f3e
MC
846 ECerr(EC_F_EC_POINT_IS_ON_CURVE, EC_R_INCOMPATIBLE_OBJECTS);
847 return 0;
848 }
849 return group->meth->is_on_curve(group, point, ctx);
850}
851
852int EC_POINT_cmp(const EC_GROUP *group, const EC_POINT *a, const EC_POINT *b,
853 BN_CTX *ctx)
854{
855 if (group->meth->point_cmp == 0) {
856 ECerr(EC_F_EC_POINT_CMP, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
857 return -1;
858 }
b14e6015 859 if (!ec_point_is_compat(a, group) || !ec_point_is_compat(b, group)) {
0f113f3e
MC
860 ECerr(EC_F_EC_POINT_CMP, EC_R_INCOMPATIBLE_OBJECTS);
861 return -1;
862 }
863 return group->meth->point_cmp(group, a, b, ctx);
864}
1d5bd6cf 865
e869d4bd 866int EC_POINT_make_affine(const EC_GROUP *group, EC_POINT *point, BN_CTX *ctx)
0f113f3e
MC
867{
868 if (group->meth->make_affine == 0) {
869 ECerr(EC_F_EC_POINT_MAKE_AFFINE, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
870 return 0;
871 }
b14e6015 872 if (!ec_point_is_compat(point, group)) {
0f113f3e
MC
873 ECerr(EC_F_EC_POINT_MAKE_AFFINE, EC_R_INCOMPATIBLE_OBJECTS);
874 return 0;
875 }
876 return group->meth->make_affine(group, point, ctx);
877}
878
879int EC_POINTs_make_affine(const EC_GROUP *group, size_t num,
880 EC_POINT *points[], BN_CTX *ctx)
881{
882 size_t i;
883
884 if (group->meth->points_make_affine == 0) {
885 ECerr(EC_F_EC_POINTS_MAKE_AFFINE, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
886 return 0;
887 }
888 for (i = 0; i < num; i++) {
b14e6015 889 if (!ec_point_is_compat(points[i], group)) {
0f113f3e
MC
890 ECerr(EC_F_EC_POINTS_MAKE_AFFINE, EC_R_INCOMPATIBLE_OBJECTS);
891 return 0;
892 }
893 }
894 return group->meth->points_make_affine(group, num, points, ctx);
895}
896
897/*
898 * Functions for point multiplication. If group->meth->mul is 0, we use the
899 * wNAF-based implementations in ec_mult.c; otherwise we dispatch through
900 * methods.
37c660ff
BM
901 */
902
903int EC_POINTs_mul(const EC_GROUP *group, EC_POINT *r, const BIGNUM *scalar,
0f113f3e
MC
904 size_t num, const EC_POINT *points[],
905 const BIGNUM *scalars[], BN_CTX *ctx)
906{
01ad66f8
NT
907 int ret = 0;
908 size_t i = 0;
909 BN_CTX *new_ctx = NULL;
910
911 if ((scalar == NULL) && (num == 0)) {
912 return EC_POINT_set_to_infinity(group, r);
913 }
914
915 if (!ec_point_is_compat(r, group)) {
916 ECerr(EC_F_EC_POINTS_MUL, EC_R_INCOMPATIBLE_OBJECTS);
917 return 0;
918 }
919 for (i = 0; i < num; i++) {
920 if (!ec_point_is_compat(points[i], group)) {
921 ECerr(EC_F_EC_POINTS_MUL, EC_R_INCOMPATIBLE_OBJECTS);
922 return 0;
923 }
924 }
925
926 if (ctx == NULL && (ctx = new_ctx = BN_CTX_secure_new()) == NULL) {
927 ECerr(EC_F_EC_POINTS_MUL, ERR_R_INTERNAL_ERROR);
928 return 0;
929 }
930
931 if (group->meth->mul != NULL)
932 ret = group->meth->mul(group, r, scalar, num, points, scalars, ctx);
933 else
0f113f3e 934 /* use default */
01ad66f8 935 ret = ec_wNAF_mul(group, r, scalar, num, points, scalars, ctx);
37c660ff 936
01ad66f8
NT
937 BN_CTX_free(new_ctx);
938 return ret;
0f113f3e 939}
37c660ff
BM
940
941int EC_POINT_mul(const EC_GROUP *group, EC_POINT *r, const BIGNUM *g_scalar,
0f113f3e
MC
942 const EC_POINT *point, const BIGNUM *p_scalar, BN_CTX *ctx)
943{
944 /* just a convenient interface to EC_POINTs_mul() */
37c660ff 945
0f113f3e
MC
946 const EC_POINT *points[1];
947 const BIGNUM *scalars[1];
37c660ff 948
0f113f3e
MC
949 points[0] = point;
950 scalars[0] = p_scalar;
37c660ff 951
0f113f3e
MC
952 return EC_POINTs_mul(group, r, g_scalar,
953 (point != NULL
954 && p_scalar != NULL), points, scalars, ctx);
955}
37c660ff
BM
956
957int EC_GROUP_precompute_mult(EC_GROUP *group, BN_CTX *ctx)
0f113f3e
MC
958{
959 if (group->meth->mul == 0)
960 /* use default */
961 return ec_wNAF_precompute_mult(group, ctx);
37c660ff 962
0f113f3e
MC
963 if (group->meth->precompute_mult != 0)
964 return group->meth->precompute_mult(group, ctx);
965 else
966 return 1; /* nothing to do, so report success */
967}
37c660ff
BM
968
969int EC_GROUP_have_precompute_mult(const EC_GROUP *group)
0f113f3e
MC
970{
971 if (group->meth->mul == 0)
972 /* use default */
973 return ec_wNAF_have_precompute_mult(group);
974
975 if (group->meth->have_precompute_mult != 0)
976 return group->meth->have_precompute_mult(group);
977 else
978 return 0; /* cannot tell whether precomputation has
979 * been performed */
980}
981
982/*
983 * ec_precompute_mont_data sets |group->mont_data| from |group->order| and
984 * returns one on success. On error it returns zero.
985 */
eb791696 986static int ec_precompute_mont_data(EC_GROUP *group)
0f113f3e
MC
987{
988 BN_CTX *ctx = BN_CTX_new();
989 int ret = 0;
990
23a1d5e9
RS
991 BN_MONT_CTX_free(group->mont_data);
992 group->mont_data = NULL;
0f113f3e
MC
993
994 if (ctx == NULL)
995 goto err;
996
997 group->mont_data = BN_MONT_CTX_new();
90945fa3 998 if (group->mont_data == NULL)
0f113f3e
MC
999 goto err;
1000
1001 if (!BN_MONT_CTX_set(group->mont_data, group->order, ctx)) {
1002 BN_MONT_CTX_free(group->mont_data);
1003 group->mont_data = NULL;
1004 goto err;
1005 }
1006
1007 ret = 1;
1008
1009 err:
1010
23a1d5e9 1011 BN_CTX_free(ctx);
0f113f3e
MC
1012 return ret;
1013}
3aef36ff
RS
1014
1015int EC_KEY_set_ex_data(EC_KEY *key, int idx, void *arg)
1016{
1017 return CRYPTO_set_ex_data(&key->ex_data, idx, arg);
1018}
1019
1020void *EC_KEY_get_ex_data(const EC_KEY *key, int idx)
1021{
1022 return CRYPTO_get_ex_data(&key->ex_data, idx);
1023}
77470e98
DSH
1024
1025int ec_group_simple_order_bits(const EC_GROUP *group)
1026{
1027 if (group->order == NULL)
1028 return 0;
1029 return BN_num_bits(group->order);
1030}
eb791696 1031
c11d372b 1032static int ec_field_inverse_mod_ord(const EC_GROUP *group, BIGNUM *r,
792546eb 1033 const BIGNUM *x, BN_CTX *ctx)
c11d372b 1034{
262dccc0 1035 BIGNUM *e = NULL;
c11d372b
BB
1036 BN_CTX *new_ctx = NULL;
1037 int ret = 0;
1038
792546eb
BB
1039 if (group->mont_data == NULL)
1040 return 0;
1041
c11d372b
BB
1042 if (ctx == NULL && (ctx = new_ctx = BN_CTX_secure_new()) == NULL)
1043 return 0;
1044
1045 BN_CTX_start(ctx);
262dccc0 1046 if ((e = BN_CTX_get(ctx)) == NULL)
c11d372b
BB
1047 goto err;
1048
792546eb
BB
1049 /*-
1050 * We want inverse in constant time, therefore we utilize the fact
1051 * order must be prime and use Fermats Little Theorem instead.
1052 */
1053 if (!BN_set_word(e, 2))
1054 goto err;
1055 if (!BN_sub(e, group->order, e))
1056 goto err;
1057 /*-
1058 * Exponent e is public.
1059 * No need for scatter-gather or BN_FLG_CONSTTIME.
1060 */
1061 if (!BN_mod_exp_mont(r, x, e, group->order, ctx, group->mont_data))
1062 goto err;
c11d372b 1063
792546eb 1064 ret = 1;
c11d372b
BB
1065
1066 err:
262dccc0
BB
1067 if (ctx != NULL)
1068 BN_CTX_end(ctx);
c11d372b
BB
1069 BN_CTX_free(new_ctx);
1070 return ret;
1071}
1072
792546eb
BB
1073/*-
1074 * Default behavior, if group->meth->field_inverse_mod_ord is NULL:
1075 * - When group->order is even, this function returns an error.
1076 * - When group->order is otherwise composite, the correctness
1077 * of the output is not guaranteed.
1078 * - When x is outside the range [1, group->order), the correctness
1079 * of the output is not guaranteed.
1080 * - Otherwise, this function returns the multiplicative inverse in the
1081 * range [1, group->order).
1082 *
1083 * EC_METHODs must implement their own field_inverse_mod_ord for
1084 * other functionality.
1085 */
1086int ec_group_do_inverse_ord(const EC_GROUP *group, BIGNUM *res,
1087 const BIGNUM *x, BN_CTX *ctx)
eb791696
AP
1088{
1089 if (group->meth->field_inverse_mod_ord != NULL)
1090 return group->meth->field_inverse_mod_ord(group, res, x, ctx);
1091 else
c11d372b 1092 return ec_field_inverse_mod_ord(group, res, x, ctx);
eb791696 1093}
f667820c
SH
1094
1095/*-
1096 * Coordinate blinding for EC_POINT.
1097 *
1098 * The underlying EC_METHOD can optionally implement this function:
1099 * underlying implementations should return 0 on errors, or 1 on
1100 * success.
1101 *
1102 * This wrapper returns 1 in case the underlying EC_METHOD does not
1103 * support coordinate blinding.
1104 */
1105int ec_point_blind_coordinates(const EC_GROUP *group, EC_POINT *p, BN_CTX *ctx)
1106{
1107 if (group->meth->blind_coordinates == NULL)
1108 return 1; /* ignore if not implemented */
1109
1110 return group->meth->blind_coordinates(group, p, ctx);
1111}