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;
101 if (!meth
->group_init(ret
))
111 void EC_GROUP_free(EC_GROUP
*group
)
115 i
= CRYPTO_add(&group
->references
, -1, CRYPTO_LOCK_EC
);
119 if (group
->meth
->group_finish
!= 0)
120 group
->meth
->group_finish(group
);
122 EC_GROUP_free_extra_data(group
);
128 void EC_GROUP_clear_free(EC_GROUP
*group
)
132 i
= CRYPTO_add(&group
->references
, -1, CRYPTO_LOCK_EC
);
136 if (group
->meth
->group_clear_finish
!= 0)
137 group
->meth
->group_clear_finish(group
);
138 else if (group
->meth
!= NULL
&& group
->meth
->group_finish
!= 0)
139 group
->meth
->group_finish(group
);
141 EC_GROUP_clear_free_extra_data(group
);
143 memset(group
, 0, sizeof *group
);
148 int EC_GROUP_copy(EC_GROUP
*dest
, const EC_GROUP
*src
)
150 if (dest
->meth
->group_copy
== 0)
152 ECerr(EC_F_EC_GROUP_COPY
, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED
);
155 if (dest
->meth
!= src
->meth
)
157 ECerr(EC_F_EC_GROUP_COPY
, EC_R_INCOMPATIBLE_OBJECTS
);
163 EC_GROUP_clear_free_extra_data(dest
);
164 if (src
->extra_data_dup_func
)
166 if (src
->extra_data
!= NULL
)
168 dest
->extra_data
= src
->extra_data_dup_func(src
->extra_data
);
169 if (dest
->extra_data
== NULL
)
173 dest
->extra_data_dup_func
= src
->extra_data_dup_func
;
174 dest
->extra_data_free_func
= src
->extra_data_free_func
;
175 dest
->extra_data_clear_free_func
= src
->extra_data_clear_free_func
;
178 return dest
->meth
->group_copy(dest
, src
);
182 const EC_METHOD
*EC_GROUP_method_of(const EC_GROUP
*group
)
188 int EC_GROUP_set_curve_GFp(EC_GROUP
*group
, const BIGNUM
*p
, const BIGNUM
*a
, const BIGNUM
*b
, BN_CTX
*ctx
)
190 if (group
->meth
->group_set_curve_GFp
== 0)
192 ECerr(EC_F_EC_GROUP_SET_CURVE_GFP
, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED
);
195 return group
->meth
->group_set_curve_GFp(group
, p
, a
, b
, ctx
);
199 int EC_GROUP_get_curve_GFp(const EC_GROUP
*group
, BIGNUM
*p
, BIGNUM
*a
, BIGNUM
*b
, BN_CTX
*ctx
)
201 if (group
->meth
->group_get_curve_GFp
== 0)
203 ECerr(EC_F_EC_GROUP_GET_CURVE_GFP
, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED
);
206 return group
->meth
->group_get_curve_GFp(group
, p
, a
, b
, ctx
);
210 int EC_GROUP_set_generator(EC_GROUP
*group
, const EC_POINT
*generator
, const BIGNUM
*order
, const BIGNUM
*cofactor
)
212 if (group
->meth
->group_set_generator
== 0)
214 ECerr(EC_F_EC_GROUP_SET_GENERATOR
, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED
);
217 return group
->meth
->group_set_generator(group
, generator
, order
, cofactor
);
221 EC_POINT
*EC_GROUP_get0_generator(const EC_GROUP
*group
)
223 if (group
->meth
->group_get0_generator
== 0)
225 ECerr(EC_F_EC_GROUP_GET0_GENERATOR
, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED
);
228 return group
->meth
->group_get0_generator(group
);
232 int EC_GROUP_get_order(const EC_GROUP
*group
, BIGNUM
*order
, BN_CTX
*ctx
)
234 if (group
->meth
->group_get_order
== 0)
236 ECerr(EC_F_EC_GROUP_GET_ORDER
, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED
);
239 return group
->meth
->group_get_order(group
, order
, ctx
);
243 int EC_GROUP_get_cofactor(const EC_GROUP
*group
, BIGNUM
*cofactor
, BN_CTX
*ctx
)
245 if (group
->meth
->group_get_cofactor
== 0)
247 ECerr(EC_F_EC_GROUP_GET_COFACTOR
, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED
);
250 return group
->meth
->group_get_cofactor(group
, cofactor
, ctx
);
254 /* this has 'package' visibility */
255 int EC_GROUP_set_extra_data(EC_GROUP
*group
, void *extra_data
, void *(*extra_data_dup_func
)(void *),
256 void (*extra_data_free_func
)(void *), void (*extra_data_clear_free_func
)(void *))
258 if ((group
->extra_data
!= NULL
)
259 || (group
->extra_data_dup_func
!= 0)
260 || (group
->extra_data_free_func
!= 0)
261 || (group
->extra_data_clear_free_func
!= 0))
263 ECerr(EC_F_EC_GROUP_SET_EXTRA_DATA
, EC_R_SLOT_FULL
);
267 group
->extra_data
= extra_data
;
268 group
->extra_data_dup_func
= extra_data_dup_func
;
269 group
->extra_data_free_func
= extra_data_free_func
;
270 group
->extra_data_clear_free_func
= extra_data_clear_free_func
;
275 /* this has 'package' visibility */
276 void *EC_GROUP_get_extra_data(const EC_GROUP
*group
, void *(*extra_data_dup_func
)(void *),
277 void (*extra_data_free_func
)(void *), void (*extra_data_clear_free_func
)(void *))
279 if ((group
->extra_data_dup_func
!= extra_data_dup_func
)
280 || (group
->extra_data_free_func
!= extra_data_free_func
)
281 || (group
->extra_data_clear_free_func
!= extra_data_clear_free_func
))
283 ECerr(EC_F_EC_GROUP_GET_EXTRA_DATA
, EC_R_NO_SUCH_EXTRA_DATA
);
287 return group
->extra_data
;
291 /* this has 'package' visibility */
292 void EC_GROUP_free_extra_data(EC_GROUP
*group
)
294 if (group
->extra_data_free_func
)
295 group
->extra_data_free_func(group
->extra_data
);
296 group
->extra_data
= NULL
;
297 group
->extra_data_dup_func
= 0;
298 group
->extra_data_free_func
= 0;
299 group
->extra_data_clear_free_func
= 0;
303 /* this has 'package' visibility */
304 void EC_GROUP_clear_free_extra_data(EC_GROUP
*group
)
306 if (group
->extra_data_clear_free_func
)
307 group
->extra_data_clear_free_func(group
->extra_data
);
308 else if (group
->extra_data_free_func
)
309 group
->extra_data_free_func(group
->extra_data
);
310 group
->extra_data
= NULL
;
311 group
->extra_data_dup_func
= 0;
312 group
->extra_data_free_func
= 0;
313 group
->extra_data_clear_free_func
= 0;
316 void EC_GROUP_set_nid(EC_GROUP
*group
, int nid
)
321 int EC_GROUP_get_nid(const EC_GROUP
*group
)
328 /* functions for EC_POINT objects */
330 EC_POINT
*EC_POINT_new(const EC_GROUP
*group
)
336 ECerr(EC_F_EC_POINT_NEW
, ERR_R_PASSED_NULL_PARAMETER
);
339 if (group
->meth
->point_init
== 0)
341 ECerr(EC_F_EC_POINT_NEW
, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED
);
345 ret
= OPENSSL_malloc(sizeof *ret
);
348 ECerr(EC_F_EC_POINT_NEW
, ERR_R_MALLOC_FAILURE
);
352 ret
->meth
= group
->meth
;
354 if (!ret
->meth
->point_init(ret
))
364 void EC_POINT_free(EC_POINT
*point
)
366 if (point
->meth
->point_finish
!= 0)
367 point
->meth
->point_finish(point
);
372 void EC_POINT_clear_free(EC_POINT
*point
)
374 if (point
->meth
->point_clear_finish
!= 0)
375 point
->meth
->point_clear_finish(point
);
376 else if (point
->meth
!= NULL
&& point
->meth
->point_finish
!= 0)
377 point
->meth
->point_finish(point
);
378 memset(point
, 0, sizeof *point
);
383 int EC_POINT_copy(EC_POINT
*dest
, const EC_POINT
*src
)
385 if (dest
->meth
->point_copy
== 0)
387 ECerr(EC_F_EC_POINT_COPY
, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED
);
390 if (dest
->meth
!= src
->meth
)
392 ECerr(EC_F_EC_POINT_COPY
, EC_R_INCOMPATIBLE_OBJECTS
);
397 return dest
->meth
->point_copy(dest
, src
);
401 const EC_METHOD
*EC_POINT_method_of(const EC_POINT
*point
)
407 int EC_POINT_set_to_infinity(const EC_GROUP
*group
, EC_POINT
*point
)
409 if (group
->meth
->point_set_to_infinity
== 0)
411 ECerr(EC_F_EC_POINT_SET_TO_INFINITY
, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED
);
414 if (group
->meth
!= point
->meth
)
416 ECerr(EC_F_EC_POINT_SET_TO_INFINITY
, EC_R_INCOMPATIBLE_OBJECTS
);
419 return group
->meth
->point_set_to_infinity(group
, point
);
423 int EC_POINT_set_Jprojective_coordinates_GFp(const EC_GROUP
*group
, EC_POINT
*point
,
424 const BIGNUM
*x
, const BIGNUM
*y
, const BIGNUM
*z
, BN_CTX
*ctx
)
426 if (group
->meth
->point_set_Jprojective_coordinates_GFp
== 0)
428 ECerr(EC_F_EC_POINT_SET_JPROJECTIVE_COORDINATES_GFP
, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED
);
431 if (group
->meth
!= point
->meth
)
433 ECerr(EC_F_EC_POINT_SET_JPROJECTIVE_COORDINATES_GFP
, EC_R_INCOMPATIBLE_OBJECTS
);
436 return group
->meth
->point_set_Jprojective_coordinates_GFp(group
, point
, x
, y
, z
, ctx
);
440 int EC_POINT_get_Jprojective_coordinates_GFp(const EC_GROUP
*group
, const EC_POINT
*point
,
441 BIGNUM
*x
, BIGNUM
*y
, BIGNUM
*z
, BN_CTX
*ctx
)
443 if (group
->meth
->point_get_Jprojective_coordinates_GFp
== 0)
445 ECerr(EC_F_EC_POINT_GET_JPROJECTIVE_COORDINATES_GFP
, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED
);
448 if (group
->meth
!= point
->meth
)
450 ECerr(EC_F_EC_POINT_GET_JPROJECTIVE_COORDINATES_GFP
, EC_R_INCOMPATIBLE_OBJECTS
);
453 return group
->meth
->point_get_Jprojective_coordinates_GFp(group
, point
, x
, y
, z
, ctx
);
457 int EC_POINT_set_affine_coordinates_GFp(const EC_GROUP
*group
, EC_POINT
*point
,
458 const BIGNUM
*x
, const BIGNUM
*y
, BN_CTX
*ctx
)
460 if (group
->meth
->point_set_affine_coordinates_GFp
== 0)
462 ECerr(EC_F_EC_POINT_SET_AFFINE_COORDINATES_GFP
, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED
);
465 if (group
->meth
!= point
->meth
)
467 ECerr(EC_F_EC_POINT_SET_AFFINE_COORDINATES_GFP
, EC_R_INCOMPATIBLE_OBJECTS
);
470 return group
->meth
->point_set_affine_coordinates_GFp(group
, point
, x
, y
, ctx
);
474 int EC_POINT_get_affine_coordinates_GFp(const EC_GROUP
*group
, const EC_POINT
*point
,
475 BIGNUM
*x
, BIGNUM
*y
, BN_CTX
*ctx
)
477 if (group
->meth
->point_get_affine_coordinates_GFp
== 0)
479 ECerr(EC_F_EC_POINT_GET_AFFINE_COORDINATES_GFP
, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED
);
482 if (group
->meth
!= point
->meth
)
484 ECerr(EC_F_EC_POINT_GET_AFFINE_COORDINATES_GFP
, EC_R_INCOMPATIBLE_OBJECTS
);
487 return group
->meth
->point_get_affine_coordinates_GFp(group
, point
, x
, y
, ctx
);
491 int EC_POINT_set_compressed_coordinates_GFp(const EC_GROUP
*group
, EC_POINT
*point
,
492 const BIGNUM
*x
, int y_bit
, BN_CTX
*ctx
)
494 if (group
->meth
->point_set_compressed_coordinates_GFp
== 0)
496 ECerr(EC_F_EC_POINT_SET_COMPRESSED_COORDINATES_GFP
, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED
);
499 if (group
->meth
!= point
->meth
)
501 ECerr(EC_F_EC_POINT_SET_COMPRESSED_COORDINATES_GFP
, EC_R_INCOMPATIBLE_OBJECTS
);
504 return group
->meth
->point_set_compressed_coordinates_GFp(group
, point
, x
, y_bit
, ctx
);
508 size_t EC_POINT_point2oct(const EC_GROUP
*group
, const EC_POINT
*point
, point_conversion_form_t form
,
509 unsigned char *buf
, size_t len
, BN_CTX
*ctx
)
511 if (group
->meth
->point2oct
== 0)
513 ECerr(EC_F_EC_POINT_POINT2OCT
, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED
);
516 if (group
->meth
!= point
->meth
)
518 ECerr(EC_F_EC_POINT_POINT2OCT
, EC_R_INCOMPATIBLE_OBJECTS
);
521 return group
->meth
->point2oct(group
, point
, form
, buf
, len
, ctx
);
525 int EC_POINT_oct2point(const EC_GROUP
*group
, EC_POINT
*point
,
526 const unsigned char *buf
, size_t len
, BN_CTX
*ctx
)
528 if (group
->meth
->oct2point
== 0)
530 ECerr(EC_F_EC_POINT_OCT2POINT
, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED
);
533 if (group
->meth
!= point
->meth
)
535 ECerr(EC_F_EC_POINT_OCT2POINT
, EC_R_INCOMPATIBLE_OBJECTS
);
538 return group
->meth
->oct2point(group
, point
, buf
, len
, ctx
);
542 int EC_POINT_add(const EC_GROUP
*group
, EC_POINT
*r
, const EC_POINT
*a
, const EC_POINT
*b
, BN_CTX
*ctx
)
544 if (group
->meth
->add
== 0)
546 ECerr(EC_F_EC_POINT_ADD
, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED
);
549 if ((group
->meth
!= r
->meth
) || (r
->meth
!= a
->meth
) || (a
->meth
!= b
->meth
))
551 ECerr(EC_F_EC_POINT_ADD
, EC_R_INCOMPATIBLE_OBJECTS
);
554 return group
->meth
->add(group
, r
, a
, b
, ctx
);
558 int EC_POINT_dbl(const EC_GROUP
*group
, EC_POINT
*r
, const EC_POINT
*a
, BN_CTX
*ctx
)
560 if (group
->meth
->dbl
== 0)
562 ECerr(EC_F_EC_POINT_DBL
, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED
);
565 if ((group
->meth
!= r
->meth
) || (r
->meth
!= a
->meth
))
567 ECerr(EC_F_EC_POINT_DBL
, EC_R_INCOMPATIBLE_OBJECTS
);
570 return group
->meth
->dbl(group
, r
, a
, ctx
);
574 int EC_POINT_invert(const EC_GROUP
*group
, EC_POINT
*a
, BN_CTX
*ctx
)
576 if (group
->meth
->dbl
== 0)
578 ECerr(EC_F_EC_POINT_DBL
, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED
);
581 if (group
->meth
!= a
->meth
)
583 ECerr(EC_F_EC_POINT_DBL
, EC_R_INCOMPATIBLE_OBJECTS
);
586 return group
->meth
->invert(group
, a
, ctx
);
590 int EC_POINT_is_at_infinity(const EC_GROUP
*group
, const EC_POINT
*point
)
592 if (group
->meth
->is_at_infinity
== 0)
594 ECerr(EC_F_EC_POINT_IS_AT_INFINITY
, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED
);
597 if (group
->meth
!= point
->meth
)
599 ECerr(EC_F_EC_POINT_IS_AT_INFINITY
, EC_R_INCOMPATIBLE_OBJECTS
);
602 return group
->meth
->is_at_infinity(group
, point
);
606 int EC_POINT_is_on_curve(const EC_GROUP
*group
, const EC_POINT
*point
, BN_CTX
*ctx
)
608 if (group
->meth
->is_on_curve
== 0)
610 ECerr(EC_F_EC_POINT_IS_ON_CURVE
, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED
);
613 if (group
->meth
!= point
->meth
)
615 ECerr(EC_F_EC_POINT_IS_ON_CURVE
, EC_R_INCOMPATIBLE_OBJECTS
);
618 return group
->meth
->is_on_curve(group
, point
, ctx
);
622 int EC_POINT_cmp(const EC_GROUP
*group
, const EC_POINT
*a
, const EC_POINT
*b
, BN_CTX
*ctx
)
624 if (group
->meth
->point_cmp
== 0)
626 ECerr(EC_F_EC_POINT_CMP
, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED
);
629 if ((group
->meth
!= a
->meth
) || (a
->meth
!= b
->meth
))
631 ECerr(EC_F_EC_POINT_CMP
, EC_R_INCOMPATIBLE_OBJECTS
);
634 return group
->meth
->point_cmp(group
, a
, b
, ctx
);
638 int EC_POINT_make_affine(const EC_GROUP
*group
, EC_POINT
*point
, BN_CTX
*ctx
)
640 if (group
->meth
->make_affine
== 0)
642 ECerr(EC_F_EC_POINT_MAKE_AFFINE
, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED
);
645 if (group
->meth
!= point
->meth
)
647 ECerr(EC_F_EC_POINT_MAKE_AFFINE
, EC_R_INCOMPATIBLE_OBJECTS
);
650 return group
->meth
->make_affine(group
, point
, ctx
);
654 int EC_POINTs_make_affine(const EC_GROUP
*group
, size_t num
, EC_POINT
*points
[], BN_CTX
*ctx
)
658 if (group
->meth
->points_make_affine
== 0)
660 ECerr(EC_F_EC_POINTS_MAKE_AFFINE
, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED
);
663 for (i
= 0; i
< num
; i
++)
665 if (group
->meth
!= points
[i
]->meth
)
667 ECerr(EC_F_EC_POINTS_MAKE_AFFINE
, EC_R_INCOMPATIBLE_OBJECTS
);
671 return group
->meth
->points_make_affine(group
, num
, points
, ctx
);