Networking

A small stack with a shared receive pump.

The NIC and the protocol stack live in the kernel; ring-3 commands drive them through SYS_NET_* and SYS_TCP_*. Packet-level commands still take the receiver exclusively through SYS_NET_ACQUIRE, while up to twelve processes can hold a TCP client connection at the same time. Every stack syscall drains the NIC through net_pump(), so downloads overlap without sharing one connection or one receive queue.

ARP · ICMP · UDP · TCP DHCP · DNS · NTP TLS 1.3 · X25519 netconsole + netkexec

Protocol stack

NebOS does not expose a general socket API. A ring-3 program asks the kernel for info and configuration, then either acquires the receiver for raw frame paths or opens one TCP client connection. Each connection has its own receive queue and is owned by one process; net_pump() dispatches frames to every active client, the WebDAV listener, a pending DNS query and the ARP cache. HTTP and TLS are libraries linked into the command, not kernel services.

NebOS network stack Ring-3 curl, browser and websrv use uhttp and TLS, then sys_net syscalls, then TCP/DNS/DHCP/NTP, IPv4/ARP/ICMP, netdev drivers and the NIC. curl · browser · websrv · ping · dhcp · settime ring-3 programs uhttp · tls.c HTTP/1.1 · redirects · chunked · TLS 1.3 kernel services sys_fs for WebDAV · netlog · netkexec SYS_NET_* · SYS_TCP_* · SYS_DNS_RESOLVE · SYS_DHCP_RUN · SYS_NTP_SYNC raw owner for packet commands · shared net_pump for TCP/DNS/ARP tcp.c · dns.c · dhcp.c TCP client table + listener · one pending A query · DISCOVER/OFFER/REQUEST/ACK IPv4 · ARP · ICMP · UDP · netdev registry · NIC driver
Thin kernel, thick command. The kernel owns addressing, ARP, routing and the shared TCP client table. HTTP, TLS and WebDAV run in ring 3, so a protocol bug kills a command rather than the kernel.

NIC drivers

netdev.c keeps a registry of struct netdev drivers; the first one whose probe succeeds becomes active. All drivers are polled and share the same transmit, receive, register-dump and reset interface. netdev with no argument shows the active driver; netdev asix switches to a named one, leaving the current driver untouched if the probe fails.

DriverHardwareTransportNotes
e1000e.cIntel 82540EM, 82577LM, 82578, 82579PCI MMIOPCI INTx disabled before MMIO; PCH D0; skips the global MAC reset while the link is up.
r8168.cRTL8111/8168PCIe MMIOC+ mode, 64-entry RX ring, polled.
ne2000.cRTL8029ISA / QEMU PCISimple DP8390 path used by make run-net.
asix.cAX88772USB bulkRuns over the USB core; usable on EHCI/xHCI dongles.

The management NIC used by netlog and netkexec prefers the ASIX dongle so a direct debug link survives netdev e1000e; otherwise it falls back to the active driver. netregs dumps registers and decoded interrupt status; netloop runs a PHY loopback self-test; netreset re-initialises the active NIC.

Link & IP layer

The static default address is 192.168.178.240. At boot, with a NIC present, a DHCP client runs with a 4-second budget (requesting the current address); if no server answers, the static address stays. The idle WM loop answers ARP/ICMP for the board's IP even when no command is running, so the board is reachable and MAC-resolvable.

DHCP, DNS & NTP

DHCP

dhcp.c is a minimal client: DISCOVER → OFFER → REQUEST → ACK. It learns the mask, gateway and DNS server (option 6), and dhcp re-runs it on demand. The configuration is retained across kexec through the boot-info BOOTINFO_FLAG_NET fields.

DNS

dns.c sends one recursive A query over UDP and handles name compression in the response. One query is in flight at a time; parallel stack callers wait for it and then hit a small five-minute A-record cache, so three browser workers asking for the same host cause one DNS query, not three. netdns shows or sets the server; host <name> resolves. Numeric hosts skip DNS entirely.

