Namespace: System.Net.Sockets

Socket

Provides a rich set of methods and properties for network communications, implementing non-blocking optimistic syscalls with thread pool event multiplexing and zero GC overhead.

⚡ 4.3 GB/s Loopback Throughput

Optimistic Syscall-First Architecture with Deterministic Buffer Reuse

High-Performance Networking

Every SystemH socket is set non-blocking from construction. Send() and Receive() immediately attempt raw syscalls without epoll registration overhead. Fallback to epoll/poll occurs only when EWOULDBLOCK is returned, yielding sustained 4,341 MB/s TCP async throughput (1.59x faster than .NET 10) and 4,092 MB/s TCP sync throughput (1.24x faster than raw POSIX). Async completion events reuse fixed-size pre-allocated nodes from System::Threading::ThreadPool, completely eliminating garbage collection jitter and CLR safepoint freezes.

Constructors

Socket(AddressFamily addressFamily, SocketType socketType, ProtocolType protocolType)

Initializes a new instance of the Socket class for the specified address family, socket type, and protocol. Configures the socket for non-blocking optimistic I/O automatically.

Properties

int Available

Gets the amount of data that has been received from the network and is available to be read without blocking.

bool Connected

Gets a value that indicates whether a Socket is connected to a remote host as of the last operation.

bool Blocking

Gets or sets a value that indicates whether the Socket is in blocking mode.

AddressFamily AddressFamily

Gets the address family of the Socket (e.g. InterNetwork, InterNetworkV6).

SocketType SocketType

Gets the type of the Socket (Stream, Dgram, Raw).

ProtocolType ProtocolType

Gets the protocol type of the Socket (Tcp, Udp).

intptr_t Handle

Gets the native operating system file descriptor or socket handle.

Methods

void Connect(EndPoint remoteEP)

Establishes a connection to a remote host specified by an EndPoint.

void Bind(EndPoint localEP)

Associates a Socket with a local network address and port number.

void Listen(int backlog)

Places a Socket in a listening state for incoming connection attempts.

Socket Accept()

Creates a new Socket for a newly created incoming connection.

int Send(Array<uint8_t> buffer, int offset, int size, SocketFlags flags)

Sends data to a connected Socket using optimistic syscall execution without kernel polling overhead on hot paths.

int Receive(Array<uint8_t> buffer, int offset, int size, SocketFlags flags)

Receives data from a connected Socket into a receive buffer.

int SendTo(Array<uint8_t> buffer, int offset, int size, SocketFlags flags, EndPoint remoteEP)

Sends a datagram to the specified remote endpoint (UDP).

int ReceiveFrom(Array<uint8_t> buffer, int offset, int size, SocketFlags flags, EndPoint& remoteEP)

Receives a datagram into the data buffer and stores the endpoint of the sender.

IAsyncResult BeginConnect(EndPoint remoteEP, Action<IAsyncResult> callback, Object state)

Begins an asynchronous request for a remote host connection.

void EndConnect(IAsyncResult asyncResult)

Ends a pending asynchronous connection request.

IAsyncResult BeginSend(Array<uint8_t> buffer, int offset, int size, SocketFlags flags, Action<IAsyncResult> callback, Object state)

Sends data asynchronously to a connected Socket using pre-allocated ThreadPool completion nodes.

int EndSend(IAsyncResult asyncResult)

Ends a pending asynchronous send and returns the number of bytes sent.

IAsyncResult BeginReceive(Array<uint8_t> buffer, int offset, int size, SocketFlags flags, Action<IAsyncResult> callback, Object state)

Begins to asynchronously receive data from a connected Socket.

int EndReceive(IAsyncResult asyncResult)

Ends a pending asynchronous read and returns the number of bytes received.

bool Poll(int microSeconds, SelectMode mode)

Determines the status of the Socket using kernel polling with microsecond precision.

void Shutdown(SocketShutdown how)

Disables sends and receives on a Socket.

void Close()

Closes the Socket connection and releases all associated native OS resources.

void SetSocketOption(SocketOptionLevel optionLevel, SocketOptionName optionName, int optionValue)

Sets the specified Socket option to the specified integer value (e.g. TCP_NODELAY, SO_REUSEADDR, SO_RCVBUF).