std.net.socket

Umfassende Socket-Abstraktion für TCP, UDP, Unix Domain Sockets und Raw Sockets. Ermöglicht den Aufbau von Client- und Serveranwendungen auf Netzwerkebene – von einfachen Verbindungen bis hin zu nicht-blockierendem I/O mit Poll/Select-Multiplexing. Enthält außerdem Low-Level-Funktionen für ICMP-Ping, ARP-Paketgenerierung und Ethernet-Header-Erstellung.

Diese Unit bildet die Grundlage für alle höheren Netzwerkprotokolle in der Lyx-Standardbibliothek (HTTP, DNS, SMTP etc.).

import std.net.socket;

var listener: TCPListener := TCPListenerNew();
TCPListenerBind(listener, 8080);
TCPListenerListen(listener, 16);   // Backlog: wartende Verbindungen

var conn: TCPConn := TCPListenerAccept(listener);
TCPConnWrite(conn, "Hello\n", 6);
TCPConnClose(conn);

• std.net.types
• std.net.syscalls

Extern deklarierte Funktionen (aus C-Bibliotheken):

Die Unit deckt IPv6 durchgehend ab — von der Socket-Erzeugung bis zum Auslesen der Gegenstelle. Adressen werden als zwei int64-Hälften übergeben (ip6Hi, ip6Lo); die passenden Werte liefert std.net.types mit IPv6MakeHi/IPv6MakeLo, IPv6AnyHi/IPv6AnyLo und IPv6LoopbackHi/IPv6LoopbackLo.

Die drei out-Parameter sind Zeiger auf int64, nicht Rückgabewerte. Wer eine Angabe nicht braucht, übergibt dort 0 — die Funktion überspringt sie dann.

Nützlich, wenn der Port vom Kernel vergeben wurde — nach einem Bind auf Port 0 steht die tatsächlich belegte Nummer erst hier.

Beide liefern einen neuen Deskriptor. Liegt bei AcceptNonBlocking keine Verbindung an, ist das Ergebnis -11 (-EAGAIN) — das ist kein Fehler, sondern die übliche Antwort in einer Ereignisschleife (→ std.net.epoll).

Dass beide SOCK_CLOEXEC setzen, ist wichtiger als es aussieht: ohne dieses Flag erbt jeder mit fork/execve gestartete Kindprozess die offene Verbindung.

sendmmsg und recvmmsg übertragen mehrere Nachrichten mit einem einzigen Systemaufruf. Bei hohen Paketraten spart das den größten Einzelposten — den Wechsel in den Kernel und zurück.

iovOut ist ein alloc(8)-Puffer, in den MmsgAlloc den iov-Zeiger schreibt — die Funktion gibt also zwei Zeiger zurück, einen über den Rückgabewert und einen über diesen Parameter. Beide werden für MmsgFree gebraucht.

Der Rückgabewert von SendMmsg/RecvMmsg ist die Zahl der tatsächlich übertragenen Nachrichten; sie kann kleiner als vlen sein.

<WRAP alert> Bis lyxc 1.1.1C lieferten alle zehn Options-Setter EFAULT zurück und wirkten nicht: optval wurde als Wert statt als Adresse an setsockopt übergeben, der Kernel las an Adresse 1 (#1611). Betroffen waren TCPConnSetNodelay, TCPConnSetKeepAlive, TCPConnSetRecvBuf, TCPConnSetSendBuf, TCPConnSetReuseAddr, TCPListenerSetReuseAddr, TCPListenerSetReusePort, UDPSocketSetReuseAddr, UDPSocketSetRecvBuf und UDPSocketSetSendBuf.

Schwerer wog der Lesepfad: TCPConnGetError und UDPSocketGetError lasen den Fehlerstand nie und meldeten deshalb immer 0 — „kein Fehler„. Im Connect-Pfad (revents & POLLOUT) galt eine Verbindung damit immer als erfolgreich, auch nach einem abgewiesenen Verbindungsversuch. </WRAP>

Beide Richtungen laufen jetzt über je einen Helfer, damit die Frage „Wert oder Adresse“ nur an einer Stelle beantwortet wird. Neu hinzugekommen ist UDPSocketSetBroadcast — die Option fehlte ganz, und ohne sie ist kein Rundruf möglich.

UDPSocketSetRecvTimeout(sock, sek, mikrosek) und UDPSocketSetSendTimeout(sock, sek, mikrosek) setzen SO_RCVTIMEO bzw. SO_SNDTIMEO; Rückgabe ist 0 bei Erfolg, sonst der negative Fehlercode. Läuft die Zeit ab, liefert UDPSocketRecv einen negativen Wert (EAGAIN), statt für immer zu blockieren.

Beide Setter brauchen eine timeval aus zwei 64-Bit-Werten — der Helfer für die einfachen int-Optionen schreibt nur vier Byte und taugt hier nicht. Eingezogen wurden sie für std.net.dns, wo eine ausbleibende Antwort den Aufrufer aufhängte (#1641).

UDPSocketSetRecvTimeout(sock, 2, 0);       // zwei Sekunden
var n: int64 := UDPSocketRecv(sock, buf, 512, 0, 0);
if (n < 0) { PrintLn("keine Antwort"); }

Letzte Aktualisierung: 2026-08-19 — UDPSocketSetRecvTimeout/UDPSocketSetSendTimeout ergänzt (#1641).

Vorherige Aktualisierung: 2026-08-18 — Options-Setter, Fehlerabfrage und UDPSocketSetBroadcast nachgezogen (#1611).