BEZEICHNUNG¶

ÜBERSICHT¶

#include <netdb.h>
extern int h_errno;

struct hostent *gethostbyname(const char *name);
#include <sys/socket.h>       /* für AF_INET */
struct hostent *gethostbyaddr(const void *addr,
                              socklen_t len, int type);

void sethostent(int stayopen);

void endhostent(void);

void herror(const char *s);

const char *hstrerror(int err);

/* System V-/POSIX-Erweiterung */
struct hostent *gethostent(void);

/* GNU-Erweiterungen */
struct hostent *gethostbyname2(const char *name, int af);

int gethostent_r(
        struct hostent *ret, char *buf, size_t buflen,
        struct hostent **result, int *h_errnop);

int gethostbyaddr_r(const void *addr, socklen_t len, int type,
        struct hostent *ret, char *buf, size_t buflen,
        struct hostent **result, int *h_errnop);

int gethostbyname_r(const char *name,
        struct hostent *ret, char *buf, size_t buflen,
        struct hostent **result, int *h_errnop);

int gethostbyname2_r(const char *name, int af,
        struct hostent *ret, char *buf, size_t buflen,
        struct hostent **result, int *h_errnop);

Mit Glibc erforderliche Makros (siehe feature_test_macros(7)):

gethostbyname2(), gethostent_r(), gethostbyaddr_r(), gethostbyname_r(), gethostbyname2_r():

herror(), hstrerror():

h_errno:

BESCHREIBUNG¶

Die Funktion gethostbyname() gibt eine Struktur vom Typ hostent für den angegebenen Host name zurück. Darin ist name entweder ein Host-Name oder eine IPv4-Adresse in der Standard-Punktnotation. Falls name eine IPv4-Adresse ist, wird nicht gesucht und gethostbyname() kopiert einfach nur den namen und dessen struct in_addr-Äquivalent in das Feld h_addr_list[0] der zurückgegebenen hostent-Struktur. Falls name nicht mit einem Punkt endet und die Umgebungsvariable HOSTALIASES gesetzt ist, wird zuerst die von HOSTALIASES bestimmte Aliasdatei nach dem namen durchsucht (siehe hostname(7) für das Dateiformat). Falls der name nicht mit einem Punkt endet, werden die aktuelle Domain und ihre übergeordneten Domains durchsucht.

Die Funktion gethostbyaddr() gibt für die angegebene Adresse addr eine Struktur vom Typ hostent mit der Länge len und dem Adresstyp type zurück. Mögliche Adresstypen sind AF_INET und AF_INET6. Das Argument addr ist ein Zeiger auf eine Struktur, die vom Adresstyp abhängt, beispielsweise eine struct in_addr * (möglicherweise ermittelt durch einen Aufruf von inet_addr(3)) für den Adresstyp AF_INET.

Wenn stayopen wahr (d.h. 1 ist), legt die Funktion sethostent() fest, dass eine bestehende TCP-Verbindung für Nameserveranfragen genutzt werden soll und dass die Verbindung für die nachfolgenden Anfragen bestehen bleiben soll. Ansonsten werden für Nameserveranfragen UDP-Datagramme benutzt.

Die Funktion endhostent() beendet die Nutzung einer TCP-Verbindung für Namerserveranfragen.

Die (veraltete) Funktion herror() gibt die zum aktuellen Wert von h_errno gehörende Fehlermeldung auf stderr aus.

Die (veraltete) Funktion hstrerror() ermittelt zu einer Fehlernummer (normalerweise h_errno) die zugehörige Zeichenkette mit der Fehlermeldung.

Die durch gethostbyname() und gethostbyaddr() durchgeführten Domain-Name-Abfragen verlassen sich auf die konfigurierten Quellen des »Name Service Switch« (nsswitch.conf(5)) oder einen lokalen Name-Server (named(8)). Standardmäßig werden die Quellen des »Name Service Switch« (nsswitch.conf(5)) abgefragt und, falls das fehlschlägt, der lokale Name-Server (named(8)).

struct hostent {
    char  *h_name;            /* offizieller Name des Rechners */
    char **h_aliases;         /* Aliasliste */
    int    h_addrtype;        /* Host-Adresstyp */
    int    h_length;          /* Länge der Adresse */
    char **h_addr_list;       /* Adressliste */
}
#define h_addr h_addr_list[0] /* für Abwärtskompatibilität */

RÜCKGABEWERT¶

FEHLER¶

HOST_NOT_FOUND

Der angegebene Rechner ist unbekannt.

NO_DATA

Der angeforderte Name ist gültig aber verfügt über keine IP-Adresse. Ein anderer Anfragetyp beim Nameserver für diese Domain könnte eine Antwort liefern. Die Konstante NO_ADDRESS ist ein Synonym für NO_DATA.

NO_RECOVERY

Ein nichtbehebbarer Nameserverfehler ist aufgetreten.

TRY_AGAIN

Beim maßgebenden Nameserver ist ein vorübergehender Fehler aufgetreten. Versuchen Sie es später noch einmal.

DATEIEN¶

/etc/host.conf

Konfigurationsdatei des Resolvers (Namensauflöser)

/etc/hosts

Host-Datenbankdatei

/etc/nsswitch.conf

Konfigurationsdatei für »name service switch«

ATTRIBUTE¶

In der obigen Tabelle bedeutet hostent in race:hostent, dass, falls eine der Funktionen sethostent(), gethostent(), gethostent_r() oder endhostent() in verschiedenen Threads eines Programms parallel verwandt werden, konkurrierende Zugriffe auf Daten (»data races«) auftreten könnten.

KONFORM ZU¶

ANMERKUNGEN¶

In der ursprünglichen BSD-Implementierung von gethostbyname() war das Argument len ein int. Der Standard SUSv2 ist fehlerhaft und weist dem Argument len von gethostbyaddr() den Typ size_t zu. (Das ist falsch, weil es int sein muss und das für size_t nicht der Fall ist. POSIX.1-2001 macht es zusocklen_t, was in Ordnung ist.) Siehe auch accept(2).

Der BSD-Prototyp für gethostbyaddr() verwendet const char * als Datentyp für das erste Argument.

FEHLER¶

SIEHE AUCH¶

KOLOPHON¶

ÜBERSETZUNG¶

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.