NTP

ntp.c is a minimal SNTP (RFC 4330) client: one 48-byte request to UDP port 123, three one-second tries, DNS unless the server is a dotted address, and the shared ARP/router path. An empty name uses pool.ntp.org. A reply is accepted only when it comes from the resolved server to the ephemeral source port, is a server/broadcast reply with a valid stratum, and echoes the request's origin timestamp; the transmit timestamp is converted from NTP's 1900 epoch to a UTC struct sys_datetime (with the 2036 era wrap handled). SYS_NTP_SYNC returns that value to ring 3; the Date & Time editor then writes it through SYS_RTC_SET. The service owns the raw receiver for the duration, so it reports SYS_NTP_EBUSY while another raw command or a TCP client is active.

NTP is unauthenticated. The origin-timestamp check rejects unrelated datagrams but does not authenticate the server; anyone who can answer for the configured name can set the board's clock. There is no NTS, no leap-second handling and no delay/dispersion estimation — the CMOS RTC only resolves seconds.

TCP

tcp.c implements a small client table, not a general socket layer: each process may hold one connect/send/receive/ close connection, and up to TCP_CLIENT_MAX (twelve) connections can be active. Every connection owns a 4 KB receive queue, so one socket's data can never be read or reset by another. The window update is sent whenever the application drains the queue, so a full queue cannot deadlock until the peer's zero-window probe.

New SYNs and data are also handed to tcp_srv_input() from the active connection's receive/send poll loops, not only between requests, so parallel gvfs clients make progress.

TLS 1.3

tls.c is a ring-3 client with a deliberately narrow cipher suite: TLS_CHACHA20_POLY1305_SHA256 and X25519 only. It is stream-oriented over the existing TCP connection and prints the leaf SHA-256 fingerprint for manual comparison.

Do not treat HTTPS as secure authentication. The cipher suite is real, but without certificate verification the connection authenticates nothing. Use it for confidentiality on a trusted network, not for secrets against an active attacker.

sys_net ABI & ownership

sys_net.c exposes NIC info, MAC/IP/mask/ gateway/DNS getters and setters, raw frame TX/RX, decode, reply, loopback, register dump, reset, speed and MAC overrides. It also exposes the DNS, DHCP and NTP clients and the TCP/HTTP helpers.

Netconsole & netkexec

netlog.c mirrors the serial console and terminal output to UDP port 19290. The mirror is on by default and broadcasts; netconsole host <laptop-ip> narrows it, netconsole off/on toggles it, and netlog <text> sends an ad-hoc line. The producer never blocks: a full buffer drops characters and reports it. The flush pauses while a raw command owns the receiver or a TCP/stack operation is active, so its broadcast traffic cannot compete with DNS/ARP replies.

netkexec.c receives a new kernel/rootfs over UDP port 19288 using KXN2, and a runtime command pack using KXNP. Datagrams are acknowledged with the next expected offset and verified with a 32-bit checksum before the jump or pack swap. On the host, make netmon and make net-dev wrap these protocols.

HTTP clients

The browser's helper requests identity encoding because inflating multi-megabyte pages in the UI process stalled. If a server still sends gzip, the browser's inflate hook pumps the UI while decoding.

Security posture

SurfaceStateConsequence
TLS certificatesNot verifiedEncryption without authentication; MITM is undetected.
TLS DRBGWeak (RDTSC/ticks/MAC)Not suitable for high-value secrets.
WebDAVNo authenticationAnyone on the LAN can read mounts and write /share.
NTPUnauthenticated SNTPAnyone who can answer for the server name can set the clock.
NIC ownershipRaw lease for packet commands; shared TCP client tableRaw commands are mutually exclusive; up to twelve processes can hold one TCP connection each. A killed owner is force-released.
Kernel/user isolationNone (identity map)A ring-3 bug can reach any mapped kernel page.

Source map