Functions and Types

Data Structures
struct	validus_state
	Represents the state of an individual Validus hash operation. More...

Typedefs
typedef uint8_t	validus_octet
	Validus byte (8-bit).
typedef uint32_t	validus_word
	Validus word (32-bit).

Functions
void	validus_init (validus_state *state)
	Initializes a validus_state object.
void	validus_append (validus_state *state, const void *data, size_t len)
	Processes a block of data, accumulating the results in the validus_state object.
void	validus_finalize (validus_state *state)
	Finalizes a Validus hashing operation.
bool	validus_compare (const validus_state *one, const validus_state *two)
	Compares two validus_state objects for equality.
void	_validus_process (validus_state *state, const validus_word *blk32)
	Processes a 192-bit block of data, accumulating the results in the validus_state object.

Detailed Description

Function Documentation

validus_init()

void validus_init

(

validus_state *

state

)

Initializes a validus_state object.

Fills the state structure with initial values and prepares it for use with validus_append, and validus_finalize.

Note

Must be called before any other Validus function that takes a validus_state input argument.

If state is NULL, this function will return early, and have no effect.

Parameters

state

Pointer to the validus_state object to initialize.

validus_append()

void validus_append	(	validus_state *	state,
		const void *	data,
		size_t	len )

Processes a block of data, accumulating the results in the validus_state object.

Note

If state or data are NULL, or len is zero, this function will return early, and have no effect.

Parameters

state	Pointer to the validus_state object in use for this series of data.
data	Pointer to a new block of data to process.
len	Length of data in octets.

validus_finalize()

void validus_finalize

(

validus_state *

state

)

Finalizes a Validus hashing operation.

Note

Must be called after the final call to validus_append.

If state is NULL, this function will return early and have no effect.

Parameters

state

Pointer to the validus_state object to finalize.

validus_compare()

bool validus_compare	(	const validus_state *	one,
		const validus_state *	two )

Compares two validus_state objects for equality.

Parameters

one	Pointer to a validus_state to compare for equality.
two	Pointer to a validus_state to compare for equality.

Returns

bool true if both states are identical, false otherwise.

_validus_process()

void _validus_process	(	validus_state *	state,
		const validus_word *	blk32 )

Processes a 192-bit block of data, accumulating the results in the validus_state object.

Attention

This function is only called by other Validus functions; do not call it directly.

Parameters

state	Pointer to the validus_state object in use for this series of data.
blk32	Pointer to the block of data to be processed.