2001-03-05 20:13:37 +00:00
|
|
|
/* crypto/ec/ec.h */
|
2002-08-02 14:28:37 +00:00
|
|
|
/*
|
|
|
|
* Originally written by Bodo Moeller for the OpenSSL project.
|
|
|
|
*/
|
2001-03-05 20:13:37 +00:00
|
|
|
/* ====================================================================
|
2003-02-06 19:25:12 +00:00
|
|
|
* Copyright (c) 1998-2003 The OpenSSL Project. All rights reserved.
|
2000-11-26 12:55:19 +00:00
|
|
|
*
|
2001-03-05 20:13:37 +00:00
|
|
|
* Redistribution and use in source and binary forms, with or without
|
|
|
|
* modification, are permitted provided that the following conditions
|
|
|
|
* are met:
|
2000-11-26 12:55:19 +00:00
|
|
|
*
|
2001-03-05 20:13:37 +00:00
|
|
|
* 1. Redistributions of source code must retain the above copyright
|
|
|
|
* notice, this list of conditions and the following disclaimer.
|
2000-11-26 12:55:19 +00:00
|
|
|
*
|
2001-03-05 20:13:37 +00:00
|
|
|
* 2. Redistributions in binary form must reproduce the above copyright
|
|
|
|
* notice, this list of conditions and the following disclaimer in
|
|
|
|
* the documentation and/or other materials provided with the
|
|
|
|
* distribution.
|
2000-11-26 12:55:19 +00:00
|
|
|
*
|
2001-03-05 20:13:37 +00:00
|
|
|
* 3. All advertising materials mentioning features or use of this
|
|
|
|
* software must display the following acknowledgment:
|
|
|
|
* "This product includes software developed by the OpenSSL Project
|
|
|
|
* for use in the OpenSSL Toolkit. (http://www.openssl.org/)"
|
|
|
|
*
|
|
|
|
* 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
|
|
|
|
* endorse or promote products derived from this software without
|
|
|
|
* prior written permission. For written permission, please contact
|
|
|
|
* openssl-core@openssl.org.
|
|
|
|
*
|
|
|
|
* 5. Products derived from this software may not be called "OpenSSL"
|
|
|
|
* nor may "OpenSSL" appear in their names without prior written
|
|
|
|
* permission of the OpenSSL Project.
|
|
|
|
*
|
|
|
|
* 6. Redistributions of any form whatsoever must retain the following
|
|
|
|
* acknowledgment:
|
|
|
|
* "This product includes software developed by the OpenSSL Project
|
|
|
|
* for use in the OpenSSL Toolkit (http://www.openssl.org/)"
|
|
|
|
*
|
|
|
|
* THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY
|
|
|
|
* EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
|
|
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
|
|
|
|
* PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR
|
|
|
|
* ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
|
|
|
|
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
|
|
|
|
* NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
|
|
|
|
* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
|
|
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
|
|
|
|
* STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
|
|
|
|
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
|
|
|
|
* OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
|
|
* ====================================================================
|
|
|
|
*
|
|
|
|
* This product includes cryptographic software written by Eric Young
|
|
|
|
* (eay@cryptsoft.com). This product includes software written by Tim
|
|
|
|
* Hudson (tjh@cryptsoft.com).
|
2000-11-26 12:55:19 +00:00
|
|
|
*
|
|
|
|
*/
|
2002-08-02 13:42:24 +00:00
|
|
|
/* ====================================================================
|
|
|
|
* Copyright 2002 Sun Microsystems, Inc. ALL RIGHTS RESERVED.
|
|
|
|
*
|
|
|
|
* Portions of the attached software ("Contribution") are developed by
|
|
|
|
* SUN MICROSYSTEMS, INC., and are contributed to the OpenSSL project.
|
|
|
|
*
|
|
|
|
* The Contribution is licensed pursuant to the OpenSSL open source
|
|
|
|
* license provided above.
|
|
|
|
*
|
|
|
|
* The elliptic curve binary polynomial software is originally written by
|
|
|
|
* Sheueling Chang Shantz and Douglas Stebila of Sun Microsystems Laboratories.
|
|
|
|
*
|
|
|
|
*/
|
2000-11-26 12:55:19 +00:00
|
|
|
|
|
|
|
#ifndef HEADER_EC_H
|
|
|
|
#define HEADER_EC_H
|
|
|
|
|
2003-03-20 23:22:06 +00:00
|
|
|
#include <openssl/opensslconf.h>
|
|
|
|
|
2001-03-08 19:14:52 +00:00
|
|
|
#ifdef OPENSSL_NO_EC
|
2001-09-26 15:18:32 +00:00
|
|
|
#error EC is disabled.
|
2001-03-08 19:14:52 +00:00
|
|
|
#endif
|
|
|
|
|
2002-06-10 12:18:21 +00:00
|
|
|
#include <openssl/asn1.h>
|
2001-03-08 17:20:31 +00:00
|
|
|
#include <openssl/symhacks.h>
|
2004-05-17 19:14:22 +00:00
|
|
|
#ifndef OPENSSL_NO_DEPRECATED
|
|
|
|
#include <openssl/bn.h>
|
|
|
|
#endif
|
2000-11-26 12:55:19 +00:00
|
|
|
|
2001-03-05 20:13:37 +00:00
|
|
|
#ifdef __cplusplus
|
|
|
|
extern "C" {
|
2004-01-24 16:31:21 +00:00
|
|
|
#elif defined(__SUNPRO_C)
|
|
|
|
# if __SUNPRO_C >= 0x520
|
|
|
|
# pragma error_messages (off,E_ARRAY_OF_INCOMPLETE_NONAME,E_ARRAY_OF_INCOMPLETE)
|
|
|
|
# endif
|
2001-03-05 20:13:37 +00:00
|
|
|
#endif
|
2000-11-26 12:55:19 +00:00
|
|
|
|
|
|
|
|
2001-03-05 21:54:39 +00:00
|
|
|
typedef enum {
|
2001-03-08 01:23:28 +00:00
|
|
|
/* values as defined in X9.62 (ECDSA) and elsewhere */
|
2001-03-05 21:54:39 +00:00
|
|
|
POINT_CONVERSION_COMPRESSED = 2,
|
|
|
|
POINT_CONVERSION_UNCOMPRESSED = 4,
|
|
|
|
POINT_CONVERSION_HYBRID = 6
|
|
|
|
} point_conversion_form_t;
|
|
|
|
|
|
|
|
|
|
|
|
typedef struct ec_method_st EC_METHOD;
|
|
|
|
|
|
|
|
typedef struct ec_group_st
|
|
|
|
/*
|
|
|
|
EC_METHOD *meth;
|
|
|
|
-- field definition
|
|
|
|
-- curve coefficients
|
|
|
|
-- optional generator with associated information (order, cofactor)
|
2003-02-06 19:25:12 +00:00
|
|
|
-- optional extra data (precomputed table for fast computation of multiples of generator)
|
2002-06-18 08:38:59 +00:00
|
|
|
-- ASN1 stuff
|
2001-03-05 21:54:39 +00:00
|
|
|
*/
|
|
|
|
EC_GROUP;
|
|
|
|
|
|
|
|
typedef struct ec_point_st EC_POINT;
|
|
|
|
|
|
|
|
|
|
|
|
/* EC_METHODs for curves over GF(p).
|
|
|
|
* EC_GFp_simple_method provides the basis for the optimized methods.
|
|
|
|
*/
|
|
|
|
const EC_METHOD *EC_GFp_simple_method(void);
|
|
|
|
const EC_METHOD *EC_GFp_mont_method(void);
|
2002-10-28 13:23:24 +00:00
|
|
|
const EC_METHOD *EC_GFp_nist_method(void);
|
2001-03-05 21:54:39 +00:00
|
|
|
|
2002-08-02 13:43:26 +00:00
|
|
|
/* EC_METHOD for curves over GF(2^m).
|
2002-08-02 13:42:24 +00:00
|
|
|
*/
|
|
|
|
const EC_METHOD *EC_GF2m_simple_method(void);
|
|
|
|
|
2001-03-05 21:54:39 +00:00
|
|
|
|
|
|
|
EC_GROUP *EC_GROUP_new(const EC_METHOD *);
|
2001-03-10 23:18:35 +00:00
|
|
|
void EC_GROUP_free(EC_GROUP *);
|
|
|
|
void EC_GROUP_clear_free(EC_GROUP *);
|
|
|
|
int EC_GROUP_copy(EC_GROUP *, const EC_GROUP *);
|
2002-08-02 13:42:24 +00:00
|
|
|
EC_GROUP *EC_GROUP_dup(const EC_GROUP *);
|
2001-03-10 23:18:35 +00:00
|
|
|
|
2002-05-08 11:54:24 +00:00
|
|
|
const EC_METHOD *EC_GROUP_method_of(const EC_GROUP *);
|
2002-06-10 12:18:21 +00:00
|
|
|
int EC_METHOD_get_field_type(const EC_METHOD *);
|
2002-05-08 11:54:24 +00:00
|
|
|
|
|
|
|
int EC_GROUP_set_generator(EC_GROUP *, const EC_POINT *generator, const BIGNUM *order, const BIGNUM *cofactor);
|
2005-05-16 10:11:04 +00:00
|
|
|
const EC_POINT *EC_GROUP_get0_generator(const EC_GROUP *);
|
2002-05-08 11:54:24 +00:00
|
|
|
int EC_GROUP_get_order(const EC_GROUP *, BIGNUM *order, BN_CTX *);
|
|
|
|
int EC_GROUP_get_cofactor(const EC_GROUP *, BIGNUM *cofactor, BN_CTX *);
|
|
|
|
|
2005-05-11 03:45:39 +00:00
|
|
|
void EC_GROUP_set_curve_name(EC_GROUP *, int nid);
|
2005-05-08 22:09:12 +00:00
|
|
|
int EC_GROUP_get_curve_name(const EC_GROUP *);
|
2002-02-13 17:22:59 +00:00
|
|
|
|
2002-06-18 08:38:59 +00:00
|
|
|
void EC_GROUP_set_asn1_flag(EC_GROUP *, int flag);
|
|
|
|
int EC_GROUP_get_asn1_flag(const EC_GROUP *);
|
|
|
|
|
|
|
|
void EC_GROUP_set_point_conversion_form(EC_GROUP *, point_conversion_form_t);
|
|
|
|
point_conversion_form_t EC_GROUP_get_point_conversion_form(const EC_GROUP *);
|
|
|
|
|
|
|
|
unsigned char *EC_GROUP_get0_seed(const EC_GROUP *);
|
|
|
|
size_t EC_GROUP_get_seed_len(const EC_GROUP *);
|
|
|
|
size_t EC_GROUP_set_seed(EC_GROUP *, const unsigned char *, size_t len);
|
2001-03-10 23:18:35 +00:00
|
|
|
|
2001-03-08 19:14:52 +00:00
|
|
|
int EC_GROUP_set_curve_GFp(EC_GROUP *, const BIGNUM *p, const BIGNUM *a, const BIGNUM *b, BN_CTX *);
|
2001-03-10 23:18:35 +00:00
|
|
|
int EC_GROUP_get_curve_GFp(const EC_GROUP *, BIGNUM *p, BIGNUM *a, BIGNUM *b, BN_CTX *);
|
2002-08-02 13:42:24 +00:00
|
|
|
int EC_GROUP_set_curve_GF2m(EC_GROUP *, const BIGNUM *p, const BIGNUM *a, const BIGNUM *b, BN_CTX *);
|
|
|
|
int EC_GROUP_get_curve_GF2m(const EC_GROUP *, BIGNUM *p, BIGNUM *a, BIGNUM *b, BN_CTX *);
|
|
|
|
|
2003-07-22 12:34:21 +00:00
|
|
|
/* returns the number of bits needed to represent a field element */
|
2002-08-02 13:42:24 +00:00
|
|
|
int EC_GROUP_get_degree(const EC_GROUP *);
|
2001-03-05 21:54:39 +00:00
|
|
|
|
2002-03-18 13:10:45 +00:00
|
|
|
/* EC_GROUP_check() returns 1 if 'group' defines a valid group, 0 otherwise */
|
|
|
|
int EC_GROUP_check(const EC_GROUP *group, BN_CTX *ctx);
|
2002-03-20 10:18:07 +00:00
|
|
|
/* EC_GROUP_check_discriminant() returns 1 if the discriminant of the
|
|
|
|
* elliptic curve is not zero, 0 otherwise */
|
|
|
|
int EC_GROUP_check_discriminant(const EC_GROUP *, BN_CTX *);
|
2002-02-13 17:22:59 +00:00
|
|
|
|
2003-07-21 13:43:28 +00:00
|
|
|
/* EC_GROUP_cmp() returns 0 if both groups are equal and 1 otherwise */
|
|
|
|
int EC_GROUP_cmp(const EC_GROUP *, const EC_GROUP *, BN_CTX *);
|
|
|
|
|
2002-08-02 13:42:24 +00:00
|
|
|
/* EC_GROUP_new_GF*() calls EC_GROUP_new() and EC_GROUP_set_GF*()
|
2002-02-13 17:22:59 +00:00
|
|
|
* after choosing an appropriate EC_METHOD */
|
|
|
|
EC_GROUP *EC_GROUP_new_curve_GFp(const BIGNUM *p, const BIGNUM *a, const BIGNUM *b, BN_CTX *);
|
2002-08-02 13:42:24 +00:00
|
|
|
EC_GROUP *EC_GROUP_new_curve_GF2m(const BIGNUM *p, const BIGNUM *a, const BIGNUM *b, BN_CTX *);
|
2002-02-13 17:22:59 +00:00
|
|
|
|
2005-05-10 11:37:47 +00:00
|
|
|
/* EC_GROUP_new_by_curve_name() creates a EC_GROUP structure
|
|
|
|
* specified by a curve name (in form of a NID) */
|
|
|
|
EC_GROUP *EC_GROUP_new_by_curve_name(int nid);
|
2002-09-02 07:08:33 +00:00
|
|
|
/* handling of internal curves */
|
|
|
|
typedef struct {
|
|
|
|
int nid;
|
|
|
|
const char *comment;
|
|
|
|
} EC_builtin_curve;
|
|
|
|
/* EC_builtin_curves(EC_builtin_curve *r, size_t size) returns number
|
|
|
|
* of all available curves or zero if a error occurred.
|
|
|
|
* In case r ist not zero nitems EC_builtin_curve structures
|
|
|
|
* are filled with the data of the first nitems internal groups */
|
|
|
|
size_t EC_get_builtin_curves(EC_builtin_curve *r, size_t nitems);
|
2002-08-15 09:21:31 +00:00
|
|
|
|
2002-08-26 11:25:54 +00:00
|
|
|
|
|
|
|
/* EC_POINT functions */
|
2002-02-13 17:22:59 +00:00
|
|
|
|
2001-03-05 21:54:39 +00:00
|
|
|
EC_POINT *EC_POINT_new(const EC_GROUP *);
|
|
|
|
void EC_POINT_free(EC_POINT *);
|
2001-03-07 01:17:05 +00:00
|
|
|
void EC_POINT_clear_free(EC_POINT *);
|
2001-03-06 06:20:20 +00:00
|
|
|
int EC_POINT_copy(EC_POINT *, const EC_POINT *);
|
2002-08-02 13:42:24 +00:00
|
|
|
EC_POINT *EC_POINT_dup(const EC_POINT *, const EC_GROUP *);
|
2001-03-05 21:54:39 +00:00
|
|
|
|
2001-03-10 23:18:35 +00:00
|
|
|
const EC_METHOD *EC_POINT_method_of(const EC_POINT *);
|
|
|
|
|
2001-03-08 01:23:28 +00:00
|
|
|
int EC_POINT_set_to_infinity(const EC_GROUP *, EC_POINT *);
|
2001-03-08 11:16:33 +00:00
|
|
|
int EC_POINT_set_Jprojective_coordinates_GFp(const EC_GROUP *, EC_POINT *,
|
|
|
|
const BIGNUM *x, const BIGNUM *y, const BIGNUM *z, BN_CTX *);
|
|
|
|
int EC_POINT_get_Jprojective_coordinates_GFp(const EC_GROUP *, const EC_POINT *,
|
|
|
|
BIGNUM *x, BIGNUM *y, BIGNUM *z, BN_CTX *);
|
2001-03-08 01:23:28 +00:00
|
|
|
int EC_POINT_set_affine_coordinates_GFp(const EC_GROUP *, EC_POINT *,
|
|
|
|
const BIGNUM *x, const BIGNUM *y, BN_CTX *);
|
|
|
|
int EC_POINT_get_affine_coordinates_GFp(const EC_GROUP *, const EC_POINT *,
|
|
|
|
BIGNUM *x, BIGNUM *y, BN_CTX *);
|
2001-03-08 11:16:33 +00:00
|
|
|
int EC_POINT_set_compressed_coordinates_GFp(const EC_GROUP *, EC_POINT *,
|
|
|
|
const BIGNUM *x, int y_bit, BN_CTX *);
|
2001-03-06 06:20:20 +00:00
|
|
|
|
2002-08-02 13:42:24 +00:00
|
|
|
int EC_POINT_set_affine_coordinates_GF2m(const EC_GROUP *, EC_POINT *,
|
|
|
|
const BIGNUM *x, const BIGNUM *y, BN_CTX *);
|
|
|
|
int EC_POINT_get_affine_coordinates_GF2m(const EC_GROUP *, const EC_POINT *,
|
|
|
|
BIGNUM *x, BIGNUM *y, BN_CTX *);
|
|
|
|
int EC_POINT_set_compressed_coordinates_GF2m(const EC_GROUP *, EC_POINT *,
|
|
|
|
const BIGNUM *x, int y_bit, BN_CTX *);
|
|
|
|
|
2001-03-06 22:30:03 +00:00
|
|
|
size_t EC_POINT_point2oct(const EC_GROUP *, const EC_POINT *, point_conversion_form_t form,
|
2001-03-06 06:20:20 +00:00
|
|
|
unsigned char *buf, size_t len, BN_CTX *);
|
|
|
|
int EC_POINT_oct2point(const EC_GROUP *, EC_POINT *,
|
|
|
|
const unsigned char *buf, size_t len, BN_CTX *);
|
|
|
|
|
2002-05-30 13:16:03 +00:00
|
|
|
/* other interfaces to point2oct/oct2point: */
|
|
|
|
BIGNUM *EC_POINT_point2bn(const EC_GROUP *, const EC_POINT *,
|
|
|
|
point_conversion_form_t form, BIGNUM *, BN_CTX *);
|
|
|
|
EC_POINT *EC_POINT_bn2point(const EC_GROUP *, const BIGNUM *,
|
|
|
|
EC_POINT *, BN_CTX *);
|
|
|
|
char *EC_POINT_point2hex(const EC_GROUP *, const EC_POINT *,
|
|
|
|
point_conversion_form_t form, BN_CTX *);
|
|
|
|
EC_POINT *EC_POINT_hex2point(const EC_GROUP *, const char *,
|
|
|
|
EC_POINT *, BN_CTX *);
|
|
|
|
|
2001-03-06 06:20:20 +00:00
|
|
|
int EC_POINT_add(const EC_GROUP *, EC_POINT *r, const EC_POINT *a, const EC_POINT *b, BN_CTX *);
|
|
|
|
int EC_POINT_dbl(const EC_GROUP *, EC_POINT *r, const EC_POINT *a, BN_CTX *);
|
2001-03-08 11:16:33 +00:00
|
|
|
int EC_POINT_invert(const EC_GROUP *, EC_POINT *, BN_CTX *);
|
2001-03-05 21:54:39 +00:00
|
|
|
|
2001-03-06 22:30:03 +00:00
|
|
|
int EC_POINT_is_at_infinity(const EC_GROUP *, const EC_POINT *);
|
|
|
|
int EC_POINT_is_on_curve(const EC_GROUP *, const EC_POINT *, BN_CTX *);
|
2001-03-08 11:16:33 +00:00
|
|
|
int EC_POINT_cmp(const EC_GROUP *, const EC_POINT *a, const EC_POINT *b, BN_CTX *);
|
2001-03-06 07:01:51 +00:00
|
|
|
|
2001-03-07 20:56:48 +00:00
|
|
|
int EC_POINT_make_affine(const EC_GROUP *, EC_POINT *, BN_CTX *);
|
2001-03-10 23:18:35 +00:00
|
|
|
int EC_POINTs_make_affine(const EC_GROUP *, size_t num, EC_POINT *[], BN_CTX *);
|
2001-03-06 07:01:51 +00:00
|
|
|
|
2001-03-05 21:54:39 +00:00
|
|
|
|
2001-03-11 12:27:24 +00:00
|
|
|
int EC_POINTs_mul(const EC_GROUP *, EC_POINT *r, const BIGNUM *, size_t num, const EC_POINT *[], const BIGNUM *[], BN_CTX *);
|
|
|
|
int EC_POINT_mul(const EC_GROUP *, EC_POINT *r, const BIGNUM *, const EC_POINT *, const BIGNUM *, BN_CTX *);
|
2003-02-06 19:25:12 +00:00
|
|
|
|
|
|
|
/* EC_GROUP_precompute_mult() stores multiples of generator for faster point multiplication */
|
2001-03-12 07:26:23 +00:00
|
|
|
int EC_GROUP_precompute_mult(EC_GROUP *, BN_CTX *);
|
2003-02-06 19:25:12 +00:00
|
|
|
/* EC_GROUP_have_precompute_mult() reports whether such precomputation has been done */
|
|
|
|
int EC_GROUP_have_precompute_mult(const EC_GROUP *);
|
2000-11-26 12:55:19 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
2002-06-10 12:18:21 +00:00
|
|
|
/* ASN1 stuff */
|
2002-08-26 11:33:13 +00:00
|
|
|
|
|
|
|
/* EC_GROUP_get_basis_type() returns the NID of the basis type
|
2002-08-26 18:08:53 +00:00
|
|
|
* used to represent the field elements */
|
|
|
|
int EC_GROUP_get_basis_type(const EC_GROUP *);
|
|
|
|
int EC_GROUP_get_trinomial_basis(const EC_GROUP *, unsigned int *k);
|
|
|
|
int EC_GROUP_get_pentanomial_basis(const EC_GROUP *, unsigned int *k1,
|
2002-08-26 11:33:13 +00:00
|
|
|
unsigned int *k2, unsigned int *k3);
|
|
|
|
|
2002-06-12 14:01:17 +00:00
|
|
|
#define OPENSSL_EC_NAMED_CURVE 0x001
|
2002-06-10 12:18:21 +00:00
|
|
|
|
|
|
|
typedef struct ecpk_parameters_st ECPKPARAMETERS;
|
|
|
|
|
|
|
|
EC_GROUP *d2i_ECPKParameters(EC_GROUP **, const unsigned char **in, long len);
|
|
|
|
int i2d_ECPKParameters(const EC_GROUP *, unsigned char **out);
|
|
|
|
|
2005-03-31 09:26:39 +00:00
|
|
|
#define d2i_ECPKParameters_bio(bp,x) ASN1_d2i_bio_of(EC_GROUP,NULL,d2i_ECPKParameters,bp,x)
|
|
|
|
#define i2d_ECPKParameters_bio(bp,x) ASN1_i2d_bio_of_const(EC_GROUP,i2d_ECPKParameters,bp,x)
|
2002-07-14 16:54:31 +00:00
|
|
|
#define d2i_ECPKParameters_fp(fp,x) (EC_GROUP *)ASN1_d2i_fp(NULL, \
|
|
|
|
(char *(*)())d2i_ECPKParameters,(fp),(unsigned char **)(x))
|
|
|
|
#define i2d_ECPKParameters_fp(fp,x) ASN1_i2d_fp(i2d_ECPKParameters,(fp), \
|
|
|
|
(unsigned char *)(x))
|
2002-06-10 12:18:21 +00:00
|
|
|
|
2002-06-18 08:38:59 +00:00
|
|
|
#ifndef OPENSSL_NO_BIO
|
|
|
|
int ECPKParameters_print(BIO *bp, const EC_GROUP *x, int off);
|
|
|
|
#endif
|
|
|
|
#ifndef OPENSSL_NO_FP_API
|
|
|
|
int ECPKParameters_print_fp(FILE *fp, const EC_GROUP *x, int off);
|
|
|
|
#endif
|
|
|
|
|
2002-08-07 10:49:54 +00:00
|
|
|
/* the EC_KEY stuff */
|
|
|
|
typedef struct ec_key_st EC_KEY;
|
|
|
|
|
|
|
|
/* some values for the encoding_flag */
|
|
|
|
#define EC_PKEY_NO_PARAMETERS 0x001
|
|
|
|
#define EC_PKEY_NO_PUBKEY 0x002
|
|
|
|
|
|
|
|
EC_KEY *EC_KEY_new(void);
|
2005-05-16 10:11:04 +00:00
|
|
|
EC_KEY *EC_KEY_new_by_curve_name(int nid);
|
2002-08-07 10:49:54 +00:00
|
|
|
void EC_KEY_free(EC_KEY *);
|
|
|
|
EC_KEY *EC_KEY_copy(EC_KEY *, const EC_KEY *);
|
|
|
|
EC_KEY *EC_KEY_dup(const EC_KEY *);
|
2005-05-16 10:11:04 +00:00
|
|
|
|
2002-08-09 08:43:04 +00:00
|
|
|
int EC_KEY_up_ref(EC_KEY *);
|
2002-08-07 10:49:54 +00:00
|
|
|
|
2005-05-16 10:11:04 +00:00
|
|
|
const EC_GROUP *EC_KEY_get0_group(const EC_KEY *);
|
|
|
|
int EC_KEY_set_group(EC_KEY *, const EC_GROUP *);
|
|
|
|
const BIGNUM *EC_KEY_get0_private_key(const EC_KEY *);
|
|
|
|
int EC_KEY_set_private_key(EC_KEY *, const BIGNUM *);
|
|
|
|
const EC_POINT *EC_KEY_get0_public_key(const EC_KEY *);
|
|
|
|
int EC_KEY_set_public_key(EC_KEY *, const EC_POINT *);
|
|
|
|
unsigned EC_KEY_get_enc_flags(const EC_KEY *);
|
|
|
|
void EC_KEY_set_enc_flags(EC_KEY *, unsigned int);
|
|
|
|
point_conversion_form_t EC_KEY_get_conv_form(const EC_KEY *);
|
|
|
|
void EC_KEY_set_conv_form(EC_KEY *, point_conversion_form_t);
|
|
|
|
/* functions to set/get method specific data */
|
|
|
|
void *EC_KEY_get_key_method_data(EC_KEY *,
|
|
|
|
void *(*dup_func)(void *), void (*free_func)(void *), void (*clear_free_func)(void *));
|
|
|
|
void EC_KEY_insert_key_method_data(EC_KEY *, void *data,
|
|
|
|
void *(*dup_func)(void *), void (*free_func)(void *), void (*clear_free_func)(void *));
|
|
|
|
/* wrapper functions for the underlying EC_GROUP object */
|
|
|
|
void EC_KEY_set_asn1_flag(EC_KEY *, int);
|
|
|
|
int EC_KEY_precompute_mult(EC_KEY *, BN_CTX *ctx);
|
|
|
|
|
2002-08-07 10:49:54 +00:00
|
|
|
/* EC_KEY_generate_key() creates a ec private (public) key */
|
|
|
|
int EC_KEY_generate_key(EC_KEY *);
|
|
|
|
/* EC_KEY_check_key() */
|
|
|
|
int EC_KEY_check_key(const EC_KEY *);
|
|
|
|
|
2003-02-21 13:58:23 +00:00
|
|
|
/* de- and encoding functions for SEC1 ECPrivateKey */
|
2002-08-07 10:49:54 +00:00
|
|
|
EC_KEY *d2i_ECPrivateKey(EC_KEY **a, const unsigned char **in, long len);
|
|
|
|
int i2d_ECPrivateKey(EC_KEY *a, unsigned char **out);
|
2003-02-21 13:58:23 +00:00
|
|
|
/* de- and encoding functions for EC parameters */
|
2002-08-07 10:49:54 +00:00
|
|
|
EC_KEY *d2i_ECParameters(EC_KEY **a, const unsigned char **in, long len);
|
|
|
|
int i2d_ECParameters(EC_KEY *a, unsigned char **out);
|
2003-02-21 13:58:23 +00:00
|
|
|
/* de- and encoding functions for EC public key
|
|
|
|
* (octet string, not DER -- hence 'o2i' and 'i2o') */
|
|
|
|
EC_KEY *o2i_ECPublicKey(EC_KEY **a, const unsigned char **in, long len);
|
|
|
|
int i2o_ECPublicKey(EC_KEY *a, unsigned char **out);
|
2002-08-07 10:49:54 +00:00
|
|
|
|
|
|
|
#ifndef OPENSSL_NO_BIO
|
|
|
|
int ECParameters_print(BIO *bp, const EC_KEY *x);
|
|
|
|
int EC_KEY_print(BIO *bp, const EC_KEY *x, int off);
|
|
|
|
#endif
|
|
|
|
#ifndef OPENSSL_NO_FP_API
|
|
|
|
int ECParameters_print_fp(FILE *fp, const EC_KEY *x);
|
|
|
|
int EC_KEY_print_fp(FILE *fp, const EC_KEY *x, int off);
|
|
|
|
#endif
|
2002-07-26 08:41:04 +00:00
|
|
|
|
2005-03-31 09:26:39 +00:00
|
|
|
#define ECParameters_dup(x) ASN1_dup_of(EC_KEY,i2d_ECParameters,d2i_ECParameters,x)
|
2002-06-10 12:18:21 +00:00
|
|
|
|
2005-04-12 16:36:36 +00:00
|
|
|
#ifndef __cplusplus
|
|
|
|
#if defined(__SUNPRO_C)
|
|
|
|
# if __SUNPRO_C >= 0x520
|
|
|
|
# pragma error_messages (default,E_ARRAY_OF_INCOMPLETE_NONAME,E_ARRAY_OF_INCOMPLETE)
|
|
|
|
# endif
|
|
|
|
# endif
|
|
|
|
#endif
|
|
|
|
|
2001-03-05 20:13:37 +00:00
|
|
|
/* BEGIN ERROR CODES */
|
|
|
|
/* The following lines are auto generated by the script mkerr.pl. Any changes
|
|
|
|
* made after this point may be overwritten when the script is next run.
|
|
|
|
*/
|
2001-03-08 12:14:25 +00:00
|
|
|
void ERR_load_EC_strings(void);
|
2000-11-26 12:55:19 +00:00
|
|
|
|
2001-03-05 20:13:37 +00:00
|
|
|
/* Error codes for the EC functions. */
|
2000-11-26 12:55:19 +00:00
|
|
|
|
2001-03-05 20:13:37 +00:00
|
|
|
/* Function codes. */
|
2001-11-15 22:32:11 +00:00
|
|
|
#define EC_F_COMPUTE_WNAF 143
|
2002-08-15 09:21:31 +00:00
|
|
|
#define EC_F_D2I_ECPARAMETERS 144
|
|
|
|
#define EC_F_D2I_ECPKPARAMETERS 145
|
|
|
|
#define EC_F_D2I_ECPRIVATEKEY 146
|
|
|
|
#define EC_F_ECPARAMETERS_PRINT 147
|
|
|
|
#define EC_F_ECPARAMETERS_PRINT_FP 148
|
|
|
|
#define EC_F_ECPKPARAMETERS_PRINT 149
|
|
|
|
#define EC_F_ECPKPARAMETERS_PRINT_FP 150
|
2002-10-28 13:23:24 +00:00
|
|
|
#define EC_F_ECP_NIST_MOD_192 203
|
|
|
|
#define EC_F_ECP_NIST_MOD_224 204
|
|
|
|
#define EC_F_ECP_NIST_MOD_256 205
|
|
|
|
#define EC_F_ECP_NIST_MOD_521 206
|
2002-08-15 09:21:31 +00:00
|
|
|
#define EC_F_EC_ASN1_GROUP2CURVE 153
|
|
|
|
#define EC_F_EC_ASN1_GROUP2FIELDID 154
|
|
|
|
#define EC_F_EC_ASN1_GROUP2PARAMETERS 155
|
|
|
|
#define EC_F_EC_ASN1_GROUP2PKPARAMETERS 156
|
2002-06-10 12:18:21 +00:00
|
|
|
#define EC_F_EC_ASN1_PARAMETERS2GROUP 157
|
2002-08-15 09:21:31 +00:00
|
|
|
#define EC_F_EC_ASN1_PKPARAMETERS2GROUP 158
|
2005-04-26 18:53:22 +00:00
|
|
|
#define EC_F_EC_GF2M_MONTGOMERY_POINT_MULTIPLY 208
|
2002-08-15 09:21:31 +00:00
|
|
|
#define EC_F_EC_GF2M_SIMPLE_GROUP_CHECK_DISCRIMINANT 159
|
2002-08-26 18:08:53 +00:00
|
|
|
#define EC_F_EC_GF2M_SIMPLE_GROUP_SET_CURVE 195
|
2002-08-15 09:21:31 +00:00
|
|
|
#define EC_F_EC_GF2M_SIMPLE_OCT2POINT 160
|
|
|
|
#define EC_F_EC_GF2M_SIMPLE_POINT2OCT 161
|
|
|
|
#define EC_F_EC_GF2M_SIMPLE_POINT_GET_AFFINE_COORDINATES 162
|
|
|
|
#define EC_F_EC_GF2M_SIMPLE_POINT_SET_AFFINE_COORDINATES 163
|
|
|
|
#define EC_F_EC_GF2M_SIMPLE_SET_COMPRESSED_COORDINATES 164
|
2001-03-08 20:55:16 +00:00
|
|
|
#define EC_F_EC_GFP_MONT_FIELD_DECODE 133
|
|
|
|
#define EC_F_EC_GFP_MONT_FIELD_ENCODE 134
|
|
|
|
#define EC_F_EC_GFP_MONT_FIELD_MUL 131
|
2005-04-26 18:53:22 +00:00
|
|
|
#define EC_F_EC_GFP_MONT_FIELD_SET_TO_ONE 209
|
2001-03-08 20:55:16 +00:00
|
|
|
#define EC_F_EC_GFP_MONT_FIELD_SQR 132
|
2005-04-26 18:53:22 +00:00
|
|
|
#define EC_F_EC_GFP_MONT_GROUP_SET_CURVE 189
|
|
|
|
#define EC_F_EC_GFP_MONT_GROUP_SET_CURVE_GFP 135
|
2002-10-28 13:23:24 +00:00
|
|
|
#define EC_F_EC_GFP_NIST_FIELD_MUL 200
|
|
|
|
#define EC_F_EC_GFP_NIST_FIELD_SQR 201
|
2005-04-26 18:53:22 +00:00
|
|
|
#define EC_F_EC_GFP_NIST_GROUP_SET_CURVE 202
|
2002-08-15 09:21:31 +00:00
|
|
|
#define EC_F_EC_GFP_SIMPLE_GROUP_CHECK_DISCRIMINANT 165
|
|
|
|
#define EC_F_EC_GFP_SIMPLE_GROUP_SET_CURVE 166
|
|
|
|
#define EC_F_EC_GFP_SIMPLE_GROUP_SET_CURVE_GFP 100
|
2001-03-08 12:14:25 +00:00
|
|
|
#define EC_F_EC_GFP_SIMPLE_GROUP_SET_GENERATOR 101
|
|
|
|
#define EC_F_EC_GFP_SIMPLE_MAKE_AFFINE 102
|
|
|
|
#define EC_F_EC_GFP_SIMPLE_OCT2POINT 103
|
|
|
|
#define EC_F_EC_GFP_SIMPLE_POINT2OCT 104
|
2001-03-10 23:18:35 +00:00
|
|
|
#define EC_F_EC_GFP_SIMPLE_POINTS_MAKE_AFFINE 137
|
2002-08-15 09:21:31 +00:00
|
|
|
#define EC_F_EC_GFP_SIMPLE_POINT_GET_AFFINE_COORDINATES 167
|
|
|
|
#define EC_F_EC_GFP_SIMPLE_POINT_GET_AFFINE_COORDINATES_GFP 105
|
|
|
|
#define EC_F_EC_GFP_SIMPLE_POINT_SET_AFFINE_COORDINATES 168
|
|
|
|
#define EC_F_EC_GFP_SIMPLE_POINT_SET_AFFINE_COORDINATES_GFP 128
|
|
|
|
#define EC_F_EC_GFP_SIMPLE_SET_COMPRESSED_COORDINATES 169
|
|
|
|
#define EC_F_EC_GFP_SIMPLE_SET_COMPRESSED_COORDINATES_GFP 129
|
|
|
|
#define EC_F_EC_GROUP_CHECK 170
|
|
|
|
#define EC_F_EC_GROUP_CHECK_DISCRIMINANT 171
|
2001-03-08 12:14:25 +00:00
|
|
|
#define EC_F_EC_GROUP_COPY 106
|
2001-03-10 23:18:35 +00:00
|
|
|
#define EC_F_EC_GROUP_GET0_GENERATOR 139
|
|
|
|
#define EC_F_EC_GROUP_GET_COFACTOR 140
|
2002-08-15 09:21:31 +00:00
|
|
|
#define EC_F_EC_GROUP_GET_CURVE_GF2M 172
|
2001-03-08 19:14:52 +00:00
|
|
|
#define EC_F_EC_GROUP_GET_CURVE_GFP 130
|
2002-08-15 09:21:31 +00:00
|
|
|
#define EC_F_EC_GROUP_GET_DEGREE 173
|
2001-03-10 23:18:35 +00:00
|
|
|
#define EC_F_EC_GROUP_GET_ORDER 141
|
2002-08-26 18:08:53 +00:00
|
|
|
#define EC_F_EC_GROUP_GET_PENTANOMIAL_BASIS 193
|
|
|
|
#define EC_F_EC_GROUP_GET_TRINOMIAL_BASIS 194
|
2002-02-13 17:57:52 +00:00
|
|
|
#define EC_F_EC_GROUP_GROUP2NID 147
|
2001-03-08 12:14:25 +00:00
|
|
|
#define EC_F_EC_GROUP_NEW 108
|
2005-05-10 11:37:47 +00:00
|
|
|
#define EC_F_EC_GROUP_NEW_BY_CURVE_NAME 174
|
2002-08-15 09:21:31 +00:00
|
|
|
#define EC_F_EC_GROUP_NEW_FROM_DATA 175
|
2001-03-12 07:26:23 +00:00
|
|
|
#define EC_F_EC_GROUP_PRECOMPUTE_MULT 142
|
2002-08-02 13:42:24 +00:00
|
|
|
#define EC_F_EC_GROUP_SET_CURVE_GF2M 176
|
2001-03-08 12:14:25 +00:00
|
|
|
#define EC_F_EC_GROUP_SET_CURVE_GFP 109
|
|
|
|
#define EC_F_EC_GROUP_SET_EXTRA_DATA 110
|
|
|
|
#define EC_F_EC_GROUP_SET_GENERATOR 111
|
2002-08-15 09:21:31 +00:00
|
|
|
#define EC_F_EC_KEY_CHECK_KEY 177
|
|
|
|
#define EC_F_EC_KEY_COPY 178
|
|
|
|
#define EC_F_EC_KEY_GENERATE_KEY 179
|
2005-04-26 18:53:22 +00:00
|
|
|
#define EC_F_EC_KEY_NEW 182
|
2002-08-15 09:21:31 +00:00
|
|
|
#define EC_F_EC_KEY_PRINT 180
|
|
|
|
#define EC_F_EC_KEY_PRINT_FP 181
|
2001-03-10 23:18:35 +00:00
|
|
|
#define EC_F_EC_POINTS_MAKE_AFFINE 136
|
|
|
|
#define EC_F_EC_POINTS_MUL 138
|
2001-03-08 12:14:25 +00:00
|
|
|
#define EC_F_EC_POINT_ADD 112
|
|
|
|
#define EC_F_EC_POINT_CMP 113
|
|
|
|
#define EC_F_EC_POINT_COPY 114
|
|
|
|
#define EC_F_EC_POINT_DBL 115
|
2002-08-15 09:21:31 +00:00
|
|
|
#define EC_F_EC_POINT_GET_AFFINE_COORDINATES_GF2M 183
|
2001-03-08 12:14:25 +00:00
|
|
|
#define EC_F_EC_POINT_GET_AFFINE_COORDINATES_GFP 116
|
|
|
|
#define EC_F_EC_POINT_GET_JPROJECTIVE_COORDINATES_GFP 117
|
2005-04-26 18:53:22 +00:00
|
|
|
#define EC_F_EC_POINT_INVERT 210
|
2001-03-08 12:14:25 +00:00
|
|
|
#define EC_F_EC_POINT_IS_AT_INFINITY 118
|
|
|
|
#define EC_F_EC_POINT_IS_ON_CURVE 119
|
|
|
|
#define EC_F_EC_POINT_MAKE_AFFINE 120
|
2002-08-15 09:21:31 +00:00
|
|
|
#define EC_F_EC_POINT_MUL 184
|
2001-03-08 12:14:25 +00:00
|
|
|
#define EC_F_EC_POINT_NEW 121
|
|
|
|
#define EC_F_EC_POINT_OCT2POINT 122
|
|
|
|
#define EC_F_EC_POINT_POINT2OCT 123
|
2002-08-15 09:21:31 +00:00
|
|
|
#define EC_F_EC_POINT_SET_AFFINE_COORDINATES_GF2M 185
|
2001-03-08 12:14:25 +00:00
|
|
|
#define EC_F_EC_POINT_SET_AFFINE_COORDINATES_GFP 124
|
2002-08-15 09:21:31 +00:00
|
|
|
#define EC_F_EC_POINT_SET_COMPRESSED_COORDINATES_GF2M 186
|
2001-03-08 11:16:33 +00:00
|
|
|
#define EC_F_EC_POINT_SET_COMPRESSED_COORDINATES_GFP 125
|
|
|
|
#define EC_F_EC_POINT_SET_JPROJECTIVE_COORDINATES_GFP 126
|
2001-03-08 12:14:25 +00:00
|
|
|
#define EC_F_EC_POINT_SET_TO_INFINITY 127
|
2003-02-06 19:25:12 +00:00
|
|
|
#define EC_F_EC_PRE_COMP_DUP 207
|
2002-08-15 09:21:31 +00:00
|
|
|
#define EC_F_EC_WNAF_MUL 187
|
|
|
|
#define EC_F_EC_WNAF_PRECOMPUTE_MULT 188
|
|
|
|
#define EC_F_I2D_ECPARAMETERS 190
|
|
|
|
#define EC_F_I2D_ECPKPARAMETERS 191
|
|
|
|
#define EC_F_I2D_ECPRIVATEKEY 192
|
2003-02-21 13:58:23 +00:00
|
|
|
#define EC_F_I2O_ECPUBLICKEY 151
|
|
|
|
#define EC_F_O2I_ECPUBLICKEY 152
|
2000-11-26 12:55:19 +00:00
|
|
|
|
2001-03-05 20:13:37 +00:00
|
|
|
/* Reason codes. */
|
2002-08-15 09:21:31 +00:00
|
|
|
#define EC_R_ASN1_ERROR 115
|
|
|
|
#define EC_R_ASN1_UNKNOWN_FIELD 116
|
2001-03-08 01:23:28 +00:00
|
|
|
#define EC_R_BUFFER_TOO_SMALL 100
|
2002-08-15 09:21:31 +00:00
|
|
|
#define EC_R_D2I_ECPKPARAMETERS_FAILURE 117
|
2002-03-18 13:10:45 +00:00
|
|
|
#define EC_R_DISCRIMINANT_IS_ZERO 118
|
2002-08-15 09:21:31 +00:00
|
|
|
#define EC_R_EC_GROUP_NEW_BY_NAME_FAILURE 119
|
|
|
|
#define EC_R_GROUP2PKPARAMETERS_FAILURE 120
|
|
|
|
#define EC_R_I2D_ECPKPARAMETERS_FAILURE 121
|
2001-03-08 01:23:28 +00:00
|
|
|
#define EC_R_INCOMPATIBLE_OBJECTS 101
|
2001-03-10 23:18:35 +00:00
|
|
|
#define EC_R_INVALID_ARGUMENT 112
|
2001-03-08 19:14:52 +00:00
|
|
|
#define EC_R_INVALID_COMPRESSED_POINT 110
|
|
|
|
#define EC_R_INVALID_COMPRESSION_BIT 109
|
2001-03-08 01:23:28 +00:00
|
|
|
#define EC_R_INVALID_ENCODING 102
|
2001-03-08 12:14:25 +00:00
|
|
|
#define EC_R_INVALID_FIELD 103
|
|
|
|
#define EC_R_INVALID_FORM 104
|
2002-08-15 09:21:31 +00:00
|
|
|
#define EC_R_INVALID_GROUP_ORDER 122
|
|
|
|
#define EC_R_INVALID_PRIVATE_KEY 123
|
|
|
|
#define EC_R_MISSING_PARAMETERS 124
|
|
|
|
#define EC_R_MISSING_PRIVATE_KEY 125
|
2003-02-06 19:25:12 +00:00
|
|
|
#define EC_R_NOT_A_NIST_PRIME 135
|
|
|
|
#define EC_R_NOT_A_SUPPORTED_NIST_PRIME 136
|
2002-08-15 09:21:31 +00:00
|
|
|
#define EC_R_NOT_IMPLEMENTED 126
|
2001-03-08 20:55:16 +00:00
|
|
|
#define EC_R_NOT_INITIALIZED 111
|
2002-10-28 13:23:24 +00:00
|
|
|
#define EC_R_NO_FIELD_MOD 133
|
|
|
|
#define EC_R_PASSED_NULL_PARAMETER 134
|
2002-08-15 09:21:31 +00:00
|
|
|
#define EC_R_PKPARAMETERS2GROUP_FAILURE 127
|
2001-03-08 12:14:25 +00:00
|
|
|
#define EC_R_POINT_AT_INFINITY 106
|
|
|
|
#define EC_R_POINT_IS_NOT_ON_CURVE 107
|
|
|
|
#define EC_R_SLOT_FULL 108
|
2001-03-10 23:37:52 +00:00
|
|
|
#define EC_R_UNDEFINED_GENERATOR 113
|
2002-08-15 09:21:31 +00:00
|
|
|
#define EC_R_UNDEFINED_ORDER 128
|
|
|
|
#define EC_R_UNKNOWN_GROUP 129
|
2001-03-11 12:27:24 +00:00
|
|
|
#define EC_R_UNKNOWN_ORDER 114
|
2002-08-26 18:08:53 +00:00
|
|
|
#define EC_R_UNSUPPORTED_FIELD 131
|
2002-08-15 09:21:31 +00:00
|
|
|
#define EC_R_WRONG_ORDER 130
|
2000-11-26 12:55:19 +00:00
|
|
|
|
2001-03-05 20:13:37 +00:00
|
|
|
#ifdef __cplusplus
|
|
|
|
}
|
|
|
|
#endif
|
2000-11-26 18:31:32 +00:00
|
|
|
#endif
|