sha256.h File Reference

#include <stddef.h>
#include <stdint.h>

Include dependency graph for sha256.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Classes
struct	mbedtls_sha256_context
	SHA-256 context structure. More...

Functions
void	mbedtls_sha256_init (mbedtls_sha256_context *ctx)
	Initialize SHA-256 context.
void	mbedtls_sha256_free (mbedtls_sha256_context *ctx)
	Clear SHA-256 context.
void	mbedtls_sha256_clone (mbedtls_sha256_context *dst, const mbedtls_sha256_context *src)
	Clone (the state of) a SHA-256 context.
void	mbedtls_sha256_starts (mbedtls_sha256_context *ctx, int is224)
	SHA-256 context setup.
void	mbedtls_sha256_update (mbedtls_sha256_context *ctx, const unsigned char *input, size_t ilen)
	SHA-256 process buffer.
void	mbedtls_sha256_finish (mbedtls_sha256_context *ctx, unsigned char output[32])
	SHA-256 final digest.
void	mbedtls_sha256_process (mbedtls_sha256_context *ctx, const unsigned char data[64])
void	mbedtls_sha256 (const unsigned char *input, size_t ilen, unsigned char output[32], int is224)
	Output = SHA-256( input buffer )
int	mbedtls_sha256_self_test (int verbose)
	Checkup routine.

Function Documentation

mbedtls_sha256()

void mbedtls_sha256	(	const unsigned char *	input,
		size_t	ilen,
		unsigned char	output[32],
		int	is224
	)

Output = SHA-256( input buffer )

Parameters

input	buffer holding the data
ilen	length of the input data
output	SHA-224/256 checksum result
is224	0 = use SHA256, 1 = use SHA224

Definition at line 325 of file sha256.cxx.

{
    mbedtls_sha256_context ctx;
 
    mbedtls_sha256_init( &ctx );
    mbedtls_sha256_starts( &ctx, is224 );
    mbedtls_sha256_update( &ctx, input, ilen );
    mbedtls_sha256_finish( &ctx, output );
    mbedtls_sha256_free( &ctx );
}

Here is the call graph for this function:

mbedtls_sha256_clone()

void mbedtls_sha256_clone	(	mbedtls_sha256_context *	dst,
		const mbedtls_sha256_context *	src
	)

Clone (the state of) a SHA-256 context.

Parameters

dst	The destination context
src	The context to be cloned

Definition at line 93 of file sha256.cxx.

{
    *dst = *src;
}

mbedtls_sha256_finish()

void mbedtls_sha256_finish	(	mbedtls_sha256_context *	ctx,
		unsigned char	output[32]
	)

SHA-256 final digest.

Parameters

ctx	SHA-256 context
output	SHA-224/256 checksum result

Definition at line 289 of file sha256.cxx.

{
    uint32_t last, padn;
    uint32_t high, low;
    unsigned char msglen[8];
 
    high = ( ctx->total[0] >> 29 )
         | ( ctx->total[1] <<  3 );
    low  = ( ctx->total[0] <<  3 );
 
    PUT_UINT32_BE( high, msglen, 0 );
    PUT_UINT32_BE( low,  msglen, 4 );
 
    last = ctx->total[0] & 0x3F;
    padn = ( last < 56 ) ? ( 56 - last ) : ( 120 - last );
 
    mbedtls_sha256_update( ctx, sha256_padding, padn );
    mbedtls_sha256_update( ctx, msglen, 8 );
 
    PUT_UINT32_BE( ctx->state[0], output,  0 );
    PUT_UINT32_BE( ctx->state[1], output,  4 );
    PUT_UINT32_BE( ctx->state[2], output,  8 );
    PUT_UINT32_BE( ctx->state[3], output, 12 );
    PUT_UINT32_BE( ctx->state[4], output, 16 );
    PUT_UINT32_BE( ctx->state[5], output, 20 );
    PUT_UINT32_BE( ctx->state[6], output, 24 );
 
    if( ctx->is224 == 0 )
        PUT_UINT32_BE( ctx->state[7], output, 28 );
}

Here is the call graph for this function:

Here is the caller graph for this function:

mbedtls_sha256_free()

void mbedtls_sha256_free

(

mbedtls_sha256_context *

ctx

)

Clear SHA-256 context.

Parameters

ctx	SHA-256 context to be cleared

Definition at line 85 of file sha256.cxx.

{
    if( ctx == NULL )
        return;
 
    mbedtls_zeroize( ctx, sizeof( mbedtls_sha256_context ) );
}

Here is the call graph for this function:

Here is the caller graph for this function:

mbedtls_sha256_init()

void mbedtls_sha256_init

(

mbedtls_sha256_context *

ctx

)

Initialize SHA-256 context.

Parameters

ctx	SHA-256 context to be initialized

Definition at line 80 of file sha256.cxx.

{
    memset( ctx, 0, sizeof( mbedtls_sha256_context ) );
}

Here is the call graph for this function:

Here is the caller graph for this function:

mbedtls_sha256_process()

void mbedtls_sha256_process	(	mbedtls_sha256_context *	ctx,
		const unsigned char	data[64]
	)

Definition at line 181 of file sha256.cxx.

