Enum Packet 

#[non_exhaustive]
pub enum Packet {
    Unknown(Unknown),
    Signature(Signature),
    OnePassSig(OnePassSig),
    PublicKey(Key<PublicParts, PrimaryRole>),
    PublicSubkey(Key<PublicParts, SubordinateRole>),
    SecretKey(Key<SecretParts, PrimaryRole>),
    SecretSubkey(Key<SecretParts, SubordinateRole>),
    Marker(Marker),
    Trust(Trust),
    UserID(UserID),
    UserAttribute(UserAttribute),
    Literal(Literal),
    CompressedData(CompressedData),
    PKESK(PKESK),
    SKESK(SKESK),
    SEIP(SEIP),
    MDC(MDC),
    Padding(Padding),
}

Enumeration of packet types.

The different OpenPGP packets are detailed in Section 5 of RFC 9580.

The Unknown packet allows Sequoia to deal with packets that it doesn’t understand. It is basically a binary blob that includes the packet’s tag. See the module-level documentation for details.

A note on equality

We define equality on Packet as the equality of the serialized form of their packet bodies as defined by RFC 9580. That is, two packets are considered equal if and only if their serialized forms are equal, modulo the OpenPGP framing (CTB and length style, potential partial body encoding).

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.

Unknown(Unknown)

Unknown packet.

Signature(Signature)

Signature packet.

OnePassSig(OnePassSig)

One pass signature packet.

PublicKey(Key<PublicParts, PrimaryRole>)

Public key packet.

PublicSubkey(Key<PublicParts, SubordinateRole>)

Public subkey packet.

SecretKey(Key<SecretParts, PrimaryRole>)

Public/Secret key pair.

SecretSubkey(Key<SecretParts, SubordinateRole>)

Public/Secret subkey pair.

Marker(Marker)

Marker packet.

Trust(Trust)

Trust packet.

UserID(UserID)

User ID packet.

UserAttribute(UserAttribute)

User attribute packet.

Literal(Literal)

Literal data packet.

CompressedData(CompressedData)

Compressed literal data packet.

PKESK(PKESK)

Public key encrypted data packet.

SKESK(SKESK)

Symmetric key encrypted data packet.

SEIP(SEIP)

Symmetric key encrypted, integrity protected data packet.

MDC(MDC)

👎Deprecated

Modification detection code packet.

Padding(Padding)

Padding packet.

Implementations

impl Packet

pub fn tag(&self) -> Tag

Returns the Packet's corresponding OpenPGP tag.

Tags are explained in Section 5 of RFC 9580.

pub fn kind(&self) -> Option<Tag>

Returns the parsed Packet's corresponding OpenPGP tag.

Returns the packets tag, but only if it was successfully parsed into the corresponding packet type. If e.g. a Signature Packet uses some unsupported methods, it is parsed into an Packet::Unknown. tag() returns Tag::Signature, whereas kind() returns None.

pub fn is_critical(&self) -> bool

Returns whether this is a critical packet.

Upon encountering an unknown critical packet, implementations MUST reject the whole packet sequence. On the other hand, unknown non-critical packets MUST be ignored. See Section 4.3 of RFC 9580.

pub fn version(&self) -> Option<u8>

Returns the Packet's version, if the packet is versioned and recognized.

If the packet is not versioned, or we couldn’t parse the packet, this function returns None.

pub fn normalized_hash<H>(&self, state: &mut H)

where H: Hasher,

Hashes most everything into state.

This is an alternate implementation of Hash, which does not hash:

• The unhashed subpacket area of Signature packets.
• Secret key material.

Unlike Signature::normalize, this method ignores authenticated packets in the unhashed subpacket area.

Trait Implementations

impl Any<CompressedData> for Packet

fn downcast(self) -> Result<CompressedData, Packet>

Attempts to downcast to T, returning the packet if it fails.

fn downcast_ref(&self) -> Option<&CompressedData>

Attempts to downcast to &T, returning None if it fails.

fn downcast_mut(&mut self) -> Option<&mut CompressedData>

Attempts to downcast to &mut T, returning None if it fails.

impl Any<Key<PublicParts, PrimaryRole>> for Packet

fn downcast(self) -> Result<Key<PublicParts, PrimaryRole>, Packet>

Attempts to downcast to T, returning the packet if it fails.

fn downcast_ref(&self) -> Option<&Key<PublicParts, PrimaryRole>>

