Add a simple (raw) PKCS#1 padding mode
[libgcrypt.git] / 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 /*-- serpent.c --*/
177 void _gcry_serpent_ctr_enc (void *context, unsigned char *ctr,
178                             void *outbuf_arg, const void *inbuf_arg,
179                             size_t nblocks);
180 void _gcry_serpent_cbc_dec (void *context, unsigned char *iv,
181                             void *outbuf_arg, const void *inbuf_arg,
182                             size_t nblocks);
183 void _gcry_serpent_cfb_dec (void *context, unsigned char *iv,
184                             void *outbuf_arg, const void *inbuf_arg,
185                             size_t nblocks);
186
187 /*-- twofish.c --*/
188 void _gcry_twofish_ctr_enc (void *context, unsigned char *ctr,
189                             void *outbuf_arg, const void *inbuf_arg,
190                             size_t nblocks);
191 void _gcry_twofish_cbc_dec (void *context, unsigned char *iv,
192                             void *outbuf_arg, const void *inbuf_arg,
193                             size_t nblocks);
194 void _gcry_twofish_cfb_dec (void *context, unsigned char *iv,
195                             void *outbuf_arg, const void *inbuf_arg,
196                             size_t nblocks);
197
198 /*-- dsa.c --*/
199 void _gcry_register_pk_dsa_progress (gcry_handler_progress_t cbc, void *cb_data);
200
201 /*-- elgamal.c --*/
202 void _gcry_register_pk_elg_progress (gcry_handler_progress_t cb,
203                                      void *cb_data);
204
205
206 /*-- ecc.c --*/
207 void _gcry_register_pk_ecc_progress (gcry_handler_progress_t cbc,
208                                      void *cb_data);
209
210
211 /*-- primegen.c --*/
212 void _gcry_register_primegen_progress (gcry_handler_progress_t cb,
213                                        void *cb_data);
214
215 /*-- pubkey.c --*/
216
217 /* Declarations for the cipher specifications.  */
218 extern gcry_cipher_spec_t _gcry_cipher_spec_blowfish;
219 extern gcry_cipher_spec_t _gcry_cipher_spec_des;
220 extern gcry_cipher_spec_t _gcry_cipher_spec_tripledes;
221 extern gcry_cipher_spec_t _gcry_cipher_spec_arcfour;
222 extern gcry_cipher_spec_t _gcry_cipher_spec_cast5;
223 extern gcry_cipher_spec_t _gcry_cipher_spec_aes;
224 extern gcry_cipher_spec_t _gcry_cipher_spec_aes192;
225 extern gcry_cipher_spec_t _gcry_cipher_spec_aes256;
226 extern gcry_cipher_spec_t _gcry_cipher_spec_twofish;
227 extern gcry_cipher_spec_t _gcry_cipher_spec_twofish128;
228 extern gcry_cipher_spec_t _gcry_cipher_spec_serpent128;
229 extern gcry_cipher_spec_t _gcry_cipher_spec_serpent192;
230 extern gcry_cipher_spec_t _gcry_cipher_spec_serpent256;
231 extern gcry_cipher_spec_t _gcry_cipher_spec_rfc2268_40;
232 extern gcry_cipher_spec_t _gcry_cipher_spec_rfc2268_128;
233 extern gcry_cipher_spec_t _gcry_cipher_spec_seed;
234 extern gcry_cipher_spec_t _gcry_cipher_spec_camellia128;
235 extern gcry_cipher_spec_t _gcry_cipher_spec_camellia192;
236 extern gcry_cipher_spec_t _gcry_cipher_spec_camellia256;
237 extern gcry_cipher_spec_t _gcry_cipher_spec_idea;
238 extern gcry_cipher_spec_t _gcry_cipher_spec_salsa20;
239 extern gcry_cipher_spec_t _gcry_cipher_spec_salsa20r12;
240 extern gcry_cipher_spec_t _gcry_cipher_spec_gost28147;
241
242 /* Declarations for the digest specifications.  */
243 extern gcry_md_spec_t _gcry_digest_spec_crc32;
244 extern gcry_md_spec_t _gcry_digest_spec_crc32_rfc1510;
245 extern gcry_md_spec_t _gcry_digest_spec_crc24_rfc2440;
246 extern gcry_md_spec_t _gcry_digest_spec_gost3411_94;
247 extern gcry_md_spec_t _gcry_digest_spec_stribog_256;
248 extern gcry_md_spec_t _gcry_digest_spec_stribog_512;
249 extern gcry_md_spec_t _gcry_digest_spec_md4;
250 extern gcry_md_spec_t _gcry_digest_spec_md5;
251 extern gcry_md_spec_t _gcry_digest_spec_rmd160;
252 extern gcry_md_spec_t _gcry_digest_spec_sha1;
253 extern gcry_md_spec_t _gcry_digest_spec_sha224;
254 extern gcry_md_spec_t _gcry_digest_spec_sha256;
255 extern gcry_md_spec_t _gcry_digest_spec_sha512;
256 extern gcry_md_spec_t _gcry_digest_spec_sha384;
257 extern gcry_md_spec_t _gcry_digest_spec_tiger;
258 extern gcry_md_spec_t _gcry_digest_spec_tiger1;
259 extern gcry_md_spec_t _gcry_digest_spec_tiger2;
260 extern gcry_md_spec_t _gcry_digest_spec_whirlpool;
261
262 /* Declarations for the pubkey cipher specifications.  */
263 extern gcry_pk_spec_t _gcry_pubkey_spec_rsa;
264 extern gcry_pk_spec_t _gcry_pubkey_spec_elg;
265 extern gcry_pk_spec_t _gcry_pubkey_spec_elg_e;
266 extern gcry_pk_spec_t _gcry_pubkey_spec_dsa;
267 extern gcry_pk_spec_t _gcry_pubkey_spec_ecc;
268
269
270 #endif /*G10_CIPHER_H*/