hmac.h File Reference

Keyed-Hashing for Message Authentication. More...

#include <ipxe/crypto.h>

Go to the source code of this file.

Macros
#define	hmac_context_t(digest)
	HMAC context type. More...

Functions
	FILE_LICENCE (GPL2_OR_LATER_OR_UBDL)
static	__attribute__ ((always_inline)) size_t hmac_ctxsize(struct digest_algorithm *digest)
	Calculate HMAC context size. More...
static void	hmac_update (struct digest_algorithm *digest, void *ctx, const void *data, size_t len)
	Update HMAC. More...
void	hmac_init (struct digest_algorithm *digest, void *ctx, const void *key, size_t key_len)
	Initialise HMAC. More...
void	hmac_final (struct digest_algorithm *digest, void *ctx, void *hmac)
	Finalise HMAC. More...

Detailed Description

Keyed-Hashing for Message Authentication.

Definition in file hmac.h.

Macro Definition Documentation

hmac_context_t

#define hmac_context_t

(

digest

)

Value:

struct {                                \
                /** Digest context */                                   \
                uint8_t ctx[ digest->ctxsize ];                         \
                /** HMAC input/output padding */                        \
                uint8_t pad[ digest->blocksize ];                       \
        } __attribute__ (( packed ))

HMAC context type.

Definition at line 14 of file hmac.h.

Function Documentation

FILE_LICENCE()

FILE_LICENCE

(

GPL2_OR_LATER_OR_UBDL

)

__attribute__()

static __attribute__ ( (always_inline)  )

inlinestatic

Calculate HMAC context size.

Parameters

digest

Digest algorithm to use

Return values

len	HMAC context size

Definition at line 27 of file hmac.h.

                                                 {
        hmac_context_t ( digest ) *hctx;

        return sizeof ( *hctx );
}

References digest, and hmac_context_t.

hmac_update()

static void hmac_update ( struct digest_algorithm *  digest, void *  ctx, const void *  data, size_t  len  )

inlinestatic

Update HMAC.

Parameters

digest	Digest algorithm to use
ctx	HMAC context
data	Data
len	Length of data

Definition at line 42 of file hmac.h.

                                                                {
        hmac_context_t ( digest ) *hctx = ctx;

        digest_update ( digest, hctx->ctx, data, len );
}

References ctx, data, digest, hmac_context_t, and len.

Referenced by ccmp_kie_mic(), hmac_drbg_update_key(), hmac_drbg_update_value(), hmac_okx(), ntlm_key(), ntlm_response(), pbkdf2_sha1_f(), peerdist_info_passphrase_okx(), peerdist_info_segment_hash(), prf_sha1(), tkip_kie_mic(), tls_hmac_init(), tls_hmac_update(), tls_hmac_update_va(), and tls_p_hash_va().

hmac_init()

void hmac_init	(	struct digest_algorithm *	digest,
		void *	ctx,
		const void *	key,
		size_t	key_len
	)

Initialise HMAC.

Parameters

digest	Digest algorithm to use
ctx	HMAC context
key	Key
key_len	Length of key

Definition at line 57 of file hmac.c.

                                  {
        hmac_context_t ( digest ) *hctx = ctx;
        unsigned int i;

        /* Construct input pad */
        memset ( hctx->pad, 0, sizeof ( hctx->pad ) );
        if ( key_len <= sizeof ( hctx->pad ) ) {
                memcpy ( hctx->pad, key, key_len );
        } else {
                digest_init ( digest, hctx->ctx );
                digest_update ( digest, hctx->ctx, key, key_len );
                digest_final ( digest, hctx->ctx, hctx->pad );
        }
        for ( i = 0 ; i < sizeof ( hctx->pad ) ; i++ ) {
                hctx->pad[i] ^= 0x36;
        }

        /* Start inner hash */
        digest_init ( digest, hctx->ctx );
        digest_update ( digest, hctx->ctx, hctx->pad, sizeof ( hctx->pad ) );
}

References ctx, digest, hmac_context_t, key, key_len, memcpy(), and memset().

Referenced by ccmp_kie_mic(), hmac_drbg_update_key(), hmac_drbg_update_value(), hmac_okx(), ntlm_key(), ntlm_response(), pbkdf2_sha1_f(), peerdist_info_passphrase_okx(), peerdist_info_segment_hash(), prf_sha1(), tkip_kie_mic(), tls_hmac_init(), and tls_p_hash_va().

hmac_final()

void hmac_final	(	struct digest_algorithm *	digest,
		void *	ctx,
		void *	hmac
	)

Finalise HMAC.

Parameters

digest	Digest algorithm to use
ctx	HMAC context
hmac	HMAC digest to fill in

Definition at line 87 of file hmac.c.

                                                                           {
        hmac_context_t ( digest ) *hctx = ctx;
        unsigned int i;

        /* Construct output pad from input pad */
        for ( i = 0 ; i < sizeof ( hctx->pad ) ; i++ ) {
                hctx->pad[i] ^= 0x6a;
        }

        /* Finish inner hash */
        digest_final ( digest, hctx->ctx, hmac );

        /* Perform outer hash */
        digest_init ( digest, hctx->ctx );
        digest_update ( digest, hctx->ctx, hctx->pad, sizeof ( hctx->pad ) );
        digest_update ( digest, hctx->ctx, hmac, digest->digestsize );
        digest_final ( digest, hctx->ctx, hmac );

        /* Erase output pad (from which the key may be derivable) */
        memset ( hctx->pad, 0, sizeof ( hctx->pad ) );
}

References ctx, digest, digest_algorithm::digestsize, hmac_context_t, and memset().

Referenced by ccmp_kie_mic(), hmac_drbg_update_key(), hmac_drbg_update_value(), hmac_okx(), ntlm_key(), ntlm_response(), pbkdf2_sha1_f(), peerdist_info_passphrase_okx(), peerdist_info_segment_hash(), prf_sha1(), tkip_kie_mic(), tls_hmac_final(), and tls_p_hash_va().