AES block cipher. More...
#include "config.h"
#include <string.h>
#include <inttypes.h>
Go to the source code of this file.
Data Structures | |
struct | aes_context |
AES context structure. More... | |
Defines | |
#define | AES_ENCRYPT 1 |
#define | AES_DECRYPT 0 |
#define | POLARSSL_ERR_AES_INVALID_KEY_LENGTH -0x0020 |
Invalid key length. | |
#define | POLARSSL_ERR_AES_INVALID_INPUT_LENGTH -0x0022 |
Invalid data input length. | |
Functions | |
int | aes_setkey_enc (aes_context *ctx, const unsigned char *key, unsigned int keysize) |
AES key schedule (encryption). | |
int | aes_setkey_dec (aes_context *ctx, const unsigned char *key, unsigned int keysize) |
AES key schedule (decryption). | |
int | aes_crypt_ecb (aes_context *ctx, int mode, const unsigned char input[16], unsigned char output[16]) |
AES-ECB block encryption/decryption. | |
int | aes_crypt_cfb128 (aes_context *ctx, int mode, size_t length, size_t *iv_off, unsigned char iv[16], const unsigned char *input, unsigned char *output) |
AES-CFB128 buffer encryption/decryption. | |
int | aes_crypt_ctr (aes_context *ctx, size_t length, size_t *nc_off, unsigned char nonce_counter[16], unsigned char stream_block[16], const unsigned char *input, unsigned char *output) |
AES-CTR buffer encryption/decryption. | |
int | aes_self_test (int verbose) |
Checkup routine. |
AES block cipher.
Copyright (C) 2006-2013, Brainspark B.V.
This file is part of PolarSSL (http://www.polarssl.org) Lead Maintainer: Paul Bakker <polarssl_maintainer at polarssl.org>
All rights reserved.
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
Definition in file aes.h.
#define AES_DECRYPT 0 |
Definition at line 42 of file aes.h.
Referenced by aes_crypt_cbc(), aes_crypt_cfb128(), aes_crypt_ecb(), aes_self_test(), pem_aes_decrypt(), ssl_parse_ticket(), test_suite_aes_decrypt_cbc(), test_suite_aes_decrypt_cfb128(), and test_suite_aes_decrypt_ecb().
#define AES_ENCRYPT 1 |
Definition at line 41 of file aes.h.
Referenced by aes_crypt_cfb128(), aes_crypt_ctr(), block_cipher_df(), ctr_drbg_random_with_add(), ctr_drbg_update_internal(), ssl_write_ticket(), test_suite_aes_encrypt_cbc(), test_suite_aes_encrypt_cfb128(), and test_suite_aes_encrypt_ecb().
#define POLARSSL_ERR_AES_INVALID_INPUT_LENGTH -0x0022 |
Invalid data input length.
Definition at line 45 of file aes.h.
Referenced by aes_crypt_cbc(), polarssl_strerror(), and verify_int().
#define POLARSSL_ERR_AES_INVALID_KEY_LENGTH -0x0020 |
Invalid key length.
Definition at line 44 of file aes.h.
Referenced by aes_setkey_dec(), aes_setkey_enc(), polarssl_strerror(), and verify_int().
int aes_crypt_cfb128 | ( | aes_context * | ctx, | |
int | mode, | |||
size_t | length, | |||
size_t * | iv_off, | |||
unsigned char | iv[16], | |||
const unsigned char * | input, | |||
unsigned char * | output | |||
) |
AES-CFB128 buffer encryption/decryption.
Note: Due to the nature of CFB you should use the same key schedule for both encryption and decryption. So a context initialized with aes_setkey_enc() for both AES_ENCRYPT and AES_DECRYPT.
ctx | AES context | |
mode | AES_ENCRYPT or AES_DECRYPT | |
length | length of the input data | |
iv_off | offset in IV (updated after use) | |
iv | initialization vector (updated after use) | |
input | buffer holding the input data | |
output | buffer holding the output data |
Definition at line 842 of file aes.c.
References aes_crypt_ecb(), AES_DECRYPT, and AES_ENCRYPT.
Referenced by aes_crypt_cfb128_wrap(), aes_self_test(), test_suite_aes_decrypt_cfb128(), and test_suite_aes_encrypt_cfb128().
int aes_crypt_ctr | ( | aes_context * | ctx, | |
size_t | length, | |||
size_t * | nc_off, | |||
unsigned char | nonce_counter[16], | |||
unsigned char | stream_block[16], | |||
const unsigned char * | input, | |||
unsigned char * | output | |||
) |
AES-CTR buffer encryption/decryption.
Warning: You have to keep the maximum use of your counter in mind!
Note: Due to the nature of CTR you should use the same key schedule for both encryption and decryption. So a context initialized with aes_setkey_enc() for both AES_ENCRYPT and AES_DECRYPT.
ctx | AES context | |
length | The length of the data | |
nc_off | The offset in the current stream_block (for resuming within current cipher stream). The offset pointer to should be 0 at the start of a stream. | |
nonce_counter | The 128-bit nonce and counter. | |
stream_block | The saved stream-block for resuming. Is overwritten by the function. | |
input | The input data stream | |
output | The output data stream |
Definition at line 890 of file aes.c.
References aes_crypt_ecb(), and AES_ENCRYPT.
Referenced by aes_crypt_ctr_wrap(), and aes_self_test().
int aes_crypt_ecb | ( | aes_context * | ctx, | |
int | mode, | |||
const unsigned char | input[16], | |||
unsigned char | output[16] | |||
) |
AES-ECB block encryption/decryption.
ctx | AES context | |
mode | AES_ENCRYPT or AES_DECRYPT | |
input | 16-byte input block | |
output | 16-byte output block |
Definition at line 668 of file aes.c.
References AES_DECRYPT, AES_FROUND, AES_RROUND, FSb, GET_UINT32_LE, aes_context::nr, PUT_UINT32_LE, aes_context::rk, and RSb.
Referenced by aes_crypt_cbc(), aes_crypt_cfb128(), aes_crypt_ctr(), aes_crypt_ecb_wrap(), aes_self_test(), block_cipher_df(), ctr_drbg_random_with_add(), ctr_drbg_update_internal(), test_suite_aes_decrypt_ecb(), and test_suite_aes_encrypt_ecb().
int aes_self_test | ( | int | verbose | ) |
Checkup routine.
Definition at line 1106 of file aes.c.
References aes_crypt_cbc(), aes_crypt_cfb128(), aes_crypt_ctr(), aes_crypt_ecb(), AES_DECRYPT, aes_setkey_dec(), aes_setkey_enc(), aes_test_cbc_dec, aes_test_cbc_enc, aes_test_cfb128_ct, aes_test_cfb128_iv, aes_test_cfb128_key, aes_test_cfb128_pt, aes_test_ctr_ct, aes_test_ctr_key, aes_test_ctr_len, aes_test_ctr_nonce_counter, aes_test_ctr_pt, aes_test_ecb_dec, aes_test_ecb_enc, iv, and key.
Referenced by test_suite_aes_selftest().
int aes_setkey_dec | ( | aes_context * | ctx, | |
const unsigned char * | key, | |||
unsigned int | keysize | |||
) |
AES key schedule (decryption).
ctx | AES context to be initialized | |
key | decryption key | |
keysize | must be 128, 192 or 256 |
Definition at line 561 of file aes.c.
References aes_setkey_enc(), aes_context::buf, FSb, aes_context::nr, POLARSSL_ERR_AES_INVALID_KEY_LENGTH, aes_context::rk, RT0, RT1, RT2, and RT3.
Referenced by aes_self_test(), aes_setkey_dec_wrap(), pem_aes_decrypt(), ssl_ticket_keys_init(), test_suite_aes_decrypt_cbc(), and test_suite_aes_decrypt_ecb().
int aes_setkey_enc | ( | aes_context * | ctx, | |
const unsigned char * | key, | |||
unsigned int | keysize | |||
) |
AES key schedule (encryption).
ctx | AES context to be initialized | |
key | encryption key | |
keysize | must be 128, 192 or 256 |
Definition at line 451 of file aes.c.
References aes_gen_tables(), aes_init_done, aes_context::buf, FSb, GET_UINT32_LE, aes_context::nr, POLARSSL_ERR_AES_INVALID_KEY_LENGTH, RCON, and aes_context::rk.
Referenced by aes_self_test(), aes_setkey_dec(), aes_setkey_enc_wrap(), block_cipher_df(), ctr_drbg_init_entropy_len(), ctr_drbg_update_internal(), ssl_ticket_keys_init(), test_suite_aes_decrypt_cfb128(), test_suite_aes_encrypt_cbc(), test_suite_aes_encrypt_cfb128(), and test_suite_aes_encrypt_ecb().