Struct Pkcs11Context 

pub struct Pkcs11Context { /* private fields */ }

PKCS#11 library context.

Wraps the Cryptoki Pkcs11 handle with thread-safe reference counting and automatic initialization/finalization.

Implementations

impl Pkcs11Context

pub fn new(library_path: impl AsRef<Path>) -> HsmResult<Self>

Initialize a new PKCS#11 context from a library path.

Arguments

• library_path - Path to the PKCS#11 library (.so, .dylib, .dll)

Errors

Returns HsmError::LibraryLoad if the library cannot be loaded or initialized.

pub fn with_pkcs11<F, R>(&self, f: F) -> HsmResult<R>

where F: FnOnce(&Pkcs11) -> HsmResult<R>,

Get the underlying Pkcs11 handle.

Panics

Panics if the mutex is poisoned (should never happen in normal operation). Execute a closure with the PKCS#11 handle.

Returns HsmError::LibraryLoad if this is a placeholder context.

pub fn library_info(&self) -> HsmResult<String>

Get library information.

pub fn placeholder() -> Self

Create a placeholder context for use when HSM is not configured.

Any PKCS#11 operation on a placeholder will return HsmError::LibraryLoad.

Trait Implementations

impl Clone for Pkcs11Context

fn clone(&self) -> Pkcs11Context

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Drop for Pkcs11Context

fn drop(&mut self)

Executes the destructor for this type.