std.net.dns

DNS (Domain Name System) übersetzt Hostnamen in IP-Adressen und umgekehrt. Die Unit implementiert einen vollständigen DNS-Resolver über UDP mit Unterstützung für alle gängigen Record-Typen: A, AAAA, MX, NS, CNAME, TXT, PTR, SOA, SRV, CAA, DNSKEY und DS. Auflösungen können gegen den System-Resolver, Google Public DNS (8.8.8.8) oder Cloudflare DNS (1.1.1.1) gerichtet werden.

Einsatzbereiche sind Domainvalidierung, Mail-Routing (MX-Lookup), Infrastruktur-Abfragen, DNSSEC-Analysen und alle Anwendungen, die Hostnamen selbst auflösen müssen ohne auf libc-Resolver zu setzen.

import std.net.dns;
import std.alloc;

// Der Aufrufer stellt den Ergebnispuffer: 32 Byte Kopf, danach der Datenbereich.
var res: int64 := alloc(512);
if (DNSResolve("example.com"c as int64, 11, 0x08080808, res)) {
    DNSPrintIP(DNSResultGetIPv4(res));
}

DNSResolve nimmt vier Argumente: Hostname als Adresse, dessen Länge, den DNS-Server als gepackte IPv4-Adresse (0 = Voreinstellung) und den Ergebnispuffer. Es gibt keine Fassung mit nur einem Argument.

• std.net.socket
• std.net.types

Seit 1.0.20A wird nicht mehr jeder Name über das Netz abgefragt (#1330). Die Reihenfolge:

1. literale IPv4 — „127.0.0.1“ wird als Adresse erkannt, nicht als Name abgefragt
2. /etc/hosts — damit funktioniert „localhost“ und jeder dort eingetragene Name
3. Nameserver aus /etc/resolv.conf
4. Google DNS als Rückfall

import std.net.dns;
fn Zeige(name: pchar): void {
    var ip: int64 := GetHostByName(name);
    PrintLn("  ", name, " -> ", IntToStr((ip >> 24) & 255), ".", IntToStr((ip >> 16) & 255), ".",
            IntToStr((ip >> 8) & 255), ".", IntToStr(ip & 255));
}
fn main(): int64 {
    Zeige("127.0.0.1");
    Zeige("localhost");
    Zeige("example.com");
    return 0;
}

127.0.0.1 -> 127.0.0.1
  localhost -> 127.0.0.1
  example.com -> 172.66.147.243

Für alle Units mit einem host-Parameter heißt das: localhost und 127.0.0.1 funktionieren jetzt — betrifft unter anderem std.db.redis, std.net.imap, smtp, mongo, quic, telnet, ntp, https, rest und sip. Frühere Fassungen dieser Seiten schränkten auf „nur öffentlich auflösbare Namen„ ein; das gilt nicht mehr.

Eine Anfrage wartet zwei Sekunden auf Antwort und wird bis zu dreimal gestellt; danach schlägt die Auflösung fehl. Die Werte stehen als DNS_TIMEOUT_SEK und DNS_VERSUCHE in der Unit.

Bis lyxc 1.1.3B las DNSResolve die Antwort ohne jede Zeitgrenze: blieb das Paket aus — verworfene Anfrage, Paketverlust, unerreichbarer Server —, kehrte GetHostByName nie zurück (#1641). Bei UDP ist genau das der Normalfall, weil es keine Verbindung gibt, die abbricht. Gesetzt wird die Grenze über UDPSocketSetRecvTimeout aus std.net.socket.

Damit muss der Nameserver nicht im Programm stehen — es gilt, was das System vorgibt.

<WRAP alert> Ohne lesbare /etc/resolv.conf wird still 8.8.8.8 verwendet. Der Quelltext fällt auf Googles Nameserver zurück, wenn das Parsen kein Ergebnis liefert:

var ns: int64 := dns_parse_resolv_conf();
if (ns == 0) {
    ns := IPPack(8, 8, 8, 8);
}

Es gibt weder Meldung noch Rückgabewert, an dem sich das erkennen ließe. In abgeschotteten Umgebungen — Container ohne /etc/resolv.conf, chroot, seccomp-beschränkte Prozesse — gehen die Anfragen dann an einen fremden Anbieter, statt zu scheitern. Wer das ausschließen muss, verwendet DNSResolve mit ausdrücklich angegebenem Server. </WRAP>

Die 16 Plätze sind fest vergeben. Wer mehr verschiedene Namen abfragt, verdrängt ältere Einträge — für eine Handvoll wiederkehrender Ziele ist der Zwischenspeicher gedacht, nicht als allgemeiner Resolver-Cache.

DoH verpackt die Anfrage in HTTPS. Das verbirgt sie vor Beobachtern auf dem Weg und kommt durch Netze, die UDP/53 sperren — der Anbieter des DoH-Dienstes sieht die Anfragen dafür im Klartext.

outHi und outLo sind Zeiger auf int64 — die Funktion schreibt dorthin mit poke64. Die 16 Bytes im Ergebnis liegen ab Versatz 40 in Netzwerk-Byte-Order.

TCPConnectHostIPv6 ist der kürzeste Weg zu einer IPv6-Verbindung: es nimmt einen nullterminierten Namen und einen Port in Host-Byte-Order und liefert eine fertige TCPConn.

Letzte Aktualisierung: 2026-08-19 — Zeitgrenze und Wiederholungen der Auflösung ergänzt (#1641).

Vorherige Aktualisierung: 2026-08-18 — Kurzbeispiel auf die tatsächliche Signatur berichtigt; die Unit ist seit #1608 wieder übersetzbar (pchar/int64 waren nur halb umgestellt, 53 abhängige Dateien betroffen).