SHA-256 algorithm. More...

#include <stdint.h>
#include <endian.h>
#include <ipxe/crypto.h>
#include <ipxe/mdhash.h>

Data Structures
struct	sha256_digest
	An SHA-256 digest. More...
union	sha256_block
	An SHA-256 data block. More...
struct	sha256_digest_data
	SHA-256 digest and data block. More...

Macros
#define	SHA256_ROUNDS 64
	SHA-256 number of rounds.
#define	SHA256_CTX_SIZE MDHASH_CTX_SIZE ( struct sha256_digest_data )
	SHA-256 context size.
#define	SHA256_BLOCK_SIZE sizeof ( union sha256_block )
	SHA-256 block size.
#define	SHA256_DIGEST_SIZE sizeof ( struct sha256_digest )
	SHA-256 digest size.
#define	SHA224_DIGEST_SIZE ( SHA256_DIGEST_SIZE * 224 / 256 )
	SHA-224 digest size.
#define	SHA256_ALGORITHM(_name, _digest, _init, _digestsize)
	Define a SHA-256 family digest algorithm.

Functions
	FILE_LICENCE (GPL2_OR_LATER_OR_UBDL)
	FILE_SECBOOT (PERMITTED)
void	sha256_compress (struct sha256_digest_data dd, const struct sha256_digest digest)
	Calculate SHA-256 digest of accumulated data.

Variables
struct digest_algorithm	sha256_algorithm
struct digest_algorithm	sha224_algorithm

Detailed Description

SHA-256 algorithm.

Definition in file sha256.h.

Macro Definition Documentation

◆ SHA256_ROUNDS

#define SHA256_ROUNDS 64

SHA-256 number of rounds.

Definition at line 19 of file sha256.h.

Referenced by sha256_compress().

◆ SHA256_CTX_SIZE

#define SHA256_CTX_SIZE MDHASH_CTX_SIZE ( struct sha256_digest_data )

SHA-256 context size.

Definition at line 55 of file sha256.h.

Referenced by icert_cert().

◆ SHA256_BLOCK_SIZE

#define SHA256_BLOCK_SIZE sizeof ( union sha256_block )

SHA-256 block size.

Definition at line 58 of file sha256.h.

◆ SHA256_DIGEST_SIZE

#define SHA256_DIGEST_SIZE sizeof ( struct sha256_digest )

SHA-256 digest size.

Definition at line 61 of file sha256.h.

◆ SHA224_DIGEST_SIZE

#define SHA224_DIGEST_SIZE ( SHA256_DIGEST_SIZE * 224 / 256 )

SHA-224 digest size.

Definition at line 64 of file sha256.h.

Referenced by SHA256_ALGORITHM().

◆ SHA256_ALGORITHM

#define SHA256_ALGORITHM	(	_name,
		_digest,
		_init,
		_digestsize )

Value:

MDHASH_ALGORITHM( _name, _digest, sha256_compress,              \
                  __BIG_ENDIAN, struct sha256_digest_data,      \
                  _init, _digestsize )

Define a SHA-256 family digest algorithm.

Definition at line 70 of file sha256.h.

#define SHA256_ALGORITHM( _name, _digest, _init, _digestsize )          \
        MDHASH_ALGORITHM( _name, _digest, sha256_compress,              \
                          __BIG_ENDIAN, struct sha256_digest_data,      \
                          _init, _digestsize )

Function Documentation

◆ FILE_LICENCE()

FILE_LICENCE ( GPL2_OR_LATER_OR_UBDL )

◆ FILE_SECBOOT()

FILE_SECBOOT ( PERMITTED )

◆ sha256_compress()

void sha256_compress	(	struct sha256_digest_data *	dd,
		const struct sha256_digest *	digest )

extern

Calculate SHA-256 digest of accumulated data.

Parameters

dd	Digest and data block
digest	Copy of current digest value

