Struct der::Document

source · [−]

pub struct Document { /* private fields */ }

Available on crate feature alloc only.

Expand description

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

source

impl Document

source

pub fn as_bytes(&self) -> &[u8 ]ⓘNotable traits for &'_ mut [u8 ]`impl<'_> Write for &'_ mut [u8]impl<'_> Read for &'_ [u8]`

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

source

pub fn into_secret(self) -> SecretDocument

Available on crate feature zeroize only.

Convert to a SecretDocument.

source

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

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

source

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

Return an ASN.1 DER-encoded byte vector.

source

pub fn len(&self) -> Length

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

source

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

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

source

pub fn encode_msg<T: Encode>(msg: &T) -> Result<Self>

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

source

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

Available on crate feature pem only.

Decode ASN.1 DER document from PEM.

Returns the PEM label and decoded Document on success.

source

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

Available on crate feature pem only.

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

source

pub fn read_der_file(path: impl AsRef<Path>) -> Result<Self>

Available on crate feature std only.

Read ASN.1 DER document from a file.

source

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

Available on crate feature std only.

Write ASN.1 DER document to a file.

source

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

Available on crate features pem and std only.

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

source

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

Available on crate features pem and std only.

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

Trait Implementations

source

impl AsRef<[u8 ]> for Document

source

fn as_ref(&self) -> &[u8 ]ⓘNotable traits for &'_ mut [u8 ]`impl<'_> Write for &'_ mut [u8]impl<'_> Read for &'_ [u8]`

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

source

impl Clone for Document

source

fn clone(&self) -> Document

Returns a copy of the value. Read more

1.0.0 · source

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

Performs copy-assignment from source. Read more

source

impl Debug for Document

source

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

Formats the value using the given formatter. Read more

source

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

source

fn decode<R: Reader<'a>>(reader: &mut R) -> Result<Document>

Attempt to decode this message using the provided decoder.

source

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

Parse Self from the provided DER-encoded byte slice.

source

impl Encode for Document

source

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

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

source

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

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

source

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

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

source

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

Available on crate feature alloc only.

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

source

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

Available on crate feature alloc only.

Serialize this message as a byte vector.

source

impl FixedTag for Document

source

const TAG: Tag = Tag::Sequence

ASN.1 tag

source

impl From<Document> for SecretDocument

source

fn from(doc: Document) -> SecretDocument

Converts to this type from the input type.

source

impl PartialEq<Document> for Document

source

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

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

source

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

This method tests for !=.

source

impl TryFrom<&'_ [u8 ]> for Document

type Error = Error

The type returned in the event of a conversion error.

source

fn try_from(der_bytes: &[u8 ]) -> Result<Self>

Performs the conversion.

source

impl TryFrom<Vec<u8, Global>> for Document

type Error = Error

The type returned in the event of a conversion error.

source

fn try_from(der_bytes: Vec<u8>) -> Result<Self>

Performs the conversion.

source

impl Eq for Document

source

impl StructuralEq for Document

source

impl StructuralPartialEq for Document

Auto Trait Implementations

impl RefUnwindSafe for Document

impl Send for Document

impl Sync for Document

impl Unpin for Document

impl UnwindSafe for Document

Blanket Implementations

source

impl<T> Any for T where
T: 'static + ?Sized,

source

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

source

impl<T> Borrow<T> for T where
T: ?Sized,

const: unstable · source

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

source

impl<T> BorrowMut<T> for T where
T: ?Sized,

const: unstable · source

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

source

impl<T> From<T> for T

const: unstable · source

fn from(t: T) -> T

Returns the argument unchanged.

source

impl<T, U> Into for T where
U: From<T>,

const: unstable · source

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source

impl<T> ToOwned for T where
T: Clone,

type Owned = T

The resulting type after obtaining ownership.

source

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more

source

fn clone_into(&self, target: &mut T)

🔬 This is a nightly-only experimental API. (toowned_clone_into)

Uses borrowed data to replace owned data, usually by cloning. Read more

source

impl<T, U> TryFrom for T where
U: Into<T>,

