[][src]Enum sequoia_openpgp::types::ReasonForRevocation

pub enum ReasonForRevocation {
    Unspecified,
    KeySuperseded,
    KeyCompromised,
    KeyRetired,
    UIDRetired,
    Private(u8),
    Unknown(u8),
    // some variants omitted
}

Describes the reason for a revocation.

See the description of revocation subpackets Section 5.2.3.23 of RFC 4880.

Note: This enum cannot be exhaustively matched to allow future extensions.

Examples

use sequoia_openpgp as openpgp;
use openpgp::cert::prelude::*;
use openpgp::policy::StandardPolicy;
use openpgp::types::{RevocationStatus, ReasonForRevocation, SignatureType};

let p = &StandardPolicy::new();

// A certificate with a User ID.
let (cert, _) = CertBuilder::new()
    .add_userid("Alice <alice@example.org>")
    .generate()?;

let mut keypair = cert.primary_key().key().clone()
    .parts_into_secret()?.into_keypair()?;
let ca = cert.userids().nth(0).unwrap();

// Generate the revocation for the first and only UserID.
let revocation =
    UserIDRevocationBuilder::new()
    .set_reason_for_revocation(
        ReasonForRevocation::UIDRetired,
        b"Left example.org.")?
    .build(&mut keypair, &cert, ca.userid(), None)?;
assert_eq!(revocation.typ(), SignatureType::CertificationRevocation);

// Now merge the revocation signature into the Cert.
let cert = cert.insert_packets(revocation.clone())?;

// Check that it is revoked.
let ca = cert.userids().nth(0).unwrap();
let status = ca.with_policy(p, None)?.revocation_status();
if let RevocationStatus::Revoked(revs) = status {
    assert_eq!(revs.len(), 1);
    let rev = revs[0];

    assert_eq!(rev.typ(), SignatureType::CertificationRevocation);
    assert_eq!(rev.reason_for_revocation(),
               Some((ReasonForRevocation::UIDRetired,
                     "Left example.org.".as_bytes())));
   // User ID has been revoked.
}

Variants

Unspecified

No reason specified (key revocations or cert revocations)

KeySuperseded

Key is superseded (key revocations)

KeyCompromised

Key material has been compromised (key revocations)

KeyRetired

Key is retired and no longer used (key revocations)

UIDRetired

User ID information is no longer valid (cert revocations)

Private(u8)

Private reason identifier.

Unknown(u8)

Unknown reason identifier.

Implementations

impl ReasonForRevocation[src]

pub fn revocation_type(&self) -> RevocationType[src]

Returns the revocation's RevocationType.

Examples

use sequoia_openpgp as openpgp;
use openpgp::types::{ReasonForRevocation, RevocationType};

assert_eq!(ReasonForRevocation::KeyCompromised.revocation_type(), RevocationType::Hard);
assert_eq!(ReasonForRevocation::Private(101).revocation_type(), RevocationType::Hard);

assert_eq!(ReasonForRevocation::KeyRetired.revocation_type(), RevocationType::Soft);

Trait Implementations

impl Clone for ReasonForRevocation[src]

impl Copy for ReasonForRevocation[src]

impl Debug for ReasonForRevocation[src]

impl Display for ReasonForRevocation[src]

impl Eq for ReasonForRevocation[src]

impl From<ReasonForRevocation> for u8[src]

impl From<u8> for ReasonForRevocation[src]

impl Hash for ReasonForRevocation[src]

impl Ord for ReasonForRevocation[src]

impl PartialEq<ReasonForRevocation> for ReasonForRevocation[src]

impl PartialOrd<ReasonForRevocation> for ReasonForRevocation[src]

impl StructuralEq for ReasonForRevocation[src]

impl StructuralPartialEq for ReasonForRevocation[src]

Auto Trait Implementations

Blanket Implementations

impl<T> Any for T where
    T: 'static + ?Sized
[src]

impl<T> Borrow<T> for T where
    T: ?Sized
[src]

impl<T> BorrowMut<T> for T where
    T: ?Sized
[src]

impl<T> DynClone for T where
    T: Clone
[src]

impl<T> From<T> for T[src]

impl<T, U> Into<U> for T where
    U: From<T>, 
[src]

impl<T> ToOwned for T where
    T: Clone
[src]

type Owned = T

The resulting type after obtaining ownership.

impl<T> ToString for T where
    T: Display + ?Sized
[src]

impl<T, U> TryFrom<U> for T where
    U: Into<T>, 
[src]

type Error = Infallible

The type returned in the event of a conversion error.

impl<T, U> TryInto<U> for T where
    U: TryFrom<T>, 
[src]

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.