Struct Unknown

pub struct Unknown { /* private fields */ }

Holds an unknown packet.

This is used by the parser to hold packets that it doesn’t know how to process rather than abort.

This packet effectively holds a binary blob.

A note on equality

Two Unknown packets are considered equal if their tags and their bodies are equal.

Implementations

impl Unknown

pub fn new(tag: Tag, error: Error) -> Self

Returns a new Unknown packet.

pub fn hash_algo_security(&self) -> HashAlgoSecurity

The security requirements of the hash algorithm for self-signatures.

A cryptographic hash algorithm usually has three security properties: pre-image resistance, second pre-image resistance, and collision resistance. If an attacker can influence the signed data, then the hash algorithm needs to have both second pre-image resistance, and collision resistance. If not, second pre-image resistance is sufficient.

In general, an attacker may be able to influence third-party signatures. But direct key signatures, and binding signatures are only over data fully determined by signer. And, an attacker’s control over self signatures over User IDs is limited due to their structure.

These observations can be used to extend the life of a hash algorithm after its collision resistance has been partially compromised, but not completely broken. For more details, please refer to the documentation for HashAlgoSecurity.

pub fn tag(&self) -> Tag

Gets the unknown packet’s tag.

pub fn set_tag(&mut self, tag: Tag) -> Tag

Sets the unknown packet’s tag.

pub fn error(&self) -> &Error

Gets the unknown packet’s error.

This is the error that caused parsing or processing to abort.

pub fn set_error(&mut self, error: Error) -> Error

Sets the unknown packet’s error.

This is the error that caused parsing or processing to abort.

pub fn into_error(self) -> Error

Returns the error.

impl Unknown

This packet implements the unprocessed container interface.

Container packets like this one can contain unprocessed data.

pub fn body(&self) -> &[u8]

Gets a reference to the this packet’s body.

pub fn set_body(&mut self, data: Vec<u8>) -> Vec<u8>

Sets the this packet’s body.

Trait Implementations

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 Clone for Unknown

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Unknown

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

Formats the value using the given formatter.

impl From<Unknown> for Packet

fn from(s: Unknown) -> Self

Converts to this type from the input type.

impl Hash for Unknown

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

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 Unknown

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

type Item = Unknown

The type of the elements being iterated over.

type IntoIter = Once<Unknown>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl Marshal for Unknown

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

Writes a serialized version of the object to o.

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

Exports a serialized version of the object to o.

impl MarshalInto for Unknown

fn serialized_len(&self) -> usize

Computes the maximal length of the serialized representation.

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

Serializes into the given buffer.

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

Serializes the packet to a vector.

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

Exports into the given buffer.

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

Exports to a vector.

impl PartialEq for Unknown

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl TryFrom<Packet> for Unknown

fn try_from(p: Packet) -> Result<Self, Self::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 Eq for Unknown