Hannes Tschofenig / Mbed 2 deprecated aes-gcm-test-program

Example program to test AES-GCM functionality. Used for a workshop

Dependencies:   mbed

SSL/include/polarssl/sha256.h@0:796d0f61a05b, 2018-09-27 (annotated)

Committer:
HannesTschofenig
Date:
Thu Sep 27 06:34:22 2018 +0000
Revision:
0:796d0f61a05b
Example AES-GCM test program

Who changed what in which revision?

UserRevisionLine numberNew contents of line
HannesTschofenig 0:796d0f61a05b 1 /**
HannesTschofenig 0:796d0f61a05b 2 * \file sha256.h
HannesTschofenig 0:796d0f61a05b 3 *
HannesTschofenig 0:796d0f61a05b 4 * \brief SHA-224 and SHA-256 cryptographic hash function
HannesTschofenig 0:796d0f61a05b 5 *
HannesTschofenig 0:796d0f61a05b 6 * Copyright (C) 2006-2014, Brainspark B.V.
HannesTschofenig 0:796d0f61a05b 7 *
HannesTschofenig 0:796d0f61a05b 8 * This file is part of PolarSSL (http://www.polarssl.org)
HannesTschofenig 0:796d0f61a05b 9 * Lead Maintainer: Paul Bakker <polarssl_maintainer at polarssl.org>
HannesTschofenig 0:796d0f61a05b 10 *
HannesTschofenig 0:796d0f61a05b 11 * All rights reserved.
HannesTschofenig 0:796d0f61a05b 12 *
HannesTschofenig 0:796d0f61a05b 13 * This program is free software; you can redistribute it and/or modify
HannesTschofenig 0:796d0f61a05b 14 * it under the terms of the GNU General Public License as published by
HannesTschofenig 0:796d0f61a05b 15 * the Free Software Foundation; either version 2 of the License, or
HannesTschofenig 0:796d0f61a05b 16 * (at your option) any later version.
HannesTschofenig 0:796d0f61a05b 17 *
HannesTschofenig 0:796d0f61a05b 18 * This program is distributed in the hope that it will be useful,
HannesTschofenig 0:796d0f61a05b 19 * but WITHOUT ANY WARRANTY; without even the implied warranty of
HannesTschofenig 0:796d0f61a05b 20 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
HannesTschofenig 0:796d0f61a05b 21 * GNU General Public License for more details.
HannesTschofenig 0:796d0f61a05b 22 *
HannesTschofenig 0:796d0f61a05b 23 * You should have received a copy of the GNU General Public License along
HannesTschofenig 0:796d0f61a05b 24 * with this program; if not, write to the Free Software Foundation, Inc.,
HannesTschofenig 0:796d0f61a05b 25 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
HannesTschofenig 0:796d0f61a05b 26 */
HannesTschofenig 0:796d0f61a05b 27 #ifndef POLARSSL_SHA256_H
HannesTschofenig 0:796d0f61a05b 28 #define POLARSSL_SHA256_H
HannesTschofenig 0:796d0f61a05b 29
HannesTschofenig 0:796d0f61a05b 30 #if !defined(POLARSSL_CONFIG_FILE)
HannesTschofenig 0:796d0f61a05b 31 #include "config.h"
HannesTschofenig 0:796d0f61a05b 32 #else
HannesTschofenig 0:796d0f61a05b 33 #include POLARSSL_CONFIG_FILE
HannesTschofenig 0:796d0f61a05b 34 #endif
HannesTschofenig 0:796d0f61a05b 35
HannesTschofenig 0:796d0f61a05b 36 #include <string.h>
HannesTschofenig 0:796d0f61a05b 37
HannesTschofenig 0:796d0f61a05b 38 #if defined(_MSC_VER) && !defined(EFIX64) && !defined(EFI32)
HannesTschofenig 0:796d0f61a05b 39 #include <basetsd.h>
HannesTschofenig 0:796d0f61a05b 40 typedef UINT32 uint32_t;
HannesTschofenig 0:796d0f61a05b 41 #else
HannesTschofenig 0:796d0f61a05b 42 #include <inttypes.h>
HannesTschofenig 0:796d0f61a05b 43 #endif
HannesTschofenig 0:796d0f61a05b 44
HannesTschofenig 0:796d0f61a05b 45 #define POLARSSL_ERR_SHA256_FILE_IO_ERROR -0x0078 /**< Read/write error in file. */
HannesTschofenig 0:796d0f61a05b 46
HannesTschofenig 0:796d0f61a05b 47 #if !defined(POLARSSL_SHA256_ALT)
HannesTschofenig 0:796d0f61a05b 48 // Regular implementation
HannesTschofenig 0:796d0f61a05b 49 //
HannesTschofenig 0:796d0f61a05b 50
HannesTschofenig 0:796d0f61a05b 51 #ifdef __cplusplus
HannesTschofenig 0:796d0f61a05b 52 extern "C" {
HannesTschofenig 0:796d0f61a05b 53 #endif
HannesTschofenig 0:796d0f61a05b 54
HannesTschofenig 0:796d0f61a05b 55 /**
HannesTschofenig 0:796d0f61a05b 56 * \brief SHA-256 context structure
HannesTschofenig 0:796d0f61a05b 57 */
HannesTschofenig 0:796d0f61a05b 58 typedef struct
HannesTschofenig 0:796d0f61a05b 59 {
HannesTschofenig 0:796d0f61a05b 60 uint32_t total[2]; /*!< number of bytes processed */
HannesTschofenig 0:796d0f61a05b 61 uint32_t state[8]; /*!< intermediate digest state */
HannesTschofenig 0:796d0f61a05b 62 unsigned char buffer[64]; /*!< data block being processed */
HannesTschofenig 0:796d0f61a05b 63
HannesTschofenig 0:796d0f61a05b 64 unsigned char ipad[64]; /*!< HMAC: inner padding */
HannesTschofenig 0:796d0f61a05b 65 unsigned char opad[64]; /*!< HMAC: outer padding */
HannesTschofenig 0:796d0f61a05b 66 int is224; /*!< 0 => SHA-256, else SHA-224 */
HannesTschofenig 0:796d0f61a05b 67 }
HannesTschofenig 0:796d0f61a05b 68 sha256_context;
HannesTschofenig 0:796d0f61a05b 69
HannesTschofenig 0:796d0f61a05b 70 /**
HannesTschofenig 0:796d0f61a05b 71 * \brief SHA-256 context setup
HannesTschofenig 0:796d0f61a05b 72 *
HannesTschofenig 0:796d0f61a05b 73 * \param ctx context to be initialized
HannesTschofenig 0:796d0f61a05b 74 * \param is224 0 = use SHA256, 1 = use SHA224
HannesTschofenig 0:796d0f61a05b 75 */
HannesTschofenig 0:796d0f61a05b 76 void sha256_starts( sha256_context *ctx, int is224 );
HannesTschofenig 0:796d0f61a05b 77
HannesTschofenig 0:796d0f61a05b 78 /**
HannesTschofenig 0:796d0f61a05b 79 * \brief SHA-256 process buffer
HannesTschofenig 0:796d0f61a05b 80 *
HannesTschofenig 0:796d0f61a05b 81 * \param ctx SHA-256 context
HannesTschofenig 0:796d0f61a05b 82 * \param input buffer holding the data
HannesTschofenig 0:796d0f61a05b 83 * \param ilen length of the input data
HannesTschofenig 0:796d0f61a05b 84 */
HannesTschofenig 0:796d0f61a05b 85 void sha256_update( sha256_context *ctx, const unsigned char *input,
HannesTschofenig 0:796d0f61a05b 86 size_t ilen );
HannesTschofenig 0:796d0f61a05b 87
HannesTschofenig 0:796d0f61a05b 88 /**
HannesTschofenig 0:796d0f61a05b 89 * \brief SHA-256 final digest
HannesTschofenig 0:796d0f61a05b 90 *
HannesTschofenig 0:796d0f61a05b 91 * \param ctx SHA-256 context
HannesTschofenig 0:796d0f61a05b 92 * \param output SHA-224/256 checksum result
HannesTschofenig 0:796d0f61a05b 93 */
HannesTschofenig 0:796d0f61a05b 94 void sha256_finish( sha256_context *ctx, unsigned char output[32] );
HannesTschofenig 0:796d0f61a05b 95
HannesTschofenig 0:796d0f61a05b 96 /* Internal use */
HannesTschofenig 0:796d0f61a05b 97 void sha256_process( sha256_context *ctx, const unsigned char data[64] );
HannesTschofenig 0:796d0f61a05b 98
HannesTschofenig 0:796d0f61a05b 99 #ifdef __cplusplus
HannesTschofenig 0:796d0f61a05b 100 }
HannesTschofenig 0:796d0f61a05b 101 #endif
HannesTschofenig 0:796d0f61a05b 102
HannesTschofenig 0:796d0f61a05b 103 #else /* POLARSSL_SHA256_ALT */
HannesTschofenig 0:796d0f61a05b 104 #include "sha256_alt.h"
HannesTschofenig 0:796d0f61a05b 105 #endif /* POLARSSL_SHA256_ALT */
HannesTschofenig 0:796d0f61a05b 106
HannesTschofenig 0:796d0f61a05b 107 #ifdef __cplusplus
HannesTschofenig 0:796d0f61a05b 108 extern "C" {
HannesTschofenig 0:796d0f61a05b 109 #endif
HannesTschofenig 0:796d0f61a05b 110
HannesTschofenig 0:796d0f61a05b 111 /**
HannesTschofenig 0:796d0f61a05b 112 * \brief Output = SHA-256( input buffer )
HannesTschofenig 0:796d0f61a05b 113 *
HannesTschofenig 0:796d0f61a05b 114 * \param input buffer holding the data
HannesTschofenig 0:796d0f61a05b 115 * \param ilen length of the input data
HannesTschofenig 0:796d0f61a05b 116 * \param output SHA-224/256 checksum result
HannesTschofenig 0:796d0f61a05b 117 * \param is224 0 = use SHA256, 1 = use SHA224
HannesTschofenig 0:796d0f61a05b 118 */
HannesTschofenig 0:796d0f61a05b 119 void sha256( const unsigned char *input, size_t ilen,
HannesTschofenig 0:796d0f61a05b 120 unsigned char output[32], int is224 );
HannesTschofenig 0:796d0f61a05b 121
HannesTschofenig 0:796d0f61a05b 122 /**
HannesTschofenig 0:796d0f61a05b 123 * \brief Output = SHA-256( file contents )
HannesTschofenig 0:796d0f61a05b 124 *
HannesTschofenig 0:796d0f61a05b 125 * \param path input file name
HannesTschofenig 0:796d0f61a05b 126 * \param output SHA-224/256 checksum result
HannesTschofenig 0:796d0f61a05b 127 * \param is224 0 = use SHA256, 1 = use SHA224
HannesTschofenig 0:796d0f61a05b 128 *
HannesTschofenig 0:796d0f61a05b 129 * \return 0 if successful, or POLARSSL_ERR_SHA256_FILE_IO_ERROR
HannesTschofenig 0:796d0f61a05b 130 */
HannesTschofenig 0:796d0f61a05b 131 int sha256_file( const char *path, unsigned char output[32], int is224 );
HannesTschofenig 0:796d0f61a05b 132
HannesTschofenig 0:796d0f61a05b 133 /**
HannesTschofenig 0:796d0f61a05b 134 * \brief SHA-256 HMAC context setup
HannesTschofenig 0:796d0f61a05b 135 *
HannesTschofenig 0:796d0f61a05b 136 * \param ctx HMAC context to be initialized
HannesTschofenig 0:796d0f61a05b 137 * \param key HMAC secret key
HannesTschofenig 0:796d0f61a05b 138 * \param keylen length of the HMAC key
HannesTschofenig 0:796d0f61a05b 139 * \param is224 0 = use SHA256, 1 = use SHA224
HannesTschofenig 0:796d0f61a05b 140 */
HannesTschofenig 0:796d0f61a05b 141 void sha256_hmac_starts( sha256_context *ctx, const unsigned char *key,
HannesTschofenig 0:796d0f61a05b 142 size_t keylen, int is224 );
HannesTschofenig 0:796d0f61a05b 143
HannesTschofenig 0:796d0f61a05b 144 /**
HannesTschofenig 0:796d0f61a05b 145 * \brief SHA-256 HMAC process buffer
HannesTschofenig 0:796d0f61a05b 146 *
HannesTschofenig 0:796d0f61a05b 147 * \param ctx HMAC context
HannesTschofenig 0:796d0f61a05b 148 * \param input buffer holding the data
HannesTschofenig 0:796d0f61a05b 149 * \param ilen length of the input data
HannesTschofenig 0:796d0f61a05b 150 */
HannesTschofenig 0:796d0f61a05b 151 void sha256_hmac_update( sha256_context *ctx, const unsigned char *input,
HannesTschofenig 0:796d0f61a05b 152 size_t ilen );
HannesTschofenig 0:796d0f61a05b 153
HannesTschofenig 0:796d0f61a05b 154 /**
HannesTschofenig 0:796d0f61a05b 155 * \brief SHA-256 HMAC final digest
HannesTschofenig 0:796d0f61a05b 156 *
HannesTschofenig 0:796d0f61a05b 157 * \param ctx HMAC context
HannesTschofenig 0:796d0f61a05b 158 * \param output SHA-224/256 HMAC checksum result
HannesTschofenig 0:796d0f61a05b 159 */
HannesTschofenig 0:796d0f61a05b 160 void sha256_hmac_finish( sha256_context *ctx, unsigned char output[32] );
HannesTschofenig 0:796d0f61a05b 161
HannesTschofenig 0:796d0f61a05b 162 /**
HannesTschofenig 0:796d0f61a05b 163 * \brief SHA-256 HMAC context reset
HannesTschofenig 0:796d0f61a05b 164 *
HannesTschofenig 0:796d0f61a05b 165 * \param ctx HMAC context to be reset
HannesTschofenig 0:796d0f61a05b 166 */
HannesTschofenig 0:796d0f61a05b 167 void sha256_hmac_reset( sha256_context *ctx );
HannesTschofenig 0:796d0f61a05b 168
HannesTschofenig 0:796d0f61a05b 169 /**
HannesTschofenig 0:796d0f61a05b 170 * \brief Output = HMAC-SHA-256( hmac key, input buffer )
HannesTschofenig 0:796d0f61a05b 171 *
HannesTschofenig 0:796d0f61a05b 172 * \param key HMAC secret key
HannesTschofenig 0:796d0f61a05b 173 * \param keylen length of the HMAC key
HannesTschofenig 0:796d0f61a05b 174 * \param input buffer holding the data
HannesTschofenig 0:796d0f61a05b 175 * \param ilen length of the input data
HannesTschofenig 0:796d0f61a05b 176 * \param output HMAC-SHA-224/256 result
HannesTschofenig 0:796d0f61a05b 177 * \param is224 0 = use SHA256, 1 = use SHA224
HannesTschofenig 0:796d0f61a05b 178 */
HannesTschofenig 0:796d0f61a05b 179 void sha256_hmac( const unsigned char *key, size_t keylen,
HannesTschofenig 0:796d0f61a05b 180 const unsigned char *input, size_t ilen,
HannesTschofenig 0:796d0f61a05b 181 unsigned char output[32], int is224 );
HannesTschofenig 0:796d0f61a05b 182
HannesTschofenig 0:796d0f61a05b 183 /**
HannesTschofenig 0:796d0f61a05b 184 * \brief Checkup routine
HannesTschofenig 0:796d0f61a05b 185 *
HannesTschofenig 0:796d0f61a05b 186 * \return 0 if successful, or 1 if the test failed
HannesTschofenig 0:796d0f61a05b 187 */
HannesTschofenig 0:796d0f61a05b 188 int sha256_self_test( int verbose );
HannesTschofenig 0:796d0f61a05b 189
HannesTschofenig 0:796d0f61a05b 190 #ifdef __cplusplus
HannesTschofenig 0:796d0f61a05b 191 }
HannesTschofenig 0:796d0f61a05b 192 #endif
HannesTschofenig 0:796d0f61a05b 193
HannesTschofenig 0:796d0f61a05b 194 #endif /* sha256.h */
HannesTschofenig 0:796d0f61a05b 195
HannesTschofenig 0:796d0f61a05b 196