gethostbyaddr

Deklaration

#include <netdb.h>

struct hostent *gethostbyaddr(const void *addr, socklen_t len, int type);

Beschreibung

Die Funktion gethostbyaddr() ermittelt zu einer gegebenen IP-Adresse in Binärform eine Struktur vom Typ hostent wie auf der Seite zu gethostbyname beschrieben. Das dort beschriebene Verfahren zur Ermittlung der Ursache fehlgeschlagener Aufrufe gilt ebenfalls.

Parameter

addr	Adresse des Hosts nach dem gesucht wird.
len	Die Größe der Adresse in Bytes, also 4 bei AF_INET.
type	Typ der Adressen, für IPv4 ist dies AF_INET.

Rückgabewert

Zeiger auf eine Struktur hostent, im Fehlerfall NULL. Zurückgegeben wird ein Zeiger auf statischen Speicher, der für weitere Umwandlungen benutzt wird. Daher muss der Aufrufer eine Kopie anlegen, wenn die Daten auch nach weiteren Aufrufe von gethostbyaddr() zur Verfügung stehen sollen.

Typische Fehler

Zur Ermittlung der Ursache eines fehlgeschlagenen Aufrufs muss systemabhängig ggf. ein anderer Mechanismus benutzt werden (h_errno, hstrerror()).
Beim Kopieren der zurückgegebenen Daten muss eine deep copy angelegt werden, d.h. auch die Ziele der Zeiger müssen kopiert werden, da dieser Speicher ebenfalls überschrieben werden kann!

Zurück