BEZEICHNUNG¶

gethostname, sethostname - bestimmt/setzt den Rechnernamen

BIBLIOTHEK¶

Standard-C-Bibliothek (libc, -lc)

ÜBERSICHT¶

#include <unistd.h>

int gethostname(char *name, size_t Länge);
int sethostname(const char *name, size_t Länge);

gethostname():

    _XOPEN_SOURCE >= 500 || _POSIX_C_SOURCE >= 200112L


        || /* Glibc 2.19 und älter */ _BSD_SOURCE

sethostname():

    Seit Glibc 2.21:


        _DEFAULT_SOURCE


    In Glibc 2.19 und 2.20:


        _DEFAULT_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE < 500)


    Bis einschließlich Glibc 2.19:


        _BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE < 500)

BESCHREIBUNG¶

Mit diesen Systemaufrufen erfragen und setzen Sie den Rechnernamen des aktuellen Prozessors. Genauer ausgedrückt, arbeiten sie mit dem Rechnernamen, der dem UTS-Namensraum des aufrufenden Prozesses zugeordnet ist.

sethostname() setzt den Rechnernamen auf den im Zeichenfeld (character array) name übergebenen Wert. Das Argument Länge gibt die Anzahl der Bytes in name an. (Deshalb erfordert name kein abschließendes Null-Byte.)

gethostname() gibt den (mit einem Nullbyte abgeschlossenen) Rechnernamen der Länge Länge Byte im Zeichenfeld name zurück. Ist der Rechnername zu groß für name, wird er ohne Fehlermeldung gekürzt (siehe aber die ANMERKUNGEN unten). POSIX.1 legt nicht fest, ob im Fall einer solchen Kürzung der zurückgegebene Puffer ein abschließendes Nullbyte enthält.

RÜCKGABEWERT¶

Bei Erfolg wird Null zurückgegeben. Bei einem Fehler wird -1 zurückgegeben und errno gesetzt, um den Fehler anzuzeigen.

FEHLER¶

EFAULT

name ist eine ungültige Adresse.

EINVAL

Länge ist negativ oder das Argument Länge für sethostname() überschreitet die maximal zulässige Größe.

ENAMETOOLONG

gethostname() der Glibc gibt damit an, das Länge kleiner ist als die tatsächliche Größe. (Vor Version 2.1 verwendet Glibc in diesem Fall EINVAL.)

EPERM

Der Aufruf von sethostname() erfolgte ohne die CAP_SYS_ADMIN-Capability im Benutzernamensraum, der seinem UTS-Namensraum zugeordnet ist (siehe namespaces(7)).

VERSIONEN¶

SUSv2 garantiert, dass »Rechnernamen auf 255 Byte begrenzt sind«. POSIX.1 garantiert, dass »Rechnernamen (ohne das abschließende Nullbyte) auf HOST_NAME_MAX byte begrenzt sind«. Für Linux ist HOST_NAME_MAX seit Version 1.0 auf 64 gesetzt (frühere Kernel setzten eine Grenze von 8 byte).

STANDARDS¶

gethostname()

POSIX.1-2008.

sethostname()

Keine.

GESCHICHTE¶

SVr4, 4.4BSD (diese Schnittstellen kamen erstmals in 4.2BSD vor). POSIX.1-2001 und POSIX.1-2008 spezifizieren gethostname(), aber nicht sethostname().

Glibc-Versionen vor 2.2 verhielten sich anders, wenn die Länge von nodename größer als oder gleich Länge war: sie kopierten nichts nach name, gaben -1 zurück und setzten errno auf ENAMETOOLONG.

SIEHE AUCH¶

hostname(1), getdomainname(2), setdomainname(2), uname(2), uts_namespaces(7)

ÜBERSETZUNG¶

Die deutsche Übersetzung dieser Handbuchseite wurde von René Tschirley <gremlin@cs.tu-berlin.de>, Martin Eberhard Schauer <Martin.E.Schauer@gmx.de> und Mario Blättermann <mario.blaettermann@gmail.com> erstellt.

Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.

Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Übersetzer.