std.net.dhcp

DHCP-Client nach RFC 2131 — vollständige IP-Adressvergabe über UDP-Broadcast. Deckt den gesamten DORA-Prozess ab (Discover → Offer → Request → Acknowledge) und stellt Paket-Builder, Reply-Parser und High-Level-Lease-Funktion bereit.

import std.net.dhcp;
import std.alloc;

// Vollständigen Lease in einem Aufruf holen
var mac:    int64 := alloc(6);
var result: int64 := alloc(DHCP_RESULT_SIZE);
// mac mit 6 Byte Ethernet-Adresse befüllen ...
poke8(mac, 0xAA);  poke8(mac+1, 0xBB);  // ...

if (DhcpLease(mac, result) == 0) {
    var ip:    int64 := peek64(result + DHCP_RESULT_IP);
    var gw:    int64 := peek64(result + DHCP_RESULT_GW);
    var lease: int64 := peek64(result + DHCP_RESULT_LEASE);
}
free(result, DHCP_RESULT_SIZE);
free(mac, 6);

Berechtigung: Port 68 < 1024 — erfordert root oder CAP_NET_BIND_SERVICE.

• std.net.socket
• std.net.syscalls
• std.net.types
• std.alloc

Wird vom Caller alloziert und mit Nullen initialisiert. DhcpParseReply, DhcpDiscover, DhcpRequest und DhcpLease schreiben hinein.

Alle IP-Adressen sind im selben gepackten Format wie IPPack() aus std.net.types gespeichert (Big-Endian uint32 in int64).

Client                          Server (255.255.255.255:67)
   |                                 |
   |── DHCPDISCOVER (Broadcast) ────>|  xid = MAC[0..3]
   |<─ DHCPOFFER ────────────────────|  yiaddr=192.168.1.100, srv=192.168.1.1
   |                                 |
   |── DHCPREQUEST (Broadcast) ─────>|  opt50=192.168.1.100, opt54=192.168.1.1
   |<─ DHCPACK ──────────────────────|  Lease bestätigt, Lease-Zeit: 43200s

DhcpLease() führt den gesamten Ablauf durch. DhcpDiscover() und DhcpRequest() erlauben manuelle Steuerung (z. B. für Fehlerbehandlung oder Logging zwischen den Schritten).

import std.net.dhcp;
import std.net.types;
import std.alloc;

fn acquireLease(mac: int64): int64 {
    var result: int64 := alloc(DHCP_RESULT_SIZE);
    var xid:    int64 := peek8(mac);
    xid := (xid << 8) | peek8(mac + 1);
    xid := (xid << 8) | peek8(mac + 2);
    xid := (xid << 8) | peek8(mac + 3);

    if (DhcpDiscover(mac, xid, result) < 0) {
        free(result, DHCP_RESULT_SIZE);
        return 0 - 1;
    }

    var offeredIP: int64 := peek64(result + DHCP_RESULT_IP);
    var srvIP:     int64 := peek64(result + DHCP_RESULT_SERVER);
    // Hier könnte Validierung des OFFER stattfinden ...

    if (DhcpRequest(mac, xid, result) < 0) {
        free(result, DHCP_RESULT_SIZE);
        return 0 - 1;
    }

    var ip:    int64 := peek64(result + DHCP_RESULT_IP);
    var mask:  int64 := peek64(result + DHCP_RESULT_MASK);
    var gw:    int64 := peek64(result + DHCP_RESULT_GW);
    var dns:   int64 := peek64(result + DHCP_RESULT_DNS);
    var lease: int64 := peek64(result + DHCP_RESULT_LEASE);

    // IP-Adresse z. B. an Netzwerk-Interface binden ...
    // Lease-Erneuerung nach lease/2 Sekunden nötig

    free(result, DHCP_RESULT_SIZE);
    return 0;
}

• Berechtigung: DhcpDiscover und DhcpRequest binden Port 68 — erfordert root oder CAP_NET_BIND_SERVICE. Auf Linux genügt: setcap cap_net_bind_service+ep ./programm.
• IP-Format: Alle IP-Adressen im Result-Struct verwenden das IPPack-Format aus std.net.types (Big-Endian uint32 in int64). Zum Anzeigen: IpToStr() verwenden.
• Timeout: DhcpDiscover und DhcpRequest warten je maximal 5 Sekunden auf eine Antwort (SocketCanRead(fd, 5000)). Kein automatischer Retry.
• Kein Lease-Renewal: Diese Unit macht keine automatische Lease-Erneuerung. Die Anwendung muss nach lease/2 Sekunden DhcpLease erneut aufrufen.
• XID: DhcpLease leitet die Transaction ID aus den ersten 4 MAC-Bytes ab. Bei mehreren gleichzeitigen Clients mit ähnlichen MACs kann es zu XID-Kollisionen kommen — in diesem Fall DhcpDiscover/DhcpRequest direkt mit einer zufälligen XID verwenden.
• DNS: Nur der erste DNS-Server (Byte 0–3 von Option 6) wird gespeichert. Mehrere DNS-Server werden ignoriert.
• BOOTP-Kompatibilität: Pakete sind mindestens 300 Bytes lang (DHCP_MIN_LEN) für ältere BOOTP-Server.

Letzte Aktualisierung: 2026-06-17