Struct SplitConnection 

pub struct SplitConnection<Side: SideData> {
    pub send: SendTraffic,
    pub receive: ReceiveTraffic<Side>,
    pub outputs: ConnectionOutputs,
}

A post-handshake connection which has been split by direction.

Typically you will immediately destructure this type, and give the components to different threads/handlers to progress separately.

Fields

send: SendTraffic

The ability to encrypt data to be sent.

receive: ReceiveTraffic<Side>

The ability to decrypt received data.

outputs: ConnectionOutputs

Facts about the connection established during the handshake.

Implementations

impl<Side: SideData> SplitConnection<Side>

pub fn dangerous_into_kernel_connection( self, ) -> Result<(ExtractedSecrets, KernelConnection<Side>), Error>

Extract secrets and a KernelConnection, so they can be used when configuring kTLS, for example.

Should be used with care as it exposes secret key material.

All TLS data previously written into caller-provided buffers must be sent to the peer before calling this function.

The returned KernelConnection continues to own the connection’s secrets, so it can compute new traffic secrets on key update and (for client connections) accept session tickets. See the kernel module documentation for the details.

This fails if the connection was not made with enable_secret_extraction set, or if the send half has pending data queued by the receive half (see ReceiveTrafficState::FlushSender). Flush any pending data with SendTraffic::write() before calling this.

Trait Implementations

impl<Side: Debug + SideData> Debug for SplitConnection<Side>

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

Formats the value using the given formatter.