Struct sequoia_openpgp::packet::Unknown

pub struct Unknown { /* fields omitted */ }

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.

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

pub fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Unknown

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

Formats the value using the given formatter.

impl Eq for Unknown

impl From<Unknown> for Packet

pub fn from(s: Unknown) -> Self

Performs the conversion.

impl Hash for Unknown

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

Feeds this value into the given Hasher.

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

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?

pub fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl Marshal for Unknown

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

Writes a serialized version of the object to o.

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

Exports a serialized version of the object to o.

impl MarshalInto for Unknown

pub fn serialized_len(&self) -> usize

Computes the maximal length of the serialized representation.

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

Serializes into the given buffer.

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

Serializes the packet to a vector.

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

Exports into the given buffer.

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

Exports to a vector.

impl PartialEq<Unknown> for Unknown

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

This method tests for self and other values to be equal, and is used by ==.

#[must_use]pub fn ne(&self, other: &Rhs) -> bool

This method tests for !=.