Struct Ech

pub struct Ech<Octs: ?Sized>(/* private fields */);

The Encrypted Client Hello (ECH) service parameter value.

This value holds the information necessary to connect to the service with Encrypted Client Hello. It contains all this information in wire-format to be used with the TLS ECH extension currently in development as Internet draft draft-ietf-tls-esni.

Implementations

impl<Octs> Ech<Octs>

pub unsafe fn from_octets_unchecked(octets: Octs) -> Self

Creates a new value from octets without checking.

Safety

The caller has to ensure that octets contains a properly formated value of at most 65,535 octets.

impl Ech<[u8]>

pub unsafe fn from_slice_unchecked(slice: &[u8]) -> &Self

Creates a new value for a slice without checking.

Safety

The caller has to ensure that slice contains a properly formated value of at most 65,535 octets.

impl<Octs: ?Sized> Ech<Octs>

pub fn as_octets(&self) -> &Octs

Returns a reference to the underlying octets sequence.

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

where Octs: AsRef<[u8]>,

Returns a slice of the underlying octets sequence.

impl<Octs: AsRef<[u8]>> Ech<Octs>

pub fn from_octets(octets: Octs) -> Result<Self, LongSvcParam>

Creates a new ECH value from the given content.

Returns an error if the content is too long to fit into an SVCB parameter value.

impl Ech<[u8]>

pub fn from_slice(slice: &[u8]) -> Result<&Self, LongSvcParam>

Creates a new ECH value from a slice of the content.

Returns an error if the slice is too long to fit into an SVCB parameter value.

impl<Octs: AsRef<[u8]>> Ech<Octs>

pub fn parse<'a, Src: Octets<Range<'a> = Octs> + ?Sized>( parser: &mut Parser<'a, Src>, ) -> Result<Self, ParseError>

Parses an ECH value from its wire-format.

Trait Implementations

impl<Octs: AsRef<[u8]> + ?Sized> AsRef<[u8]> for Ech<Octs>

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

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

impl<Octs> AsRef<Octs> for Ech<Octs>

fn as_ref(&self) -> &Octs

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

impl<Octs: Clone + ?Sized> Clone for Ech<Octs>

fn clone(&self) -> Ech<Octs>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<Octs: AsRef<[u8]> + ?Sized> ComposeSvcParamValue for Ech<Octs>

fn compose_len(&self) -> u16

Returns the length of the composed value.

fn compose_value<Target: OctetsBuilder + ?Sized>( &self, target: &mut Target, ) -> Result<(), Target::AppendError>

Appends the wire format of the value to the end of target.

impl<Octs: Debug + ?Sized> Debug for Ech<Octs>

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

Formats the value using the given formatter.

impl<Octs: AsRef<[u8]> + ?Sized> Display for Ech<Octs>

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

Formats the value using the given formatter.

impl<Octs> From<Ech<Octs>> for AllValues<Octs>

fn from(p: Ech<Octs>) -> Self

Converts to this type from the input type.

impl<Octs: AsRef<[u8]>> Hash for Ech<Octs>

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

Feeds this value into the given Hasher.

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

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<O, OO> OctetsFrom<Ech<O>> for Ech<OO>

where OO: OctetsFrom<O>,

type Error = <OO as OctetsFrom<O>>::Error

fn try_octets_from(source: Ech<O>) -> Result<Self, Self::Error>

Performs the conversion.

impl<'a, Octs> ParseSvcParamValue<'a, Octs> for Ech<Octs::Range<'a>>

where Octs: Octets + ?Sized,

fn parse_value( key: SvcParamKey, parser: &mut Parser<'a, Octs>, ) -> Result<Option<Self>, ParseError>

Parse a parameter value from wire format.

impl<Octs, OtherOcts> PartialEq<Ech<OtherOcts>> for Ech<Octs>

where Octs: AsRef<[u8]>, OtherOcts: AsRef<[u8]>,

fn eq(&self, other: &Ech<OtherOcts>) -> 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<Octs: ?Sized> SvcParamValue for Ech<Octs>

fn key(&self) -> SvcParamKey

Returns the parameter key of the value.

impl<Octs: AsRef<[u8]>> Eq for Ech<Octs>