Skip to main content

WriteEarlyData

Struct WriteEarlyData 

Source
pub struct WriteEarlyData<'a> { /* private fields */ }
Expand description

Allows writing of early data in resumed TLS 1.3 connections.

“Early data” is also known as “0-RTT data”.

Use Self::write_tls() to encrypt early data into TLS records.

Implementations§

Source§

impl<'a> WriteEarlyData<'a>

Source

pub fn write_tls( &mut self, plaintext: OutboundPlain<'_>, tls: &mut Vec<u8>, ) -> usize

Encrypt early data as TLS records and encode them into tls.

Yields the number of bytes of plaintext that were consumed. This may be less than the length of plaintext if the server has limited the amount of early data that may be sent.

Source

pub fn bytes_left(&self) -> usize

How many bytes you may send. Writes will become short once this reaches zero.

Source

pub fn exporter(&mut self) -> Result<KeyingMaterialExporter, Error>

Returns the “early” exporter that can derive key material for use in early data

See RFC 5705 for general details on what exporters are, and RFC 9846 S7.5 for specific details on the “early” exporter.

Beware that the early exporter requires care, as it is subject to the same potential for replay as early data itself. See RFC 9846 appendix F.5.1 for more detail.

This function can be called at most once per connection. This function will error: if called more than once per connection.

If you are looking for the normal exporter, this is available from Connection::exporter().

Auto Trait Implementations§

§

impl<'a> !RefUnwindSafe for WriteEarlyData<'a>

§

impl<'a> !UnwindSafe for WriteEarlyData<'a>

§

impl<'a> Freeze for WriteEarlyData<'a>

§

impl<'a> Send for WriteEarlyData<'a>

§

impl<'a> Sync for WriteEarlyData<'a>

§

impl<'a> Unpin for WriteEarlyData<'a>

§

impl<'a> UnsafeUnpin for WriteEarlyData<'a>

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,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

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

Source§

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

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

§

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
Source§

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

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, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

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

Performs the conversion.
Source§

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

Source§

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

The type returned in the event of a conversion error.
Source§

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

Performs the conversion.
§

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