Linux Certif

Toute la documentation sur la certification Linux LPI

gethostname

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