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

BEZEICHNUNG
       getdomainname, setdomainname - abfragen/setzen des Domainnamens


"UBERSICHT
       #include <unistd.h>

       int getdomainname(char *name, size_t laenge);
       int setdomainname(const char *name, size_t laenge);

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

       getdomainname(), setdomainname():
           _BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE < 500)


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

       setdomainname() setzt den Domainnamen auf den Wert, der im  Zeichenfeld
       name  steht.  Das  Argument laenge gibt die Anzahl der Byte in name an.
       (Daher benotigt name kein abschlieBendes Null-Byte.)

       getdomainname()  gibt  den  Domainnamen  mit  abschlieBender  Null   im
       Zeichenfeld  name zuruck, der eine Lange von laenge Byte hat. Falls der
       Domainname mit abschlieBender Null mehr als laenge Byte benotigt,  gibt
       getdomainname() die ersten laenge Byte (Glibc) oder einen Fehler (Libc)
       zuruck.


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


FEHLER
       setdomainname() kann mit den folgenden Fehlern fehlschlagen:

       EFAULT name zeigte auBerhalb des Adressraums des Benutzers.

       EINVAL laenge war negativ oder zu groB.

       EPERM  der Aufrufende verfugt nicht uber die notigen Rechte (Linux: hat
              nicht die Fahigkeit CAP_SYS_ADMIN)

       getdomainname() kann mit den folgenden Fehlern fehlschlagen:

       EINVAL Fur getdomainname unter Libc: name ist NULL oder name ist langer
              als laenge Byte.


KONFORM ZU
       Diese Aufrufe sind nicht von POSIX spezifiziert worden.


ANMERKUNGEN
       Seit  Linux  1.0  ist  die  Begrenzung  fur  die Lange des Domainnamens
       einschlieBlich abschlieBendem Null-Byte 64 Byte. In alteren Kerneln war
       sie 8 Byte.

       Auf den meisten Linux-Architekturen (einschlieBlich i86) gibt es keinen
       getdomainname()-Systemaufruf;    stattdessen    implementiert     Glibc
       getdomainname()  als  Bibliotheksfunktion,  die  eine  Kopie des Feldes
       domainname von einem uname(2)-Aufruf zuruckgibt.


SIEHE AUCH
       gethostname(2), sethostname(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>, Martin Schulze <joey@infodrom.org> und Chris
       Leick <c.leick@vollbio.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>.