Hash.h File Reference

EFI_HASH_SERVICE_BINDING_PROTOCOL as defined in UEFI 2.0. More...

Go to the source code of this file.

Data Structures
union	EFI_HASH_OUTPUT
struct	_EFI_HASH_PROTOCOL
	This protocol allows creating a hash of an arbitrary message digest using one or more hash algorithms. More...

Macros
#define	EFI_HASH_SERVICE_BINDING_PROTOCOL_GUID
#define	EFI_HASH_PROTOCOL_GUID
#define	EFI_HASH_ALGORITHM_SHA1_GUID
#define	EFI_HASH_ALGORITHM_SHA224_GUID
#define	EFI_HASH_ALGORITHM_SHA256_GUID
#define	EFI_HASH_ALGORITHM_SHA384_GUID
#define	EFI_HASH_ALGORITHM_SHA512_GUID
#define	EFI_HASH_ALGORTIHM_MD5_GUID
#define	EFI_HASH_ALGORITHM_SHA1_NOPAD_GUID
#define	EFI_HASH_ALGORITHM_SHA256_NOPAD_GUID

Typedefs
typedef struct _EFI_HASH_PROTOCOL	EFI_HASH_PROTOCOL
typedef UINT8	EFI_MD5_HASH[16]
typedef UINT8	EFI_SHA1_HASH[20]
typedef UINT8	EFI_SHA224_HASH[28]
typedef UINT8	EFI_SHA256_HASH[32]
typedef UINT8	EFI_SHA384_HASH[48]
typedef UINT8	EFI_SHA512_HASH[64]
typedef EFI_STATUS(EFIAPI *	EFI_HASH_GET_HASH_SIZE) (IN CONST EFI_HASH_PROTOCOL *This, IN CONST EFI_GUID *HashAlgorithm, OUT UINTN *HashSize)
	Returns the size of the hash which results from a specific algorithm. More...
typedef EFI_STATUS(EFIAPI *	EFI_HASH_HASH) (IN CONST EFI_HASH_PROTOCOL *This, IN CONST EFI_GUID *HashAlgorithm, IN BOOLEAN Extend, IN CONST UINT8 *Message, IN UINT64 MessageSize, IN OUT EFI_HASH_OUTPUT *Hash)
	Creates a hash for the specified message text. More...

Functions
	FILE_LICENCE (BSD2_PATENT)

Variables
EFI_GUID	gEfiHashServiceBindingProtocolGuid
EFI_GUID	gEfiHashProtocolGuid
EFI_GUID	gEfiHashAlgorithmSha1Guid
EFI_GUID	gEfiHashAlgorithmSha224Guid
EFI_GUID	gEfiHashAlgorithmSha256Guid
EFI_GUID	gEfiHashAlgorithmSha384Guid
EFI_GUID	gEfiHashAlgorithmSha512Guid
EFI_GUID	gEfiHashAlgorithmMD5Guid
EFI_GUID	gEfiHashAlgorithmSha1NoPadGuid
EFI_GUID	gEfiHashAlgorithmSha256NoPadGuid

Detailed Description

EFI_HASH_SERVICE_BINDING_PROTOCOL as defined in UEFI 2.0.

EFI_HASH_PROTOCOL as defined in UEFI 2.0. The EFI Hash Service Binding Protocol is used to locate hashing services support provided by a driver and to create and destroy instances of the EFI Hash Protocol so that a multiple drivers can use the underlying hashing services.

Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.
SPDX-License-Identifier: BSD-2-Clause-Patent

Definition in file Hash.h.

Macro Definition Documentation

EFI_HASH_SERVICE_BINDING_PROTOCOL_GUID

#define EFI_HASH_SERVICE_BINDING_PROTOCOL_GUID

Value:

{ \
    0x42881c98, 0xa4f3, 0x44b0, {0xa3, 0x9d, 0xdf, 0xa1, 0x86, 0x67, 0xd8, 0xcd } \
  }

Definition at line 18 of file Hash.h.

EFI_HASH_PROTOCOL_GUID

#define EFI_HASH_PROTOCOL_GUID