Attempts to downcast to &T, returning None if it fails.

fn downcast_mut(&mut self) -> Option<&mut Key<PublicParts, PrimaryRole>>

Attempts to downcast to &mut T, returning None if it fails.

impl Any<Key<PublicParts, SubordinateRole>> for Packet

fn downcast(self) -> Result<Key<PublicParts, SubordinateRole>, Packet>

Attempts to downcast to T, returning the packet if it fails.

fn downcast_ref(&self) -> Option<&Key<PublicParts, SubordinateRole>>

Attempts to downcast to &T, returning None if it fails.

fn downcast_mut(&mut self) -> Option<&mut Key<PublicParts, SubordinateRole>>

Attempts to downcast to &mut T, returning None if it fails.

impl Any<Key<PublicParts, UnspecifiedRole>> for Packet

fn downcast(self) -> Result<Key<PublicParts, UnspecifiedRole>, Packet>

Attempts to downcast to T, returning the packet if it fails.

fn downcast_ref(&self) -> Option<&Key<PublicParts, UnspecifiedRole>>

Attempts to downcast to &T, returning None if it fails.

fn downcast_mut(&mut self) -> Option<&mut Key<PublicParts, UnspecifiedRole>>

Attempts to downcast to &mut T, returning None if it fails.

impl Any<Key<SecretParts, PrimaryRole>> for Packet

fn downcast(self) -> Result<Key<SecretParts, PrimaryRole>, Packet>

Attempts to downcast to T, returning the packet if it fails.

fn downcast_ref(&self) -> Option<&Key<SecretParts, PrimaryRole>>

Attempts to downcast to &T, returning None if it fails.

fn downcast_mut(&mut self) -> Option<&mut Key<SecretParts, PrimaryRole>>

Attempts to downcast to &mut T, returning None if it fails.

impl Any<Key<SecretParts, SubordinateRole>> for Packet

fn downcast(self) -> Result<Key<SecretParts, SubordinateRole>, Packet>

Attempts to downcast to T, returning the packet if it fails.

fn downcast_ref(&self) -> Option<&Key<SecretParts, SubordinateRole>>

Attempts to downcast to &T, returning None if it fails.

fn downcast_mut(&mut self) -> Option<&mut Key<SecretParts, SubordinateRole>>

Attempts to downcast to &mut T, returning None if it fails.

impl Any<Key<SecretParts, UnspecifiedRole>> for Packet

fn downcast(self) -> Result<Key<SecretParts, UnspecifiedRole>, Packet>

Attempts to downcast to T, returning the packet if it fails.

fn downcast_ref(&self) -> Option<&Key<SecretParts, UnspecifiedRole>>

Attempts to downcast to &T, returning None if it fails.

fn downcast_mut(&mut self) -> Option<&mut Key<SecretParts, UnspecifiedRole>>

Attempts to downcast to &mut T, returning None if it fails.

impl Any<Key<UnspecifiedParts, PrimaryRole>> for Packet

fn downcast(self) -> Result<Key<UnspecifiedParts, PrimaryRole>, Packet>

Attempts to downcast to T, returning the packet if it fails.

fn downcast_ref(&self) -> Option<&Key<UnspecifiedParts, PrimaryRole>>

Attempts to downcast to &T, returning None if it fails.

fn downcast_mut(&mut self) -> Option<&mut Key<UnspecifiedParts, PrimaryRole>>

Attempts to downcast to &mut T, returning None if it fails.

impl Any<Key<UnspecifiedParts, SubordinateRole>> for Packet

fn downcast(self) -> Result<Key<UnspecifiedParts, SubordinateRole>, Packet>

Attempts to downcast to T, returning the packet if it fails.

fn downcast_ref(&self) -> Option<&Key<UnspecifiedParts, SubordinateRole>>

Attempts to downcast to &T, returning None if it fails.

fn downcast_mut( &mut self, ) -> Option<&mut Key<UnspecifiedParts, SubordinateRole>>

Attempts to downcast to &mut T, returning None if it fails.

impl Any<Key<UnspecifiedParts, UnspecifiedRole>> for Packet

fn downcast(self) -> Result<Key<UnspecifiedParts, UnspecifiedRole>, Packet>

Attempts to downcast to T, returning the packet if it fails.

fn downcast_ref(&self) -> Option<&Key<UnspecifiedParts, UnspecifiedRole>>

