Struct Document 

pub struct Document { /* private fields */ }

Available on crate feature alloc only.

ASN.1 DER-encoded document.

This type wraps an encoded ASN.1 DER message. The document checked to ensure it contains a valid DER-encoded SEQUENCE.

It implements common functionality related to encoding/decoding such documents, such as PEM encapsulation as well as reading/writing documents from/to the filesystem.

The SecretDocument provides a wrapper for this type with additional hardening applied.

Implementations

impl Document

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

Get the ASN.1 DER-encoded bytes of this document.

pub fn into_secret(self) -> SecretDocument

Convert to a SecretDocument.

pub fn into_vec(self) -> Vec<u8>

Convert to an ASN.1 DER-encoded byte vector.

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

Return an ASN.1 DER-encoded byte vector.

pub fn len(&self) -> Length

Get the length of the encoded ASN.1 DER in bytes.

pub fn decode_msg<'a, T>(&'a self) -> Result<T, Error>

where T: Decode<'a>,

Try to decode the inner ASN.1 DER message contained in this Document as the given type.

pub fn encode_msg<T>(msg: &T) -> Result<Document, Error>

where T: Encode,

Encode the provided type as ASN.1 DER, storing the resulting encoded DER as a Document.

pub fn from_pem(pem: &str) -> Result<(&str, Document), Error>

Decode ASN.1 DER document from PEM.

Returns the PEM label and decoded Document on success.

pub fn to_pem( &self, label: &'static str, line_ending: LineEnding, ) -> Result<String, Error>

Encode ASN.1 DER document as a PEM string with encapsulation boundaries containing the provided PEM type label (e.g. CERTIFICATE).

pub fn read_der_file(path: impl AsRef<Path>) -> Result<Document, Error>

Read ASN.1 DER document from a file.

pub fn write_der_file(&self, path: impl AsRef<Path>) -> Result<(), Error>

Write ASN.1 DER document to a file.

pub fn read_pem_file( path: impl AsRef<Path>, ) -> Result<(String, Document), Error>

Read PEM-encoded ASN.1 DER document from a file.

pub fn write_pem_file( &self, path: impl AsRef<Path>, label: &'static str, line_ending: LineEnding, ) -> Result<(), Error>

Write PEM-encoded ASN.1 DER document to a file.

Trait Implementations

impl AsRef<[u8]> for Document

fn as_ref(&self) -> &[u8]

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for Document

fn clone(&self) -> Document

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Document

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

Formats the value using the given formatter.

impl<'a> Decode<'a> for Document

fn decode<R>(reader: &mut R) -> Result<Document, Error>

where R: Reader<'a>,

Attempt to decode this message using the provided decoder.

fn from_der(bytes: &'a [u8]) -> Result<Self, Error>

Parse Self from the provided DER-encoded byte slice.

impl Encode for Document

fn encoded_len(&self) -> Result<Length, Error>

Compute the length of this value in bytes when encoded as ASN.1 DER.

fn encode(&self, writer: &mut impl Writer) -> Result<(), Error>

Encode this value as ASN.1 DER using the provided Writer.

fn encode_to_slice<'a>(&self, buf: &'a mut [u8]) -> Result<&'a [u8], Error>

Encode this value to the provided byte slice, returning a sub-slice containing the encoded message.

fn encode_to_vec(&self, buf: &mut Vec<u8>) -> Result<Length, Error>

Encode this message as ASN.1 DER, appending it to the provided byte vector.

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

Encode this type as DER, returning a byte vector.

impl FixedTag for Document

const TAG: Tag = Tag::Sequence

ASN.1 tag

impl From<Document> for SecretDocument

fn from(doc: Document) -> SecretDocument

Converts to this type from the input type.

impl PartialEq for Document

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

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

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<&[u8]> for Document

type Error = Error

The type returned in the event of a conversion error.

fn try_from(der_bytes: &[u8]) -> Result<Document, Error>

Performs the conversion.

impl<'a, 'k, Params, Key> TryFrom<&SubjectPublicKeyInfo<Params, Key>> for Document

where 'a: 'k, Key: 'k + Decode<'a> + Encode + FixedTag, Params: Choice<'a> + Encode, BitStringRef<'a>: From<&'k Key>,

type Error = Error

The type returned in the event of a conversion error.

fn try_from(spki: &SubjectPublicKeyInfo<Params, Key>) -> Result<Document, Error>

Performs the conversion.

impl<'a, 'k, Params, Key> TryFrom<SubjectPublicKeyInfo<Params, Key>> for Document

where 'a: 'k, Key: 'k + Decode<'a> + Encode + FixedTag, Params: Choice<'a> + Encode, BitStringRef<'a>: From<&'k Key>,

type Error = Error

The type returned in the event of a conversion error.

fn try_from(spki: SubjectPublicKeyInfo<Params, Key>) -> Result<Document, Error>

Performs the conversion.

impl TryFrom<Vec<u8>> for Document

type Error = Error

The type returned in the event of a conversion error.

fn try_from(der_bytes: Vec<u8>) -> Result<Document, Error>

Performs the conversion.

impl Eq for Document

impl StructuralPartialEq for Document

Layout

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 32 bytes