Struct LibCtx 

pub struct LibCtx { /* private fields */ }

An OpenSSL library context (OSSL_LIB_CTX*).

Wrap in Arc<LibCtx> before passing to algorithm descriptors; they will clone the Arc to keep the context alive.

Implementations

impl LibCtx

pub fn new() -> Result<Self, ErrorStack>

Create a new, empty library context.

No providers are loaded by default. Call load_provider at least once before using algorithms.

Errors

Returns Err if OpenSSL cannot allocate the context.

pub fn load_provider(&self, name: &CStr) -> Result<Provider, ErrorStack>

Load a provider into this library context.

Common provider names:

• c"default" — standard algorithms.
• c"fips" — FIPS 140-3 validated algorithms (requires OpenSSL FIPS module).
• c"base" — must be loaded alongside "fips" for PEM/DER encoders.

The returned Provider keeps the provider loaded until dropped.

Errors

Returns Err if the provider cannot be loaded.

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

Return the raw OSSL_LIB_CTX* pointer. Valid while self is alive.

pub unsafe fn from_raw_unowned(ptr: *mut OSSL_LIB_CTX) -> Self

Wrap a raw OSSL_LIB_CTX* that is owned and managed externally.

The resulting LibCtx will NOT call OSSL_LIB_CTX_free when dropped. Use this only when the raw pointer’s lifetime is guaranteed to exceed the LibCtx (e.g. a context received from a FIPS provider callback).

Safety

The caller must ensure that ptr is a valid, non-null OSSL_LIB_CTX* that remains valid for as long as the returned LibCtx is alive.

Trait Implementations

impl Debug for LibCtx

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

Formats the value using the given formatter.

impl Drop for LibCtx

fn drop(&mut self)

Executes the destructor for this type.

impl Send for LibCtx

impl Sync for LibCtx