Struct CBCEncrypter 

pub struct CBCEncrypter<'a, B: Block> { /* private fields */ }

CBCEncrypter implements encryption in cipher block chaining mode, using the given Block.

Implementations

impl<'a, B: Block> CBCEncrypter<'a, B>

pub fn new(b: &'a B, iv: &[u8]) -> Self

new returns a BlockMode which encrypts in cipher block chaining mode, using the given Block. The length of iv must be the same as the Block’s block size.

Examples found in repository

examples/aes.rs (line 70)

fn aes_cbc(key: &[u8], plaintext: &[u8]) {
    let block = aes::Cipher::new(key).unwrap();
    assert!(
        plaintext.len() % aes::BLOCK_SIZE == 0,
        "Plaintext length must be a multiple of the block size"
    );

    // Using the initialization vector of all zeroes for demo purposes.
    // In practice the IV should be unique for each encryption operation and upredictable,
    // for example, generated using a secure random generator.
    let iv = vec![0; aes::BLOCK_SIZE];
    let mut mode = cipher::CBCEncrypter::new(&block, &iv);

    let mut encrypted = vec![0; plaintext.len()];
    mode.crypt_blocks(&mut encrypted, plaintext);

    // let mut mode = cipher::CBCDecrypter::new(&block, &iv);
    // let mut decrypted = vec![0; plaintext.len()];
    // mode.crypt_blocks(&mut decrypted, &encrypted);

    // println!("plaintext:      {}", String::from_utf8_lossy(plaintext));
    println!("CBC encrypted:  {}", hex::encode_to_string(&encrypted));
    // println!("decrypted:      {}", String::from_utf8_lossy(&decrypted));
    // println!();
}

pub fn set_iv(&mut self, iv: &[u8])

Trait Implementations

impl<'a, B: Block> BlockMode for CBCEncrypter<'a, B>

fn block_size(&self) -> usize

block_size returns the mode’s block size.

fn crypt_blocks(&mut self, dst: &mut [u8], src: &[u8])

crypt_blocks encrypts or decrypts a number of blocks. The length of src must be a multiple of the block size. If dst.len() < src.len(), crypt_blocks should panic. It is acceptable to pass a dst bigger than src, and in that case, crypt_blocks will only update dst[..src.len()] and will not touch the rest of dst.

fn crypt_blocks_inplace(&mut self, data: &mut [u8])

crypt_blocks_inplace is similar to crypt_blocks, but encrypts or decrypts a number of blocks in the same buffer.