1 /* $OpenBSD: ec.h,v 1.49 2025/01/25 17:59:44 tb Exp $ */ 2 /* 3 * Originally written by Bodo Moeller for the OpenSSL project. 4 */ 5 /* ==================================================================== 6 * Copyright (c) 1998-2005 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 * The elliptic curve binary polynomial software is originally written by 68 * Sheueling Chang Shantz and Douglas Stebila of Sun Microsystems Laboratories. 69 */ 70 71 #ifndef HEADER_EC_H 72 #define HEADER_EC_H 73 74 #include <openssl/opensslconf.h> 75 76 #include <openssl/asn1.h> 77 #include <openssl/bn.h> 78 79 #ifdef __cplusplus 80 extern "C" { 81 #elif defined(__SUNPRO_C) 82 # if __SUNPRO_C >= 0x520 83 # pragma error_messages (off,E_ARRAY_OF_INCOMPLETE_NONAME,E_ARRAY_OF_INCOMPLETE) 84 # endif 85 #endif 86 87 #ifndef OPENSSL_ECC_MAX_FIELD_BITS 88 #define OPENSSL_ECC_MAX_FIELD_BITS 661 89 #endif 90 91 /* Elliptic point conversion form as per X9.62, page 4 and section 4.4.2. */ 92 typedef enum { 93 POINT_CONVERSION_COMPRESSED = 2, 94 POINT_CONVERSION_UNCOMPRESSED = 4, 95 POINT_CONVERSION_HYBRID = 6 96 } point_conversion_form_t; 97 98 typedef struct ec_method_st EC_METHOD; 99 typedef struct ec_group_st EC_GROUP; 100 typedef struct ec_point_st EC_POINT; 101 102 const EC_METHOD *EC_GFp_simple_method(void); 103 const EC_METHOD *EC_GFp_mont_method(void); 104 105 EC_GROUP *EC_GROUP_new(const EC_METHOD *meth); 106 void EC_GROUP_free(EC_GROUP *group); 107 void EC_GROUP_clear_free(EC_GROUP *group); 108 109 int EC_GROUP_copy(EC_GROUP *dst, const EC_GROUP *src); 110 EC_GROUP *EC_GROUP_dup(const EC_GROUP *src); 111 112 const EC_METHOD *EC_GROUP_method_of(const EC_GROUP *group); 113 int EC_METHOD_get_field_type(const EC_METHOD *meth); 114 115 int EC_GROUP_set_generator(EC_GROUP *group, const EC_POINT *generator, 116 const BIGNUM *order, const BIGNUM *cofactor); 117 const EC_POINT *EC_GROUP_get0_generator(const EC_GROUP *group); 118 119 int EC_GROUP_get_order(const EC_GROUP *group, BIGNUM *order, BN_CTX *ctx); 120 int EC_GROUP_order_bits(const EC_GROUP *group); 121 int EC_GROUP_get_cofactor(const EC_GROUP *group, BIGNUM *cofactor, BN_CTX *ctx); 122 123 void EC_GROUP_set_curve_name(EC_GROUP *group, int nid); 124 int EC_GROUP_get_curve_name(const EC_GROUP *group); 125 126 void EC_GROUP_set_asn1_flag(EC_GROUP *group, int flag); 127 int EC_GROUP_get_asn1_flag(const EC_GROUP *group); 128 129 void EC_GROUP_set_point_conversion_form(EC_GROUP *group, 130 point_conversion_form_t form); 131 point_conversion_form_t EC_GROUP_get_point_conversion_form(const EC_GROUP *); 132 133 unsigned char *EC_GROUP_get0_seed(const EC_GROUP *x); 134 size_t EC_GROUP_get_seed_len(const EC_GROUP *); 135 size_t EC_GROUP_set_seed(EC_GROUP *, const unsigned char *, size_t len); 136 137 int EC_GROUP_set_curve(EC_GROUP *group, const BIGNUM *p, const BIGNUM *a, 138 const BIGNUM *b, BN_CTX *ctx); 139 int EC_GROUP_get_curve(const EC_GROUP *group, BIGNUM *p, BIGNUM *a, BIGNUM *b, 140 BN_CTX *ctx); 141 142 int EC_GROUP_set_curve_GFp(EC_GROUP *group, const BIGNUM *p, const BIGNUM *a, 143 const BIGNUM *b, BN_CTX *ctx); 144 int EC_GROUP_get_curve_GFp(const EC_GROUP *group, BIGNUM *p, BIGNUM *a, 145 BIGNUM *b, BN_CTX *ctx); 146 147 int EC_GROUP_get_degree(const EC_GROUP *group); 148 149 int EC_GROUP_check(const EC_GROUP *group, BN_CTX *ctx); 150 int EC_GROUP_check_discriminant(const EC_GROUP *group, BN_CTX *ctx); 151 152 /* Compare two EC_GROUPs. Returns 0 if both groups are equal, 1 otherwise. */ 153 int EC_GROUP_cmp(const EC_GROUP *a, const EC_GROUP *b, BN_CTX *ctx); 154 155 EC_GROUP *EC_GROUP_new_curve_GFp(const BIGNUM *p, const BIGNUM *a, 156 const BIGNUM *b, BN_CTX *ctx); 157 EC_GROUP *EC_GROUP_new_by_curve_name(int nid); 158 159 typedef struct { 160 int nid; 161 const char *comment; 162 } EC_builtin_curve; 163 164 size_t EC_get_builtin_curves(EC_builtin_curve *r, size_t nitems); 165 166 const char *EC_curve_nid2nist(int nid); 167 int EC_curve_nist2nid(const char *name); 168 169 EC_POINT *EC_POINT_new(const EC_GROUP *group); 170 void EC_POINT_free(EC_POINT *point); 171 void EC_POINT_clear_free(EC_POINT *point); 172 int EC_POINT_copy(EC_POINT *dst, const EC_POINT *src); 173 EC_POINT *EC_POINT_dup(const EC_POINT *src, const EC_GROUP *group); 174 175 const EC_METHOD *EC_POINT_method_of(const EC_POINT *point); 176 177 int EC_POINT_set_to_infinity(const EC_GROUP *group, EC_POINT *point); 178 179 int EC_POINT_set_affine_coordinates(const EC_GROUP *group, EC_POINT *p, 180 const BIGNUM *x, const BIGNUM *y, BN_CTX *ctx); 181 int EC_POINT_get_affine_coordinates(const EC_GROUP *group, const EC_POINT *p, 182 BIGNUM *x, BIGNUM *y, BN_CTX *ctx); 183 int EC_POINT_set_compressed_coordinates(const EC_GROUP *group, EC_POINT *p, 184 const BIGNUM *x, int y_bit, BN_CTX *ctx); 185 186 int EC_POINT_set_Jprojective_coordinates_GFp(const EC_GROUP *group, EC_POINT *p, 187 const BIGNUM *x, const BIGNUM *y, const BIGNUM *z, BN_CTX *ctx); 188 int EC_POINT_get_Jprojective_coordinates_GFp(const EC_GROUP *group, 189 const EC_POINT *p, BIGNUM *x, BIGNUM *y, BIGNUM *z, BN_CTX *ctx); 190 int EC_POINT_set_affine_coordinates_GFp(const EC_GROUP *group, EC_POINT *p, 191 const BIGNUM *x, const BIGNUM *y, BN_CTX *ctx); 192 int EC_POINT_get_affine_coordinates_GFp(const EC_GROUP *group, 193 const EC_POINT *p, BIGNUM *x, BIGNUM *y, BN_CTX *ctx); 194 int EC_POINT_set_compressed_coordinates_GFp(const EC_GROUP *group, EC_POINT *p, 195 const BIGNUM *x, int y_bit, BN_CTX *ctx); 196 size_t EC_POINT_point2oct(const EC_GROUP *group, const EC_POINT *p, 197 point_conversion_form_t form, unsigned char *buf, size_t len, BN_CTX *ctx); 198 int EC_POINT_oct2point(const EC_GROUP *group, EC_POINT *p, 199 const unsigned char *buf, size_t len, BN_CTX *ctx); 200 201 BIGNUM *EC_POINT_point2bn(const EC_GROUP *, const EC_POINT *, 202 point_conversion_form_t form, BIGNUM *, BN_CTX *); 203 EC_POINT *EC_POINT_bn2point(const EC_GROUP *, const BIGNUM *, EC_POINT *, 204 BN_CTX *); 205 char *EC_POINT_point2hex(const EC_GROUP *, const EC_POINT *, 206 point_conversion_form_t form, BN_CTX *); 207 EC_POINT *EC_POINT_hex2point(const EC_GROUP *, const char *, EC_POINT *, 208 BN_CTX *); 209 210 int EC_POINT_add(const EC_GROUP *group, EC_POINT *r, const EC_POINT *a, 211 const EC_POINT *b, BN_CTX *ctx); 212 int EC_POINT_dbl(const EC_GROUP *group, EC_POINT *r, const EC_POINT *a, 213 BN_CTX *ctx); 214 int EC_POINT_invert(const EC_GROUP *group, EC_POINT *a, BN_CTX *ctx); 215 int EC_POINT_is_at_infinity(const EC_GROUP *group, const EC_POINT *p); 216 int EC_POINT_is_on_curve(const EC_GROUP *group, const EC_POINT *point, 217 BN_CTX *ctx); 218 int EC_POINT_cmp(const EC_GROUP *group, const EC_POINT *a, const EC_POINT *b, 219 BN_CTX *ctx); 220 221 int EC_POINT_make_affine(const EC_GROUP *group, EC_POINT *point, BN_CTX *ctx); 222 int EC_POINTs_make_affine(const EC_GROUP *group, size_t num, EC_POINT *points[], 223 BN_CTX *ctx); 224 int EC_POINTs_mul(const EC_GROUP *group, EC_POINT *r, const BIGNUM *n, 225 size_t num, const EC_POINT *p[], const BIGNUM *m[], BN_CTX *ctx); 226 int EC_POINT_mul(const EC_GROUP *group, EC_POINT *r, const BIGNUM *n, 227 const EC_POINT *q, const BIGNUM *m, BN_CTX *ctx); 228 int EC_GROUP_precompute_mult(EC_GROUP *group, BN_CTX *ctx); 229 int EC_GROUP_have_precompute_mult(const EC_GROUP *group); 230 231 int EC_GROUP_get_basis_type(const EC_GROUP *); 232 233 #define OPENSSL_EC_EXPLICIT_CURVE 0x000 234 #define OPENSSL_EC_NAMED_CURVE 0x001 235 236 EC_GROUP *d2i_ECPKParameters(EC_GROUP **, const unsigned char **in, long len); 237 int i2d_ECPKParameters(const EC_GROUP *, unsigned char **out); 238 239 #define d2i_ECPKParameters_bio(bp,x) ASN1_d2i_bio_of(EC_GROUP,NULL,d2i_ECPKParameters,bp,x) 240 #define i2d_ECPKParameters_bio(bp,x) ASN1_i2d_bio_of_const(EC_GROUP,i2d_ECPKParameters,bp,x) 241 #define d2i_ECPKParameters_fp(fp,x) (EC_GROUP *)ASN1_d2i_fp(NULL, \ 242 (char *(*)())d2i_ECPKParameters,(fp),(unsigned char **)(x)) 243 #define i2d_ECPKParameters_fp(fp,x) ASN1_i2d_fp(i2d_ECPKParameters,(fp), \ 244 (unsigned char *)(x)) 245 246 #ifndef OPENSSL_NO_BIO 247 int ECPKParameters_print(BIO *bp, const EC_GROUP *x, int off); 248 #endif 249 int ECPKParameters_print_fp(FILE *fp, const EC_GROUP *x, int off); 250 251 #define EC_PKEY_NO_PARAMETERS 0x001 252 #define EC_PKEY_NO_PUBKEY 0x002 253 254 #define EC_FLAG_NON_FIPS_ALLOW 0x1 255 #define EC_FLAG_FIPS_CHECKED 0x2 256 #define EC_FLAG_COFACTOR_ECDH 0x1000 257 258 EC_KEY *EC_KEY_new(void); 259 int EC_KEY_get_flags(const EC_KEY *key); 260 void EC_KEY_set_flags(EC_KEY *key, int flags); 261 void EC_KEY_clear_flags(EC_KEY *key, int flags); 262 EC_KEY *EC_KEY_new_by_curve_name(int nid); 263 void EC_KEY_free(EC_KEY *key); 264 EC_KEY *EC_KEY_copy(EC_KEY *dst, const EC_KEY *src); 265 EC_KEY *EC_KEY_dup(const EC_KEY *src); 266 int EC_KEY_up_ref(EC_KEY *key); 267 268 const EC_GROUP *EC_KEY_get0_group(const EC_KEY *key); 269 int EC_KEY_set_group(EC_KEY *key, const EC_GROUP *group); 270 const BIGNUM *EC_KEY_get0_private_key(const EC_KEY *key); 271 int EC_KEY_set_private_key(EC_KEY *key, const BIGNUM *prv); 272 const EC_POINT *EC_KEY_get0_public_key(const EC_KEY *key); 273 int EC_KEY_set_public_key(EC_KEY *key, const EC_POINT *pub); 274 275 unsigned EC_KEY_get_enc_flags(const EC_KEY *key); 276 void EC_KEY_set_enc_flags(EC_KEY *eckey, unsigned int flags); 277 point_conversion_form_t EC_KEY_get_conv_form(const EC_KEY *key); 278 void EC_KEY_set_conv_form(EC_KEY *eckey, point_conversion_form_t cform); 279 280 void EC_KEY_set_asn1_flag(EC_KEY *eckey, int asn1_flag); 281 int EC_KEY_precompute_mult(EC_KEY *key, BN_CTX *ctx); 282 int EC_KEY_generate_key(EC_KEY *key); 283 int EC_KEY_check_key(const EC_KEY *key); 284 int EC_KEY_set_public_key_affine_coordinates(EC_KEY *key, BIGNUM *x, BIGNUM *y); 285 286 EC_KEY *d2i_ECPrivateKey(EC_KEY **key, const unsigned char **in, long len); 287 int i2d_ECPrivateKey(EC_KEY *key, unsigned char **out); 288 EC_KEY *d2i_ECParameters(EC_KEY **key, const unsigned char **in, long len); 289 int i2d_ECParameters(EC_KEY *key, unsigned char **out); 290 291 EC_KEY *o2i_ECPublicKey(EC_KEY **key, const unsigned char **in, long len); 292 int i2o_ECPublicKey(const EC_KEY *key, unsigned char **out); 293 294 #ifndef OPENSSL_NO_BIO 295 int ECParameters_print(BIO *bp, const EC_KEY *key); 296 int EC_KEY_print(BIO *bp, const EC_KEY *key, int off); 297 #endif 298 int ECParameters_print_fp(FILE *fp, const EC_KEY *key); 299 int EC_KEY_print_fp(FILE *fp, const EC_KEY *key, int off); 300 301 #define EC_KEY_get_ex_new_index(l, p, newf, dupf, freef) \ 302 CRYPTO_get_ex_new_index(CRYPTO_EX_INDEX_EC_KEY, l, p, newf, dupf, freef) 303 int EC_KEY_set_ex_data(EC_KEY *key, int idx, void *arg); 304 void *EC_KEY_get_ex_data(const EC_KEY *key, int idx); 305 306 const EC_KEY_METHOD *EC_KEY_OpenSSL(void); 307 const EC_KEY_METHOD *EC_KEY_get_default_method(void); 308 void EC_KEY_set_default_method(const EC_KEY_METHOD *meth); 309 const EC_KEY_METHOD *EC_KEY_get_method(const EC_KEY *key); 310 int EC_KEY_set_method(EC_KEY *key, const EC_KEY_METHOD *meth); 311 EC_KEY *EC_KEY_new_method(ENGINE *engine); 312 313 int ECDH_size(const EC_KEY *ecdh); 314 int ECDH_compute_key(void *out, size_t outlen, const EC_POINT *pub_key, 315 EC_KEY *ecdh, 316 void *(*KDF)(const void *in, size_t inlen, void *out, size_t *outlen)); 317 318 typedef struct ECDSA_SIG_st ECDSA_SIG; 319 320 ECDSA_SIG *ECDSA_SIG_new(void); 321 void ECDSA_SIG_free(ECDSA_SIG *sig); 322 int i2d_ECDSA_SIG(const ECDSA_SIG *sig, unsigned char **pp); 323 ECDSA_SIG *d2i_ECDSA_SIG(ECDSA_SIG **sig, const unsigned char **pp, long len); 324 325 const BIGNUM *ECDSA_SIG_get0_r(const ECDSA_SIG *sig); 326 const BIGNUM *ECDSA_SIG_get0_s(const ECDSA_SIG *sig); 327 void ECDSA_SIG_get0(const ECDSA_SIG *sig, const BIGNUM **pr, const BIGNUM **ps); 328 int ECDSA_SIG_set0(ECDSA_SIG *sig, BIGNUM *r, BIGNUM *s); 329 330 int ECDSA_size(const EC_KEY *eckey); 331 332 ECDSA_SIG *ECDSA_do_sign(const unsigned char *digest, int digest_len, 333 EC_KEY *eckey); 334 int ECDSA_do_verify(const unsigned char *digest, int digest_len, 335 const ECDSA_SIG *sig, EC_KEY *eckey); 336 337 int ECDSA_sign(int type, const unsigned char *digest, int digest_len, 338 unsigned char *signature, unsigned int *signature_len, EC_KEY *eckey); 339 int ECDSA_verify(int type, const unsigned char *digest, int digest_len, 340 const unsigned char *signature, int signature_len, EC_KEY *eckey); 341 342 EC_KEY_METHOD *EC_KEY_METHOD_new(const EC_KEY_METHOD *meth); 343 void EC_KEY_METHOD_free(EC_KEY_METHOD *meth); 344 void EC_KEY_METHOD_set_init(EC_KEY_METHOD *meth, 345 int (*init)(EC_KEY *key), 346 void (*finish)(EC_KEY *key), 347 int (*copy)(EC_KEY *dest, const EC_KEY *src), 348 int (*set_group)(EC_KEY *key, const EC_GROUP *grp), 349 int (*set_private)(EC_KEY *key, const BIGNUM *priv_key), 350 int (*set_public)(EC_KEY *key, const EC_POINT *pub_key)); 351 void EC_KEY_METHOD_set_keygen(EC_KEY_METHOD *meth, 352 int (*keygen)(EC_KEY *key)); 353 void EC_KEY_METHOD_set_compute_key(EC_KEY_METHOD *meth, 354 int (*ckey)(unsigned char **out, size_t *out_len, const EC_POINT *pub_key, 355 const EC_KEY *ecdh)); 356 void EC_KEY_METHOD_set_sign(EC_KEY_METHOD *meth, 357 int (*sign)(int type, const unsigned char *digest, int digest_len, 358 unsigned char *signature, unsigned int *signature_len, 359 const BIGNUM *kinv, const BIGNUM *r, EC_KEY *eckey), 360 int (*sign_setup)(EC_KEY *eckey, BN_CTX *ctx_in, BIGNUM **kinvp, BIGNUM **rp), 361 ECDSA_SIG *(*sign_sig)(const unsigned char *digest, int digest_len, 362 const BIGNUM *in_kinv, const BIGNUM *in_r, EC_KEY *eckey)); 363 void EC_KEY_METHOD_set_verify(EC_KEY_METHOD *meth, 364 int (*verify)(int type, const unsigned char *digest, int digest_len, 365 const unsigned char *signature, int signature_len, EC_KEY *eckey), 366 int (*verify_sig)(const unsigned char *digest, int digest_len, 367 const ECDSA_SIG *sig, EC_KEY *eckey)); 368 void EC_KEY_METHOD_get_init(const EC_KEY_METHOD *meth, 369 int (**pinit)(EC_KEY *key), 370 void (**pfinish)(EC_KEY *key), 371 int (**pcopy)(EC_KEY *dest, const EC_KEY *src), 372 int (**pset_group)(EC_KEY *key, const EC_GROUP *grp), 373 int (**pset_private)(EC_KEY *key, const BIGNUM *priv_key), 374 int (**pset_public)(EC_KEY *key, const EC_POINT *pub_key)); 375 void EC_KEY_METHOD_get_keygen(const EC_KEY_METHOD *meth, 376 int (**pkeygen)(EC_KEY *key)); 377 void EC_KEY_METHOD_get_compute_key(const EC_KEY_METHOD *meth, 378 int (**pck)(unsigned char **out, size_t *out_len, const EC_POINT *pub_key, 379 const EC_KEY *ecdh)); 380 void EC_KEY_METHOD_get_sign(const EC_KEY_METHOD *meth, 381 int (**psign)(int type, const unsigned char *digest, int digest_len, 382 unsigned char *signature, unsigned int *signature_len, 383 const BIGNUM *kinv, const BIGNUM *r, EC_KEY *eckey), 384 int (**psign_setup)(EC_KEY *eckey, BN_CTX *ctx_in, BIGNUM **kinvp, BIGNUM **rp), 385 ECDSA_SIG *(**psign_sig)(const unsigned char *digest, int digest_len, 386 const BIGNUM *in_kinv, const BIGNUM *in_r, EC_KEY *eckey)); 387 void EC_KEY_METHOD_get_verify(const EC_KEY_METHOD *meth, 388 int (**pverify)(int type, const unsigned char *digest, int digest_len, 389 const unsigned char *signature, int signature_len, EC_KEY *eckey), 390 int (**pverify_sig)(const unsigned char *digest, int digest_len, 391 const ECDSA_SIG *sig, EC_KEY *eckey)); 392 393 EC_KEY *ECParameters_dup(EC_KEY *key); 394 395 #ifndef __cplusplus 396 #if defined(__SUNPRO_C) 397 # if __SUNPRO_C >= 0x520 398 # pragma error_messages (default,E_ARRAY_OF_INCOMPLETE_NONAME,E_ARRAY_OF_INCOMPLETE) 399 # endif 400 # endif 401 #endif 402 403 #define EVP_PKEY_CTX_set_ec_paramgen_curve_nid(ctx, nid) \ 404 EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_EC, \ 405 EVP_PKEY_OP_PARAMGEN|EVP_PKEY_OP_KEYGEN, \ 406 EVP_PKEY_CTRL_EC_PARAMGEN_CURVE_NID, nid, NULL) 407 408 #define EVP_PKEY_CTX_set_ec_param_enc(ctx, flag) \ 409 EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_EC, \ 410 EVP_PKEY_OP_PARAMGEN|EVP_PKEY_OP_KEYGEN, \ 411 EVP_PKEY_CTRL_EC_PARAM_ENC, flag, NULL) 412 413 #define EVP_PKEY_CTX_set_ecdh_cofactor_mode(ctx, flag) \ 414 EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_EC, \ 415 EVP_PKEY_OP_DERIVE, \ 416 EVP_PKEY_CTRL_EC_ECDH_COFACTOR, flag, NULL) 417 418 #define EVP_PKEY_CTX_get_ecdh_cofactor_mode(ctx) \ 419 EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_EC, \ 420 EVP_PKEY_OP_DERIVE, \ 421 EVP_PKEY_CTRL_EC_ECDH_COFACTOR, -2, NULL) 422 423 #define EVP_PKEY_CTX_set_ecdh_kdf_type(ctx, kdf) \ 424 EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_EC, \ 425 EVP_PKEY_OP_DERIVE, \ 426 EVP_PKEY_CTRL_EC_KDF_TYPE, kdf, NULL) 427 428 #define EVP_PKEY_CTX_get_ecdh_kdf_type(ctx) \ 429 EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_EC, \ 430 EVP_PKEY_OP_DERIVE, \ 431 EVP_PKEY_CTRL_EC_KDF_TYPE, -2, NULL) 432 433 #define EVP_PKEY_CTX_set_ecdh_kdf_md(ctx, md) \ 434 EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_EC, \ 435 EVP_PKEY_OP_DERIVE, \ 436 EVP_PKEY_CTRL_EC_KDF_MD, 0, (void *)(md)) 437 438 #define EVP_PKEY_CTX_get_ecdh_kdf_md(ctx, pmd) \ 439 EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_EC, \ 440 EVP_PKEY_OP_DERIVE, \ 441 EVP_PKEY_CTRL_GET_EC_KDF_MD, 0, (void *)(pmd)) 442 443 #define EVP_PKEY_CTX_set_ecdh_kdf_outlen(ctx, len) \ 444 EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_EC, \ 445 EVP_PKEY_OP_DERIVE, \ 446 EVP_PKEY_CTRL_EC_KDF_OUTLEN, len, NULL) 447 448 #define EVP_PKEY_CTX_get_ecdh_kdf_outlen(ctx, plen) \ 449 EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_EC, \ 450 EVP_PKEY_OP_DERIVE, \ 451 EVP_PKEY_CTRL_GET_EC_KDF_OUTLEN, 0, \ 452 (void *)(plen)) 453 454 #define EVP_PKEY_CTX_set0_ecdh_kdf_ukm(ctx, p, plen) \ 455 EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_EC, \ 456 EVP_PKEY_OP_DERIVE, \ 457 EVP_PKEY_CTRL_EC_KDF_UKM, plen, (void *)(p)) 458 459 #define EVP_PKEY_CTX_get0_ecdh_kdf_ukm(ctx, p) \ 460 EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_EC, \ 461 EVP_PKEY_OP_DERIVE, \ 462 EVP_PKEY_CTRL_GET_EC_KDF_UKM, 0, (void *)(p)) 463 464 /* SM2 will skip the operation check so no need to pass operation here */ 465 #define EVP_PKEY_CTX_set1_id(ctx, id, id_len) \ 466 EVP_PKEY_CTX_ctrl(ctx, -1, -1, \ 467 EVP_PKEY_CTRL_SET1_ID, (int)id_len, (void*)(id)) 468 469 #define EVP_PKEY_CTX_get1_id(ctx, id) \ 470 EVP_PKEY_CTX_ctrl(ctx, -1, -1, \ 471 EVP_PKEY_CTRL_GET1_ID, 0, (void*)(id)) 472 473 #define EVP_PKEY_CTX_get1_id_len(ctx, id_len) \ 474 EVP_PKEY_CTX_ctrl(ctx, -1, -1, \ 475 EVP_PKEY_CTRL_GET1_ID_LEN, 0, (void*)(id_len)) 476 477 #define EVP_PKEY_CTRL_EC_PARAMGEN_CURVE_NID (EVP_PKEY_ALG_CTRL + 1) 478 #define EVP_PKEY_CTRL_EC_PARAM_ENC (EVP_PKEY_ALG_CTRL + 2) 479 #define EVP_PKEY_CTRL_EC_ECDH_COFACTOR (EVP_PKEY_ALG_CTRL + 3) 480 #define EVP_PKEY_CTRL_EC_KDF_TYPE (EVP_PKEY_ALG_CTRL + 4) 481 #define EVP_PKEY_CTRL_EC_KDF_MD (EVP_PKEY_ALG_CTRL + 5) 482 #define EVP_PKEY_CTRL_GET_EC_KDF_MD (EVP_PKEY_ALG_CTRL + 6) 483 #define EVP_PKEY_CTRL_EC_KDF_OUTLEN (EVP_PKEY_ALG_CTRL + 7) 484 #define EVP_PKEY_CTRL_GET_EC_KDF_OUTLEN (EVP_PKEY_ALG_CTRL + 8) 485 #define EVP_PKEY_CTRL_EC_KDF_UKM (EVP_PKEY_ALG_CTRL + 9) 486 #define EVP_PKEY_CTRL_GET_EC_KDF_UKM (EVP_PKEY_ALG_CTRL + 10) 487 #define EVP_PKEY_CTRL_SET1_ID (EVP_PKEY_ALG_CTRL + 11) 488 #define EVP_PKEY_CTRL_GET1_ID (EVP_PKEY_ALG_CTRL + 12) 489 #define EVP_PKEY_CTRL_GET1_ID_LEN (EVP_PKEY_ALG_CTRL + 13) 490 491 /* KDF types */ 492 #define EVP_PKEY_ECDH_KDF_NONE 1 493 #define EVP_PKEY_ECDH_KDF_X9_63 2 494 495 void ERR_load_EC_strings(void); 496 497 /* Error codes for the EC functions. */ 498 499 /* Function codes. */ 500 #define EC_F_BN_TO_FELEM 224 501 #define EC_F_COMPUTE_WNAF 143 502 #define EC_F_D2I_ECPARAMETERS 144 503 #define EC_F_D2I_ECPKPARAMETERS 145 504 #define EC_F_D2I_ECPRIVATEKEY 146 505 #define EC_F_DO_EC_KEY_PRINT 221 506 #define EC_F_ECKEY_PARAM2TYPE 223 507 #define EC_F_ECKEY_PARAM_DECODE 212 508 #define EC_F_ECKEY_PRIV_DECODE 213 509 #define EC_F_ECKEY_PRIV_ENCODE 214 510 #define EC_F_ECKEY_PUB_DECODE 215 511 #define EC_F_ECKEY_PUB_ENCODE 216 512 #define EC_F_ECKEY_TYPE2PARAM 220 513 #define EC_F_ECPARAMETERS_PRINT 147 514 #define EC_F_ECPARAMETERS_PRINT_FP 148 515 #define EC_F_ECPKPARAMETERS_PRINT 149 516 #define EC_F_ECPKPARAMETERS_PRINT_FP 150 517 #define EC_F_ECP_NIST_MOD_192 203 518 #define EC_F_ECP_NIST_MOD_224 204 519 #define EC_F_ECP_NIST_MOD_256 205 520 #define EC_F_ECP_NIST_MOD_521 206 521 #define EC_F_ECP_NISTZ256_GET_AFFINE 240 522 #define EC_F_ECP_NISTZ256_MULT_PRECOMPUTE 243 523 #define EC_F_ECP_NISTZ256_POINTS_MUL 241 524 #define EC_F_ECP_NISTZ256_PRE_COMP_NEW 244 525 #define EC_F_ECP_NISTZ256_SET_WORDS 245 526 #define EC_F_ECP_NISTZ256_WINDOWED_MUL 242 527 #define EC_F_EC_ASN1_GROUP2CURVE 153 528 #define EC_F_EC_ASN1_GROUP2FIELDID 154 529 #define EC_F_EC_ASN1_GROUP2PARAMETERS 155 530 #define EC_F_EC_ASN1_GROUP2PKPARAMETERS 156 531 #define EC_F_EC_ASN1_PARAMETERS2GROUP 157 532 #define EC_F_EC_ASN1_PKPARAMETERS2GROUP 158 533 #define EC_F_EC_EX_DATA_SET_DATA 211 534 #define EC_F_EC_GF2M_MONTGOMERY_POINT_MULTIPLY 208 535 #define EC_F_EC_GF2M_SIMPLE_GROUP_CHECK_DISCRIMINANT 159 536 #define EC_F_EC_GF2M_SIMPLE_GROUP_SET_CURVE 195 537 #define EC_F_EC_GF2M_SIMPLE_OCT2POINT 160 538 #define EC_F_EC_GF2M_SIMPLE_POINT2OCT 161 539 #define EC_F_EC_GF2M_SIMPLE_POINT_GET_AFFINE_COORDINATES 162 540 #define EC_F_EC_GF2M_SIMPLE_POINT_SET_AFFINE_COORDINATES 163 541 #define EC_F_EC_GF2M_SIMPLE_SET_COMPRESSED_COORDINATES 164 542 #define EC_F_EC_GFP_MONT_FIELD_DECODE 133 543 #define EC_F_EC_GFP_MONT_FIELD_ENCODE 134 544 #define EC_F_EC_GFP_MONT_FIELD_MUL 131 545 #define EC_F_EC_GFP_MONT_FIELD_SET_TO_ONE 209 546 #define EC_F_EC_GFP_MONT_FIELD_SQR 132 547 #define EC_F_EC_GFP_MONT_GROUP_SET_CURVE 189 548 #define EC_F_EC_GFP_MONT_GROUP_SET_CURVE_GFP 135 549 #define EC_F_EC_GFP_NISTP224_GROUP_SET_CURVE 225 550 #define EC_F_EC_GFP_NISTP224_POINTS_MUL 228 551 #define EC_F_EC_GFP_NISTP224_POINT_GET_AFFINE_COORDINATES 226 552 #define EC_F_EC_GFP_NISTP256_GROUP_SET_CURVE 230 553 #define EC_F_EC_GFP_NISTP256_POINTS_MUL 231 554 #define EC_F_EC_GFP_NISTP256_POINT_GET_AFFINE_COORDINATES 232 555 #define EC_F_EC_GFP_NISTP521_GROUP_SET_CURVE 233 556 #define EC_F_EC_GFP_NISTP521_POINTS_MUL 234 557 #define EC_F_EC_GFP_NISTP521_POINT_GET_AFFINE_COORDINATES 235 558 #define EC_F_EC_GFP_NIST_FIELD_MUL 200 559 #define EC_F_EC_GFP_NIST_FIELD_SQR 201 560 #define EC_F_EC_GFP_NIST_GROUP_SET_CURVE 202 561 #define EC_F_EC_GFP_SIMPLE_GROUP_CHECK_DISCRIMINANT 165 562 #define EC_F_EC_GFP_SIMPLE_GROUP_SET_CURVE 166 563 #define EC_F_EC_GFP_SIMPLE_GROUP_SET_CURVE_GFP 100 564 #define EC_F_EC_GFP_SIMPLE_GROUP_SET_GENERATOR 101 565 #define EC_F_EC_GFP_SIMPLE_MAKE_AFFINE 102 566 #define EC_F_EC_GFP_SIMPLE_OCT2POINT 103 567 #define EC_F_EC_GFP_SIMPLE_POINT2OCT 104 568 #define EC_F_EC_GFP_SIMPLE_POINTS_MAKE_AFFINE 137 569 #define EC_F_EC_GFP_SIMPLE_POINT_GET_AFFINE_COORDINATES 167 570 #define EC_F_EC_GFP_SIMPLE_POINT_GET_AFFINE_COORDINATES_GFP 105 571 #define EC_F_EC_GFP_SIMPLE_POINT_SET_AFFINE_COORDINATES 168 572 #define EC_F_EC_GFP_SIMPLE_POINT_SET_AFFINE_COORDINATES_GFP 128 573 #define EC_F_EC_GFP_SIMPLE_SET_COMPRESSED_COORDINATES 169 574 #define EC_F_EC_GFP_SIMPLE_SET_COMPRESSED_COORDINATES_GFP 129 575 #define EC_F_EC_GROUP_CHECK 170 576 #define EC_F_EC_GROUP_CHECK_DISCRIMINANT 171 577 #define EC_F_EC_GROUP_COPY 106 578 #define EC_F_EC_GROUP_GET0_GENERATOR 139 579 #define EC_F_EC_GROUP_GET_COFACTOR 140 580 #define EC_F_EC_GROUP_GET_CURVE_GF2M 172 581 #define EC_F_EC_GROUP_GET_CURVE_GFP 130 582 #define EC_F_EC_GROUP_GET_DEGREE 173 583 #define EC_F_EC_GROUP_GET_ORDER 141 584 #define EC_F_EC_GROUP_GET_PENTANOMIAL_BASIS 193 585 #define EC_F_EC_GROUP_GET_TRINOMIAL_BASIS 194 586 #define EC_F_EC_GROUP_NEW 108 587 #define EC_F_EC_GROUP_NEW_BY_CURVE_NAME 174 588 #define EC_F_EC_GROUP_NEW_FROM_DATA 175 589 #define EC_F_EC_GROUP_PRECOMPUTE_MULT 142 590 #define EC_F_EC_GROUP_SET_CURVE_GF2M 176 591 #define EC_F_EC_GROUP_SET_CURVE_GFP 109 592 #define EC_F_EC_GROUP_SET_EXTRA_DATA 110 593 #define EC_F_EC_GROUP_SET_GENERATOR 111 594 #define EC_F_EC_KEY_CHECK_KEY 177 595 #define EC_F_EC_KEY_COPY 178 596 #define EC_F_EC_KEY_GENERATE_KEY 179 597 #define EC_F_EC_KEY_NEW 182 598 #define EC_F_EC_KEY_PRINT 180 599 #define EC_F_EC_KEY_PRINT_FP 181 600 #define EC_F_EC_KEY_SET_PUBLIC_KEY_AFFINE_COORDINATES 229 601 #define EC_F_EC_POINTS_MAKE_AFFINE 136 602 #define EC_F_EC_POINT_ADD 112 603 #define EC_F_EC_POINT_CMP 113 604 #define EC_F_EC_POINT_COPY 114 605 #define EC_F_EC_POINT_DBL 115 606 #define EC_F_EC_POINT_GET_AFFINE_COORDINATES_GF2M 183 607 #define EC_F_EC_POINT_GET_AFFINE_COORDINATES_GFP 116 608 #define EC_F_EC_POINT_GET_JPROJECTIVE_COORDINATES_GFP 117 609 #define EC_F_EC_POINT_INVERT 210 610 #define EC_F_EC_POINT_IS_AT_INFINITY 118 611 #define EC_F_EC_POINT_IS_ON_CURVE 119 612 #define EC_F_EC_POINT_MAKE_AFFINE 120 613 #define EC_F_EC_POINT_MUL 184 614 #define EC_F_EC_POINT_NEW 121 615 #define EC_F_EC_POINT_OCT2POINT 122 616 #define EC_F_EC_POINT_POINT2OCT 123 617 #define EC_F_EC_POINT_SET_AFFINE_COORDINATES_GF2M 185 618 #define EC_F_EC_POINT_SET_AFFINE_COORDINATES_GFP 124 619 #define EC_F_EC_POINT_SET_COMPRESSED_COORDINATES_GF2M 186 620 #define EC_F_EC_POINT_SET_COMPRESSED_COORDINATES_GFP 125 621 #define EC_F_EC_POINT_SET_JPROJECTIVE_COORDINATES_GFP 126 622 #define EC_F_EC_POINT_SET_TO_INFINITY 127 623 #define EC_F_EC_PRE_COMP_DUP 207 624 #define EC_F_EC_PRE_COMP_NEW 196 625 #define EC_F_EC_WNAF_MUL 187 626 #define EC_F_EC_WNAF_PRECOMPUTE_MULT 188 627 #define EC_F_I2D_ECPARAMETERS 190 628 #define EC_F_I2D_ECPKPARAMETERS 191 629 #define EC_F_I2D_ECPRIVATEKEY 192 630 #define EC_F_I2O_ECPUBLICKEY 151 631 #define EC_F_NISTP224_PRE_COMP_NEW 227 632 #define EC_F_NISTP256_PRE_COMP_NEW 236 633 #define EC_F_NISTP521_PRE_COMP_NEW 237 634 #define EC_F_O2I_ECPUBLICKEY 152 635 #define EC_F_OLD_EC_PRIV_DECODE 222 636 #define EC_F_PKEY_EC_CTRL 197 637 #define EC_F_PKEY_EC_CTRL_STR 198 638 #define EC_F_PKEY_EC_DERIVE 217 639 #define EC_F_PKEY_EC_KEYGEN 199 640 #define EC_F_PKEY_EC_PARAMGEN 219 641 #define EC_F_PKEY_EC_SIGN 218 642 643 /* Reason codes. */ 644 #define EC_R_ASN1_ERROR 115 645 #define EC_R_ASN1_UNKNOWN_FIELD 116 646 #define EC_R_BAD_SIGNATURE 166 647 #define EC_R_BIGNUM_OUT_OF_RANGE 144 648 #define EC_R_BUFFER_TOO_SMALL 100 649 #define EC_R_COORDINATES_OUT_OF_RANGE 146 650 #define EC_R_D2I_ECPKPARAMETERS_FAILURE 117 651 #define EC_R_DECODE_ERROR 142 652 #define EC_R_DISCRIMINANT_IS_ZERO 118 653 #define EC_R_EC_GROUP_NEW_BY_NAME_FAILURE 119 654 #define EC_R_FIELD_TOO_LARGE 143 655 #define EC_R_GF2M_NOT_SUPPORTED 147 656 #define EC_R_GROUP2PKPARAMETERS_FAILURE 120 657 #define EC_R_I2D_ECPKPARAMETERS_FAILURE 121 658 #define EC_R_INCOMPATIBLE_OBJECTS 101 659 #define EC_R_INVALID_ARGUMENT 112 660 #define EC_R_INVALID_COMPRESSED_POINT 110 661 #define EC_R_INVALID_COMPRESSION_BIT 109 662 #define EC_R_INVALID_CURVE 141 663 #define EC_R_INVALID_DIGEST 151 664 #define EC_R_INVALID_DIGEST_TYPE 138 665 #define EC_R_INVALID_ENCODING 102 666 #define EC_R_INVALID_FIELD 103 667 #define EC_R_INVALID_FORM 104 668 #define EC_R_INVALID_GROUP_ORDER 122 669 #define EC_R_INVALID_KEY 165 670 #define EC_R_INVALID_OUTPUT_LENGTH 171 671 #define EC_R_INVALID_PEER_KEY 152 672 #define EC_R_INVALID_PENTANOMIAL_BASIS 132 673 #define EC_R_INVALID_PRIVATE_KEY 123 674 #define EC_R_INVALID_TRINOMIAL_BASIS 137 675 #define EC_R_KDF_FAILED 167 676 #define EC_R_KDF_PARAMETER_ERROR 148 677 #define EC_R_KEY_TRUNCATION 168 678 #define EC_R_KEYS_NOT_SET 140 679 #define EC_R_MISSING_PARAMETERS 124 680 #define EC_R_MISSING_PRIVATE_KEY 125 681 #define EC_R_NEED_NEW_SETUP_VALUES 170 682 #define EC_R_NOT_A_NIST_PRIME 135 683 #define EC_R_NOT_A_SUPPORTED_NIST_PRIME 136 684 #define EC_R_NOT_IMPLEMENTED 126 685 #define EC_R_NOT_INITIALIZED 111 686 #define EC_R_NO_FIELD_MOD 133 687 #define EC_R_NO_PARAMETERS_SET 139 688 #define EC_R_PASSED_NULL_PARAMETER 134 689 #define EC_R_PEER_KEY_ERROR 149 690 #define EC_R_PKPARAMETERS2GROUP_FAILURE 127 691 #define EC_R_POINT_AT_INFINITY 106 692 #define EC_R_POINT_ARITHMETIC_FAILURE 169 693 #define EC_R_POINT_IS_NOT_ON_CURVE 107 694 #define EC_R_SHARED_INFO_ERROR 150 695 #define EC_R_SLOT_FULL 108 696 #define EC_R_UNDEFINED_GENERATOR 113 697 #define EC_R_UNDEFINED_ORDER 128 698 #define EC_R_UNKNOWN_COFACTOR 164 699 #define EC_R_UNKNOWN_GROUP 129 700 #define EC_R_UNKNOWN_ORDER 114 701 #define EC_R_UNSUPPORTED_FIELD 131 702 #define EC_R_WRONG_CURVE_PARAMETERS 145 703 #define EC_R_WRONG_ORDER 130 704 705 #ifdef __cplusplus 706 } 707 #endif 708 #endif 709