aes/aes_keyschedule.h

   1 /* aes_keyschedule.h */
   2 /*
   3     This file is part of the AVR-Crypto-Lib.
   4     Copyright (C) 2008  Daniel Otte (daniel.otte@rub.de)
   5
   6     This program is free software: you can redistribute it and/or modify
   7     it under the terms of the GNU General Public License as published by
   8     the Free Software Foundation, either version 3 of the License, or
   9     (at your option) any later version.
  10
  11     This program is distributed in the hope that it will be useful,
  12     but WITHOUT ANY WARRANTY; without even the implied warranty of
  13     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14     GNU General Public License for more details.
  15
  16     You should have received a copy of the GNU General Public License
  17     along with this program.  If not, see <http://www.gnu.org/licenses/>.
  18 */
  19 /**
  20  * \file     aes_keyschedule.h
  21  * \email    daniel.otte@rub.de
  22  * \author   Daniel Otte
  23  * \date     2008-12-30
  24  * \license  GPLv3 or later
  25  * \ingroup  AES
  26  */
  27
  28
  29 #ifndef AES_KEYSCHEDULE_H_
  30 #define AES_KEYSCHEDULE_H_
  31
  32 #include "aes_types.h"
  33 /**
  34  * \brief initialize the keyschedule
  35  *
  36  * This function computes the keyschedule from a given key with a given length
  37  * and stores it in the context variable
  38  * \param key       pointer to the key material
  39  * \param keysize_b length of the key in bits (valid are 128, 192 and 256)
  40  * \param ctx       pointer to the context where the keyschedule should be stored
  41  */
  42 void aes_init(const void* key, uint16_t keysize_b, aes_genctx_t* ctx);
  43
  44 /**
  45  * \brief initialize the keyschedule for 128 bit key
  46  *
  47  * This function computes the keyschedule from a given 128 bit key
  48  * and stores it in the context variable
  49  * \param key       pointer to the key material
  50  * \param ctx       pointer to the context where the keyschedule should be stored
  51  */
  52 void aes128_init(const void* key, aes128_ctx_t* ctx);
  53
  54 /**
  55  * \brief initialize the keyschedule for 192 bit key
  56  *
  57  * This function computes the keyschedule from a given 192 bit key
  58  * and stores it in the context variable
  59  * \param key       pointer to the key material
  60  * \param ctx       pointer to the context where the keyschedule should be stored
  61  */
  62 void aes192_init(const void* key, aes192_ctx_t* ctx);
  63
  64 /**
  65  * \brief initialize the keyschedule for 256 bit key
  66  *
  67  * This function computes the keyschedule from a given 256 bit key
  68  * and stores it in the context variable
  69  * \param key       pointer to the key material
  70  * \param ctx       pointer to the context where the keyschedule should be stored
  71  */
  72 void aes256_init(const void* key, aes256_ctx_t* ctx);
  73
  74 #endif /* AES_KEYSCHEDULE_H_ */
  75