use a generic EC_KEY structure (EC keys are not ECDSA specific)
[openssl.git] / crypto / ecdsa / ecdsa.h
index 00cd71d068f529a162259ae8cfbe9c664ef918fa..d72d0b1363aa76960104f34971a3087cb22597ca 100644 (file)
@@ -59,9 +59,6 @@
 #error ECDSA is disabled.
 #endif
 
-#ifndef OPENSSL_NO_BIO
-#include <openssl/bio.h>
-#endif
 #include <openssl/bn.h>
 #include <openssl/ec.h>
 #include <openssl/ossl_typ.h>
@@ -70,8 +67,6 @@
 extern "C" {
 #endif
 
-typedef struct ecdsa_st ECDSA;
-
 typedef struct ECDSA_SIG_st
 {
        BIGNUM *r;
@@ -81,122 +76,70 @@ typedef struct ECDSA_SIG_st
 typedef struct ecdsa_method 
 {
        const char *name;
-       ECDSA_SIG *(*ecdsa_do_sign)(const unsigned char *dgst, int dgst_len, ECDSA *ecdsa);
-       int (*ecdsa_sign_setup)(ECDSA *ecdsa, BN_CTX *ctx, BIGNUM **kinv, BIGNUM **r);
-       int (*ecdsa_do_verify)(const unsigned char *dgst, int dgst_len, ECDSA_SIG *sig, ECDSA *ecdsa);
-       int (*init)(ECDSA *ecdsa);
-       int (*finish)(ECDSA *ecdsa);
+       ECDSA_SIG *(*ecdsa_do_sign)(const unsigned char *dgst, int dgst_len, 
+                       EC_KEY *eckey);
+       int (*ecdsa_sign_setup)(EC_KEY *eckey, BN_CTX *ctx, BIGNUM **kinv, 
+                       BIGNUM **r);
+       int (*ecdsa_do_verify)(const unsigned char *dgst, int dgst_len, 
+                       ECDSA_SIG *sig, EC_KEY *eckey);
+#if 0
+       int (*init)(EC_KEY *eckey);
+       int (*finish)(EC_KEY *eckey);
+#endif
        int flags;
        char *app_data;
 } ECDSA_METHOD;
 
-struct ecdsa_st
-{
-       int version;
-       point_conversion_form_t conversion_form;
-
-       EC_GROUP *group;
-
-       EC_POINT *pub_key;
-       BIGNUM   *priv_key;
-
-       BIGNUM   *kinv; /* signing pre-calc */
-       BIGNUM   *r;    /* signing pre-calc */
-
-       unsigned int enc_flag;
-
-       int     references;
+typedef struct ecdsa_data_st {
+       /* EC_KEY_METH_DATA part */
+       int (*init)(EC_KEY *);
+       void (*finish)(EC_KEY *);
+       /* method specific part */
+       BIGNUM  *kinv;  /* signing pre-calc */
+       BIGNUM  *r;     /* signing pre-calc */
+       ENGINE  *engine;
        int     flags;
-       CRYPTO_EX_DATA ex_data;
        const ECDSA_METHOD *meth;
-       struct engine_st *engine;
-};
-
-/* some values for the encoding_flag */
-#define ECDSA_PKEY_NO_PARAMETERS       0x001
-#define ECDSA_PKEY_NO_PUBKEY           0x002
+       CRYPTO_EX_DATA ex_data;
+} ECDSA_DATA; 
 
+/* signature functions */
 ECDSA_SIG *ECDSA_SIG_new(void);
 void     ECDSA_SIG_free(ECDSA_SIG *a);
 int      i2d_ECDSA_SIG(const ECDSA_SIG *a, unsigned char **pp);
 ECDSA_SIG *d2i_ECDSA_SIG(ECDSA_SIG **v, const unsigned char **pp, long length);
 
-ECDSA_SIG *ECDSA_do_sign(const unsigned char *dgst, int dgst_len, ECDSA *ecdsa);
-int      ECDSA_do_verify(const unsigned char *dgst, int dgst_len, ECDSA_SIG *sig, ECDSA* ecdsa);
-int      ECDSA_generate_key(ECDSA *ecdsa);
-int      ECDSA_check_key(ECDSA *ecdsa);
+/* ECDSA_DATA functions */
+ECDSA_DATA *ECDSA_DATA_new(void);
+ECDSA_DATA *ECDSA_DATA_new_method(ENGINE *);
+void ECDSA_DATA_free(ECDSA_DATA *);
+
+ECDSA_DATA *ecdsa_check(EC_KEY *);
+
+ECDSA_SIG *ECDSA_do_sign(const unsigned char *dgst, int dgst_len, EC_KEY *);
+int      ECDSA_do_verify(const unsigned char *dgst, int dgst_len, ECDSA_SIG 
+               *sig, EC_KEY* eckey);
 
 const ECDSA_METHOD *ECDSA_OpenSSL(void);
 
 void     ECDSA_set_default_method(const ECDSA_METHOD *);
 const ECDSA_METHOD *ECDSA_get_default_method(void);
-int      ECDSA_set_method(ECDSA *, const ECDSA_METHOD *);
-
-ECDSA    *ECDSA_new(void);
-ECDSA    *ECDSA_new_method(ENGINE *engine);
-int      ECDSA_size(const ECDSA *);
-int      ECDSA_sign_setup(ECDSA *ecdsa, BN_CTX *ctx, BIGNUM **kinv, BIGNUM **rp);
-int      ECDSA_sign(int type, const unsigned char *dgst, int dgst_len, unsigned char *sig, 
-                    unsigned int *siglen, ECDSA *ecdsa);
-int      ECDSA_verify(int type, const unsigned char *dgst, int dgst_len, const unsigned char *sig,
-                      int sig_len, ECDSA *ecdsa);
-int      ECDSA_up_ref(ECDSA *ecdsa);
-void     ECDSA_free(ECDSA *a);
-int      ECDSA_get_ex_new_index(long argl, void *argp, CRYPTO_EX_new *new_func,
-                                CRYPTO_EX_dup *dup_func, CRYPTO_EX_free *free_func);
-int      ECDSA_set_ex_data(ECDSA *d, int idx, void *arg);
-void     *ECDSA_get_ex_data(ECDSA *d, int idx);
-
-#ifndef OPENSSL_NO_BIO
-int    ECDSAParameters_print(BIO *bp, const ECDSA *x);
-int    ECDSA_print(BIO *bp, const ECDSA *x, int off);
-#endif
-#ifndef OPENSSL_NO_FP_API
-int    ECDSAParameters_print_fp(FILE *fp, const ECDSA *x);
-int    ECDSA_print_fp(FILE *fp, const ECDSA *x, int off);
-#endif 
-
-/* the ECDSA_{set|get}_enc_flag() specify the encoding
- * of the elliptic curve private key */
-unsigned int ECDSA_get_enc_flag(const ECDSA *);
-void ECDSA_set_enc_flag(ECDSA *, unsigned int);
-
-/* The ECDSA_{set|get}_conversion_type() functions set/get the
- * conversion form for ec-points (see ec.h) in a ECDSA-structure */
-void   ECDSA_set_conversion_form(ECDSA *, const point_conversion_form_t);
-point_conversion_form_t ECDSA_get_conversion_form(const ECDSA *);
-/* The ECDSA_{set|get}_default_conversion_form() functions set/get the 
- * default conversion form */
-void   ECDSA_set_default_conversion_form(const point_conversion_form_t);
-point_conversion_form_t ECDSA_get_default_conversion_form(void);
-
-/* the basic de- and encode functions ( see ecs_asn1.c ) */
-ECDSA   *d2i_ECDSAParameters(ECDSA **a, const unsigned char **in, long len);
-int     i2d_ECDSAParameters(ECDSA *a, unsigned char **out);
+int      ECDSA_set_method(EC_KEY *, const ECDSA_METHOD *);
 
-ECDSA   *d2i_ECDSAPrivateKey(ECDSA **a, const unsigned char **in, long len);
-int     i2d_ECDSAPrivateKey(ECDSA *a, unsigned char **out);
+int      ECDSA_size(const EC_KEY *);
+int      ECDSA_sign_setup(EC_KEY *eckey, BN_CTX *ctx, BIGNUM **kinv, 
+               BIGNUM **rp);
+int      ECDSA_sign(int type, const unsigned char *dgst, int dgst_len, 
+               unsigned char *sig, unsigned int *siglen, EC_KEY *eckey);
+int      ECDSA_verify(int type, const unsigned char *dgst, int dgst_len, 
+               const unsigned char *sig, int sig_len, EC_KEY *eckey);
 
-/* ECDSAPublicKey_set_octet_string() sets the public key in the ECDSA-structure.
- * (*a) must be a pointer to a ECDSA-structure with (*a)->group not zero 
- * (e.g. a ECDSA-structure with a valid EC_GROUP-structure) */
-ECDSA  *ECDSAPublicKey_set_octet_string(ECDSA **a, const unsigned char **in, long len);
-/* ECDSAPublicKey_get_octet_string() returns the length of the octet string encoding
- * of the public key. If out != NULL then the function returns in *out 
- * a pointer to the octet string */
-int    ECDSAPublicKey_get_octet_string(ECDSA *a, unsigned char **out);
 
+int      ECDSA_get_ex_new_index(long argl, void *argp, CRYPTO_EX_new 
+               *new_func, CRYPTO_EX_dup *dup_func, CRYPTO_EX_free *free_func);
+int      ECDSA_set_ex_data(EC_KEY *d, int idx, void *arg);
+void     *ECDSA_get_ex_data(EC_KEY *d, int idx);
 
-#define ECDSAParameters_dup(x) (ECDSA *)ASN1_dup((int (*)())i2d_ECDSAParameters, \
-               (char *(*)())d2i_ECDSAParameters,(char *)(x))
-#define d2i_ECDSAParameters_fp(fp,x) (ECDSA *)ASN1_d2i_fp((char *(*)())ECDSA_new, \
-               (char *(*)())d2i_ECDSAParameters,(fp),(unsigned char **)(x))
-#define i2d_ECDSAParameters_fp(fp,x) ASN1_i2d_fp(i2d_ECDSAParameters,(fp), \
-               (unsigned char *)(x))
-#define d2i_ECDSAParameters_bio(bp,x) (ECDSA *)ASN1_d2i_bio((char *(*)())ECDSA_new, \
-               (char *(*)())d2i_ECDSAParameters,(bp),(unsigned char **)(x))
-#define i2d_ECDSAParameters_bio(bp,x) ASN1_i2d_bio(i2d_ECDSAParameters,(bp), \
-               (unsigned char *)(x))
 
 /* BEGIN ERROR CODES */
 /* The following lines are auto generated by the script mkerr.pl. Any changes
@@ -207,72 +150,18 @@ void ERR_load_ECDSA_strings(void);
 /* Error codes for the ECDSA functions. */
 
 /* Function codes. */