{
    uint32_t temp1, temp2, W[64];
    uint32_t A[8];
    unsigned int i;
 
    for( i = 0; i < 8; i++ )
        A[i] = ctx->state[i];
 
#if defined(MBEDTLS_SHA256_SMALLER)
    for( i = 0; i < 64; i++ )
    {
        if( i < 16 )
            GET_UINT32_BE( W[i], data, 4 * i );
        else
            R( i );
 
        P( A[0], A[1], A[2], A[3], A[4], A[5], A[6], A[7], W[i], K[i] );
 
        temp1 = A[7]; A[7] = A[6]; A[6] = A[5]; A[5] = A[4]; A[4] = A[3];
        A[3] = A[2]; A[2] = A[1]; A[1] = A[0]; A[0] = temp1;
    }
#else /* MBEDTLS_SHA256_SMALLER */
    for( i = 0; i < 16; i++ )
        GET_UINT32_BE( W[i], data, 4 * i );
 
    for( i = 0; i < 16; i += 8 )
    {
        P( A[0], A[1], A[2], A[3], A[4], A[5], A[6], A[7], W[i+0], K[i+0] );
        P( A[7], A[0], A[1], A[2], A[3], A[4], A[5], A[6], W[i+1], K[i+1] );
        P( A[6], A[7], A[0], A[1], A[2], A[3], A[4], A[5], W[i+2], K[i+2] );
        P( A[5], A[6], A[7], A[0], A[1], A[2], A[3], A[4], W[i+3], K[i+3] );
        P( A[4], A[5], A[6], A[7], A[0], A[1], A[2], A[3], W[i+4], K[i+4] );
        P( A[3], A[4], A[5], A[6], A[7], A[0], A[1], A[2], W[i+5], K[i+5] );
        P( A[2], A[3], A[4], A[5], A[6], A[7], A[0], A[1], W[i+6], K[i+6] );
        P( A[1], A[2], A[3], A[4], A[5], A[6], A[7], A[0], W[i+7], K[i+7] );
    }
 
    for( i = 16; i < 64; i += 8 )
    {
        P( A[0], A[1], A[2], A[3], A[4], A[5], A[6], A[7], R(i+0), K[i+0] );
        P( A[7], A[0], A[1], A[2], A[3], A[4], A[5], A[6], R(i+1), K[i+1] );
        P( A[6], A[7], A[0], A[1], A[2], A[3], A[4], A[5], R(i+2), K[i+2] );
        P( A[5], A[6], A[7], A[0], A[1], A[2], A[3], A[4], R(i+3), K[i+3] );
        P( A[4], A[5], A[6], A[7], A[0], A[1], A[2], A[3], R(i+4), K[i+4] );
        P( A[3], A[4], A[5], A[6], A[7], A[0], A[1], A[2], R(i+5), K[i+5] );
        P( A[2], A[3], A[4], A[5], A[6], A[7], A[0], A[1], R(i+6), K[i+6] );
        P( A[1], A[2], A[3], A[4], A[5], A[6], A[7], A[0], R(i+7), K[i+7] );
    }
#endif /* MBEDTLS_SHA256_SMALLER */
 
    for( i = 0; i < 8; i++ )
        ctx->state[i] += A[i];
}

Here is the call graph for this function:

Here is the caller graph for this function:

mbedtls_sha256_self_test()

int mbedtls_sha256_self_test

(

int

verbose

)

Checkup routine.

Returns

0 if successful, or 1 if the test failed

mbedtls_sha256_starts()

void mbedtls_sha256_starts	(	mbedtls_sha256_context *	ctx,
		int	is224
	)

SHA-256 context setup.

Parameters

ctx	context to be initialized
is224	0 = use SHA256, 1 = use SHA224

Definition at line 102 of file sha256.cxx.

{
    ctx->total[0] = 0;
    ctx->total[1] = 0;
 
    if( is224 == 0 )
    {
        /* SHA-256 */
        ctx->state[0] = 0x6A09E667;
        ctx->state[1] = 0xBB67AE85;
        ctx->state[2] = 0x3C6EF372;
        ctx->state[3] = 0xA54FF53A;
        ctx->state[4] = 0x510E527F;
        ctx->state[5] = 0x9B05688C;
        ctx->state[6] = 0x1F83D9AB;
        ctx->state[7] = 0x5BE0CD19;
    }
    else
    {
        /* SHA-224 */
        ctx->state[0] = 0xC1059ED8;
        ctx->state[1] = 0x367CD507;
        ctx->state[2] = 0x3070DD17;
        ctx->state[3] = 0xF70E5939;
        ctx->state[4] = 0xFFC00B31;
        ctx->state[5] = 0x68581511;
        ctx->state[6] = 0x64F98FA7;
        ctx->state[7] = 0xBEFA4FA4;
    }
 
    ctx->is224 = is224;
}

Here is the caller graph for this function:

mbedtls_sha256_update()

void mbedtls_sha256_update	(	mbedtls_sha256_context *	ctx,
		const unsigned char *	input,
		size_t	ilen
	)

SHA-256 process buffer.

Parameters

ctx	SHA-256 context
input	buffer holding the data
ilen	length of the input data

Definition at line 240 of file sha256.cxx.

{
    size_t fill;
    uint32_t left;
 
    if( ilen == 0 )
        return;
 
    left = ctx->total[0] & 0x3F;
    fill = 64 - left;
 
    ctx->total[0] += (uint32_t) ilen;
    ctx->total[0] &= 0xFFFFFFFF;
 
    if( ctx->total[0] < (uint32_t) ilen )
        ctx->total[1]++;
 
    if( left && ilen >= fill )
    {
        memcpy( (void *) (ctx->buffer + left), input, fill );
        mbedtls_sha256_process( ctx, ctx->buffer );
        input += fill;
        ilen  -= fill;
        left = 0;
    }
 
    while( ilen >= 64 )
    {
        mbedtls_sha256_process( ctx, input );
        input += 64;
        ilen  -= 64;
    }
 
    if( ilen > 0 )
        memcpy( (void *) (ctx->buffer + left), input, ilen );
}

Here is the call graph for this function:

Here is the caller graph for this function: