Struct ghash::GHash

pub struct GHash(_);

GHASH: universal hash over GF(2^128) used by AES-GCM.

GHASH is a universal hash function used for message authentication in the AES-GCM authenticated encryption cipher.

Trait Implementations

impl Clone for GHash

pub fn clone(&self) -> GHash

Returns a copy of the value.

pub fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for GHash

pub fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl NewUniversalHash for GHash

type KeySize = U16

Size of the key for the universal hash function.

pub fn new(h: &Key) -> Self

Initialize GHASH with the given H field element

impl UniversalHash for GHash

type BlockSize = U16

Size of the inputs to and outputs from the universal hash function

pub fn update(&mut self, x: &Block)

Input a field element X to be authenticated

pub fn reset(&mut self)

Reset internal state

pub fn finalize(self) -> Tag

Get GHASH output

pub fn update_padded(&mut self, data: &[u8])

Input data into the universal hash function. If the length of the data is not a multiple of the block size, the remaining data is padded with zeroes up to the BlockSize.

pub fn finalize_reset(&mut self) -> Output<Self>

Obtain the [Output] of a [UniversalHash] computation and reset it back to its initial state.

pub fn verify(
    self,
    other: &GenericArray<u8, Self::BlockSize>
) -> Result<(), Error>

Verify the [UniversalHash] of the processed input matches a given [Output]. This is useful when constructing Message Authentication Codes (MACs) from universal hash functions.