1/* crypto/ec/ec.h */
2/*
3 * Originally written by Bodo Moeller for the OpenSSL project.
4 */
5/**
6 * \file crypto/ec/ec.h Include file for the OpenSSL EC functions
7 * \author Originally written by Bodo Moeller for the OpenSSL project
8 */
9/* ====================================================================
10 * Copyright (c) 1998-2005 The OpenSSL Project. All rights reserved.
11 *
12 * Redistribution and use in source and binary forms, with or without
13 * modification, are permitted provided that the following conditions
14 * are met:
15 *
16 * 1. Redistributions of source code must retain the above copyright
17 * notice, this list of conditions and the following disclaimer.
18 *
19 * 2. Redistributions in binary form must reproduce the above copyright
20 * notice, this list of conditions and the following disclaimer in
21 * the documentation and/or other materials provided with the
22 * distribution.
23 *
24 * 3. All advertising materials mentioning features or use of this
25 * software must display the following acknowledgment:
26 * "This product includes software developed by the OpenSSL Project
27 * for use in the OpenSSL Toolkit. (http://www.openssl.org/)"
28 *
29 * 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
30 * endorse or promote products derived from this software without
31 * prior written permission. For written permission, please contact
32 * openssl-core@openssl.org.
33 *
34 * 5. Products derived from this software may not be called "OpenSSL"
35 * nor may "OpenSSL" appear in their names without prior written
36 * permission of the OpenSSL Project.
37 *
38 * 6. Redistributions of any form whatsoever must retain the following
39 * acknowledgment:
40 * "This product includes software developed by the OpenSSL Project
41 * for use in the OpenSSL Toolkit (http://www.openssl.org/)"
42 *
43 * THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY
44 * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
45 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
46 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR
47 * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
48 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
49 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
50 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
51 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
52 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
53 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
54 * OF THE POSSIBILITY OF SUCH DAMAGE.
55 * ====================================================================
56 *
57 * This product includes cryptographic software written by Eric Young
58 * (eay@cryptsoft.com). This product includes software written by Tim
59 * Hudson (tjh@cryptsoft.com).
60 *
61 */
62/* ====================================================================
63 * Copyright 2002 Sun Microsystems, Inc. ALL RIGHTS RESERVED.
64 *
65 * Portions of the attached software ("Contribution") are developed by
66 * SUN MICROSYSTEMS, INC., and are contributed to the OpenSSL project.
67 *
68 * The Contribution is licensed pursuant to the OpenSSL open source
69 * license provided above.
70 *
71 * The elliptic curve binary polynomial software is originally written by
72 * Sheueling Chang Shantz and Douglas Stebila of Sun Microsystems Laboratories.
73 *
74 */
75
76#ifndef HEADER_EC_H
77#define HEADER_EC_H
78
79#include <openssl/opensslconf.h>
80
81#ifdef OPENSSL_NO_EC
82#error EC is disabled.
83#endif
84
85#include <openssl/asn1.h>
86#include <openssl/symhacks.h>
87#ifndef OPENSSL_NO_DEPRECATED
88#include <openssl/bn.h>
89#endif
90
91#ifdef __cplusplus
92extern "C" {
93#elif defined(__SUNPRO_C)
94# if __SUNPRO_C >= 0x520
95# pragma error_messages (off,E_ARRAY_OF_INCOMPLETE_NONAME,E_ARRAY_OF_INCOMPLETE)
96# endif
97#endif
98
99
100#ifndef OPENSSL_ECC_MAX_FIELD_BITS
101# define OPENSSL_ECC_MAX_FIELD_BITS 661
102#endif
103
104/** Enum for the point conversion form as defined in X9.62 (ECDSA)
105 * for the encoding of a elliptic curve point (x,y) */
106typedef enum {
107 /** the point is encoded as z||x, where the octet z specifies
108 * which solution of the quadratic equation y is */
109 POINT_CONVERSION_COMPRESSED = 2,
110 /** the point is encoded as z||x||y, where z is the octet 0x02 */
111 POINT_CONVERSION_UNCOMPRESSED = 4,
112 /** the point is encoded as z||x||y, where the octet z specifies
113 * which solution of the quadratic equation y is */
114 POINT_CONVERSION_HYBRID = 6
115} point_conversion_form_t;
116
117
118typedef struct ec_method_st EC_METHOD;
119
120typedef struct ec_group_st
121 /*
122 EC_METHOD *meth;
123 -- field definition
124 -- curve coefficients
125 -- optional generator with associated information (order, cofactor)
126 -- optional extra data (precomputed table for fast computation of multiples of generator)
127 -- ASN1 stuff
128 */
129 EC_GROUP;
130
131typedef struct ec_point_st EC_POINT;
132
133
134/********************************************************************/
135/* EC_METHODs for curves over GF(p) */
136/********************************************************************/
137
138/** Returns the basic GFp ec methods which provides the basis for the
139 * optimized methods.
140 * \return EC_METHOD object
141 */
142const EC_METHOD *EC_GFp_simple_method(void);
143
144/** Returns GFp methods using montgomery multiplication.
145 * \return EC_METHOD object
146 */
147const EC_METHOD *EC_GFp_mont_method(void);
148
149/** Returns GFp methods using optimized methods for NIST recommended curves
150 * \return EC_METHOD object
151 */
152const EC_METHOD *EC_GFp_nist_method(void);
153
154#ifndef OPENSSL_NO_EC_NISTP_64_GCC_128
155/** Returns 64-bit optimized methods for nistp224
156 * \return EC_METHOD object
157 */
158const EC_METHOD *EC_GFp_nistp224_method(void);
159
160/** Returns 64-bit optimized methods for nistp256
161 * \return EC_METHOD object
162 */
163const EC_METHOD *EC_GFp_nistp256_method(void);
164
165/** Returns 64-bit optimized methods for nistp521
166 * \return EC_METHOD object
167 */
168const EC_METHOD *EC_GFp_nistp521_method(void);
169#endif
170
171#ifndef OPENSSL_NO_EC2M
172/********************************************************************/
173/* EC_METHOD for curves over GF(2^m) */
174/********************************************************************/
175
176/** Returns the basic GF2m ec method
177 * \return EC_METHOD object
178 */
179const EC_METHOD *EC_GF2m_simple_method(void);
180
181#endif
182
183
184/********************************************************************/
185/* EC_GROUP functions */
186/********************************************************************/
187
188/** Creates a new EC_GROUP object
189 * \param meth EC_METHOD to use
190 * \return newly created EC_GROUP object or NULL in case of an error.
191 */
192EC_GROUP *EC_GROUP_new(const EC_METHOD *meth);
193
194/** Frees a EC_GROUP object
195 * \param group EC_GROUP object to be freed.
196 */
197void EC_GROUP_free(EC_GROUP *group);
198
199/** Clears and frees a EC_GROUP object
200 * \param group EC_GROUP object to be cleared and freed.
201 */
202void EC_GROUP_clear_free(EC_GROUP *group);
203
204/** Copies EC_GROUP objects. Note: both EC_GROUPs must use the same EC_METHOD.
205 * \param dst destination EC_GROUP object
206 * \param src source EC_GROUP object
207 * \return 1 on success and 0 if an error occurred.
208 */
209int EC_GROUP_copy(EC_GROUP *dst, const EC_GROUP *src);
210
211/** Creates a new EC_GROUP object and copies the copies the content
212 * form src to the newly created EC_KEY object
213 * \param src source EC_GROUP object
214 * \return newly created EC_GROUP object or NULL in case of an error.
215 */
216EC_GROUP *EC_GROUP_dup(const EC_GROUP *src);
217
218/** Returns the EC_METHOD of the EC_GROUP object.
219 * \param group EC_GROUP object
220 * \return EC_METHOD used in this EC_GROUP object.
221 */
222const EC_METHOD *EC_GROUP_method_of(const EC_GROUP *group);
223
224/** Returns the field type of the EC_METHOD.
225 * \param meth EC_METHOD object
226 * \return NID of the underlying field type OID.
227 */
228int EC_METHOD_get_field_type(const EC_METHOD *meth);
229
230/** Sets the generator and it's order/cofactor of a EC_GROUP object.
231 * \param group EC_GROUP object
232 * \param generator EC_POINT object with the generator.
233 * \param order the order of the group generated by the generator.
234 * \param cofactor the index of the sub-group generated by the generator
235 * in the group of all points on the elliptic curve.
236 * \return 1 on success and 0 if an error occured
237 */
238int EC_GROUP_set_generator(EC_GROUP *group, const EC_POINT *generator, const BIGNUM *order, const BIGNUM *cofactor);
239
240/** Returns the generator of a EC_GROUP object.
241 * \param group EC_GROUP object
242 * \return the currently used generator (possibly NULL).
243 */
244const EC_POINT *EC_GROUP_get0_generator(const EC_GROUP *group);
245
246/** Returns the montgomery data for order(Generator)
247 * \param group EC_GROUP object
248 * \return the currently used generator (possibly NULL).
249*/
250BN_MONT_CTX *EC_GROUP_get_mont_data(const EC_GROUP *group);
251
252/** Gets the order of a EC_GROUP
253 * \param group EC_GROUP object
254 * \param order BIGNUM to which the order is copied
255 * \param ctx BN_CTX object (optional)
256 * \return 1 on success and 0 if an error occured
257 */
258int EC_GROUP_get_order(const EC_GROUP *group, BIGNUM *order, BN_CTX *ctx);
259
260/** Gets the cofactor of a EC_GROUP
261 * \param group EC_GROUP object
262 * \param cofactor BIGNUM to which the cofactor is copied
263 * \param ctx BN_CTX object (optional)
264 * \return 1 on success and 0 if an error occured
265 */
266int EC_GROUP_get_cofactor(const EC_GROUP *group, BIGNUM *cofactor, BN_CTX *ctx);
267
268/** Sets the name of a EC_GROUP object
269 * \param group EC_GROUP object
270 * \param nid NID of the curve name OID
271 */
272void EC_GROUP_set_curve_name(EC_GROUP *group, int nid);
273
274/** Returns the curve name of a EC_GROUP object
275 * \param group EC_GROUP object
276 * \return NID of the curve name OID or 0 if not set.
277 */
278int EC_GROUP_get_curve_name(const EC_GROUP *group);
279
280void EC_GROUP_set_asn1_flag(EC_GROUP *group, int flag);
281int EC_GROUP_get_asn1_flag(const EC_GROUP *group);
282
283void EC_GROUP_set_point_conversion_form(EC_GROUP *group, point_conversion_form_t form);
284point_conversion_form_t EC_GROUP_get_point_conversion_form(const EC_GROUP *);
285
286unsigned char *EC_GROUP_get0_seed(const EC_GROUP *x);
287size_t EC_GROUP_get_seed_len(const EC_GROUP *);
288size_t EC_GROUP_set_seed(EC_GROUP *, const unsigned char *, size_t len);
289
290/** Sets the parameter of a ec over GFp defined by y^2 = x^3 + a*x + b
291 * \param group EC_GROUP object
292 * \param p BIGNUM with the prime number
293 * \param a BIGNUM with parameter a of the equation
294 * \param b BIGNUM with parameter b of the equation
295 * \param ctx BN_CTX object (optional)
296 * \return 1 on success and 0 if an error occured
297 */
298int EC_GROUP_set_curve_GFp(EC_GROUP *group, const BIGNUM *p, const BIGNUM *a, const BIGNUM *b, BN_CTX *ctx);
299
300/** Gets the parameter of the ec over GFp defined by y^2 = x^3 + a*x + b
301 * \param group EC_GROUP object
302 * \param p BIGNUM for the prime number
303 * \param a BIGNUM for parameter a of the equation
304 * \param b BIGNUM for parameter b of the equation
305 * \param ctx BN_CTX object (optional)
306 * \return 1 on success and 0 if an error occured
307 */
308int EC_GROUP_get_curve_GFp(const EC_GROUP *group, BIGNUM *p, BIGNUM *a, BIGNUM *b, BN_CTX *ctx);
309
310#ifndef OPENSSL_NO_EC2M
311/** Sets the parameter of a ec over GF2m defined by y^2 + x*y = x^3 + a*x^2 + b
312 * \param group EC_GROUP object
313 * \param p BIGNUM with the polynomial defining the underlying field
314 * \param a BIGNUM with parameter a of the equation
315 * \param b BIGNUM with parameter b of the equation
316 * \param ctx BN_CTX object (optional)
317 * \return 1 on success and 0 if an error occured
318 */
319int EC_GROUP_set_curve_GF2m(EC_GROUP *group, const BIGNUM *p, const BIGNUM *a, const BIGNUM *b, BN_CTX *ctx);
320
321/** Gets the parameter of the ec over GF2m defined by y^2 + x*y = x^3 + a*x^2 + b
322 * \param group EC_GROUP object
323 * \param p BIGNUM for the polynomial defining the underlying field
324 * \param a BIGNUM for parameter a of the equation
325 * \param b BIGNUM for parameter b of the equation
326 * \param ctx BN_CTX object (optional)
327 * \return 1 on success and 0 if an error occured
328 */
329int EC_GROUP_get_curve_GF2m(const EC_GROUP *group, BIGNUM *p, BIGNUM *a, BIGNUM *b, BN_CTX *ctx);
330#endif
331/** Returns the number of bits needed to represent a field element
332 * \param group EC_GROUP object
333 * \return number of bits needed to represent a field element
334 */
335int EC_GROUP_get_degree(const EC_GROUP *group);
336
337/** Checks whether the parameter in the EC_GROUP define a valid ec group
338 * \param group EC_GROUP object
339 * \param ctx BN_CTX object (optional)
340 * \return 1 if group is a valid ec group and 0 otherwise
341 */
342int EC_GROUP_check(const EC_GROUP *group, BN_CTX *ctx);
343
344/** Checks whether the discriminant of the elliptic curve is zero or not
345 * \param group EC_GROUP object
346 * \param ctx BN_CTX object (optional)
347 * \return 1 if the discriminant is not zero and 0 otherwise
348 */
349int EC_GROUP_check_discriminant(const EC_GROUP *group, BN_CTX *ctx);
350
351/** Compares two EC_GROUP objects
352 * \param a first EC_GROUP object
353 * \param b second EC_GROUP object
354 * \param ctx BN_CTX object (optional)
355 * \return 0 if both groups are equal and 1 otherwise
356 */
357int EC_GROUP_cmp(const EC_GROUP *a, const EC_GROUP *b, BN_CTX *ctx);
358
359/* EC_GROUP_new_GF*() calls EC_GROUP_new() and EC_GROUP_set_GF*()
360 * after choosing an appropriate EC_METHOD */
361
362/** Creates a new EC_GROUP object with the specified parameters defined
363 * over GFp (defined by the equation y^2 = x^3 + a*x + b)
364 * \param p BIGNUM with the prime number
365 * \param a BIGNUM with the parameter a of the equation
366 * \param b BIGNUM with the parameter b of the equation
367 * \param ctx BN_CTX object (optional)
368 * \return newly created EC_GROUP object with the specified parameters
369 */
370EC_GROUP *EC_GROUP_new_curve_GFp(const BIGNUM *p, const BIGNUM *a, const BIGNUM *b, BN_CTX *ctx);
371#ifndef OPENSSL_NO_EC2M
372/** Creates a new EC_GROUP object with the specified parameters defined
373 * over GF2m (defined by the equation y^2 + x*y = x^3 + a*x^2 + b)
374 * \param p BIGNUM with the polynomial defining the underlying field
375 * \param a BIGNUM with the parameter a of the equation
376 * \param b BIGNUM with the parameter b of the equation
377 * \param ctx BN_CTX object (optional)
378 * \return newly created EC_GROUP object with the specified parameters
379 */
380EC_GROUP *EC_GROUP_new_curve_GF2m(const BIGNUM *p, const BIGNUM *a, const BIGNUM *b, BN_CTX *ctx);
381#endif
382/** Creates a EC_GROUP object with a curve specified by a NID
383 * \param nid NID of the OID of the curve name
384 * \return newly created EC_GROUP object with specified curve or NULL
385 * if an error occurred
386 */
387EC_GROUP *EC_GROUP_new_by_curve_name(int nid);
388
389
390/********************************************************************/
391/* handling of internal curves */
392/********************************************************************/
393
394typedef struct {
395 int nid;
396 const char *comment;
397 } EC_builtin_curve;
398
399/* EC_builtin_curves(EC_builtin_curve *r, size_t size) returns number
400 * of all available curves or zero if a error occurred.
401 * In case r ist not zero nitems EC_builtin_curve structures
402 * are filled with the data of the first nitems internal groups */
403size_t EC_get_builtin_curves(EC_builtin_curve *r, size_t nitems);
404
405
406/********************************************************************/
407/* EC_POINT functions */
408/********************************************************************/
409
410/** Creates a new EC_POINT object for the specified EC_GROUP
411 * \param group EC_GROUP the underlying EC_GROUP object
412 * \return newly created EC_POINT object or NULL if an error occurred
413 */
414EC_POINT *EC_POINT_new(const EC_GROUP *group);
415
416/** Frees a EC_POINT object
417 * \param point EC_POINT object to be freed
418 */
419void EC_POINT_free(EC_POINT *point);
420
421/** Clears and frees a EC_POINT object
422 * \param point EC_POINT object to be cleared and freed
423 */
424void EC_POINT_clear_free(EC_POINT *point);
425
426/** Copies EC_POINT object
427 * \param dst destination EC_POINT object
428 * \param src source EC_POINT object
429 * \return 1 on success and 0 if an error occured
430 */
431int EC_POINT_copy(EC_POINT *dst, const EC_POINT *src);
432
433/** Creates a new EC_POINT object and copies the content of the supplied
434 * EC_POINT
435 * \param src source EC_POINT object
436 * \param group underlying the EC_GROUP object
437 * \return newly created EC_POINT object or NULL if an error occurred
438 */
439EC_POINT *EC_POINT_dup(const EC_POINT *src, const EC_GROUP *group);
440
441/** Returns the EC_METHOD used in EC_POINT object
442 * \param point EC_POINT object
443 * \return the EC_METHOD used
444 */
445const EC_METHOD *EC_POINT_method_of(const EC_POINT *point);
446
447/** Sets a point to infinity (neutral element)
448 * \param group underlying EC_GROUP object
449 * \param point EC_POINT to set to infinity
450 * \return 1 on success and 0 if an error occured
451 */
452int EC_POINT_set_to_infinity(const EC_GROUP *group, EC_POINT *point);
453
454/** Sets the jacobian projective coordinates of a EC_POINT over GFp
455 * \param group underlying EC_GROUP object
456 * \param p EC_POINT object
457 * \param x BIGNUM with the x-coordinate
458 * \param y BIGNUM with the y-coordinate
459 * \param z BIGNUM with the z-coordinate
460 * \param ctx BN_CTX object (optional)
461 * \return 1 on success and 0 if an error occured
462 */
463int EC_POINT_set_Jprojective_coordinates_GFp(const EC_GROUP *group, EC_POINT *p,
464 const BIGNUM *x, const BIGNUM *y, const BIGNUM *z, BN_CTX *ctx);
465
466/** Gets the jacobian projective coordinates of a EC_POINT over GFp
467 * \param group underlying EC_GROUP object
468 * \param p EC_POINT object
469 * \param x BIGNUM for the x-coordinate
470 * \param y BIGNUM for the y-coordinate
471 * \param z BIGNUM for the z-coordinate
472 * \param ctx BN_CTX object (optional)
473 * \return 1 on success and 0 if an error occured
474 */
475int EC_POINT_get_Jprojective_coordinates_GFp(const EC_GROUP *group,
476 const EC_POINT *p, BIGNUM *x, BIGNUM *y, BIGNUM *z, BN_CTX *ctx);
477
478/** Sets the affine coordinates of a EC_POINT over GFp
479 * \param group underlying EC_GROUP object
480 * \param p EC_POINT object
481 * \param x BIGNUM with the x-coordinate
482 * \param y BIGNUM with the y-coordinate
483 * \param ctx BN_CTX object (optional)
484 * \return 1 on success and 0 if an error occured
485 */
486int EC_POINT_set_affine_coordinates_GFp(const EC_GROUP *group, EC_POINT *p,
487 const BIGNUM *x, const BIGNUM *y, BN_CTX *ctx);
488
489/** Gets the affine coordinates of a EC_POINT over GFp
490 * \param group underlying EC_GROUP object
491 * \param p EC_POINT object
492 * \param x BIGNUM for the x-coordinate
493 * \param y BIGNUM for the y-coordinate
494 * \param ctx BN_CTX object (optional)
495 * \return 1 on success and 0 if an error occured
496 */
497int EC_POINT_get_affine_coordinates_GFp(const EC_GROUP *group,
498 const EC_POINT *p, BIGNUM *x, BIGNUM *y, BN_CTX *ctx);
499
500/** Sets the x9.62 compressed coordinates of a EC_POINT over GFp
501 * \param group underlying EC_GROUP object
502 * \param p EC_POINT object
503 * \param x BIGNUM with x-coordinate
504 * \param y_bit integer with the y-Bit (either 0 or 1)
505 * \param ctx BN_CTX object (optional)
506 * \return 1 on success and 0 if an error occured
507 */
508int EC_POINT_set_compressed_coordinates_GFp(const EC_GROUP *group, EC_POINT *p,
509 const BIGNUM *x, int y_bit, BN_CTX *ctx);
510#ifndef OPENSSL_NO_EC2M
511/** Sets the affine coordinates of a EC_POINT over GF2m
512 * \param group underlying EC_GROUP object
513 * \param p EC_POINT object
514 * \param x BIGNUM with the x-coordinate
515 * \param y BIGNUM with the y-coordinate
516 * \param ctx BN_CTX object (optional)
517 * \return 1 on success and 0 if an error occured
518 */
519int EC_POINT_set_affine_coordinates_GF2m(const EC_GROUP *group, EC_POINT *p,
520 const BIGNUM *x, const BIGNUM *y, BN_CTX *ctx);
521
522/** Gets the affine coordinates of a EC_POINT over GF2m
523 * \param group underlying EC_GROUP object
524 * \param p EC_POINT object
525 * \param x BIGNUM for the x-coordinate
526 * \param y BIGNUM for the y-coordinate
527 * \param ctx BN_CTX object (optional)
528 * \return 1 on success and 0 if an error occured
529 */
530int EC_POINT_get_affine_coordinates_GF2m(const EC_GROUP *group,
531 const EC_POINT *p, BIGNUM *x, BIGNUM *y, BN_CTX *ctx);
532
533/** Sets the x9.62 compressed coordinates of a EC_POINT over GF2m
534 * \param group underlying EC_GROUP object
535 * \param p EC_POINT object
536 * \param x BIGNUM with x-coordinate
537 * \param y_bit integer with the y-Bit (either 0 or 1)
538 * \param ctx BN_CTX object (optional)
539 * \return 1 on success and 0 if an error occured
540 */
541int EC_POINT_set_compressed_coordinates_GF2m(const EC_GROUP *group, EC_POINT *p,
542 const BIGNUM *x, int y_bit, BN_CTX *ctx);
543#endif
544/** Encodes a EC_POINT object to a octet string
545 * \param group underlying EC_GROUP object
546 * \param p EC_POINT object
547 * \param form point conversion form
548 * \param buf memory buffer for the result. If NULL the function returns
549 * required buffer size.
550 * \param len length of the memory buffer
551 * \param ctx BN_CTX object (optional)
552 * \return the length of the encoded octet string or 0 if an error occurred
553 */
554size_t EC_POINT_point2oct(const EC_GROUP *group, const EC_POINT *p,
555 point_conversion_form_t form,
556 unsigned char *buf, size_t len, BN_CTX *ctx);
557
558/** Decodes a EC_POINT from a octet string
559 * \param group underlying EC_GROUP object
560 * \param p EC_POINT object
561 * \param buf memory buffer with the encoded ec point
562 * \param len length of the encoded ec point
563 * \param ctx BN_CTX object (optional)
564 * \return 1 on success and 0 if an error occured
565 */
566int EC_POINT_oct2point(const EC_GROUP *group, EC_POINT *p,
567 const unsigned char *buf, size_t len, BN_CTX *ctx);
568
569/* other interfaces to point2oct/oct2point: */
570BIGNUM *EC_POINT_point2bn(const EC_GROUP *, const EC_POINT *,
571 point_conversion_form_t form, BIGNUM *, BN_CTX *);
572EC_POINT *EC_POINT_bn2point(const EC_GROUP *, const BIGNUM *,
573 EC_POINT *, BN_CTX *);
574char *EC_POINT_point2hex(const EC_GROUP *, const EC_POINT *,
575 point_conversion_form_t form, BN_CTX *);
576EC_POINT *EC_POINT_hex2point(const EC_GROUP *, const char *,
577 EC_POINT *, BN_CTX *);
578
579
580/********************************************************************/
581/* functions for doing EC_POINT arithmetic */
582/********************************************************************/
583
584/** Computes the sum of two EC_POINT
585 * \param group underlying EC_GROUP object
586 * \param r EC_POINT object for the result (r = a + b)
587 * \param a EC_POINT object with the first summand
588 * \param b EC_POINT object with the second summand
589 * \param ctx BN_CTX object (optional)
590 * \return 1 on success and 0 if an error occured
591 */
592int EC_POINT_add(const EC_GROUP *group, EC_POINT *r, const EC_POINT *a, const EC_POINT *b, BN_CTX *ctx);
593
594/** Computes the double of a EC_POINT
595 * \param group underlying EC_GROUP object
596 * \param r EC_POINT object for the result (r = 2 * a)
597 * \param a EC_POINT object
598 * \param ctx BN_CTX object (optional)
599 * \return 1 on success and 0 if an error occured
600 */
601int EC_POINT_dbl(const EC_GROUP *group, EC_POINT *r, const EC_POINT *a, BN_CTX *ctx);
602
603/** Computes the inverse of a EC_POINT
604 * \param group underlying EC_GROUP object
605 * \param a EC_POINT object to be inverted (it's used for the result as well)
606 * \param ctx BN_CTX object (optional)
607 * \return 1 on success and 0 if an error occured
608 */
609int EC_POINT_invert(const EC_GROUP *group, EC_POINT *a, BN_CTX *ctx);
610
611/** Checks whether the point is the neutral element of the group
612 * \param group the underlying EC_GROUP object
613 * \param p EC_POINT object
614 * \return 1 if the point is the neutral element and 0 otherwise
615 */
616int EC_POINT_is_at_infinity(const EC_GROUP *group, const EC_POINT *p);
617
618/** Checks whether the point is on the curve
619 * \param group underlying EC_GROUP object
620 * \param point EC_POINT object to check
621 * \param ctx BN_CTX object (optional)
622 * \return 1 if point if on the curve and 0 otherwise
623 */
624int EC_POINT_is_on_curve(const EC_GROUP *group, const EC_POINT *point, BN_CTX *ctx);
625
626/** Compares two EC_POINTs
627 * \param group underlying EC_GROUP object
628 * \param a first EC_POINT object
629 * \param b second EC_POINT object
630 * \param ctx BN_CTX object (optional)
631 * \return 0 if both points are equal and a value != 0 otherwise
632 */
633int EC_POINT_cmp(const EC_GROUP *group, const EC_POINT *a, const EC_POINT *b, BN_CTX *ctx);
634
635int EC_POINT_make_affine(const EC_GROUP *group, EC_POINT *point, BN_CTX *ctx);
636int EC_POINTs_make_affine(const EC_GROUP *group, size_t num, EC_POINT *points[], BN_CTX *ctx);
637
638/** Computes r = generator * n sum_{i=0}^num p[i] * m[i]
639 * \param group underlying EC_GROUP object
640 * \param r EC_POINT object for the result
641 * \param n BIGNUM with the multiplier for the group generator (optional)
642 * \param num number futher summands
643 * \param p array of size num of EC_POINT objects
644 * \param m array of size num of BIGNUM objects
645 * \param ctx BN_CTX object (optional)
646 * \return 1 on success and 0 if an error occured
647 */
648int EC_POINTs_mul(const EC_GROUP *group, EC_POINT *r, const BIGNUM *n, size_t num, const EC_POINT *p[], const BIGNUM *m[], BN_CTX *ctx);
649
650/** Computes r = generator * n + q * m
651 * \param group underlying EC_GROUP object
652 * \param r EC_POINT object for the result
653 * \param n BIGNUM with the multiplier for the group generator (optional)
654 * \param q EC_POINT object with the first factor of the second summand
655 * \param m BIGNUM with the second factor of the second summand
656 * \param ctx BN_CTX object (optional)
657 * \return 1 on success and 0 if an error occured
658 */
659int EC_POINT_mul(const EC_GROUP *group, EC_POINT *r, const BIGNUM *n, const EC_POINT *q, const BIGNUM *m, BN_CTX *ctx);
660
661/** Stores multiples of generator for faster point multiplication
662 * \param group EC_GROUP object
663 * \param ctx BN_CTX object (optional)
664 * \return 1 on success and 0 if an error occured
665 */
666int EC_GROUP_precompute_mult(EC_GROUP *group, BN_CTX *ctx);
667
668/** Reports whether a precomputation has been done
669 * \param group EC_GROUP object
670 * \return 1 if a pre-computation has been done and 0 otherwise
671 */
672int EC_GROUP_have_precompute_mult(const EC_GROUP *group);
673
674
675/********************************************************************/
676/* ASN1 stuff */
677/********************************************************************/
678
679/* EC_GROUP_get_basis_type() returns the NID of the basis type
680 * used to represent the field elements */
681int EC_GROUP_get_basis_type(const EC_GROUP *);
682#ifndef OPENSSL_NO_EC2M
683int EC_GROUP_get_trinomial_basis(const EC_GROUP *, unsigned int *k);
684int EC_GROUP_get_pentanomial_basis(const EC_GROUP *, unsigned int *k1,
685 unsigned int *k2, unsigned int *k3);
686#endif
687
688#define OPENSSL_EC_NAMED_CURVE 0x001
689
690typedef struct ecpk_parameters_st ECPKPARAMETERS;
691
692EC_GROUP *d2i_ECPKParameters(EC_GROUP **, const unsigned char **in, long len);
693int i2d_ECPKParameters(const EC_GROUP *, unsigned char **out);
694
695#define d2i_ECPKParameters_bio(bp,x) ASN1_d2i_bio_of(EC_GROUP,NULL,d2i_ECPKParameters,bp,x)
696#define i2d_ECPKParameters_bio(bp,x) ASN1_i2d_bio_of_const(EC_GROUP,i2d_ECPKParameters,bp,x)
697#define d2i_ECPKParameters_fp(fp,x) (EC_GROUP *)ASN1_d2i_fp(NULL, \
698 (char *(*)())d2i_ECPKParameters,(fp),(unsigned char **)(x))
699#define i2d_ECPKParameters_fp(fp,x) ASN1_i2d_fp(i2d_ECPKParameters,(fp), \
700 (unsigned char *)(x))
701
702#ifndef OPENSSL_NO_BIO
703int ECPKParameters_print(BIO *bp, const EC_GROUP *x, int off);
704#endif
705#ifndef OPENSSL_NO_FP_API
706int ECPKParameters_print_fp(FILE *fp, const EC_GROUP *x, int off);
707#endif
708
709
710/********************************************************************/
711/* EC_KEY functions */
712/********************************************************************/
713
714typedef struct ec_key_st EC_KEY;
715
716/* some values for the encoding_flag */
717#define EC_PKEY_NO_PARAMETERS 0x001
718#define EC_PKEY_NO_PUBKEY 0x002
719
720/* some values for the flags field */
721#define EC_FLAG_NON_FIPS_ALLOW 0x1
722#define EC_FLAG_FIPS_CHECKED 0x2
723
724/** Creates a new EC_KEY object.
725 * \return EC_KEY object or NULL if an error occurred.
726 */
727EC_KEY *EC_KEY_new(void);
728
729int EC_KEY_get_flags(const EC_KEY *key);
730
731void EC_KEY_set_flags(EC_KEY *key, int flags);
732
733void EC_KEY_clear_flags(EC_KEY *key, int flags);
734
735/** Creates a new EC_KEY object using a named curve as underlying
736 * EC_GROUP object.
737 * \param nid NID of the named curve.
738 * \return EC_KEY object or NULL if an error occurred.
739 */
740EC_KEY *EC_KEY_new_by_curve_name(int nid);
741
742/** Frees a EC_KEY object.
743 * \param key EC_KEY object to be freed.
744 */
745void EC_KEY_free(EC_KEY *key);
746
747/** Copies a EC_KEY object.
748 * \param dst destination EC_KEY object
749 * \param src src EC_KEY object
750 * \return dst or NULL if an error occurred.
751 */
752EC_KEY *EC_KEY_copy(EC_KEY *dst, const EC_KEY *src);
753
754/** Creates a new EC_KEY object and copies the content from src to it.
755 * \param src the source EC_KEY object
756 * \return newly created EC_KEY object or NULL if an error occurred.
757 */
758EC_KEY *EC_KEY_dup(const EC_KEY *src);
759
760/** Increases the internal reference count of a EC_KEY object.
761 * \param key EC_KEY object
762 * \return 1 on success and 0 if an error occurred.
763 */
764int EC_KEY_up_ref(EC_KEY *key);
765
766/** Returns the EC_GROUP object of a EC_KEY object
767 * \param key EC_KEY object
768 * \return the EC_GROUP object (possibly NULL).
769 */
770const EC_GROUP *EC_KEY_get0_group(const EC_KEY *key);
771
772/** Sets the EC_GROUP of a EC_KEY object.
773 * \param key EC_KEY object
774 * \param group EC_GROUP to use in the EC_KEY object (note: the EC_KEY
775 * object will use an own copy of the EC_GROUP).
776 * \return 1 on success and 0 if an error occurred.
777 */
778int EC_KEY_set_group(EC_KEY *key, const EC_GROUP *group);
779
780/** Returns the private key of a EC_KEY object.
781 * \param key EC_KEY object
782 * \return a BIGNUM with the private key (possibly NULL).
783 */
784const BIGNUM *EC_KEY_get0_private_key(const EC_KEY *key);
785
786/** Sets the private key of a EC_KEY object.
787 * \param key EC_KEY object
788 * \param prv BIGNUM with the private key (note: the EC_KEY object
789 * will use an own copy of the BIGNUM).
790 * \return 1 on success and 0 if an error occurred.
791 */
792int EC_KEY_set_private_key(EC_KEY *key, const BIGNUM *prv);
793
794/** Returns the public key of a EC_KEY object.
795 * \param key the EC_KEY object
796 * \return a EC_POINT object with the public key (possibly NULL)
797 */
798const EC_POINT *EC_KEY_get0_public_key(const EC_KEY *key);
799
800/** Sets the public key of a EC_KEY object.
801 * \param key EC_KEY object
802 * \param pub EC_POINT object with the public key (note: the EC_KEY object
803 * will use an own copy of the EC_POINT object).
804 * \return 1 on success and 0 if an error occurred.
805 */
806int EC_KEY_set_public_key(EC_KEY *key, const EC_POINT *pub);
807
808unsigned EC_KEY_get_enc_flags(const EC_KEY *key);
809void EC_KEY_set_enc_flags(EC_KEY *eckey, unsigned int flags);
810point_conversion_form_t EC_KEY_get_conv_form(const EC_KEY *key);
811void EC_KEY_set_conv_form(EC_KEY *eckey, point_conversion_form_t cform);
812/* functions to set/get method specific data */
813void *EC_KEY_get_key_method_data(EC_KEY *key,
814 void *(*dup_func)(void *), void (*free_func)(void *), void (*clear_free_func)(void *));
815/** Sets the key method data of an EC_KEY object, if none has yet been set.
816 * \param key EC_KEY object
817 * \param data opaque data to install.
818 * \param dup_func a function that duplicates |data|.
819 * \param free_func a function that frees |data|.
820 * \param clear_free_func a function that wipes and frees |data|.
821 * \return the previously set data pointer, or NULL if |data| was inserted.
822 */
823void *EC_KEY_insert_key_method_data(EC_KEY *key, void *data,
824 void *(*dup_func)(void *), void (*free_func)(void *), void (*clear_free_func)(void *));
825/* wrapper functions for the underlying EC_GROUP object */
826void EC_KEY_set_asn1_flag(EC_KEY *eckey, int asn1_flag);
827
828/** Creates a table of pre-computed multiples of the generator to
829 * accelerate further EC_KEY operations.
830 * \param key EC_KEY object
831 * \param ctx BN_CTX object (optional)
832 * \return 1 on success and 0 if an error occurred.
833 */
834int EC_KEY_precompute_mult(EC_KEY *key, BN_CTX *ctx);
835
836/** Creates a new ec private (and optional a new public) key.
837 * \param key EC_KEY object
838 * \return 1 on success and 0 if an error occurred.
839 */
840int EC_KEY_generate_key(EC_KEY *key);
841
842/** Verifies that a private and/or public key is valid.
843 * \param key the EC_KEY object
844 * \return 1 on success and 0 otherwise.
845 */
846int EC_KEY_check_key(const EC_KEY *key);
847
848/** Sets a public key from affine coordindates performing
849 * neccessary NIST PKV tests.
850 * \param key the EC_KEY object
851 * \param x public key x coordinate
852 * \param y public key y coordinate
853 * \return 1 on success and 0 otherwise.
854 */
855int EC_KEY_set_public_key_affine_coordinates(EC_KEY *key, BIGNUM *x, BIGNUM *y);
856
857
858/********************************************************************/
859/* de- and encoding functions for SEC1 ECPrivateKey */
860/********************************************************************/
861
862/** Decodes a private key from a memory buffer.
863 * \param key a pointer to a EC_KEY object which should be used (or NULL)
864 * \param in pointer to memory with the DER encoded private key
865 * \param len length of the DER encoded private key
866 * \return the decoded private key or NULL if an error occurred.
867 */
868EC_KEY *d2i_ECPrivateKey(EC_KEY **key, const unsigned char **in, long len);
869
870/** Encodes a private key object and stores the result in a buffer.
871 * \param key the EC_KEY object to encode
872 * \param out the buffer for the result (if NULL the function returns number
873 * of bytes needed).
874 * \return 1 on success and 0 if an error occurred.
875 */
876int i2d_ECPrivateKey(EC_KEY *key, unsigned char **out);
877
878
879/********************************************************************/
880/* de- and encoding functions for EC parameters */
881/********************************************************************/
882
883/** Decodes ec parameter from a memory buffer.
884 * \param key a pointer to a EC_KEY object which should be used (or NULL)
885 * \param in pointer to memory with the DER encoded ec parameters
886 * \param len length of the DER encoded ec parameters
887 * \return a EC_KEY object with the decoded parameters or NULL if an error
888 * occurred.
889 */
890EC_KEY *d2i_ECParameters(EC_KEY **key, const unsigned char **in, long len);
891
892/** Encodes ec parameter and stores the result in a buffer.
893 * \param key the EC_KEY object with ec paramters to encode
894 * \param out the buffer for the result (if NULL the function returns number
895 * of bytes needed).
896 * \return 1 on success and 0 if an error occurred.
897 */
898int i2d_ECParameters(EC_KEY *key, unsigned char **out);
899
900
901/********************************************************************/
902/* de- and encoding functions for EC public key */
903/* (octet string, not DER -- hence 'o2i' and 'i2o') */
904/********************************************************************/
905
906/** Decodes a ec public key from a octet string.
907 * \param key a pointer to a EC_KEY object which should be used
908 * \param in memory buffer with the encoded public key
909 * \param len length of the encoded public key
910 * \return EC_KEY object with decoded public key or NULL if an error
911 * occurred.
912 */
913EC_KEY *o2i_ECPublicKey(EC_KEY **key, const unsigned char **in, long len);
914
915/** Encodes a ec public key in an octet string.
916 * \param key the EC_KEY object with the public key
917 * \param out the buffer for the result (if NULL the function returns number
918 * of bytes needed).
919 * \return 1 on success and 0 if an error occurred
920 */
921int i2o_ECPublicKey(EC_KEY *key, unsigned char **out);
922
923#ifndef OPENSSL_NO_BIO
924/** Prints out the ec parameters on human readable form.
925 * \param bp BIO object to which the information is printed
926 * \param key EC_KEY object
927 * \return 1 on success and 0 if an error occurred
928 */
929int ECParameters_print(BIO *bp, const EC_KEY *key);
930
931/** Prints out the contents of a EC_KEY object
932 * \param bp BIO object to which the information is printed
933 * \param key EC_KEY object
934 * \param off line offset
935 * \return 1 on success and 0 if an error occurred
936 */
937int EC_KEY_print(BIO *bp, const EC_KEY *key, int off);
938
939#endif
940#ifndef OPENSSL_NO_FP_API
941/** Prints out the ec parameters on human readable form.
942 * \param fp file descriptor to which the information is printed
943 * \param key EC_KEY object
944 * \return 1 on success and 0 if an error occurred
945 */
946int ECParameters_print_fp(FILE *fp, const EC_KEY *key);
947
948/** Prints out the contents of a EC_KEY object
949 * \param fp file descriptor to which the information is printed
950 * \param key EC_KEY object
951 * \param off line offset
952 * \return 1 on success and 0 if an error occurred
953 */
954int EC_KEY_print_fp(FILE *fp, const EC_KEY *key, int off);
955
956#endif
957
958#define ECParameters_dup(x) ASN1_dup_of(EC_KEY,i2d_ECParameters,d2i_ECParameters,x)
959
960#ifndef __cplusplus
961#if defined(__SUNPRO_C)
962# if __SUNPRO_C >= 0x520
963# pragma error_messages (default,E_ARRAY_OF_INCOMPLETE_NONAME,E_ARRAY_OF_INCOMPLETE)
964# endif
965# endif
966#endif
967
968#define EVP_PKEY_CTX_set_ec_paramgen_curve_nid(ctx, nid) \
969 EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_EC, EVP_PKEY_OP_PARAMGEN, \
970 EVP_PKEY_CTRL_EC_PARAMGEN_CURVE_NID, nid, NULL)
971
972
973#define EVP_PKEY_CTRL_EC_PARAMGEN_CURVE_NID (EVP_PKEY_ALG_CTRL + 1)
974
975/* BEGIN ERROR CODES */
976/* The following lines are auto generated by the script mkerr.pl. Any changes
977 * made after this point may be overwritten when the script is next run.
978 */
979void ERR_load_EC_strings(void);
980
981/* Error codes for the EC functions. */
982
983/* Function codes. */
984#define EC_F_BN_TO_FELEM 224
985#define EC_F_COMPUTE_WNAF 143
986#define EC_F_D2I_ECPARAMETERS 144
987#define EC_F_D2I_ECPKPARAMETERS 145
988#define EC_F_D2I_ECPRIVATEKEY 146
989#define EC_F_DO_EC_KEY_PRINT 221
990#define EC_F_ECKEY_PARAM2TYPE 223
991#define EC_F_ECKEY_PARAM_DECODE 212
992#define EC_F_ECKEY_PRIV_DECODE 213
993#define EC_F_ECKEY_PRIV_ENCODE 214
994#define EC_F_ECKEY_PUB_DECODE 215
995#define EC_F_ECKEY_PUB_ENCODE 216
996#define EC_F_ECKEY_TYPE2PARAM 220
997#define EC_F_ECPARAMETERS_PRINT 147
998#define EC_F_ECPARAMETERS_PRINT_FP 148
999#define EC_F_ECPKPARAMETERS_PRINT 149
1000#define EC_F_ECPKPARAMETERS_PRINT_FP 150
1001#define EC_F_ECP_NIST_MOD_192 203
1002#define EC_F_ECP_NIST_MOD_224 204
1003#define EC_F_ECP_NIST_MOD_256 205
1004#define EC_F_ECP_NIST_MOD_521 206
1005#define EC_F_EC_ASN1_GROUP2CURVE 153
1006#define EC_F_EC_ASN1_GROUP2FIELDID 154
1007#define EC_F_EC_ASN1_GROUP2PARAMETERS 155
1008#define EC_F_EC_ASN1_GROUP2PKPARAMETERS 156
1009#define EC_F_EC_ASN1_PARAMETERS2GROUP 157
1010#define EC_F_EC_ASN1_PKPARAMETERS2GROUP 158
1011#define EC_F_EC_EX_DATA_SET_DATA 211
1012#define EC_F_EC_GF2M_MONTGOMERY_POINT_MULTIPLY 208
1013#define EC_F_EC_GF2M_SIMPLE_GROUP_CHECK_DISCRIMINANT 159
1014#define EC_F_EC_GF2M_SIMPLE_GROUP_SET_CURVE 195
1015#define EC_F_EC_GF2M_SIMPLE_OCT2POINT 160
1016#define EC_F_EC_GF2M_SIMPLE_POINT2OCT 161
1017#define EC_F_EC_GF2M_SIMPLE_POINT_GET_AFFINE_COORDINATES 162
1018#define EC_F_EC_GF2M_SIMPLE_POINT_SET_AFFINE_COORDINATES 163
1019#define EC_F_EC_GF2M_SIMPLE_SET_COMPRESSED_COORDINATES 164
1020#define EC_F_EC_GFP_MONT_FIELD_DECODE 133
1021#define EC_F_EC_GFP_MONT_FIELD_ENCODE 134
1022#define EC_F_EC_GFP_MONT_FIELD_MUL 131
1023#define EC_F_EC_GFP_MONT_FIELD_SET_TO_ONE 209
1024#define EC_F_EC_GFP_MONT_FIELD_SQR 132
1025#define EC_F_EC_GFP_MONT_GROUP_SET_CURVE 189
1026#define EC_F_EC_GFP_MONT_GROUP_SET_CURVE_GFP 135
1027#define EC_F_EC_GFP_NISTP224_GROUP_SET_CURVE 225
1028#define EC_F_EC_GFP_NISTP224_POINTS_MUL 228
1029#define EC_F_EC_GFP_NISTP224_POINT_GET_AFFINE_COORDINATES 226
1030#define EC_F_EC_GFP_NISTP256_GROUP_SET_CURVE 230
1031#define EC_F_EC_GFP_NISTP256_POINTS_MUL 231
1032#define EC_F_EC_GFP_NISTP256_POINT_GET_AFFINE_COORDINATES 232
1033#define EC_F_EC_GFP_NISTP521_GROUP_SET_CURVE 233
1034#define EC_F_EC_GFP_NISTP521_POINTS_MUL 234
1035#define EC_F_EC_GFP_NISTP521_POINT_GET_AFFINE_COORDINATES 235
1036#define EC_F_EC_GFP_NIST_FIELD_MUL 200
1037#define EC_F_EC_GFP_NIST_FIELD_SQR 201
1038#define EC_F_EC_GFP_NIST_GROUP_SET_CURVE 202
1039#define EC_F_EC_GFP_SIMPLE_GROUP_CHECK_DISCRIMINANT 165
1040#define EC_F_EC_GFP_SIMPLE_GROUP_SET_CURVE 166
1041#define EC_F_EC_GFP_SIMPLE_GROUP_SET_CURVE_GFP 100
1042#define EC_F_EC_GFP_SIMPLE_GROUP_SET_GENERATOR 101
1043#define EC_F_EC_GFP_SIMPLE_MAKE_AFFINE 102
1044#define EC_F_EC_GFP_SIMPLE_OCT2POINT 103
1045#define EC_F_EC_GFP_SIMPLE_POINT2OCT 104
1046#define EC_F_EC_GFP_SIMPLE_POINTS_MAKE_AFFINE 137
1047#define EC_F_EC_GFP_SIMPLE_POINT_GET_AFFINE_COORDINATES 167
1048#define EC_F_EC_GFP_SIMPLE_POINT_GET_AFFINE_COORDINATES_GFP 105
1049#define EC_F_EC_GFP_SIMPLE_POINT_SET_AFFINE_COORDINATES 168
1050#define EC_F_EC_GFP_SIMPLE_POINT_SET_AFFINE_COORDINATES_GFP 128
1051#define EC_F_EC_GFP_SIMPLE_SET_COMPRESSED_COORDINATES 169
1052#define EC_F_EC_GFP_SIMPLE_SET_COMPRESSED_COORDINATES_GFP 129
1053#define EC_F_EC_GROUP_CHECK 170
1054#define EC_F_EC_GROUP_CHECK_DISCRIMINANT 171
1055#define EC_F_EC_GROUP_COPY 106
1056#define EC_F_EC_GROUP_GET0_GENERATOR 139
1057#define EC_F_EC_GROUP_GET_COFACTOR 140
1058#define EC_F_EC_GROUP_GET_CURVE_GF2M 172
1059#define EC_F_EC_GROUP_GET_CURVE_GFP 130
1060#define EC_F_EC_GROUP_GET_DEGREE 173
1061#define EC_F_EC_GROUP_GET_ORDER 141
1062#define EC_F_EC_GROUP_GET_PENTANOMIAL_BASIS 193
1063#define EC_F_EC_GROUP_GET_TRINOMIAL_BASIS 194
1064#define EC_F_EC_GROUP_NEW 108
1065#define EC_F_EC_GROUP_NEW_BY_CURVE_NAME 174
1066#define EC_F_EC_GROUP_NEW_FROM_DATA 175
1067#define EC_F_EC_GROUP_PRECOMPUTE_MULT 142
1068#define EC_F_EC_GROUP_SET_CURVE_GF2M 176
1069#define EC_F_EC_GROUP_SET_CURVE_GFP 109
1070#define EC_F_EC_GROUP_SET_EXTRA_DATA 110
1071#define EC_F_EC_GROUP_SET_GENERATOR 111
1072#define EC_F_EC_KEY_CHECK_KEY 177
1073#define EC_F_EC_KEY_COPY 178
1074#define EC_F_EC_KEY_GENERATE_KEY 179
1075#define EC_F_EC_KEY_NEW 182
1076#define EC_F_EC_KEY_PRINT 180
1077#define EC_F_EC_KEY_PRINT_FP 181
1078#define EC_F_EC_KEY_SET_PUBLIC_KEY_AFFINE_COORDINATES 229
1079#define EC_F_EC_POINTS_MAKE_AFFINE 136
1080#define EC_F_EC_POINT_ADD 112
1081#define EC_F_EC_POINT_CMP 113
1082#define EC_F_EC_POINT_COPY 114
1083#define EC_F_EC_POINT_DBL 115
1084#define EC_F_EC_POINT_GET_AFFINE_COORDINATES_GF2M 183
1085#define EC_F_EC_POINT_GET_AFFINE_COORDINATES_GFP 116
1086#define EC_F_EC_POINT_GET_JPROJECTIVE_COORDINATES_GFP 117
1087#define EC_F_EC_POINT_INVERT 210
1088#define EC_F_EC_POINT_IS_AT_INFINITY 118
1089#define EC_F_EC_POINT_IS_ON_CURVE 119
1090#define EC_F_EC_POINT_MAKE_AFFINE 120
1091#define EC_F_EC_POINT_MUL 184
1092#define EC_F_EC_POINT_NEW 121
1093#define EC_F_EC_POINT_OCT2POINT 122
1094#define EC_F_EC_POINT_POINT2OCT 123
1095#define EC_F_EC_POINT_SET_AFFINE_COORDINATES_GF2M 185
1096#define EC_F_EC_POINT_SET_AFFINE_COORDINATES_GFP 124
1097#define EC_F_EC_POINT_SET_COMPRESSED_COORDINATES_GF2M 186
1098#define EC_F_EC_POINT_SET_COMPRESSED_COORDINATES_GFP 125
1099#define EC_F_EC_POINT_SET_JPROJECTIVE_COORDINATES_GFP 126
1100#define EC_F_EC_POINT_SET_TO_INFINITY 127
1101#define EC_F_EC_PRE_COMP_DUP 207
1102#define EC_F_EC_PRE_COMP_NEW 196
1103#define EC_F_EC_WNAF_MUL 187
1104#define EC_F_EC_WNAF_PRECOMPUTE_MULT 188
1105#define EC_F_I2D_ECPARAMETERS 190
1106#define EC_F_I2D_ECPKPARAMETERS 191
1107#define EC_F_I2D_ECPRIVATEKEY 192
1108#define EC_F_I2O_ECPUBLICKEY 151
1109#define EC_F_NISTP224_PRE_COMP_NEW 227
1110#define EC_F_NISTP256_PRE_COMP_NEW 236
1111#define EC_F_NISTP521_PRE_COMP_NEW 237
1112#define EC_F_O2I_ECPUBLICKEY 152
1113#define EC_F_OLD_EC_PRIV_DECODE 222
1114#define EC_F_PKEY_EC_CTRL 197
1115#define EC_F_PKEY_EC_CTRL_STR 198
1116#define EC_F_PKEY_EC_DERIVE 217
1117#define EC_F_PKEY_EC_KEYGEN 199
1118#define EC_F_PKEY_EC_PARAMGEN 219
1119#define EC_F_PKEY_EC_SIGN 218
1120
1121/* Reason codes. */
1122#define EC_R_ASN1_ERROR 115
1123#define EC_R_ASN1_UNKNOWN_FIELD 116
1124#define EC_R_BIGNUM_OUT_OF_RANGE 144
1125#define EC_R_BUFFER_TOO_SMALL 100
1126#define EC_R_COORDINATES_OUT_OF_RANGE 146
1127#define EC_R_D2I_ECPKPARAMETERS_FAILURE 117
1128#define EC_R_DECODE_ERROR 142
1129#define EC_R_DISCRIMINANT_IS_ZERO 118
1130#define EC_R_EC_GROUP_NEW_BY_NAME_FAILURE 119
1131#define EC_R_FIELD_TOO_LARGE 143
1132#define EC_R_GF2M_NOT_SUPPORTED 147
1133#define EC_R_GROUP2PKPARAMETERS_FAILURE 120
1134#define EC_R_I2D_ECPKPARAMETERS_FAILURE 121
1135#define EC_R_INCOMPATIBLE_OBJECTS 101
1136#define EC_R_INVALID_ARGUMENT 112
1137#define EC_R_INVALID_COMPRESSED_POINT 110
1138#define EC_R_INVALID_COMPRESSION_BIT 109
1139#define EC_R_INVALID_CURVE 141
1140#define EC_R_INVALID_DIGEST_TYPE 138
1141#define EC_R_INVALID_ENCODING 102
1142#define EC_R_INVALID_FIELD 103
1143#define EC_R_INVALID_FORM 104
1144#define EC_R_INVALID_GROUP_ORDER 122
1145#define EC_R_INVALID_PENTANOMIAL_BASIS 132
1146#define EC_R_INVALID_PRIVATE_KEY 123
1147#define EC_R_INVALID_TRINOMIAL_BASIS 137
1148#define EC_R_KEYS_NOT_SET 140
1149#define EC_R_MISSING_PARAMETERS 124
1150#define EC_R_MISSING_PRIVATE_KEY 125
1151#define EC_R_NOT_A_NIST_PRIME 135
1152#define EC_R_NOT_A_SUPPORTED_NIST_PRIME 136
1153#define EC_R_NOT_IMPLEMENTED 126
1154#define EC_R_NOT_INITIALIZED 111
1155#define EC_R_NO_FIELD_MOD 133
1156#define EC_R_NO_PARAMETERS_SET 139
1157#define EC_R_PASSED_NULL_PARAMETER 134
1158#define EC_R_PKPARAMETERS2GROUP_FAILURE 127
1159#define EC_R_POINT_AT_INFINITY 106
1160#define EC_R_POINT_IS_NOT_ON_CURVE 107
1161#define EC_R_SLOT_FULL 108
1162#define EC_R_UNDEFINED_GENERATOR 113
1163#define EC_R_UNDEFINED_ORDER 128
1164#define EC_R_UNKNOWN_GROUP 129
1165#define EC_R_UNKNOWN_ORDER 114
1166#define EC_R_UNSUPPORTED_FIELD 131
1167#define EC_R_WRONG_CURVE_PARAMETERS 145
1168#define EC_R_WRONG_ORDER 130
1169
1170#ifdef __cplusplus
1171}
1172#endif
1173#endif
1174