std.net.os

raw socket layer under std.net; for options the higher layers lack

sys_wsa_startup

pub sys_wsa_startup :: fn(version: u16, data: *u8) -> i32

os socket seam: Winsock on windows, syscalls on linux (Windows constants translated)

sys_wsa_cleanup

pub sys_wsa_cleanup :: fn() -> i32

sys_wsa_lasterr

pub sys_wsa_lasterr :: fn() -> i32

sys_socket

pub sys_socket :: fn(af: i32, kind: i32, proto: i32) -> usize

sys_closesocket

pub sys_closesocket :: fn(s: usize) -> i32

sys_connect

pub sys_connect :: fn(s: usize, name: *const u8, namelen: i32) -> i32

sys_bind

pub sys_bind :: fn(s: usize, name: *const u8, namelen: i32) -> i32

sys_listen

pub sys_listen :: fn(s: usize, backlog: i32) -> i32

sys_accept

pub sys_accept :: fn(s: usize, name: ?*u8, namelen: ?*i32) -> usize

sys_send

pub sys_send :: fn(s: usize, buf: *const u8, len: i32, flags: i32) -> i32

sys_recv

pub sys_recv :: fn(s: usize, buf: *u8, len: i32, flags: i32) -> i32

sys_sendto

pub sys_sendto :: fn(s: usize, buf: *const u8, len: i32, flags: i32, to: *const u8, tolen: i32) -> i32

sys_recvfrom

pub sys_recvfrom :: fn(s: usize, buf: *u8, len: i32, flags: i32, from: *u8, fromlen: *i32) -> i32

sys_setsockopt

pub sys_setsockopt :: fn(s: usize, level: i32, opt: i32, val: *const u8, len: i32) -> i32

sys_getsockname

pub sys_getsockname :: fn(s: usize, name: *u8, namelen: *i32) -> i32

sys_ioctlsocket

pub sys_ioctlsocket :: fn(s: usize, cmd: u32, argp: *u32) -> i32

sys_shutdown

pub sys_shutdown :: fn(s: usize, how: i32) -> i32

sys_htons

pub sys_htons :: fn(x: u16) -> u16

host <-> network order for a 16-bit port (x86 little-endian)

sys_ntohs

pub sys_ntohs :: fn(x: u16) -> u16

AF_INET

pub AF_INET        :: 2

protocol constants

SOCK_STREAM

pub SOCK_STREAM    :: 1

SOCK_DGRAM

pub SOCK_DGRAM     :: 2

IPPROTO_TCP

pub IPPROTO_TCP    :: 6

IPPROTO_UDP

pub IPPROTO_UDP    :: 17

INVALID_SOCKET

pub INVALID_SOCKET :: 0xFFFFFFFFFFFFFFFFusize

SOCKET_ERROR

pub SOCKET_ERROR   :: -1

SOCKADDR_LEN

pub SOCKADDR_LEN   :: 16

SOL_SOCKET

pub SOL_SOCKET     :: 0xFFFF

setsockopt levels and options

SO_REUSEADDR

pub SO_REUSEADDR   :: 0x0004

SO_BROADCAST

pub SO_BROADCAST   :: 0x0020

SO_RCVTIMEO

pub SO_RCVTIMEO    :: 0x1006

SO_SNDTIMEO

pub SO_SNDTIMEO    :: 0x1005

TCP_NODELAY

pub TCP_NODELAY    :: 0x0001

FIONBIO

pub FIONBIO        :: 0x8004667Eu32

ioctlsocket non-blocking mode; argp != 0 enables

SHUT_RECV

pub SHUT_RECV      :: 0

shutdown() directions

SHUT_SEND

pub SHUT_SEND      :: 1

SHUT_BOTH

pub SHUT_BOTH      :: 2

WSAEWOULDBLOCK

pub WSAEWOULDBLOCK :: 10035

NetError

pub NetError :: errors {
    startup_failed,
    socket_failed,
    connect_failed,
    bind_failed,
    listen_failed,
    accept_failed,
    send_failed,
    recv_failed,
    option_failed,
    addr_failed,
    would_block,
    closed,
    unknown_host,
}

shared by all of std.net; the variant names the failed call, last_error() has the code

• startup_failed: WSAStartup
• socket_failed: socket()
• connect_failed: connect()
• bind_failed: bind()
• listen_failed: listen()
• accept_failed: accept()
• send_failed: send()/sendto()
• recv_failed: recv()/recvfrom()
• option_failed: setsockopt()/ioctlsocket()
• addr_failed: getsockname()
• would_block: a non-blocking call had no data ready
• closed: peer closed the connection
• unknown_host: a name with no address (resolve)

RawSockaddr

pub RawSockaddr :: struct {
    family: u16,
    port: u16,
    addr: u32,
    zero: u64,
}

sockaddr_in, 16 bytes: family, port and addr in network order, 8 zero bytes

raw_from

pub raw_from :: fn(sa: addr::SocketAddr) -> RawSockaddr

host order -> network order

addr_from_raw

pub addr_from_raw :: fn(r: RawSockaddr) -> addr::SocketAddr

network order -> host order

init

pub init :: fn() -> void ! NetError

must be called once per process before any socket call

cleanup

pub cleanup :: fn()

optional, at process exit

last_error

pub last_error :: fn() -> i32

last Winsock error on this thread

is_would_block

pub is_would_block :: fn() -> bool

last error was WSAEWOULDBLOCK