Attempts to downcast to &T, returning None if it fails.

fn downcast_mut( &mut self, ) -> Option<&mut Key<UnspecifiedParts, UnspecifiedRole>>

Attempts to downcast to &mut T, returning None if it fails.

impl Any<Literal> for Packet

fn downcast(self) -> Result<Literal, Packet>

Attempts to downcast to T, returning the packet if it fails.

fn downcast_ref(&self) -> Option<&Literal>

Attempts to downcast to &T, returning None if it fails.

fn downcast_mut(&mut self) -> Option<&mut Literal>

Attempts to downcast to &mut T, returning None if it fails.

impl Any<MDC> for Packet

fn downcast(self) -> Result<MDC, Packet>

Attempts to downcast to T, returning the packet if it fails.

fn downcast_ref(&self) -> Option<&MDC>

Attempts to downcast to &T, returning None if it fails.

fn downcast_mut(&mut self) -> Option<&mut MDC>

Attempts to downcast to &mut T, returning None if it fails.

impl Any<Marker> for Packet

fn downcast(self) -> Result<Marker, Packet>

Attempts to downcast to T, returning the packet if it fails.

fn downcast_ref(&self) -> Option<&Marker>

Attempts to downcast to &T, returning None if it fails.

fn downcast_mut(&mut self) -> Option<&mut Marker>

Attempts to downcast to &mut T, returning None if it fails.

impl Any<OnePassSig> for Packet

fn downcast(self) -> Result<OnePassSig, Packet>

Attempts to downcast to T, returning the packet if it fails.

fn downcast_ref(&self) -> Option<&OnePassSig>

Attempts to downcast to &T, returning None if it fails.

fn downcast_mut(&mut self) -> Option<&mut OnePassSig>

Attempts to downcast to &mut T, returning None if it fails.

impl Any<PKESK> for Packet

fn downcast(self) -> Result<PKESK, Packet>

Attempts to downcast to T, returning the packet if it fails.

fn downcast_ref(&self) -> Option<&PKESK>

Attempts to downcast to &T, returning None if it fails.

fn downcast_mut(&mut self) -> Option<&mut PKESK>

Attempts to downcast to &mut T, returning None if it fails.

impl Any<Padding> for Packet

fn downcast(self) -> Result<Padding, Packet>

Attempts to downcast to T, returning the packet if it fails.

fn downcast_ref(&self) -> Option<&Padding>

Attempts to downcast to &T, returning None if it fails.

fn downcast_mut(&mut self) -> Option<&mut Padding>

Attempts to downcast to &mut T, returning None if it fails.

impl Any<SEIP> for Packet

fn downcast(self) -> Result<SEIP, Packet>

Attempts to downcast to T, returning the packet if it fails.

fn downcast_ref(&self) -> Option<&SEIP>

Attempts to downcast to &T, returning None if it fails.

fn downcast_mut(&mut self) -> Option<&mut SEIP>

Attempts to downcast to &mut T, returning None if it fails.

impl Any<SKESK> for Packet

fn downcast(self) -> Result<SKESK, Packet>

Attempts to downcast to T, returning the packet if it fails.

fn downcast_ref(&self) -> Option<&SKESK>

Attempts to downcast to &T, returning None if it fails.

fn downcast_mut(&mut self) -> Option<&mut SKESK>

Attempts to downcast to &mut T, returning None if it fails.

impl Any<Signature> for Packet

fn downcast(self) -> Result<Signature, Packet>

Attempts to downcast to T, returning the packet if it fails.

fn downcast_ref(&self) -> Option<&Signature>

Attempts to downcast to &T, returning None if it fails.

fn downcast_mut(&mut self) -> Option<&mut Signature>

Attempts to downcast to &mut T, returning None if it fails.

impl Any<Trust> for Packet

fn downcast(self) -> Result<Trust, Packet>

Attempts to downcast to T, returning the packet if it fails.

fn downcast_ref(&self) -> Option<&Trust>

Attempts to downcast to &T, returning None if it fails.

fn downcast_mut(&mut self) -> Option<&mut Trust>

Attempts to downcast to &mut T, returning None if it fails.

impl Any<Unknown> for Packet

fn downcast(self) -> Result<Unknown, Packet>

Attempts to downcast to T, returning the packet if it fails.

fn downcast_ref(&self) -> Option<&Unknown>

Attempts to downcast to &T, returning None if it fails.

