getdomainname(2)              System Calls Manual             getdomainname(2)

NOM
       getdomainname, setdomainname - Lire et ecrire le nom de domaine NIS

BIBLIOTHEQUE
       Bibliotheque C standard (libc, -lc)

SYNOPSIS
       #include <unistd.h>

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

   Exigences de macros de test de fonctionnalites pour la glibc (consulter
   feature_test_macros(7)) :

       getdomainname(), setdomainname() :
           Depuis la glibc 2.21 :
               _DEFAULT_SOURCE
           Dans glibc 2.19 et 2.20 :
               _DEFAULT_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE < 500)
           Jusqu'a et y compris la glibc 2.19 :
               _BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE < 500)

DESCRIPTION
       Ces fonctions sont utilisees pour obtenir ou changer le nom de domaine
       NIS du systeme hote. Plus precisement, elles agissent sur le nom de
       domaine NIS associe a l'espace de noms UTS du processus appelant.

       setdomainname() definit le nom de domaine a la valeur fournie dans le
       tableau de caracteres name. Le parametre len indique le nombre d'octets
       de name (name n'a donc pas a se terminer par un octet NULL).

       getdomainname() renvoie le nom de domaine termine par NULL dans le
       tableau de caracteres name, ayant une longueur de len octets. Si le nom
       de domaine termine par NULL necessite plus de len octets,
       getdomainname() renvoie les premiers len octets (glibc) ou produit une
       erreur (libc).

VALEUR RENVOYEE
       En cas de succes, zero est renvoye. En cas d'erreur, -1 est renvoye et
       errno est definie pour preciser l'erreur.

ERREURS
       setdomainname() peut echouer avec les erreurs suivantes :

       EFAULT name pointe en dehors de l'espace d'adressage utilisateur.

       EINVAL len est negatif ou trop large.

       EPERM  L'appelant n'avait pas la capacite CAP_SYS_ADMIN dans l'espace
              de noms de l'utilisateur associe a son espace de noms UTS (voir
              namespaces(7)).

       getdomainname() peut echouer avec les erreurs suivantes :

       EINVAL Avec getdomainname() et la Libc : name est NULL ou name est plus
              long que len.

VERSIONS
       Sur la plupart des architectures Linux (x86 incluse), il n'y a pas
       d'appel systeme getdomainname() ; a la place, la glibc implemente
       getdomainname() comme une fonction de bibliotheque qui renvoie une
       copie du champ domainname renvoye par un appel a uname(2).

STANDARDS
       Aucun.

HISTORIQUE
       Depuis Linux 1.0, la limite sur la taille d'un nom de domaine, octet
       NULL de fin compris, est de 64 octets. Dans les noyaux plus anciens,
       elle etait de 8 octets.

VOIR AUSSI
       gethostname(2), sethostname(2), uname(2), uts_namespaces(7)

TRADUCTION
       La traduction francaise de cette page de manuel a ete creee par
       Christophe Blaess <https://www.blaess.fr/christophe/>, Stephan Rafin
       <stephan.rafin@laposte.net>, Thierry Vignaud <tvignaud@mandriva.com>,
       Francois Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe
       Guerard <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-
       luc.coulon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas
       Huriaux <thomas.huriaux@gmail.com>, Nicolas Francois
       <nicolas.francois@centraliens.net>, Florentin Duneau
       <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-
       bretagne.fr>, Denis Barbier <barbier@debian.org>, David Prevot
       <david@tilapin.org> et Jean-Philippe MENGUAL <jpmengual@debian.org>

       Cette traduction est une documentation libre ; veuillez vous reporter a
       la GNU General Public License version 3
       <https://www.gnu.org/licenses/gpl-3.0.html> concernant les conditions
       de copie et de distribution. Il n'y a aucune RESPONSABILITE LEGALE.

       Si vous decouvrez un bogue dans la traduction de cette page de manuel,
       veuillez envoyer un message a <debian-l10n-french@lists.debian.org>.

Pages du manuel de Linux 6.8      2 mai 2024                  getdomainname(2)