1 .\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk)
3 .\" Permission is granted to make and distribute verbatim copies of this
4 .\" manual provided the copyright notice and this permission notice are
5 .\" preserved on all copies.
7 .\" Permission is granted to copy and distribute modified versions of this
8 .\" manual under the conditions for verbatim copying, provided that the
9 .\" entire resulting derived work is distributed under the terms of a
10 .\" permission notice identical to this one
12 .\" Since the Linux kernel and libraries are constantly changing, this
13 .\" manual page may be incorrect or out-of-date. The author(s) assume no
14 .\" responsibility for errors or omissions, or for damages resulting from
15 .\" the use of the information contained herein. The author(s) may not
16 .\" have taken the same level of care in the production of this manual,
17 .\" which is licensed free of charge, as they might when working
20 .\" Formatted or processed versions of this manual, if unaccompanied by
21 .\" the source, must acknowledge the copyright and authors of this work.
23 .\" References consulted:
24 .\" Linux libc source code
25 .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991)
27 .\" Modified Sat May 22 18:43:54 1993, David Metcalfe
28 .\" Modified Sun Jul 25 10:42:30 1993, Rik Faith <faith@cs.unc.edu>
29 .\" Translated into german 21 August 1996 by Markus Kaufmann
30 .\" <markus.kaufmann@gmx.de>
31 .TH GETHOSTBYNAME 3 "19. April 1993" "BSD" "Bibliotheksfunktionen"
33 gethostbyname, gethostbyaddr, sethostent, endhostent, herror \- Lesen der
34 Netzwerk Rechnereinträge
38 .B extern int h_errno;
40 .BI "struct hostent *gethostbyname(const char *" name );
42 .BI "struct hostent *gethostbyaddr(const char *" addr ", int " len ", int " type );
44 .BI "void sethostent(int " stayopen );
46 .B void endhostent(void);
48 .BI "void herror(const char *" s );
52 .BR gethostbyname() -Funktion
53 liefert für den angegebenen Host
60 nicht mit einem Punkt endet, dann werden die aktuelle und die
61 darüberliegenden Domains durchsucht.
64 nicht mit einem Punkt endet und die Umgebungsvariable
66 gesetzt ist, dann wird zuerst in der Alias-Datei auf die
73 .BR gethostbyaddr() -Funktion
74 liefert für die angegebene Adresse
82 zurück. Der z.Zt. einzig gültige Adresstyp ist AF_INET.
85 .BR sethostent() -Funktion
88 wahr (1) ist, dass eine bestehende TCP-Verbindung für Nameserveranfragen
89 genutzt werden soll und dass die Verbindung für die nachfolgenden Anfragen
90 offen bleiben soll. Ansonsten werden für Nameserveranfragen
91 UDP-Datagramme benutzt.
94 .BR endhostent() -Funktion
95 beendet die Benutzung einer TCP-Verbindung für Namerserveranfragen.
98 .BR herror() -Funktion
99 gibt die zum aktuellen Wert von
101 gehörende Fehlermeldung auf stderr aus.
107 benutzen für ihre Anfragen den Nameserver
111 und den Network Information Service (NIS oder YP). Was davon und in welcher
112 Reihenfolge benutzt wird, bestimmt die
120 Das Standardverhalten ist zuerst den Nameserver zu befragen und danach
126 .IR hostent -Struktur
129 folgendermaßen definiert:
136 char *h_name; /* Offizieller Name des Rechners */
137 char **h_aliases; /* Aliasliste */
138 int h_addrtype; /* Host-Adress-Typ */
139 int h_length; /* Adresslänge */
140 char **h_addr_list; /* Adressliste */
142 #define h_addr h_addr_list[0] /* für Abwärtskompatibilität */
148 .IR hostent -Struktur
152 Der Offizielle Name des Rechners.
155 Ein Null-terminiertes Array mit den alternativen Namen des Rechner.
158 Adresstyp, z.Zt. immer AF_INET.
161 Die Länge der Adresse in Bytes.
164 Ein Null-terminiertes Array von Netzwerkadressen des Rechners in der
165 Netzwerk-Byte-Reihenfolge (network byte order).
170 für Abwärtskompatibilität.
175 .BR gethostbyaddr() -Funktionen
177 .IR hostent -Struktur
178 zurück. Bei einem Fehler wird ein NULL-Zeiger zurückgegeben, in diesem
179 Fall enthält die Variable
185 kann folgende Werte annehmen.
188 Der angegebene Rechner ist unbekannt.
191 Der angegebene Name ist gültig, aber es existiert dazu keine IP-Adresse.
194 Ein nichtbehebbarer Nameserverfehler ist aufgetreten.
197 Beim zuständigen Nameserver ist ein vorübergehender Fehler aufgetreten.
198 Versuchen Sie es später nochmals.
202 Konfigurationsdatei des Namenauflösers (resolver).
205 Rechnerdatenbankdatei