[thirdparty/openssl.git] / crypto / dsa / dsa.h

/* crypto/dsa/dsa.h */
/* Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com)
 * All rights reserved.
 *
 * This package is an SSL implementation written
 * by Eric Young (eay@cryptsoft.com).
 * The implementation was written so as to conform with Netscapes SSL.
 * 
 * This library is free for commercial and non-commercial use as long as
 * the following conditions are aheared to.  The following conditions
 * apply to all code found in this distribution, be it the RC4, RSA,
 * lhash, DES, etc., code; not just the SSL code.  The SSL documentation
 * included with this distribution is covered by the same copyright terms
 * except that the holder is Tim Hudson (tjh@cryptsoft.com).
 * 
 * Copyright remains Eric Young's, and as such any Copyright notices in
 * the code are not to be removed.
 * If this package is used in a product, Eric Young should be given attribution
 * as the author of the parts of the library used.
 * This can be in the form of a textual message at program startup or
 * in documentation (online or textual) provided with the package.
 * 
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 * 1. Redistributions of source code must retain the copyright
 *    notice, this list of conditions and the following disclaimer.
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in the
 *    documentation and/or other materials provided with the distribution.
 * 3. All advertising materials mentioning features or use of this software
 *    must display the following acknowledgement:
 *    "This product includes cryptographic software written by
 *     Eric Young (eay@cryptsoft.com)"
 *    The word 'cryptographic' can be left out if the rouines from the library
 *    being used are not cryptographic related :-).
 * 4. If you include any Windows specific code (or a derivative thereof) from 
 *    the apps directory (application code) you must include an acknowledgement:
 *    "This product includes software written by Tim Hudson (tjh@cryptsoft.com)"
 * 
 * THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND
 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 * SUCH DAMAGE.
 * 
 * The licence and distribution terms for any publically available version or
 * derivative of this code cannot be changed.  i.e. this code cannot simply be
 * copied and put under another distribution licence
 * [including the GNU Public Licence.]
 */

/*
 * The DSS routines are based on patches supplied by
 * Steven Schoch <schoch@sheba.arc.nasa.gov>.  He basically did the
 * work and I have just tweaked them a little to fit into my
 * stylistic vision for SSLeay :-) */

#ifndef HEADER_DSA_H
#define HEADER_DSA_H

#ifdef  __cplusplus
extern "C" {
#endif

#ifdef NO_DSA
#error DSA is disabled.
#endif

#include <openssl/bn.h>
#include <openssl/crypto.h>
#ifndef NO_DH
# include <openssl/dh.h>
#endif

#define DSA_FLAG_CACHE_MONT_P	0x01

typedef struct dsa_st DSA;

typedef struct DSA_SIG_st
	{
	BIGNUM *r;
	BIGNUM *s;
	} DSA_SIG;

typedef struct dsa_method {
	const char *name;
	DSA_SIG * (*dsa_do_sign)(const unsigned char *dgst, int dlen, DSA *dsa);
	int (*dsa_sign_setup)(DSA *dsa, BN_CTX *ctx_in, BIGNUM **kinvp,
								BIGNUM **rp);
	int (*dsa_do_verify)(const unsigned char *dgst, int dgst_len,
							DSA_SIG *sig, DSA *dsa);
	int (*dsa_mod_exp)(DSA *dsa, BIGNUM *rr, BIGNUM *a1, BIGNUM *p1,
			BIGNUM *a2, BIGNUM *p2, BIGNUM *m, BN_CTX *ctx,
			BN_MONT_CTX *in_mont);
	int (*bn_mod_exp)(DSA *dsa, BIGNUM *r, BIGNUM *a, const BIGNUM *p,
				const BIGNUM *m, BN_CTX *ctx,
				BN_MONT_CTX *m_ctx); /* Can be null */
	int (*init)(DSA *dsa);
	int (*finish)(DSA *dsa);
	int flags;
	char *app_data;
} DSA_METHOD;

struct dsa_st
	{
	/* This first variable is used to pick up errors where
	 * a DSA is passed instead of of a EVP_PKEY */
	int pad;
	int version;
	int write_params;
	BIGNUM *p;
	BIGNUM *q;	/* == 20 */
	BIGNUM *g;

	BIGNUM *pub_key;  /* y public key */
	BIGNUM *priv_key; /* x private key */

	BIGNUM *kinv;	/* Signing pre-calc */
	BIGNUM *r;	/* Signing pre-calc */

	int flags;
	/* Normally used to cache montgomery values */
	char *method_mont_p;
	int references;
	CRYPTO_EX_DATA ex_data;
	DSA_METHOD *meth;
	};

#define DSAparams_dup(x) (DSA *)ASN1_dup((int (*)())i2d_DSAparams, \
		(char *(*)())d2i_DSAparams,(char *)(x))
