1 /* crypto/ec/ec_lib.c */
2 /* ====================================================================
3 * Copyright (c) 1998-2002 The OpenSSL Project. All rights reserved.
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
9 * 1. Redistributions of source code must retain the above copyright
10 * notice, this list of conditions and the following disclaimer.
12 * 2. Redistributions in binary form must reproduce the above copyright
13 * notice, this list of conditions and the following disclaimer in
14 * the documentation and/or other materials provided with the
17 * 3. All advertising materials mentioning features or use of this
18 * software must display the following acknowledgment:
19 * "This product includes software developed by the OpenSSL Project
20 * for use in the OpenSSL Toolkit. (http://www.openssl.org/)"
22 * 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
23 * endorse or promote products derived from this software without
24 * prior written permission. For written permission, please contact
25 * openssl-core@openssl.org.
27 * 5. Products derived from this software may not be called "OpenSSL"
28 * nor may "OpenSSL" appear in their names without prior written
29 * permission of the OpenSSL Project.
31 * 6. Redistributions of any form whatsoever must retain the following
33 * "This product includes software developed by the OpenSSL Project
34 * for use in the OpenSSL Toolkit (http://www.openssl.org/)"
36 * THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY
37 * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
38 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
39 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR
40 * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
41 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
42 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
43 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
44 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
45 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
46 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
47 * OF THE POSSIBILITY OF SUCH DAMAGE.
48 * ====================================================================
50 * This product includes cryptographic software written by Eric Young
51 * (eay@cryptsoft.com). This product includes software written by Tim
52 * Hudson (tjh@cryptsoft.com).
58 #include <openssl/err.h>
59 #include <openssl/opensslv.h>
63 static const char EC_version[] = "EC" OPENSSL_VERSION_PTEXT;
66 /* functions for EC_GROUP objects */
68 EC_GROUP *EC_GROUP_new(const EC_METHOD *meth)
74 ECerr(EC_F_EC_GROUP_NEW, ERR_R_PASSED_NULL_PARAMETER);
77 if (meth->group_init == 0)
79 ECerr(EC_F_EC_GROUP_NEW, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
83 ret = OPENSSL_malloc(sizeof *ret);
86 ECerr(EC_F_EC_GROUP_NEW, ERR_R_MALLOC_FAILURE);
92 ret->extra_data = NULL;
93 ret->extra_data_dup_func = 0;
94 ret->extra_data_free_func = 0;
95 ret->extra_data_clear_free_func = 0;
99 if (!meth->group_init(ret))
109 void EC_GROUP_free(EC_GROUP *group)
111 if (group->meth->group_finish != 0)
112 group->meth->group_finish(group);
114 EC_GROUP_free_extra_data(group);
120 void EC_GROUP_clear_free(EC_GROUP *group)
122 if (group->meth->group_clear_finish != 0)
123 group->meth->group_clear_finish(group);
124 else if (group->meth != NULL && group->meth->group_finish != 0)
125 group->meth->group_finish(group);
127 EC_GROUP_clear_free_extra_data(group);
129 memset(group, 0, sizeof *group);
134 int EC_GROUP_copy(EC_GROUP *dest, const EC_GROUP *src)
136 if (dest->meth->group_copy == 0)
138 ECerr(EC_F_EC_GROUP_COPY, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
141 if (dest->meth != src->meth)
143 ECerr(EC_F_EC_GROUP_COPY, EC_R_INCOMPATIBLE_OBJECTS);
149 EC_GROUP_clear_free_extra_data(dest);
150 if (src->extra_data_dup_func)
152 if (src->extra_data != NULL)
154 dest->extra_data = src->extra_data_dup_func(src->extra_data);
155 if (dest->extra_data == NULL)
159 dest->extra_data_dup_func = src->extra_data_dup_func;
160 dest->extra_data_free_func = src->extra_data_free_func;
161 dest->extra_data_clear_free_func = src->extra_data_clear_free_func;
164 return dest->meth->group_copy(dest, src);
168 const EC_METHOD *EC_GROUP_method_of(const EC_GROUP *group)
174 int EC_GROUP_set_curve_GFp(EC_GROUP *group, const BIGNUM *p, const BIGNUM *a, const BIGNUM *b, BN_CTX *ctx)
176 if (group->meth->group_set_curve_GFp == 0)
178 ECerr(EC_F_EC_GROUP_SET_CURVE_GFP, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
181 return group->meth->group_set_curve_GFp(group, p, a, b, ctx);
185 int EC_GROUP_get_curve_GFp(const EC_GROUP *group, BIGNUM *p, BIGNUM *a, BIGNUM *b, BN_CTX *ctx)
187 if (group->meth->group_get_curve_GFp == 0)
189 ECerr(EC_F_EC_GROUP_GET_CURVE_GFP, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
192 return group->meth->group_get_curve_GFp(group, p, a, b, ctx);
196 int EC_GROUP_set_generator(EC_GROUP *group, const EC_POINT *generator, const BIGNUM *order, const BIGNUM *cofactor)
198 if (group->meth->group_set_generator == 0)
200 ECerr(EC_F_EC_GROUP_SET_GENERATOR, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
203 return group->meth->group_set_generator(group, generator, order, cofactor);
207 EC_POINT *EC_GROUP_get0_generator(const EC_GROUP *group)
209 if (group->meth->group_get0_generator == 0)
211 ECerr(EC_F_EC_GROUP_GET0_GENERATOR, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
214 return group->meth->group_get0_generator(group);
218 int EC_GROUP_get_order(const EC_GROUP *group, BIGNUM *order, BN_CTX *ctx)
220 if (group->meth->group_get_order == 0)
222 ECerr(EC_F_EC_GROUP_GET_ORDER, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
225 return group->meth->group_get_order(group, order, ctx);
229 int EC_GROUP_get_cofactor(const EC_GROUP *group, BIGNUM *cofactor, BN_CTX *ctx)
231 if (group->meth->group_get_cofactor == 0)
233 ECerr(EC_F_EC_GROUP_GET_COFACTOR, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
236 return group->meth->group_get_cofactor(group, cofactor, ctx);
240 int EC_GROUP_check_discriminant(const EC_GROUP *group, BN_CTX *ctx)
242 if (group->meth->group_check_discriminant == 0)
244 ECerr(EC_F_EC_GROUP_CHECK_DISCRIMINANT, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
247 return group->meth->group_check_discriminant(group, ctx);
251 void EC_GROUP_set_nid(EC_GROUP *group, int nid)
257 int EC_GROUP_get_nid(const EC_GROUP *group)
263 /* this has 'package' visibility */
264 int EC_GROUP_set_extra_data(EC_GROUP *group, void *extra_data, void *(*extra_data_dup_func)(void *),
265 void (*extra_data_free_func)(void *), void (*extra_data_clear_free_func)(void *))
267 if ((group->extra_data != NULL)
268 || (group->extra_data_dup_func != 0)
269 || (group->extra_data_free_func != 0)
270 || (group->extra_data_clear_free_func != 0))
272 ECerr(EC_F_EC_GROUP_SET_EXTRA_DATA, EC_R_SLOT_FULL);
276 group->extra_data = extra_data;
277 group->extra_data_dup_func = extra_data_dup_func;
278 group->extra_data_free_func = extra_data_free_func;
279 group->extra_data_clear_free_func = extra_data_clear_free_func;
284 /* this has 'package' visibility */
285 void *EC_GROUP_get_extra_data(const EC_GROUP *group, void *(*extra_data_dup_func)(void *),
286 void (*extra_data_free_func)(void *), void (*extra_data_clear_free_func)(void *))
288 if ((group->extra_data_dup_func != extra_data_dup_func)
289 || (group->extra_data_free_func != extra_data_free_func)
290 || (group->extra_data_clear_free_func != extra_data_clear_free_func))
292 ECerr(EC_F_EC_GROUP_GET_EXTRA_DATA, EC_R_NO_SUCH_EXTRA_DATA);
296 return group->extra_data;
300 /* this has 'package' visibility */
301 void EC_GROUP_free_extra_data(EC_GROUP *group)
303 if (group->extra_data_free_func)
304 group->extra_data_free_func(group->extra_data);
305 group->extra_data = NULL;
306 group->extra_data_dup_func = 0;
307 group->extra_data_free_func = 0;
308 group->extra_data_clear_free_func = 0;
312 /* this has 'package' visibility */
313 void EC_GROUP_clear_free_extra_data(EC_GROUP *group)
315 if (group->extra_data_clear_free_func)
316 group->extra_data_clear_free_func(group->extra_data);
317 else if (group->extra_data_free_func)
318 group->extra_data_free_func(group->extra_data);
319 group->extra_data = NULL;
320 group->extra_data_dup_func = 0;
321 group->extra_data_free_func = 0;
322 group->extra_data_clear_free_func = 0;
326 /* functions for EC_POINT objects */
328 EC_POINT *EC_POINT_new(const EC_GROUP *group)
334 ECerr(EC_F_EC_POINT_NEW, ERR_R_PASSED_NULL_PARAMETER);
337 if (group->meth->point_init == 0)
339 ECerr(EC_F_EC_POINT_NEW, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
343 ret = OPENSSL_malloc(sizeof *ret);
346 ECerr(EC_F_EC_POINT_NEW, ERR_R_MALLOC_FAILURE);
350 ret->meth = group->meth;
352 if (!ret->meth->point_init(ret))
362 void EC_POINT_free(EC_POINT *point)
364 if (point->meth->point_finish != 0)
365 point->meth->point_finish(point);
370 void EC_POINT_clear_free(EC_POINT *point)
372 if (point->meth->point_clear_finish != 0)
373 point->meth->point_clear_finish(point);
374 else if (point->meth != NULL && point->meth->point_finish != 0)
375 point->meth->point_finish(point);
376 memset(point, 0, sizeof *point);
381 int EC_POINT_copy(EC_POINT *dest, const EC_POINT *src)
383 if (dest->meth->point_copy == 0)
385 ECerr(EC_F_EC_POINT_COPY, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
388 if (dest->meth != src->meth)
390 ECerr(EC_F_EC_POINT_COPY, EC_R_INCOMPATIBLE_OBJECTS);
395 return dest->meth->point_copy(dest, src);
399 const EC_METHOD *EC_POINT_method_of(const EC_POINT *point)
405 int EC_POINT_set_to_infinity(const EC_GROUP *group, EC_POINT *point)
407 if (group->meth->point_set_to_infinity == 0)
409 ECerr(EC_F_EC_POINT_SET_TO_INFINITY, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
412 if (group->meth != point->meth)
414 ECerr(EC_F_EC_POINT_SET_TO_INFINITY, EC_R_INCOMPATIBLE_OBJECTS);
417 return group->meth->point_set_to_infinity(group, point);
421 int EC_POINT_set_Jprojective_coordinates_GFp(const EC_GROUP *group, EC_POINT *point,
422 const BIGNUM *x, const BIGNUM *y, const BIGNUM *z, BN_CTX *ctx)
424 if (group->meth->point_set_Jprojective_coordinates_GFp == 0)
426 ECerr(EC_F_EC_POINT_SET_JPROJECTIVE_COORDINATES_GFP, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
429 if (group->meth != point->meth)
431 ECerr(EC_F_EC_POINT_SET_JPROJECTIVE_COORDINATES_GFP, EC_R_INCOMPATIBLE_OBJECTS);
434 return group->meth->point_set_Jprojective_coordinates_GFp(group, point, x, y, z, ctx);
438 int EC_POINT_get_Jprojective_coordinates_GFp(const EC_GROUP *group, const EC_POINT *point,
439 BIGNUM *x, BIGNUM *y, BIGNUM *z, BN_CTX *ctx)
441 if (group->meth->point_get_Jprojective_coordinates_GFp == 0)
443 ECerr(EC_F_EC_POINT_GET_JPROJECTIVE_COORDINATES_GFP, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
446 if (group->meth != point->meth)
448 ECerr(EC_F_EC_POINT_GET_JPROJECTIVE_COORDINATES_GFP, EC_R_INCOMPATIBLE_OBJECTS);
451 return group->meth->point_get_Jprojective_coordinates_GFp(group, point, x, y, z, ctx);
455 int EC_POINT_set_affine_coordinates_GFp(const EC_GROUP *group, EC_POINT *point,
456 const BIGNUM *x, const BIGNUM *y, BN_CTX *ctx)
458 if (group->meth->point_set_affine_coordinates_GFp == 0)
460 ECerr(EC_F_EC_POINT_SET_AFFINE_COORDINATES_GFP, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
463 if (group->meth != point->meth)
465 ECerr(EC_F_EC_POINT_SET_AFFINE_COORDINATES_GFP, EC_R_INCOMPATIBLE_OBJECTS);
468 return group->meth->point_set_affine_coordinates_GFp(group, point, x, y, ctx);
472 int EC_POINT_get_affine_coordinates_GFp(const EC_GROUP *group, const EC_POINT *point,
473 BIGNUM *x, BIGNUM *y, BN_CTX *ctx)
475 if (group->meth->point_get_affine_coordinates_GFp == 0)
477 ECerr(EC_F_EC_POINT_GET_AFFINE_COORDINATES_GFP, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
480 if (group->meth != point->meth)
482 ECerr(EC_F_EC_POINT_GET_AFFINE_COORDINATES_GFP, EC_R_INCOMPATIBLE_OBJECTS);
485 return group->meth->point_get_affine_coordinates_GFp(group, point, x, y, ctx);
489 int EC_POINT_set_compressed_coordinates_GFp(const EC_GROUP *group, EC_POINT *point,
490 const BIGNUM *x, int y_bit, BN_CTX *ctx)
492 if (group->meth->point_set_compressed_coordinates_GFp == 0)
494 ECerr(EC_F_EC_POINT_SET_COMPRESSED_COORDINATES_GFP, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
497 if (group->meth != point->meth)
499 ECerr(EC_F_EC_POINT_SET_COMPRESSED_COORDINATES_GFP, EC_R_INCOMPATIBLE_OBJECTS);
502 return group->meth->point_set_compressed_coordinates_GFp(group, point, x, y_bit, ctx);
506 size_t EC_POINT_point2oct(const EC_GROUP *group, const EC_POINT *point, point_conversion_form_t form,
507 unsigned char *buf, size_t len, BN_CTX *ctx)
509 if (group->meth->point2oct == 0)
511 ECerr(EC_F_EC_POINT_POINT2OCT, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
514 if (group->meth != point->meth)
516 ECerr(EC_F_EC_POINT_POINT2OCT, EC_R_INCOMPATIBLE_OBJECTS);
519 return group->meth->point2oct(group, point, form, buf, len, ctx);
523 int EC_POINT_oct2point(const EC_GROUP *group, EC_POINT *point,
524 const unsigned char *buf, size_t len, BN_CTX *ctx)
526 if (group->meth->oct2point == 0)
528 ECerr(EC_F_EC_POINT_OCT2POINT, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
531 if (group->meth != point->meth)
533 ECerr(EC_F_EC_POINT_OCT2POINT, EC_R_INCOMPATIBLE_OBJECTS);
536 return group->meth->oct2point(group, point, buf, len, ctx);
540 int EC_POINT_add(const EC_GROUP *group, EC_POINT *r, const EC_POINT *a, const EC_POINT *b, BN_CTX *ctx)
542 if (group->meth->add == 0)
544 ECerr(EC_F_EC_POINT_ADD, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
547 if ((group->meth != r->meth) || (r->meth != a->meth) || (a->meth != b->meth))
549 ECerr(EC_F_EC_POINT_ADD, EC_R_INCOMPATIBLE_OBJECTS);
552 return group->meth->add(group, r, a, b, ctx);
556 int EC_POINT_dbl(const EC_GROUP *group, EC_POINT *r, const EC_POINT *a, BN_CTX *ctx)
558 if (group->meth->dbl == 0)
560 ECerr(EC_F_EC_POINT_DBL, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
563 if ((group->meth != r->meth) || (r->meth != a->meth))
565 ECerr(EC_F_EC_POINT_DBL, EC_R_INCOMPATIBLE_OBJECTS);
568 return group->meth->dbl(group, r, a, ctx);
572 int EC_POINT_invert(const EC_GROUP *group, EC_POINT *a, BN_CTX *ctx)
574 if (group->meth->dbl == 0)
576 ECerr(EC_F_EC_POINT_DBL, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
579 if (group->meth != a->meth)
581 ECerr(EC_F_EC_POINT_DBL, EC_R_INCOMPATIBLE_OBJECTS);
584 return group->meth->invert(group, a, ctx);
588 int EC_POINT_is_at_infinity(const EC_GROUP *group, const EC_POINT *point)
590 if (group->meth->is_at_infinity == 0)
592 ECerr(EC_F_EC_POINT_IS_AT_INFINITY, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
595 if (group->meth != point->meth)
597 ECerr(EC_F_EC_POINT_IS_AT_INFINITY, EC_R_INCOMPATIBLE_OBJECTS);
600 return group->meth->is_at_infinity(group, point);
604 int EC_POINT_is_on_curve(const EC_GROUP *group, const EC_POINT *point, BN_CTX *ctx)
606 if (group->meth->is_on_curve == 0)
608 ECerr(EC_F_EC_POINT_IS_ON_CURVE, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
611 if (group->meth != point->meth)
613 ECerr(EC_F_EC_POINT_IS_ON_CURVE, EC_R_INCOMPATIBLE_OBJECTS);
616 return group->meth->is_on_curve(group, point, ctx);
620 int EC_POINT_cmp(const EC_GROUP *group, const EC_POINT *a, const EC_POINT *b, BN_CTX *ctx)
622 if (group->meth->point_cmp == 0)
624 ECerr(EC_F_EC_POINT_CMP, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
627 if ((group->meth != a->meth) || (a->meth != b->meth))
629 ECerr(EC_F_EC_POINT_CMP, EC_R_INCOMPATIBLE_OBJECTS);
632 return group->meth->point_cmp(group, a, b, ctx);
636 int EC_POINT_make_affine(const EC_GROUP *group, EC_POINT *point, BN_CTX *ctx)
638 if (group->meth->make_affine == 0)
640 ECerr(EC_F_EC_POINT_MAKE_AFFINE, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
643 if (group->meth != point->meth)
645 ECerr(EC_F_EC_POINT_MAKE_AFFINE, EC_R_INCOMPATIBLE_OBJECTS);
648 return group->meth->make_affine(group, point, ctx);
652 int EC_POINTs_make_affine(const EC_GROUP *group, size_t num, EC_POINT *points[], BN_CTX *ctx)
656 if (group->meth->points_make_affine == 0)
658 ECerr(EC_F_EC_POINTS_MAKE_AFFINE, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
661 for (i = 0; i < num; i++)
663 if (group->meth != points[i]->meth)
665 ECerr(EC_F_EC_POINTS_MAKE_AFFINE, EC_R_INCOMPATIBLE_OBJECTS);
669 return group->meth->points_make_affine(group, num, points, ctx);