Struct Polyval

pub struct Polyval<B = Precomputed>(/* private fields */);

An implementation of POLYVAL.

POLYVAL is similar to GHASH. It operates in GF(2¹²⁸) defined by the irreducible polynomial

x^128 + x^127 + x^126 + x^121 + 1

The field has characteristic 2, so addition is performed with XOR. Multiplication is polynomial multiplication reduced modulo the polynomial.

For more information on POLYVAL, see RFC 8452.

Implementations

impl Polyval

pub fn export(&self) -> State

Available on crate feature experimental only.

Exports the current state.

pub fn reset(&mut self, state: &State)

Available on crate feature experimental only.

Resets the hash to state.

pub fn current_tag(&self) -> Tag

Available on crate feature experimental only.

Returns the current authentication tag without consuming self.

impl<B: Backend> Polyval<B>

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

Creates an instance of POLYVAL.

pub fn update_block(&mut self, block: &[u8; 16])

Writes a single block to the running hash.

pub fn update(&mut self, blocks: &[[u8; 16]])

Writes one or more blocks to the running hash.

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

Writes one or more blocks to the running hash.

If the length of blocks is non-zero and is not a multiple of BLOCK_SIZE, it’s padded with zeros.

pub fn tag(self) -> Tag

Returns the current authentication tag.

pub fn verify(self, expected_tag: &Tag) -> Choice

Reports whether the current authentication tag matches expected_tag.

Trait Implementations

impl<B: Clone> Clone for Polyval<B>

fn clone(&self) -> Polyval<B>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T> Debug for Polyval<T>

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

Formats the value using the given formatter.

impl<T> ZeroizeOnDrop for Polyval<T>

Available on crate feature zeroize only.