stdx_network.h

X_NETWORK_VERSION_MAJOR

#define X_NETWORK_VERSION_MAJOR 1

X_NETWORK_VERSION_MINOR

#define X_NETWORK_VERSION_MINOR 0

X_NETWORK_VERSION_PATCH

#define X_NETWORK_VERSION_PATCH 0

X_NETWORK_VERSION

#define X_NETWORK_VERSION(X_NETWORK_VERSION_MAJOR *10000+X_NETWORK_VERSION_MINOR *100+X_NETWORK_VERSION_PATCH)

XSocket

typedef SOCKET XSocket;

socklen_t

typedef int32_t socklen_t;

INVALID_SOCKET

#define INVALID_SOCKET(-1)

XAddress

typedef struct XAddress XAddress;

XAddressFamily

typedef enum{
  X_NET_AF_IPV4=1,
  X_NET_AF_IPV6=2,
}XAddressFamily;

XSocketType

typedef enum{
  X_NET_SOCK_STREAM=1,
  X_NET_SOCK_DGRAM=2,
}XSocketType;

XNetAdapter

typedef struct{
  int8_t name[128];
}XNetAdapter;

XNetAdapterInfo

typedef struct{
  int8_t name[128];
  int8_t description[256];
  int8_t mac[18];
  int8_t ipv4[16];
  int8_t ipv6[46];
  uint64_t speed_bps;
  bool is_wireless;
  int32_t mtu;
  uint32_t ifindex;
}XNetAdapterInfo;

x_net_init

Initialize the networking subsystem.

bool x_net_init(void);

x_net_shutdown

Shut down the networking subsystem and release associated resources.

void x_net_shutdown(void);

x_net_socket_is_valid

Check whether a socket handle represents a valid socket.

bool x_net_socket_is_valid(XSocket sock);

x_net_close

Close a socket handle.

void x_net_close(XSocket sock);

x_net_set_nonblocking

Enable or disable non-blocking mode on a socket.

int32_t x_net_set_nonblocking(
 XSocket sock,
 int32_t nonblocking
);

x_net_socket

Create a socket with the specified address family and socket type.

XSocket x_net_socket(
 XAddressFamily family,
 XSocketType type
);

x_net_socket_tcp4

Create an IPv4 TCP socket.

XSocket x_net_socket_tcp4(void);

x_net_socket_tcp6

Create an IPv6 TCP socket.

XSocket x_net_socket_tcp6(void);

x_net_socket_udp4

Create an IPv4 UDP socket.

XSocket x_net_socket_udp4(void);

x_net_socket_udp6

Create an IPv6 UDP socket.

XSocket x_net_socket_udp6(void);

x_net_bind

Bind a socket to a specific local address.

bool x_net_bind(
 XSocket sock,
 const XAddress *addr
);

x_net_bind_any

Bind a socket to any local address of the given family and port.

bool x_net_bind_any(
 XSocket sock,
 XAddressFamily family,
 uint16_t port
);

x_net_bind_any_udp

Bind a UDP socket to any local IPv4 address (system-chosen port/address if applicable).

bool x_net_bind_any_udp(XSocket sock);

x_net_bind_any_udp6

Bind a UDP socket to any local IPv6 address (system-chosen port/address if applicable).

bool x_net_bind_any_udp6(XSocket sock);

x_net_listen

Mark a bound socket as listening for incoming connections.

bool x_net_listen(
 XSocket sock,
 int32_t backlog
);

x_net_accept

Accept an incoming connection on a listening socket.

XSocket x_net_accept(
 XSocket sock,
 XAddress *out_addr
);

x_net_connect

Connect a socket to a remote address.

int32_t x_net_connect(
 XSocket sock,
 const XAddress *addr
);

x_net_send

Send data on a connected socket.

size_t x_net_send(
 XSocket sock,
 const void *buf,
 size_t len
);

x_net_recv

Receive data from a connected socket.

size_t x_net_recv(
 XSocket sock,
 void *buf,
 size_t len
);

x_net_sendto

Send data to a specific address (datagram sockets).

size_t x_net_sendto(
 XSocket sock,
 const void *buf,
 size_t len,
 const XAddress *addr
);

x_net_recvfrom

Receive data from a socket and optionally retrieve the sender address.

size_t x_net_recvfrom(
 XSocket sock,
 void *buf,
 size_t len,
 XAddress *out_addr
);

x_net_select

Wait for readability on multiple sockets.

int32_t x_net_select(
 XSocket *read_sockets,
 int32_t read_count,
 int32_t timeout_ms
);

x_net_poll

Wait for specific events on a socket.

int32_t x_net_poll(
 XSocket sock,
 int32_t events,
 int32_t timeout_ms
);

x_net_resolve

Resolve a host and service/port into a network address.

bool x_net_resolve(
 const int8_t *host,
 const int8_t *port,
 XAddressFamily family,
 XAddress *out_addr
);

