File Explorer

1/*2 * Copyright 2002-2023 The OpenSSL Project Authors. All Rights Reserved.3 * Copyright (c) 2002, Oracle and/or its affiliates. All rights reserved4 *5 * Licensed under the Apache License 2.0 (the "License").  You may not use6 * this file except in compliance with the License.  You can obtain a copy7 * in the file LICENSE in the source distribution or at8 * https://www.openssl.org/source/license.html9 */10 11#ifndef OPENSSL_EC_H12#define OPENSSL_EC_H13#pragma once14 15#include <openssl/macros.h>16#ifndef OPENSSL_NO_DEPRECATED_3_017#define HEADER_EC_H18#endif19 20#include <openssl/opensslconf.h>21#include <openssl/types.h>22 23#include <string.h>24 25#ifdef __cplusplus26extern "C" {27#endif28 29/* Values for EVP_PKEY_CTX_set_ec_param_enc() */30#define OPENSSL_EC_EXPLICIT_CURVE 0x00031#define OPENSSL_EC_NAMED_CURVE 0x00132 33int EVP_PKEY_CTX_set_ec_paramgen_curve_nid(EVP_PKEY_CTX *ctx, int nid);34int EVP_PKEY_CTX_set_ec_param_enc(EVP_PKEY_CTX *ctx, int param_enc);35int EVP_PKEY_CTX_set_ecdh_cofactor_mode(EVP_PKEY_CTX *ctx, int cofactor_mode);36int EVP_PKEY_CTX_get_ecdh_cofactor_mode(EVP_PKEY_CTX *ctx);37 38int EVP_PKEY_CTX_set_ecdh_kdf_type(EVP_PKEY_CTX *ctx, int kdf);39int EVP_PKEY_CTX_get_ecdh_kdf_type(EVP_PKEY_CTX *ctx);40 41int EVP_PKEY_CTX_set_ecdh_kdf_md(EVP_PKEY_CTX *ctx, const EVP_MD *md);42int EVP_PKEY_CTX_get_ecdh_kdf_md(EVP_PKEY_CTX *ctx, const EVP_MD **md);43 44int EVP_PKEY_CTX_set_ecdh_kdf_outlen(EVP_PKEY_CTX *ctx, int len);45int EVP_PKEY_CTX_get_ecdh_kdf_outlen(EVP_PKEY_CTX *ctx, int *len);46 47int EVP_PKEY_CTX_set0_ecdh_kdf_ukm(EVP_PKEY_CTX *ctx, unsigned char *ukm,48    int len);49#ifndef OPENSSL_NO_DEPRECATED_3_050OSSL_DEPRECATEDIN_3_051int EVP_PKEY_CTX_get0_ecdh_kdf_ukm(EVP_PKEY_CTX *ctx, unsigned char **ukm);52#endif53 54#define EVP_PKEY_CTRL_EC_PARAMGEN_CURVE_NID (EVP_PKEY_ALG_CTRL + 1)55#define EVP_PKEY_CTRL_EC_PARAM_ENC (EVP_PKEY_ALG_CTRL + 2)56#define EVP_PKEY_CTRL_EC_ECDH_COFACTOR (EVP_PKEY_ALG_CTRL + 3)57#define EVP_PKEY_CTRL_EC_KDF_TYPE (EVP_PKEY_ALG_CTRL + 4)58#define EVP_PKEY_CTRL_EC_KDF_MD (EVP_PKEY_ALG_CTRL + 5)59#define EVP_PKEY_CTRL_GET_EC_KDF_MD (EVP_PKEY_ALG_CTRL + 6)60#define EVP_PKEY_CTRL_EC_KDF_OUTLEN (EVP_PKEY_ALG_CTRL + 7)61#define EVP_PKEY_CTRL_GET_EC_KDF_OUTLEN (EVP_PKEY_ALG_CTRL + 8)62#define EVP_PKEY_CTRL_EC_KDF_UKM (EVP_PKEY_ALG_CTRL + 9)63#define EVP_PKEY_CTRL_GET_EC_KDF_UKM (EVP_PKEY_ALG_CTRL + 10)64 65/* KDF types */66#define EVP_PKEY_ECDH_KDF_NONE 167#define EVP_PKEY_ECDH_KDF_X9_63 268/*69 * The old name for EVP_PKEY_ECDH_KDF_X9_6370 *  The ECDH KDF specification has been mistakenly attributed to ANSI X9.62,71 *  it is actually specified in ANSI X9.63.72 *  This identifier is retained for backwards compatibility73 */74#define EVP_PKEY_ECDH_KDF_X9_62 EVP_PKEY_ECDH_KDF_X9_6375 76/** Enum for the point conversion form as defined in X9.62 (ECDSA)77 *  for the encoding of a elliptic curve point (x,y) */78typedef enum {79    /** the point is encoded as z||x, where the octet z specifies80     *  which solution of the quadratic equation y is  */81    POINT_CONVERSION_COMPRESSED = 2,82    /** the point is encoded as z||x||y, where z is the octet 0x04  */83    POINT_CONVERSION_UNCOMPRESSED = 4,84    /** the point is encoded as z||x||y, where the octet z specifies85     *  which solution of the quadratic equation y is  */86    POINT_CONVERSION_HYBRID = 687} point_conversion_form_t;88 89const char *OSSL_EC_curve_nid2name(int nid);90 91#ifndef OPENSSL_NO_STDIO92#include <stdio.h>93#endif94#ifndef OPENSSL_NO_EC95#include <openssl/asn1.h>96#include <openssl/symhacks.h>97#ifndef OPENSSL_NO_DEPRECATED_1_1_098#include <openssl/bn.h>99#endif100#include <openssl/ecerr.h>101 102#ifndef OPENSSL_ECC_MAX_FIELD_BITS103#define OPENSSL_ECC_MAX_FIELD_BITS 661104#endif105 106#include <openssl/params.h>107#ifndef OPENSSL_NO_DEPRECATED_3_0108typedef struct ec_method_st EC_METHOD;109#endif110typedef struct ec_group_st EC_GROUP;111typedef struct ec_point_st EC_POINT;112typedef struct ecpk_parameters_st ECPKPARAMETERS;113typedef struct ec_parameters_st ECPARAMETERS;114 115/********************************************************************/116/*               EC_METHODs for curves over GF(p)                   */117/********************************************************************/118 119#ifndef OPENSSL_NO_DEPRECATED_3_0120/** Returns the basic GFp ec methods which provides the basis for the121 *  optimized methods.122 *  \return  EC_METHOD object123 */124OSSL_DEPRECATEDIN_3_0 const EC_METHOD *EC_GFp_simple_method(void);125 126/** Returns GFp methods using montgomery multiplication.127 *  \return  EC_METHOD object128 */129OSSL_DEPRECATEDIN_3_0 const EC_METHOD *EC_GFp_mont_method(void);130 131/** Returns GFp methods using optimized methods for NIST recommended curves132 *  \return  EC_METHOD object133 */134OSSL_DEPRECATEDIN_3_0 const EC_METHOD *EC_GFp_nist_method(void);135 136#ifndef OPENSSL_NO_EC_NISTP_64_GCC_128137/** Returns 64-bit optimized methods for nistp224138 *  \return  EC_METHOD object139 */140OSSL_DEPRECATEDIN_3_0 const EC_METHOD *EC_GFp_nistp224_method(void);141 142/** Returns 64-bit optimized methods for nistp256143 *  \return  EC_METHOD object144 */145OSSL_DEPRECATEDIN_3_0 const EC_METHOD *EC_GFp_nistp256_method(void);146 147/** Returns 64-bit optimized methods for nistp521148 *  \return  EC_METHOD object149 */150OSSL_DEPRECATEDIN_3_0 const EC_METHOD *EC_GFp_nistp521_method(void);151#endif /* OPENSSL_NO_EC_NISTP_64_GCC_128 */152 153#ifndef OPENSSL_NO_EC2M154/********************************************************************/155/*           EC_METHOD for curves over GF(2^m)                      */156/********************************************************************/157 158/** Returns the basic GF2m ec method159 *  \return  EC_METHOD object160 */161OSSL_DEPRECATEDIN_3_0 const EC_METHOD *EC_GF2m_simple_method(void);162 163#endif164 165/********************************************************************/166/*                   EC_GROUP functions                             */167/********************************************************************/168 169/**170 *  Creates a new EC_GROUP object171 *  \param   meth   EC_METHOD to use172 *  \return  newly created EC_GROUP object or NULL in case of an error.173 */174OSSL_DEPRECATEDIN_3_0 EC_GROUP *EC_GROUP_new(const EC_METHOD *meth);175 176/** Clears and frees a EC_GROUP object177 *  \param  group  EC_GROUP object to be cleared and freed.178 */179OSSL_DEPRECATEDIN_3_0 void EC_GROUP_clear_free(EC_GROUP *group);180 181/** Returns the EC_METHOD of the EC_GROUP object.182 *  \param  group  EC_GROUP object183 *  \return EC_METHOD used in this EC_GROUP object.184 */185OSSL_DEPRECATEDIN_3_0 const EC_METHOD *EC_GROUP_method_of(const EC_GROUP *group);186 187/** Returns the field type of the EC_METHOD.188 *  \param  meth  EC_METHOD object189 *  \return NID of the underlying field type OID.190 */191OSSL_DEPRECATEDIN_3_0 int EC_METHOD_get_field_type(const EC_METHOD *meth);192#endif /* OPENSSL_NO_DEPRECATED_3_0 */193 194/** Frees a EC_GROUP object195 *  \param  group  EC_GROUP object to be freed.196 */197void EC_GROUP_free(EC_GROUP *group);198 199/** Copies EC_GROUP objects. Note: both EC_GROUPs must use the same EC_METHOD.200 *  \param  dst  destination EC_GROUP object201 *  \param  src  source EC_GROUP object202 *  \return 1 on success and 0 if an error occurred.203 */204int EC_GROUP_copy(EC_GROUP *dst, const EC_GROUP *src);205 206/** Creates a new EC_GROUP object and copies the content207 *  form src to the newly created EC_KEY object208 *  \param  src  source EC_GROUP object209 *  \return newly created EC_GROUP object or NULL in case of an error.210 */211EC_GROUP *EC_GROUP_dup(const EC_GROUP *src);212 213/** Sets the generator and its order/cofactor of a EC_GROUP object.214 *  \param  group      EC_GROUP object215 *  \param  generator  EC_POINT object with the generator.216 *  \param  order      the order of the group generated by the generator.217 *  \param  cofactor   the index of the sub-group generated by the generator218 *                     in the group of all points on the elliptic curve.219 *  \return 1 on success and 0 if an error occurred220 */221int EC_GROUP_set_generator(EC_GROUP *group, const EC_POINT *generator,222    const BIGNUM *order, const BIGNUM *cofactor);223 224/** Returns the generator of a EC_GROUP object.225 *  \param  group  EC_GROUP object226 *  \return the currently used generator (possibly NULL).227 */228const EC_POINT *EC_GROUP_get0_generator(const EC_GROUP *group);229 230/** Returns the montgomery data for order(Generator)231 *  \param  group  EC_GROUP object232 *  \return the currently used montgomery data (possibly NULL).233 */234BN_MONT_CTX *EC_GROUP_get_mont_data(const EC_GROUP *group);235 236/** Gets the order of a EC_GROUP237 *  \param  group  EC_GROUP object238 *  \param  order  BIGNUM to which the order is copied239 *  \param  ctx    unused240 *  \return 1 on success and 0 if an error occurred241 */242int EC_GROUP_get_order(const EC_GROUP *group, BIGNUM *order, BN_CTX *ctx);243 244/** Gets the order of an EC_GROUP245 *  \param  group  EC_GROUP object246 *  \return the group order247 */248const BIGNUM *EC_GROUP_get0_order(const EC_GROUP *group);249 250/** Gets the number of bits of the order of an EC_GROUP251 *  \param  group  EC_GROUP object252 *  \return number of bits of group order.253 */254int EC_GROUP_order_bits(const EC_GROUP *group);255 256/** Gets the cofactor of a EC_GROUP257 *  \param  group     EC_GROUP object258 *  \param  cofactor  BIGNUM to which the cofactor is copied259 *  \param  ctx       unused260 *  \return 1 on success and 0 if an error occurred261 */262int EC_GROUP_get_cofactor(const EC_GROUP *group, BIGNUM *cofactor,263    BN_CTX *ctx);264 265/** Gets the cofactor of an EC_GROUP266 *  \param  group  EC_GROUP object267 *  \return the group cofactor268 */269const BIGNUM *EC_GROUP_get0_cofactor(const EC_GROUP *group);270 271/** Sets the name of a EC_GROUP object272 *  \param  group  EC_GROUP object273 *  \param  nid    NID of the curve name OID274 */275void EC_GROUP_set_curve_name(EC_GROUP *group, int nid);276 277/** Returns the curve name of a EC_GROUP object278 *  \param  group  EC_GROUP object279 *  \return NID of the curve name OID or 0 if not set.280 */281int EC_GROUP_get_curve_name(const EC_GROUP *group);282 283/** Gets the field of an EC_GROUP284 *  \param  group  EC_GROUP object285 *  \return the group field286 */287const BIGNUM *EC_GROUP_get0_field(const EC_GROUP *group);288 289/** Returns the field type of the EC_GROUP.290 *  \param  group  EC_GROUP object291 *  \return NID of the underlying field type OID.292 */293int EC_GROUP_get_field_type(const EC_GROUP *group);294 295void EC_GROUP_set_asn1_flag(EC_GROUP *group, int flag);296int EC_GROUP_get_asn1_flag(const EC_GROUP *group);297 298void EC_GROUP_set_point_conversion_form(EC_GROUP *group,299    point_conversion_form_t form);300point_conversion_form_t EC_GROUP_get_point_conversion_form(const EC_GROUP *);301 302unsigned char *EC_GROUP_get0_seed(const EC_GROUP *x);303size_t EC_GROUP_get_seed_len(const EC_GROUP *);304size_t EC_GROUP_set_seed(EC_GROUP *, const unsigned char *, size_t len);305 306/** Sets the parameters of an ec curve defined by y^2 = x^3 + a*x + b (for GFp)307 *  or y^2 + x*y = x^3 + a*x^2 + b (for GF2m)308 *  \param  group  EC_GROUP object309 *  \param  p      BIGNUM with the prime number (GFp) or the polynomial310 *                 defining the underlying field (GF2m)311 *  \param  a      BIGNUM with parameter a of the equation312 *  \param  b      BIGNUM with parameter b of the equation313 *  \param  ctx    BN_CTX object (optional)314 *  \return 1 on success and 0 if an error occurred315 */316int EC_GROUP_set_curve(EC_GROUP *group, const BIGNUM *p, const BIGNUM *a,317    const BIGNUM *b, BN_CTX *ctx);318 319/** Gets the parameters of the ec curve defined by y^2 = x^3 + a*x + b (for GFp)320 *  or y^2 + x*y = x^3 + a*x^2 + b (for GF2m)321 *  \param  group  EC_GROUP object322 *  \param  p      BIGNUM with the prime number (GFp) or the polynomial323 *                 defining the underlying field (GF2m)324 *  \param  a      BIGNUM for parameter a of the equation325 *  \param  b      BIGNUM for parameter b of the equation326 *  \param  ctx    BN_CTX object (optional)327 *  \return 1 on success and 0 if an error occurred328 */329int EC_GROUP_get_curve(const EC_GROUP *group, BIGNUM *p, BIGNUM *a, BIGNUM *b,330    BN_CTX *ctx);331 332#ifndef OPENSSL_NO_DEPRECATED_3_0333/** Sets the parameters of an ec curve. Synonym for EC_GROUP_set_curve334 *  \param  group  EC_GROUP object335 *  \param  p      BIGNUM with the prime number (GFp) or the polynomial336 *                 defining the underlying field (GF2m)337 *  \param  a      BIGNUM with parameter a of the equation338 *  \param  b      BIGNUM with parameter b of the equation339 *  \param  ctx    BN_CTX object (optional)340 *  \return 1 on success and 0 if an error occurred341 */342OSSL_DEPRECATEDIN_3_0 int EC_GROUP_set_curve_GFp(EC_GROUP *group,343    const BIGNUM *p,344    const BIGNUM *a,345    const BIGNUM *b,346    BN_CTX *ctx);347 348/** Gets the parameters of an ec curve. Synonym for EC_GROUP_get_curve349 *  \param  group  EC_GROUP object350 *  \param  p      BIGNUM with the prime number (GFp) or the polynomial351 *                 defining the underlying field (GF2m)352 *  \param  a      BIGNUM for parameter a of the equation353 *  \param  b      BIGNUM for parameter b of the equation354 *  \param  ctx    BN_CTX object (optional)355 *  \return 1 on success and 0 if an error occurred356 */357OSSL_DEPRECATEDIN_3_0 int EC_GROUP_get_curve_GFp(const EC_GROUP *group,358    BIGNUM *p,359    BIGNUM *a, BIGNUM *b,360    BN_CTX *ctx);361 362#ifndef OPENSSL_NO_EC2M363/** Sets the parameter of an ec curve. Synonym for EC_GROUP_set_curve364 *  \param  group  EC_GROUP object365 *  \param  p      BIGNUM with the prime number (GFp) or the polynomial366 *                 defining the underlying field (GF2m)367 *  \param  a      BIGNUM with parameter a of the equation368 *  \param  b      BIGNUM with parameter b of the equation369 *  \param  ctx    BN_CTX object (optional)370 *  \return 1 on success and 0 if an error occurred371 */372OSSL_DEPRECATEDIN_3_0 int EC_GROUP_set_curve_GF2m(EC_GROUP *group,373    const BIGNUM *p,374    const BIGNUM *a,375    const BIGNUM *b,376    BN_CTX *ctx);377 378/** Gets the parameters of an ec curve. Synonym for EC_GROUP_get_curve379 *  \param  group  EC_GROUP object380 *  \param  p      BIGNUM with the prime number (GFp) or the polynomial381 *                 defining the underlying field (GF2m)382 *  \param  a      BIGNUM for parameter a of the equation383 *  \param  b      BIGNUM for parameter b of the equation384 *  \param  ctx    BN_CTX object (optional)385 *  \return 1 on success and 0 if an error occurred386 */387OSSL_DEPRECATEDIN_3_0 int EC_GROUP_get_curve_GF2m(const EC_GROUP *group,388    BIGNUM *p,389    BIGNUM *a, BIGNUM *b,390    BN_CTX *ctx);391#endif /* OPENSSL_NO_EC2M */392#endif /* OPENSSL_NO_DEPRECATED_3_0 */393 394/** Returns the number of bits needed to represent a field element395 *  \param  group  EC_GROUP object396 *  \return number of bits needed to represent a field element397 */398int EC_GROUP_get_degree(const EC_GROUP *group);399 400/** Checks whether the parameter in the EC_GROUP define a valid ec group401 *  \param  group  EC_GROUP object402 *  \param  ctx    BN_CTX object (optional)403 *  \return 1 if group is a valid ec group and 0 otherwise404 */405int EC_GROUP_check(const EC_GROUP *group, BN_CTX *ctx);406 407/** Checks whether the discriminant of the elliptic curve is zero or not408 *  \param  group  EC_GROUP object409 *  \param  ctx    BN_CTX object (optional)410 *  \return 1 if the discriminant is not zero and 0 otherwise411 */412int EC_GROUP_check_discriminant(const EC_GROUP *group, BN_CTX *ctx);413 414/** Compares two EC_GROUP objects415 *  \param  a    first EC_GROUP object416 *  \param  b    second EC_GROUP object417 *  \param  ctx  BN_CTX object (optional)418 *  \return 0 if the groups are equal, 1 if not, or -1 on error419 */420int EC_GROUP_cmp(const EC_GROUP *a, const EC_GROUP *b, BN_CTX *ctx);421 422/*423 * EC_GROUP_new_GF*() calls EC_GROUP_new() and EC_GROUP_set_GF*() after424 * choosing an appropriate EC_METHOD425 */426 427/** Creates a new EC_GROUP object with the specified parameters defined428 *  over GFp (defined by the equation y^2 = x^3 + a*x + b)429 *  \param  p    BIGNUM with the prime number430 *  \param  a    BIGNUM with the parameter a of the equation431 *  \param  b    BIGNUM with the parameter b of the equation432 *  \param  ctx  BN_CTX object (optional)433 *  \return newly created EC_GROUP object with the specified parameters434 */435EC_GROUP *EC_GROUP_new_curve_GFp(const BIGNUM *p, const BIGNUM *a,436    const BIGNUM *b, BN_CTX *ctx);437#ifndef OPENSSL_NO_EC2M438/** Creates a new EC_GROUP object with the specified parameters defined439 *  over GF2m (defined by the equation y^2 + x*y = x^3 + a*x^2 + b)440 *  \param  p    BIGNUM with the polynomial defining the underlying field441 *  \param  a    BIGNUM with the parameter a of the equation442 *  \param  b    BIGNUM with the parameter b of the equation443 *  \param  ctx  BN_CTX object (optional)444 *  \return newly created EC_GROUP object with the specified parameters445 */446EC_GROUP *EC_GROUP_new_curve_GF2m(const BIGNUM *p, const BIGNUM *a,447    const BIGNUM *b, BN_CTX *ctx);448#endif449 450/**451 * Creates a EC_GROUP object with a curve specified by parameters.452 * The parameters may be explicit or a named curve,453 *  \param  params A list of parameters describing the group.454 *  \param  libctx The associated library context or NULL for the default455 *                 context456 *  \param  propq  A property query string457 *  \return newly created EC_GROUP object with specified parameters or NULL458 *          if an error occurred459 */460EC_GROUP *EC_GROUP_new_from_params(const OSSL_PARAM params[],461    OSSL_LIB_CTX *libctx, const char *propq);462 463/**464 * Creates an OSSL_PARAM array with the parameters describing the given465 * EC_GROUP.466 * The resulting parameters may contain an explicit or a named curve depending467 * on the EC_GROUP.468 *  \param  group  pointer to the EC_GROUP object469 *  \param  libctx The associated library context or NULL for the default470 *                 context471 *  \param  propq  A property query string472 *  \param  bnctx  BN_CTX object (optional)473 *  \return newly created OSSL_PARAM array with the parameters474 *          describing the given EC_GROUP or NULL if an error occurred475 */476OSSL_PARAM *EC_GROUP_to_params(const EC_GROUP *group, OSSL_LIB_CTX *libctx,477    const char *propq, BN_CTX *bnctx);478 479/**480 * Creates a EC_GROUP object with a curve specified by a NID481 *  \param  libctx The associated library context or NULL for the default482 *                 context483 *  \param  propq  A property query string484 *  \param  nid    NID of the OID of the curve name485 *  \return newly created EC_GROUP object with specified curve or NULL486 *          if an error occurred487 */488EC_GROUP *EC_GROUP_new_by_curve_name_ex(OSSL_LIB_CTX *libctx, const char *propq,489    int nid);490 491/**492 * Creates a EC_GROUP object with a curve specified by a NID. Same as493 * EC_GROUP_new_by_curve_name_ex but the libctx and propq are always494 * NULL.495 *  \param  nid    NID of the OID of the curve name496 *  \return newly created EC_GROUP object with specified curve or NULL497 *          if an error occurred498 */499EC_GROUP *EC_GROUP_new_by_curve_name(int nid);500 501/** Creates a new EC_GROUP object from an ECPARAMETERS object502 *  \param  params  pointer to the ECPARAMETERS object503 *  \return newly created EC_GROUP object with specified curve or NULL504 *          if an error occurred505 */506EC_GROUP *EC_GROUP_new_from_ecparameters(const ECPARAMETERS *params);507 508/** Creates an ECPARAMETERS object for the given EC_GROUP object.509 *  \param  group   pointer to the EC_GROUP object510 *  \param  params  pointer to an existing ECPARAMETERS object or NULL511 *  \return pointer to the new ECPARAMETERS object or NULL512 *          if an error occurred.513 */514ECPARAMETERS *EC_GROUP_get_ecparameters(const EC_GROUP *group,515    ECPARAMETERS *params);516 517/** Creates a new EC_GROUP object from an ECPKPARAMETERS object518 *  \param  params  pointer to an existing ECPKPARAMETERS object, or NULL519 *  \return newly created EC_GROUP object with specified curve, or NULL520 *          if an error occurred521 */522EC_GROUP *EC_GROUP_new_from_ecpkparameters(const ECPKPARAMETERS *params);523 524/** Creates an ECPKPARAMETERS object for the given EC_GROUP object.525 *  \param  group   pointer to the EC_GROUP object526 *  \param  params  pointer to an existing ECPKPARAMETERS object or NULL527 *  \return pointer to the new ECPKPARAMETERS object or NULL528 *          if an error occurred.529 */530ECPKPARAMETERS *EC_GROUP_get_ecpkparameters(const EC_GROUP *group,531    ECPKPARAMETERS *params);532 533/********************************************************************/534/*               handling of internal curves                        */535/********************************************************************/536 537typedef struct {538    int nid;539    const char *comment;540} EC_builtin_curve;541 542/*543 * EC_builtin_curves(EC_builtin_curve *r, size_t size) returns number of all544 * available curves or zero if a error occurred. In case r is not zero,545 * nitems EC_builtin_curve structures are filled with the data of the first546 * nitems internal groups547 */548size_t EC_get_builtin_curves(EC_builtin_curve *r, size_t nitems);549 550const char *EC_curve_nid2nist(int nid);551int EC_curve_nist2nid(const char *name);552int EC_GROUP_check_named_curve(const EC_GROUP *group, int nist_only,553    BN_CTX *ctx);554 555/********************************************************************/556/*                    EC_POINT functions                            */557/********************************************************************/558 559/** Creates a new EC_POINT object for the specified EC_GROUP560 *  \param  group  EC_GROUP the underlying EC_GROUP object561 *  \return newly created EC_POINT object or NULL if an error occurred562 */563EC_POINT *EC_POINT_new(const EC_GROUP *group);564 565/** Frees a EC_POINT object566 *  \param  point  EC_POINT object to be freed567 */568void EC_POINT_free(EC_POINT *point);569 570/** Clears and frees a EC_POINT object571 *  \param  point  EC_POINT object to be cleared and freed572 */573void EC_POINT_clear_free(EC_POINT *point);574 575/** Copies EC_POINT object576 *  \param  dst  destination EC_POINT object577 *  \param  src  source EC_POINT object578 *  \return 1 on success and 0 if an error occurred579 */580int EC_POINT_copy(EC_POINT *dst, const EC_POINT *src);581 582/** Creates a new EC_POINT object and copies the content of the supplied583 *  EC_POINT584 *  \param  src    source EC_POINT object585 *  \param  group  underlying the EC_GROUP object586 *  \return newly created EC_POINT object or NULL if an error occurred587 */588EC_POINT *EC_POINT_dup(const EC_POINT *src, const EC_GROUP *group);589 590/** Sets a point to infinity (neutral element)591 *  \param  group  underlying EC_GROUP object592 *  \param  point  EC_POINT to set to infinity593 *  \return 1 on success and 0 if an error occurred594 */595int EC_POINT_set_to_infinity(const EC_GROUP *group, EC_POINT *point);596 597#ifndef OPENSSL_NO_DEPRECATED_3_0598/** Returns the EC_METHOD used in EC_POINT object599 *  \param  point  EC_POINT object600 *  \return the EC_METHOD used601 */602OSSL_DEPRECATEDIN_3_0 const EC_METHOD *EC_POINT_method_of(const EC_POINT *point);603 604/** Sets the jacobian projective coordinates of a EC_POINT over GFp605 *  \param  group  underlying EC_GROUP object606 *  \param  p      EC_POINT object607 *  \param  x      BIGNUM with the x-coordinate608 *  \param  y      BIGNUM with the y-coordinate609 *  \param  z      BIGNUM with the z-coordinate610 *  \param  ctx    BN_CTX object (optional)611 *  \return 1 on success and 0 if an error occurred612 */613OSSL_DEPRECATEDIN_3_0 int EC_POINT_set_Jprojective_coordinates_GFp(const EC_GROUP *group, EC_POINT *p,614    const BIGNUM *x, const BIGNUM *y, const BIGNUM *z,615    BN_CTX *ctx);616 617/** Gets the jacobian projective coordinates of a EC_POINT over GFp618 *  \param  group  underlying EC_GROUP object619 *  \param  p      EC_POINT object620 *  \param  x      BIGNUM for the x-coordinate621 *  \param  y      BIGNUM for the y-coordinate622 *  \param  z      BIGNUM for the z-coordinate623 *  \param  ctx    BN_CTX object (optional)624 *  \return 1 on success and 0 if an error occurred625 */626OSSL_DEPRECATEDIN_3_0 int EC_POINT_get_Jprojective_coordinates_GFp(const EC_GROUP *group, const EC_POINT *p,627    BIGNUM *x, BIGNUM *y, BIGNUM *z, BN_CTX *ctx);628#endif /* OPENSSL_NO_DEPRECATED_3_0 */629 630/** Sets the affine coordinates of an EC_POINT631 *  \param  group  underlying EC_GROUP object632 *  \param  p      EC_POINT object633 *  \param  x      BIGNUM with the x-coordinate634 *  \param  y      BIGNUM with the y-coordinate635 *  \param  ctx    BN_CTX object (optional)636 *  \return 1 on success and 0 if an error occurred637 */638int EC_POINT_set_affine_coordinates(const EC_GROUP *group, EC_POINT *p,639    const BIGNUM *x, const BIGNUM *y,640    BN_CTX *ctx);641 642/** Gets the affine coordinates of an EC_POINT.643 *  \param  group  underlying EC_GROUP object644 *  \param  p      EC_POINT object645 *  \param  x      BIGNUM for the x-coordinate646 *  \param  y      BIGNUM for the y-coordinate647 *  \param  ctx    BN_CTX object (optional)648 *  \return 1 on success and 0 if an error occurred649 */650int EC_POINT_get_affine_coordinates(const EC_GROUP *group, const EC_POINT *p,651    BIGNUM *x, BIGNUM *y, BN_CTX *ctx);652 653#ifndef OPENSSL_NO_DEPRECATED_3_0654/** Sets the affine coordinates of an EC_POINT. A synonym of655 *  EC_POINT_set_affine_coordinates656 *  \param  group  underlying EC_GROUP object657 *  \param  p      EC_POINT object658 *  \param  x      BIGNUM with the x-coordinate659 *  \param  y      BIGNUM with the y-coordinate660 *  \param  ctx    BN_CTX object (optional)661 *  \return 1 on success and 0 if an error occurred662 */663OSSL_DEPRECATEDIN_3_0 int EC_POINT_set_affine_coordinates_GFp(const EC_GROUP *group, EC_POINT *p,664    const BIGNUM *x, const BIGNUM *y, BN_CTX *ctx);665 666/** Gets the affine coordinates of an EC_POINT. A synonym of667 *  EC_POINT_get_affine_coordinates668 *  \param  group  underlying EC_GROUP object669 *  \param  p      EC_POINT object670 *  \param  x      BIGNUM for the x-coordinate671 *  \param  y      BIGNUM for the y-coordinate672 *  \param  ctx    BN_CTX object (optional)673 *  \return 1 on success and 0 if an error occurred674 */675OSSL_DEPRECATEDIN_3_0 int EC_POINT_get_affine_coordinates_GFp(const EC_GROUP *group, const EC_POINT *p,676    BIGNUM *x, BIGNUM *y, BN_CTX *ctx);677#endif /* OPENSSL_NO_DEPRECATED_3_0 */678 679/** Sets the x9.62 compressed coordinates of a EC_POINT680 *  \param  group  underlying EC_GROUP object681 *  \param  p      EC_POINT object682 *  \param  x      BIGNUM with x-coordinate683 *  \param  y_bit  integer with the y-Bit (either 0 or 1)684 *  \param  ctx    BN_CTX object (optional)685 *  \return 1 on success and 0 if an error occurred686 */687int EC_POINT_set_compressed_coordinates(const EC_GROUP *group, EC_POINT *p,688    const BIGNUM *x, int y_bit,689    BN_CTX *ctx);690 691#ifndef OPENSSL_NO_DEPRECATED_3_0692/** Sets the x9.62 compressed coordinates of a EC_POINT. A synonym of693 *  EC_POINT_set_compressed_coordinates694 *  \param  group  underlying EC_GROUP object695 *  \param  p      EC_POINT object696 *  \param  x      BIGNUM with x-coordinate697 *  \param  y_bit  integer with the y-Bit (either 0 or 1)698 *  \param  ctx    BN_CTX object (optional)699 *  \return 1 on success and 0 if an error occurred700 */701OSSL_DEPRECATEDIN_3_0 int EC_POINT_set_compressed_coordinates_GFp(const EC_GROUP *group, EC_POINT *p,702    const BIGNUM *x, int y_bit, BN_CTX *ctx);703#ifndef OPENSSL_NO_EC2M704/** Sets the affine coordinates of an EC_POINT. A synonym of705 *  EC_POINT_set_affine_coordinates706 *  \param  group  underlying EC_GROUP object707 *  \param  p      EC_POINT object708 *  \param  x      BIGNUM with the x-coordinate709 *  \param  y      BIGNUM with the y-coordinate710 *  \param  ctx    BN_CTX object (optional)711 *  \return 1 on success and 0 if an error occurred712 */713OSSL_DEPRECATEDIN_3_0 int EC_POINT_set_affine_coordinates_GF2m(const EC_GROUP *group, EC_POINT *p,714    const BIGNUM *x, const BIGNUM *y, BN_CTX *ctx);715 716/** Gets the affine coordinates of an EC_POINT. A synonym of717 *  EC_POINT_get_affine_coordinates718 *  \param  group  underlying EC_GROUP object719 *  \param  p      EC_POINT object720 *  \param  x      BIGNUM for the x-coordinate721 *  \param  y      BIGNUM for the y-coordinate722 *  \param  ctx    BN_CTX object (optional)723 *  \return 1 on success and 0 if an error occurred724 */725OSSL_DEPRECATEDIN_3_0 int EC_POINT_get_affine_coordinates_GF2m(const EC_GROUP *group, const EC_POINT *p,726    BIGNUM *x, BIGNUM *y, BN_CTX *ctx);727 728/** Sets the x9.62 compressed coordinates of a EC_POINT. A synonym of729 *  EC_POINT_set_compressed_coordinates730 *  \param  group  underlying EC_GROUP object731 *  \param  p      EC_POINT object732 *  \param  x      BIGNUM with x-coordinate733 *  \param  y_bit  integer with the y-Bit (either 0 or 1)734 *  \param  ctx    BN_CTX object (optional)735 *  \return 1 on success and 0 if an error occurred736 */737OSSL_DEPRECATEDIN_3_0 int EC_POINT_set_compressed_coordinates_GF2m(const EC_GROUP *group, EC_POINT *p,738    const BIGNUM *x, int y_bit, BN_CTX *ctx);739#endif740#endif /* OPENSSL_NO_DEPRECATED_3_0 */741 742/** Encodes a EC_POINT object to a octet string743 *  \param  group  underlying EC_GROUP object744 *  \param  p      EC_POINT object745 *  \param  form   point conversion form746 *  \param  buf    memory buffer for the result. If NULL the function returns747 *                 required buffer size.748 *  \param  len    length of the memory buffer749 *  \param  ctx    BN_CTX object (optional)750 *  \return the length of the encoded octet string or 0 if an error occurred751 */752size_t EC_POINT_point2oct(const EC_GROUP *group, const EC_POINT *p,753    point_conversion_form_t form,754    unsigned char *buf, size_t len, BN_CTX *ctx);755 756/** Decodes a EC_POINT from a octet string757 *  \param  group  underlying EC_GROUP object758 *  \param  p      EC_POINT object759 *  \param  buf    memory buffer with the encoded ec point760 *  \param  len    length of the encoded ec point761 *  \param  ctx    BN_CTX object (optional)762 *  \return 1 on success and 0 if an error occurred763 */764int EC_POINT_oct2point(const EC_GROUP *group, EC_POINT *p,765    const unsigned char *buf, size_t len, BN_CTX *ctx);766 767/** Encodes an EC_POINT object to an allocated octet string768 *  \param  group  underlying EC_GROUP object769 *  \param  point  EC_POINT object770 *  \param  form   point conversion form771 *  \param  pbuf   returns pointer to allocated buffer772 *  \param  ctx    BN_CTX object (optional)773 *  \return the length of the encoded octet string or 0 if an error occurred774 */775size_t EC_POINT_point2buf(const EC_GROUP *group, const EC_POINT *point,776    point_conversion_form_t form,777    unsigned char **pbuf, BN_CTX *ctx);778 779/* other interfaces to point2oct/oct2point: */780#ifndef OPENSSL_NO_DEPRECATED_3_0781OSSL_DEPRECATEDIN_3_0 BIGNUM *EC_POINT_point2bn(const EC_GROUP *,782    const EC_POINT *,783    point_conversion_form_t form,784    BIGNUM *, BN_CTX *);785OSSL_DEPRECATEDIN_3_0 EC_POINT *EC_POINT_bn2point(const EC_GROUP *,786    const BIGNUM *,787    EC_POINT *, BN_CTX *);788#endif /* OPENSSL_NO_DEPRECATED_3_0 */789 790char *EC_POINT_point2hex(const EC_GROUP *, const EC_POINT *,791    point_conversion_form_t form, BN_CTX *);792EC_POINT *EC_POINT_hex2point(const EC_GROUP *, const char *,793    EC_POINT *, BN_CTX *);794 795/********************************************************************/796/*         functions for doing EC_POINT arithmetic                  */797/********************************************************************/798 799/** Computes the sum of two EC_POINT800 *  \param  group  underlying EC_GROUP object801 *  \param  r      EC_POINT object for the result (r = a + b)802 *  \param  a      EC_POINT object with the first summand803 *  \param  b      EC_POINT object with the second summand804 *  \param  ctx    BN_CTX object (optional)805 *  \return 1 on success and 0 if an error occurred806 */807int EC_POINT_add(const EC_GROUP *group, EC_POINT *r, const EC_POINT *a,808    const EC_POINT *b, BN_CTX *ctx);809 810/** Computes the double of a EC_POINT811 *  \param  group  underlying EC_GROUP object812 *  \param  r      EC_POINT object for the result (r = 2 * a)813 *  \param  a      EC_POINT object814 *  \param  ctx    BN_CTX object (optional)815 *  \return 1 on success and 0 if an error occurred816 */817int EC_POINT_dbl(const EC_GROUP *group, EC_POINT *r, const EC_POINT *a,818    BN_CTX *ctx);819 820/** Computes the inverse of a EC_POINT821 *  \param  group  underlying EC_GROUP object822 *  \param  a      EC_POINT object to be inverted (it's used for the result as well)823 *  \param  ctx    BN_CTX object (optional)824 *  \return 1 on success and 0 if an error occurred825 */826int EC_POINT_invert(const EC_GROUP *group, EC_POINT *a, BN_CTX *ctx);827 828/** Checks whether the point is the neutral element of the group829 *  \param  group  the underlying EC_GROUP object830 *  \param  p      EC_POINT object831 *  \return 1 if the point is the neutral element and 0 otherwise832 */833int EC_POINT_is_at_infinity(const EC_GROUP *group, const EC_POINT *p);834 835/** Checks whether the point is on the curve836 *  \param  group  underlying EC_GROUP object837 *  \param  point  EC_POINT object to check838 *  \param  ctx    BN_CTX object (optional)839 *  \return 1 if the point is on the curve, 0 if not, or -1 on error840 */841int EC_POINT_is_on_curve(const EC_GROUP *group, const EC_POINT *point,842    BN_CTX *ctx);843 844/** Compares two EC_POINTs845 *  \param  group  underlying EC_GROUP object846 *  \param  a      first EC_POINT object847 *  \param  b      second EC_POINT object848 *  \param  ctx    BN_CTX object (optional)849 *  \return 1 if the points are not equal, 0 if they are, or -1 on error850 */851int EC_POINT_cmp(const EC_GROUP *group, const EC_POINT *a, const EC_POINT *b,852    BN_CTX *ctx);853 854#ifndef OPENSSL_NO_DEPRECATED_3_0855OSSL_DEPRECATEDIN_3_0 int EC_POINT_make_affine(const EC_GROUP *group,856    EC_POINT *point, BN_CTX *ctx);857OSSL_DEPRECATEDIN_3_0 int EC_POINTs_make_affine(const EC_GROUP *group, size_t num,858    EC_POINT *points[], BN_CTX *ctx);859 860/** Computes r = generator * n + sum_{i=0}^{num-1} p[i] * m[i]861 *  \param  group  underlying EC_GROUP object862 *  \param  r      EC_POINT object for the result863 *  \param  n      BIGNUM with the multiplier for the group generator (optional)864 *  \param  num    number further summands865 *  \param  p      array of size num of EC_POINT objects866 *  \param  m      array of size num of BIGNUM objects867 *  \param  ctx    BN_CTX object (optional)868 *  \return 1 on success and 0 if an error occurred869 */870OSSL_DEPRECATEDIN_3_0 int EC_POINTs_mul(const EC_GROUP *group, EC_POINT *r,871    const BIGNUM *n, size_t num,872    const EC_POINT *p[], const BIGNUM *m[],873    BN_CTX *ctx);874#endif /* OPENSSL_NO_DEPRECATED_3_0 */875 876/** Computes r = generator * n + q * m877 *  \param  group  underlying EC_GROUP object878 *  \param  r      EC_POINT object for the result879 *  \param  n      BIGNUM with the multiplier for the group generator (optional)880 *  \param  q      EC_POINT object with the first factor of the second summand881 *  \param  m      BIGNUM with the second factor of the second summand882 *  \param  ctx    BN_CTX object (optional)883 *  \return 1 on success and 0 if an error occurred884 */885int EC_POINT_mul(const EC_GROUP *group, EC_POINT *r, const BIGNUM *n,886    const EC_POINT *q, const BIGNUM *m, BN_CTX *ctx);887 888#ifndef OPENSSL_NO_DEPRECATED_3_0889/** Stores multiples of generator for faster point multiplication890 *  \param  group  EC_GROUP object891 *  \param  ctx    BN_CTX object (optional)892 *  \return 1 on success and 0 if an error occurred893 */894OSSL_DEPRECATEDIN_3_0 int EC_GROUP_precompute_mult(EC_GROUP *group, BN_CTX *ctx);895 896/** Reports whether a precomputation has been done897 *  \param  group  EC_GROUP object898 *  \return 1 if a pre-computation has been done and 0 otherwise899 */900OSSL_DEPRECATEDIN_3_0 int EC_GROUP_have_precompute_mult(const EC_GROUP *group);901#endif /* OPENSSL_NO_DEPRECATED_3_0 */902 903/********************************************************************/904/*                       ASN1 stuff                                 */905/********************************************************************/906 907DECLARE_ASN1_ITEM(ECPKPARAMETERS)908DECLARE_ASN1_ALLOC_FUNCTIONS(ECPKPARAMETERS)909DECLARE_ASN1_ITEM(ECPARAMETERS)910DECLARE_ASN1_ALLOC_FUNCTIONS(ECPARAMETERS)911 912/*913 * EC_GROUP_get_basis_type() returns the NID of the basis type used to914 * represent the field elements915 */916int EC_GROUP_get_basis_type(const EC_GROUP *);917#ifndef OPENSSL_NO_EC2M918int EC_GROUP_get_trinomial_basis(const EC_GROUP *, unsigned int *k);919int EC_GROUP_get_pentanomial_basis(const EC_GROUP *, unsigned int *k1,920    unsigned int *k2, unsigned int *k3);921#endif922 923EC_GROUP *d2i_ECPKParameters(EC_GROUP **, const unsigned char **in, long len);924int i2d_ECPKParameters(const EC_GROUP *, unsigned char **out);925 926#define d2i_ECPKParameters_bio(bp, x) \927    ASN1_d2i_bio_of(EC_GROUP, NULL, d2i_ECPKParameters, bp, x)928#define i2d_ECPKParameters_bio(bp, x) \929    ASN1_i2d_bio_of(EC_GROUP, i2d_ECPKParameters, bp, x)930#define d2i_ECPKParameters_fp(fp, x)                                       \931    (EC_GROUP *)ASN1_d2i_fp(NULL, (d2i_of_void *)d2i_ECPKParameters, (fp), \932        (void **)(x))933#define i2d_ECPKParameters_fp(fp, x) \934    ASN1_i2d_fp((i2d_of_void *)i2d_ECPKParameters, (fp), (void *)(x))935 936#ifndef OPENSSL_NO_DEPRECATED_3_0937OSSL_DEPRECATEDIN_3_0 int ECPKParameters_print(BIO *bp, const EC_GROUP *x,938    int off);939#ifndef OPENSSL_NO_STDIO940OSSL_DEPRECATEDIN_3_0 int ECPKParameters_print_fp(FILE *fp, const EC_GROUP *x,941    int off);942#endif943#endif /* OPENSSL_NO_DEPRECATED_3_0 */944 945/********************************************************************/946/*                      EC_KEY functions                            */947/********************************************************************/948 949/* some values for the encoding_flag */950#define EC_PKEY_NO_PARAMETERS 0x001951#define EC_PKEY_NO_PUBKEY 0x002952 953/* some values for the flags field */954#define EC_FLAG_SM2_RANGE 0x0004955#define EC_FLAG_COFACTOR_ECDH 0x1000956#define EC_FLAG_CHECK_NAMED_GROUP 0x2000957#define EC_FLAG_CHECK_NAMED_GROUP_NIST 0x4000958#define EC_FLAG_CHECK_NAMED_GROUP_MASK \959    (EC_FLAG_CHECK_NAMED_GROUP | EC_FLAG_CHECK_NAMED_GROUP_NIST)960 961/* Deprecated flags -  it was using 0x01..0x02 */962#define EC_FLAG_NON_FIPS_ALLOW 0x0000963#define EC_FLAG_FIPS_CHECKED 0x0000964 965#ifndef OPENSSL_NO_DEPRECATED_3_0966/**967 *  Creates a new EC_KEY object.968 *  \param  ctx  The library context for to use for this EC_KEY. May be NULL in969 *               which case the default library context is used.970 *  \return EC_KEY object or NULL if an error occurred.971 */972OSSL_DEPRECATEDIN_3_0 EC_KEY *EC_KEY_new_ex(OSSL_LIB_CTX *ctx, const char *propq);973 974/**975 *  Creates a new EC_KEY object. Same as calling EC_KEY_new_ex with a976 *  NULL library context977 *  \return EC_KEY object or NULL if an error occurred.978 */979OSSL_DEPRECATEDIN_3_0 EC_KEY *EC_KEY_new(void);980 981OSSL_DEPRECATEDIN_3_0 int EC_KEY_get_flags(const EC_KEY *key);982 983OSSL_DEPRECATEDIN_3_0 void EC_KEY_set_flags(EC_KEY *key, int flags);984 985OSSL_DEPRECATEDIN_3_0 void EC_KEY_clear_flags(EC_KEY *key, int flags);986 987OSSL_DEPRECATEDIN_3_0 int EC_KEY_decoded_from_explicit_params(const EC_KEY *key);988 989/**990 *  Creates a new EC_KEY object using a named curve as underlying991 *  EC_GROUP object.992 *  \param  ctx   The library context for to use for this EC_KEY. May be NULL in993 *                which case the default library context is used.994 *  \param  propq Any property query string995 *  \param  nid   NID of the named curve.996 *  \return EC_KEY object or NULL if an error occurred.997 */998OSSL_DEPRECATEDIN_3_0 EC_KEY *EC_KEY_new_by_curve_name_ex(OSSL_LIB_CTX *ctx,999    const char *propq,1000    int nid);1001 1002/**1003 *  Creates a new EC_KEY object using a named curve as underlying1004 *  EC_GROUP object. Same as calling EC_KEY_new_by_curve_name_ex with a NULL1005 *  library context and property query string.1006 *  \param  nid  NID of the named curve.1007 *  \return EC_KEY object or NULL if an error occurred.1008 */1009OSSL_DEPRECATEDIN_3_0 EC_KEY *EC_KEY_new_by_curve_name(int nid);1010 1011/** Frees a EC_KEY object.1012 *  \param  key  EC_KEY object to be freed.1013 */1014OSSL_DEPRECATEDIN_3_0 void EC_KEY_free(EC_KEY *key);1015 1016/** Copies a EC_KEY object.1017 *  \param  dst  destination EC_KEY object1018 *  \param  src  src EC_KEY object1019 *  \return dst or NULL if an error occurred.1020 */1021OSSL_DEPRECATEDIN_3_0 EC_KEY *EC_KEY_copy(EC_KEY *dst, const EC_KEY *src);1022 1023/** Creates a new EC_KEY object and copies the content from src to it.1024 *  \param  src  the source EC_KEY object1025 *  \return newly created EC_KEY object or NULL if an error occurred.1026 */1027OSSL_DEPRECATEDIN_3_0 EC_KEY *EC_KEY_dup(const EC_KEY *src);1028 1029/** Increases the internal reference count of a EC_KEY object.1030 *  \param  key  EC_KEY object1031 *  \return 1 on success and 0 if an error occurred.1032 */1033OSSL_DEPRECATEDIN_3_0 int EC_KEY_up_ref(EC_KEY *key);1034 1035/** Returns the ENGINE object of a EC_KEY object1036 *  \param  eckey  EC_KEY object1037 *  \return the ENGINE object (possibly NULL).1038 */1039OSSL_DEPRECATEDIN_3_0 ENGINE *EC_KEY_get0_engine(const EC_KEY *eckey);1040 1041/** Returns the EC_GROUP object of a EC_KEY object1042 *  \param  key  EC_KEY object1043 *  \return the EC_GROUP object (possibly NULL).1044 */1045OSSL_DEPRECATEDIN_3_0 const EC_GROUP *EC_KEY_get0_group(const EC_KEY *key);1046 1047/** Sets the EC_GROUP of a EC_KEY object.1048 *  \param  key    EC_KEY object1049 *  \param  group  EC_GROUP to use in the EC_KEY object (note: the EC_KEY1050 *                 object will use an own copy of the EC_GROUP).1051 *  \return 1 on success and 0 if an error occurred.1052 */1053OSSL_DEPRECATEDIN_3_0 int EC_KEY_set_group(EC_KEY *key, const EC_GROUP *group);1054 1055/** Returns the private key of a EC_KEY object.1056 *  \param  key  EC_KEY object1057 *  \return a BIGNUM with the private key (possibly NULL).1058 */1059OSSL_DEPRECATEDIN_3_0 const BIGNUM *EC_KEY_get0_private_key(const EC_KEY *key);1060 1061/** Sets the private key of a EC_KEY object.1062 *  \param  key  EC_KEY object1063 *  \param  prv  BIGNUM with the private key (note: the EC_KEY object1064 *               will use an own copy of the BIGNUM).1065 *  \return 1 on success and 0 if an error occurred.1066 */1067OSSL_DEPRECATEDIN_3_0 int EC_KEY_set_private_key(EC_KEY *key, const BIGNUM *prv);1068 1069/** Returns the public key of a EC_KEY object.1070 *  \param  key  the EC_KEY object1071 *  \return a EC_POINT object with the public key (possibly NULL)1072 */1073OSSL_DEPRECATEDIN_3_0 const EC_POINT *EC_KEY_get0_public_key(const EC_KEY *key);1074 1075/** Sets the public key of a EC_KEY object.1076 *  \param  key  EC_KEY object1077 *  \param  pub  EC_POINT object with the public key (note: the EC_KEY object1078 *               will use an own copy of the EC_POINT object).1079 *  \return 1 on success and 0 if an error occurred.1080 */1081OSSL_DEPRECATEDIN_3_0 int EC_KEY_set_public_key(EC_KEY *key, const EC_POINT *pub);1082 1083OSSL_DEPRECATEDIN_3_0 unsigned EC_KEY_get_enc_flags(const EC_KEY *key);1084OSSL_DEPRECATEDIN_3_0 void EC_KEY_set_enc_flags(EC_KEY *eckey, unsigned int flags);1085OSSL_DEPRECATEDIN_3_0 point_conversion_form_t EC_KEY_get_conv_form(const EC_KEY *key);1086OSSL_DEPRECATEDIN_3_0 void EC_KEY_set_conv_form(EC_KEY *eckey,1087    point_conversion_form_t cform);1088#endif /*OPENSSL_NO_DEPRECATED_3_0 */1089 1090#define EC_KEY_get_ex_new_index(l, p, newf, dupf, freef) \1091    CRYPTO_get_ex_new_index(CRYPTO_EX_INDEX_EC_KEY, l, p, newf, dupf, freef)1092 1093#ifndef OPENSSL_NO_DEPRECATED_3_01094OSSL_DEPRECATEDIN_3_0 int EC_KEY_set_ex_data(EC_KEY *key, int idx, void *arg);1095OSSL_DEPRECATEDIN_3_0 void *EC_KEY_get_ex_data(const EC_KEY *key, int idx);1096 1097/* wrapper functions for the underlying EC_GROUP object */1098OSSL_DEPRECATEDIN_3_0 void EC_KEY_set_asn1_flag(EC_KEY *eckey, int asn1_flag);1099 1100/** Creates a table of pre-computed multiples of the generator to1101 *  accelerate further EC_KEY operations.1102 *  \param  key  EC_KEY object1103 *  \param  ctx  BN_CTX object (optional)1104 *  \return 1 on success and 0 if an error occurred.1105 */1106OSSL_DEPRECATEDIN_3_0 int EC_KEY_precompute_mult(EC_KEY *key, BN_CTX *ctx);1107 1108/** Creates a new ec private (and optional a new public) key.1109 *  \param  key  EC_KEY object1110 *  \return 1 on success and 0 if an error occurred.1111 */1112OSSL_DEPRECATEDIN_3_0 int EC_KEY_generate_key(EC_KEY *key);1113 1114/** Verifies that a private and/or public key is valid.1115 *  \param  key  the EC_KEY object1116 *  \return 1 on success and 0 otherwise.1117 */1118OSSL_DEPRECATEDIN_3_0 int EC_KEY_check_key(const EC_KEY *key);1119 1120/** Indicates if an EC_KEY can be used for signing.1121 *  \param  eckey  the EC_KEY object1122 *  \return 1 if can sign and 0 otherwise.1123 */1124OSSL_DEPRECATEDIN_3_0 int EC_KEY_can_sign(const EC_KEY *eckey);1125 1126/** Sets a public key from affine coordinates performing1127 *  necessary NIST PKV tests.1128 *  \param  key  the EC_KEY object1129 *  \param  x    public key x coordinate1130 *  \param  y    public key y coordinate1131 *  \return 1 on success and 0 otherwise.1132 */1133OSSL_DEPRECATEDIN_3_0 int EC_KEY_set_public_key_affine_coordinates(EC_KEY *key,1134    BIGNUM *x,1135    BIGNUM *y);1136 1137/** Encodes an EC_KEY public key to an allocated octet string1138 *  \param  key    key to encode1139 *  \param  form   point conversion form1140 *  \param  pbuf   returns pointer to allocated buffer1141 *  \param  ctx    BN_CTX object (optional)1142 *  \return the length of the encoded octet string or 0 if an error occurred1143 */1144OSSL_DEPRECATEDIN_3_0 size_t EC_KEY_key2buf(const EC_KEY *key,1145    point_conversion_form_t form,1146    unsigned char **pbuf, BN_CTX *ctx);1147 1148/** Decodes a EC_KEY public key from a octet string1149 *  \param  key    key to decode1150 *  \param  buf    memory buffer with the encoded ec point1151 *  \param  len    length of the encoded ec point1152 *  \param  ctx    BN_CTX object (optional)1153 *  \return 1 on success and 0 if an error occurred1154 */1155 1156OSSL_DEPRECATEDIN_3_0 int EC_KEY_oct2key(EC_KEY *key, const unsigned char *buf,1157    size_t len, BN_CTX *ctx);1158 1159/** Decodes an EC_KEY private key from an octet string1160 *  \param  key    key to decode1161 *  \param  buf    memory buffer with the encoded private key1162 *  \param  len    length of the encoded key1163 *  \return 1 on success and 0 if an error occurred1164 */1165 1166OSSL_DEPRECATEDIN_3_0 int EC_KEY_oct2priv(EC_KEY *key, const unsigned char *buf,1167    size_t len);1168 1169/** Encodes a EC_KEY private key to an octet string1170 *  \param  key    key to encode1171 *  \param  buf    memory buffer for the result. If NULL the function returns1172 *                 required buffer size.1173 *  \param  len    length of the memory buffer1174 *  \return the length of the encoded octet string or 0 if an error occurred1175 */1176 1177OSSL_DEPRECATEDIN_3_0 size_t EC_KEY_priv2oct(const EC_KEY *key,1178    unsigned char *buf, size_t len);1179 1180/** Encodes an EC_KEY private key to an allocated octet string1181 *  \param  eckey  key to encode1182 *  \param  pbuf   returns pointer to allocated buffer1183 *  \return the length of the encoded octet string or 0 if an error occurred1184 */1185OSSL_DEPRECATEDIN_3_0 size_t EC_KEY_priv2buf(const EC_KEY *eckey,1186    unsigned char **pbuf);1187 1188/********************************************************************/1189/*        de- and encoding functions for SEC1 ECPrivateKey          */1190/********************************************************************/1191 1192/** Decodes a private key from a memory buffer.1193 *  \param  key  a pointer to a EC_KEY object which should be used (or NULL)1194 *  \param  in   pointer to memory with the DER encoded private key1195 *  \param  len  length of the DER encoded private key1196 *  \return the decoded private key or NULL if an error occurred.1197 */1198OSSL_DEPRECATEDIN_3_0 EC_KEY *d2i_ECPrivateKey(EC_KEY **key,1199    const unsigned char **in,1200    long len);1201 1202/** Encodes a private key object and stores the result in a buffer.1203 *  \param  key  the EC_KEY object to encode1204 *  \param  out  the buffer for the result (if NULL the function returns number1205 *               of bytes needed).1206 *  \return 1 on success and 0 if an error occurred.1207 */1208OSSL_DEPRECATEDIN_3_0 int i2d_ECPrivateKey(const EC_KEY *key,1209    unsigned char **out);1210 1211/********************************************************************/1212/*        de- and encoding functions for EC parameters              */1213/********************************************************************/1214 1215/** Decodes ec parameter from a memory buffer.1216 *  \param  key  a pointer to a EC_KEY object which should be used (or NULL)1217 *  \param  in   pointer to memory with the DER encoded ec parameters1218 *  \param  len  length of the DER encoded ec parameters1219 *  \return a EC_KEY object with the decoded parameters or NULL if an error1220 *          occurred.1221 */1222OSSL_DEPRECATEDIN_3_0 EC_KEY *d2i_ECParameters(EC_KEY **key,1223    const unsigned char **in,1224    long len);1225 1226/** Encodes ec parameter and stores the result in a buffer.1227 *  \param  key  the EC_KEY object with ec parameters to encode1228 *  \param  out  the buffer for the result (if NULL the function returns number1229 *               of bytes needed).1230 *  \return 1 on success and 0 if an error occurred.1231 */1232OSSL_DEPRECATEDIN_3_0 int i2d_ECParameters(const EC_KEY *key,1233    unsigned char **out);1234 1235/********************************************************************/1236/*         de- and encoding functions for EC public key             */1237/*         (octet string, not DER -- hence 'o2i' and 'i2o')         */1238/********************************************************************/1239 1240/** Decodes an ec public key from a octet string.1241 *  \param  key  a pointer to a EC_KEY object which should be used1242 *  \param  in   memory buffer with the encoded public key1243 *  \param  len  length of the encoded public key1244 *  \return EC_KEY object with decoded public key or NULL if an error1245 *          occurred.1246 */1247OSSL_DEPRECATEDIN_3_0 EC_KEY *o2i_ECPublicKey(EC_KEY **key,1248    const unsigned char **in, long len);1249 1250/** Encodes an ec public key in an octet string.1251 *  \param  key  the EC_KEY object with the public key1252 *  \param  out  the buffer for the result (if NULL the function returns number1253 *               of bytes needed).1254 *  \return 1 on success and 0 if an error occurred1255 */1256OSSL_DEPRECATEDIN_3_0 int i2o_ECPublicKey(const EC_KEY *key, unsigned char **out);1257 1258/** Prints out the ec parameters on human readable form.1259 *  \param  bp   BIO object to which the information is printed1260 *  \param  key  EC_KEY object1261 *  \return 1 on success and 0 if an error occurred1262 */1263OSSL_DEPRECATEDIN_3_0 int ECParameters_print(BIO *bp, const EC_KEY *key);1264 1265/** Prints out the contents of a EC_KEY object1266 *  \param  bp   BIO object to which the information is printed1267 *  \param  key  EC_KEY object1268 *  \param  off  line offset1269 *  \return 1 on success and 0 if an error occurred1270 */1271OSSL_DEPRECATEDIN_3_0 int EC_KEY_print(BIO *bp, const EC_KEY *key, int off);1272 1273#ifndef OPENSSL_NO_STDIO1274/** Prints out the ec parameters on human readable form.1275 *  \param  fp   file descriptor to which the information is printed1276 *  \param  key  EC_KEY object1277 *  \return 1 on success and 0 if an error occurred1278 */1279OSSL_DEPRECATEDIN_3_0 int ECParameters_print_fp(FILE *fp, const EC_KEY *key);1280 1281/** Prints out the contents of a EC_KEY object1282 *  \param  fp   file descriptor to which the information is printed1283 *  \param  key  EC_KEY object1284 *  \param  off  line offset1285 *  \return 1 on success and 0 if an error occurred1286 */1287OSSL_DEPRECATEDIN_3_0 int EC_KEY_print_fp(FILE *fp, const EC_KEY *key, int off);1288#endif /* OPENSSL_NO_STDIO */1289 1290OSSL_DEPRECATEDIN_3_0 const EC_KEY_METHOD *EC_KEY_OpenSSL(void);1291OSSL_DEPRECATEDIN_3_0 const EC_KEY_METHOD *EC_KEY_get_default_method(void);1292OSSL_DEPRECATEDIN_3_0 void EC_KEY_set_default_method(const EC_KEY_METHOD *meth);1293OSSL_DEPRECATEDIN_3_0 const EC_KEY_METHOD *EC_KEY_get_method(const EC_KEY *key);1294OSSL_DEPRECATEDIN_3_0 int EC_KEY_set_method(EC_KEY *key, const EC_KEY_METHOD *meth);1295OSSL_DEPRECATEDIN_3_0 EC_KEY *EC_KEY_new_method(ENGINE *engine);1296 1297/** The old name for ecdh_KDF_X9_631298 *  The ECDH KDF specification has been mistakenly attributed to ANSI X9.62,1299 *  it is actually specified in ANSI X9.63.1300 *  This identifier is retained for backwards compatibility1301 */1302OSSL_DEPRECATEDIN_3_0 int ECDH_KDF_X9_62(unsigned char *out, size_t outlen,1303    const unsigned char *Z, size_t Zlen,1304    const unsigned char *sinfo,1305    size_t sinfolen, const EVP_MD *md);1306 1307OSSL_DEPRECATEDIN_3_0 int ECDH_compute_key(void *out, size_t outlen,1308    const EC_POINT *pub_key,1309    const EC_KEY *ecdh,1310    void *(*KDF)(const void *in,1311        size_t inlen, void *out,1312        size_t *outlen));1313#endif /* OPENSSL_NO_DEPRECATED_3_0 */1314 1315typedef struct ECDSA_SIG_st ECDSA_SIG;1316 1317/** Allocates and initialize a ECDSA_SIG structure1318 *  \return pointer to a ECDSA_SIG structure or NULL if an error occurred1319 */1320ECDSA_SIG *ECDSA_SIG_new(void);1321 1322/** frees a ECDSA_SIG structure1323 *  \param  sig  pointer to the ECDSA_SIG structure1324 */1325void ECDSA_SIG_free(ECDSA_SIG *sig);1326 1327/** i2d_ECDSA_SIG encodes content of ECDSA_SIG (note: this function modifies *pp1328 *  (*pp += length of the DER encoded signature)).1329 *  \param  sig  pointer to the ECDSA_SIG object1330 *  \param  pp   pointer to a unsigned char pointer for the output or NULL1331 *  \return the length of the DER encoded ECDSA_SIG object or a negative value1332 *          on error1333 */1334DECLARE_ASN1_ENCODE_FUNCTIONS_only(ECDSA_SIG, ECDSA_SIG)1335 1336/** d2i_ECDSA_SIG decodes an ECDSA signature (note: this function modifies *pp1337 *  (*pp += len)).1338 *  \param  sig  pointer to ECDSA_SIG pointer (may be NULL)1339 *  \param  pp   memory buffer with the DER encoded signature1340 *  \param  len  length of the buffer1341 *  \return pointer to the decoded ECDSA_SIG structure (or NULL)1342 */1343 1344/** Accessor for r and s fields of ECDSA_SIG1345 *  \param  sig  pointer to ECDSA_SIG structure1346 *  \param  pr   pointer to BIGNUM pointer for r (may be NULL)1347 *  \param  ps   pointer to BIGNUM pointer for s (may be NULL)1348 */1349void ECDSA_SIG_get0(const ECDSA_SIG *sig, const BIGNUM **pr, const BIGNUM **ps);1350 1351/** Accessor for r field of ECDSA_SIG1352 *  \param  sig  pointer to ECDSA_SIG structure1353 */1354const BIGNUM *ECDSA_SIG_get0_r(const ECDSA_SIG *sig);1355 1356/** Accessor for s field of ECDSA_SIG1357 *  \param  sig  pointer to ECDSA_SIG structure1358 */1359const BIGNUM *ECDSA_SIG_get0_s(const ECDSA_SIG *sig);1360 1361/** Setter for r and s fields of ECDSA_SIG1362 *  \param  sig  pointer to ECDSA_SIG structure1363 *  \param  r    pointer to BIGNUM for r1364 *  \param  s    pointer to BIGNUM for s1365 */1366int ECDSA_SIG_set0(ECDSA_SIG *sig, BIGNUM *r, BIGNUM *s);1367 1368#ifndef OPENSSL_NO_DEPRECATED_3_01369/** Computes the ECDSA signature of the given hash value using1370 *  the supplied private key and returns the created signature.1371 *  \param  dgst      pointer to the hash value1372 *  \param  dgst_len  length of the hash value1373 *  \param  eckey     EC_KEY object containing a private EC key1374 *  \return pointer to a ECDSA_SIG structure or NULL if an error occurred1375 */1376OSSL_DEPRECATEDIN_3_0 ECDSA_SIG *ECDSA_do_sign(const unsigned char *dgst,1377    int dgst_len, EC_KEY *eckey);1378 1379/** Computes ECDSA signature of a given hash value using the supplied1380 *  private key (note: sig must point to ECDSA_size(eckey) bytes of memory).1381 *  \param  dgst     pointer to the hash value to sign1382 *  \param  dgstlen  length of the hash value1383 *  \param  kinv     BIGNUM with a pre-computed inverse k (optional)1384 *  \param  rp       BIGNUM with a pre-computed rp value (optional),1385 *                   see ECDSA_sign_setup1386 *  \param  eckey    EC_KEY object containing a private EC key1387 *  \return pointer to a ECDSA_SIG structure or NULL if an error occurred1388 */1389OSSL_DEPRECATEDIN_3_0 ECDSA_SIG *ECDSA_do_sign_ex(const unsigned char *dgst,1390    int dgstlen, const BIGNUM *kinv,1391    const BIGNUM *rp, EC_KEY *eckey);1392 1393/** Verifies that the supplied signature is a valid ECDSA1394 *  signature of the supplied hash value using the supplied public key.1395 *  \param  dgst      pointer to the hash value1396 *  \param  dgst_len  length of the hash value1397 *  \param  sig       ECDSA_SIG structure1398 *  \param  eckey     EC_KEY object containing a public EC key1399 *  \return 1 if the signature is valid, 0 if the signature is invalid1400 *          and -1 on error1401 */1402OSSL_DEPRECATEDIN_3_0 int ECDSA_do_verify(const unsigned char *dgst, int dgst_len,1403    const ECDSA_SIG *sig, EC_KEY *eckey);1404 1405/** Precompute parts of the signing operation1406 *  \param  eckey  EC_KEY object containing a private EC key1407 *  \param  ctx    BN_CTX object (optional)1408 *  \param  kinv   BIGNUM pointer for the inverse of k1409 *  \param  rp     BIGNUM pointer for x coordinate of k * generator1410 *  \return 1 on success and 0 otherwise1411 */1412OSSL_DEPRECATEDIN_3_0 int ECDSA_sign_setup(EC_KEY *eckey, BN_CTX *ctx,1413    BIGNUM **kinv, BIGNUM **rp);1414 1415/** Computes ECDSA signature of a given hash value using the supplied1416 *  private key (note: sig must point to ECDSA_size(eckey) bytes of memory).1417 *  \param  type     this parameter is ignored1418 *  \param  dgst     pointer to the hash value to sign1419 *  \param  dgstlen  length of the hash value1420 *  \param  sig      memory for the DER encoded created signature1421 *  \param  siglen   pointer to the length of the returned signature1422 *  \param  eckey    EC_KEY object containing a private EC key1423 *  \return 1 on success and 0 otherwise1424 */1425OSSL_DEPRECATEDIN_3_0 int ECDSA_sign(int type, const unsigned char *dgst,1426    int dgstlen, unsigned char *sig,1427    unsigned int *siglen, EC_KEY *eckey);1428 1429/** Computes ECDSA signature of a given hash value using the supplied1430 *  private key (note: sig must point to ECDSA_size(eckey) bytes of memory).1431 *  \param  type     this parameter is ignored1432 *  \param  dgst     pointer to the hash value to sign1433 *  \param  dgstlen  length of the hash value1434 *  \param  sig      buffer to hold the DER encoded signature1435 *  \param  siglen   pointer to the length of the returned signature1436 *  \param  kinv     BIGNUM with a pre-computed inverse k (optional)1437 *  \param  rp       BIGNUM with a pre-computed rp value (optional),1438 *                   see ECDSA_sign_setup1439 *  \param  eckey    EC_KEY object containing a private EC key1440 *  \return 1 on success and 0 otherwise1441 */1442OSSL_DEPRECATEDIN_3_0 int ECDSA_sign_ex(int type, const unsigned char *dgst,1443    int dgstlen, unsigned char *sig,1444    unsigned int *siglen, const BIGNUM *kinv,1445    const BIGNUM *rp, EC_KEY *eckey);1446 1447/** Verifies that the given signature is valid ECDSA signature1448 *  of the supplied hash value using the specified public key.1449 *  \param  type     this parameter is ignored1450 *  \param  dgst     pointer to the hash value1451 *  \param  dgstlen  length of the hash value1452 *  \param  sig      pointer to the DER encoded signature1453 *  \param  siglen   length of the DER encoded signature1454 *  \param  eckey    EC_KEY object containing a public EC key1455 *  \return 1 if the signature is valid, 0 if the signature is invalid1456 *          and -1 on error1457 */1458OSSL_DEPRECATEDIN_3_0 int ECDSA_verify(int type, const unsigned char *dgst,1459    int dgstlen, const unsigned char *sig,1460    int siglen, EC_KEY *eckey);1461 1462/** Returns the maximum length of the DER encoded signature1463 *  \param  eckey  EC_KEY object1464 *  \return numbers of bytes required for the DER encoded signature1465 */1466OSSL_DEPRECATEDIN_3_0 int ECDSA_size(const EC_KEY *eckey);1467 1468/********************************************************************/1469/*  EC_KEY_METHOD constructors, destructors, writers and accessors  */1470/********************************************************************/1471 1472OSSL_DEPRECATEDIN_3_0 EC_KEY_METHOD *EC_KEY_METHOD_new(const EC_KEY_METHOD *meth);1473OSSL_DEPRECATEDIN_3_0 void EC_KEY_METHOD_free(EC_KEY_METHOD *meth);1474OSSL_DEPRECATEDIN_3_0 void EC_KEY_METHOD_set_init(EC_KEY_METHOD *meth,1475    int (*init)(EC_KEY *key),1476    void (*finish)(EC_KEY *key),1477    int (*copy)(EC_KEY *dest, const EC_KEY *src),1478    int (*set_group)(EC_KEY *key, const EC_GROUP *grp),1479    int (*set_private)(EC_KEY *key, const BIGNUM *priv_key),1480    int (*set_public)(EC_KEY *key, const EC_POINT *pub_key));1481 1482OSSL_DEPRECATEDIN_3_0 void EC_KEY_METHOD_set_keygen(EC_KEY_METHOD *meth,1483    int (*keygen)(EC_KEY *key));1484 1485OSSL_DEPRECATEDIN_3_0 void EC_KEY_METHOD_set_compute_key(EC_KEY_METHOD *meth,1486    int (*ckey)(unsigned char **psec, size_t *pseclen,1487        const EC_POINT *pub_key, const EC_KEY *ecdh));1488 1489OSSL_DEPRECATEDIN_3_0 void EC_KEY_METHOD_set_sign(EC_KEY_METHOD *meth,1490    int (*sign)(int type, const unsigned char *dgst,1491        int dlen, unsigned char *sig,1492        unsigned int *siglen,1493        const BIGNUM *kinv, const BIGNUM *r,1494        EC_KEY *eckey),1495    int (*sign_setup)(EC_KEY *eckey, BN_CTX *ctx_in,1496        BIGNUM **kinvp, BIGNUM **rp),1497    ECDSA_SIG *(*sign_sig)(const unsigned char *dgst,1498        int dgst_len,1499        const BIGNUM *in_kinv,1500        const BIGNUM *in_r,1501        EC_KEY *eckey));1502 1503OSSL_DEPRECATEDIN_3_0 void EC_KEY_METHOD_set_verify(EC_KEY_METHOD *meth,1504    int (*verify)(int type, const unsigned char *dgst, int dgst_len,1505        const unsigned char *sigbuf,1506        int sig_len, EC_KEY *eckey),1507    int (*verify_sig)(const unsigned char *dgst,1508        int dgst_len, const ECDSA_SIG *sig,1509        EC_KEY *eckey));1510 1511OSSL_DEPRECATEDIN_3_0 void EC_KEY_METHOD_get_init(const EC_KEY_METHOD *meth,1512    int (**pinit)(EC_KEY *key),1513    void (**pfinish)(EC_KEY *key),1514    int (**pcopy)(EC_KEY *dest, const EC_KEY *src),1515    int (**pset_group)(EC_KEY *key, const EC_GROUP *grp),1516    int (**pset_private)(EC_KEY *key, const BIGNUM *priv_key),1517    int (**pset_public)(EC_KEY *key, const EC_POINT *pub_key));1518 1519OSSL_DEPRECATEDIN_3_0 void EC_KEY_METHOD_get_keygen(const EC_KEY_METHOD *meth, int (**pkeygen)(EC_KEY *key));1520 1521OSSL_DEPRECATEDIN_3_0 void EC_KEY_METHOD_get_compute_key(const EC_KEY_METHOD *meth,1522    int (**pck)(unsigned char **psec,1523        size_t *pseclen,1524        const EC_POINT *pub_key,1525        const EC_KEY *ecdh));1526 1527OSSL_DEPRECATEDIN_3_0 void EC_KEY_METHOD_get_sign(const EC_KEY_METHOD *meth,1528    int (**psign)(int type, const unsigned char *dgst,1529        int dlen, unsigned char *sig,1530        unsigned int *siglen,1531        const BIGNUM *kinv, const BIGNUM *r,1532        EC_KEY *eckey),1533    int (**psign_setup)(EC_KEY *eckey, BN_CTX *ctx_in,1534        BIGNUM **kinvp, BIGNUM **rp),1535    ECDSA_SIG *(**psign_sig)(const unsigned char *dgst,1536        int dgst_len,1537        const BIGNUM *in_kinv,1538        const BIGNUM *in_r,1539        EC_KEY *eckey));1540 1541OSSL_DEPRECATEDIN_3_0 void EC_KEY_METHOD_get_verify(const EC_KEY_METHOD *meth,1542    int (**pverify)(int type, const unsigned char *dgst, int dgst_len,1543        const unsigned char *sigbuf,1544        int sig_len, EC_KEY *eckey),1545    int (**pverify_sig)(const unsigned char *dgst,1546        int dgst_len,1547        const ECDSA_SIG *sig,1548        EC_KEY *eckey));1549#endif /* OPENSSL_NO_DEPRECATED_3_0 */1550 1551#define EVP_EC_gen(curve) \1552    EVP_PKEY_Q_keygen(NULL, NULL, "EC", (char *)(strstr(curve, "")))1553/* strstr is used to enable type checking for the variadic string arg */1554#define ECParameters_dup(x) ASN1_dup_of(EC_KEY, i2d_ECParameters, \1555    d2i_ECParameters, x)1556 1557#ifndef __cplusplus1558#if defined(__SUNPRO_C)1559#if __SUNPRO_C >= 0x5201560#pragma error_messages(default, E_ARRAY_OF_INCOMPLETE_NONAME, E_ARRAY_OF_INCOMPLETE)1561#endif1562#endif1563#endif1564 1565#endif1566#ifdef __cplusplus1567}1568#endif1569#endif1570