lib/hcrypto/dh.h

   1 /*
   2  * Copyright (c) 2006 Kungliga Tekniska Högskolan
   3  * (Royal Institute of Technology, Stockholm, Sweden).
   4  * All rights reserved.
   5  *
   6  * Redistribution and use in source and binary forms, with or without
   7  * modification, are permitted provided that the following conditions
   8  * are met:
   9  *
  10  * 1. Redistributions of source code must retain the above copyright
  11  *    notice, this list of conditions and the following disclaimer.
  12  *
  13  * 2. Redistributions in binary form must reproduce the above copyright
  14  *    notice, this list of conditions and the following disclaimer in the
  15  *    documentation and/or other materials provided with the distribution.
  16  *
  17  * 3. Neither the name of the Institute nor the names of its contributors
  18  *    may be used to endorse or promote products derived from this software
  19  *    without specific prior written permission.
  20  *
  21  * THIS SOFTWARE IS PROVIDED BY THE INSTITUTE AND CONTRIBUTORS ``AS IS'' AND
  22  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  23  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  24  * ARE DISCLAIMED.  IN NO EVENT SHALL THE INSTITUTE OR CONTRIBUTORS BE LIABLE
  25  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  26  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  27  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  28  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  29  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  30  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  31  * SUCH DAMAGE.
  32  */
  33
  34 /*
  35  * $Id$
  36  */
  37
  38 #ifndef _HEIM_DH_H
  39 #define _HEIM_DH_H 1
  40
  41 /* symbol renaming */
  42 #define DH_null_method hc_DH_null_method
  43 #define DH_imath_method hc_DH_imath_method
  44 #define DH_tfm_method hc_DH_tfm_method
  45 #define DH_new hc_DH_new
  46 #define DH_new_method hc_DH_new_method
  47 #define DH_free hc_DH_free
  48 #define DH_up_ref hc_DH_up_ref
  49 #define DH_size hc_DH_size
  50 #define DH_set_default_method hc_DH_set_default_method
  51 #define DH_get_default_method hc_DH_get_default_method
  52 #define DH_set_method hc_DH_set_method
  53 #define DH_get_method hc_DH_get_method
  54 #define DH_set_ex_data hc_DH_set_ex_data
  55 #define DH_get_ex_data hc_DH_get_ex_data
  56 #define DH_generate_parameters_ex hc_DH_generate_parameters_ex
  57 #define DH_check_pubkey hc_DH_check_pubkey
  58 #define DH_generate_key hc_DH_generate_key
  59 #define DH_compute_key hc_DH_compute_key
  60
  61 /*
  62  *
  63  */
  64
  65 typedef struct DH DH;
  66 typedef struct DH_METHOD DH_METHOD;
  67
  68 #include <hcrypto/bn.h>
  69 #include <hcrypto/engine.h>
  70
  71 struct DH_METHOD {
  72     const char *name;
  73     int (*generate_key)(DH *);
  74     int (*compute_key)(unsigned char *,const BIGNUM *,DH *);
  75     int (*bn_mod_exp)(const DH *, BIGNUM *, const BIGNUM *,
  76                       const BIGNUM *, const BIGNUM *, BN_CTX *,
  77                       BN_MONT_CTX *);
  78     int (*init)(DH *);
  79     int (*finish)(DH *);
  80     int flags;
  81     void *app_data;
  82     int (*generate_params)(DH *, int, int, BN_GENCB *);
  83 };
  84
  85 struct DH {
  86     int pad;
  87     int version;
  88     BIGNUM *p;
  89     BIGNUM *g;
  90     long length;
  91     BIGNUM *pub_key;
  92     BIGNUM *priv_key;
  93     int flags;
  94     void *method_mont_p;
  95     BIGNUM *q;
  96     BIGNUM *j;
  97     void *seed;
  98     int seedlen;
  99     BIGNUM *counter;
 100     int references;
 101     struct CRYPTO_EX_DATA {
 102         void *sk;
 103         int dummy;
 104     } ex_data;
 105     const DH_METHOD *meth;
 106     ENGINE *engine;
 107 };
 108
 109 /* DH_check_pubkey return codes in `codes' argument. */
 110 #define DH_CHECK_PUBKEY_TOO_SMALL 1
 111 #define DH_CHECK_PUBKEY_TOO_LARGE 2
 112
 113 /*
 114  *
 115  */
 116
 117 const DH_METHOD *DH_null_method(void);
 118 const DH_METHOD *DH_tfm_method(void);
 119 const DH_METHOD *DH_imath_method(void);
 120
 121 DH *    DH_new(void);
 122 DH *    DH_new_method(ENGINE *);
 123 void    DH_free(DH *);
 124 int     DH_up_ref(DH *);
 125
 126 int     DH_size(const DH *);
 127
 128
 129 void    DH_set_default_method(const DH_METHOD *);
 130 const DH_METHOD *
 131         DH_get_default_method(void);
 132 int     DH_set_method(DH *, const DH_METHOD *);
 133
 134 int     DH_set_ex_data(DH *, int, void *);
 135 void *  DH_get_ex_data(DH *, int);
 136
 137 int     DH_generate_parameters_ex(DH *, int, int, BN_GENCB *);
 138 int     DH_check_pubkey(const DH *, const BIGNUM *, int *);
 139 int     DH_generate_key(DH *);
 140 int     DH_compute_key(unsigned char *,const BIGNUM *,DH *);
 141
 142 #endif /* _HEIM_DH_H */
 143