/usr/include/beecrypt/aes.h is in libbeecrypt-dev 4.2.1-4.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 | /*
* Copyright (c) 2002, 2003 Bob Deblier
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*
* This library 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
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*
*/
/*!\file aes.h
* \brief AES block cipher, as specified by NIST FIPS 197.
* \author Bob Deblier <bob.deblier@telenet.be>
* \ingroup BC_m BC_aes_m
*/
#ifndef _AES_H
#define _AES_H
#include "beecrypt/beecrypt.h"
#include "beecrypt/aesopt.h"
/*!\brief Holds all the parameters necessary for the AES cipher.
* \ingroup BC_aes_m
*/
#ifdef __cplusplus
struct BEECRYPTAPI aesParam
#else
struct _aesParam
#endif
{
/*!\var k
* \brief Holds the key expansion.
*/
uint32_t k[64];
/*!\var nr
* \brief Number of rounds to be used in encryption/decryption.
*/
uint32_t nr;
/*!\var fdback
* \brief Buffer to be used by block chaining or feedback modes.
*/
uint32_t fdback[4];
};
#ifndef __cplusplus
typedef struct _aesParam aesParam;
#endif
#ifdef __cplusplus
extern "C" {
#endif
/*!\var aes
* \brief Holds the full API description of the AES algorithm.
*/
extern const BEECRYPTAPI blockCipher aes;
/*!\fn int aesSetup(aesParam* ap, const byte* key, size_t keybits, cipherOperation op)
* \brief This function performs the cipher's key expansion.
* \param ap The cipher's parameter block.
* \param key The key value.
* \param keybits The number of bits in the key; legal values are:
* 128, 192 and 256.
* \param op ENCRYPT or DECRYPT.
* \retval 0 on success.
* \retval -1 on failure.
*/
BEECRYPTAPI
int aesSetup (aesParam* ap, const byte* key, size_t keybits, cipherOperation op);
/*!\fn int aesSetIV(aesParam* ap, const byte* iv)
* \brief This function sets the Initialization Vector.
* \note This function is only useful in block chaining or feedback modes.
* \param ap The cipher's parameter block.
* \param iv The initialization vector; may be null.
* \retval 0 on success.
*/
BEECRYPTAPI
int aesSetIV (aesParam* ap, const byte* iv);
/*!\fn int aesSetCTR(aesParam* ap, const byte* nivz, size_t counter)
* \brief This function sets the CTR mode counter.
* \note This function is only useful in CTR modes.
* \param ap The cipher's parameter block.
* \param nivz The concatenation of Nonce, IV, and padding Zeroes.
* \param counter The counter.
* \retval 0 on success.
*/
BEECRYPTAPI
int aesSetCTR (aesParam* ap, const byte* nivz, size_t counter);
/*!\fn aesEncrypt(aesParam* ap, uint32_t* dst, const uint32_t* src)
* \brief This function performs the raw AES encryption; it encrypts one block
* of 128 bits.
* \param ap The cipher's parameter block.
* \param dst The ciphertext; should be aligned on 32-bit boundary.
* \param src The cleartext; should be aligned on 32-bit boundary.
* \retval 0 on success.
*/
BEECRYPTAPI
int aesEncrypt (aesParam* ap, uint32_t* dst, const uint32_t* src);
/*!\fn aesDecrypt(aesParam* ap, uint32_t* dst, const uint32_t* src)
* \brief This function performs the raw AES decryption; it decrypts one block
* of 128 bits.
* \param ap The cipher's parameter block.
* \param dst The cleartext; should be aligned on 32-bit boundary.
* \param src The ciphertext; should be aligned on 32-bit boundary.
* \retval 0 on success.
*/
BEECRYPTAPI
int aesDecrypt (aesParam* ap, uint32_t* dst, const uint32_t* src);
BEECRYPTAPI
uint32_t* aesFeedback(aesParam* ap);
#ifdef __cplusplus
}
#endif
#endif
|