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.
#define	SHA512_CTX_SIZE   sizeof ( struct sha512_context )
	SHA-512 context size.
#define	SHA512_BLOCK_SIZE   sizeof ( union sha512_block )
	SHA-512 block size.
#define	SHA512_DIGEST_SIZE   sizeof ( struct sha512_digest )
	SHA-512 digest size.
#define	SHA384_DIGEST_SIZE   ( SHA512_DIGEST_SIZE * 384 / 512 )
	SHA-384 digest size.
#define	SHA512_256_DIGEST_SIZE   ( SHA512_DIGEST_SIZE * 256 / 512 )
	SHA-512/256 digest size.
#define	SHA512_224_DIGEST_SIZE   ( SHA512_DIGEST_SIZE * 224 / 512 )
	SHA-512/224 digest size.

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

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

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 17 of file sha512.h.

Referenced by sha512_digest().

SHA512_CTX_SIZE

#define SHA512_CTX_SIZE   sizeof ( struct sha512_context )

SHA-512 context size.

Definition at line 74 of file sha512.h.

SHA512_BLOCK_SIZE

#define SHA512_BLOCK_SIZE   sizeof ( union sha512_block )

SHA-512 block size.

Definition at line 77 of file sha512.h.

SHA512_DIGEST_SIZE

#define SHA512_DIGEST_SIZE   sizeof ( struct sha512_digest )

SHA-512 digest size.

Definition at line 80 of file sha512.h.

SHA384_DIGEST_SIZE

#define SHA384_DIGEST_SIZE   ( SHA512_DIGEST_SIZE * 384 / 512 )

SHA-384 digest size.

Definition at line 83 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 86 of file sha512.h.

Referenced by sha512_256_init().

SHA512_224_DIGEST_SIZE

#define SHA512_224_DIGEST_SIZE   ( SHA512_DIGEST_SIZE * 224 / 512 )

SHA-512/224 digest size.

Definition at line 89 of file sha512.h.

Referenced by sha512_224_init().

Function Documentation

FILE_LICENCE()

FILE_LICENCE

(

GPL2_OR_LATER_OR_UBDL

)

FILE_SECBOOT()

FILE_SECBOOT

(

PERMITTED

)

sha512_family_init()

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

extern

Initialise SHA-512 family algorithm.

Parameters

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

Definition at line 109 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 )

extern

Accumulate data with SHA-512 algorithm.

Parameters

ctx	SHA-512 context
data	Data
len	Length of data

Definition at line 234 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, len, sha512_context::len, offset, and sha512_digest().

Referenced by sha512_final().

sha512_final()

void sha512_final ( void * ctx, void * out )

extern

Generate SHA-512 digest.

Parameters

ctx	SHA-512 context
out	Output buffer

Definition at line 257 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

extern

SHA-512 algorithm.

Definition at line 285 of file sha512.c.

                                           {
        .name           = "sha512",
        .ctxsize        = sizeof ( struct sha512_context ),
        .blocksize      = sizeof ( union sha512_block ),
        .digestsize   = sizeof ( struct sha512_digest ),
        .init           = sha512_init,
        .update         = sha512_update,
        .final          = sha512_final,
};

Referenced by DIGEST_TEST(), DIGEST_TEST(), DIGEST_TEST(), PEERDIST_INFO_TEST(), peerdist_info_v1(), peerdist_info_v2(), PUBKEY_SIGN_TEST(), PUBKEY_SIGN_TEST(), sha512_test_exec(), and sha512sum_exec().

sha384_algorithm

struct digest_algorithm sha384_algorithm

extern

SHA-384 algorithm.

Definition at line 64 of file sha384.c.

                                           {
        .name           = "sha384",
        .ctxsize        = sizeof ( struct sha512_context ),
        .blocksize      = sizeof ( union sha512_block ),
        .digestsize   = SHA384_DIGEST_SIZE,
        .init           = sha384_init,
        .update         = sha512_update,
        .final          = sha512_final,
};

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

sha512_256_algorithm

struct digest_algorithm sha512_256_algorithm

extern

SHA-512/256 algorithm.

Definition at line 65 of file sha512_256.c.

                                               {
        .name           = "sha512/256",
        .ctxsize        = sizeof ( struct sha512_context ),
        .blocksize      = sizeof ( union sha512_block ),
        .digestsize   = SHA512_256_DIGEST_SIZE,
        .init           = sha512_256_init,
        .update         = sha512_update,
        .final          = sha512_final,
};

Referenced by DIGEST_TEST(), DIGEST_TEST(), DIGEST_TEST(), and sha512_test_exec().

sha512_224_algorithm

struct digest_algorithm sha512_224_algorithm

extern

SHA-512/224 algorithm.

Definition at line 65 of file sha512_224.c.

                                               {
        .name           = "sha512/224",
        .ctxsize        = sizeof ( struct sha512_context ),
        .blocksize      = sizeof ( union sha512_block ),
        .digestsize   = SHA512_224_DIGEST_SIZE,
        .init           = sha512_224_init,
        .update         = sha512_update,
        .final          = sha512_final,
};

Referenced by DIGEST_TEST(), DIGEST_TEST(), DIGEST_TEST(), and sha512_test_exec().