Struct CipherCtx

Source

pub struct CipherCtx<Dir> { /* private fields */ }

Expand description

Stateful symmetric cipher context.

Dir is either Encrypt or Decrypt; the type parameter prevents accidentally calling encrypt operations on a decrypt context and vice versa.

!Clone — cipher contexts have no up_ref; use a fresh context per message.

Implementations§

Source §

impl<Dir: Direction> CipherCtx<Dir>

Source

pub fn update( &mut self, input: &[u8], output: &mut [u8], ) -> Result<usize, ErrorStack>
where Dir: IsEncrypt,

Feed input into the cipher; write plaintext/ciphertext to output.

output must be at least input.len() + block_size - 1 bytes. Returns the number of bytes written.

§Errors

Source

pub fn update_to_vec(&mut self, input: &[u8]) -> Result<Vec<u8>, ErrorStack>
where Dir: IsEncrypt,

Feed input through the cipher and return the output as a Vec<u8>.

Allocates input.len() + block_size bytes, calls Self::update, then truncates to the actual number of bytes written. Use this when the caller cannot easily compute the output size in advance.

§Errors

Source

pub fn finalize(&mut self, output: &mut [u8]) -> Result<usize, ErrorStack>
where Dir: IsEncrypt,

Finalise the operation (flush padding / verify auth tag).

§Errors

Source

pub fn set_params(&mut self, params: &Params<'_>) -> Result<(), ErrorStack>

Set dynamic parameters on the context (e.g. GCM tag length).

§Errors

Source

pub fn as_ptr(&self) -> *mut EVP_CIPHER_CTX

Return the raw EVP_CIPHER_CTX* pointer. Returns a mutable pointer because most OpenSSL EVP functions require EVP_CIPHER_CTX* even for logically read-only operations.