David Fletcher / Mbed 2 deprecated cc3100_Test_websock_Camera_CM4F

Important changes to repositories hosted on mbed.com

Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.

To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.

It is also possible to export all your personal repositories from the account settings page.

Dependencies:   mbed

SHA1/polarssl/sha256.h@0:50cedd586816, 2015-06-24 (annotated)

Committer:
dflet
Date:
Wed Jun 24 09:54:16 2015 +0000
Revision:
0:50cedd586816
First commit work in progress

Who changed what in which revision?

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