Value:

{ \
    0xc5184932, 0xdba5, 0x46db, {0xa5, 0xba, 0xcc, 0x0b, 0xda, 0x9c, 0x14, 0x35 } \
  }

Definition at line 23 of file Hash.h.

EFI_HASH_ALGORITHM_SHA1_GUID

#define EFI_HASH_ALGORITHM_SHA1_GUID

Value:

{ \
    0x2ae9d80f, 0x3fb2, 0x4095, {0xb7, 0xb1, 0xe9, 0x31, 0x57, 0xb9, 0x46, 0xb6 } \
  }

Definition at line 28 of file Hash.h.

EFI_HASH_ALGORITHM_SHA224_GUID

#define EFI_HASH_ALGORITHM_SHA224_GUID

Value:

{ \
    0x8df01a06, 0x9bd5, 0x4bf7, {0xb0, 0x21, 0xdb, 0x4f, 0xd9, 0xcc, 0xf4, 0x5b } \
  }

Definition at line 33 of file Hash.h.

EFI_HASH_ALGORITHM_SHA256_GUID

#define EFI_HASH_ALGORITHM_SHA256_GUID

Value:

{ \
    0x51aa59de, 0xfdf2, 0x4ea3, {0xbc, 0x63, 0x87, 0x5f, 0xb7, 0x84, 0x2e, 0xe9 } \
  }

Definition at line 38 of file Hash.h.

EFI_HASH_ALGORITHM_SHA384_GUID

#define EFI_HASH_ALGORITHM_SHA384_GUID

Value:

{ \
    0xefa96432, 0xde33, 0x4dd2, {0xae, 0xe6, 0x32, 0x8c, 0x33, 0xdf, 0x77, 0x7a } \
  }

Definition at line 43 of file Hash.h.

EFI_HASH_ALGORITHM_SHA512_GUID

#define EFI_HASH_ALGORITHM_SHA512_GUID

Value:

{ \
    0xcaa4381e, 0x750c, 0x4770, {0xb8, 0x70, 0x7a, 0x23, 0xb4, 0xe4, 0x21, 0x30 } \
  }

Definition at line 48 of file Hash.h.

EFI_HASH_ALGORTIHM_MD5_GUID

#define EFI_HASH_ALGORTIHM_MD5_GUID

Value:

{ \
    0xaf7c79c, 0x65b5, 0x4319, {0xb0, 0xae, 0x44, 0xec, 0x48, 0x4e, 0x4a, 0xd7 } \
  }

Definition at line 53 of file Hash.h.

EFI_HASH_ALGORITHM_SHA1_NOPAD_GUID

#define EFI_HASH_ALGORITHM_SHA1_NOPAD_GUID

Value:

{ \
    0x24c5dc2f, 0x53e2, 0x40ca, {0x9e, 0xd6, 0xa5, 0xd9, 0xa4, 0x9f, 0x46, 0x3b } \
  }

Definition at line 58 of file Hash.h.

EFI_HASH_ALGORITHM_SHA256_NOPAD_GUID

#define EFI_HASH_ALGORITHM_SHA256_NOPAD_GUID

Value:

{ \
    0x8628752a, 0x6cb7, 0x4814, {0x96, 0xfc, 0x24, 0xa8, 0x15, 0xac, 0x22, 0x26 } \
  }

Definition at line 63 of file Hash.h.

Typedef Documentation

EFI_HASH_PROTOCOL

typedef struct _EFI_HASH_PROTOCOL EFI_HASH_PROTOCOL

Definition at line 78 of file Hash.h.

EFI_MD5_HASH

typedef UINT8 EFI_MD5_HASH[16]

Definition at line 80 of file Hash.h.

EFI_SHA1_HASH

typedef UINT8 EFI_SHA1_HASH[20]

Definition at line 81 of file Hash.h.

EFI_SHA224_HASH

typedef UINT8 EFI_SHA224_HASH[28]

Definition at line 82 of file Hash.h.

EFI_SHA256_HASH

typedef UINT8 EFI_SHA256_HASH[32]

