sha512.h File Reference

SHA-512 algorithm. More...

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

Go to the source code of this file.

Data Structures
struct	sha512_digest
	An SHA-512 digest. More...
union	sha512_block
	An SHA-512 data block. More...
struct	sha512_digest_data
	SHA-512 digest and data block. More...
union	sha512_digest_data_qwords
	SHA-512 digest and data block. More...
struct	sha512_context
	An SHA-512 context. More...

Macros
#define	SHA512_ROUNDS   80
	SHA-512 number of rounds. More...
#define	SHA512_CTX_SIZE   sizeof ( struct sha512_context )
	SHA-512 context size. More...
#define	SHA512_BLOCK_SIZE   sizeof ( union sha512_block )
	SHA-512 block size. More...
#define	SHA512_DIGEST_SIZE   sizeof ( struct sha512_digest )
	SHA-512 digest size. More...
#define	SHA384_DIGEST_SIZE   ( SHA512_DIGEST_SIZE * 384 / 512 )
	SHA-384 digest size. More...
#define	SHA512_256_DIGEST_SIZE   ( SHA512_DIGEST_SIZE * 256 / 512 )
	SHA-512/256 digest size. More...
#define	SHA512_224_DIGEST_SIZE   ( SHA512_DIGEST_SIZE * 224 / 512 )
	SHA-512/224 digest size. More...

Functions
	FILE_LICENCE (GPL2_OR_LATER_OR_UBDL)
void	sha512_family_init (struct sha512_context *context, const struct sha512_digest *init, size_t digestsize)
	Initialise SHA-512 family algorithm. More...
void	sha512_update (void *ctx, const void *data, size_t len)
	Accumulate data with SHA-512 algorithm. More...
void	sha512_final (void *ctx, void *out)
	Generate SHA-512 digest. More...

Variables
struct digest_algorithm	sha512_algorithm
	SHA-512 algorithm. More...
struct digest_algorithm	sha384_algorithm
	SHA-384 algorithm. More...
struct digest_algorithm	sha512_256_algorithm
	SHA-512/256 algorithm. More...
struct digest_algorithm	sha512_224_algorithm
	SHA-512/224 algorithm. More...

Detailed Description

SHA-512 algorithm.

Definition in file sha512.h.

Macro Definition Documentation

SHA512_ROUNDS

#define SHA512_ROUNDS   80

SHA-512 number of rounds.

Definition at line 16 of file sha512.h.

SHA512_CTX_SIZE

#define SHA512_CTX_SIZE   sizeof ( struct sha512_context )

SHA-512 context size.

Definition at line 73 of file sha512.h.

SHA512_BLOCK_SIZE

#define SHA512_BLOCK_SIZE   sizeof ( union sha512_block )

SHA-512 block size.

Definition at line 76 of file sha512.h.

SHA512_DIGEST_SIZE

#define SHA512_DIGEST_SIZE   sizeof ( struct sha512_digest )

SHA-512 digest size.

Definition at line 79 of file sha512.h.

SHA384_DIGEST_SIZE

#define SHA384_DIGEST_SIZE   ( SHA512_DIGEST_SIZE * 384 / 512 )

SHA-384 digest size.

Definition at line 82 of file sha512.h.

SHA512_256_DIGEST_SIZE

#define SHA512_256_DIGEST_SIZE   ( SHA512_DIGEST_SIZE * 256 / 512 )

SHA-512/256 digest size.

Definition at line 85 of file sha512.h.

SHA512_224_DIGEST_SIZE

#define SHA512_224_DIGEST_SIZE   ( SHA512_DIGEST_SIZE * 224 / 512 )

SHA-512/224 digest size.

Definition at line 88 of file sha512.h.

Function Documentation

FILE_LICENCE()

FILE_LICENCE

(

GPL2_OR_LATER_OR_UBDL

)

sha512_family_init()

void sha512_family_init	(	struct sha512_context *	context,
		const struct sha512_digest *	init,
		size_t	digestsize
	)

Initialise SHA-512 family algorithm.

Parameters

context	SHA-512 context
init	Initial digest values
digestsize	Digest size

