Deprecate the AES_ige_*() functions
[openssl.git] / include / openssl / aes.h
1 /*
2  * Copyright 2002-2016 The OpenSSL Project Authors. All Rights Reserved.
3  *
4  * Licensed under the Apache License 2.0 (the "License").  You may not use
5  * this file except in compliance with the License.  You can obtain a copy
6  * in the file LICENSE in the source distribution or at
7  * https://www.openssl.org/source/license.html
8  */
9
10 #ifndef OPENSSL_AES_H
11 # define OPENSSL_AES_H
12 # pragma once
13
14 # include <openssl/macros.h>
15 # ifndef OPENSSL_NO_DEPRECATED_3_0
16 #  define HEADER_AES_H
17 # endif
18
19 # include <openssl/opensslconf.h>
20
21 # include <stddef.h>
22 # ifdef  __cplusplus
23 extern "C" {
24 # endif
25
26 # define AES_ENCRYPT     1
27 # define AES_DECRYPT     0
28
29 /*
30  * Because array size can't be a const in C, the following two are macros.
31  * Both sizes are in bytes.
32  */
33 # define AES_MAXNR 14
34 # define AES_BLOCK_SIZE 16
35
36 /* This should be a hidden type, but EVP requires that the size be known */
37 struct aes_key_st {
38 # ifdef AES_LONG
39     unsigned long rd_key[4 * (AES_MAXNR + 1)];
40 # else
41     unsigned int rd_key[4 * (AES_MAXNR + 1)];
42 # endif
43     int rounds;
44 };
45 typedef struct aes_key_st AES_KEY;
46
47 const char *AES_options(void);
48
49 int AES_set_encrypt_key(const unsigned char *userKey, const int bits,
50                         AES_KEY *key);
51 int AES_set_decrypt_key(const unsigned char *userKey, const int bits,
52                         AES_KEY *key);
53
54 void AES_encrypt(const unsigned char *in, unsigned char *out,
55                  const AES_KEY *key);
56 void AES_decrypt(const unsigned char *in, unsigned char *out,
57                  const AES_KEY *key);
58
59 void AES_ecb_encrypt(const unsigned char *in, unsigned char *out,
60                      const AES_KEY *key, const int enc);
61 void AES_cbc_encrypt(const unsigned char *in, unsigned char *out,
62                      size_t length, const AES_KEY *key,
63                      unsigned char *ivec, const int enc);
64 void AES_cfb128_encrypt(const unsigned char *in, unsigned char *out,
65                         size_t length, const AES_KEY *key,
66                         unsigned char *ivec, int *num, const int enc);
67 void AES_cfb1_encrypt(const unsigned char *in, unsigned char *out,
68                       size_t length, const AES_KEY *key,
69                       unsigned char *ivec, int *num, const int enc);
70 void AES_cfb8_encrypt(const unsigned char *in, unsigned char *out,
71                       size_t length, const AES_KEY *key,
72                       unsigned char *ivec, int *num, const int enc);
73 void AES_ofb128_encrypt(const unsigned char *in, unsigned char *out,
74                         size_t length, const AES_KEY *key,
75                         unsigned char *ivec, int *num);
76
77 /* NB: the IV is _two_ blocks long */
78 DEPRECATEDIN_3_0(void
79                  AES_ige_encrypt(const unsigned char *in, unsigned char *out,
80                                  size_t length, const AES_KEY *key,
81                                  unsigned char *ivec, const int enc))
82 /* NB: the IV is _four_ blocks long */
83 DEPRECATEDIN_3_0(void
84                  AES_bi_ige_encrypt(const unsigned char *in, unsigned char *out,
85                                     size_t length, const AES_KEY *key,
86                                     const AES_KEY *key2,
87                                     const unsigned char *ivec, const int enc))
88
89 int AES_wrap_key(AES_KEY *key, const unsigned char *iv,
90                  unsigned char *out,
91                  const unsigned char *in, unsigned int inlen);
92 int AES_unwrap_key(AES_KEY *key, const unsigned char *iv,
93                    unsigned char *out,
94                    const unsigned char *in, unsigned int inlen);
95
96
97 # ifdef  __cplusplus
98 }
99 # endif
100
101 #endif