A lot of doxygen updates
[asterisk/asterisk.git] / include / asterisk / aes.h
1 /*
2  * Asterisk -- An open source telephony toolkit.
3  *
4  * Copyright (C) 20075, Digium, Inc.
5  *
6  * Kevin P. Fleming <kpfleming@digium.com>
7  *
8  * See http://www.asterisk.org for more information about
9  * the Asterisk project. Please do not directly contact
10  * any of the maintainers of this project for assistance;
11  * the project provides a web site, mailing lists and IRC
12  * channels for your use.
13  *
14  * This program is free software, distributed under the terms of
15  * the GNU General Public License Version 2. See the LICENSE file
16  * at the top of the source tree.
17  */
18
19 /*! \file
20  * Wrappers for AES encryption/decryption
21  *
22  * \author Kevin P. Fleming <kpfleming@digium.com>
23  *
24  * These wrappers provided a generic interface to either the
25  * AES methods provided by OpenSSL's crypto library, or the
26  * AES implementation included with Asterisk.
27  */
28
29 #ifndef _ASTERISK_AES_H
30 #define _ASTERISK_AES_H
31
32 #ifdef HAVE_CRYPTO
33
34 /* Use the OpenSSL crypto library */
35 #include "openssl/aes.h"
36
37 typedef AES_KEY ast_aes_encrypt_key;
38 typedef AES_KEY ast_aes_decrypt_key;
39
40 #define ast_aes_encrypt_key(key, context) AES_set_encrypt_key(key, 1024, context)
41
42 #define ast_aes_decrypt_key(key, context) AES_set_decrypt_key(key, 1024, context)
43
44 #define ast_aes_encrypt(in, out, context) AES_encrypt(in, out, context)
45
46 #define ast_aes_decrypt(in, out, context) AES_decrypt(in, out, context)
47
48 #else /* !HAVE_CRYPTO */
49
50 /* Use the included AES implementation */
51
52 #include "aes_internal.h"
53
54 typedef aes_encrypt_ctx ast_aes_encrypt_key;
55 typedef aes_decrypt_ctx ast_aes_decrypt_key;
56
57 #define ast_aes_encrypt_key(key, context) aes_encrypt_key128(key, context)
58
59 #define ast_aes_decrypt_key(key, context) aes_decrypt_key128(key, context)
60
61 #define ast_aes_encrypt(in, out, context) aes_encrypt(in, out, context)
62
63 #define ast_aes_decrypt(in, out, context) aes_decrypt(in, out, context)
64
65 #endif /* !HAVE_CRYPTO */
66
67 #endif /* _ASTERISK_AES_H */