Struct Polyval 

pub struct Polyval(/* 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 new(key: &[u8; 16]) -> Option<Self>

Creates a new hash instance.

It returns None if key is all zeroes.

pub fn new_unchecked(key: &[u8; 16]) -> Self

Creates a hash instance from a known non-zero key.

Warning

Only use this method if key is known to be non-zero. Using an all zero key fixes the output to zero, regardless of the input.

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

Writes a single block to the running hash.

pub fn update_blocks(&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, it’s padded to the lowest multiple of BLOCK_SIZE.

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.

pub fn export(&self) -> PolyvalState

Available on crate feature experimental only.

Exports the current state.

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

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 the hash.

Trait Implementations

impl Clone for Polyval

fn clone(&self) -> Polyval

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Polyval

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

Formats the value using the given formatter.

impl Drop for Polyval

fn drop(&mut self)

Executes the destructor for this type.

impl ZeroizeOnDrop for Polyval

Available on crate feature zeroize only.