GETHOSTNAME(2)

BEZEICHNUNG
gethostname, sethostname - hole/setze Hostname

ÜBERSICHT
#include <unistd.h>

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

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

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

FEHLER

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.

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

BUGS
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.

ANMERKUNGEN
In Linux/Alpha ist gethostname ein System Call, in Linux/i386 ist gethostname auf Libraryebene als Aufruf von uname(2) realisiert.

SIEHE AUCH
getdomainname(2), setdomainname(2), uname(2).