RSA, DSA, DH: Allow some given input to be NULL on already initialised keys
[openssl.git] / crypto / dsa / dsa_locl.h
1 /* ====================================================================
2  * Copyright (c) 2007 The OpenSSL Project.  All rights reserved.
3  *
4  * Redistribution and use in source and binary forms, with or without
5  * modification, are permitted provided that the following conditions
6  * are met:
7  *
8  * 1. Redistributions of source code must retain the above copyright
9  *    notice, this list of conditions and the following disclaimer.
10  *
11  * 2. Redistributions in binary form must reproduce the above copyright
12  *    notice, this list of conditions and the following disclaimer in
13  *    the documentation and/or other materials provided with the
14  *    distribution.
15  *
16  * 3. All advertising materials mentioning features or use of this
17  *    software must display the following acknowledgment:
18  *    "This product includes software developed by the OpenSSL Project
19  *    for use in the OpenSSL Toolkit. (http://www.openssl.org/)"
20  *
21  * 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
22  *    endorse or promote products derived from this software without
23  *    prior written permission. For written permission, please contact
24  *    openssl-core@openssl.org.
25  *
26  * 5. Products derived from this software may not be called "OpenSSL"
27  *    nor may "OpenSSL" appear in their names without prior written
28  *    permission of the OpenSSL Project.
29  *
30  * 6. Redistributions of any form whatsoever must retain the following
31  *    acknowledgment:
32  *    "This product includes software developed by the OpenSSL Project
33  *    for use in the OpenSSL Toolkit (http://www.openssl.org/)"
34  *
35  * THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY
36  * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
37  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
38  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE OpenSSL PROJECT OR
39  * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
40  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
41  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
42  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
43  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
44  * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
45  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
46  * OF THE POSSIBILITY OF SUCH DAMAGE.
47  * ====================================================================
48  *
49  * This product includes cryptographic software written by Eric Young
50  * (eay@cryptsoft.com).  This product includes software written by Tim
51  * Hudson (tjh@cryptsoft.com).
52  *
53  */
54
55 #include <openssl/dsa.h>
56
57 struct dsa_st {
58     /*
59      * This first variable is used to pick up errors where a DSA is passed
60      * instead of of a EVP_PKEY
61      */
62     int pad;
63     long version;
64     BIGNUM *p;
65     BIGNUM *q;                  /* == 20 */
66     BIGNUM *g;
67     BIGNUM *pub_key;            /* y public key */
68     BIGNUM *priv_key;           /* x private key */
69     int flags;
70     /* Normally used to cache montgomery values */
71     BN_MONT_CTX *method_mont_p;
72     int references;
73     CRYPTO_EX_DATA ex_data;
74     const DSA_METHOD *meth;
75     /* functional reference if 'meth' is ENGINE-provided */
76     ENGINE *engine;
77     CRYPTO_RWLOCK *lock;
78 };
79
80 struct dsa_method {
81     char *name;
82     DSA_SIG *(*dsa_do_sign) (const unsigned char *dgst, int dlen, DSA *dsa);
83     int (*dsa_sign_setup) (DSA *dsa, BN_CTX *ctx_in, BIGNUM **kinvp,
84                            BIGNUM **rp);
85     int (*dsa_do_verify) (const unsigned char *dgst, int dgst_len,
86                           DSA_SIG *sig, DSA *dsa);
87     int (*dsa_mod_exp) (DSA *dsa, BIGNUM *rr, BIGNUM *a1, BIGNUM *p1,
88                         BIGNUM *a2, BIGNUM *p2, BIGNUM *m, BN_CTX *ctx,
89                         BN_MONT_CTX *in_mont);
90     /* Can be null */
91     int (*bn_mod_exp) (DSA *dsa, BIGNUM *r, BIGNUM *a, const BIGNUM *p,
92                        const BIGNUM *m, BN_CTX *ctx, BN_MONT_CTX *m_ctx);
93     int (*init) (DSA *dsa);
94     int (*finish) (DSA *dsa);
95     int flags;
96     void *app_data;
97     /* If this is non-NULL, it is used to generate DSA parameters */
98     int (*dsa_paramgen) (DSA *dsa, int bits,
99                          const unsigned char *seed, int seed_len,
100                          int *counter_ret, unsigned long *h_ret,
101                          BN_GENCB *cb);
102     /* If this is non-NULL, it is used to generate DSA keys */
103     int (*dsa_keygen) (DSA *dsa);
104 };
105
106 int dsa_builtin_paramgen(DSA *ret, size_t bits, size_t qbits,
107                          const EVP_MD *evpmd, const unsigned char *seed_in,
108                          size_t seed_len, unsigned char *seed_out,
109                          int *counter_ret, unsigned long *h_ret,
110                          BN_GENCB *cb);
111
112 int dsa_builtin_paramgen2(DSA *ret, size_t L, size_t N,
113                           const EVP_MD *evpmd, const unsigned char *seed_in,
114                           size_t seed_len, int idx, unsigned char *seed_out,
115                           int *counter_ret, unsigned long *h_ret,
116                           BN_GENCB *cb);