1 /* crypto/ec/ec_lib.c */
2 /* ====================================================================
3 * Copyright (c) 1998-2001 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>
63 /* functions for EC_GROUP objects */
65 EC_GROUP *EC_GROUP_new(const EC_METHOD *meth)
71 ECerr(EC_F_EC_GROUP_NEW, ERR_R_PASSED_NULL_PARAMETER);
74 if (meth->group_init == 0)
76 ECerr(EC_F_EC_GROUP_NEW, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
80 ret = OPENSSL_malloc(sizeof *ret);
83 ECerr(EC_F_EC_GROUP_NEW, ERR_R_MALLOC_FAILURE);
89 ret->extra_data = NULL;
90 ret->extra_data_dup_func = 0;
91 ret->extra_data_free_func = 0;
92 ret->extra_data_clear_free_func = 0;
94 if (!meth->group_init(ret))
104 int EC_GROUP_set_curve_GFp(EC_GROUP *group, const BIGNUM *p, const BIGNUM *a, const BIGNUM *b, BN_CTX *ctx)
106 if (group->meth->group_set_curve_GFp == 0)
108 ECerr(EC_F_EC_GROUP_SET_CURVE_GFP, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
112 return group->meth->group_set_curve_GFp(group, p, a, b, ctx);
116 void EC_GROUP_free(EC_GROUP *group)
118 if (group->meth->group_finish != 0)
119 group->meth->group_finish(group);
121 EC_GROUP_free_extra_data(group);
127 void EC_GROUP_clear_free(EC_GROUP *group)
129 if (group->meth->group_clear_finish != 0)
130 group->meth->group_clear_finish(group);
131 else if (group->meth != NULL && group->meth->group_finish != 0)
132 group->meth->group_finish(group);
134 EC_GROUP_clear_free_extra_data(group);
136 memset(group, 0, sizeof *group);
141 int EC_GROUP_copy(EC_GROUP *dest, const EC_GROUP *src)
143 if (dest->meth->group_copy == 0)
145 ECerr(EC_F_EC_GROUP_COPY, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
148 if (dest->meth != src->meth)
150 ECerr(EC_F_EC_GROUP_COPY, EC_R_INCOMPATIBLE_OBJECTS);
154 EC_GROUP_clear_free_extra_data(dest);
155 if (src->extra_data_dup_func)
157 if (src->extra_data != NULL)
159 dest->extra_data = src->extra_data_dup_func(src->extra_data);
160 if (dest->extra_data == NULL)
164 dest->extra_data_dup_func = src->extra_data_dup_func;
165 dest->extra_data_free_func = src->extra_data_free_func;
166 dest->extra_data_clear_free_func = src->extra_data_clear_free_func;
169 return dest->meth->group_copy(dest, src);
173 int EC_GROUP_set_generator(EC_GROUP *group, const EC_POINT *generator, const BIGNUM *order, const BIGNUM *cofactor)
175 if (group->meth->group_set_generator == 0)
177 ECerr(EC_F_EC_GROUP_SET_GENERATOR, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
180 return group->meth->group_set_generator(group, generator, order, cofactor);
184 /* TODO: 'set' and 'get' functions for EC_GROUPs */
187 /* this has 'package' visibility */
188 int EC_GROUP_set_extra_data(EC_GROUP *group, void *extra_data, void *(*extra_data_dup_func)(void *),
189 void (*extra_data_free_func)(void *), void (*extra_data_clear_free_func)(void *))
191 if ((group->extra_data != NULL)
192 || (group->extra_data_dup_func != 0)
193 || (group->extra_data_free_func != 0)
194 || (group->extra_data_clear_free_func != 0))
196 ECerr(EC_F_EC_GROUP_SET_EXTRA_DATA, EC_R_SLOT_FULL);
200 group->extra_data = extra_data;
201 group->extra_data_dup_func = extra_data_dup_func;
202 group->extra_data_free_func = extra_data_free_func;
203 group->extra_data_clear_free_func = extra_data_clear_free_func;
208 /* this has 'package' visibility */
209 void *EC_GROUP_get_extra_data(EC_GROUP *group, void *(*extra_data_dup_func)(void *),
210 void (*extra_data_free_func)(void *), void (*extra_data_clear_free_func)(void *))
212 if ((group->extra_data_dup_func != extra_data_dup_func)
213 || (group->extra_data_free_func != extra_data_free_func)
214 || (group->extra_data_clear_free_func != extra_data_clear_free_func))
216 ECerr(EC_F_EC_GROUP_GET_EXTRA_DATA, EC_R_NO_SUCH_EXTRA_DATA);
220 return group->extra_data;
224 /* this has 'package' visibility */
225 void EC_GROUP_free_extra_data(EC_GROUP *group)
227 if (group->extra_data_free_func)
228 group->extra_data_free_func(group->extra_data);
229 group->extra_data = NULL;
230 group->extra_data_dup_func = 0;
231 group->extra_data_free_func = 0;
232 group->extra_data_clear_free_func = 0;
236 /* this has 'package' visibility */
237 void EC_GROUP_clear_free_extra_data(EC_GROUP *group)
239 if (group->extra_data_clear_free_func)
240 group->extra_data_clear_free_func(group->extra_data);
241 else if (group->extra_data_free_func)
242 group->extra_data_free_func(group->extra_data);
243 group->extra_data = NULL;
244 group->extra_data_dup_func = 0;
245 group->extra_data_free_func = 0;
246 group->extra_data_clear_free_func = 0;
251 /* functions for EC_POINT objects */
253 EC_POINT *EC_POINT_new(const EC_GROUP *group)
259 ECerr(EC_F_EC_POINT_NEW, ERR_R_PASSED_NULL_PARAMETER);
262 if (group->meth->point_init == 0)
264 ECerr(EC_F_EC_POINT_NEW, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
268 ret = OPENSSL_malloc(sizeof *ret);
271 ECerr(EC_F_EC_POINT_NEW, ERR_R_MALLOC_FAILURE);
275 ret->meth = group->meth;
277 if (!ret->meth->point_init(ret))
287 void EC_POINT_free(EC_POINT *point)
289 if (point->meth->point_finish != 0)
290 point->meth->point_finish(point);
295 void EC_POINT_clear_free(EC_POINT *point)
297 if (point->meth->point_clear_finish != 0)
298 point->meth->point_clear_finish(point);
299 else if (point->meth != NULL && point->meth->point_finish != 0)
300 point->meth->point_finish(point);
301 memset(point, 0, sizeof *point);
306 int EC_POINT_copy(EC_POINT *dest, const EC_POINT *src)
308 if (dest->meth->point_copy == 0)
310 ECerr(EC_F_EC_POINT_COPY, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
313 if (dest->meth != src->meth)
315 ECerr(EC_F_EC_POINT_COPY, EC_R_INCOMPATIBLE_OBJECTS);
319 return dest->meth->point_copy(dest, src);
323 /* TODO: 'set' and 'get' functions for EC_POINTs */
326 size_t EC_POINT_point2oct(const EC_GROUP *group, const EC_POINT *point, point_conversion_form_t form,
327 unsigned char *buf, size_t len, BN_CTX *ctx)
329 if (group->meth->point2oct == 0)
331 ECerr(EC_F_EC_POINT_POINT2OCT, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
334 if (group->meth != point->meth)
336 ECerr(EC_F_EC_POINT_POINT2OCT, EC_R_INCOMPATIBLE_OBJECTS);
339 return group->meth->point2oct(group, point, form, buf, len, ctx);
343 int EC_POINT_oct2point(const EC_GROUP *group, EC_POINT *point,
344 const unsigned char *buf, size_t len, BN_CTX *ctx)
346 if (group->meth->oct2point == 0)
348 ECerr(EC_F_EC_POINT_OCT2POINT, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
351 if (group->meth != point->meth)
353 ECerr(EC_F_EC_POINT_OCT2POINT, EC_R_INCOMPATIBLE_OBJECTS);
356 return group->meth->oct2point(group, point, buf, len, ctx);
360 int EC_POINT_add(const EC_GROUP *group, EC_POINT *r, const EC_POINT *a, const EC_POINT *b, BN_CTX *ctx)
362 if (group->meth->add == 0)
364 ECerr(EC_F_EC_POINT_ADD, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
367 if ((group->meth != r->meth) || (r->meth != a->meth) || (a->meth != b->meth))
369 ECerr(EC_F_EC_POINT_ADD, EC_R_INCOMPATIBLE_OBJECTS);
372 return group->meth->add(group, r, a, b, ctx);
376 int EC_POINT_dbl(const EC_GROUP *group, EC_POINT *r, const EC_POINT *a, BN_CTX *ctx)
378 if (group->meth->dbl == 0)
380 ECerr(EC_F_EC_POINT_DBL, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
383 if ((group->meth != r->meth) || (r->meth != a->meth))
385 ECerr(EC_F_EC_POINT_DBL, EC_R_INCOMPATIBLE_OBJECTS);
388 return group->meth->dbl(group, r, a, ctx);
392 int EC_POINT_is_at_infinity(const EC_GROUP *group, const EC_POINT *point)
394 if (group->meth->is_at_infinity == 0)
396 ECerr(EC_F_EC_POINT_IS_AT_INFINITY, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
399 if (group->meth != point->meth)
401 ECerr(EC_F_EC_POINT_IS_AT_INFINITY, EC_R_INCOMPATIBLE_OBJECTS);
404 return group->meth->is_at_infinity(group, point);
408 int EC_POINT_is_on_curve(const EC_GROUP *group, const EC_POINT *point, BN_CTX *ctx)
410 if (group->meth->is_on_curve == 0)
412 ECerr(EC_F_EC_POINT_IS_ON_CURVE, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
415 if (group->meth != point->meth)
417 ECerr(EC_F_EC_POINT_IS_ON_CURVE, EC_R_INCOMPATIBLE_OBJECTS);
420 return group->meth->is_on_curve(group, point, ctx);
424 int EC_POINT_make_affine(const EC_GROUP *group, const EC_POINT *point, BN_CTX *ctx)
426 if (group->meth->make_affine == 0)
428 ECerr(EC_F_EC_POINT_MAKE_AFFINE, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
431 if (group->meth != point->meth)
433 ECerr(EC_F_EC_POINT_MAKE_AFFINE, EC_R_INCOMPATIBLE_OBJECTS);
436 return group->meth->make_affine(group, point, ctx);