crypto/ec/ec.h

   1 /* crypto/ec/ec.h */
   2 /*
   3  * Originally written by Bodo Moeller for the OpenSSL project.
   4  */
   5 /* ====================================================================
   6  * Copyright (c) 1998-2002 The OpenSSL Project.  All rights reserved.
   7  *
   8  * Redistribution and use in source and binary forms, with or without
   9  * modification, are permitted provided that the following conditions
  10  * are met:
  11  *
  12  * 1. Redistributions of source code must retain the above copyright
  13  *    notice, this list of conditions and the following disclaimer.
  14  *
  15  * 2. Redistributions in binary form must reproduce the above copyright
  16  *    notice, this list of conditions and the following disclaimer in
  17  *    the documentation and/or other materials provided with the
  18  *    distribution.
  19  *
  20  * 3. All advertising materials mentioning features or use of this
  21  *    software must display the following acknowledgment:
  22  *    "This product includes software developed by the OpenSSL Project
  23  *    for use in the OpenSSL Toolkit. (http://www.openssl.org/)"
  24  *
  25  * 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
  26  *    endorse or promote products derived from this software without
  27  *    prior written permission. For written permission, please contact
  28  *    openssl-core@openssl.org.
  29  *
  30  * 5. Products derived from this software may not be called "OpenSSL"
  31  *    nor may "OpenSSL" appear in their names without prior written
  32  *    permission of the OpenSSL Project.
  33  *
  34  * 6. Redistributions of any form whatsoever must retain the following
  35  *    acknowledgment:
  36  *    "This product includes software developed by the OpenSSL Project
  37  *    for use in the OpenSSL Toolkit (http://www.openssl.org/)"
  38  *
  39  * THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY
  40  * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  41  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  42  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE OpenSSL PROJECT OR
  43  * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  44  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  45  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
  46  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  47  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
  48  * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  49  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
  50  * OF THE POSSIBILITY OF SUCH DAMAGE.
  51  * ====================================================================
  52  *
  53  * This product includes cryptographic software written by Eric Young
  54  * (eay@cryptsoft.com).  This product includes software written by Tim
  55  * Hudson (tjh@cryptsoft.com).
  56  *
  57  */
  58 /* ====================================================================
  59  * Copyright 2002 Sun Microsystems, Inc. ALL RIGHTS RESERVED.
  60  *
  61  * Portions of the attached software ("Contribution") are developed by
  62  * SUN MICROSYSTEMS, INC., and are contributed to the OpenSSL project.
  63  *
  64  * The Contribution is licensed pursuant to the OpenSSL open source
  65  * license provided above.
  66  *
  67  * In addition, Sun covenants to all licensees who provide a reciprocal
  68  * covenant with respect to their own patents if any, not to sue under
  69  * current and future patent claims necessarily infringed by the making,
  70  * using, practicing, selling, offering for sale and/or otherwise
  71  * disposing of the Contribution as delivered hereunder
  72  * (or portions thereof), provided that such covenant shall not apply:
  73  *  1) for code that a licensee deletes from the Contribution;
  74  *  2) separates from the Contribution; or
  75  *  3) for infringements caused by:
  76  *       i) the modification of the Contribution or
  77  *      ii) the combination of the Contribution with other software or
  78  *          devices where such combination causes the infringement.
  79  *
  80  * The elliptic curve binary polynomial software is originally written by
  81  * Sheueling Chang Shantz and Douglas Stebila of Sun Microsystems Laboratories.
  82  *
  83  */
  84
  85 #ifndef HEADER_EC_H
  86 #define HEADER_EC_H
  87
  88 #ifdef OPENSSL_NO_EC
  89 #error EC is disabled.
  90 #endif
  91
  92 #include <openssl/bn.h>
  93 #include <openssl/asn1.h>
  94 #include <openssl/symhacks.h>
  95
  96 #ifdef  __cplusplus
  97 extern "C" {
  98 #endif
  99
 100
 101 typedef enum {
 102         /* values as defined in X9.62 (ECDSA) and elsewhere */
 103         POINT_CONVERSION_COMPRESSED = 2,
 104         POINT_CONVERSION_UNCOMPRESSED = 4,
 105         POINT_CONVERSION_HYBRID = 6
 106 } point_conversion_form_t;
 107
 108
 109 typedef struct ec_method_st EC_METHOD;
 110
 111 typedef struct ec_group_st
 112         /*
 113          EC_METHOD *meth;
 114          -- field definition
 115          -- curve coefficients
 116          -- optional generator with associated information (order, cofactor)
 117          -- optional extra data (TODO: precomputed table for fast computation of multiples of generator)
 118          -- ASN1 stuff
 119         */
 120         EC_GROUP;
 121
 122 typedef struct ec_point_st EC_POINT;
 123
 124
 125 /* EC_METHODs for curves over GF(p).
 126  * EC_GFp_simple_method provides the basis for the optimized methods.
 127  */
 128 const EC_METHOD *EC_GFp_simple_method(void);
 129 const EC_METHOD *EC_GFp_mont_method(void);
 130 #if 0
 131 const EC_METHOD *EC_GFp_recp_method(void); /* TODO */
 132 const EC_METHOD *EC_GFp_nist_method(void); /* TODO */
 133 #endif
 134
 135 /* EC_METHOD for curves over GF(2^m).
 136  */
 137 const EC_METHOD *EC_GF2m_simple_method(void);
 138
 139
 140 EC_GROUP *EC_GROUP_new(const EC_METHOD *);
 141 void EC_GROUP_free(EC_GROUP *);
 142 void EC_GROUP_clear_free(EC_GROUP *);
 143 int EC_GROUP_copy(EC_GROUP *, const EC_GROUP *);
 144 EC_GROUP *EC_GROUP_dup(const EC_GROUP *);
 145
 146 const EC_METHOD *EC_GROUP_method_of(const EC_GROUP *);
 147 int EC_METHOD_get_field_type(const EC_METHOD *);
 148
 149 int EC_GROUP_set_generator(EC_GROUP *, const EC_POINT *generator, const BIGNUM *order, const BIGNUM *cofactor);
 150 EC_POINT *EC_GROUP_get0_generator(const EC_GROUP *);
 151 int EC_GROUP_get_order(const EC_GROUP *, BIGNUM *order, BN_CTX *);
 152 int EC_GROUP_get_cofactor(const EC_GROUP *, BIGNUM *cofactor, BN_CTX *);
 153
 154 void EC_GROUP_set_nid(EC_GROUP *, int); /* curve name */
 155 int EC_GROUP_get_nid(const EC_GROUP *);
 156
 157 void EC_GROUP_set_asn1_flag(EC_GROUP *, int flag);
 158 int EC_GROUP_get_asn1_flag(const EC_GROUP *);
 159
 160 void EC_GROUP_set_point_conversion_form(EC_GROUP *, point_conversion_form_t);
 161 point_conversion_form_t EC_GROUP_get_point_conversion_form(const EC_GROUP *);
 162
 163 unsigned char *EC_GROUP_get0_seed(const EC_GROUP *);
 164 size_t EC_GROUP_get_seed_len(const EC_GROUP *);
 165 size_t EC_GROUP_set_seed(EC_GROUP *, const unsigned char *, size_t len);
 166
 167 int EC_GROUP_set_curve_GFp(EC_GROUP *, const BIGNUM *p, const BIGNUM *a, const BIGNUM *b, BN_CTX *);
 168 int EC_GROUP_get_curve_GFp(const EC_GROUP *, BIGNUM *p, BIGNUM *a, BIGNUM *b, BN_CTX *);
 169 int EC_GROUP_set_curve_GF2m(EC_GROUP *, const BIGNUM *p, const BIGNUM *a, const BIGNUM *b, BN_CTX *);
 170 int EC_GROUP_get_curve_GF2m(const EC_GROUP *, BIGNUM *p, BIGNUM *a, BIGNUM *b, BN_CTX *);
 171
 172 int EC_GROUP_get_degree(const EC_GROUP *);
 173
 174 /* EC_GROUP_check() returns 1 if 'group' defines a valid group, 0 otherwise */
 175 int EC_GROUP_check(const EC_GROUP *group, BN_CTX *ctx);
 176 /* EC_GROUP_check_discriminant() returns 1 if the discriminant of the
 177  * elliptic curve is not zero, 0 otherwise */
 178 int EC_GROUP_check_discriminant(const EC_GROUP *, BN_CTX *);
 179
 180 /* EC_GROUP_new_GF*() calls EC_GROUP_new() and EC_GROUP_set_GF*()
 181  * after choosing an appropriate EC_METHOD */
 182 EC_GROUP *EC_GROUP_new_curve_GFp(const BIGNUM *p, const BIGNUM *a, const BIGNUM *b, BN_CTX *);
 183 EC_GROUP *EC_GROUP_new_curve_GF2m(const BIGNUM *p, const BIGNUM *a, const BIGNUM *b, BN_CTX *);
 184
 185 /* EC_GROUP_new_by_nid() and EC_GROUP_new_by_name() also set
 186  * generator and order */
 187 EC_GROUP *EC_GROUP_new_by_nid(int nid);
 188 EC_GROUP *EC_GROUP_new_by_name(int name);
 189 /* Currently valid arguments to EC_GROUP_new_by_name() */
 190 #define EC_GROUP_NO_CURVE               0
 191 #define EC_GROUP_NIST_PRIME_192         NID_X9_62_prime192v1
 192 #define EC_GROUP_NIST_PRIME_224         NID_secp224r1
 193 #define EC_GROUP_NIST_PRIME_256         NID_X9_62_prime256v1
 194 #define EC_GROUP_NIST_PRIME_384         NID_secp384r1
 195 #define EC_GROUP_NIST_PRIME_521         NID_secp521r1
 196 #define EC_GROUP_X9_62_PRIME_192V1      NID_X9_62_prime192v1
 197 #define EC_GROUP_X9_62_PRIME_192V2      NID_X9_62_prime192v2
 198 #define EC_GROUP_X9_62_PRIME_192V3      NID_X9_62_prime192v3
 199 #define EC_GROUP_X9_62_PRIME_239V1      NID_X9_62_prime239v1
 200 #define EC_GROUP_X9_62_PRIME_239V2      NID_X9_62_prime239v2
 201 #define EC_GROUP_X9_62_PRIME_239V3      NID_X9_62_prime239v3
 202 #define EC_GROUP_X9_62_PRIME_256V1      NID_X9_62_prime256v1
 203 #define EC_GROUP_SECG_PRIME_112R1       NID_secp112r1
 204 #define EC_GROUP_SECG_PRIME_112R2       NID_secp112r2
 205 #define EC_GROUP_SECG_PRIME_128R1       NID_secp128r1
 206 #define EC_GROUP_SECG_PRIME_128R2       NID_secp128r2
 207 #define EC_GROUP_SECG_PRIME_160K1       NID_secp160k1
 208 #define EC_GROUP_SECG_PRIME_160R1       NID_secp160r1
 209 #define EC_GROUP_SECG_PRIME_160R2       NID_secp160r2
 210 #define EC_GROUP_SECG_PRIME_192K1       NID_secp192k1
 211 #define EC_GROUP_SECG_PRIME_192R1       NID_X9_62_prime192v1
 212 #define EC_GROUP_SECG_PRIME_224K1       NID_secp224k1
 213 #define EC_GROUP_SECG_PRIME_224R1       NID_secp224r1
 214 #define EC_GROUP_SECG_PRIME_256K1       NID_secp256k1
 215 #define EC_GROUP_SECG_PRIME_256R1       NID_X9_62_prime256v1
 216 #define EC_GROUP_SECG_PRIME_384R1       NID_secp384r1
 217 #define EC_GROUP_SECG_PRIME_521R1       NID_secp521r1
 218 #define EC_GROUP_WTLS_6                 NID_wap_wsg_idm_ecid_wtls6
 219 #define EC_GROUP_WTLS_7                 NID_wap_wsg_idm_ecid_wtls7
 220 #define EC_GROUP_WTLS_8                 NID_wap_wsg_idm_ecid_wtls8
 221 #define EC_GROUP_WTLS_9                 NID_wap_wsg_idm_ecid_wtls9
 222 #define EC_GROUP_WTLS_12                NID_wap_wsg_idm_ecid_wtls12
 223 #define EC_GROUP_NIST_CHAR2_K163        NID_sect163k1
 224 #define EC_GROUP_NIST_CHAR2_B163        NID_sect163r2
 225 #define EC_GROUP_NIST_CHAR2_K233        NID_sect233k1
 226 #define EC_GROUP_NIST_CHAR2_B233        NID_sect233r1
 227 #define EC_GROUP_NIST_CHAR2_K283        NID_sect283k1
 228 #define EC_GROUP_NIST_CHAR2_B283        NID_sect283r1
 229 #define EC_GROUP_NIST_CHAR2_K409        NID_sect409k1
 230 #define EC_GROUP_NIST_CHAR2_B409        NID_sect409r1
 231 #define EC_GROUP_NIST_CHAR2_K571        NID_sect571k1
 232 #define EC_GROUP_NIST_CHAR2_B571        NID_sect571r1
 233 #define EC_GROUP_X9_62_CHAR2_163V1      NID_X9_62_c2pnb163v1
 234 #define EC_GROUP_X9_62_CHAR2_163V2      NID_X9_62_c2pnb163v2
 235 #define EC_GROUP_X9_62_CHAR2_163V3      NID_X9_62_c2pnb163v3
 236 #define EC_GROUP_X9_62_CHAR2_176V1      NID_X9_62_c2pnb176v1
 237 #define EC_GROUP_X9_62_CHAR2_191V1      NID_X9_62_c2tnb191v1
 238 #define EC_GROUP_X9_62_CHAR2_191V2      NID_X9_62_c2tnb191v2
 239 #define EC_GROUP_X9_62_CHAR2_191V3      NID_X9_62_c2tnb191v3
 240 #define EC_GROUP_X9_62_CHAR2_208W1      NID_X9_62_c2pnb208w1
 241 #define EC_GROUP_X9_62_CHAR2_239V1      NID_X9_62_c2tnb239v1
 242 #define EC_GROUP_X9_62_CHAR2_239V2      NID_X9_62_c2tnb239v2
 243 #define EC_GROUP_X9_62_CHAR2_239V3      NID_X9_62_c2tnb239v3
 244 #define EC_GROUP_X9_62_CHAR2_272W1      NID_X9_62_c2pnb272w1
 245 #define EC_GROUP_X9_62_CHAR2_304W1      NID_X9_62_c2pnb304w1
 246 #define EC_GROUP_X9_62_CHAR2_359V1      NID_X9_62_c2tnb359v1
 247 #define EC_GROUP_X9_62_CHAR2_368W1      NID_X9_62_c2pnb368w1
 248 #define EC_GROUP_X9_62_CHAR2_431R1      NID_X9_62_c2tnb431r1
 249 #define EC_GROUP_SECG_CHAR2_113R1       NID_sect113r1
 250 #define EC_GROUP_SECG_CHAR2_113R2       NID_sect113r2
 251 #define EC_GROUP_SECG_CHAR2_131R1       NID_sect131r1
 252 #define EC_GROUP_SECG_CHAR2_131R2       NID_sect131r2
 253 #define EC_GROUP_SECG_CHAR2_163K1       NID_sect163k1
 254 #define EC_GROUP_SECG_CHAR2_163R1       NID_sect163r1
 255 #define EC_GROUP_SECG_CHAR2_163R2       NID_sect163r2
 256 #define EC_GROUP_SECG_CHAR2_193R1       NID_sect193r1
 257 #define EC_GROUP_SECG_CHAR2_193R2       NID_sect193r2
 258 #define EC_GROUP_SECG_CHAR2_233K1       NID_sect233k1
 259 #define EC_GROUP_SECG_CHAR2_233R1       NID_sect233r1
 260 #define EC_GROUP_SECG_CHAR2_239K1       NID_sect239k1
 261 #define EC_GROUP_SECG_CHAR2_283K1       NID_sect283k1
 262 #define EC_GROUP_SECG_CHAR2_283R1       NID_sect283r1
 263 #define EC_GROUP_SECG_CHAR2_409K1       NID_sect409k1
 264 #define EC_GROUP_SECG_CHAR2_409R1       NID_sect409r1
 265 #define EC_GROUP_SECG_CHAR2_571K1       NID_sect571k1
 266 #define EC_GROUP_SECG_CHAR2_571R1       NID_sect571r1
 267 #define EC_GROUP_WTLS_1                 NID_wap_wsg_idm_ecid_wtls1
 268 #define EC_GROUP_WTLS_3                 NID_wap_wsg_idm_ecid_wtls3
 269 #define EC_GROUP_WTLS_4                 NID_wap_wsg_idm_ecid_wtls4
 270 #define EC_GROUP_WTLS_5                 NID_wap_wsg_idm_ecid_wtls5
 271 #define EC_GROUP_WTLS_10                NID_wap_wsg_idm_ecid_wtls10
 272 #define EC_GROUP_WTLS_11                NID_wap_wsg_idm_ecid_wtls11
 273
 274 EC_POINT *EC_POINT_new(const EC_GROUP *);
 275 void EC_POINT_free(EC_POINT *);
 276 void EC_POINT_clear_free(EC_POINT *);
 277 int EC_POINT_copy(EC_POINT *, const EC_POINT *);
 278 EC_POINT *EC_POINT_dup(const EC_POINT *, const EC_GROUP *);
 279
 280 const EC_METHOD *EC_POINT_method_of(const EC_POINT *);
 281
 282 int EC_POINT_set_to_infinity(const EC_GROUP *, EC_POINT *);
 283 int EC_POINT_set_Jprojective_coordinates_GFp(const EC_GROUP *, EC_POINT *,
 284         const BIGNUM *x, const BIGNUM *y, const BIGNUM *z, BN_CTX *);
 285 int EC_POINT_get_Jprojective_coordinates_GFp(const EC_GROUP *, const EC_POINT *,
 286         BIGNUM *x, BIGNUM *y, BIGNUM *z, BN_CTX *);
 287 int EC_POINT_set_affine_coordinates_GFp(const EC_GROUP *, EC_POINT *,
 288         const BIGNUM *x, const BIGNUM *y, BN_CTX *);
 289 int EC_POINT_get_affine_coordinates_GFp(const EC_GROUP *, const EC_POINT *,
 290         BIGNUM *x, BIGNUM *y, BN_CTX *);
 291 int EC_POINT_set_compressed_coordinates_GFp(const EC_GROUP *, EC_POINT *,
 292         const BIGNUM *x, int y_bit, BN_CTX *);
 293
 294 int EC_POINT_set_affine_coordinates_GF2m(const EC_GROUP *, EC_POINT *,
 295         const BIGNUM *x, const BIGNUM *y, BN_CTX *);
 296 int EC_POINT_get_affine_coordinates_GF2m(const EC_GROUP *, const EC_POINT *,
 297         BIGNUM *x, BIGNUM *y, BN_CTX *);
 298 int EC_POINT_set_compressed_coordinates_GF2m(const EC_GROUP *, EC_POINT *,
 299         const BIGNUM *x, int y_bit, BN_CTX *);
 300
 301 size_t EC_POINT_point2oct(const EC_GROUP *, const EC_POINT *, point_conversion_form_t form,
 302         unsigned char *buf, size_t len, BN_CTX *);
 303 int EC_POINT_oct2point(const EC_GROUP *, EC_POINT *,
 304         const unsigned char *buf, size_t len, BN_CTX *);
 305
 306 /* other interfaces to point2oct/oct2point: */
 307 BIGNUM *EC_POINT_point2bn(const EC_GROUP *, const EC_POINT *,
 308         point_conversion_form_t form, BIGNUM *, BN_CTX *);
 309 EC_POINT *EC_POINT_bn2point(const EC_GROUP *, const BIGNUM *,
 310         EC_POINT *, BN_CTX *);
 311 char *EC_POINT_point2hex(const EC_GROUP *, const EC_POINT *,
 312         point_conversion_form_t form, BN_CTX *);
 313 EC_POINT *EC_POINT_hex2point(const EC_GROUP *, const char *,
 314         EC_POINT *, BN_CTX *);
 315
 316 int EC_POINT_add(const EC_GROUP *, EC_POINT *r, const EC_POINT *a, const EC_POINT *b, BN_CTX *);
 317 int EC_POINT_dbl(const EC_GROUP *, EC_POINT *r, const EC_POINT *a, BN_CTX *);
 318 int EC_POINT_invert(const EC_GROUP *, EC_POINT *, BN_CTX *);
 319
 320 int EC_POINT_is_at_infinity(const EC_GROUP *, const EC_POINT *);
 321 int EC_POINT_is_on_curve(const EC_GROUP *, const EC_POINT *, BN_CTX *);
 322 int EC_POINT_cmp(const EC_GROUP *, const EC_POINT *a, const EC_POINT *b, BN_CTX *);
 323
 324 int EC_POINT_make_affine(const EC_GROUP *, EC_POINT *, BN_CTX *);
 325 int EC_POINTs_make_affine(const EC_GROUP *, size_t num, EC_POINT *[], BN_CTX *);
 326
 327
 328 int EC_POINTs_mul(const EC_GROUP *, EC_POINT *r, const BIGNUM *, size_t num, const EC_POINT *[], const BIGNUM *[], BN_CTX *);
 329 int EC_POINT_mul(const EC_GROUP *, EC_POINT *r, const BIGNUM *, const EC_POINT *, const BIGNUM *, BN_CTX *);
 330 int EC_GROUP_precompute_mult(EC_GROUP *, BN_CTX *);
 331
 332
 333
 334 /* ASN1 stuff */
 335 #define OPENSSL_EC_NAMED_CURVE  0x001
 336
 337 typedef struct ecpk_parameters_st ECPKPARAMETERS;
 338
 339 EC_GROUP *d2i_ECPKParameters(EC_GROUP **, const unsigned char **in, long len);
 340 int i2d_ECPKParameters(const EC_GROUP *, unsigned char **out);
 341
 342 #define d2i_ECPKParameters_bio(bp,x) (EC_GROUP *)ASN1_d2i_bio(NULL, \
 343                 (char *(*)())d2i_ECPKParameters,(bp),(unsigned char **)(x))
 344 #define i2d_ECPKParameters_bio(bp,x) ASN1_i2d_bio(i2d_ECPKParameters,(bp), \
 345                 (unsigned char *)(x))
 346 #define d2i_ECPKParameters_fp(fp,x) (EC_GROUP *)ASN1_d2i_fp(NULL, \
 347                 (char *(*)())d2i_ECPKParameters,(fp),(unsigned char **)(x))
 348 #define i2d_ECPKParameters_fp(fp,x) ASN1_i2d_fp(i2d_ECPKParameters,(fp), \
 349                 (unsigned char *)(x))
 350
 351 #ifndef OPENSSL_NO_BIO
 352 int     ECPKParameters_print(BIO *bp, const EC_GROUP *x, int off);
 353 #endif
 354 #ifndef OPENSSL_NO_FP_API
 355 int     ECPKParameters_print_fp(FILE *fp, const EC_GROUP *x, int off);
 356 #endif
 357
 358 /* the EC_KEY stuff */
 359 typedef struct ec_key_st EC_KEY;
 360
 361 typedef struct ec_key_meth_data_st {
 362         int (*init)(EC_KEY *);
 363         void (*finish)(EC_KEY *);
 364         } EC_KEY_METH_DATA;
 365
 366 struct ec_key_st {
 367         int version;
 368
 369         EC_GROUP *group;
 370
 371         EC_POINT *pub_key;
 372         BIGNUM   *priv_key;
 373
 374         unsigned int enc_flag;
 375         point_conversion_form_t conv_form;
 376
 377         int     references;
 378
 379         EC_KEY_METH_DATA *meth_data;
 380         }/* EC_KEY */;
 381 /* some values for the encoding_flag */
 382 #define EC_PKEY_NO_PARAMETERS   0x001
 383 #define EC_PKEY_NO_PUBKEY       0x002
 384
 385 EC_KEY *EC_KEY_new(void);
 386 void EC_KEY_free(EC_KEY *);
 387 EC_KEY *EC_KEY_copy(EC_KEY *, const EC_KEY *);
 388 EC_KEY *EC_KEY_dup(const EC_KEY *);
 389
 390 /* EC_KEY_generate_key() creates a ec private (public) key */
 391 int EC_KEY_generate_key(EC_KEY *);
 392 /* EC_KEY_check_key() */
 393 int EC_KEY_check_key(const EC_KEY *);
 394
 395 /* de- and encode functions for the SEC1 ECPrivateKey */
 396 EC_KEY *d2i_ECPrivateKey(EC_KEY **a, const unsigned char **in, long len);
 397 int i2d_ECPrivateKey(EC_KEY *a, unsigned char **out);
 398 /* de- and encode functions for the elliptic curve parameters */
 399 EC_KEY *d2i_ECParameters(EC_KEY **a, const unsigned char **in, long len);
 400 int i2d_ECParameters(EC_KEY *a, unsigned char **out);
 401
 402 EC_KEY *ECPublicKey_set_octet_string(EC_KEY **a, const unsigned char **in,
 403                                         long len);
 404 int ECPublicKey_get_octet_string(EC_KEY *a, unsigned char **out);
 405
 406 #ifndef OPENSSL_NO_BIO
 407 int     ECParameters_print(BIO *bp, const EC_KEY *x);
 408 int     EC_KEY_print(BIO *bp, const EC_KEY *x, int off);
 409 #endif
 410 #ifndef OPENSSL_NO_FP_API
 411 int     ECParameters_print_fp(FILE *fp, const EC_KEY *x);
 412 int     EC_KEY_print_fp(FILE *fp, const EC_KEY *x, int off);
 413 #endif
 414
 415 #define ECParameters_dup(x) (EC_KEY *)ASN1_dup((int (*)())i2d_ECParameters,\
 416                 (char *(*)())d2i_ECParameters,(char *)(x))
 417
 418 /* BEGIN ERROR CODES */
 419 /* The following lines are auto generated by the script mkerr.pl. Any changes
 420  * made after this point may be overwritten when the script is next run.
 421  */
 422 void ERR_load_EC_strings(void);
 423
 424 /* Error codes for the EC functions. */
 425
 426 /* Function codes. */
 427 #define EC_F_COMPUTE_WNAF                                143
 428 #define EC_F_D2I_ECPARAMETERS                            155
 429 #define EC_F_D2I_ECPKPARAMETERS                          161
 430 #define EC_F_D2I_ECPRIVATEKEY                            168
 431 #define EC_F_ECPARAMETERS_PRINT                          173
 432 #define EC_F_ECPARAMETERS_PRINT_FP                       174
 433 #define EC_F_ECPKPARAMETERS_PRINT                        166
 434 #define EC_F_ECPKPARAMETERS_PRINT_FP                     167
 435 #define EC_F_ECPUBLICKEY_GET_OCTET                       170
 436 #define EC_F_ECPUBLICKEY_SET_OCTET                       171
 437 #define EC_F_EC_ASN1_GROUP2CURVE                         159
 438 #define EC_F_EC_ASN1_GROUP2FIELDID                       156
 439 #define EC_F_EC_ASN1_GROUP2PARAMETERS                    160
 440 #define EC_F_EC_ASN1_GROUP2PKPARAMETERS                  162
 441 #define EC_F_EC_ASN1_PARAMETERS2GROUP                    157
 442 #define EC_F_EC_ASN1_PKPARAMETERS2GROUP                  163
 443 #define EC_F_EC_GF2M_SIMPLE_GROUP_CHECK_DISCRIMINANT     168
 444 #define EC_F_EC_GF2M_SIMPLE_OCT2POINT                    169
 445 #define EC_F_EC_GF2M_SIMPLE_POINT2OCT                    170
 446 #define EC_F_EC_GF2M_SIMPLE_POINT_GET_AFFINE_COORDINATES 171
 447 #define EC_F_EC_GF2M_SIMPLE_POINT_SET_AFFINE_COORDINATES 172
 448 #define EC_F_EC_GF2M_SIMPLE_SET_COMPRESSED_COORDINATES   182
 449 #define EC_F_EC_GFP_MONT_FIELD_DECODE                    133
 450 #define EC_F_EC_GFP_MONT_FIELD_ENCODE                    134
 451 #define EC_F_EC_GFP_MONT_FIELD_MUL                       131
 452 #define EC_F_EC_GFP_MONT_FIELD_SQR                       132
 453 #define EC_F_EC_GFP_SIMPLE_GROUP_CHECK_DISCRIMINANT      152
 454 #define EC_F_EC_GFP_SIMPLE_GROUP_SET_CURVE               100
 455 #define EC_F_EC_GFP_SIMPLE_GROUP_SET_GENERATOR           101
 456 #define EC_F_EC_GFP_SIMPLE_MAKE_AFFINE                   102
 457 #define EC_F_EC_GFP_SIMPLE_OCT2POINT                     103
 458 #define EC_F_EC_GFP_SIMPLE_POINT2OCT                     104
 459 #define EC_F_EC_GFP_SIMPLE_POINTS_MAKE_AFFINE            137
 460 #define EC_F_EC_GFP_SIMPLE_POINT_GET_AFFINE_COORDINATES  105
 461 #define EC_F_EC_GFP_SIMPLE_POINT_SET_AFFINE_COORDINATES  128
 462 #define EC_F_EC_GFP_SIMPLE_SET_COMPRESSED_COORDINATES    129
 463 #define EC_F_EC_GROUP_CHECK                              150
 464 #define EC_F_EC_GROUP_CHECK_DISCRIMINANT                 153
 465 #define EC_F_EC_GROUP_COPY                               106
 466 #define EC_F_EC_GROUP_GET0_GENERATOR                     139
 467 #define EC_F_EC_GROUP_GET_COFACTOR                       140
 468 #define EC_F_EC_GROUP_GET_CURVE_GF2M                     173
 469 #define EC_F_EC_GROUP_GET_CURVE_GFP                      130
 470 #define EC_F_EC_GROUP_GET_DEGREE                         174
 471 #define EC_F_EC_GROUP_GET_EXTRA_DATA                     107
 472 #define EC_F_EC_GROUP_GET_ORDER                          141
 473 #define EC_F_EC_GROUP_GROUP2NID                          147
 474 #define EC_F_EC_GROUP_NEW                                108
 475 #define EC_F_EC_GROUP_NEW_BY_NAME                        144
 476 #define EC_F_EC_GROUP_NEW_BY_NID                         146
 477 #define EC_F_EC_GROUP_NEW_GF2M_FROM_HEX                  175
 478 #define EC_F_EC_GROUP_NEW_GFP_FROM_HEX                   148
 479 #define EC_F_EC_GROUP_PRECOMPUTE_MULT                    142
 480 #define EC_F_EC_GROUP_SET_CURVE_GF2M                     176
 481 #define EC_F_EC_GROUP_SET_CURVE_GFP                      109
 482 #define EC_F_EC_GROUP_SET_EXTRA_DATA                     110
 483 #define EC_F_EC_GROUP_SET_GENERATOR                      111
 484 #define EC_F_EC_KEY_CHECK_KEY                            184
 485 #define EC_F_EC_KEY_COPY                                 186
 486 #define EC_F_EC_KEY_GENERATE_KEY                         185
 487 #define EC_F_EC_KEY_PRINT                                175
 488 #define EC_F_EC_KEY_PRINT_FP                             176
 489 #define EC_F_EC_NEW                                      172
 490 #define EC_F_EC_POINTS_MAKE_AFFINE                       136
 491 #define EC_F_EC_POINTS_MUL                               138
 492 #define EC_F_EC_POINT_ADD                                112
 493 #define EC_F_EC_POINT_CMP                                113
 494 #define EC_F_EC_POINT_COPY                               114
 495 #define EC_F_EC_POINT_DBL                                115
 496 #define EC_F_EC_POINT_GET_AFFINE_COORDINATES_GF2M        177
 497 #define EC_F_EC_POINT_GET_AFFINE_COORDINATES_GFP         116
 498 #define EC_F_EC_POINT_GET_JPROJECTIVE_COORDINATES_GFP    117
 499 #define EC_F_EC_POINT_IS_AT_INFINITY                     118
 500 #define EC_F_EC_POINT_IS_ON_CURVE                        119
 501 #define EC_F_EC_POINT_MAKE_AFFINE                        120
 502 #define EC_F_EC_POINT_MUL                                179
 503 #define EC_F_EC_POINT_NEW                                121
 504 #define EC_F_EC_POINT_OCT2POINT                          122
 505 #define EC_F_EC_POINT_POINT2OCT                          123
 506 #define EC_F_EC_POINT_SET_AFFINE_COORDINATES_GF2M        180
 507 #define EC_F_EC_POINT_SET_AFFINE_COORDINATES_GFP         124
 508 #define EC_F_EC_POINT_SET_COMPRESSED_COORDINATES_GF2M    181
 509 #define EC_F_EC_POINT_SET_COMPRESSED_COORDINATES_GFP     125
 510 #define EC_F_EC_POINT_SET_JPROJECTIVE_COORDINATES_GFP    126
 511 #define EC_F_EC_POINT_SET_TO_INFINITY                    127
 512 #define EC_F_EC_WNAF_MUL                                 183
 513 #define EC_F_EC_WNAF_PRECOMPUTE_MULT                     178
 514 #define EC_F_GFP_MONT_GROUP_SET_CURVE                    135
 515 #define EC_F_I2D_ECDSAPARAMETERS                         158
 516 #define EC_F_I2D_ECPARAMETERS                            164
 517 #define EC_F_I2D_ECPKPARAMETERS                          165
 518 #define EC_F_I2D_ECPRIVATEKEY                            169
 519
 520 /* Reason codes. */
 521 #define EC_R_ASN1_ERROR                                  130
 522 #define EC_R_ASN1_UNKNOWN_FIELD                          131
 523 #define EC_R_BUFFER_TOO_SMALL                            100
 524 #define EC_R_D2I_ECPARAMETERS_FAILURE                    132
 525 #define EC_R_D2I_ECPKPARAMETERS_FAILURE                  133
 526 #define EC_R_D2I_EC_PARAMETERS_FAILURE                   123
 527 #define EC_R_DISCRIMINANT_IS_ZERO                        118
 528 #define EC_R_EC_GROUP_NEW_BY_NAME_FAILURE                124
 529 #define EC_R_GROUP2PARAMETERS_FAILURE                    125
 530 #define EC_R_GROUP2PKPARAMETERS_FAILURE                  134
 531 #define EC_R_I2D_ECPKPARAMETERS_FAILURE                  135
 532 #define EC_R_I2D_EC_PARAMETERS_FAILURE                   126
 533 #define EC_R_INCOMPATIBLE_OBJECTS                        101
 534 #define EC_R_INVALID_ARGUMENT                            112
 535 #define EC_R_INVALID_COMPRESSED_POINT                    110
 536 #define EC_R_INVALID_COMPRESSION_BIT                     109
 537 #define EC_R_INVALID_ENCODING                            102
 538 #define EC_R_INVALID_FIELD                               103
 539 #define EC_R_INVALID_FORM                                104
 540 #define EC_R_INVALID_GROUP_ORDER                         119
 541 #define EC_R_INVALID_PRIVATE_KEY                         139
 542 #define EC_R_MISSING_PARAMETERS                          127
 543 #define EC_R_MISSING_PRIVATE_KEY                         138
 544 #define EC_R_NOT_IMPLEMENTED                             136
 545 #define EC_R_NOT_INITIALIZED                             111
 546 #define EC_R_NO_SUCH_EXTRA_DATA                          105
 547 #define EC_R_PARAMETERS2GROUP_FAILURE                    128
 548 #define EC_R_PKPARAMETERS2GROUP_FAILURE                  137
 549 #define EC_R_POINT_AT_INFINITY                           106
 550 #define EC_R_POINT_IS_NOT_ON_CURVE                       107
 551 #define EC_R_SLOT_FULL                                   108
 552 #define EC_R_UNDEFINED_GENERATOR                         113
 553 #define EC_R_UNDEFINED_ORDER                             122
 554 #define EC_R_UNKNOWN_GROUP                               116
 555 #define EC_R_UNKNOWN_NID                                 117
 556 #define EC_R_UNKNOWN_ORDER                               114
 557 #define EC_R_UNKNOWN_PARAMETERS_TYPE                     129
 558 #define EC_R_WRONG_ORDER                                 140
 559
 560 #ifdef  __cplusplus
 561 }
 562 #endif
 563 #endif