Struct cipher::BlockModeDecryptWrapper

pub struct BlockModeDecryptWrapper<M: BlockModeDecrypt, P: Padding<M::BlockSize>> { /* fields omitted */ }

Convinience wrapper around the BlockModeDecrypt trait, which handles data buffering and provides slice-based methods.

Implementations

impl<M, P> BlockModeDecryptWrapper<M, P> where
    M: BlockModeDecrypt,
    P: Padding<M::BlockSize>, 

pub fn decrypt_part<'a>(
    &mut self,
    ciphertext: &[u8],
    out_buf: &'a mut [u8]
) -> Result<&'a [u8], BlockModeError>

Decrypt part of a ciphertext.

This mehthod MUST be used in conjuction with the decrypt_final method, otherwise plaintext will not be properly padded and may be truncated.

The method decrypts ciphertext, writes the resulting plaintext into out_buf, and returns it in the Ok variant. If a whole message can not be processed, it caches ciphertext leftovers into inner buffer for future use.

It’s recommended for out_buf to be at least one block longer than data, otherwise the method can return Err(BlockModeError) if there is not enough space for encrypted blocks.

pub fn decrypt_final<'a>(
    self,
    ciphertext: &[u8],
    out_buf: &'a mut [u8]
) -> Result<&'a [u8], BlockModeError>

Pad and decrypt plaintext.

The method decrypts ciphertext, writes the resulting plaintext into into out_buf, and unpads it.

It’s recommended for out_buf to be at least one block longer than data, otherwise the method can return Err(BlockModeError) if there is not enough space for encrypted blocks.

Trait Implementations

impl<M, P> FromBlockCipherNonce for BlockModeDecryptWrapper<M, P> where
    M: BlockModeDecrypt + FromBlockCipherNonce,
    P: Padding<M::BlockSize>, 

type BlockCipher = M::BlockCipher

Block cipher used for initialization.

type NonceSize = M::NonceSize

Nonce size in bytes.

fn from_block_cipher_nonce(
    cipher: Self::BlockCipher,
    nonce: &GenericArray<u8, Self::NonceSize>
) -> Self

Initialize instance from block cipher and nonce.