Enum TcpConnState

pub enum TcpConnState {
    Closed,
    Connecting {
        socket_handle: usize,
        remote_ip: Ipv4Addr,
        remote_port: u16,
        local_port: u16,
        start_tsc: TscTimestamp,
    },
    Established {
        socket_handle: usize,
        info: TcpConnectionInfo,
    },
    Closing {
        socket_handle: usize,
        start_tsc: TscTimestamp,
    },
    Error {
        error: TcpError,
    },
}

TCP connection state machine.

Manages non-blocking TCP connection establishment and closing. Does NOT handle data transfer - that’s done directly on the socket.

Variants

Closed

Socket not connected

Connecting

Connection initiated, waiting for establishment

Fields

socket_handle: usize

Socket handle (opaque, passed to smoltcp)

remote_ip: Ipv4Addr

Remote address

remote_port: u16

Remote port

local_port: u16

Local port (for reference)

start_tsc: TscTimestamp

When connect started

Established

Connection established

Fields

socket_handle: usize

Socket handle

info: TcpConnectionInfo

Connection info

Closing

Connection closing

Fields

socket_handle: usize

Socket handle

start_tsc: TscTimestamp

When close started

Error

Error state

Fields

error: TcpError

Error details

Implementations

impl TcpConnState

pub fn new() -> Self

Create new TCP state machine in closed state.

pub fn initiate( &mut self, socket_handle: usize, remote_ip: Ipv4Addr, remote_port: u16, local_port: u16, now_tsc: u64, )

Initiate connection.

Called AFTER smoltcp’s socket.connect() has been called. This just tracks the state - actual connect is done by smoltcp.

Arguments

• socket_handle: Socket handle from smoltcp
• remote_ip: Remote IP address
• remote_port: Remote port
• local_port: Local port (0 for ephemeral)
• now_tsc: Current TSC timestamp

pub fn step( &mut self, socket_state: TcpSocketState, now_tsc: u64, timeout_ticks: u64, ) -> StepResult

Step the state machine.

Arguments

• socket_state: Current TCP socket state from smoltcp
• now_tsc: Current TSC value
• timeout_ticks: Connect/close timeout in TSC ticks

Returns

• Pending: Still connecting/closing
• Done: Connected (when Connecting) or Closed (when Closing)
• Timeout: Operation timed out
• Failed: Operation failed

pub fn close(&mut self, now_tsc: u64)

Start graceful close.

Called AFTER smoltcp’s socket.close() has been called.

pub fn abort(&mut self)

Abort connection immediately.

pub fn fail(&mut self, error: TcpError)

Mark as failed with error.

pub fn socket_handle(&self) -> Option<usize>

Get socket handle (if connecting or established).

pub fn connection_info(&self) -> Option<&TcpConnectionInfo>

Get connection info (if established).

pub fn error(&self) -> Option<TcpError>

Get error (if failed).

pub fn is_established(&self) -> bool

Check if connection is established.

pub fn is_closed(&self) -> bool

Check if closed (initial or after close).

pub fn is_error(&self) -> bool

Check if in error state.

pub fn is_terminal(&self) -> bool

Check if terminal (established, closed, or error).

Trait Implementations

impl Debug for TcpConnState

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

Formats the value using the given formatter.

impl Default for TcpConnState

fn default() -> Self

Returns the “default value” for a type.