Provided by: manpages-de-dev_1.11-1_all 
BEZEICHNUNG
res_ninit, res_nquery, res_nsearch, res_nquerydomain, res_nmkquery, res_nsend, res_init,
res_query, res_search, res_querydomain, res_mkquery, res_send, dn_comp, dn_expand -
Resolver-Routinen
ÜBERSICHT
#include <netinet/in.h>
#include <arpa/nameser.h>
#include <resolv.h>
#include <netinet/in.h>
#include <arpa/nameser.h>
#include <resolv.h>
extern struct __res_state _res;
struct __res_state;
typedef struct __res_state *res_state;
int res_ninit(void);
int res_nquery(res_state statep,
const char *dname, int class, int type,
unsigned char *answer, int anslen);
int res_nsearch(res_state statep,
const char *dname, int class, int type,
unsigned char *answer, int anslen);
int res_nquerydomain(res_state statep,
const char *name, const char *domain,
int class, int type, unsigned char *answer,
int anslen);
int res_nmkquery(res_state statep,
int op, const char *dname, int class,
int type, const unsigned char *data, int datalen,
const unsigned char *newrr,
unsigned char *buf, int buflen);
int res_nsend(res_state statep,
const unsigned char *msg, int msglen,
unsigned char *answer, int anslen);
int dn_comp(const char *exp_dn, unsigned char *comp_dn,
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,
int length);
Deprecated
extern struct __res_state _res;
int res_init(void);
int res_query(const char *dname, int class, int type,
unsigned char *answer, int anslen);
int res_search(const char *dname, int class, int type,
unsigned char *answer, int anslen);
int res_querydomain(const char *name, const char *domain,
int class, int type, unsigned char *answer,
int anslen);
int res_mkquery(int op, const char *dname, int class,
int type, const unsigned char *data, int datalen,
const unsigned char *newrr,
unsigned char *buf, int buflen);
int res_send(const unsigned char *msg, int msglen,
unsigned char *answer, int anslen);
Linken Sie mit der Option -lresolv.
BESCHREIBUNG
Note: This page is incomplete (various resolver functions provided by glibc are not
described) and likely out of date.
Diese unten beschriebenen Funktionen stellen Anfragen an Internet Domain Nameserver und
interpretieren die Rückmeldungen.
The API consists of a set of more modern, reentrant functions and an older set of
nonreentrant functions that have been superseded. The traditional resolver interfaces such
as res_init() and res_query() use some static (global) state stored in the _res
structure, rendering these functions non-thread-safe. BIND 8.2 introduced a set of new
interfaces res_ninit(), res_nquery(), and so on, which take a res_state as their first
argument, so you can use a per-thread resolver state.
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.
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_query()/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 gewöhnlich QUERY, kann
aber jeder der in <arpa/nameser.h> definierten Typen sein. newrr wird momentan nicht
benutzt.
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.
The resolver routines use configuration and state information contained in a __res_state
structure (either passed as the statep argument, or in the global variable _res, in the
case of the older nonreentrant functions). The only field of this structure that is
normally manipulated by the user is the options field. This field can contain the bitwise
"OR" of the following options:
RES_INIT
Wahr, falls res_ninit() oder res_init() aufgerufen wurde.
RES_DEBUG
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.
RES_AAONLY
Akzeptiere nur autoritative Antworten. res_send() fährt fort, bis es eine
autoritative Antwort findet oder gibt einen Fehler zurück. [Noch nicht
implementiert.]
RES_USEVC
TCP-Verbindungen statt UDP-Datagramme für Anfragen benutzen.
RES_PRIMARY
Nur primäre Domainnameserver abfragen. [Derzeit nicht implementiert.]
RES_IGNTC
Ignoriere Fehler bei verstümmelten Antworten. Versuche es nicht erneut mit TCP.
RES_RECURSE
Setze das Rekursionswunsch-Bit in Anfragen. Rekursion wird von dem Domainnameserver
ausgeführt, nicht von res_send(). [Standardmäßig eingeschaltet]
RES_DEFNAMES
Falls gesetzt fügt res_search() den Vorgabedomainnamen an Einzelkomponentennamen
an, d.h. an solchen, die keinen Punkt enthalten. [Standardmäßig eingeschaltet]
RES_STAYOPEN
Benutzt mit RES_USEVC um die TCP-Verbindung zwischen Anfragen geöffnet zu halten.
RES_DNSRCH
Falls gesetzt, sucht res_search() nach Hostnamen in der aktuellen und in
übergeordneten Domains. Diese Option wird von gethostbyname(3) benutzt.
[Eingeschaltet durch Vorgabe.]
RES_INSECURE1
Accept a response from a wrong server. This can be used to detect potential
security hazards, but you need to compile glibc with debugging enabled and use
RES_DEBUG option (for debug purpose only).
RES_INSECURE2
Accept a response which contains a wrong query. This can be used to detect
potential security hazards, but you need to compile glibc with debugging enabled
and use RES_DEBUG option (for debug purpose only).
RES_NOALIASES
Disable usage of HOSTALIASES environment variable.
RES_USE_INET6
Try an AAAA query before an A query inside the gethostbyname() function, and map
IPv4 responses in IPv6 "tunneled form" if no AAAA records are found but an A record
set exists.
RES_ROTATE
Causes round-robin selection of name servers from among those listed. This has the
effect of spreading the query load among all listed servers, rather than having all
clients try the first listed server first every time.
RES_NOCHECKNAME
Disable the modern BIND checking of incoming hostnames and mail names for invalid
characters such as underscore (_), non-ASCII, or control characters. [Not currently
implemented].
RES_KEEPTSIG
Do not strip TSIG records. [Not currently implemented].
RES_BLAST
Send each query simultaneously and recursively to all servers. Note this option
overrides RES_ROTATE.
RES_USEBSTRING (seit Glibc 2.3.4)
Make reverse IPv6 lookups using the bit-label format described in RFC 2673; if this
option is not set, then nibble format is used.
RES_NOIP6DOTINT
Use ip6.arpa zone in IPv6 reverse lookup instead of ip6.int, which is deprecated
since glibc 2.3.4. [Enabled by default].
RES_USE_EDNS0 (seit Glibc 2.6)
Enables support for the DNS extensions (EDNS0) described in RFC 2671.
RES_SNGLKUP (seit Glibc 2.10)
By default, glibc performs IPv4 and IPv6 lookups in parallel since version 2.9.
Some appliance DNS servers cannot handle these queries properly and make the
requests time out. This option disables the behavior and makes glibc perform the
IPv6 and IPv4 requests sequentially (at the cost of some slowdown of the resolving
process).
RES_SNGLKUPREOP
When RES_SNGLKUP option is enabled, opens a new socket for the each request.
RES_USE_DNSSEC
Use DNSSEC with OK bit in OPT record. This option implies RES_USE_EDNS0.
RES_NOTLDQUERY
Do not look up unqualified name as a top-level domain (TLD).
RES_DEFAULT
Default option which implies: RES_RECURSE, RES_DEFNAMES, RES_DNSRCH and
RES_NOIP6DOTINT.
RÜCKGABEWERT
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.
DATEIEN
/etc/resolv.conf Resolver-Konfigurationsdatei
/etc/host.conf Resolver-Konfigurationsdatei
ATTRIBUTE
Siehe attributes(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke.
┌───────────────────────────────────┬───────────────────────┬────────────────┐
│Schnittstelle │ Attribut │ Wert │
├───────────────────────────────────┼───────────────────────┼────────────────┤
│res_ninit(), res_nquery(), │ Multithread-Fähigkeit │ MT-Safe locale │
│res_nsearch(), res_nquerydomain(), │ │ │
│res_nsend() │ │ │
├───────────────────────────────────┼───────────────────────┼────────────────┤
│res_nmkquery(), dn_comp(), │ Multithread-Fähigkeit │ MT-Safe │
│dn_expand() │ │ │
└───────────────────────────────────┴───────────────────────┴────────────────┘
KONFORM ZU
4.3BSD.
SIEHE AUCH
gethostbyname(3), resolv.conf(5), resolver(5), hostname(7), named(8)
The GNU C library source file resolv/README.
KOLOPHON
Diese Seite ist Teil der Veröffentlichung 4.04 des Projekts Linux-man-pages. 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/.
ÜBERSETZUNG
Die deutsche Übersetzung dieser Handbuchseite wurde von Martin Eberhard Schauer
<Martin.E.Schauer@gmx.de> 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 <debian-l10n-german@lists.debian.org>.