Struct bacteria::Strobe128

pub struct Strobe128 { /* fields omitted */ }

A Strobe context for the 128-bit security level.

Implementations

impl Strobe128

pub fn new(protocol_label: &[u8]) -> Strobe128

Makes a new Strobe object with a given protocol byte string and with security parameter 128bit.

pub fn set_as_receiver(&mut self)

pub fn set_as_sender(&mut self)

pub fn recv_mac(&mut self, data: &mut [u8], more: bool) -> Result<(), AuthError>

Attempts to authenticate the current state against the given MAC. On failure, it returns an AuthError. It behooves the user of this library to check this return value and overreact on error.

pub fn meta_recv_mac(
    &mut self,
    data: &mut [u8],
    more: bool
) -> Result<(), AuthError>

Attempts to authenticate the current state against the given MAC. On failure, it returns an AuthError. It behooves the user of this library to check this return value and overreact on error.

pub fn ratchet(&mut self, num_bytes_to_zero: usize, more: bool)

Ratchets the internal state forward in an irreversible way by zeroing bytes.

Takes a usize argument specifying the number of bytes of public state to zero. If the size exceeds self.rate, Keccak-f will be called before more bytes are zeroed.

pub fn meta_ratchet(&mut self, num_bytes_to_zero: usize, more: bool)

Ratchets the internal state forward in an irreversible way by zeroing bytes.

Takes a usize argument specifying the number of bytes of public state to zero. If the size exceeds self.rate, Keccak-f will be called before more bytes are zeroed.

pub fn send_enc(&mut self, data: &mut [u8], more: bool)

Sends an encrypted message.

pub fn meta_send_enc(&mut self, data: &mut [u8], more: bool)

Sends an encrypted message.

pub fn recv_enc(&mut self, data: &mut [u8], more: bool)

Receives an encrypted message.

pub fn meta_recv_enc(&mut self, data: &mut [u8], more: bool)

Receives an encrypted message.

pub fn send_mac(&mut self, data: &mut [u8], more: bool)

Sends a MAC of the internal state. The output is independent of the initial contents of the input buffer.

pub fn meta_send_mac(&mut self, data: &mut [u8], more: bool)

Sends a MAC of the internal state. The output is independent of the initial contents of the input buffer.

pub fn prf(&mut self, data: &mut [u8], more: bool)

Extracts pseudorandom data as a function of the internal state. The output is independent of the initial contents of the input buffer.

pub fn meta_prf(&mut self, data: &mut [u8], more: bool)

Extracts pseudorandom data as a function of the internal state. The output is independent of the initial contents of the input buffer.

pub fn send_clr(&mut self, data: &[u8], more: bool)

Sends a plaintext message.

pub fn meta_send_clr(&mut self, data: &[u8], more: bool)

Sends a plaintext message.

pub fn recv_clr(&mut self, data: &[u8], more: bool)

Receives a plaintext message.

pub fn meta_recv_clr(&mut self, data: &[u8], more: bool)

Receives a plaintext message.

pub fn ad(&mut self, data: &[u8], more: bool)

Mixes associated data into the internal state.

pub fn meta_ad(&mut self, data: &[u8], more: bool)

Mixes associated data into the internal state.

pub fn key(&mut self, data: &[u8], more: bool)

Sets a symmetric cipher key.

pub fn meta_key(&mut self, data: &[u8], more: bool)

Sets a symmetric cipher key.

pub fn send_aead(&mut self, plaintext: &[u8], ad: &[u8]) -> Vec<u8>

encrypt data and authenticate additional data

pub fn recv_aead(
    &mut self,
    ciphertext: &[u8],
    ad: &[u8]
) -> Result<Vec<u8>, AuthError>

decrypt data and authenticate additional data

Trait Implementations

impl Clone for Strobe128

fn clone(&self) -> Strobe128

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Strobe128

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

Formats the value using the given formatter.

impl Drop for Strobe128

fn drop(&mut self)

Executes the destructor for this type.

impl Zeroize for Strobe128

fn zeroize(&mut self)

Zero out this object from memory using Rust intrinsics which ensure the zeroization operation is not “optimized away” by the compiler.