Struct CipherAlg 

pub struct CipherAlg { /* private fields */ }

An OpenSSL symmetric cipher algorithm descriptor (EVP_CIPHER*).

Fetched once and reused. Implements Clone via EVP_CIPHER_up_ref.

Implementations

impl CipherAlg

pub fn fetch(name: &CStr, props: Option<&CStr>) -> Result<Self, ErrorStack>

Fetch a cipher algorithm from the global default library context.

Errors

Returns Err if the algorithm is not available.

pub fn fetch_in( ctx: &Arc<LibCtx>, name: &CStr, props: Option<&CStr>, ) -> Result<Self, ErrorStack>

Fetch a cipher algorithm from an explicit library context.

Errors

pub fn key_len(&self) -> usize

Expected key length in bytes (e.g. 32 for AES-256).

pub fn iv_len(&self) -> usize

Expected IV length in bytes (0 for ECB mode).

pub fn block_size(&self) -> usize

Block size in bytes (1 for stream ciphers; 16 for AES).

pub fn flags(&self) -> u64

OpenSSL flags for this cipher (e.g. EVP_CIPH_FLAG_AEAD_CIPHER).

pub fn is_aead(&self) -> bool

Return true if this is an AEAD cipher (GCM, CCM, ChaCha20-Poly1305).

pub fn as_ptr(&self) -> *const EVP_CIPHER

Return the raw EVP_CIPHER* pointer. Valid for the lifetime of self.

impl CipherAlg

pub fn encrypt( &self, key: &[u8], iv: &[u8], params: Option<&Params<'_>>, ) -> Result<CipherCtx<Encrypt>, ErrorStack>

Create an encryption context.

key and iv are copied into OpenSSL’s internal state by EVP_EncryptInit_ex2 (key scheduling + zeroization on free).

Errors

pub fn decrypt( &self, key: &[u8], iv: &[u8], params: Option<&Params<'_>>, ) -> Result<CipherCtx<Decrypt>, ErrorStack>

Create a decryption context.

Same key/IV copy semantics as encrypt.

Errors

Trait Implementations

impl Clone for CipherAlg

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Drop for CipherAlg

fn drop(&mut self)

Executes the destructor for this type.

impl Send for CipherAlg

impl Sync for CipherAlg