.\" -*- coding: UTF-8 -*- .\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk) .\" .\" %%%LICENSE_START(VERBATIM) .\" 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. .\" %%%LICENSE_END .\" .\" References consulted: .\" Linux libc source code .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified 1993-07-25 by Rik Faith (faith@cs.unc.edu) .\" Modified 2004-10-31 by aeb .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH RESOLVER 3 "28. Mai 2014" GNU Linux\-Programmierhandbuch .SH BEZEICHNUNG res_init, res_query, res_search, res_querydomain, res_mkquery, res_send, dn_comp, dn_expand \- Resolver\-Routinen .SH ÜBERSICHT .nf \fB#include \fP \fB#include \fP \fB#include \fP \fBextern struct __res_state _res;\fP .sp \fBint res_init(void);\fP .sp \fBint res_query(const char *\fP\fIdname\fP\fB, int \fP\fIclass\fP\fB, int \fP\fItype\fP\fB,\fP .RS \fBunsigned char *\fP\fIanswer\fP\fB, int \fP\fIanslen\fP\fB);\fP .RE .sp \fBint res_search(const char *\fP\fIdname\fP\fB, int \fP\fIclass\fP\fB, int \fP\fItype\fP\fB,\fP .RS \fBunsigned char *\fP\fIanswer\fP\fB, int \fP\fIanslen\fP\fB);\fP .RE .sp \fBint res_querydomain(const char *\fP\fIname\fP\fB, const char *\fP\fIdomain\fP\fB,\fP .RS \fBint \fP\fIclass\fP\fB, int \fP\fItype\fP\fB, unsigned char *\fP\fIanswer\fP\fB,\fP \fBint \fP\fIanslen\fP\fB);\fP .RE .sp \fBint res_mkquery(int \fP\fIop\fP\fB, const char *\fP\fIdname\fP\fB, int \fP\fIclass\fP\fB,\fP .RS \fBint \fP\fItype\fP\fB, const unsigned char *\fP\fIdata\fP\fB, int \fP\fIdatalen\fP\fB,\fP \fBconst unsigned char *\fP\fInewrr\fP\fB, unsigned char *\fP\fIbuf\fP\fB, int \fP\fIbuflen\fP\fB);\fP .RE .sp \fBint res_send(const unsigned char *\fP\fImsg\fP\fB, int \fP\fImsglen\fP\fB,\fP .RS \fBunsigned char *\fP\fIanswer\fP\fB, int \fP\fIanslen\fP\fB);\fP .RE .sp \fBint dn_comp(const char *\fP\fIexp_dn\fP\fB, unsigned char *\fP\fIcomp_dn\fP\fB,\fP .RS \fBint \fP\fIlength\fP\fB, unsigned char **\fP\fIdnptrs\fP\fB, unsigned char **\fP\fIlastdnptr\fP\fB);\fP .RE .sp \fBint dn_expand(const unsigned char *\fP\fImsg\fP\fB, const unsigned char *\fP\fIeomorig\fP\fB,\fP .RS \fBconst unsigned char *\fP\fIcomp_dn\fP\fB, char *\fP\fIexp_dn\fP\fB,\fP \fBint \fP\fIlength\fP\fB);\fP .RE .fi .sp Linken Sie mit der Option \fI\-lresolv\fP. .SH BESCHREIBUNG Diese Funktionen stellen Anfragen an Internet Domain Nameserver und interpretieren die Rückmeldungen. .PP Die Funktion \fBres_init\fP() liest die Konfigurationsdateien (siehe \fBresolv.conf\fP(5)), 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 dem lokalen Host zugeordnet ist. Dies kann mit der Umgebungsvariablen \fBLOCALDOMAIN\fP überschrieben werden. \fBres_init\fP() wird normalerweise durch den ersten Aufruf von einer der anderen Funktionen ausgeführt. .PP Die Funktion \fBres_query\fP() fragt den Nameserver nach dem vollständigen Domain\-Namen \fIname\fP des spezifizierten Typs \fItype\fP und der Klasse \fIclass\fP. Die Antwort verbleibt im Puffer \fIanswer\fP der Länge \fIanslen\fP, der vom Aufrufenden bereitgestellt wurde. .PP Die Funktion \fBres_search\fP() stellt eine Anfrage und wartet wie \fBres_query\fP() auf die Antwort, implementiert jedoch zusätzlich die Vorgabe\- und Such\-Regeln, die durch \fBRES_DEFNAMES\fP und \fBRES_DNSRCH\fP gesteuert werden (siehe im Folgenden die Beschreibung der \fI_res\fP\-Optionen). .PP Die Funktion \fBres_querydomain\fP() macht mittels \fBres_query\fP() eine Anfrage auf die Verkettung von \fIname\fP und \fIdomain\fP. .PP Die folgenden Funktionen sind Routinen tieferer Ebene, die von \fBres_query\fP() benutzt werden. .PP Die Funktion \fBres_mkquery\fP() konstruiert eine Anfragenachricht für den Domain\-Namen \fIdname\fP in \fIbuf\fP der Länge \fIbuflen\fP. Der Anfragetyp \fIop\fP ist gewöhnlich \fBQUERY\fP, kann aber jeder der in \fI\fP definierten Typen sein. \fInewrr\fP wird momentan nicht benutzt. .PP Die Funktion \fBres_send\fP() sendet eine vorformatierte Anfrage, die in \fImsg\fP gegeben ist und die Länge \fImsglen\fP hat und gibt die Antwort in \fIanswer\fP zurück, die die Länge \fIanslen\fP hat. Sie ruft \fBres_init\fP() auf, falls sie noch nicht aufgerufen wurde. .PP Die Funktion \fBdn_comp\fP() komprimiert den Domain\-Namen \fIexp_dn\fP und speichert ihn in dem Puffer \fIcomp_dn\fP der Länge \fIlength\fP. Die Komprimierung benutzt ein Feld von Zeigern \fIdnptrs\fP 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 \fIlastdnptr\fP. Wenn \fIdnptr\fP NULL ist, dann sind Domain\-Namen nicht komprimiert. Wenn \fIlastdnptr\fP NULL ist, dann wird die Liste der Namen nicht aktualisiert. .PP Die Funktion \fBdn_expand\fP() expandiert den komprimierten Domain\-Namen \fIcomp_dn\fP zu einem vollen Domain\-Namen, welcher in dem Puffer \fIexp_dn\fP der Größe \fIlength\fP platziert ist. Der komprimierte Name ist in einer Anfrage\- oder Antwortnachricht enthalten und \fImsg\fP zeigt auf den Anfang der Nachricht. .PP Die Resolver\-Routinen benutzen globale Konfigurations\- und Statusinformationen, die in der Struktur \fI_res\fP enthalten sind, welche in \fI\fP definiert ist. Das einzige Feld, das normalerweise vom Benutzer manipuliert wird, ist \fI_res.options\fP. Dieses Feld kann bitweise Oder\-Verknüpfungen der folgenden Optionen enthalten: .TP \fBRES_INIT\fP Wahr, falls \fBres_init\fP() aufgerufen wurde. .TP \fBRES_DEBUG\fP .\" See resolv/README. .\" Support for RES_DEBUG was made conditional in glibc 2.2. Gibt Debugging\-Meldungen aus. Diese Option ist nur dann verfügbar, wenn glibc mit Debugging\-Unterstützung kompiliert wurde, was allerdings nicht die Vorgabe ist. .TP \fBRES_AAONLY\fP Akzeptiere nur autoritative Antworten. \fBres_send\fP() fährt fort, bis es eine autoritative Antwort findet oder gibt einen Fehler zurück. [Noch nicht implementiert.] .TP \fBRES_USEVC\fP TCP\-Verbindungen statt UDP\-Datagramme für Anfragen benutzen. .TP \fBRES_PRIMARY\fP Nur primäre Domainnameserver abfragen. .TP \fBRES_IGNTC\fP Ignoriere Fehler bei verstümmelten Antworten. Versuche es nicht erneut mit TCP. [Noch nicht implementiert.] .TP \fBRES_RECURSE\fP Setze das Rekursionswunsch\-Bit in Anfragen. Rekursion wird von dem Domainnameserver ausgeführt, nicht von \fBres_send\fP(). [Standardmäßig eingeschaltet] .TP \fBRES_DEFNAMES\fP Falls gesetzt fügt \fBres_search\fP() den Vorgabedomainnamen an Einzelkomponentennamen an, d.h. an solchen, die keinen Punkt enthalten. [Standardmäßig eingeschaltet] .TP \fBRES_STAYOPEN\fP Benutzt mit \fBRES_USEVC\fP um die TCP\-Verbindung zwischen Anfragen geöffnet zu halten. .TP \fBRES_DNSRCH\fP Falls gesetzt, sucht \fBres_search\fP() nach Hostnamen in der aktuellen und in übergeordneten Domains. Diese Option wird von \fBgethostbyname\fP(3) benutzt. [Eingeschaltet durch Vorgabe.] .PP Diese Liste ist unvollständig. Sie finden die Beschreibung einiger weiterer Schalter in \fBresolv.conf\fP(5). .SH RÜCKGABEWERT Die Funktion \fBres_init\fP() gibt 0 bei Erfolg zurück oder \-1, falls ein Fehler auftritt. .PP Die Funktionen \fBres_query\fP(), \fBres_search\fP(), \fBres_querydomain\fP(), \fBres_mkquery\fP() und \fBres_send\fP() geben die Länge der Antwort zurück oder \-1, falls ein Fehler auftritt. .PP Die Funktionen \fBdn_comp\fP() und \fBdn_expand\fP() geben die Länge des komprimierten Namens zurück oder \-1, falls ein Fehler auftritt. .SH DATEIEN .nf /etc/resolv.conf Resolver\-Konfigurationsdatei /etc/host.conf Resolver\-Konfigurationsdatei .fi .SH "KONFORM ZU" 4.3BSD. .SH "SIEHE AUCH" \fBgethostbyname\fP(3), \fBresolv.conf\fP(5), \fBresolver\fP(5), \fBhostname\fP(7), \fBnamed\fP(8) .SH KOLOPHON Diese Seite ist Teil der Veröffentlichung 3.74 des Projekts Linux\-\fIman\-pages\fP. Eine Beschreibung des Projekts, Informationen, wie Fehler gemeldet werden können sowie die aktuelle Version dieser Seite finden sich unter \%http://www.kernel.org/doc/man\-pages/. .SH ÜBERSETZUNG Die deutsche Übersetzung dieser Handbuchseite wurde von Martin Eberhard Schauer 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 .