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;
97 ret->generator = NULL;
99 BN_init(&ret->cofactor);
103 ret->asn1_form = POINT_CONVERSION_UNCOMPRESSED;
108 if (!meth->group_init(ret))
118 void EC_GROUP_free(EC_GROUP *group)
122 if (group->meth->group_finish != 0)
123 group->meth->group_finish(group);
125 EC_GROUP_free_extra_data(group);
127 if (group->generator != NULL)
128 EC_POINT_free(group->generator);
129 BN_free(&group->order);
130 BN_free(&group->cofactor);
133 OPENSSL_free(group->seed);
139 void EC_GROUP_clear_free(EC_GROUP *group)
143 if (group->meth->group_clear_finish != 0)
144 group->meth->group_clear_finish(group);
145 else if (group->meth != NULL && group->meth->group_finish != 0)
146 group->meth->group_finish(group);
148 EC_GROUP_clear_free_extra_data(group);
150 if (group->generator != NULL)
151 EC_POINT_clear_free(group->generator);
152 BN_clear_free(&group->order);
153 BN_clear_free(&group->cofactor);
157 memset(group->seed, 0, group->seed_len);
158 OPENSSL_free(group->seed);
161 memset(group, 0, sizeof *group);
166 int EC_GROUP_copy(EC_GROUP *dest, const EC_GROUP *src)
168 if (dest->meth->group_copy == 0)
170 ECerr(EC_F_EC_GROUP_COPY, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
173 if (dest->meth != src->meth)
175 ECerr(EC_F_EC_GROUP_COPY, EC_R_INCOMPATIBLE_OBJECTS);
181 EC_GROUP_clear_free_extra_data(dest);
182 if (src->extra_data_dup_func)
184 if (src->extra_data != NULL)
186 dest->extra_data = src->extra_data_dup_func(src->extra_data);
187 if (dest->extra_data == NULL)
191 dest->extra_data_dup_func = src->extra_data_dup_func;
192 dest->extra_data_free_func = src->extra_data_free_func;
193 dest->extra_data_clear_free_func = src->extra_data_clear_free_func;
196 if (src->generator != NULL)
198 if (dest->generator == NULL)
200 dest->generator = EC_POINT_new(dest);
201 if (dest->generator == NULL) return 0;
203 if (!EC_POINT_copy(dest->generator, src->generator)) return 0;
207 /* src->generator == NULL */
208 if (dest->generator != NULL)
210 EC_POINT_clear_free(dest->generator);
211 dest->generator = NULL;
215 if (!BN_copy(&dest->order, &src->order)) return 0;
216 if (!BN_copy(&dest->cofactor, &src->cofactor)) return 0;
218 dest->curve_name = src->curve_name;
219 dest->asn1_flag = src->asn1_flag;
220 dest->asn1_form = src->asn1_form;
225 OPENSSL_free(dest->seed);
226 dest->seed = OPENSSL_malloc(src->seed_len);
227 if (dest->seed == NULL)
229 if (!memcpy(dest->seed, src->seed, src->seed_len))
231 dest->seed_len = src->seed_len;
236 OPENSSL_free(dest->seed);
242 return dest->meth->group_copy(dest, src);
246 const EC_METHOD *EC_GROUP_method_of(const EC_GROUP *group)
252 int EC_METHOD_get_field_type(const EC_METHOD *meth)
254 return meth->field_type;
258 int EC_GROUP_set_generator(EC_GROUP *group, const EC_POINT *generator, const BIGNUM *order, const BIGNUM *cofactor)
260 if (generator == NULL)
262 ECerr(EC_F_EC_GROUP_SET_GENERATOR, ERR_R_PASSED_NULL_PARAMETER);
266 if (group->generator == NULL)
268 group->generator = EC_POINT_new(group);
269 if (group->generator == NULL) return 0;
271 if (!EC_POINT_copy(group->generator, generator)) return 0;
274 { if (!BN_copy(&group->order, order)) return 0; }
276 { if (!BN_zero(&group->order)) return 0; }
278 if (cofactor != NULL)
279 { if (!BN_copy(&group->cofactor, cofactor)) return 0; }
281 { if (!BN_zero(&group->cofactor)) return 0; }
287 EC_POINT *EC_GROUP_get0_generator(const EC_GROUP *group)
289 return group->generator;
293 int EC_GROUP_get_order(const EC_GROUP *group, BIGNUM *order, BN_CTX *ctx)
295 if (!BN_copy(order, &group->order))
298 return !BN_is_zero(order);
302 int EC_GROUP_get_cofactor(const EC_GROUP *group, BIGNUM *cofactor, BN_CTX *ctx)
304 if (!BN_copy(cofactor, &group->cofactor))
307 return !BN_is_zero(&group->cofactor);
311 void EC_GROUP_set_nid(EC_GROUP *group, int nid)
313 group->curve_name = nid;
317 int EC_GROUP_get_nid(const EC_GROUP *group)
319 return group->curve_name;
323 void EC_GROUP_set_asn1_flag(EC_GROUP *group, int flag)
325 group->asn1_flag = flag;
329 int EC_GROUP_get_asn1_flag(const EC_GROUP *group)
331 return group->asn1_flag;
335 void EC_GROUP_set_point_conversion_form(EC_GROUP *group,
336 point_conversion_form_t form)
338 group->asn1_form = form;
342 point_conversion_form_t EC_GROUP_get_point_conversion_form(const EC_GROUP *group)
344 return group->asn1_form;
348 size_t EC_GROUP_set_seed(EC_GROUP *group, const unsigned char *p, size_t len)
352 OPENSSL_free(group->seed);
360 if ((group->seed = OPENSSL_malloc(len)) == NULL)
362 memcpy(group->seed, p, len);
363 group->seed_len = len;
369 unsigned char *EC_GROUP_get0_seed(const EC_GROUP *group)
375 size_t EC_GROUP_get_seed_len(const EC_GROUP *group)
377 return group->seed_len;
381 int EC_GROUP_set_curve_GFp(EC_GROUP *group, const BIGNUM *p, const BIGNUM *a, const BIGNUM *b, BN_CTX *ctx)
383 if (group->meth->group_set_curve_GFp == 0)
385 ECerr(EC_F_EC_GROUP_SET_CURVE_GFP, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
388 return group->meth->group_set_curve_GFp(group, p, a, b, ctx);
392 int EC_GROUP_get_curve_GFp(const EC_GROUP *group, BIGNUM *p, BIGNUM *a, BIGNUM *b, BN_CTX *ctx)
394 if (group->meth->group_get_curve_GFp == 0)
396 ECerr(EC_F_EC_GROUP_GET_CURVE_GFP, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
399 return group->meth->group_get_curve_GFp(group, p, a, b, ctx);
403 int EC_GROUP_check_discriminant(const EC_GROUP *group, BN_CTX *ctx)
405 if (group->meth->group_check_discriminant == 0)
407 ECerr(EC_F_EC_GROUP_CHECK_DISCRIMINANT, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
410 return group->meth->group_check_discriminant(group, ctx);
414 /* this has 'package' visibility */
415 int EC_GROUP_set_extra_data(EC_GROUP *group, void *extra_data, void *(*extra_data_dup_func)(void *),
416 void (*extra_data_free_func)(void *), void (*extra_data_clear_free_func)(void *))
418 if ((group->extra_data != NULL)
419 || (group->extra_data_dup_func != 0)
420 || (group->extra_data_free_func != 0)
421 || (group->extra_data_clear_free_func != 0))
423 ECerr(EC_F_EC_GROUP_SET_EXTRA_DATA, EC_R_SLOT_FULL);
427 group->extra_data = extra_data;
428 group->extra_data_dup_func = extra_data_dup_func;
429 group->extra_data_free_func = extra_data_free_func;
430 group->extra_data_clear_free_func = extra_data_clear_free_func;
435 /* this has 'package' visibility */
436 void *EC_GROUP_get_extra_data(const EC_GROUP *group, void *(*extra_data_dup_func)(void *),
437 void (*extra_data_free_func)(void *), void (*extra_data_clear_free_func)(void *))
439 if ((group->extra_data_dup_func != extra_data_dup_func)
440 || (group->extra_data_free_func != extra_data_free_func)
441 || (group->extra_data_clear_free_func != extra_data_clear_free_func))
443 ECerr(EC_F_EC_GROUP_GET_EXTRA_DATA, EC_R_NO_SUCH_EXTRA_DATA);
447 return group->extra_data;
451 /* this has 'package' visibility */
452 void EC_GROUP_free_extra_data(EC_GROUP *group)
454 if (group->extra_data_free_func)
455 group->extra_data_free_func(group->extra_data);
456 group->extra_data = NULL;
457 group->extra_data_dup_func = 0;
458 group->extra_data_free_func = 0;
459 group->extra_data_clear_free_func = 0;
463 /* this has 'package' visibility */
464 void EC_GROUP_clear_free_extra_data(EC_GROUP *group)
466 if (group->extra_data_clear_free_func)
467 group->extra_data_clear_free_func(group->extra_data);
468 else if (group->extra_data_free_func)
469 group->extra_data_free_func(group->extra_data);
470 group->extra_data = NULL;
471 group->extra_data_dup_func = 0;
472 group->extra_data_free_func = 0;
473 group->extra_data_clear_free_func = 0;
477 /* functions for EC_POINT objects */
479 EC_POINT *EC_POINT_new(const EC_GROUP *group)
485 ECerr(EC_F_EC_POINT_NEW, ERR_R_PASSED_NULL_PARAMETER);
488 if (group->meth->point_init == 0)
490 ECerr(EC_F_EC_POINT_NEW, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
494 ret = OPENSSL_malloc(sizeof *ret);
497 ECerr(EC_F_EC_POINT_NEW, ERR_R_MALLOC_FAILURE);
501 ret->meth = group->meth;
503 if (!ret->meth->point_init(ret))
513 void EC_POINT_free(EC_POINT *point)
517 if (point->meth->point_finish != 0)
518 point->meth->point_finish(point);
523 void EC_POINT_clear_free(EC_POINT *point)
527 if (point->meth->point_clear_finish != 0)
528 point->meth->point_clear_finish(point);
529 else if (point->meth != NULL && point->meth->point_finish != 0)
530 point->meth->point_finish(point);
531 memset(point, 0, sizeof *point);
536 int EC_POINT_copy(EC_POINT *dest, const EC_POINT *src)
538 if (dest->meth->point_copy == 0)
540 ECerr(EC_F_EC_POINT_COPY, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
543 if (dest->meth != src->meth)
545 ECerr(EC_F_EC_POINT_COPY, EC_R_INCOMPATIBLE_OBJECTS);
550 return dest->meth->point_copy(dest, src);
554 const EC_METHOD *EC_POINT_method_of(const EC_POINT *point)
560 int EC_POINT_set_to_infinity(const EC_GROUP *group, EC_POINT *point)
562 if (group->meth->point_set_to_infinity == 0)
564 ECerr(EC_F_EC_POINT_SET_TO_INFINITY, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
567 if (group->meth != point->meth)
569 ECerr(EC_F_EC_POINT_SET_TO_INFINITY, EC_R_INCOMPATIBLE_OBJECTS);
572 return group->meth->point_set_to_infinity(group, point);
576 int EC_POINT_set_Jprojective_coordinates_GFp(const EC_GROUP *group, EC_POINT *point,
577 const BIGNUM *x, const BIGNUM *y, const BIGNUM *z, BN_CTX *ctx)
579 if (group->meth->point_set_Jprojective_coordinates_GFp == 0)
581 ECerr(EC_F_EC_POINT_SET_JPROJECTIVE_COORDINATES_GFP, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
584 if (group->meth != point->meth)
586 ECerr(EC_F_EC_POINT_SET_JPROJECTIVE_COORDINATES_GFP, EC_R_INCOMPATIBLE_OBJECTS);
589 return group->meth->point_set_Jprojective_coordinates_GFp(group, point, x, y, z, ctx);
593 int EC_POINT_get_Jprojective_coordinates_GFp(const EC_GROUP *group, const EC_POINT *point,
594 BIGNUM *x, BIGNUM *y, BIGNUM *z, BN_CTX *ctx)
596 if (group->meth->point_get_Jprojective_coordinates_GFp == 0)
598 ECerr(EC_F_EC_POINT_GET_JPROJECTIVE_COORDINATES_GFP, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
601 if (group->meth != point->meth)
603 ECerr(EC_F_EC_POINT_GET_JPROJECTIVE_COORDINATES_GFP, EC_R_INCOMPATIBLE_OBJECTS);
606 return group->meth->point_get_Jprojective_coordinates_GFp(group, point, x, y, z, ctx);
610 int EC_POINT_set_affine_coordinates_GFp(const EC_GROUP *group, EC_POINT *point,
611 const BIGNUM *x, const BIGNUM *y, BN_CTX *ctx)
613 if (group->meth->point_set_affine_coordinates_GFp == 0)
615 ECerr(EC_F_EC_POINT_SET_AFFINE_COORDINATES_GFP, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
618 if (group->meth != point->meth)
620 ECerr(EC_F_EC_POINT_SET_AFFINE_COORDINATES_GFP, EC_R_INCOMPATIBLE_OBJECTS);
623 return group->meth->point_set_affine_coordinates_GFp(group, point, x, y, ctx);
627 int EC_POINT_get_affine_coordinates_GFp(const EC_GROUP *group, const EC_POINT *point,
628 BIGNUM *x, BIGNUM *y, BN_CTX *ctx)
630 if (group->meth->point_get_affine_coordinates_GFp == 0)
632 ECerr(EC_F_EC_POINT_GET_AFFINE_COORDINATES_GFP, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
635 if (group->meth != point->meth)
637 ECerr(EC_F_EC_POINT_GET_AFFINE_COORDINATES_GFP, EC_R_INCOMPATIBLE_OBJECTS);
640 return group->meth->point_get_affine_coordinates_GFp(group, point, x, y, ctx);
644 int EC_POINT_set_compressed_coordinates_GFp(const EC_GROUP *group, EC_POINT *point,
645 const BIGNUM *x, int y_bit, BN_CTX *ctx)
647 if (group->meth->point_set_compressed_coordinates_GFp == 0)
649 ECerr(EC_F_EC_POINT_SET_COMPRESSED_COORDINATES_GFP, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
652 if (group->meth != point->meth)
654 ECerr(EC_F_EC_POINT_SET_COMPRESSED_COORDINATES_GFP, EC_R_INCOMPATIBLE_OBJECTS);
657 return group->meth->point_set_compressed_coordinates_GFp(group, point, x, y_bit, ctx);
661 size_t EC_POINT_point2oct(const EC_GROUP *group, const EC_POINT *point, point_conversion_form_t form,
662 unsigned char *buf, size_t len, BN_CTX *ctx)
664 if (group->meth->point2oct == 0)
666 ECerr(EC_F_EC_POINT_POINT2OCT, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
669 if (group->meth != point->meth)
671 ECerr(EC_F_EC_POINT_POINT2OCT, EC_R_INCOMPATIBLE_OBJECTS);
674 return group->meth->point2oct(group, point, form, buf, len, ctx);
678 int EC_POINT_oct2point(const EC_GROUP *group, EC_POINT *point,
679 const unsigned char *buf, size_t len, BN_CTX *ctx)
681 if (group->meth->oct2point == 0)
683 ECerr(EC_F_EC_POINT_OCT2POINT, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
686 if (group->meth != point->meth)
688 ECerr(EC_F_EC_POINT_OCT2POINT, EC_R_INCOMPATIBLE_OBJECTS);
691 return group->meth->oct2point(group, point, buf, len, ctx);
695 int EC_POINT_add(const EC_GROUP *group, EC_POINT *r, const EC_POINT *a, const EC_POINT *b, BN_CTX *ctx)
697 if (group->meth->add == 0)
699 ECerr(EC_F_EC_POINT_ADD, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
702 if ((group->meth != r->meth) || (r->meth != a->meth) || (a->meth != b->meth))
704 ECerr(EC_F_EC_POINT_ADD, EC_R_INCOMPATIBLE_OBJECTS);
707 return group->meth->add(group, r, a, b, ctx);
711 int EC_POINT_dbl(const EC_GROUP *group, EC_POINT *r, const EC_POINT *a, BN_CTX *ctx)
713 if (group->meth->dbl == 0)
715 ECerr(EC_F_EC_POINT_DBL, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
718 if ((group->meth != r->meth) || (r->meth != a->meth))
720 ECerr(EC_F_EC_POINT_DBL, EC_R_INCOMPATIBLE_OBJECTS);
723 return group->meth->dbl(group, r, a, ctx);
727 int EC_POINT_invert(const EC_GROUP *group, EC_POINT *a, BN_CTX *ctx)
729 if (group->meth->dbl == 0)
731 ECerr(EC_F_EC_POINT_DBL, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
734 if (group->meth != a->meth)
736 ECerr(EC_F_EC_POINT_DBL, EC_R_INCOMPATIBLE_OBJECTS);
739 return group->meth->invert(group, a, ctx);
743 int EC_POINT_is_at_infinity(const EC_GROUP *group, const EC_POINT *point)
745 if (group->meth->is_at_infinity == 0)
747 ECerr(EC_F_EC_POINT_IS_AT_INFINITY, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
750 if (group->meth != point->meth)
752 ECerr(EC_F_EC_POINT_IS_AT_INFINITY, EC_R_INCOMPATIBLE_OBJECTS);
755 return group->meth->is_at_infinity(group, point);
759 int EC_POINT_is_on_curve(const EC_GROUP *group, const EC_POINT *point, BN_CTX *ctx)
761 if (group->meth->is_on_curve == 0)
763 ECerr(EC_F_EC_POINT_IS_ON_CURVE, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
766 if (group->meth != point->meth)
768 ECerr(EC_F_EC_POINT_IS_ON_CURVE, EC_R_INCOMPATIBLE_OBJECTS);
771 return group->meth->is_on_curve(group, point, ctx);
775 int EC_POINT_cmp(const EC_GROUP *group, const EC_POINT *a, const EC_POINT *b, BN_CTX *ctx)
777 if (group->meth->point_cmp == 0)
779 ECerr(EC_F_EC_POINT_CMP, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
782 if ((group->meth != a->meth) || (a->meth != b->meth))
784 ECerr(EC_F_EC_POINT_CMP, EC_R_INCOMPATIBLE_OBJECTS);
787 return group->meth->point_cmp(group, a, b, ctx);
791 int EC_POINT_make_affine(const EC_GROUP *group, EC_POINT *point, BN_CTX *ctx)
793 if (group->meth->make_affine == 0)
795 ECerr(EC_F_EC_POINT_MAKE_AFFINE, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
798 if (group->meth != point->meth)
800 ECerr(EC_F_EC_POINT_MAKE_AFFINE, EC_R_INCOMPATIBLE_OBJECTS);
803 return group->meth->make_affine(group, point, ctx);
807 int EC_POINTs_make_affine(const EC_GROUP *group, size_t num, EC_POINT *points[], BN_CTX *ctx)
811 if (group->meth->points_make_affine == 0)
813 ECerr(EC_F_EC_POINTS_MAKE_AFFINE, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
816 for (i = 0; i < num; i++)
818 if (group->meth != points[i]->meth)
820 ECerr(EC_F_EC_POINTS_MAKE_AFFINE, EC_R_INCOMPATIBLE_OBJECTS);
824 return group->meth->points_make_affine(group, num, points, ctx);