Struct polyhash::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: &Key) -> Self

Creates an instance of POLYVAL.

pub fn update(&mut self, blocks: &[u8]) -> Result<(), Error>

Writes one or more blocks to the running hash.

It is an error if blocks is not a multiple of BLOCK_SIZE.

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

Writes one or more blocks to the running hash.

If the length of blocks 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 Clone for Polyval

fn clone(&self) -> Polyval

Returns a copy of the value.

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

Performs copy-assignment from source.