src/cipher.h

   1 /* cipher.h
   2  *      Copyright (C) 1998, 2002, 2003, 2009 Free Software Foundation, Inc.
   3  *
   4  * This file is part of Libgcrypt.
   5  *
   6  * Libgcrypt is free software; you can redistribute it and/or modify
   7  * it under the terms of the GNU Lesser general Public License as
   8  * published by the Free Software Foundation; either version 2.1 of
   9  * the License, or (at your option) any later version.
  10  *
  11  * Libgcrypt is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14  * GNU Lesser General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU Lesser General Public
  17  * License along with this program; if not, write to the Free Software
  18  * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA
  19  */
  20 #ifndef G10_CIPHER_H
  21 #define G10_CIPHER_H
  22
  23 #include "gcrypt-int.h"
  24
  25 #define DBG_CIPHER _gcry_get_debug_flag( 1 )
  26
  27 #include "../random/random.h"
  28
  29 #define PUBKEY_FLAG_NO_BLINDING    (1 << 0)
  30 #define PUBKEY_FLAG_RFC6979        (1 << 1)
  31 #define PUBKEY_FLAG_FIXEDLEN       (1 << 2)
  32 #define PUBKEY_FLAG_LEGACYRESULT   (1 << 3)
  33 #define PUBKEY_FLAG_RAW_FLAG       (1 << 4)
  34 #define PUBKEY_FLAG_TRANSIENT_KEY  (1 << 5)
  35 #define PUBKEY_FLAG_USE_X931       (1 << 6)
  36 #define PUBKEY_FLAG_USE_FIPS186    (1 << 7)
  37 #define PUBKEY_FLAG_USE_FIPS186_2  (1 << 8)
  38 #define PUBKEY_FLAG_PARAM          (1 << 9)
  39 #define PUBKEY_FLAG_COMP           (1 << 10)
  40 #define PUBKEY_FLAG_NOCOMP         (1 << 11)
  41 #define PUBKEY_FLAG_EDDSA          (1 << 12)
  42 #define PUBKEY_FLAG_GOST           (1 << 13)
  43
  44
  45 enum pk_operation
  46   {
  47     PUBKEY_OP_ENCRYPT,
  48     PUBKEY_OP_DECRYPT,
  49     PUBKEY_OP_SIGN,
  50     PUBKEY_OP_VERIFY
  51   };
  52
  53 enum pk_encoding
  54   {
  55     PUBKEY_ENC_RAW,
  56     PUBKEY_ENC_PKCS1,
  57     PUBKEY_ENC_PKCS1_RAW,
  58     PUBKEY_ENC_OAEP,
  59     PUBKEY_ENC_PSS,
  60     PUBKEY_ENC_UNKNOWN
  61   };
  62
  63 struct pk_encoding_ctx
  64 {
  65   enum pk_operation op;
  66   unsigned int nbits;
  67
  68   enum pk_encoding encoding;
  69   int flags;
  70
  71   int hash_algo;
  72
  73   /* for OAEP */
  74   unsigned char *label;
  75   size_t labellen;
  76
  77   /* for PSS */
  78   size_t saltlen;
  79
  80   int (* verify_cmp) (void *opaque, gcry_mpi_t tmp);
  81   void *verify_arg;
  82 };
  83
  84 #define CIPHER_INFO_NO_WEAK_KEY    1
  85
  86 #include "cipher-proto.h"
  87
  88 /* The internal encryption modes. */
  89 enum gcry_cipher_internal_modes
  90   {
  91     GCRY_CIPHER_MODE_INTERNAL = 0x10000,
  92     GCRY_CIPHER_MODE_CMAC     = 0x10000 + 1   /* Cipher-based MAC. */
  93   };
  94
  95
  96 /*-- cipher.c --*/
  97 gcry_err_code_t _gcry_cipher_open_internal (gcry_cipher_hd_t *handle,
  98                                             int algo, int mode,
  99                                             unsigned int flags);
 100
 101 /*-- cipher-cmac.c --*/
 102 gcry_err_code_t _gcry_cipher_cmac_authenticate
 103 /*           */ (gcry_cipher_hd_t c, const unsigned char *abuf, size_t abuflen);
 104 gcry_err_code_t _gcry_cipher_cmac_get_tag
 105 /*           */ (gcry_cipher_hd_t c,
 106                  unsigned char *outtag, size_t taglen);
 107 gcry_err_code_t _gcry_cipher_cmac_check_tag
 108 /*           */ (gcry_cipher_hd_t c,
 109                  const unsigned char *intag, size_t taglen);
 110 gcry_err_code_t _gcry_cipher_cmac_set_subkeys
 111 /*           */ (gcry_cipher_hd_t c);
 112
 113 /*-- rmd160.c --*/
 114 void _gcry_rmd160_hash_buffer (void *outbuf,
 115                                const void *buffer, size_t length);
 116 /*-- sha1.c --*/
 117 void _gcry_sha1_hash_buffer (void *outbuf,
 118                              const void *buffer, size_t length);
 119 void _gcry_sha1_hash_buffers (void *outbuf,
 120                               const gcry_buffer_t *iov, int iovcnt);
 121
 122 /*-- rijndael.c --*/
 123 void _gcry_aes_cfb_enc (void *context, unsigned char *iv,
 124                         void *outbuf, const void *inbuf,
 125                         size_t nblocks);
 126 void _gcry_aes_cfb_dec (void *context, unsigned char *iv,
 127                         void *outbuf_arg, const void *inbuf_arg,
 128                         size_t nblocks);
 129 void _gcry_aes_cbc_enc (void *context, unsigned char *iv,
 130                         void *outbuf_arg, const void *inbuf_arg,
 131                         size_t nblocks, int cbc_mac);
 132 void _gcry_aes_cbc_dec (void *context, unsigned char *iv,
 133                         void *outbuf_arg, const void *inbuf_arg,
 134                         size_t nblocks);
 135 void _gcry_aes_ctr_enc (void *context, unsigned char *ctr,
 136                         void *outbuf_arg, const void *inbuf_arg,
 137                         size_t nblocks);
 138
 139 /*-- blowfish.c --*/
 140 void _gcry_blowfish_cfb_dec (void *context, unsigned char *iv,
 141                              void *outbuf_arg, const void *inbuf_arg,
 142                              size_t nblocks);
 143
 144 void _gcry_blowfish_cbc_dec (void *context, unsigned char *iv,
 145                              void *outbuf_arg, const void *inbuf_arg,
 146                              size_t nblocks);
 147
 148 void _gcry_blowfish_ctr_enc (void *context, unsigned char *ctr,
 149                              void *outbuf_arg, const void *inbuf_arg,
 150                              size_t nblocks);
 151
 152 /*-- cast5.c --*/
 153 void _gcry_cast5_cfb_dec (void *context, unsigned char *iv,
 154                           void *outbuf_arg, const void *inbuf_arg,
 155                           size_t nblocks);
 156
 157 void _gcry_cast5_cbc_dec (void *context, unsigned char *iv,
 158                           void *outbuf_arg, const void *inbuf_arg,
 159                           size_t nblocks);
 160
 161 void _gcry_cast5_ctr_enc (void *context, unsigned char *ctr,
 162                           void *outbuf_arg, const void *inbuf_arg,
 163                           size_t nblocks);
 164
 165 /*-- camellia-glue.c --*/
 166 void _gcry_camellia_ctr_enc (void *context, unsigned char *ctr,
 167                              void *outbuf_arg, const void *inbuf_arg,
 168                              size_t nblocks);
 169 void _gcry_camellia_cbc_dec (void *context, unsigned char *iv,
 170                              void *outbuf_arg, const void *inbuf_arg,
 171                              size_t nblocks);
 172 void _gcry_camellia_cfb_dec (void *context, unsigned char *iv,
 173                              void *outbuf_arg, const void *inbuf_arg,
 174                              size_t nblocks);
 175
 176 /*-- des.c --*/
 177 void _gcry_3des_ctr_enc (void *context, unsigned char *ctr,
 178                          void *outbuf_arg, const void *inbuf_arg,
 179                          size_t nblocks);
 180
 181 void _gcry_3des_cbc_dec (void *context, unsigned char *iv,
 182                          void *outbuf_arg, const void *inbuf_arg,
 183                          size_t nblocks);
 184
 185 void _gcry_3des_cfb_dec (void *context, unsigned char *iv,
 186                          void *outbuf_arg, const void *inbuf_arg,
 187                          size_t nblocks);
 188
 189 /*-- serpent.c --*/
 190 void _gcry_serpent_ctr_enc (void *context, unsigned char *ctr,
 191                             void *outbuf_arg, const void *inbuf_arg,
 192                             size_t nblocks);
 193 void _gcry_serpent_cbc_dec (void *context, unsigned char *iv,
 194                             void *outbuf_arg, const void *inbuf_arg,
 195                             size_t nblocks);
 196 void _gcry_serpent_cfb_dec (void *context, unsigned char *iv,
 197                             void *outbuf_arg, const void *inbuf_arg,
 198                             size_t nblocks);
 199
 200 /*-- twofish.c --*/
 201 void _gcry_twofish_ctr_enc (void *context, unsigned char *ctr,
 202                             void *outbuf_arg, const void *inbuf_arg,
 203                             size_t nblocks);
 204 void _gcry_twofish_cbc_dec (void *context, unsigned char *iv,
 205                             void *outbuf_arg, const void *inbuf_arg,
 206                             size_t nblocks);
 207 void _gcry_twofish_cfb_dec (void *context, unsigned char *iv,
 208                             void *outbuf_arg, const void *inbuf_arg,
 209                             size_t nblocks);
 210
 211 /*-- dsa.c --*/
 212 void _gcry_register_pk_dsa_progress (gcry_handler_progress_t cbc, void *cb_data);
 213
 214 /*-- elgamal.c --*/
 215 void _gcry_register_pk_elg_progress (gcry_handler_progress_t cb,
 216                                      void *cb_data);
 217
 218
 219 /*-- ecc.c --*/
 220 void _gcry_register_pk_ecc_progress (gcry_handler_progress_t cbc,
 221                                      void *cb_data);
 222
 223
 224 /*-- primegen.c --*/
 225 void _gcry_register_primegen_progress (gcry_handler_progress_t cb,
 226                                        void *cb_data);
 227
 228 /*-- pubkey.c --*/
 229
 230 /* Declarations for the cipher specifications.  */
 231 extern gcry_cipher_spec_t _gcry_cipher_spec_blowfish;
 232 extern gcry_cipher_spec_t _gcry_cipher_spec_des;
 233 extern gcry_cipher_spec_t _gcry_cipher_spec_tripledes;
 234 extern gcry_cipher_spec_t _gcry_cipher_spec_arcfour;
 235 extern gcry_cipher_spec_t _gcry_cipher_spec_cast5;
 236 extern gcry_cipher_spec_t _gcry_cipher_spec_aes;
 237 extern gcry_cipher_spec_t _gcry_cipher_spec_aes192;
 238 extern gcry_cipher_spec_t _gcry_cipher_spec_aes256;
 239 extern gcry_cipher_spec_t _gcry_cipher_spec_twofish;
 240 extern gcry_cipher_spec_t _gcry_cipher_spec_twofish128;
 241 extern gcry_cipher_spec_t _gcry_cipher_spec_serpent128;
 242 extern gcry_cipher_spec_t _gcry_cipher_spec_serpent192;
 243 extern gcry_cipher_spec_t _gcry_cipher_spec_serpent256;
 244 extern gcry_cipher_spec_t _gcry_cipher_spec_rfc2268_40;
 245 extern gcry_cipher_spec_t _gcry_cipher_spec_rfc2268_128;
 246 extern gcry_cipher_spec_t _gcry_cipher_spec_seed;
 247 extern gcry_cipher_spec_t _gcry_cipher_spec_camellia128;
 248 extern gcry_cipher_spec_t _gcry_cipher_spec_camellia192;
 249 extern gcry_cipher_spec_t _gcry_cipher_spec_camellia256;
 250 extern gcry_cipher_spec_t _gcry_cipher_spec_idea;
 251 extern gcry_cipher_spec_t _gcry_cipher_spec_salsa20;
 252 extern gcry_cipher_spec_t _gcry_cipher_spec_salsa20r12;
 253 extern gcry_cipher_spec_t _gcry_cipher_spec_gost28147;
 254 extern gcry_cipher_spec_t _gcry_cipher_spec_chacha20;
 255
 256 /* Declarations for the digest specifications.  */
 257 extern gcry_md_spec_t _gcry_digest_spec_crc32;
 258 extern gcry_md_spec_t _gcry_digest_spec_crc32_rfc1510;
 259 extern gcry_md_spec_t _gcry_digest_spec_crc24_rfc2440;
 260 extern gcry_md_spec_t _gcry_digest_spec_gost3411_94;
 261 extern gcry_md_spec_t _gcry_digest_spec_gost3411_cp;
 262 extern gcry_md_spec_t _gcry_digest_spec_stribog_256;
 263 extern gcry_md_spec_t _gcry_digest_spec_stribog_512;
 264 extern gcry_md_spec_t _gcry_digest_spec_md2;
 265 extern gcry_md_spec_t _gcry_digest_spec_md4;
 266 extern gcry_md_spec_t _gcry_digest_spec_md5;
 267 extern gcry_md_spec_t _gcry_digest_spec_rmd160;
 268 extern gcry_md_spec_t _gcry_digest_spec_sha1;
 269 extern gcry_md_spec_t _gcry_digest_spec_sha224;
 270 extern gcry_md_spec_t _gcry_digest_spec_sha256;
 271 extern gcry_md_spec_t _gcry_digest_spec_sha512;
 272 extern gcry_md_spec_t _gcry_digest_spec_sha384;
 273 extern gcry_md_spec_t _gcry_digest_spec_tiger;
 274 extern gcry_md_spec_t _gcry_digest_spec_tiger1;
 275 extern gcry_md_spec_t _gcry_digest_spec_tiger2;
 276 extern gcry_md_spec_t _gcry_digest_spec_whirlpool;
 277
 278 /* Declarations for the pubkey cipher specifications.  */
 279 extern gcry_pk_spec_t _gcry_pubkey_spec_rsa;
 280 extern gcry_pk_spec_t _gcry_pubkey_spec_elg;
 281 extern gcry_pk_spec_t _gcry_pubkey_spec_elg_e;
 282 extern gcry_pk_spec_t _gcry_pubkey_spec_dsa;
 283 extern gcry_pk_spec_t _gcry_pubkey_spec_ecc;
 284
 285
 286 #endif /*G10_CIPHER_H*/