#define d2i_DSAparams_fp(fp,x) (DSA *)ASN1_d2i_fp((char *(*)())DSA_new, \
		(char *(*)())d2i_DSAparams,(fp),(unsigned char **)(x))
#define i2d_DSAparams_fp(fp,x) ASN1_i2d_fp(i2d_DSAparams,(fp), \
		(unsigned char *)(x))
#define d2i_DSAparams_bio(bp,x) (DSA *)ASN1_d2i_bio((char *(*)())DSA_new, \
		(char *(*)())d2i_DSAparams,(bp),(unsigned char **)(x))
#define i2d_DSAparams_bio(bp,x) ASN1_i2d_bio(i2d_DSAparams,(bp), \
		(unsigned char *)(x))


DSA_SIG * DSA_SIG_new(void);
void	DSA_SIG_free(DSA_SIG *a);
int	i2d_DSA_SIG(DSA_SIG *a, unsigned char **pp);
DSA_SIG * d2i_DSA_SIG(DSA_SIG **v, unsigned char **pp, long length);

DSA_SIG * DSA_do_sign(const unsigned char *dgst,int dlen,DSA *dsa);
int	DSA_do_verify(const unsigned char *dgst,int dgst_len,
		      DSA_SIG *sig,DSA *dsa);

DSA_METHOD *DSA_OpenSSL(void);

void        DSA_set_default_method(DSA_METHOD *);
DSA_METHOD *DSA_get_default_method(void);
DSA_METHOD *DSA_set_method(DSA *dsa, DSA_METHOD *);

DSA *	DSA_new(void);
DSA *	DSA_new_method(DSA_METHOD *meth);
int	DSA_size(DSA *);
	/* next 4 return -1 on error */
int	DSA_sign_setup( DSA *dsa,BN_CTX *ctx_in,BIGNUM **kinvp,BIGNUM **rp);
int	DSA_sign(int type,const unsigned char *dgst,int dlen,
		unsigned char *sig, unsigned int *siglen, DSA *dsa);
int	DSA_verify(int type,const unsigned char *dgst,int dgst_len,
		unsigned char *sigbuf, int siglen, DSA *dsa);
void	DSA_free (DSA *r);
int DSA_get_ex_new_index(long argl, char *argp, int (*new_func)(),
	     int (*dup_func)(), void (*free_func)());
int DSA_set_ex_data(DSA *d, int idx, char *arg);
char *DSA_get_ex_data(DSA *d, int idx);

void	ERR_load_DSA_strings(void );

DSA *	d2i_DSAPublicKey(DSA **a, unsigned char **pp, long length);
DSA *	d2i_DSAPrivateKey(DSA **a, unsigned char **pp, long length);
DSA * 	d2i_DSAparams(DSA **a, unsigned char **pp, long length);
DSA *	DSA_generate_parameters(int bits, unsigned char *seed,int seed_len,
		int *counter_ret, unsigned long *h_ret,void
		(*callback)(),char *cb_arg);
int	DSA_generate_key(DSA *a);
int	i2d_DSAPublicKey(DSA *a, unsigned char **pp);
int 	i2d_DSAPrivateKey(DSA *a, unsigned char **pp);
int	i2d_DSAparams(DSA *a,unsigned char **pp);

#ifdef HEADER_BIO_H
int	DSAparams_print(BIO *bp, DSA *x);
int	DSA_print(BIO *bp, DSA *x, int off);
#endif
#ifndef NO_FP_API
int	DSAparams_print_fp(FILE *fp, DSA *x);
int	DSA_print_fp(FILE *bp, DSA *x, int off);
#endif

int DSA_is_prime(BIGNUM *q,void (*callback)(),char *cb_arg);

#ifndef NO_DH
/* Convert DSA structure (key or just parameters) into DH structure
 * (be careful to avoid small subgroup attacks when using this!) */
DH *DSA_dup_DH(DSA *r);
#endif

/* BEGIN ERROR CODES */
/* The following lines are auto generated by the script mkerr.pl. Any changes
 * made after this point may be overwritten when the script is next run.
 */

/* Error codes for the DSA functions. */

