#include <sys.socket.h>
Kernighan-Ritchie-C:
int gethostname(name, namelen);
char *name;
int namelen;
ANSI-C:
int gethostname(char* name, int namelen);
Beschreibung
Die Verwendung der Funktion gethostname() ist nur in den Adressfamilien AF_INET und AF_INET6 sinnvoll.
gethostname() liefert im Parameter name den eigenen Socket-Hostnamen zurück. Socket-Hostnamen sind netzweit eindeutige Namen, die in TCP/IP-Netzen für alle Verarbeitungsrechner vergeben werden, die über eine TCP/IP-Route erreichbar sind (siehe Handbuch „BCAM Band 1/2“).
Beim Aufruf von gethostname() muss im Parameter namelen die Länge der String-Variablen name spezifiziert werden.
Genügt die durch namelen spezifizierte Länge der String-Variablen name für die Aufnahme des Hostnamens, so wird der Hostname durch das Null-Byte terminiert. Andernfalls werden die überzähligen Stellen des Hostnamens abgeschnitten, und es ist undefiniert, ob der so zurückgelieferte Hostname durch ein Null-Byte terminiert ist.
Returnwert
0:
bei Erfolg
-1:
bei Fehler. errno wird nicht gesetzt.