fn downcast_mut(&mut self) -> Option<&mut Unknown>

Attempts to downcast to &mut T, returning None if it fails.

impl Any<UserAttribute> for Packet

fn downcast(self) -> Result<UserAttribute, Packet>

Attempts to downcast to T, returning the packet if it fails.

fn downcast_ref(&self) -> Option<&UserAttribute>

Attempts to downcast to &T, returning None if it fails.

fn downcast_mut(&mut self) -> Option<&mut UserAttribute>

Attempts to downcast to &mut T, returning None if it fails.

impl Any<UserID> for Packet

fn downcast(self) -> Result<UserID, Packet>

Attempts to downcast to T, returning the packet if it fails.

fn downcast_ref(&self) -> Option<&UserID>

Attempts to downcast to &T, returning None if it fails.

fn downcast_mut(&mut self) -> Option<&mut UserID>

Attempts to downcast to &mut T, returning None if it fails.

impl Clone for Packet

fn clone(&self) -> Packet

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Packet

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

Formats the value using the given formatter.

impl Eq for Packet

impl From<&Packet> for Tag

fn from(p: &Packet) -> Tag

Converts to this type from the input type.

impl From<CompressedData> for Packet

fn from(s: CompressedData) -> Packet

Converts to this type from the input type.

impl From<Key<PublicParts, PrimaryRole>> for Packet

fn from(k: Key<PublicParts, PrimaryRole>) -> Packet

Convert the Key struct to a Packet.

impl From<Key<PublicParts, SubordinateRole>> for Packet

fn from(k: Key<PublicParts, SubordinateRole>) -> Packet

Convert the Key struct to a Packet.

impl From<Key<SecretParts, PrimaryRole>> for Packet

fn from(k: Key<SecretParts, PrimaryRole>) -> Packet

Convert the Key struct to a Packet.

impl From<Key<SecretParts, SubordinateRole>> for Packet

fn from(k: Key<SecretParts, SubordinateRole>) -> Packet

Convert the Key struct to a Packet.

impl From<Literal> for Packet

fn from(s: Literal) -> Packet

Converts to this type from the input type.

impl From<MDC> for Packet

fn from(s: MDC) -> Packet

Converts to this type from the input type.

impl From<Marker> for Packet

fn from(p: Marker) -> Packet

Converts to this type from the input type.

impl From<OnePassSig3> for Packet

fn from(p: OnePassSig3) -> Packet

Converts to this type from the input type.

impl From<OnePassSig6> for Packet

fn from(p: OnePassSig6) -> Packet

Converts to this type from the input type.

impl From<OnePassSig> for Packet

fn from(s: OnePassSig) -> Packet

Converts to this type from the input type.

impl From<PKESK3> for Packet

fn from(p: PKESK3) -> Packet

Converts to this type from the input type.

impl From<PKESK6> for Packet

fn from(p: PKESK6) -> Packet

Converts to this type from the input type.

impl From<PKESK> for Packet

fn from(p: PKESK) -> Packet

Converts to this type from the input type.

impl From<Packet> for Tag

fn from(p: Packet) -> Tag

Converts to this type from the input type.

impl From<Packet> for Result<Packet, Error>

fn from(p: Packet) -> Result<Packet, Error>

Converts to this type from the input type.

impl From<Packet> for PacketPile

fn from(p: Packet) -> PacketPile

Converts to this type from the input type.

impl From<Padding> for Packet

fn from(s: Padding) -> Packet

Converts to this type from the input type.

impl From<SEIP1> for Packet

fn from(s: SEIP1) -> Packet

Converts to this type from the input type.

impl From<SEIP2> for Packet

fn from(s: SEIP2) -> Packet

Converts to this type from the input type.

impl From<SEIP> for Packet

fn from(p: SEIP) -> Packet

Converts to this type from the input type.

impl From<SKESK4> for Packet

fn from(s: SKESK4) -> Packet

Converts to this type from the input type.

impl From<SKESK6> for Packet

fn from(s: SKESK6) -> Packet

Converts to this type from the input type.

impl From<SKESK> for Packet

fn from(p: SKESK) -> Packet

Converts to this type from the input type.

impl From<Signature3> for Packet

fn from(s: Signature3) -> Packet

Converts to this type from the input type.

impl From<Signature4> for Packet

fn from(s: Signature4) -> Packet

Converts to this type from the input type.