x_net_parse_ip

Parse an IP string into a raw binary address.

int32_t x_net_parse_ip(
 XAddressFamily family,
 const int8_t *ip,
 void *out_addr
);

x_net_format_address

Format an address as a human-readable string.

int32_t x_net_format_address(
 const XAddress *addr,
 char *out_str,
 int32_t maxlen
);

x_net_address_clear

Clear an XAddress structure (set to zero).

void x_net_address_clear(XAddress *addr);

x_net_address_any

Create an "any" address for binding on the given family and port.

void x_net_address_any(
 XAddress *out_addr,
 int32_t family,
 uint16_t port
);

x_net_address_from_ip_port

Build an XAddress from an IP string and port.

int32_t x_net_address_from_ip_port(
 const int8_t *ip,
 uint16_t port,
 XAddress *out_addr
);

x_net_address_equal

Compare two XAddress values for equality.

int32_t x_net_address_equal(
 const XAddress *a,
 const XAddress *b
);

x_net_address_to_string

Convert an XAddress to a string representation (typically "IP:port").

int32_t x_net_address_to_string(
 const XAddress *addr,
 char *buf,
 int32_t buf_len
);

x_net_dns_resolve

Resolve a DNS hostname to an address.

int32_t x_net_dns_resolve(
 const int8_t *hostname,
 XAddressFamily family,
 XAddress *out_addr
);

x_net_join_multicast_ipv4

Join an IPv4 multicast group by textual group address.

bool x_net_join_multicast_ipv4(
 XSocket sock,
 const int8_t *group
);

x_net_leave_multicast_ipv4

Leave an IPv4 multicast group by textual group address.

bool x_net_leave_multicast_ipv4(
 XSocket sock,
 const int8_t *group
);

x_net_join_multicast_ipv6

Join an IPv6 multicast group.

bool x_net_join_multicast_ipv6(
 XSocket sock,
 const int8_t *multicast_ip,
 uint32_t ifindex
);

x_net_leave_multicast_ipv6

Leave an IPv6 multicast group.

bool x_net_leave_multicast_ipv6(
 XSocket sock,
 const int8_t *multicast_ip,
 uint32_t ifindex
);

x_net_join_multicast_ipv4_addr

Join an IPv4 multicast group using an XAddress structure.

bool x_net_join_multicast_ipv4_addr(
 XSocket sock,
 const XAddress *group_addr
);

x_net_leave_multicast_ipv4_addr

Leave an IPv4 multicast group using an XAddress structure.

bool x_net_leave_multicast_ipv4_addr(
 XSocket sock,
 const XAddress *group_addr
);

x_net_enable_broadcast

Enable or disable broadcast capability on a socket.

bool x_net_enable_broadcast(
 XSocket sock,
 bool enable
);

x_net_get_adapter_count

Get the number of network adapters available on the system.

int32_t x_net_get_adapter_count(void);

x_net_list_adapters

List available network adapters.

int32_t x_net_list_adapters(
 XNetAdapter *out_adapters,
 int32_t max_adapters
);

x_net_get_adapter_info

Retrieve detailed information about a network adapter by name.

bool x_net_get_adapter_info(
 const int8_t *name,
 XNetAdapterInfo *out_info
);

x_net_get_last_error

Get the last network error code for the current thread/process.

int32_t x_net_get_last_error(void);

x_net_get_last_error_message

Write a human-readable message for the last network error into a buffer.

int32_t x_net_get_last_error_message(
 char *buf,
 int32_t buf_len
);

X_NET_ALLOC

Internal macro for allocating memory. To override how this header allocates memory, define this macro with a different implementation before including this header.

#define X_NET_ALLOC(sz) malloc(sz)

X_NET_FREE

Internal macro for freeing memory. To override how this header frees memory, define this macro with a different implementation before including this header.

#define X_NET_FREE(p) free(p)

X_NET_POLLIN

#define X_NET_POLLIN 0x01

X_NET_POLLOUT

#define X_NET_POLLOUT 0x02

x_net_get_adapter_count_win32

int32_t x_net_get_adapter_count_win32(void);

x_net_list_adapters_win32

int32_t x_net_list_adapters_win32(
 XNetAdapter *out_adapters,
 int32_t max_adapters
);

x_net_get_adapter_info_win32

int32_t x_net_get_adapter_info_win32(
 const int8_t *name,
 XNetAdapterInfo *out_info
);

x_net_get_adapter_count_posix

int32_t x_net_get_adapter_count_posix(void);

x_net_list_adapters_posix

int32_t x_net_list_adapters_posix(
 XNetAdapter *out_adapters,
 int32_t max_adapters
);

x_net_get_adapter_info_posix

int32_t x_net_get_adapter_info_posix(
 const int8_t *name,
 XNetAdapterInfo *out_info
);