Definition at line 83 of file sha256.c.

                                                            {
        union {
                struct sha256_digest_data dd;
                struct sha256_variables v;
        } *u = container_of ( dd, typeof ( *u ), dd );
        struct sha256_variables *v = &u->v;
        uint32_t *a = &v->a;
        uint32_t *b = &v->b;
        uint32_t *c = &v->c;
        uint32_t *d = &v->d;
        uint32_t *e = &v->e;
        uint32_t *f = &v->f;
        uint32_t *g = &v->g;
        uint32_t *h = &v->h;
        uint32_t *w = v->w;
        uint32_t s0;
        uint32_t s1;
        uint32_t maj;
        uint32_t t1;
        uint32_t t2;
        uint32_t ch;
        unsigned int i;
 
        /* Sanity checks */
        build_assert ( &u->dd.digest.h[0] == a );
        build_assert ( &u->dd.digest.h[1] == b );
        build_assert ( &u->dd.digest.h[2] == c );
        build_assert ( &u->dd.digest.h[3] == d );
        build_assert ( &u->dd.digest.h[4] == e );
        build_assert ( &u->dd.digest.h[5] == f );
        build_assert ( &u->dd.digest.h[6] == g );
        build_assert ( &u->dd.digest.h[7] == h );
        build_assert ( &u->dd.data.dword[0] == w );
        build_assert ( sizeof ( u->dd ) == sizeof ( u->v ) );
 
        /* Main loop */
        for ( i = 0 ; i < SHA256_ROUNDS ; i++ ) {
                s0 = ( ror32 ( *a, 2 ) ^ ror32 ( *a, 13 ) ^ ror32 ( *a, 22 ) );
                maj = ( ( *a & *b ) ^ ( *a & *c ) ^ ( *b & *c ) );
                t2 = ( s0 + maj );
                s1 = ( ror32 ( *e, 6 ) ^ ror32 ( *e, 11 ) ^ ror32 ( *e, 25 ) );
                ch = ( ( *e & *f ) ^ ( (~*e) & *g ) );
                t1 = ( *h + s1 + ch + k[i] + w[ i % 16 ] );
                *h = *g;
                *g = *f;
                *f = *e;
                *e = ( *d + t1 );
                *d = *c;
                *c = *b;
                *b = *a;
                *a = ( t1 + t2 );
                s0 = ( ror32 ( w[ ( i - 15 ) % 16 ], 7 ) ^
                       ror32 ( w[ ( i - 15 ) % 16 ], 18 ) ^
                       ( w[ ( i - 15 ) % 16 ] >> 3 ) );
                s1 = ( ror32 ( w[ ( i - 2 ) % 16 ], 17 ) ^
                       ror32 ( w[ ( i - 2 ) % 16 ], 19 ) ^
                       ( w[ ( i - 2 ) % 16 ] >> 10 ) );
                w[ i % 16 ] = ( w[ ( i - 16 ) % 16 ] + s0 +
                                w[ ( i - 7 ) % 16 ] + s1 );
                DBGC2 ( &sha256_algorithm,
                        "%2d : %08x %08x %08x %08x %08x %08x %08x %08x\n",
                        i, *a, *b, *c, *d, *e, *f, *g, *h );
        }
 
        /* Add chunk to hash */
        for ( i = 0 ; i < 8 ; i++ )
                dd->digest.h[i] += digest->h[i];
}

References sha256_variables::a, sha256_variables::b, build_assert, sha256_variables::c, ch, container_of, sha256_variables::d, DBGC2, sha256_digest_data::digest, sha256_variables::e, sha256_variables::f, sha256_variables::g, h, sha256_digest::h, sha256_variables::h, k, ror32(), sha256_algorithm, SHA256_ROUNDS, typeof(), u, and sha256_variables::w.

Variable Documentation

◆ sha256_algorithm

struct digest_algorithm sha256_algorithm

extern

◆ sha224_algorithm

struct digest_algorithm sha224_algorithm

extern

Data Structures

Macros

Functions

Variables

Detailed Description

Macro Definition Documentation

◆ SHA256_ROUNDS

◆ SHA256_CTX_SIZE

◆ SHA256_BLOCK_SIZE

◆ SHA256_DIGEST_SIZE

◆ SHA224_DIGEST_SIZE

◆ SHA256_ALGORITHM

Function Documentation

◆ FILE_LICENCE()

◆ FILE_SECBOOT()

◆ sha256_compress()

Variable Documentation

◆ sha256_algorithm

◆ sha224_algorithm