Struct SocketConfig 

pub struct SocketConfig {
    pub params: BTreeMap<String, Vec<u8>>,
}

Configuration for socket creation and layer binding

This structure carries configuration from socket creation down through the protocol layers, allowing each layer to extract the information it needs to properly configure the socket.

Design Philosophy

• Solves @petitstrawberry’s question: How does IP layer get IP address? How does TCP layer get port number? Answer: Through SocketConfig at socket creation.
• Protocol-agnostic: Generic key-value store, not tied to specific protocols
• Per-socket configuration: Each socket gets configured independently

Example: Socket Creation with Configuration

// User creates TCP socket and binds to address
let mut config = SocketConfig::new();
config.set("ip_local", &[192, 168, 1, 100]);
config.set("tcp_local_port", &5000u16.to_be_bytes());

// Socket factory creates socket with config
let socket = tcp_socket_factory(&config)?;

// Inside TcpSocket::new():
// - TCP layer extracts "tcp_local_port" for its state
// - IP layer extracts "ip_local" for source address
// - Ethernet layer might extract interface name

// Later, when connect() is called:
config.set("ip_remote", &[192, 168, 1, 1]);
config.set("tcp_remote_port", &80u16.to_be_bytes());
socket.connect(&config)?;

Fields

params: BTreeMap<String, Vec<u8>>

Protocol-agnostic configuration parameters

Common keys (convention, not enforced):

• “ip_local”: Local IP address (IPv4 or IPv6 bytes)
• “ip_remote”: Remote IP address
• “tcp_local_port”: TCP local port (u16 big-endian)
• “tcp_remote_port”: TCP remote port
• “udp_local_port”: UDP local port
• “udp_remote_port”: UDP remote port
• “interface”: Network interface name

Implementations

impl SocketConfig

pub fn new() -> Self

Create a new empty configuration

pub fn set(&mut self, key: &str, value: &[u8])

Set a configuration parameter

pub fn get(&self, key: &str) -> Option<&[u8]>

Get a configuration parameter

pub fn get_u16(&self, key: &str) -> Option<u16>

Get a u16 value (for ports)

pub fn get_ipv4(&self, key: &str) -> Option<[u8; 4]>

Get an IPv4 address

Trait Implementations

impl Clone for SocketConfig

fn clone(&self) -> SocketConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SocketConfig

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

Formats the value using the given formatter.

impl Default for SocketConfig

fn default() -> SocketConfig

Returns the “default value” for a type.