type Error = Infallible

The type returned in the event of a conversion error.

const: unstable · source

fn try_from(value: U) -> Result<T, <T as TryFrom>::Error>

Performs the conversion.

source

impl<T, U> TryInto for T where
U: TryFrom<T>,

type Error = >::Error

The type returned in the event of a conversion error.

const: unstable · source

fn try_into(self) -> Result<U, >::Error>

Performs the conversion.

Struct der::Document

Implementations

impl Document

pub fn as_bytes(&self) -> &[u8]ⓘNotable traits for &'_ mut [u8]impl<'_> Write for &'_ mut [u8]impl<'_> Read for &'_ [u8]

pub fn into_secret(self) -> SecretDocument

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

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

pub fn len(&self) -> Length

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

pub fn encode_msg<T: Encode>(msg: &T) -> Result<Self>

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

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

pub fn read_der_file(path: impl AsRef<Path>) -> Result<Self>

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

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

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

Trait Implementations

impl AsRef<[u8]> for Document

fn as_ref(&self) -> &[u8]ⓘNotable traits for &'_ mut [u8]impl<'_> Write for &'_ mut [u8]impl<'_> Read for &'_ [u8]

impl Clone for Document

fn clone(&self) -> Document

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

impl Debug for Document

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

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

fn decode<R: Reader<'a>>(reader: &mut R) -> Result<Document>

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

impl Encode for Document

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

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

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

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

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

impl FixedTag for Document

const TAG: Tag = Tag::Sequence

impl From<Document> for SecretDocument

fn from(doc: Document) -> SecretDocument

impl PartialEq<Document> for Document

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

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

impl TryFrom<&'_ [u8]> for Document

type Error = Error

fn try_from(der_bytes: &[u8]) -> Result<Self>

impl TryFrom<Vec<u8, Global>> for Document

type Error = Error

fn try_from(der_bytes: Vec<u8>) -> Result<Self>

impl Eq for Document

impl StructuralEq for Document

impl StructuralPartialEq for Document

Auto Trait Implementations

impl RefUnwindSafe for Document

impl Send for Document

impl Sync for Document

impl Unpin for Document

impl UnwindSafe for Document

Blanket Implementations

impl<T> Any for T where T: 'static + ?Sized,

fn type_id(&self) -> TypeId

impl<T> Borrow<T> for T where T: ?Sized,

fn borrow(&self) -> &T

impl<T> BorrowMut<T> for T where T: ?Sized,

fn borrow_mut(&mut self) -> &mut T

impl<T> From<T> for T

fn from(t: T) -> T

impl<T, U> Into<U> for T where U: From<T>,

fn into(self) -> U

impl<T> ToOwned for T where T: Clone,

type Owned = T

fn to_owned(&self) -> T

fn clone_into(&self, target: &mut T)

impl<T, U> TryFrom<U> for T where U: Into<T>,

type Error = Infallible

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

impl<T, U> TryInto<U> for T where U: TryFrom<T>,

type Error = <U as TryFrom<T>>::Error

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

pub fn as_bytes(&self) -> &[u8 ]ⓘNotable traits for &'_ mut [u8 ]`impl<'_> Write for &'_ mut [u8]impl<'_> Read for &'_ [u8]`

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

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

impl AsRef<[u8 ]> for Document

fn as_ref(&self) -> &[u8 ]ⓘNotable traits for &'_ mut [u8 ]`impl<'_> Write for &'_ mut [u8]impl<'_> Read for &'_ [u8]`

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

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

impl TryFrom<&'_ [u8 ]> for Document

fn try_from(der_bytes: &[u8 ]) -> Result<Self>

impl<T> Any for T where
T: 'static + ?Sized,

impl<T> Borrow<T> for T where
T: ?Sized,

impl<T> BorrowMut<T> for T where
T: ?Sized,

impl<T, U> Into<U> for T where
U: From<T>,

impl<T> ToOwned for T where
T: Clone,

impl<T, U> TryFrom<U> for T where
U: Into<T>,

impl<T, U> TryInto<U> for T where
U: TryFrom<T>,