Provided by:
manpages-fr-dev_3.27fr1.4-1_all 
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 fonctionnalites pour la glibc (consultez
feature_test_macros(7)) :
getdomainname(), setdomainname() :
_BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE < 500)
DESCRIPTION
Ces fonctions sont utilisees pour obtenir ou changer le nom de domaine
de l'hote systeme.
setdomainname() fice 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 caractere nul).
Ces deux fonctions servent a lire ou a changer le nom de domaine de
l'hote concerne. Si le nom de domaine, suivi d'un caractere nul,
necessite plus de len octets pour etre stocke, getdomainname() renvoie
les len premiers octets (glibc), ou produit une erreur (libc).
VALEUR RENVOY'EE
S'il reussit, cet appel systeme renvoie 0. S'il echoue, il renvoie -1
et remplit errno en consequence.
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'est pas privilegie (Linux : n'a pas la capacite
CAP_SYS_ADMIN).
getdomainname() peut echouer avec les erreurs suivantes :
EINVAL Avec getdomainname() et la Libc : name est NULL ou name est plus
long que len.
CONFORMIT'E
Ces fonctions ne sont pas specifiees 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 etait de 8 octets.
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).
VOIR AUSSI
gethostname(2), sethostname(2), uname(2)
COLOPHON
Cette page fait partie de la publication 3.27 du projet man-pages
Linux. Une description du projet et des instructions pour signaler des
anomalies peuvent etre trouvees a l'adresse
<URL:http://www.kernel.org/doc/man-pages/>.
TRADUCTION
Depuis 2010, cette traduction est maintenue a l'aide de l'outil po4a
<URL:http://po4a.alioth.debian.org/> par l'equipe de traduction
francophone au sein du projet perkamon
<URL:http://perkamon.alioth.debian.org/>.
Christophe Blaess <URL:http://www.blaess.fr/christophe/> (1996-2003),
Alain Portal <URL:http://manpagesfr.free.fr/> (2003-2006). Julien
Cristau et l'equipe francophone de traduction de Debian (2006-2009).
Veuillez signaler toute erreur de traduction en ecrivant a
<debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le
paquet manpages-fr.
Vous pouvez toujours avoir acces a la version anglaise de ce document
en utilisant la commande << man -L C <section> <page_de_man> >>.