-#define ECDSA_F_D2I_ECDSAPARAMETERS                     100
-#define ECDSA_F_D2I_ECDSAPRIVATEKEY                     101
-#define ECDSA_F_ECDSAPARAMETERS_PRINT                   102
-#define ECDSA_F_ECDSAPARAMETERS_PRINT_FP                103
-#define ECDSA_F_ECDSA_DO_SIGN                           104
-#define ECDSA_F_ECDSA_DO_VERIFY                                 105
-#define ECDSA_F_ECDSA_GENERATE_KEY                      106
-#define ECDSA_F_ECDSA_GET                               107
-#define ECDSA_F_ECDSA_GET_CURVE_NID                     120
-#define ECDSA_F_ECDSA_GET_ECDSA                                 121
-#define ECDSA_F_ECDSA_GET_EC_PARAMETERS                         122
-#define ECDSA_F_ECDSA_GET_X9_62_CURVE                   108
-#define ECDSA_F_ECDSA_GET_X9_62_EC_PARAMETERS           109
-#define ECDSA_F_ECDSA_GET_X9_62_FIELDID                         110
-#define ECDSA_F_ECDSA_NEW                               111
-#define ECDSA_F_ECDSA_PRINT                             112
-#define ECDSA_F_ECDSA_PRINT_FP                          113
-#define ECDSA_F_ECDSA_SET_GROUP_P                       114
-#define ECDSA_F_ECDSA_SET_PRIME_GROUP                   123
-#define ECDSA_F_ECDSA_SIGN_SETUP                        115
-#define ECDSA_F_I2D_ECDSAPARAMETERS                     116
-#define ECDSA_F_I2D_ECDSAPRIVATEKEY                     117
-#define ECDSA_F_I2D_ECDSAPUBLICKEY                      118
-#define ECDSA_F_SIG_CB                                  119
+#define ECDSA_F_ECDSA_DATA_NEW                          100
+#define ECDSA_F_ECDSA_DO_SIGN                           101
+#define ECDSA_F_ECDSA_DO_VERIFY                                 102
+#define ECDSA_F_ECDSA_SIGN_SETUP                        103
 
 /* Reason codes. */
 #define ECDSA_R_BAD_SIGNATURE                           100
