Manpage  — GETHOSTNAME

gethostname, sethostname - hole/setze Hostname

ÜBERSICHT BESCHREIBUNG RÜCKGABEWERT FEHLER KOMPATIBEL ZU BUGS ANMERKUNGEN SIEHE AUCH

#include <unistd.h>

int gethostname(char *name, size_t len);
int sethostname(const char *name, size_t len);

Diese Funktionen werden dazu benutzt, den Hostnamen des Systems abzufragen oder zu setzen.

Bei Erfolg wird 0 zurückgeliefert, bei aufgetretenem Fehler -1 und errno wird entsprechend gesetzt.

EINVAL	len ist negativ, oder bei sethostname ist len größer als die maximal zulässige Größe, oder bei gethostname unter Linux/i386 ist len kleiner als die aktuelle Größe.
EPERM	sethostname wurde nicht vom Superuser aufgerufen.
EFAULT	name ist eine ungültige Adresse.

Diese Funktionen werden nicht in POSIX.1 definiert, doch werden sie in B.4.4.1 der ISO/IEC 9945-1:1990 erwähnt.

Einige andere Implementationen von gethostname liefern erfolgreich len bytes, auch wenn name länger ist. Linux/Alpha verhält sich analog, während Linux/i386 in diesem Falle EINVAL zurückliefert.