hmac.h

Go to the documentation of this file.

#ifndef _IPXE_HMAC_H
#define _IPXE_HMAC_H
 
/** @file
 *
 * Keyed-Hashing for Message Authentication
 */
 
FILE_LICENCE ( GPL2_OR_LATER_OR_UBDL );
FILE_SECBOOT ( PERMITTED );
 
#include <ipxe/crypto.h>
 
/** HMAC reduced key type */
#define hmac_key_t( digest ) struct {                                   \
                /** HMAC input/output padding */                        \
                uint8_t pad[ digest->blocksize ];                       \
        } __attribute__ (( packed ))
 
/** HMAC context type */
#define hmac_context_t( digest ) struct {                               \
                /** Digest context */                                   \
                uint8_t ctx[ digest->ctxsize ];                         \
                /** HMAC input/output padding */                        \
                uint8_t pad[ digest->blocksize ];                       \
        } __attribute__ (( packed ))
 
/**
 * Calculate HMAC reduced key size
 *
 * @v digest            Digest algorithm to use
 * @ret len             HMAC key pad size
 */
static inline __attribute__ (( always_inline )) size_t
hmac_keysize ( struct digest_algorithm *digest ) {
        hmac_key_t ( digest ) *hkey;
 
        return sizeof ( hkey->pad );
}
 
/**
 * Calculate HMAC context size
 *
 * @v digest            Digest algorithm to use
 * @ret len             HMAC context size
 */
static inline __attribute__ (( always_inline )) size_t
hmac_ctxsize ( struct digest_algorithm *digest ) {
        hmac_context_t ( digest ) *hctx;
 
        return sizeof ( *hctx );
}
 
/**
 * Update HMAC
 *
 * @v digest            Digest algorithm to use
 * @v ctx               HMAC context
 * @v data              Data
 * @v len               Length of data
 */
static inline void hmac_update ( struct digest_algorithm *digest, void *ctx,
                                 const void *data, size_t len ) {
        hmac_context_t ( digest ) *hctx = ctx;
 
        digest_update ( digest, hctx->ctx, data, len );
}
 
extern void hmac_key ( struct digest_algorithm *digest, void *ctx,
                       const void *secret, size_t len, void *key );
extern void hmac_init_key ( struct digest_algorithm *digest, void *ctx,
                            const void *key );
extern void hmac_init ( struct digest_algorithm *digest, void *ctx,
                        const void *secret, size_t len );
extern void hmac_final ( struct digest_algorithm *digest, void *ctx,
                         void *hmac );
 
#endif /* _IPXE_HMAC_H */