Struct sequoia_openpgp::cert::components::ValidKeyAmalgamation

pub struct ValidKeyAmalgamation<'a, P: KeyParts> { /* fields omitted */ }

A Key and its associated data.

A ValidKeyAmalgamation includes a reference time, and is guaranteed to have a live binding signature at that time.

Methods

impl<'a, P: 'a + KeyParts> ValidKeyAmalgamation<'a, P>

pub fn bundle(&self) -> &'a KeyBundle<P, UnspecifiedRole> where
    &'a KeyBundle<P, UnspecifiedRole>: From<&'a KeyBundle<PublicParts, PrimaryRole>>, 

Returns this key's bundle.

pub fn alive(&self) -> Result<()>

Returns whether the key is alive as of the amalgamtion's reference time.

Note: this does not return whether the certificate is valid.

Considers both the binding signature and the direct key signature. Information in the binding signature takes precedence over the direct key signature. See also Section 5.2.3.3 of RFC 4880.

pub fn has_secret(&self) -> bool

Returns whether the key contains secret key material.

pub fn has_unencrypted_secret(&self) -> bool

Returns whether the key contains unencrypted secret key material.

Methods from Deref<Target = KeyAmalgamation<'a, P>>

pub fn key(&self) -> &'a Key<P, UnspecifiedRole> where
    &'a Key<P, UnspecifiedRole>: From<&'a Key<PublicParts, PrimaryRole>>, 

Returns the key.

pub fn cert(&self) -> &'a Cert

Returns the certificate that the key came from.

pub fn has_secret(&self) -> bool

Returns whether the key contains secret key material.

pub fn has_unencrypted_secret(&self) -> bool

Returns whether the key contains unencrypted secret key material.

pub fn bundle(&self) -> &'a KeyBundle<P, UnspecifiedRole> where
    &'a KeyBundle<P, UnspecifiedRole>: From<&'a KeyBundle<PublicParts, PrimaryRole>>, 

Returns this key's bundle.

Trait Implementations

impl<'a, P: 'a + KeyParts> Amalgamation<'a> for ValidKeyAmalgamation<'a, P>

fn cert(&self) -> &'a Cert

Returns the certificate that the component came from.

fn time(&self) -> SystemTime

Returns the amalgamation's reference time.

For queries that are with respect to a point in time, this determines that point in time. For instance, if a key is created at t_c and expires at t_e, then ValidKeyAmalgamation::alive will return true if the reference time is greater than or equal to t_c and less than t_e.

fn policy(&self) -> &'a dyn Policy

Returns the amalgamation's policy.

fn with_policy<T>(self, policy: &'a dyn Policy, time: T) -> Result<Self> where
    T: Into<Option<SystemTime>>, 

Changes the amalgamation's policy.

If time is None, the current time is used.

fn binding_signature(&self) -> &'a Signature

Returns the key's binding signature as of the reference time, if any.

fn direct_key_signature(&self) -> Option<&'a Signature>

Returns the Certificate's direct key signature as of the reference time, if any.

Subpackets on direct key signatures apply to all components of the certificate.

fn revoked(&self) -> RevocationStatus<'a>

Returns the key's revocation status as of the amalgamation's reference time.

Note: this function only returns whether the key has been revoked, it does not return whether the certificate has been revoked.

fn cert_revoked(&self) -> RevocationStatus<'a>

Returns the certificate's revocation status as of the amalgamtion's reference time.

fn cert_alive(&self) -> Result<()>

Returns whether the certificateis alive as of the amalgamtion's reference time.

fn map<F: Fn(&'a Signature) -> Option<T>, T>(&self, f: F) -> Option<T>

Maps the given function over binding and direct key signature.

fn key_flags(&self) -> Option<KeyFlags>

Returns the key's key flags as of the amalgamtion's reference time.

fn has_any_key_flag<F>(&self, flags: F) -> bool where
    F: Borrow<KeyFlags>, 

Returns whether the key has at least one of the specified key flags as of the amalgamtion's reference time.

fn for_certification(&self) -> bool

Returns whether key is certification capable as of the amalgamtion's reference time.

fn for_signing(&self) -> bool

Returns whether key is signing capable as of the amalgamtion's reference time.

fn for_authentication(&self) -> bool

Returns whether key is authentication capable as of the amalgamtion's reference time.

fn for_storage_encryption(&self) -> bool

Returns whether key is intended for storage encryption as of the amalgamtion's reference time.

fn for_transport_encryption(&self) -> bool

Returns whether key is intended for transport encryption as of the amalgamtion's reference time.

fn key_expiration_time(&self) -> Option<Duration>

Returns the key's expiration time as of the amalgamtion's reference time.

fn revocation_key(&self) -> Option<(u8, PublicKeyAlgorithm, Fingerprint)>

Returns the value of the Revocation Key subpacket, which contains a designated revoker.

impl<'a, P: Clone + KeyParts> Clone for ValidKeyAmalgamation<'a, P>

fn clone(&self) -> ValidKeyAmalgamation<'a, P>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a, P: Debug + KeyParts> Debug for ValidKeyAmalgamation<'a, P>

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

Formats the value using the given formatter.

impl<'a, P: KeyParts> Deref for ValidKeyAmalgamation<'a, P>

type Target = KeyAmalgamation<'a, P>

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<'a, P: KeyParts> From<ValidKeyAmalgamation<'a, P>> for KeyAmalgamation<'a, P>

fn from(vka: ValidKeyAmalgamation<'a, P>) -> Self

Performs the conversion.

impl<'a> From<ValidKeyAmalgamation<'a, PublicParts>> for ValidKeyAmalgamation<'a, UnspecifiedParts>

fn from(ka: ValidKeyAmalgamation<'a, PublicParts>) -> Self

Performs the conversion.

impl<'a> From<ValidKeyAmalgamation<'a, SecretParts>> for ValidKeyAmalgamation<'a, PublicParts>

fn from(ka: ValidKeyAmalgamation<'a, SecretParts>) -> Self

Performs the conversion.

impl<'a, P> From<ValidPrimaryKeyAmalgamation<'a, P>> for ValidKeyAmalgamation<'a, P> where
    P: KeyParts, 

fn from(a: ValidPrimaryKeyAmalgamation<'a, P>) -> Self

Performs the conversion.

impl<'a> TryFrom<ValidKeyAmalgamation<'a, PublicParts>> for ValidKeyAmalgamation<'a, SecretParts>

type Error = Error

The type returned in the event of a conversion error.

fn try_from(ka: ValidKeyAmalgamation<'a, PublicParts>) -> Result<Self>

Performs the conversion.