getdomainname(2) System Calls Manual getdomainname(2) BEZEICHNUNG getdomainname, setdomainname - abfragen/setzen des NIS-Domainnamens BIBLIOTHEK Standard-C-Bibliothek (libc, -lc) UBERSICHT #include int getdomainname(char *name, size_t laenge); int setdomainname(const char *name, size_t laenge); Mit Glibc erforderliche Feature-Test-Makros (siehe feature_test_macros(7)): getdomainname(), setdomainname(): Seit Glibc 2.21: _DEFAULT_SOURCE In Glibc 2.19 und 2.20: _DEFAULT_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE < 500) Bis einschliesslich Glibc 2.19: _BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE < 500) BESCHREIBUNG Diese Funktionen werden dazu benutzt, den NIS-Domainnamen des Systems abzufragen oder zu andern. Genauer gesagt arbeiten sie auf dem NIS-Domain-Namen, der dem UTS-Namensraum des aufrufenden Prozesses zugeordnet ist. 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 abschliessendes Nullbyte.) getdomainname() gibt den Domainnamen mit abschliessender Null im Zeichenfeld name zuruck, der eine Lange von laenge Byte hat. Falls der Domainname mit abschliessender Null mehr als laenge Byte benotigt, gibt getdomainname() die ersten laenge Byte (Glibc) oder einen Fehler (Libc) zuruck. RUCKGABEWERT Bei Erfolg wird Null zuruckgegeben. Bei einem Fehler wird -1 zuruckgegeben und errno gesetzt, um den Fehler anzuzeigen. FEHLER setdomainname() kann mit den folgenden Fehlern fehlschlagen: EFAULT name zeigte ausserhalb des Adressraums des Benutzers. EINVAL laenge war negativ oder zu gross. EPERM Der Aufrufende hatte nicht die Capability CAP_SYS_ADMIN in dem Benutzernamensraum, der seinem UTS-Namensraum zugeordnet ist (siehe namespaces(7)). getdomainname() kann mit den folgenden Fehlern fehlschlagen: EINVAL Fur getdomainname unter Libc: name ist NULL oder name ist langer als laenge Byte. VERSIONEN Auf den meisten Linux-Architekturen (einschliesslich i86) gibt es keinen getdomainname()-Systemaufruf; stattdessen implementiert Glibc getdomainname() als Bibliotheksfunktion, die eine Kopie des Feldes domainname von einem uname(2)-Aufruf zuruckgibt. STANDARDS Keine. GESCHICHTE Seit Linux 1.0 ist die Begrenzung fur die Lange des Domainnamens einschliesslich abschliessendem Nullbyte 64 byte. In alteren Kerneln war sie 8 byte. SIEHE AUCH gethostname(2), sethostname(2), uname(2), uts_namespaces(7) UBERSETZUNG Die deutsche Ubersetzung dieser Handbuchseite wurde von Martin Schulze , Rene Tschirley und Chris Leick 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 die Mailingliste der Ubersetzer . Linux man-pages 6.06 31. Oktober 2023 getdomainname(2)