Provided by: manpages-fr-dev_3.23.1-1_all bug

NOM

       getdomainname, setdomainname - Lire ou fixer le nom de domaine

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  fonctionnalités  pour  la  glibc (voir
   feature_test_macros(7)) :

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

DESCRIPTION

       Ces  fonctions sont utilisées pour obtenir ou changer le nom de domaine
       de l’hôte système.

       setdomainname() fice le nom de domaine à  la  valeur  fournie  dans  le
       tableau de caractères name. Le paramètre len indique le nombre d’octets
       de name (name n’a donc pas à se terminer par un caractère nul).

       Ces deux fonctions servent à lire ou à changer le  nom  de  domaine  de
       l’hôte  concerné.  Si  le  nom  de  domaine,  suivi d’un caractère nul,
       nécessite plus de len octets pour être stocké, getdomainname()  renvoie
       les len premiers octets (glibc), ou produit une erreur (libc).

VALEUR RENVOYÉE

       En  cas  de  réussite,  zéro est renvoyé, sinon -1 est renvoyé et errno
       contient le code d’erreur.

ERREURS

       setdomainname() peut échouer avec les erreurs suivantes :

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

       EINVAL len est négatif ou trop large.

       EPERM  l’appelant n’est pas privilégié (Linux :  n’a  pas  la  capacité
              CAP_SYS_ADMIN).

       getdomainname() peut échouer avec les erreurs suivantes :

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

CONFORMITÉ

       Ces fonctions ne sont pas spécifiées par POSIX.

NOTES

       Depuis Linux 1.0, la limite sur la taille d’un nom  de  domaine,  octet
       nul  de  fin  compris,  est de 64 octets. Dans les noyaux plus anciens,
       elle était de 8 octets.

       Sur la plupart des architectures Linux  (x86  inclue),  il  n’y  a  pas
       d’appel  système  getdomainname() ;  à  la  place,  la glibc implémente
       getdomainname() comme une fonction  de  bibliothèque  qui  renvoie  une
       copie du champ domainname renvoyé par un appel à uname(2).

VOIR AUSSI

       gethostname(2), sethostname(2), uname(2)

COLOPHON

       Cette  page  fait  partie  de  la  publication 3.23 du projet man-pages
       Linux. Une description du projet et des instructions pour signaler  des
       anomalies       peuvent       être       trouvées      à      l’adresse
       http://www.kernel.org/doc/man-pages/.

TRADUCTION

       Cette page de manuel a été traduite  et  mise  à  jour  par  Christophe
       Blaess  <http://www.blaess.fr/christophe/> entre 1996 et 2003, puis par
       Alain Portal <aportal AT univ-montp2 DOT fr> jusqu’en 2006, et  mise  à
       disposition sur http://manpagesfr.free.fr/.

       Les mises à jour et corrections de la version présente dans Debian sont
       directement gérées par Julien Cristau <jcristau@debian.org> et l’équipe
       francophone de traduction de Debian.

       Veuillez   signaler   toute   erreur   de   traduction  en  écrivant  à
       <debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le
       paquet manpages-fr.

       Vous  pouvez  toujours avoir accès à la version anglaise de ce document
       en utilisant la commande « man -L C <section> <page_de_man> ».