impl From<Signature6> for Packet

fn from(s: Signature6) -> Packet

Converts to this type from the input type.

impl From<Signature> for Packet

fn from(s: Signature) -> Packet

Converts to this type from the input type.

impl From<Trust> for Packet

fn from(s: Trust) -> Packet

Converts to this type from the input type.

impl From<Unknown> for Packet

fn from(s: Unknown) -> Packet

Converts to this type from the input type.

impl From<UserAttribute> for Packet

fn from(s: UserAttribute) -> Packet

Converts to this type from the input type.

impl From<UserID> for Packet

fn from(s: UserID) -> Packet

Converts to this type from the input type.

impl FromIterator<Packet> for PacketPile

fn from_iter<I>(iter: I) -> PacketPile

where I: IntoIterator<Item = Packet>,

Creates a value from an iterator.

impl Hash for Packet

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl IntoIterator for Packet

Implement IntoIterator so that cert::insert_packets(sig) just works.

type Item = Packet

The type of the elements being iterated over.

type IntoIter = Once<Packet>

Which kind of iterator are we turning this into?

fn into_iter(self) -> <Packet as IntoIterator>::IntoIter

Creates an iterator from a value.

impl Marshal for Packet

fn serialize(&self, o: &mut dyn Write) -> Result<(), Error>

Writes a serialized version of the specified Packet to o.

This function works recursively: if the packet contains any packets, they are also serialized.

fn export(&self, o: &mut dyn Write) -> Result<(), Error>

Exports a serialized version of the specified Packet to o.

This function works recursively: if the packet contains any packets, they are also serialized.

impl MarshalInto for Packet

fn serialized_len(&self) -> usize

Computes the maximal length of the serialized representation.

fn serialize_into(&self, buf: &mut [u8]) -> Result<usize, Error>

Serializes into the given buffer.

fn export_into(&self, buf: &mut [u8]) -> Result<usize, Error>

Exports into the given buffer.

fn to_vec(&self) -> Result<Vec<u8>, Error>

Serializes the packet to a vector.

fn export_to_vec(&self) -> Result<Vec<u8>, Error>

Exports to a vector.

impl<'a> Parse<'a, Packet> for Packet

fn from_buffered_reader<R>(reader: R) -> Result<Packet, Error>

where R: BufferedReader<Cookie> + 'a,

Reads from the given buffered reader.

fn from_reader<R>(reader: R) -> Result<T, Error>

where R: 'a + Read + Send + Sync,

Reads from the given reader.

fn from_file<P>(path: P) -> Result<T, Error>

where P: AsRef<Path>,

Reads from the given file.

fn from_bytes<D>(data: &'a D) -> Result<T, Error>

where D: AsRef<[u8]> + Send + Sync + ?Sized,

Reads from the given slice.

impl PartialEq for Packet

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Packet

fn serialize(&self, o: &mut dyn Write) -> Result<(), Error>

Writes a serialized version of the object to o.

fn export(&self, o: &mut dyn Write) -> Result<(), Error>

Exports a serialized version of the object to o.

impl SerializeInto for Packet

fn serialized_len(&self) -> usize

Computes the maximal length of the serialized representation.

fn serialize_into(&self, buf: &mut [u8]) -> Result<usize, Error>

Serializes into the given buffer.

fn to_vec(&self) -> Result<Vec<u8>, Error>

Serializes the packet to a vector.

fn export_into(&self, buf: &mut [u8]) -> Result<usize, Error>

Exports into the given buffer.

fn export_to_vec(&self) -> Result<Vec<u8>, Error>

Exports to a vector.

impl StructuralPartialEq for Packet

impl TryFrom<Packet> for Unknown

fn try_from(p: Packet) -> Result<Unknown, <Unknown as TryFrom<Packet>>::Error>

Tries to convert a packet to an Unknown. Returns an error if the given packet is a container packet (i.e. a compressed data packet or an encrypted data packet of any kind).

type Error = Error

The type returned in the event of a conversion error.

impl TryFrom<Packet> for Cert

type Error = Error

The type returned in the event of a conversion error.

fn try_from(p: Packet) -> Result<Cert, Error>

Performs the conversion.

impl<'a> TryFrom<RawPacket<'a>> for Packet

type Error = Error

The type returned in the event of a conversion error.

fn try_from(p: RawPacket<'a>) -> Result<Packet, Error>

Performs the conversion.