Definition at line 83 of file Hash.h.

EFI_SHA384_HASH

typedef UINT8 EFI_SHA384_HASH[48]

Definition at line 84 of file Hash.h.

EFI_SHA512_HASH

typedef UINT8 EFI_SHA512_HASH[64]

Definition at line 85 of file Hash.h.

EFI_HASH_GET_HASH_SIZE

typedef EFI_STATUS(EFIAPI * EFI_HASH_GET_HASH_SIZE) (IN CONST EFI_HASH_PROTOCOL *This, IN CONST EFI_GUID *HashAlgorithm, OUT UINTN *HashSize)

Returns the size of the hash which results from a specific algorithm.

Parameters

[in]	This	Points to this instance of EFI_HASH_PROTOCOL.
[in]	HashAlgorithm	Points to the EFI_GUID which identifies the algorithm to use.
[out]	HashSize	Holds the returned size of the algorithm's hash.

Return values

EFI_SUCCESS	Hash size returned successfully.
EFI_INVALID_PARAMETER	HashSize is NULL or HashAlgorithm is NULL.
EFI_UNSUPPORTED	The algorithm specified by HashAlgorithm is not supported by this driver.

Definition at line 111 of file Hash.h.

EFI_HASH_HASH

typedef EFI_STATUS(EFIAPI * EFI_HASH_HASH) (IN CONST EFI_HASH_PROTOCOL *This, IN CONST EFI_GUID *HashAlgorithm, IN BOOLEAN Extend, IN CONST UINT8 *Message, IN UINT64 MessageSize, IN OUT EFI_HASH_OUTPUT *Hash)

Creates a hash for the specified message text.

Parameters

[in]	This	Points to this instance of EFI_HASH_PROTOCOL.
[in]	HashAlgorithm	Points to the EFI_GUID which identifies the algorithm to use.
[in]	Extend	Specifies whether to create a new hash (FALSE) or extend the specified existing hash (TRUE).
[in]	Message	Points to the start of the message.
[in]	MessageSize	The size of Message, in bytes.
[in,out]	Hash	On input, if Extend is TRUE, then this parameter holds a pointer to a pointer to an array containing the hash to extend. If Extend is FALSE, then this parameter holds a pointer to a pointer to a caller-allocated array that will receive the result of the hash computation. On output (regardless of the value of Extend), the array will contain the result of the hash computation.

Return values

EFI_SUCCESS	Hash returned successfully.
EFI_INVALID_PARAMETER	Message or Hash, HashAlgorithm is NULL or MessageSize is 0. MessageSize is not an integer multiple of block size.
EFI_UNSUPPORTED	The algorithm specified by HashAlgorithm is not supported by this driver. Or, Extend is TRUE, and the algorithm doesn't support extending the hash.

Definition at line 142 of file Hash.h.

Function Documentation

FILE_LICENCE()

FILE_LICENCE

(

BSD2_PATENT

)

Variable Documentation

gEfiHashServiceBindingProtocolGuid

EFI_GUID gEfiHashServiceBindingProtocolGuid

gEfiHashProtocolGuid

EFI_GUID gEfiHashProtocolGuid

gEfiHashAlgorithmSha1Guid

EFI_GUID gEfiHashAlgorithmSha1Guid

gEfiHashAlgorithmSha224Guid

EFI_GUID gEfiHashAlgorithmSha224Guid

gEfiHashAlgorithmSha256Guid

EFI_GUID gEfiHashAlgorithmSha256Guid

gEfiHashAlgorithmSha384Guid

EFI_GUID gEfiHashAlgorithmSha384Guid

gEfiHashAlgorithmSha512Guid

EFI_GUID gEfiHashAlgorithmSha512Guid

gEfiHashAlgorithmMD5Guid

EFI_GUID gEfiHashAlgorithmMD5Guid

gEfiHashAlgorithmSha1NoPadGuid

EFI_GUID gEfiHashAlgorithmSha1NoPadGuid

gEfiHashAlgorithmSha256NoPadGuid

EFI_GUID gEfiHashAlgorithmSha256NoPadGuid