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 #ifndef AES_KEYSCHEDULE_H_
  29 #define AES_KEYSCHEDULE_H_
  30
  31 #include "aes_types.h"
  32 /**
  33  * \brief initialize the keyschedule
  34  *
  35  * This function computes the keyschedule from a given key with a given length
  36  * and stores it in the context variable
  37  * \param key       pointer to the key material
  38  * \param keysize_b length of the key in bits (valid are 128, 192 and 256)
  39  * \param ctx       pointer to the context where the keyschedule should be stored
  40  */
  41 void aes_init(const void *key, uint16_t keysize_b, aes_genctx_t *ctx);
  42
  43 /**
  44  * \brief initialize the keyschedule for 128 bit key
  45  *
  46  * This function computes the keyschedule from a given 128 bit key
  47  * and stores it in the context variable
  48  * \param key       pointer to the key material
  49  * \param ctx       pointer to the context where the keyschedule should be stored
  50  */
  51 void aes128_init(const void *key, aes128_ctx_t *ctx);
  52
  53 /**
  54  * \brief initialize the keyschedule for 192 bit key
  55  *
  56  * This function computes the keyschedule from a given 192 bit key
  57  * and stores it in the context variable
  58  * \param key       pointer to the key material
  59  * \param ctx       pointer to the context where the keyschedule should be stored
  60  */
  61 void aes192_init(const void *key, aes192_ctx_t *ctx);
  62
  63 /**
  64  * \brief initialize the keyschedule for 256 bit key
  65  *
  66  * This function computes the keyschedule from a given 256 bit key
  67  * and stores it in the context variable
  68  * \param key       pointer to the key material
  69  * \param ctx       pointer to the context where the keyschedule should be stored
  70  */
  71 void aes256_init(const void *key, aes256_ctx_t *ctx);
  72
  73 #endif /* AES_KEYSCHEDULE_H_ */
  74