Struct Aes256

pub struct Aes256(/* private fields */);

A key-scheduled Aes256 block cipher which can both encrypt and decrypt blocks.

Trait Implementations

impl AesBlockCipher for Aes256

fn new_with_key(key: Self::Key) -> Self

Schedule a new AES key.

Scalar Equivalent

Self({
    <aes::Aes256 as aes::cipher::KeyInit>::new_from_slice(key.as_ref())
        .expect("AES size is statically correct")
})

AVX2 Intrinsics Used

• _mm_aesimc_si128
  • AESIMC xmm, xmm
• _mm_aeskeygenassist_si128
  • AESKEYGENASSIST xmm, xmm, imm8

Neon Intrinsics Used

• vaeseq_u8
  • This intrinsic compiles to the following instructions:
    • AESE Vd.16B,Vn.16B
• vaesimcq_u8
  • This intrinsic compiles to the following instructions:
    • AESIMC Vd.16B,Vn.16B

fn encrypt_many<const N: usize>(&self, blocks: [U8x16; N]) -> [U8x16; N]

where ArrayUnrolledOps: UnrollableArraySize<N>,

Encrypt blocks with AES-ECB

Scalar Equivalent

let mut out = blocks;
for block in out.iter_mut() {
    let block = aes::cipher::generic_array::GenericArray::from_mut_slice(
        block.as_mut(),
    );
    aes::cipher::BlockEncrypt::encrypt_block((&self.0), block);
}
out

AVX2 Intrinsics Used

• _mm_aesenc_si128
  • AESENC xmm, xmm
• _mm_aesenclast_si128
  • AESENCLAST xmm, xmm

Neon Intrinsics Used

• vaeseq_u8
  • This intrinsic compiles to the following instructions:
    • AESE Vd.16B,Vn.16B
• vaesmcq_u8
  • This intrinsic compiles to the following instructions:
    • AESMC Vd.16B,Vn.16B

const BLOCK_COUNT_HINT: usize = 4usize

Running encrypt_many with this many blocks will typically result in good performance.

type Key = U8x32

The type of the AES key.

fn encrypt(&self, block: U8x16) -> U8x16

Encrypt a single 128-bit AES block.

impl AesBlockCipherDecrypt for Aes256

fn decrypt_many<const N: usize>(&self, blocks: [U8x16; N]) -> [U8x16; N]

where ArrayUnrolledOps: UnrollableArraySize<N>,

Decrypt blocks with AES-ECB

Scalar Equivalent

let mut out = blocks;
for block in out.iter_mut() {
    let block = aes::cipher::generic_array::GenericArray::from_mut_slice(
        block.as_mut(),
    );
    aes::cipher::BlockDecrypt::decrypt_block((&self.0), block);
}
out

AVX2 Intrinsics Used

• _mm_aesdec_si128
  • AESDEC xmm, xmm
• _mm_aesdeclast_si128
  • AESDECLAST xmm, xmm

Neon Intrinsics Used

• vaesdq_u8
  • This intrinsic compiles to the following instructions:
    • AESD Vd.16B,Vn.16B
• vaesimcq_u8
  • This intrinsic compiles to the following instructions:
    • AESIMC Vd.16B,Vn.16B

fn decrypt(&self, block: U8x16) -> U8x16

Decrypt a single 128-bit AES block.

impl Clone for Aes256

fn clone(&self) -> Aes256

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Aes256

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

Formats the value using the given formatter.