lib/hcrypto/evp.h

   1 /*
   2  * Copyright (c) 2005 - 2008 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 /* $Id$ */
  35
  36 #ifndef HEIM_EVP_H
  37 #define HEIM_EVP_H 1
  38
  39 #include <hcrypto/engine.h>
  40
  41 /* symbol renaming */
  42 #define EVP_CIPHER_CTX_block_size hc_EVP_CIPHER_CTX_block_size
  43 #define EVP_CIPHER_CTX_cipher hc_EVP_CIPHER_CTX_cipher
  44 #define EVP_CIPHER_CTX_cleanup hc_EVP_CIPHER_CTX_cleanup
  45 #define EVP_CIPHER_CTX_flags hc_EVP_CIPHER_CTX_flags
  46 #define EVP_CIPHER_CTX_get_app_data hc_EVP_CIPHER_CTX_get_app_data
  47 #define EVP_CIPHER_CTX_init hc_EVP_CIPHER_CTX_init
  48 #define EVP_CIPHER_CTX_iv_length hc_EVP_CIPHER_CTX_iv_length
  49 #define EVP_CIPHER_CTX_key_length hc_EVP_CIPHER_CTX_key_length
  50 #define EVP_CIPHER_CTX_mode hc_EVP_CIPHER_CTX_mode
  51 #define EVP_CIPHER_CTX_set_app_data hc_EVP_CIPHER_CTX_set_app_data
  52 #define EVP_CIPHER_CTX_set_key_length hc_EVP_CIPHER_CTX_set_key_length
  53 #define EVP_CIPHER_CTX_set_padding hc_EVP_CIPHER_CTX_set_padding
  54 #define EVP_CIPHER_block_size hc_EVP_CIPHER_block_size
  55 #define EVP_CIPHER_iv_length hc_EVP_CIPHER_iv_length
  56 #define EVP_CIPHER_key_length hc_EVP_CIPHER_key_length
  57 #define EVP_Cipher hc_EVP_Cipher
  58 #define EVP_CipherInit_ex hc_EVP_CipherInit_ex
  59 #define EVP_CipherUpdate hc_EVP_CipherUpdate
  60 #define EVP_CipherFinal_ex hc_EVP_CipherFinal_ex
  61 #define EVP_Digest hc_EVP_Digest
  62 #define EVP_DigestFinal_ex hc_EVP_DigestFinal_ex
  63 #define EVP_DigestInit_ex hc_EVP_DigestInit_ex
  64 #define EVP_DigestUpdate hc_EVP_DigestUpdate
  65 #define EVP_MD_CTX_block_size hc_EVP_MD_CTX_block_size
  66 #define EVP_MD_CTX_cleanup hc_EVP_MD_CTX_cleanup
  67 #define EVP_MD_CTX_create hc_EVP_MD_CTX_create
  68 #define EVP_MD_CTX_init hc_EVP_MD_CTX_init
  69 #define EVP_MD_CTX_destroy hc_EVP_MD_CTX_destroy
  70 #define EVP_MD_CTX_md hc_EVP_MD_CTX_md
  71 #define EVP_MD_CTX_size hc_EVP_MD_CTX_size
  72 #define EVP_MD_block_size hc_EVP_MD_block_size
  73 #define EVP_MD_size hc_EVP_MD_size
  74 #define EVP_aes_128_cbc hc_EVP_aes_128_cbc
  75 #define EVP_aes_192_cbc hc_EVP_aes_192_cbc
  76 #define EVP_aes_256_cbc hc_EVP_aes_256_cbc
  77
  78 #define EVP_des_cbc hc_EVP_des_cbc
  79 #define EVP_des_ede3_cbc hc_EVP_des_ede3_cbc
  80 #define EVP_enc_null hc_EVP_enc_null
  81 #define EVP_md2 hc_EVP_md2
  82 #define EVP_md4 hc_EVP_md4
  83 #define EVP_md5 hc_EVP_md5
  84 #define EVP_md_null hc_EVP_md_null
  85 #define EVP_rc2_40_cbc hc_EVP_rc2_40_cbc
  86 #define EVP_rc2_64_cbc hc_EVP_rc2_64_cbc
  87 #define EVP_rc2_cbc hc_EVP_rc2_cbc
  88 #define EVP_rc4 hc_EVP_rc4
  89 #define EVP_rc4_40 hc_EVP_rc4_40
  90 #define EVP_camellia_128_cbc hc_EVP_camellia_128_cbc
  91 #define EVP_camellia_192_cbc hc_EVP_camellia_192_cbc
  92 #define EVP_camellia_256_cbc hc_EVP_camellia_256_cbc
  93 #define EVP_sha hc_EVP_sha
  94 #define EVP_sha1 hc_EVP_sha1
  95 #define EVP_sha256 hc_EVP_sha256
  96 #define PKCS5_PBKDF2_HMAC_SHA1 hc_PKCS5_PBKDF2_HMAC_SHA1
  97 #define EVP_BytesToKey hc_EVP_BytesToKey
  98 #define EVP_get_cipherbyname hc_EVP_get_cipherbyname
  99 #define OpenSSL_add_all_algorithms hc_OpenSSL_add_all_algorithms
 100 #define OpenSSL_add_all_algorithms_conf hc_OpenSSL_add_all_algorithms_conf
 101 #define OpenSSL_add_all_algorithms_noconf hc_OpenSSL_add_all_algorithms_noconf
 102 #define EVP_CIPHER_CTX_ctrl hc_EVP_CIPHER_CTX_ctrl
 103 #define EVP_CIPHER_CTX_rand_key hc_EVP_CIPHER_CTX_rand_key
 104
 105 /*
 106  *
 107  */
 108
 109 typedef struct hc_EVP_MD_CTX EVP_MD_CTX;
 110 typedef struct hc_evp_pkey EVP_PKEY;
 111 typedef struct hc_evp_md EVP_MD;
 112 typedef struct hc_CIPHER EVP_CIPHER;
 113 typedef struct hc_CIPHER_CTX EVP_CIPHER_CTX;
 114
 115 #define EVP_MAX_IV_LENGTH       16
 116 #define EVP_MAX_BLOCK_LENGTH    32
 117
 118 #define EVP_MAX_MD_SIZE         64
 119
 120 struct hc_CIPHER {
 121     int nid;
 122     int block_size;
 123     int key_len;
 124     int iv_len;
 125     unsigned long flags;
 126     /* The lowest 3 bits is used as integer field for the mode the
 127      * cipher is used in (use EVP_CIPHER.._mode() to extract the
 128      * mode). The rest of the flag field is a bitfield.
 129      */
 130 #define EVP_CIPH_STREAM_CIPHER          0
 131 #define EVP_CIPH_CBC_MODE               2
 132 #define EVP_CIPH_MODE                   0x7
 133
 134 #define EVP_CIPH_VARIABLE_LENGTH        0x008 /* variable key length */
 135 #define EVP_CIPH_ALWAYS_CALL_INIT       0x020
 136 #define EVP_CIPH_RAND_KEY               0x200
 137
 138     int (*init)(EVP_CIPHER_CTX*,const unsigned char*,const unsigned char*,int);
 139     int (*do_cipher)(EVP_CIPHER_CTX *, unsigned char *,
 140                      const unsigned char *, unsigned int);
 141     int (*cleanup)(EVP_CIPHER_CTX *);
 142     int ctx_size;
 143     void *set_asn1_parameters;
 144     void *get_asn1_parameters;
 145     int (*ctrl)(EVP_CIPHER_CTX *, int type, int arg, void *ptr);
 146 #define EVP_CTRL_RAND_KEY               0x6
 147
 148     void *app_data;
 149 };
 150
 151 struct hc_CIPHER_CTX {
 152     const EVP_CIPHER *cipher;
 153     ENGINE *engine;
 154     int encrypt;
 155     int buf_len; /* bytes stored in buf for EVP_CipherUpdate */
 156     unsigned char oiv[EVP_MAX_IV_LENGTH];
 157     unsigned char iv[EVP_MAX_IV_LENGTH];
 158     unsigned char buf[EVP_MAX_BLOCK_LENGTH];
 159     int num;
 160     void *app_data;
 161     int key_len;
 162     unsigned long flags;
 163     void *cipher_data;
 164     int final_used;
 165     int block_mask;
 166     unsigned char final[EVP_MAX_BLOCK_LENGTH];
 167 };
 168
 169 typedef int (*hc_evp_md_init)(EVP_MD_CTX *);
 170 typedef int (*hc_evp_md_update)(EVP_MD_CTX *,const void *, size_t);
 171 typedef int (*hc_evp_md_final)(void *, EVP_MD_CTX *);
 172 typedef int (*hc_evp_md_cleanup)(EVP_MD_CTX *);
 173
 174 struct hc_evp_md {
 175     int hash_size;
 176     int block_size;
 177     int ctx_size;
 178     hc_evp_md_init init;
 179     hc_evp_md_update update;
 180     hc_evp_md_final final;
 181     hc_evp_md_cleanup cleanup;
 182 };
 183
 184 #if !defined(__GNUC__) && !defined(__attribute__)
 185 #define __attribute__(x)
 186 #endif
 187
 188 #ifndef HC_DEPRECATED
 189 #if defined(__GNUC__) && ((__GNUC__ > 3) || ((__GNUC__ == 3) && (__GNUC_MINOR__ >= 1 )))
 190 #define HC_DEPRECATED __attribute__((deprecated))
 191 #elif defined(_MSC_VER) && (_MSC_VER>1200)
 192 #define HC_DEPRECATED __declspec(deprecated)
 193 #else
 194 #define HC_DEPRECATED
 195 #endif
 196 #endif
 197
 198 #ifndef HC_DEPRECATED_CRYPTO
 199 #define HC_DEPRECATED_CRYPTO HC_DEPRECATED
 200 #endif
 201
 202 #ifdef __cplusplus
 203 #define HC_CPP_BEGIN extern "C" {
 204 #define HC_CPP_END }
 205 #else
 206 #define HC_CPP_BEGIN
 207 #define HC_CPP_END
 208 #endif
 209
 210 HC_CPP_BEGIN
 211
 212 /*
 213  * Avaible crypto algs
 214  */
 215
 216 const EVP_MD *EVP_md_null(void);
 217 const EVP_MD *EVP_md2(void) HC_DEPRECATED_CRYPTO;
 218 const EVP_MD *EVP_md4(void) HC_DEPRECATED_CRYPTO;
 219 const EVP_MD *EVP_md5(void) HC_DEPRECATED_CRYPTO;
 220 const EVP_MD *EVP_sha(void) HC_DEPRECATED;
 221 const EVP_MD *EVP_sha1(void);
 222 const EVP_MD *EVP_sha256(void);
 223
 224 const EVP_CIPHER * EVP_aes_128_cbc(void);
 225 const EVP_CIPHER * EVP_aes_192_cbc(void);
 226 const EVP_CIPHER * EVP_aes_256_cbc(void);
 227 const EVP_CIPHER * EVP_des_cbc(void) HC_DEPRECATED_CRYPTO;
 228 const EVP_CIPHER * EVP_des_ede3_cbc(void);
 229 const EVP_CIPHER * EVP_enc_null(void);
 230 const EVP_CIPHER * EVP_rc2_40_cbc(void) HC_DEPRECATED_CRYPTO;
 231 const EVP_CIPHER * EVP_rc2_64_cbc(void) HC_DEPRECATED_CRYPTO;
 232 const EVP_CIPHER * EVP_rc2_cbc(void) HC_DEPRECATED_CRYPTO;
 233 const EVP_CIPHER * EVP_rc4(void);
 234 const EVP_CIPHER * EVP_rc4_40(void) HC_DEPRECATED_CRYPTO;
 235 const EVP_CIPHER * EVP_camellia_128_cbc(void);
 236 const EVP_CIPHER * EVP_camellia_192_cbc(void);
 237 const EVP_CIPHER * EVP_camellia_256_cbc(void);
 238
 239 size_t  EVP_MD_size(const EVP_MD *);
 240 size_t  EVP_MD_block_size(const EVP_MD *);
 241
 242 const EVP_MD *
 243         EVP_MD_CTX_md(EVP_MD_CTX *);
 244 size_t  EVP_MD_CTX_size(EVP_MD_CTX *);
 245 size_t  EVP_MD_CTX_block_size(EVP_MD_CTX *);
 246
 247 EVP_MD_CTX *
 248         EVP_MD_CTX_create(void);
 249 void    HC_DEPRECATED EVP_MD_CTX_init(EVP_MD_CTX *);
 250 void    EVP_MD_CTX_destroy(EVP_MD_CTX *);
 251 int     HC_DEPRECATED EVP_MD_CTX_cleanup(EVP_MD_CTX *);
 252
 253 int     EVP_DigestInit_ex(EVP_MD_CTX *, const EVP_MD *, ENGINE *);
 254 int     EVP_DigestUpdate(EVP_MD_CTX *,const void *, size_t);
 255 int     EVP_DigestFinal_ex(EVP_MD_CTX *, void *, unsigned int *);
 256 int     EVP_Digest(const void *, size_t, void *, unsigned int *,
 257                    const EVP_MD *, ENGINE *);
 258 /*
 259  *
 260  */
 261
 262 const EVP_CIPHER *
 263         EVP_get_cipherbyname(const char *);
 264
 265 size_t  EVP_CIPHER_block_size(const EVP_CIPHER *);
 266 size_t  EVP_CIPHER_key_length(const EVP_CIPHER *);
 267 size_t  EVP_CIPHER_iv_length(const EVP_CIPHER *);
 268
 269 void    EVP_CIPHER_CTX_init(EVP_CIPHER_CTX *);
 270 int     EVP_CIPHER_CTX_cleanup(EVP_CIPHER_CTX *);
 271 int     EVP_CIPHER_CTX_set_key_length(EVP_CIPHER_CTX *, int);
 272 int     EVP_CIPHER_CTX_set_padding(EVP_CIPHER_CTX *, int);
 273 unsigned long
 274         EVP_CIPHER_CTX_flags(const EVP_CIPHER_CTX *);
 275 int     EVP_CIPHER_CTX_mode(const EVP_CIPHER_CTX *);
 276
 277 const EVP_CIPHER *
 278         EVP_CIPHER_CTX_cipher(EVP_CIPHER_CTX *);
 279 size_t  EVP_CIPHER_CTX_block_size(const EVP_CIPHER_CTX *);
 280 size_t  EVP_CIPHER_CTX_key_length(const EVP_CIPHER_CTX *);
 281 size_t  EVP_CIPHER_CTX_iv_length(const EVP_CIPHER_CTX *);
 282 void *  EVP_CIPHER_CTX_get_app_data(EVP_CIPHER_CTX *);
 283 void    EVP_CIPHER_CTX_set_app_data(EVP_CIPHER_CTX *, void *);
 284
 285 int     EVP_CIPHER_CTX_ctrl(EVP_CIPHER_CTX *, int, int, void *);
 286 int     EVP_CIPHER_CTX_rand_key(EVP_CIPHER_CTX *, void *);
 287
 288
 289 int     EVP_CipherInit_ex(EVP_CIPHER_CTX *,const EVP_CIPHER *, ENGINE *,
 290                           const void *, const void *, int);
 291 int     EVP_CipherUpdate(EVP_CIPHER_CTX *, void *, int *, void *, size_t);
 292 int     EVP_CipherFinal_ex(EVP_CIPHER_CTX *, void *, int *);
 293
 294 int     EVP_Cipher(EVP_CIPHER_CTX *,void *,const void *,size_t);
 295
 296 int     PKCS5_PBKDF2_HMAC_SHA1(const void *, size_t, const void *, size_t,
 297                                unsigned long, size_t, void *);
 298
 299 int     EVP_BytesToKey(const EVP_CIPHER *, const EVP_MD *,
 300                        const void *, const void *, size_t,
 301                        unsigned int, void *, void *);
 302
 303
 304 /*
 305  *
 306  */
 307
 308 void    OpenSSL_add_all_algorithms(void);
 309 void    OpenSSL_add_all_algorithms_conf(void);
 310 void    OpenSSL_add_all_algorithms_noconf(void);
 311
 312 HC_CPP_END
 313
 314 #endif /* HEIM_EVP_H */