/* Function codes. */
#define DSA_F_D2I_DSA_SIG				 110
#define DSA_F_DSAPARAMS_PRINT				 100
#define DSA_F_DSAPARAMS_PRINT_FP			 101
#define DSA_F_DSA_DO_SIGN				 112
#define DSA_F_DSA_DO_VERIFY				 113
#define DSA_F_DSA_IS_PRIME				 102
#define DSA_F_DSA_NEW					 103
#define DSA_F_DSA_PRINT					 104
#define DSA_F_DSA_PRINT_FP				 105
#define DSA_F_DSA_SIGN					 106
#define DSA_F_DSA_SIGN_SETUP				 107
#define DSA_F_DSA_SIG_NEW				 109
#define DSA_F_DSA_VERIFY				 108
#define DSA_F_I2D_DSA_SIG				 111

/* Reason codes. */
#define DSA_R_DATA_TOO_LARGE_FOR_KEY_SIZE		 100

#ifdef  __cplusplus
}
#endif
#endif
Commit	Line	Data
d02b48c6	1	/* crypto/dsa/dsa.h */
58964a49	2	/* Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com)
d02b48c6 RE	3	* All rights reserved.
	4	*
	5	* This package is an SSL implementation written
	6	* by Eric Young (eay@cryptsoft.com).
	7	* The implementation was written so as to conform with Netscapes SSL.
	8	*
	9	* This library is free for commercial and non-commercial use as long as
	10	* the following conditions are aheared to. The following conditions
	11	* apply to all code found in this distribution, be it the RC4, RSA,
	12	* lhash, DES, etc., code; not just the SSL code. The SSL documentation
	13	* included with this distribution is covered by the same copyright terms
	14	* except that the holder is Tim Hudson (tjh@cryptsoft.com).
	15	*
	16	* Copyright remains Eric Young's, and as such any Copyright notices in
	17	* the code are not to be removed.
	18	* If this package is used in a product, Eric Young should be given attribution
	19	* as the author of the parts of the library used.
	20	* This can be in the form of a textual message at program startup or
	21	* in documentation (online or textual) provided with the package.
	22	*
	23	* Redistribution and use in source and binary forms, with or without
	24	* modification, are permitted provided that the following conditions
	25	* are met:
	26	* 1. Redistributions of source code must retain the copyright
	27	* notice, this list of conditions and the following disclaimer.
	28	* 2. Redistributions in binary form must reproduce the above copyright
	29	* notice, this list of conditions and the following disclaimer in the
	30	* documentation and/or other materials provided with the distribution.
	31	* 3. All advertising materials mentioning features or use of this software
	32	* must display the following acknowledgement:
	33	* "This product includes cryptographic software written by
	34	* Eric Young (eay@cryptsoft.com)"
	35	* The word 'cryptographic' can be left out if the rouines from the library
	36	* being used are not cryptographic related :-).
	37	* 4. If you include any Windows specific code (or a derivative thereof) from
	38	* the apps directory (application code) you must include an acknowledgement:
	39	* "This product includes software written by Tim Hudson (tjh@cryptsoft.com)"
	40	*
	41	* THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND
	42	* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
	43	* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
	44	* ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
	45	* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
	46	* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
	47	* OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
	48	* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
	49	* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
	50	* OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
	51	* SUCH DAMAGE.
	52	*
	53	* The licence and distribution terms for any publically available version or
	54	* derivative of this code cannot be changed. i.e. this code cannot simply be
	55	* copied and put under another distribution licence
	56	* [including the GNU Public Licence.]
	57	*/
	58
	59	/*
	60	* The DSS routines are based on patches supplied by
	61	* Steven Schoch <schoch@sheba.arc.nasa.gov>. He basically did the
	62	* work and I have just tweaked them a little to fit into my
	63	* stylistic vision for SSLeay :-) */
	64
	65	#ifndef HEADER_DSA_H
	66	#define HEADER_DSA_H
