gethostname(3C-ucb)     (BSD Compatibility Package)     gethostname(3C-ucb)

NAME
     gethostname, sethostname - Namen des aktuellen Rechners
     abfragen/setzen

SYNTAX
     /usr/ucb/cc [flag ...] file ... -lucb

     int gethostname(char *name, int namelen);

     int sethostname(char *name, int namelen);

BESCHREIBUNG
     gethostname() gibt den Standardnamen des aktuellen Rechners zurück,
     der zuvor von sethostname() gesetzt worden ist. Der Parameter namelen
     gibt die Größe des Arrays an, auf das name zeigt. Der zurückgegebene
     Name endet mit einer Null, wenn genügend Platz vorhanden ist.

     sethostname() legt den Namen name mit der Länge namelen für den Rech-
     ner fest. Dieser Aufruf ist nur für Benutzer mit entsprechender
     Berechtigung zulässig und wird normalerweise nur dann verwendet, wenn
     das System gestartet wird.

RÜCKGABEWERT
     Bei erfolgreichem Aufruf wird der Wert 0 zurückgegeben. Andernfalls
     wird der Wert -1 zurückgegeben und durch einen Fehlercode in der glo-
     balen Variablen errno angezeigt.

FEHLER
     Die folgenden Beschreibungen der Fehlercodes sind funktionsspezifisch.
     Eine allgemeingültige Beschreibung finden Sie in introprm2(2) bzw. in
     errno(5).

     Von diesen Aufrufen können folgende Fehler zurückgegeben werden:

     EFAULT     Der Parameter name oder namelen hat eine ungültige Adresse
                angegeben.

     EPERM      Der Aufrufer verfügt nicht über die entsprechende Berechti-
                gung. Dieser Fehler gilt nur für sethostname().

HINWEISE
     Hostnamen sind auf MAXHOSTNAMELEN Zeichen (zur Zeit 256) beschränkt
     (siehe Include-Datei param.h).

SIEHE AUCH
     uname(2), gethostid(3N).









Seite 1                      Reliant UNIX 5.44               Gedruckt 11/98