Struct yubirs::piv::hal::PcscHardware

pub struct PcscHardware { /* fields omitted */ }

An implementation of PcscHal which actually talks to real hardware using the PC/SC library.

Methods

impl PcscHardware

pub fn new_with_recording<P: AsRef<Path>>(output: P) -> Result<Self>

Trait Implementations

impl Drop for PcscHardware

fn drop(&mut self)

Executes the destructor for this type.

impl PcscHal for PcscHardware

fn new() -> Result<Self>

Construct a new HAL, ready to connect to / interact with underlying hardware.

fn secure_random_bytes(&self, buf: &mut [u8]) -> Result<()>

Populate the given buffer with cryptographically secure random bytes.

fn cheap_random_bytes(&self, buf: &mut [u8]) -> Result<()>

Populate the given buffer with cheap-to-generate but possibly weak random bytes. NOTE: be extremely careful with using this function in cryptographically sensitive situations.

fn list_readers(&self) -> Result<Vec<String>>

Return a list of the PC/SC readers currently available on the system.

fn connect_impl(&mut self, reader: &str) -> Result<()>

Actually connect to the given reader using the native PC/SC library. This trait already provides the higher level connect, which handles selecting the right reader, and performing setup interactions with the device after connecting. This function simply wraps the real interaction with the underlying hardware.

fn disconnect(&mut self)

Disconnect from the current reader, if any.

fn send_data_impl(&self, apdu: &Apdu) -> Result<(StatusWord, Vec<u8>)>

Send data to the underlying hardware. The given byte slice must be formatted as a smart card APDU (https://en.wikipedia.org/wiki/Smart_card_application_protocol_data_unit). This function should return a status word, as well as any bytes returned by the hardware.

fn begin_transaction(&self) -> Result<()>

Start a new PC/SC transaction with the underlying hardware.

fn end_transaction(&self) -> Result<()>

End a previously started PC/SC transaction with the underlying hardware.

fn connect(&mut self, reader: Option<&str>) -> Result<()>

Connect to the given reader (or the default reader, if none was specified). This must be called before e.g. data is sent or transactions are started.

fn send_data(&self, templ: &[u8], data: &[u8]) -> Result<(StatusWord, Vec<u8>)>

A provided, higher-level interface for sending data to the underlying hardware.