.\" -*- coding: UTF-8 -*- .\" Copyright 1993 Rickard E. Faith (faith@cs.unc.edu) .\" .\" %%%LICENSE_START(VERBATIM) .\" Permission is granted to make and distribute verbatim copies of this .\" manual provided the copyright notice and this permission notice are .\" preserved on all copies. .\" .\" Permission is granted to copy and distribute modified versions of this .\" manual under the conditions for verbatim copying, provided that the .\" entire resulting derived work is distributed under the terms of a .\" permission notice identical to this one. .\" .\" Since the Linux kernel and libraries are constantly changing, this .\" manual page may be incorrect or out-of-date. The author(s) assume no .\" responsibility for errors or omissions, or for damages resulting from .\" the use of the information contained herein. The author(s) may not .\" have taken the same level of care in the production of this manual, .\" which is licensed free of charge, as they might when working .\" professionally. .\" .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" .\" Modified 1997-08-25 by Nicolás Lichtmaier .\" Modified 2004-06-17 by Michael Kerrisk .\" Modified 2008-11-27 by mtk .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH GETDOMAINNAME 2 "8. Oktober 2016" Linux Linux\-Programmierhandbuch .SH BEZEICHNUNG getdomainname, setdomainname \- abfragen/setzen des NIS\-Domainnamens .SH ÜBERSICHT \fB#include \fP .sp \fBint getdomainname(char *\fP\fIname\fP\fB, size_t \fP\fIlaenge\fP\fB);\fP .br \fBint setdomainname(const char *\fP\fIname\fP\fB, size_t \fP\fIlaenge\fP\fB);\fP .sp .in -4n Mit Glibc erforderliche Makros (siehe \fBfeature_test_macros\fP(7)): .in .sp .ad l \fBgetdomainname\fP(), \fBsetdomainname\fP(): .nf .\" commit 266865c0e7b79d4196e2cc393693463f03c90bd8 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) .fi .ad .SH BESCHREIBUNG Diese Funktionen werden dazu benutzt, den NIS\-Domainnamen des Systems abzufragen oder zu ändern. \fBsetdomainname\fP() setzt den Domainnamen auf den Wert, der im Zeichenfeld \fIname\fP steht. Das Argument \fIlaenge\fP gibt die Anzahl der Byte in \fIname\fP an. (Daher benötigt \fIname\fP kein abschließendes Null\-Byte.) \fBgetdomainname\fP() gibt den Domainnamen mit abschließender Null im Zeichenfeld \fIname\fP zurück, der eine Länge von \fIlaenge\fP Byte hat. Falls der Domainname mit abschließender Null mehr als \fIlaenge\fP Byte benötigt, gibt \fBgetdomainname\fP() die ersten \fIlaenge\fP Byte (Glibc) oder einen Fehler (Libc) zurück. .SH RÜCKGABEWERT Bei Erfolg wird Null zurückgegeben. Bei einem Fehler wird \-1 zurückgegeben und \fIerrno\fP entsprechend gesetzt. .SH FEHLER \fBsetdomainname\fP() kann mit den folgenden Fehlern fehlschlagen: .TP \fBEFAULT\fP \fIname\fP zeigte außerhalb des Adressraums des Benutzers. .TP \fBEINVAL\fP \fIlaenge\fP war negativ oder zu groß. .TP \fBEPERM\fP Der Aufrufende hatte nicht die Capability \fBCAP_SYS_ADMIN\fP in dem Benutzernamensraum, der seinem UTS\-Namensraum zugeordnet ist (siehe \fBnamespaces\fP(7)). .PP \fBgetdomainname\fP() kann mit den folgenden Fehlern fehlschlagen: .TP \fBEINVAL\fP Für \fBgetdomainname\fP unter Libc: \fIname\fP ist NULL oder \fIname\fP ist länger als \fIlaenge\fP Byte. .SH "KONFORM ZU" .\" But they appear on most systems... Diese Aufrufe sind nicht von POSIX spezifiziert worden. .SH ANMERKUNGEN Seit Linux 1.0 ist die Begrenzung für die Länge des Domainnamens einschließlich abschließendem Null\-Byte 64 Byte. In älteren Kerneln war sie 8 Byte. Auf den meisten Linux\-Architekturen (einschließlich i86) gibt es keinen \fBgetdomainname\fP()\-Systemaufruf; stattdessen implementiert Glibc \fBgetdomainname\fP() als Bibliotheksfunktion, die eine Kopie des Feldes \fIdomainname\fP von einem \fBuname\fP(2)\-Aufruf zurückgibt. .SH "SIEHE AUCH" \fBgethostname\fP(2), \fBsethostname\fP(2), \fBuname\fP(2) .SH KOLOPHON Diese Seite ist Teil der Veröffentlichung 4.09 des Projekts Linux\-\fIman\-pages\fP. Eine Beschreibung des Projekts, Informationen, wie Fehler gemeldet werden können sowie die aktuelle Version dieser Seite finden sich unter \%https://www.kernel.org/doc/man\-pages/. .SH ÜBERSETZUNG Die deutsche Übersetzung dieser Handbuchseite wurde von René Tschirley , Martin Schulze und Chris Leick 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 .