sha512_256.c
Go to the documentation of this file.
1 /**
2  * @file sha512_256.c
3  * @brief SHA-512/256 (Secure Hash Algorithm)
4  *
5  * @section License
6  *
7  * SPDX-License-Identifier: GPL-2.0-or-later
8  *
9  * Copyright (C) 2010-2019 Oryx Embedded SARL. All rights reserved.
10  *
11  * This file is part of CycloneCrypto Open.
12  *
13  * This program is free software; you can redistribute it and/or
14  * modify it under the terms of the GNU General Public License
15  * as published by the Free Software Foundation; either version 2
16  * of the License, or (at your option) any later version.
17  *
18  * This program is distributed in the hope that it will be useful,
19  * but WITHOUT ANY WARRANTY; without even the implied warranty of
20  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
21  * GNU General Public License for more details.
22  *
23  * You should have received a copy of the GNU General Public License
24  * along with this program; if not, write to the Free Software Foundation,
25  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
26  *
27  * @section Description
28  *
29  * SHA-512/256 is a secure hash algorithm for computing a condensed representation
30  * of an electronic message. Refer to FIPS 180-4 for more details
31  *
32  * @author Oryx Embedded SARL (www.oryx-embedded.com)
33  * @version 1.9.6
34  **/
35 
36 //Switch to the appropriate trace level
37 #define TRACE_LEVEL CRYPTO_TRACE_LEVEL
38 
39 //Dependencies
40 #include "core/crypto.h"
41 #include "hash/sha512_256.h"
42 
43 //Check crypto library configuration
44 #if (SHA512_256_SUPPORT == ENABLED)
45 
46 //SHA-512/256 object identifier (2.16.840.1.101.3.4.2.6)
47 const uint8_t sha512_256Oid[9] = {0x60, 0x86, 0x48, 0x01, 0x65, 0x03, 0x04, 0x02, 0x06};
48 
49 //Common interface for hash algorithms
51 {
52  "SHA-512/256",
54  sizeof(sha512_256Oid),
55  sizeof(Sha512_256Context),
59  TRUE,
64  NULL
65 };
66 
67 
68 /**
69  * @brief Digest a message using SHA-512/256
70  * @param[in] data Pointer to the message being hashed
71  * @param[in] length Length of the message
72  * @param[out] digest Pointer to the calculated digest
73  * @return Error code
74  **/
75 
76 error_t sha512_256Compute(const void *data, size_t length, uint8_t *digest)
77 {
78  //Allocate a memory buffer to hold the SHA-512/256 context
80  //Failed to allocate memory?
81  if(context == NULL)
82  return ERROR_OUT_OF_MEMORY;
83 
84  //Initialize the SHA-512/256 context
85  sha512_256Init(context);
86  //Digest the message
87  sha512_256Update(context, data, length);
88  //Finalize the SHA-512/256 message digest
89  sha512_256Final(context, digest);
90 
91  //Free previously allocated memory
92  cryptoFreeMem(context);
93  //Successful processing
94  return NO_ERROR;
95 }
96 
97 
98 /**
99  * @brief Initialize SHA-512/256 message digest context
100  * @param[in] context Pointer to the SHA-512/256 context to initialize
101  **/
102 
104 {
105  //Set initial hash value
106  context->h[0] = 0x22312194FC2BF72C;
107  context->h[1] = 0x9F555FA3C84C64C2;
108  context->h[2] = 0x2393B86B6F53B151;
109  context->h[3] = 0x963877195940EABD;
110  context->h[4] = 0x96283EE2A88EFFE3;
111  context->h[5] = 0xBE5E1E2553863992;
112  context->h[6] = 0x2B0199FC2C85B8AA;
113  context->h[7] = 0x0EB72DDC81C52CA2;
114 
115  //Number of bytes in the buffer
116  context->size = 0;
117  //Total length of the message
118  context->totalSize = 0;
119 }
120 
121 
122 /**
123  * @brief Update the SHA-512/256 context with a portion of the message being hashed
124  * @param[in] context Pointer to the SHA-512/256 context
125  * @param[in] data Pointer to the buffer being hashed
126  * @param[in] length Length of the buffer
127  **/
128 
129 void sha512_256Update(Sha512_256Context *context, const void *data, size_t length)
130 {
131  //The function is defined in the exact same manner as SHA-512
132  sha512Update(context, data, length);
133 }
134 
135 
136 /**
137  * @brief Finish the SHA-512/256 message digest
138  * @param[in] context Pointer to the SHA-512/256 context
139  * @param[out] digest Calculated digest (optional parameter)
140  **/
141 
142 void sha512_256Final(Sha512_256Context *context, uint8_t *digest)
143 {
144  //The function is defined in the exact same manner as SHA-512
145  sha512Final(context, NULL);
146 
147  //Copy the resulting digest
148  if(digest != NULL)
149  cryptoMemcpy(digest, context->digest, SHA512_256_DIGEST_SIZE);
150 }
151 
152 #endif
SHA-512/256 (Secure Hash Algorithm)
uint8_t length
Definition: dtls_misc.h:149
void(* HashAlgoInit)(void *context)
Definition: crypto.h:1094
void sha512Final(Sha512Context *context, uint8_t *digest)
Finish the SHA-512 message digest.
Definition: sha512.c:218
#define TRUE
Definition: os_port.h:50
void sha512_256Update(Sha512_256Context *context, const void *data, size_t length)
Update the SHA-512/256 context with a portion of the message being hashed.
Definition: sha512_256.c:129
#define SHA512_256_MIN_PAD_SIZE
Definition: sha512_256.h:43
const uint8_t sha512_256Oid[9]
Definition: sha512_256.c:47
void(* HashAlgoUpdate)(void *context, const void *data, size_t length)
Definition: crypto.h:1095
size_t size
Definition: sha512.h:70
error_t
Error codes.
Definition: error.h:42
void sha512_256Init(Sha512_256Context *context)
Initialize SHA-512/256 message digest context.
Definition: sha512_256.c:103
SHA-512 algorithm context.
Definition: sha512.h:58
General definitions for cryptographic algorithms.
const HashAlgo sha512_256HashAlgo
Definition: sha512_256.c:50
void(* HashAlgoFinal)(void *context, uint8_t *digest)
Definition: crypto.h:1096
uint64_t h[8]
Definition: sha512.h:62
#define SHA512_256_BLOCK_SIZE
Definition: sha512_256.h:39
#define cryptoMemcpy(dest, src, length)
Definition: crypto.h:642
#define cryptoFreeMem(p)
Definition: crypto.h:630
uint8_t digest[64]
Definition: sha512.h:63
void sha512_256Final(Sha512_256Context *context, uint8_t *digest)
Finish the SHA-512/256 message digest.
Definition: sha512_256.c:142
#define cryptoAllocMem(size)
Definition: crypto.h:625
Common interface for hash algorithms.
Definition: crypto.h:1128
uint64_t totalSize
Definition: sha512.h:71
#define SHA512_256_DIGEST_SIZE
Definition: sha512_256.h:41
uint8_t data[]
Definition: dtls_misc.h:176
error_t(* HashAlgoCompute)(const void *data, size_t length, uint8_t *digest)
Definition: crypto.h:1093
error_t sha512_256Compute(const void *data, size_t length, uint8_t *digest)
Digest a message using SHA-512/256.
Definition: sha512_256.c:76
Success.
Definition: error.h:44
void sha512Update(Sha512Context *context, const void *data, size_t length)
Update the SHA-512 context with a portion of the message being hashed.
Definition: sha512.c:179