.\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk) .\" .\" Permission is granted to make and distribute verbatim copies of this .\" manual provided the copyright notice and this permission notice are .\" preserved on all copies. .\" .\" Permission is granted to copy and distribute modified versions of this .\" manual under the conditions for verbatim copying, provided that the .\" entire resulting derived work is distributed under the terms of a .\" permission notice identical to this one .\" .\" Since the Linux kernel and libraries are constantly changing, this .\" manual page may be incorrect or out-of-date. The author(s) assume no .\" responsibility for errors or omissions, or for damages resulting from .\" the use of the information contained herein. The author(s) may not .\" have taken the same level of care in the production of this manual, .\" which is licensed free of charge, as they might when working .\" professionally. .\" .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" .\" References consulted: .\" Linux libc source code .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Sun Jul 25 11:01:53 1993 by Rik Faith (faith@cs.unc.edu) .\" Translated to German Sun Nov 10 1996 by Patrick Rother .\" .TH RESOLVER 3 "10. November 1996" "BSD" "Bibliotheksfunktionen" .SH BEZEICHNUNG res_init, res_query, res_search, res_querydomain, res_mkquery, res_send, dn_comp, dn_expand \- Resolverroutinen .SH ÜBERSICHT .nf .B #include .B #include .B #include .B extern struct state _res; .sp .B int res_init(void); .sp .BI "int res_query(const char *" dname ", int " class ", int " type , .RS .BI "unsigned char *" answer ", int " anslen ); .RE .sp .BI "int res_search(const char *" dname ", int " class ", int " type , .RS .BI "unsigned char *" answer ", int " anslen ); .RE .sp .BI "int res_querydomain(const char *" name ", const char *" domain , .RS .BI "int " class ", int " type ", unsigned char *" answer ", int " anslen ); .RE .sp .BI "int res_mkquery(int " op ", const char *" dname ", int " class ", int " type , .RS .BI "char *" data ", int " datalen ", struct rrec *" newrr ", char *" buf , .BI "int " buflen ); .RE .sp .BI "int res_send(const char *" msg ", int " msglen ", char *" answer , .RS .BI "int " anslen ); .RE .sp .BI "int dn_comp(unsigned char *" exp_dn ", unsigned char *" comp_dn , .RS .BI "int " length ", unsigned char **" dnptrs ", unsigned char *" exp_dn , .BI "unsigned char **" lastdnptr ); .RE .sp .BI "int dn_expand(unsigned char *" msg ", unsigned char *" eomorig , .RS .BI "unsigned char *" comp_dn ", unsigned char *" exp_dn ", int " length ); .RE .fi .SH BESCHREIBUNG Diese Funktionen machen Anfragen an Internet Domain Nameserver und interpretieren die Rückmeldungen. .PP Die Funktion .B res_init() liest die Konfigurationsdateien (siehe .BR resolv+ (8)), um den vorgegebenen Domainnamen, die Suchreihenfolge und Nameserveradresse(n) zu erhalten. Wenn kein Server angegeben ist, wird der lokale Host verwendet. Wenn keine Domain angegeben ist, wird diejenige benutzt, die mit dem lokalen Host in Verbindung gebracht wird. Dies kann mit der Umgebungsvariable LOCALDOMAIN überschrieben werden . .B res_init() wird normalerweise durch den ersten Aufruf von einer der anderen Funktionen ausgeführt. .PP Die Funktion .B res_query() fragt den Nameserver nach dem vollständigen Host- und Domainnamen von .I name vom spezifizierten .IR type " und " class . Die Antwort verbleibt im Puffer .I answer der Länge .IR anslen , der von Aufrufer angegeben ist. .PP Die Funktion .B res_search() macht eine Anfrage und wartet auf die Antwort wie .BR res_query() , implementiert jedoch zusätzlich die Vorgabe- und Such-Regeln, die durch RES_DEFNAMES und RES_DNSRCH kontrolliert werden (siehe Beschreibung von .IR _res "-Optionen unten)." .PP Die Funktion .B res_querydomain() macht eine Anfrage über .B res_query() auf die Verkettung von .IR name " und " domain . .PP Die folgenden Funktionen sind Routinen tieferer Ebene, die von .B res_query() benutzt werden. .PP Die Funktion .B res_mkquery() konstruiert eine Anfrage-Nachricht für den Domainnamen .IR dname " in " buf der Länge .IR buflen . Der Anfragetyp .I op ist gewöhnlich QUERY, kann aber jeder der in .I definierten Typen sein. .I newrr ist momentan unbenutzt. .PP Die Funktion .B res_send() sendet eine vorformatierte Anfrage, die in .I msg gegeben ist und die Länge .I msglen hat, und gibt die Antwort in .I answer zurück, die die Länge .I anslen hat. Sie ruft .B res_init() auf, wenn es noch nicht aufgerufen wurde. .PP Die Funktion .B dn_comp() komprimiert den Domainnamen .I exp_dn und speichert ihn in dem Puffer .I comp_dn der Länge .IR length . Die Komprimierung benutzt ein Feld von Zeigern .I 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 .IR lastdnptr . Wenn .I dnptr NULL ist, dann sind Domainnamen nicht komprimiert. Wenn .I lastdnptr NULL ist, dann ist die Liste der Namen nicht aktualisiert. .PP Die Funktion .B dn_expand() expandiert den komprimierten Domainnamen .I comp_dn zu einem vollen Domainnamen, welcher in dem Puffer .I exp_dn der Größe .I length platziert ist. Der komprimierte Name ist enthalten in einer Anfrage- oder Antwortnachricht, und .I msg zeigt auf den Anfang der Nachricht. .PP Die Resolverroutinen benutzen globale Konfigurations- und Statusinformationen, die in der Struktur .I _res enthalten sind, welche in .I definiert ist. Das einzige Feld, das normalerweise vom Benutzer manipuliert wird, ist .IR _res.options . Dieses Feld kann bitweise oder-Verknüpfungen der folgenden Optionen enthalten: .sp .TP .B RES_INIT Wahr wenn .B res_init() aufgerufen wurde. .TP .B RES_DEBUG Drucke Debugnachrichten. .TP .B RES_AAONLY Akzeptiere nur autoritative Antworten. .B res_send() fährt fort bis es eine autoritative Antwort findet, oder gibt einen Fehler zurück. [Noch nicht implementiert.] .TP .B RES_USEVC Benutze TCP-Verbindungen für Anfragen, nicht UDP-Datagramme. .TP .B RES_PRIMARY Frage nur primäre Domainnameserver. .TP .B RES_IGNTC Ignoriere Fehler bei verstümmelten Antworten. Versuche es nicht erneut mit TCP. [Noch nicht implementiert.] .TP .B RES_RECURSE Setze das Rekursionswunsch-Bit in Anfragen. Rekursion wird von dem Domainnameserver ausgeführt, nicht von .BR res_send() . [Eingeschaltet durch Vorgabe.] .TP .B RES_DEFNAMES Wenn gesetzt, fügt .B res_search() den Vorgabedomainnamen an Einzelnamen an, d.h. an solche, die keinen Punkt enthalten. [Eingeschaltet durch Vorgabe.] .TP .B RES_STAYOPEN Benutzt mit .B RES_USEVC um die TCP-Verbindung zwischen Anfragen geöffnet zu halten. .TP .B RES_DNSRCH Wenn gesetzt, sucht .B res_search() nach Hostnamen in der aktuellen und in übergeordneten Domains. Diese Option wird von .BR gethostbyname (3) benutzt. [Eingeschaltet durch Vorgabe.] .SH "RÜCKGABEWERT" Die Funktion .B res_init() gibt 0 zurück be Erfolg, oder \-1 wenn ein Fehler auftritt. .PP Die Funktionen .BR res_query() ", " res_search() ", " res_querydomain() , .BR res_mkquery() " und " res_send() geben die Länge der Antwort zurück, oder \-1 wenn ein Fehler auftritt. .PP Die Funktionen .BR dn_comp() " und " dn_expand() geben die Länge des komprimierten Namens zurück, oder \-1 wenn ein Fehler auftritt. .SH DATEIEN .TP .I /etc/resolv.conf Resolverkonfigurationsdatei .TP .I /etc/host.conf Resolverkonfigurationsdatei .fi .SH "KONFORM ZU" BSD 4.3 .SH "SIEHE AUCH" .BR gethostbyname (3), .BR hostname (7), .BR named (8), .BR resolv+ (8).