67
68	#ifdef __cplusplus
69	extern "C" {
70	#endif
71
f5d7a031 UM	72	#ifdef NO_DSA
	73	#error DSA is disabled.
	74	#endif
	75
ec577822	76	#include <openssl/bn.h>
c0711f7f	77	#include <openssl/crypto.h>
48c843c3 BM	78	#ifndef NO_DH
	79	# include <openssl/dh.h>
	80	#endif
d02b48c6	81
dfeab068 RE	82	#define DSA_FLAG_CACHE_MONT_P 0x01
dfeab068 RE	83
c0711f7f DSH	84	typedef struct dsa_st DSA;
	85
	86	typedef struct DSA_SIG_st
	87	{
	88	BIGNUM *r;
	89	BIGNUM *s;
	90	} DSA_SIG;
	91
	92	typedef struct dsa_method {
	93	const char *name;
	94	DSA_SIG * (dsa_do_sign)(const unsigned char dgst, int dlen, DSA *dsa);
	95	int (dsa_sign_setup)(DSA dsa, BN_CTX ctx_in, BIGNUM *kinvp,
	96	BIGNUM **rp);
	97	int (dsa_do_verify)(const unsigned char dgst, int dgst_len,
	98	DSA_SIG sig, DSA dsa);
	99	int (dsa_mod_exp)(DSA dsa, BIGNUM rr, BIGNUM a1, BIGNUM *p1,
	100	BIGNUM a2, BIGNUM p2, BIGNUM m, BN_CTX ctx,
	101	BN_MONT_CTX *in_mont);
	102	int (bn_mod_exp)(DSA dsa, BIGNUM r, BIGNUM a, const BIGNUM *p,
	103	const BIGNUM m, BN_CTX ctx,
	104	BN_MONT_CTX m_ctx); / Can be null */
	105	int (init)(DSA dsa);
	106	int (finish)(DSA dsa);
	107	int flags;
	108	char *app_data;
	109	} DSA_METHOD;
	110
	111	struct dsa_st
d02b48c6 RE	112	{
	113	/* This first variable is used to pick up errors where
	114	* a DSA is passed instead of of a EVP_PKEY */
	115	int pad;
	116	int version;
	117	int write_params;
	118	BIGNUM *p;
	119	BIGNUM q; / == 20 */
	120	BIGNUM *g;
	121
	122	BIGNUM pub_key; / y public key */
	123	BIGNUM priv_key; / x private key */
	124
	125	BIGNUM kinv; / Signing pre-calc */
	126	BIGNUM r; / Signing pre-calc */
	127
dfeab068 RE	128	int flags;
	129	/* Normally used to cache montgomery values */
	130	char *method_mont_p;
d02b48c6	131	int references;
c0711f7f DSH	132	CRYPTO_EX_DATA ex_data;
	133	DSA_METHOD *meth;
	134	};
a8da8918	135
d02b48c6 RE	136	#define DSAparams_dup(x) (DSA )ASN1_dup((int ()())i2d_DSAparams, \
	137	(char ()())d2i_DSAparams,(char *)(x))
	138	#define d2i_DSAparams_fp(fp,x) (DSA )ASN1_d2i_fp((char (*)())DSA_new, \
	139	(char ()())d2i_DSAparams,(fp),(unsigned char **)(x))
	140	#define i2d_DSAparams_fp(fp,x) ASN1_i2d_fp(i2d_DSAparams,(fp), \
	141	(unsigned char *)(x))
	142	#define d2i_DSAparams_bio(bp,x) (DSA )ASN1_d2i_bio((char (*)())DSA_new, \
	143	(char ()())d2i_DSAparams,(bp),(unsigned char **)(x))
	144	#define i2d_DSAparams_bio(bp,x) ASN1_i2d_bio(i2d_DSAparams,(bp), \
	145	(unsigned char *)(x))
	146
d02b48c6	147
a8da8918 UM	148	DSA_SIG * DSA_SIG_new(void);
	149	void DSA_SIG_free(DSA_SIG *a);
	150	int i2d_DSA_SIG(DSA_SIG a, unsigned char *pp);
	151	DSA_SIG * d2i_DSA_SIG(DSA_SIG v, unsigned char pp, long length);
	152
61f5b6f3 BL	153	DSA_SIG * DSA_do_sign(const unsigned char dgst,int dlen,DSA dsa);
	154	int DSA_do_verify(const unsigned char *dgst,int dgst_len,
	155	DSA_SIG sig,DSA dsa);
a8da8918	156
c0711f7f DSH	157	DSA_METHOD *DSA_OpenSSL(void);
c0711f7f DSH	158
f8463356 RE	159	void DSA_set_default_method(DSA_METHOD *);
	160	DSA_METHOD *DSA_get_default_method(void);
	161	DSA_METHOD DSA_set_method(DSA dsa, DSA_METHOD *);
	162
