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_new hc_DH_new
  45 #define DH_new_method hc_DH_new_method
  46 #define DH_free hc_DH_free
  47 #define DH_up_ref hc_DH_up_ref
  48 #define DH_size hc_DH_size
  49 #define DH_set_default_method hc_DH_set_default_method
  50 #define DH_get_default_method hc_DH_get_default_method
  51 #define DH_set_method hc_DH_set_method
  52 #define DH_get_method hc_DH_get_method
  53 #define DH_set_ex_data hc_DH_set_ex_data
  54 #define DH_get_ex_data hc_DH_get_ex_data
  55 #define DH_generate_parameters_ex hc_DH_generate_parameters_ex
  56 #define DH_check_pubkey hc_DH_check_pubkey
  57 #define DH_generate_key hc_DH_generate_key
  58 #define DH_compute_key hc_DH_compute_key
  59
  60 /*
  61  *
  62  */
  63
  64 typedef struct DH DH;
  65 typedef struct DH_METHOD DH_METHOD;
  66
  67 #include <hcrypto/bn.h>
  68 #include <hcrypto/engine.h>
  69
  70 struct DH_METHOD {
  71     const char *name;
  72     int (*generate_key)(DH *);
  73     int (*compute_key)(unsigned char *,const BIGNUM *,DH *);
  74     int (*bn_mod_exp)(const DH *, BIGNUM *, const BIGNUM *,
  75                       const BIGNUM *, const BIGNUM *, BN_CTX *,
  76                       BN_MONT_CTX *);
  77     int (*init)(DH *);
  78     int (*finish)(DH *);
  79     int flags;
  80     void *app_data;
  81     int (*generate_params)(DH *, int, int, BN_GENCB *);
  82 };
  83
  84 struct DH {
  85     int pad;
  86     int version;
  87     BIGNUM *p;
  88     BIGNUM *g;
  89     long length;
  90     BIGNUM *pub_key;
  91     BIGNUM *priv_key;
  92     int flags;
  93     void *method_mont_p;
  94     BIGNUM *q;
  95     BIGNUM *j;
  96     void *seed;
  97     int seedlen;
  98     BIGNUM *counter;
  99     int references;
 100     struct CRYPTO_EX_DATA {
 101         void *sk;
 102         int dummy;
 103     } ex_data;
 104     const DH_METHOD *meth;
 105     ENGINE *engine;
 106 };
 107
 108 /* DH_check_pubkey return codes in `codes' argument. */
 109 #define DH_CHECK_PUBKEY_TOO_SMALL 1
 110 #define DH_CHECK_PUBKEY_TOO_LARGE 2
 111
 112 /*
 113  *
 114  */
 115
 116 const DH_METHOD *DH_null_method(void);
 117 const DH_METHOD *DH_imath_method(void);
 118
 119 DH *    DH_new(void);
 120 DH *    DH_new_method(ENGINE *);
 121 void    DH_free(DH *);
 122 int     DH_up_ref(DH *);
 123
 124 int     DH_size(const DH *);
 125
 126
 127 void    DH_set_default_method(const DH_METHOD *);
 128 const DH_METHOD *
 129         DH_get_default_method(void);
 130 int     DH_set_method(DH *, const DH_METHOD *);
 131
 132 int     DH_set_ex_data(DH *, int, void *);
 133 void *  DH_get_ex_data(DH *, int);
 134
 135 int     DH_generate_parameters_ex(DH *, int, int, BN_GENCB *);
 136 int     DH_check_pubkey(const DH *, const BIGNUM *, int *);
 137 int     DH_generate_key(DH *);
 138 int     DH_compute_key(unsigned char *,const BIGNUM *,DH *);
 139
 140 #endif /* _HEIM_DH_H */
 141