Struct KnownCard 

pub struct KnownCard {

    pub ident: String,
    pub manufacturer: u16,
    pub serial: u32,
    pub holder: String,
    pub sign: String,
    pub decrypt: String,
    pub cert: String,
    pub addresses: Vec<String>,
    pub source: String,
    pub checked: i64,
    pub pin_tries_full: u8,
    pub touch_sign: Touch,
    pub touch_decrypt: Touch,
    pub pin_each_signature: bool,
}

A security key Sioul knows, in pgp/cards.toml: which keys it holds, the certificate they belong to and where it came from. No secret.

Fields

ident: String

“0006:12345678”, as CardInfo::ident.

manufacturer: u16

Its maker’s number.

serial: u32

Its serial number.

holder: String

The name written on it.

sign: String

The fingerprint of its signing key; empty when it holds none.

decrypt: String

The fingerprint of its decryption key; empty when it holds none.

cert: String

The certificate both belong to, by its primary key’s fingerprint.

addresses: Vec<String>

Your addresses it signs for (decision 2: it alone signs for them).

source: String

Where its certificate came from: an address, or “file”.

checked: i64

When the certificate was checked against the key (Unix seconds).

pin_tries_full: u8

The most PIN tries the key was seen with: fewer are said.

touch_sign: Touch

Whether its signing key waits for a touch, as last read.

touch_decrypt: Touch

Whether its decryption key waits for a touch, as last read.

pin_each_signature: bool

The PIN is asked for each signature.

Implementations

impl KnownCard

pub fn serves(&self, address: &str) -> bool

Whether it signs for address.

pub fn label(&self, tr: &Translator) -> String

“YubiKey 12 345 678”.

pub fn update(&mut self, info: &CardInfo)

What the key said now, kept: touch settings, the PIN for each signature, the most tries seen.

pub fn tries_line(&self, left: u8, tr: &Translator) -> Option<String>

The tries left, said when fewer than the most seen: “2 tries left.”; else nothing.

Trait Implementations

impl Clone for KnownCard

fn clone(&self) -> KnownCard

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for KnownCard

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

Formats the value using the given formatter.

impl Default for KnownCard

fn default() -> KnownCard

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for KnownCard

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for KnownCard

impl PartialEq for KnownCard

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for KnownCard

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for KnownCard