Enum Error 

#[non_exhaustive]
pub enum Error {
    Pcsc(Error),
    NoReader,
    ReaderNotFound(String),
    Status(StatusWord),
    ShortResponse(usize),
    DataTooLong(usize),
    ExpectedLengthOutOfRange(u32),
    PinIncorrect {
        retries: Option<u8>,
    },
    PinBlocked,
    InvalidPin(&'static str),
    OffsetOutOfRange(usize),
    InvalidDfName(usize),
    NoShortEfId(u16),
    InvalidRecordNumber,
    BadSigningInput {
        scheme: SignatureScheme,
        len: usize,
    },
    UnknownCertificateAuthority(KeyId),
    SignatureInvalid(&'static str),
    Malformed(String),
}

Anything that can go wrong while talking to an Individual Number Card.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Pcsc(Error)

An error reported by the PC/SC layer.

NoReader

No PC/SC reader is available.

ReaderNotFound(String)

The named PC/SC reader does not exist.

Status(StatusWord)

The card returned a status word other than success.

ShortResponse(usize)

The response was too short to even contain a status word.

DataTooLong(usize)

The command data field exceeds what even an extended APDU can encode.

ExpectedLengthOutOfRange(u32)

Le is outside the 1 to 65536 an APDU can ask for.

PinIncorrect

The PIN was rejected.

retries is the number of attempts left before the key is blocked, or None if the key has no retry limit (JICSAP 5.2.2: the card answers 6300 rather than 63Cx).

Fields

retries: Option<u8>

Attempts left on the card’s retry counter, or None if it is unlimited.

PinBlocked

The key is blocked because its retry counter reached zero.

InvalidPin(&'static str)

The supplied PIN is not well formed.

OffsetOutOfRange(usize)

The requested offset cannot be encoded in a short READ BINARY.

InvalidDfName(usize)

A DF name must be 1 to 16 bytes (JICSAP 4.2 (1)).

NoShortEfId(u16)

The EF identifier has no short form; only 0001-001E do (JICSAP 4.2 (2)).

InvalidRecordNumber

Record 0 means “the current record”, which this crate does not use.

BadSigningInput

The data field does not suit the signing scheme it was given to.

Fields

scheme: SignatureScheme

The scheme the data was rejected for.

len: usize

How many bytes were supplied.

UnknownCertificateAuthority(KeyId)

A card-verifiable certificate names a CA this crate has no key for.

Distinct from a failed signature: nothing was checked. See crate::ca.

SignatureInvalid(&'static str)

A signature did not verify under the key it was checked against.

Malformed(String)

Data read from the card did not have the expected structure.

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.