Enum noise_sodiumoxide::Aes256Gcm

pub enum Aes256Gcm {}

The AES-256-GCM AEAD.

Portability Warning

The current implementation of this construction is hardware-accelerated and requires the Intel SSSE3 extensions, as well as the aesni and pclmul instructions.

Intel Westmere processors (introduced in 2010) and newer meet the requirements.

There are no plans to support non hardware-accelerated implementations of AES-GCM. If portability is a concern, use ChaCha20-Poly1305 instead.

Before using the functions below, hardware support for AES can be checked with Aes256Gcm::available.

The function returns true if the current CPU supports the AES256-GCM implementation, and false if it doesn't.

The library must have been initialized with init prior to calling this function.

Libsodium doc: https://libsodium.gitbook.io/doc/secret-key_cryptography/aead/aes-256-gcm#limitations.

Methods

impl Aes256Gcm

pub fn available() -> bool

Check for hardware support of AES-GCM.

The function returns true if the current CPU supports the AES256-GCM implementation, and false if it doesn't.

Trait Implementations

impl Cipher for Aes256Gcm

type Key = Sensitive<[u8; 32]>

Type of key.

fn name() -> &'static str

Name of this cipher function.

fn encrypt(
    k: &Self::Key,
    nonce: u64,
    ad: &[u8],
    plaintext: &[u8],
    out: &mut [u8]
)

AEAD encryption.

fn decrypt(
    k: &Self::Key,
    nonce: u64,
    ad: &[u8],
    ciphertext: &[u8],
    out: &mut [u8]
) -> Result<(), ()>

AEAD decryption.

fn key_len() -> usize

Length of key.

fn tag_len() -> usize

Length of auth tag.

fn rekey(k: &Self::Key) -> Self::Key

Rekey. Returns a new cipher key as a pseudorandom function of k.