Struct yubirs::piv::apdu::Apdu

pub struct Apdu { /* fields omitted */ }

APDU stands for "smart card Application Protocol Data Unit". This union definition is used by upstream's library to alternate between treating APDU data in a structured or unstructured way.

Methods

impl Apdu

pub fn from_bytes(bytes: &[u8]) -> Result<Self>

pub fn from_pieces(
    cla: u8,
    ins: u8,
    p1: u8,
    p2: u8,
    lc: u8,
    data: &[u8]
) -> Result<Self>

pub fn new_aid() -> Result<Self>

Construct a new Application ID APDU, which should be sent to the underlying hardware when we connect to it.

pub fn raw(&self) -> &[u8]

Return this APDU's raw data, including the various properties which are normally broken out (e.g., this function returns more bytes than data).

pub fn raw_minimal(&self) -> &[u8]

Returns the same data as raw, but it excludes the extra tailing 0 bytes (i.e., it only includes the APDU's properties along with lc bytes of arbitrary data).

pub fn cla(&self) -> u8

Instruction class - indicates the type of command, e.g. interindustry or proprietary.

pub fn ins(&self) -> u8

Instruction code - indicates the specific command, e.g. "write data".

pub fn p1(&self) -> u8

First instruction parameter for the command, e.g. offset into file at which to write the data.

pub fn p2(&self) -> u8

Second instruction parameter for the command, e.g. offset into file at which to write the data.

pub fn lc(&self) -> u8

Encodes the number (N_c) of bytes of command data to follow. The official specification says that this field can be variable length, but upstream specifies it statically at 1 byte.

pub fn data(&self) -> &[u8]

The command data. The official specification says this can be up to 65535 bytes long, but upstream defines it as a static 255 bytes.

pub fn data_minimal(&self) -> &[u8]

Returns the same data as data, but it excludes the extra trailing 0 bytes (i.e., it only includes lc bytes or arbitrary data).

Trait Implementations

impl Clone for Apdu

fn clone(&self) -> Apdu

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Copy for Apdu

impl Debug for Apdu

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

Formats the value using the given formatter.

impl Eq for Apdu

impl PartialEq<Apdu> for Apdu

fn eq(&self, other: &Apdu) -> bool

This method tests for self and other values to be equal, and is used by ==.

#[must_use] fn ne(&self, other: &Rhs) -> bool

This method tests for !=.