Struct CardReport 

pub struct CardReport {
    pub serial: u32,
    pub firmware: String,
    pub pin: Option<CredentialMetadata>,
    pub puk: Option<CredentialMetadata>,
    pub management_key: Option<MgmtMetadata>,
    pub protection: ProtectionMode,
    pub slot: SlotReport,
    pub key_check: Option<SlotKeyCheck>,
}

The state of a YubiKey, from read-only APDUs.

Fields

serial: u32

firmware: String

pin: Option<CredentialMetadata>

None on firmware without GET METADATA (< 5.3).

puk: Option<CredentialMetadata>

management_key: Option<MgmtMetadata>

protection: ProtectionMode

slot: SlotReport

key_check: Option<SlotKeyCheck>

The key/certificate match check, when the caller ran it.

Implementations

impl CardReport

pub fn build(ctx: &Context, slot: u8) -> Self

Build the report for the YubiKey of ctx, with slot as the store slot. Read-only; no PIN.

pub fn has_metadata(&self) -> bool

The firmware reports PIN, PUK and management key metadata (5.3+).

pub fn pin_blocked(&self) -> bool

pub fn puk_blocked(&self) -> bool

pub fn items(&self, key_check_hint: Option<&str>) -> Vec<Item>

The report lines, in display order. key_check_hint is shown on the Key/certificate line when the check did not run; None omits the line.

pub fn severity(&self) -> Severity

The most serious severity among the items.

pub fn render(&self, key_check_hint: Option<&str>, hints: bool) -> String

The YubiKey section (spec 0023 §2), one line per item, followed by the item’s hint lines when hints is set.

Trait Implementations

impl Clone for CardReport

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CardReport

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

Formats the value using the given formatter.

impl Eq for CardReport

impl PartialEq for CardReport

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

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for CardReport