ClientHello

rama::net::tls::client

Struct ClientHello

pub struct ClientHello { /* private fields */ }

Available on crate features net and tls only.

Expand description

When a client first connects to a server, it is required to send the ClientHello as its first message.

The ClientHello contains random data, cipher suites, legacy content from <= TLS.12 and extensions.

For Rama however we only focus on the parts which a user might want to inspect and/or set.

Implementations§

impl ClientHello

pub fn new( protocol_version: ProtocolVersion, cipher_suites: Vec<CipherSuite>, compression_algorithms: Vec<CompressionAlgorithm>, extensions: Vec<ClientHelloExtension>, ) -> ClientHello

Available on (crate features rustls or boring or acme) and crate feature boring only.

pub fn protocol_version(&self) -> ProtocolVersion

Available on (crate features rustls or boring or acme) and crate feature boring only.

Return all ProtocolVersions defined in this ClientHello.

pub fn cipher_suites(&self) -> &[CipherSuite]

Available on (crate features rustls or boring or acme) and crate feature boring only.

Return all CipherSuites defined in this ClientHello.

pub fn compression_algorithms(&self) -> &[CompressionAlgorithm]

Available on (crate features rustls or boring or acme) and crate feature boring only.

Return all CompressionAlgorithms defined in this ClientHello.

pub fn extensions(&self) -> &[ClientHelloExtension]

Available on (crate features rustls or boring or acme) and crate feature boring only.

Return all ClientHelloExtensions defined in this ClientHello.

pub fn ext_server_name(&self) -> Option<&Domain>

Available on (crate features rustls or boring or acme) and crate feature boring only.

Return the server name (SNI) if it is set in the ClientHelloExtension defined in this ClientHello.

See ClientHelloExtension::ServerName for more information about the server name.

pub fn ext_supported_groups(&self) -> Option<&[SupportedGroup]>

Available on (crate features rustls or boring or acme) and crate feature boring only.

Return the elliptic curves supported by this client if it is set in the ClientHelloExtension defined in this ClientHello.

See ClientHelloExtension::SupportedGroups for more information about these curves.

pub fn ext_ec_point_formats(&self) -> Option<&[ECPointFormat]>

Available on (crate features rustls or boring or acme) and crate feature boring only.

Return the EC point formats supported by this client if it is set in the ClientHelloExtension defined in this ClientHello.

See ClientHelloExtension::ECPointFormats for more information about this.

pub fn ext_signature_algorithms(&self) -> Option<&[SignatureScheme]>

Available on (crate features rustls or boring or acme) and crate feature boring only.

Return the signature algorithms supported by this client if it is set in the ClientHelloExtension defined in this ClientHello.

See ClientHelloExtension::SignatureAlgorithms for more information about these algorithms

pub fn ext_alpn(&self) -> Option<&[ApplicationProtocol]>

Available on (crate features rustls or boring or acme) and crate feature boring only.

Return the application layer protocols supported for negotiation by this client if it is set in the ClientHelloExtension defined in this ClientHello.

See ClientHelloExtension::ApplicationLayerProtocolNegotiation for more information about these protocols (ALPN).

pub fn ext_alps(&self) -> Option<&[ApplicationProtocol]>

Available on (crate features rustls or boring or acme) and crate feature boring only.

Return the application layer protocols for which alps is supported if it is set in the ClientHelloExtension defined in this ClientHello.

See ClientHelloExtension::ApplicationSettings for more information about these protocols (ALPS).

pub fn supported_versions(&self) -> Option<&[ProtocolVersion]>

Available on (crate features rustls or boring or acme) and crate feature boring only.

Return the TLS versions supported by this client if it is set in the ClientHelloExtension defined in this ClientHello.

See ClientHelloExtension::SupportedVersions for more information about these versions

Trait Implementations§

impl Clone for ClientHello

fn clone(&self) -> ClientHello

Returns a duplicate of the value. Read more

1.0.0 · Source§

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

Performs copy-assignment from source. Read more

impl Debug for ClientHello

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

Formats the value using the given formatter. Read more

impl<'de> Deserialize<'de> for ClientHello

fn deserialize<D>( deserializer: D, ) -> Result<ClientHello, <D as Deserializer<'de>>::Error>
where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer. Read more

impl From<ClientConfig> for ClientHello

fn from(value: ClientConfig) -> ClientHello

Converts to this type from the input type.

impl From<ClientHello> for ClientConfig

fn from(value: ClientHello) -> ClientConfig

Converts to this type from the input type.

impl Hash for ClientHello

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

Feeds this value into the given Hasher. Read more

1.3.0 · Source§

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

Feeds a slice of this type into the given Hasher. Read more

