mbed TLS v2.3.0
|
AES block cipher. More...
Go to the source code of this file.
Data Structures | |
struct | mbedtls_aes_context |
AES context structure. More... | |
Macros | |
#define | MBEDTLS_AES_ENCRYPT 1 |
#define | MBEDTLS_AES_DECRYPT 0 |
#define | MBEDTLS_ERR_AES_INVALID_KEY_LENGTH -0x0020 |
Invalid key length. More... | |
#define | MBEDTLS_ERR_AES_INVALID_INPUT_LENGTH -0x0022 |
Invalid data input length. More... | |
Functions | |
void | mbedtls_aes_init (mbedtls_aes_context *ctx) |
Initialize AES context. More... | |
void | mbedtls_aes_free (mbedtls_aes_context *ctx) |
Clear AES context. More... | |
int | mbedtls_aes_setkey_enc (mbedtls_aes_context *ctx, const unsigned char *key, unsigned int keybits) |
AES key schedule (encryption) More... | |
int | mbedtls_aes_setkey_dec (mbedtls_aes_context *ctx, const unsigned char *key, unsigned int keybits) |
AES key schedule (decryption) More... | |
int | mbedtls_aes_crypt_ecb (mbedtls_aes_context *ctx, int mode, const unsigned char input[16], unsigned char output[16]) |
AES-ECB block encryption/decryption. More... | |
int | mbedtls_aes_crypt_cbc (mbedtls_aes_context *ctx, int mode, size_t length, unsigned char iv[16], const unsigned char *input, unsigned char *output) |
AES-CBC buffer encryption/decryption Length should be a multiple of the block size (16 bytes) More... | |
int | mbedtls_aes_crypt_cfb128 (mbedtls_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. More... | |
int | mbedtls_aes_crypt_cfb8 (mbedtls_aes_context *ctx, int mode, size_t length, unsigned char iv[16], const unsigned char *input, unsigned char *output) |
AES-CFB8 buffer encryption/decryption. More... | |
int | mbedtls_aes_crypt_ctr (mbedtls_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. More... | |
void | mbedtls_aes_encrypt (mbedtls_aes_context *ctx, const unsigned char input[16], unsigned char output[16]) |
Internal AES block encryption function (Only exposed to allow overriding it, see MBEDTLS_AES_ENCRYPT_ALT) More... | |
void | mbedtls_aes_decrypt (mbedtls_aes_context *ctx, const unsigned char input[16], unsigned char output[16]) |
Internal AES block decryption function (Only exposed to allow overriding it, see MBEDTLS_AES_DECRYPT_ALT) More... | |
int | mbedtls_aes_self_test (int verbose) |
Checkup routine. More... | |
AES block cipher.
Copyright (C) 2006-2015, ARM Limited, All Rights Reserved SPDX-License-Identifier: GPL-2.0
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.
This file is part of mbed TLS (https://tls.mbed.org)
Definition in file aes.h.
#define MBEDTLS_ERR_AES_INVALID_INPUT_LENGTH -0x0022 |
#define MBEDTLS_ERR_AES_INVALID_KEY_LENGTH -0x0020 |
int mbedtls_aes_crypt_cbc | ( | mbedtls_aes_context * | ctx, |
int | mode, | ||
size_t | length, | ||
unsigned char | iv[16], | ||
const unsigned char * | input, | ||
unsigned char * | output | ||
) |
AES-CBC buffer encryption/decryption Length should be a multiple of the block size (16 bytes)
ctx | AES context |
mode | MBEDTLS_AES_ENCRYPT or MBEDTLS_AES_DECRYPT |
length | length of the input data |
iv | initialization vector (updated after use) |
input | buffer holding the input data |
output | buffer holding the output data |
int mbedtls_aes_crypt_cfb128 | ( | mbedtls_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 mbedtls_aes_setkey_enc() for both MBEDTLS_AES_ENCRYPT and MBEDTLS_AES_DECRYPT.
ctx | AES context |
mode | MBEDTLS_AES_ENCRYPT or MBEDTLS_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 |
int mbedtls_aes_crypt_cfb8 | ( | mbedtls_aes_context * | ctx, |
int | mode, | ||
size_t | length, | ||
unsigned char | iv[16], | ||
const unsigned char * | input, | ||
unsigned char * | output | ||
) |
AES-CFB8 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 mbedtls_aes_setkey_enc() for both MBEDTLS_AES_ENCRYPT and MBEDTLS_AES_DECRYPT.
ctx | AES context |
mode | MBEDTLS_AES_ENCRYPT or MBEDTLS_AES_DECRYPT |
length | length of the input data |
iv | initialization vector (updated after use) |
input | buffer holding the input data |
output | buffer holding the output data |
int mbedtls_aes_crypt_ctr | ( | mbedtls_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 mbedtls_aes_setkey_enc() for both MBEDTLS_AES_ENCRYPT and MBEDTLS_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 |
int mbedtls_aes_crypt_ecb | ( | mbedtls_aes_context * | ctx, |
int | mode, | ||
const unsigned char | input[16], | ||
unsigned char | output[16] | ||
) |
AES-ECB block encryption/decryption.
ctx | AES context |
mode | MBEDTLS_AES_ENCRYPT or MBEDTLS_AES_DECRYPT |
input | 16-byte input block |
output | 16-byte output block |
void mbedtls_aes_decrypt | ( | mbedtls_aes_context * | ctx, |
const unsigned char | input[16], | ||
unsigned char | output[16] | ||
) |
Internal AES block decryption function (Only exposed to allow overriding it, see MBEDTLS_AES_DECRYPT_ALT)
ctx | AES context |
input | Ciphertext block |
output | Output (plaintext) block |
void mbedtls_aes_encrypt | ( | mbedtls_aes_context * | ctx, |
const unsigned char | input[16], | ||
unsigned char | output[16] | ||
) |
Internal AES block encryption function (Only exposed to allow overriding it, see MBEDTLS_AES_ENCRYPT_ALT)
ctx | AES context |
input | Plaintext block |
output | Output (ciphertext) block |
void mbedtls_aes_free | ( | mbedtls_aes_context * | ctx | ) |
Clear AES context.
ctx | AES context to be cleared |
void mbedtls_aes_init | ( | mbedtls_aes_context * | ctx | ) |
Initialize AES context.
ctx | AES context to be initialized |
int mbedtls_aes_self_test | ( | int | verbose | ) |
Checkup routine.
int mbedtls_aes_setkey_dec | ( | mbedtls_aes_context * | ctx, |
const unsigned char * | key, | ||
unsigned int | keybits | ||
) |
AES key schedule (decryption)
ctx | AES context to be initialized |
key | decryption key |
keybits | must be 128, 192 or 256 |
int mbedtls_aes_setkey_enc | ( | mbedtls_aes_context * | ctx, |
const unsigned char * | key, | ||
unsigned int | keybits | ||
) |
AES key schedule (encryption)
ctx | AES context to be initialized |
key | encryption key |
keybits | must be 128, 192 or 256 |