Struct cryptoki::context::Pkcs11

pub struct Pkcs11 { /* private fields */ }

Main PKCS11 context. Should usually be unique per application.

Implementations

impl Pkcs11

pub fn open_ro_session(&self, slot_id: Slot) -> Result<Session>

Open a new Read-Only session

For a Read-Write session, use open_rw_session

Note: No callback is set when opening the session.

pub fn open_rw_session(&self, slot_id: Slot) -> Result<Session>

Open a new Read/Write session

Note: No callback is set when opening the session.

impl Pkcs11

pub fn get_slots_with_token(&self) -> Result<Vec<Slot>>

Get all slots available with a token

pub fn get_all_slots(&self) -> Result<Vec<Slot>>

Get all slots

pub fn get_slots_with_initialized_token(&self) -> Result<Vec<Slot>>

Get all slots available with a token

pub fn init_token(&self, slot: Slot, pin: &AuthPin, label: &str) -> Result<()>

Initialize a token

Currently will use an empty label for all tokens.

pub fn get_slot_info(&self, slot: Slot) -> Result<SlotInfo>

Returns the slot info

pub fn get_token_info(&self, slot: Slot) -> Result<TokenInfo>

Returns information about a specific token

pub fn get_mechanism_list(&self, slot: Slot) -> Result<Vec<MechanismType>>

Get all mechanisms support by a slot

pub fn get_mechanism_info( &self, slot: Slot, type_: MechanismType ) -> Result<MechanismInfo>

Get detailed information about a mechanism for a slot

pub fn wait_for_slot_event(&self) -> Result<Slot>

Wait for slot events (insertion or removal of a token)

pub fn get_slot_event(&self) -> Result<Option<Slot>>

Get the latest slot event (insertion or removal of a token)

impl Pkcs11

pub fn new<P>(filename: P) -> Result<Self>

where P: AsRef<Path>,

Instantiate a new context from the path of a PKCS11 dynamic library implementation.

pub fn initialize(&self, init_args: CInitializeArgs) -> Result<()>

Initialize the PKCS11 library

pub fn is_initialized(&self) -> bool

Check whether the PKCS11 library has been initialized

pub fn finalize(self)

Finalize the PKCS11 library. Indicates that the application no longer needs to use PKCS11. The library is also automatically finalized on drop.

pub fn get_library_info(&self) -> Result<Info>

Returns the information about the library

pub fn is_fn_supported(&self, function: Function) -> bool

Check whether a given PKCS11 spec-defined function is supported by this implementation

Trait Implementations

impl Clone for Pkcs11

fn clone(&self) -> Pkcs11

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Pkcs11

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

Formats the value using the given formatter.