d02b48c6	163	DSA * DSA_new(void);
c0711f7f	164	DSA * DSA_new_method(DSA_METHOD *meth);
d02b48c6	165	int DSA_size(DSA *);
d02b48c6 RE	166	/* next 4 return -1 on error */
d02b48c6 RE	167	int DSA_sign_setup( DSA dsa,BN_CTX ctx_in,BIGNUM kinvp,BIGNUM rp);
61f5b6f3	168	int DSA_sign(int type,const unsigned char *dgst,int dlen,
d02b48c6	169	unsigned char sig, unsigned int siglen, DSA *dsa);
61f5b6f3	170	int DSA_verify(int type,const unsigned char *dgst,int dgst_len,
d02b48c6 RE	171	unsigned char sigbuf, int siglen, DSA dsa);
d02b48c6 RE	172	void DSA_free (DSA *r);
c0711f7f DSH	173	int DSA_get_ex_new_index(long argl, char argp, int (new_func)(),
	174	int (dup_func)(), void (free_func)());
	175	int DSA_set_ex_data(DSA d, int idx, char arg);
	176	char DSA_get_ex_data(DSA d, int idx);
d02b48c6 RE	177
	178	void ERR_load_DSA_strings(void );
	179
	180	DSA * d2i_DSAPublicKey(DSA a, unsigned char pp, long length);
	181	DSA * d2i_DSAPrivateKey(DSA a, unsigned char pp, long length);
	182	DSA * d2i_DSAparams(DSA a, unsigned char pp, long length);
	183	DSA * DSA_generate_parameters(int bits, unsigned char *seed,int seed_len,
58964a49 RE	184	int counter_ret, unsigned long h_ret,void
58964a49 RE	185	(callback)(),char cb_arg);
d02b48c6 RE	186	int DSA_generate_key(DSA *a);
	187	int i2d_DSAPublicKey(DSA a, unsigned char *pp);
	188	int i2d_DSAPrivateKey(DSA a, unsigned char *pp);
	189	int i2d_DSAparams(DSA a,unsigned char *pp);
	190
	191	#ifdef HEADER_BIO_H
	192	int DSAparams_print(BIO bp, DSA x);
	193	int DSA_print(BIO bp, DSA x, int off);
	194	#endif
58964a49	195	#ifndef NO_FP_API
d02b48c6 RE	196	int DSAparams_print_fp(FILE fp, DSA x);
	197	int DSA_print_fp(FILE bp, DSA x, int off);
	198	#endif
	199
58964a49	200	int DSA_is_prime(BIGNUM q,void (callback)(),char *cb_arg);
d02b48c6	201
48c843c3 BM	202	#ifndef NO_DH
	203	/* Convert DSA structure (key or just parameters) into DH structure
	204	* (be careful to avoid small subgroup attacks when using this!) */
	205	DH DSA_dup_DH(DSA r);
	206	#endif
	207
d02b48c6	208	/* BEGIN ERROR CODES */
6d311938 DSH	209	/* The following lines are auto generated by the script mkerr.pl. Any changes
	210	* made after this point may be overwritten when the script is next run.
	211	*/
	212
d02b48c6 RE	213	/* Error codes for the DSA functions. */
	214
	215	/* Function codes. */
6d311938	216	#define DSA_F_D2I_DSA_SIG 110
d02b48c6 RE	217	#define DSA_F_DSAPARAMS_PRINT 100
d02b48c6 RE	218	#define DSA_F_DSAPARAMS_PRINT_FP 101
6d311938 DSH	219	#define DSA_F_DSA_DO_SIGN 112
6d311938 DSH	220	#define DSA_F_DSA_DO_VERIFY 113
d02b48c6 RE	221	#define DSA_F_DSA_IS_PRIME 102
	222	#define DSA_F_DSA_NEW 103
	223	#define DSA_F_DSA_PRINT 104
	224	#define DSA_F_DSA_PRINT_FP 105
	225	#define DSA_F_DSA_SIGN 106
	226	#define DSA_F_DSA_SIGN_SETUP 107
a8da8918	227	#define DSA_F_DSA_SIG_NEW 109
6d311938	228	#define DSA_F_DSA_VERIFY 108
a8da8918	229	#define DSA_F_I2D_DSA_SIG 111
d02b48c6 RE	230
	231	/* Reason codes. */
	232	#define DSA_R_DATA_TOO_LARGE_FOR_KEY_SIZE 100
6d311938	233
d02b48c6 RE	234	#ifdef __cplusplus
	235	}
	236	#endif
	237	#endif
	238