Provided by: manpages-de-dev_0.10-1_all bug

BEZEICHNUNG

       gethostname, sethostname - bestimmt/setzt den Rechnernamen

"UBERSICHT

       #include <unistd.h>

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

   Mit Glibc erforderliche Makros (siehe feature_test_macros(7)):

       gethostname():
           Seit Glibc 2.12: _BSD_SOURCE || _XOPEN_SOURCE >= 500
           || /* Seit Glibc 2.12: */ _POSIX_C_SOURCE >= 200112L
       sethostname():
           _BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE < 500)

BESCHREIBUNG

       Mit  diesen Systemaufrufen erfragen und setzen Sie den Rechnernamen des
       aktuellen Prozessors.

       sethostname() setzt den Rechnernamen auf den im Zeichenfeld  (character
       array)  name  ubergebenen  Wert.  Das  Argument len gibt die Anzahl der
       Bytes  in  name  an.  (Deshalb  erfordert  name   kein   abschlieBendes
       Null-Byte.)

       gethostname()   gibt   den   (mit   einem   Null-Byte  abgeschlossenen)
       Rechnernamen der Lange len Byte im Zeichenfeld  name  zuruck.  Ist  der
       Rechnername zu groB fur name, wird er ohne Fehlermeldung gekurzt (siehe
       aber die ANMERKUNGEN unten). POSIX.1-2001 legt nicht fest, ob  im  Fall
       einer  solchen  Kurzung  der  zuruckgegebene  Puffer ein abschlieBendes
       Null-Byte enthalt.

R"UCKGABEWERT

       Bei  Erfolg  wird  Null  zuruckgegeben.  Bei  einem  Fehler   wird   -1
       zuruckgegeben und errno entsprechend gesetzt.

FEHLER

       EFAULT name ist eine ungultige Adresse.

       EINVAL len   ist  negativ  oder  das  Argument  len  fur  sethostname()
              uberschreitet die maximal zulassige GroBe.

       ENAMETOOLONG
              gethostname() der Glibc gibt damit an, das len kleiner  ist  als
              die  tatsachliche  GroBe.  (Vor  Version  2.1 verwendet Glibc in
              diesem Fall EINVAL.)

       EPERM  Der    Aufruf    von    sethostname()    erfolgte    ohne    die
              CAP_SYS_ADMIN-Fahigkeit.

KONFORM ZU

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

ANMERKUNGEN

       SUSv2 garantiert, dass >>Rechnernamen auf  255  Byte  begrenzt  sind<<.
       POSIX.1-2001  garantiert,  dass  >>Rechnernamen (ohne das abschlieBende
       Null-Byte) auf  HOST_NAME_MAX  Byte  begrenzt  sind<<.  Fur  Linux  ist
       HOST_NAME_MAX  seit  Version 1.0 auf 64 gesetzt (fruhere Kernel setzten
       eine Grenze von 8 Byte).

   Anmerkungen zur Glibc
       Die   GNU-C-Bibliothek   implementiert    gethostname()    nicht    als
       Systemaufruf,  sondern  als  Bibliotheksfunktion.  Diese  Funktion ruft
       uname(2) auf und kopiert bis zu len Byte aus dem  zuruckgegebenen  Feld
       nodename  nach name. Nach dem Kopieren pruft die Funktion, ob die Lange
       von nodename groBer als oder gleich len ist. In diesem Fall gibt sie -1
       zuruck  und  setzt  errno  auf  ENAMETOOLONG;  der  zuruckgegebene name
       enthalt dann kein abschlieBendes Null-Byte.

       Glibc-Versionen vor 2.2 verhielten sich  anders,  wenn  die  Lange  von
       nodename  groBer  als  oder  gleich  len war: sie kopierten nichts nach
       name, gaben -1 zuruck und setzten errno auf ENAMETOOLONG.

SIEHE AUCH

       getdomainname(2), setdomainname(2), uname(2)

KOLOPHON

       Diese  Seite  ist  Teil  der   Veroffentlichung   3.32   des   Projekts
       Linux-man-pages.  Eine Beschreibung des Projekts und Informationen, wie
       Fehler    gemeldet     werden     konnen,     finden     sich     unter
       http://www.kernel.org/doc/man-pages/.

"UBERSETZUNG

       Die  deutsche Ubersetzung dieser Handbuchseite wurde von Rene Tschirley
       <gremlin@cs.tu-berlin.de>, Jens  Seidel  <jensseidel@users.sf.net>  und
       Martin Eberhard Schauer <Martin.E.Schauer@gmx.de> erstellt.

       Diese  Ubersetzung  ist  Freie Dokumentation; lesen Sie die GNU General
       Public  License  Version  3  oder  neuer   bezuglich   der   Copyright-
       Bedingungen. Es wird KEINE HAFTUNG ubernommen.

       Wenn  Sie  Fehler  in  der  Ubersetzung  dieser  Handbuchseite  finden,
       schicken     Sie     bitte     eine     E-Mail     an     <debian-l10n-
       german@lists.debian.org>.