impl<'a> RamaFrom<ClientHello<'a>, RamaTlsRustlsCrateMarker> for ClientHello

fn rama_from(value: ClientHello<'a>) -> ClientHello

impl<'ssl> RamaTryFrom<&ClientHello<'ssl>, RamaTlsBoringCrateMarker> for ClientHello

type Error = OpaqueError

fn rama_try_from( value: &ClientHello<'ssl>, ) -> Result<ClientHello, <ClientHello as RamaTryFrom<&ClientHello<'ssl>, RamaTlsBoringCrateMarker>>::Error>

impl<'ssl> RamaTryFrom<ClientHello<'ssl>, RamaTlsBoringCrateMarker> for ClientHello

type Error = OpaqueError

fn rama_try_from( value: ClientHello<'ssl>, ) -> Result<ClientHello, <ClientHello as RamaTryFrom<ClientHello<'ssl>, RamaTlsBoringCrateMarker>>::Error>

impl Serialize for ClientHello

fn serialize<S>( &self, serializer: S, ) -> Result<<S as Serializer>::Ok, <S as Serializer>::Error>
where S: Serializer,

Serialize this value into the given Serde serializer. Read more

impl TryFrom<ClientHello> for TlsConnectorDataBuilder

type Error = OpaqueError

The type returned in the event of a conversion error.

fn try_from( value: ClientHello, ) -> Result<TlsConnectorDataBuilder, <TlsConnectorDataBuilder as TryFrom<ClientHello>>::Error>

Performs the conversion.

Auto Trait Implementations§

impl Freeze for ClientHello

impl RefUnwindSafe for ClientHello

impl Send for ClientHello

impl Sync for ClientHello

impl Unpin for ClientHello

impl UnwindSafe for ClientHello

Blanket Implementations§

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

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

impl<'a, T, E> AsTaggedExplicit<'a, E> for T
where T: 'a,

fn explicit(self, class: Class, tag: u32) -> TaggedParser<'a, Explicit, Self, E>

impl<'a, T, E> AsTaggedImplicit<'a, E> for T
where T: 'a,

fn implicit( self, class: Class, constructed: bool, tag: u32, ) -> TaggedParser<'a, Implicit, Self, E>

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

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

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

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

Mutably borrows from an owned value. Read more

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

unsafe fn clone_to_uninit(&self, dest: *mut u8)

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

Performs copy-assignment from self to dest. Read more

impl<T> From<T> for T

fn from(t: T) -> T

Returns the argument unchanged.

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

fn from_ref(input: &T) -> T

Converts to this type from a reference to the input type.

impl<T> FutureExt for T

fn with_context(self, otel_cx: Context) -> WithContext<Self> ⓘ

Attaches the provided Context to this type, returning a WithContext wrapper. Read more

fn with_current_context(self) -> WithContext<Self> ⓘ

Attaches the current Context to this type, returning a WithContext wrapper. Read more

impl<T> Instrument for T

fn instrument(self, span: Span) -> Instrumented<Self> ⓘ

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more

fn in_current_span(self) -> Instrumented<Self> ⓘ

Instruments this type with the current Span, returning an Instrumented wrapper. Read more

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

fn into(self) -> U

Calls U::from(self).

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

impl<T> IntoEither for T

fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more

impl<T> Pointable for T

const ALIGN: usize

The alignment of pointer.

type Init = T

The type for initializers.

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more

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

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow only if self and other return Action::Follow. Read more

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow if either self or other returns Action::Follow. Read more

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

fn rama_from(value: T) -> U

impl<T, U, CrateMarker> RamaInto<U, CrateMarker> for T
where U: RamaFrom<T, CrateMarker>,

fn rama_into(self) -> U

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

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

fn rama_try_from(value: T) -> Result<U, <U as RamaTryFrom<T>>::Error>

impl<T, U, CrateMarker> RamaTryInto<U, CrateMarker> for T
where U: RamaTryFrom<T, CrateMarker>,

type Error = <U as RamaTryFrom<T, CrateMarker>>::Error

fn rama_try_into(self) -> Result<U, <U as RamaTryFrom<T, CrateMarker>>::Error>

impl<T> Same for T

type Output = T

Should always be Self

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

type Owned = T

The resulting type after obtaining ownership.

fn to_owned(&self) -> T

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

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

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

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

type Error = Infallible

The type returned in the event of a conversion error.

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

Performs the conversion.

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

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

The type returned in the event of a conversion error.

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

Performs the conversion.

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

fn vzip(self) -> V

impl<T> WithSubscriber for T

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> ⓘ
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more

fn with_current_subscriber(self) -> WithDispatch<Self> ⓘ

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more

impl<T> DeserializeOwned for T
where T: for<'de> Deserialize<'de>,