aes.h File Reference

AES block cipher. More...

#include "config.h"
#include <string.h>
#include <inttypes.h>
Include dependency graph for aes.h:
This graph shows which files directly or indirectly include this file:

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.

Detailed Description

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 Documentation

#define AES_DECRYPT   0
#define AES_ENCRYPT   1
#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().


Function Documentation

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.

Parameters:
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
Returns:
0 if successful

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.

Parameters:
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
Returns:
0 if successful

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.

Parameters:
ctx AES context
mode AES_ENCRYPT or AES_DECRYPT
input 16-byte input block
output 16-byte output block
Returns:
0 if successful

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  ) 
int aes_setkey_dec ( aes_context ctx,
const unsigned char *  key,
unsigned int  keysize 
)

AES key schedule (decryption).

Parameters:
ctx AES context to be initialized
key decryption key
keysize must be 128, 192 or 256
Returns:
0 if successful, or POLARSSL_ERR_AES_INVALID_KEY_LENGTH

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).

Parameters:
ctx AES context to be initialized
key encryption key
keysize must be 128, 192 or 256
Returns:
0 if successful, or POLARSSL_ERR_AES_INVALID_KEY_LENGTH

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().


Generated on 9 Apr 2014 for PolarSSL v1.3.2 by  doxygen 1.6.1