-#define ECDSA_R_CAN_NOT_GET_GENERATOR                   101
-#define ECDSA_R_D2I_ECDSAPRIVATEKEY_MISSING_PRIVATE_KEY         102
-#define ECDSA_R_D2I_ECDSA_PRIVATEKEY_FAILURE            103
-#define ECDSA_R_D2I_EC_PARAMETERS_FAILURE               133
-#define ECDSA_R_D2I_X9_62_EC_PARAMETERS_FAILURE                 104
-#define ECDSA_R_DATA_TOO_LARGE_FOR_KEY_SIZE             105
-#define ECDSA_R_ECDSAPRIVATEKEY_NEW_FAILURE             106
-#define ECDSA_R_ECDSA_F_ECDSA_NEW                       107
-#define ECDSA_R_ECDSA_GET_EC_PARAMETERS_FAILURE                 134
-#define ECDSA_R_ECDSA_GET_FAILURE                       108
-#define ECDSA_R_ECDSA_GET_X9_62_CURVE_FAILURE           109
-#define ECDSA_R_ECDSA_GET_X9_62_EC_PARAMETERS_FAILURE   110
-#define ECDSA_R_ECDSA_GET_X9_62_FIELDID_FAILURE                 111
-#define ECDSA_R_ECDSA_NEW_FAILURE                       112
-#define ECDSA_R_ECDSA_R_D2I_EC_PARAMETERS_FAILURE       135
-#define ECDSA_R_ECDSA_R_D2I_X9_62_EC_PARAMETERS_FAILURE         113
-#define ECDSA_R_ECPARAMETERS2ECDSA_FAILURE              138
-#define ECDSA_R_EC_GROUP_NID2CURVE_FAILURE              136
-#define ECDSA_R_ERR_EC_LIB                              114
-#define ECDSA_R_I2D_ECDSA_PRIVATEKEY                    115
-#define ECDSA_R_I2D_ECDSA_PUBLICKEY                     116
-#define ECDSA_R_MISSING_PARAMETERS                      117
-#define ECDSA_R_MISSING_PRIVATE_KEY                     139
-#define ECDSA_R_NOT_SUPPORTED                           118
-#define ECDSA_R_NO_CURVE_PARAMETER_A_SPECIFIED          119
-#define ECDSA_R_NO_CURVE_PARAMETER_B_SPECIFIED          120
-#define ECDSA_R_NO_CURVE_SPECIFIED                      121
-#define ECDSA_R_NO_FIELD_SPECIFIED                      122
-#define ECDSA_R_PRIME_MISSING                           123
-#define ECDSA_R_RANDOM_NUMBER_GENERATION_FAILED                 124
-#define ECDSA_R_SIGNATURE_MALLOC_FAILED                         125
-#define ECDSA_R_UNEXPECTED_ASN1_TYPE                    126
-#define ECDSA_R_UNEXPECTED_PARAMETER                    127
-#define ECDSA_R_UNEXPECTED_PARAMETER_LENGTH             128
-#define ECDSA_R_UNEXPECTED_VERSION_NUMER                129
-#define ECDSA_R_UNKNOWN_PARAMETERS_TYPE                         137
-#define ECDSA_R_WRONG_FIELD_IDENTIFIER                  130
-#define ECDSA_R_X9_62_CURVE_NEW_FAILURE                         131
-#define ECDSA_R_X9_62_EC_PARAMETERS_NEW_FAILURE                 132
+#define ECDSA_R_DATA_TOO_LARGE_FOR_KEY_SIZE             101
+#define ECDSA_R_ERR_EC_LIB                              102
+#define ECDSA_R_MISSING_PARAMETERS                      103
+#define ECDSA_R_RANDOM_NUMBER_GENERATION_FAILED                 104
+#define ECDSA_R_SIGNATURE_MALLOC_FAILED                         105
 
 #ifdef  __cplusplus
 }