Struct x509_parser::pem::Pem

source · [−]

pub struct Pem {
    pub label: String,
    pub contents: Vec<u8>,
}

Expand description

Representation of PEM data

Fields

label: String

The PEM label

contents: Vec<u8>

The PEM decoded data

Implementations

source

impl Pem

source

pub fn read(r: impl BufRead + Seek) -> Result<(Pem, usize), PEMError>

Read the next PEM-encoded structure, and decode the base64 data

Returns the certificate (encoded in DER) and the number of bytes read. Allocates a new buffer for the decoded data.

Note that a PEM file can contain multiple PEM blocks. This function returns the first decoded object, starting from the current reader position. To get all objects, call this function repeatedly until PEMError::MissingHeader is returned.

Examples

let file = std::fs::File::open("assets/certificate.pem").unwrap();
let subject = x509_parser::pem::Pem::read(std::io::BufReader::new(file))
     .unwrap().0
    .parse_x509().unwrap()
    .tbs_certificate.subject.to_string();
assert_eq!(subject, "CN=lists.for-our.info");

source

pub fn parse_x509(&self) -> Result<X509Certificate<'_>, Err<X509Error>>

Decode the PEM contents into a X.509 object

source

pub fn iter_from_buffer(i: &[u8]) -> PemIterator<Cursor<&[u8]>>ⓘNotable traits for PemIterator<R>`impl<R: BufRead + Seek> Iterator for PemIterator<R> type Item = Result<Pem, PEMError>;`

Returns an iterator over the PEM-encapsulated parts of a buffer

Only the sections enclosed in blocks starting with -----BEGIN xxx----- and ending with -----END xxx----- will be considered. Lines before, between or after such blocks will be ignored.

The iterator is fallible: next() returns a Result<Pem, PEMError> object. An error indicates a block is present but invalid.

If the buffer does not contain any block, iterator will be empty.

source

pub fn iter_from_reader<R: BufRead + Seek>(reader: R) -> PemIterator<R>ⓘNotable traits for PemIterator<R>`impl<R: BufRead + Seek> Iterator for PemIterator<R> type Item = Result<Pem, PEMError>;`

Returns an iterator over the PEM-encapsulated parts of a reader

Only the sections enclosed in blocks starting with -----BEGIN xxx----- and ending with -----END xxx----- will be considered. Lines before, between or after such blocks will be ignored.

The iterator is fallible: next() returns a Result<Pem, PEMError> object. An error indicates a block is present but invalid.

If the reader does not contain any block, iterator will be empty.