| resolver(3) | Library Functions Manual | resolver(3) |
res_ninit, res_nquery, res_nsearch, res_nquerydomain, res_nmkquery, res_nsend, res_nclose, res_init, res_query, res_search, res_querydomain, res_mkquery, res_send, dn_comp, dn_expand - Resolver-Routinen
Resolver-Bibliothek (libresolv, -lresolv)
#include <netinet/in.h> #include <arpa/nameser.h> #include <resolv.h>
struct __res_state; typedef struct __res_state *res_state;
int res_ninit(res_state statep);
void res_nclose(res_state statep);
int res_nquery(res_state statep,
const char *dname, int class, int type,
unsigned char answer[.anslen], int anslen);
int res_nsearch(res_state statep,
const char *dname, int class, int type,
unsigned char answer[.anslen], int anslen);
int res_nquerydomain(res_state statep,
const char *name, const char *domain,
int class, int type, unsigned char answer[.anslen],
int anslen);
int res_nmkquery(res_state statep,
int op, const char *dname, int class,
int type, const unsigned char data[.datalen], int datalen,
const unsigned char *newrr,
unsigned char buf[.buflen], int buflen);
int res_nsend(res_state statep,
const unsigned char msg[.msglen], int msglen,
unsigned char answer[.anslen], int anslen);
int dn_comp(const char *exp_dn, unsigned char comp_dn[.length],
int length, unsigned char **dnptrs,
unsigned char **lastdnptr);
int dn_expand(const unsigned char *msg,
const unsigned char *eomorig,
const unsigned char *comp_dn, char exp_dn[.length],
int length);
[[veraltet]] extern struct __res_state _res;
[[veraltet]] int res_init(void);
[[veraltet]]
int res_query(const char *dname, int class, int type,
unsigned char answer[.anslen], int anslen);
[[veraltet]]
int res_search(const char *dname, int class, int type,
unsigned char answer[.anslen], int anslen);
[[veraltet]]
int res_querydomain(const char *name, const char *domain,
int class, int type, unsigned char answer[.anslen],
int anslen);
[[veraltet]]
int res_mkquery(int op, const char *dname, int class,
int type, const unsigned char data[.datalen], int datalen,
const unsigned char *newrr,
unsigned char buf[.buflen], int buflen);
[[veraltet]]
int res_send(const unsigned char msg[.msglen], int msglen,
unsigned char answer[.anslen], int anslen);
Hinweis: Diese Seite ist unvollständig (verschiedene durch Glibc bereitgestellte Resolver-Funktionen sind nicht beschrieben) und ist wahrscheinlich veraltet.
Diese unten beschriebenen Funktionen stellen Anfragen an Internet Domain Nameserver und interpretieren die Rückmeldungen.
Das API besteht aus einer Gruppe von moderneren, wiedereintrittsfähigen Funktionen und einer älteren Gruppe von überholten, nicht wiedereintrittsfähigen Funktionen. Die traditionellen Resolver-Schnittstellen wie res_init() und res_query() verwenden einigen statischen (globalen) Zustand, der in der Struktur _res gespeichert ist, womit die Funktionen nicht Thread-sicher werden. BIND 8.2 führte eine Gruppe von neuen Schnittstellen res_ninit(), res_nquery() und so weiter ein, die res_state als erstes Argument übernehmen, so dass Sie pro Thread einen Resolver-Zustand verwenden können.
Die Funktionen res_ninit() und res_init() lesen die Konfigurationsdateien (siehe resolv.conf(5)), um den vorgegebenen Domainnamen und Nameserveradresse(n) zu erhalten. Wenn kein Server angegeben ist, wird der lokale Host verwendet. Wenn keine Domain angegeben ist, wird diejenige benutzt, die dem lokalen Host zugeordnet ist. Dies kann mit der Umgebungsvariablen LOCALDOMAIN überschrieben werden. res_ninit() oder res_init() werden normalerweise durch den ersten Aufruf von einer der anderen Funktionen ausgeführt. Jeder Aufruf an res_ninit() benötigt einen entsprechenden Aufruf an res_nclose(), um den durch res_ninit() und nachfolgende Aufrufe von res_nquery() reservierten Speicher freizugeben.
Die Funktionen res_nquery() und res_query() fragen den Nameserver nach dem vollständigen Domain-Namen name des spezifizierten Typs type und der Klasse class. Die Antwort verbleibt im Puffer answer der Länge anslen, der vom Aufrufenden bereitgestellt wurde.
Die Funktionen res_nsearch() und res_search() stellen eine Anfrage und wartet wie res_nquery() und res_query() auf die Antwort, implementieren jedoch zusätzlich die Vorgabe- und Such-Regeln, die durch RES_DEFNAMES und RES_DNSRCH gesteuert werden (siehe im Folgenden die Beschreibung der _res-Optionen).
Die Funktionen res_nquerydomain() und res_querydomain() stellen mittels res_nquery()/res_query() eine Anfrage auf die Verkettung von name und domain.
Die folgenden Funktionen sind Routinen tieferer Ebene, die von res_nquery()/res_query() benutzt werden.
Die Funktionen res_nmkquery() und res_mkquery() konstruieren eine Anfragenachricht für den Domain-Namen dname in buf der Länge buflen. Der Anfragetyp op ist einer der folgenden (typischerweise QUERY):
newrr wird derzeit nicht verwandt.
Die Funktionen res_nsend() und res_send() senden eine vorformatierte Anfrage, die in msg gegeben ist und die Länge msglen hat und gibt die Antwort in answer zurück, die die Länge anslen hat. Sie rufen res_ninit()/res_init() auf, falls sie noch nicht aufgerufen wurde.
Die Funktion dn_comp() komprimiert den Domain-Namen exp_dn und speichert ihn in dem Puffer comp_dn der Länge length. Die Komprimierung benutzt ein Feld von Zeigern dnptrs auf bereits komprimierte Namen in der aktuellen Nachricht. Der erste Zeiger zeigt auf den Anfang der Nachricht und die Liste endet mit NULL. Die Grenze des Feldes ist angegeben durch lastdnptr. Wenn dnptr NULL ist, dann sind Domain-Namen nicht komprimiert. Wenn lastdnptr NULL ist, dann wird die Liste der Namen nicht aktualisiert.
Die Funktion dn_expand() expandiert den komprimierten Domain-Namen comp_dn zu einem vollen Domain-Namen, welcher in dem Puffer exp_dn der Größe length platziert ist. Der komprimierte Name ist in einer Anfrage- oder Antwortnachricht enthalten und msg zeigt auf den Anfang der Nachricht.
Die Resolver-Routinen benutzen in einer Struktur __res_state (entweder als Argument statep übergeben oder im Falle der älteren, nicht wiedereintrittsfähigen Funktion als globale Variable _res) enthaltende Konfigurations- und Zustandsinformationen. Das einzige Feld in dieser Struktur, das normalerweise vom Benutzer manipuliert wird, ist das Feld options. Dieses Feld kann bitweise Oder-Verknüpfungen der folgenden Optionen enthalten:
Die Funktionen res_ninit() und res_init() geben 0 bei Erfolg zurück oder -1, falls ein Fehler auftritt.
Die Funktionen res_nquery(), res_query(), res_nsearch(), res_search(), res_nquerydomain(), res_querydomain(), res_nmkquery(), res_mkquery(), res_nsend() und res_send() geben die Länge der Antwort zurück oder -1, falls ein Fehler auftritt.
Die Funktionen dn_comp() und dn_expand() geben die Länge des komprimierten Namens zurück oder -1, falls ein Fehler auftritt.
Falls mit einem Fehler von res_nquery(), res_query(), res_nsearch(), res_search(), res_nquerydomain() oder res_querydomain() zurückgekehrt wird, kann die globale Variable h_errno (siehe gethostbyname(3)) zur Bestimmung der Fehlerursache herangezogen werden.
Siehe attributes(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke.
| Schnittstelle | Attribut | Wert |
| res_ninit(), res_nclose(), res_nquery(), res_nsearch(), res_nquerydomain(), res_nsend() | Multithread-Fähigkeit | MT-Safe locale |
| res_nmkquery(), dn_comp(), dn_expand() | Multithread-Fähigkeit | MT-Safe |
4.3BSD.
gethostbyname(3), resolv.conf(5), resolver(5), hostname(7), named(8)
Die Quelldatei der GNU-C-Bibliothek resolv/README.
Die deutsche Übersetzung dieser Handbuchseite wurde von Martin Eberhard Schauer <Martin.E.Schauer@gmx.de>, Dr. Tobias Quathamer <toddy@debian.org>, Helge Kreutzmann <debian@helgefjell.de> und Mario Blättermann <mario.blaettermann@gmail.com> erstellt.
Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.
Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Übersetzer.
| 5. Februar 2023 | Linux man-pages 6.03 |