Struct Certs

pub struct Certs { /* private fields */ }

A Certs message is used as part of the channel handshake to send additional certificates.

These certificates are not presented as part of the TLS handshake. Originally this was meant to make Tor TLS handshakes look “normal”, but nowadays it serves less purpose, especially now that we have TLS 1.3.

Every relay sends this message as part of channel negotiation; clients do not send them.

Implementations

impl Certs

pub fn new_empty() -> Self

Return a new empty certs cell.

pub fn push_cert_body<B>(&mut self, certtype: CertType, cert: B)

where B: Into<Vec<u8>>,

Add a new encoded certificate to this cell.

Does not check anything about the well-formedness of the certificate.

pub fn cert_body(&self, tp: CertType) -> Option<&[u8]>

Return the body of the certificate tagged with ‘tp’, if any.

pub fn parse_ed_cert(&self, tp: CertType) -> Result<KeyUnknownCert>

Look for a certificate of type ‘tp’ in this cell; return it if there is one.

Trait Implementations

impl Body for Certs

fn encode_onto<W: Writer + ?Sized>(self, w: &mut W) -> EncodeResult<()>

Consume this message and encode its body onto w.

fn decode_from_reader(r: &mut Reader<'_>) -> Result<Self>

Decode a channel cell body from a provided reader.

impl ChanMsg for Certs

fn cmd(&self) -> ChanCmd

Return the ChanCmd for this message.

fn encode_onto<W: Writer + ?Sized>(self, w: &mut W) -> EncodeResult<()>

Write the body of this message (not including length or command).

fn decode_from_reader(cmd: ChanCmd, r: &mut Reader<'_>) -> Result<Self>

Decode this message from a given reader, according to a specified command value. The reader must be truncated to the exact length of the body.

impl Clone for Certs

fn clone(&self) -> Certs

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Certs

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

Formats the value using the given formatter.

impl From<Certs> for AnyChanMsg

fn from(m: Certs) -> AnyChanMsg

Converts to this type from the input type.

impl From<Certs> for AnyChanCell

fn from(body: Certs) -> AnyChanCell

Converts to this type from the input type.

impl HasMemoryCostStructural for Certs

fn indirect_memory_cost(&self, et: EnabledToken) -> usize

Memory cost of data stored out-of-line

impl Readable for Certs

fn take_from(r: &mut Reader<'_>) -> Result<Self>

Try to extract an object of this type from a Reader.