Definition at line 108 of file sha512.c.

                                              {

        context->len = 0;
        context->digestsize = digestsize;
        memcpy ( &context->ddq.dd.digest, init,
                 sizeof ( context->ddq.dd.digest ) );
}

References sha512_digest_data_qwords::dd, sha512_context::ddq, sha512_digest_data::digest, digestsize, sha512_context::digestsize, sha512_context::len, and memcpy().

Referenced by sha384_init(), sha512_224_init(), sha512_256_init(), and sha512_init().

sha512_update()

void sha512_update	(	void *	ctx,
		const void *	data,
		size_t	len
	)

Accumulate data with SHA-512 algorithm.

Parameters

ctx	SHA-512 context
data	Data
len	Length of data

Definition at line 233 of file sha512.c.

                                                               {
        struct sha512_context *context = ctx;
        const uint8_t *byte = data;
        size_t offset;

        /* Accumulate data a byte at a time, performing the digest
         * whenever we fill the data buffer
         */
        while ( len-- ) {
                offset = ( context->len % sizeof ( context->ddq.dd.data ) );
                context->ddq.dd.data.byte[offset] = *(byte++);
                context->len++;
                if ( ( context->len % sizeof ( context->ddq.dd.data ) ) == 0 )
                        sha512_digest ( context );
        }
}

References sha512_block::byte, ctx, data, sha512_digest_data::data, sha512_digest_data_qwords::dd, sha512_context::ddq, sha512_context::len, len, offset, and sha512_digest().

Referenced by sha512_final().

sha512_final()

void sha512_final	(	void *	ctx,
		void *	out
	)

Generate SHA-512 digest.

Parameters

ctx	SHA-512 context
out	Output buffer

Definition at line 256 of file sha512.c.

                                           {
        struct sha512_context *context = ctx;
        uint64_t len_bits_hi;
        uint64_t len_bits_lo;
        uint8_t pad;

        /* Record length before pre-processing */
        len_bits_hi = 0;
        len_bits_lo = cpu_to_be64 ( ( ( uint64_t ) context->len ) * 8 );

        /* Pad with a single "1" bit followed by as many "0" bits as required */
        pad = 0x80;
        do {
                sha512_update ( ctx, &pad, sizeof ( pad ) );
                pad = 0x00;
        } while ( ( context->len % sizeof ( context->ddq.dd.data ) ) !=
                  offsetof ( typeof ( context->ddq.dd.data ), final.len_hi ) );

        /* Append length (in bits) */
        sha512_update ( ctx, &len_bits_hi, sizeof ( len_bits_hi ) );
        sha512_update ( ctx, &len_bits_lo, sizeof ( len_bits_lo ) );
        assert ( ( context->len % sizeof ( context->ddq.dd.data ) ) == 0 );

        /* Copy out final digest */
        memcpy ( out, &context->ddq.dd.digest, context->digestsize );
}

References assert(), cpu_to_be64, ctx, sha512_digest_data::data, sha512_digest_data_qwords::dd, sha512_context::ddq, sha512_digest_data::digest, sha512_context::digestsize, sha512_context::len, memcpy(), offsetof, out, pad, sha512_update(), and typeof().

Variable Documentation

sha512_algorithm

struct digest_algorithm sha512_algorithm

SHA-512 algorithm.

Definition at line 284 of file sha512.c.

Referenced by peerdist_info_v1(), peerdist_info_v2(), sha512_test_exec(), and sha512sum_exec().

sha384_algorithm

struct digest_algorithm sha384_algorithm

SHA-384 algorithm.

Definition at line 63 of file sha384.c.

Referenced by peerdist_info_v1(), sha384sum_exec(), and sha512_test_exec().

sha512_256_algorithm

struct digest_algorithm sha512_256_algorithm

SHA-512/256 algorithm.

Definition at line 64 of file sha512_256.c.

Referenced by sha512_test_exec().

sha512_224_algorithm

struct digest_algorithm sha512_224_algorithm

SHA-512/224 algorithm.

Definition at line 64 of file sha512_224.c.

Referenced by sha512_test_exec().