Struct Context 

pub struct Context<C: TlsSession> { /* private fields */ }

The context for managing a kTLS connection.

Implementations

impl<C: TlsSession> Context<C>

pub fn new(session: C, buffer: Option<Buffer>) -> Self

Creates a new kTLS context with the given TLS session and optional buffer (can be TLS early data received from peer during handshake, or pre-allocated buffer).

pub const fn state(&self) -> &State

Returns the current kTLS connection state.

pub const fn buffer(&self) -> &Buffer

Returns a reference to the buffer.

pub const fn buffer_mut(&mut self) -> &mut Buffer

Returns a mutable reference to the buffer.

pub fn handle_io_error<S: AsFd>(&mut self, socket: &S, err: Error) -> Result<()>

Handles io::Errors from I/O operations on kTLS-configured sockets.

Overview

When a socket is configured with kTLS, it can be used like a normal socket for data transmission - the kernel transparently handles encryption and decryption. However, TLS control messages (e.g., TLS alerts) from peers cannot be processed automatically by the kernel, which returns EIO to notify userspace.

This method helps handle such errors appropriately:

• EIO: Attempts to process any received TLS control messages. Returns Ok(()) on success, allowing the caller to retry the operation.
• Interrupted: Indicates the operation was interrupted by a signal. Returns Ok(()), allowing the caller to retry the operation.
• WouldBlock: Indicates the operation would block (e.g., non-blocking socket). Returns Ok(()), allowing the caller to retry the operation.
• BrokenPipe: Marks the stream as closed.
• Other errors: Aborts the connection with an internal_error alert and returns the original error.

Errors

Returns the original io::Error if it cannot be recovered from.

pub fn shutdown<S: AsFd>(&mut self, socket: &S)

Closes the read side of the kTLS connection and sends a close_notify alert to the peer.

Trait Implementations

impl<C: Debug + TlsSession> Debug for Context<C>

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

Formats the value using the given formatter.