Provided by: manpages-fr-dev_3.27fr1.4-1_all bug

NOM

       gethostname, sethostname - Lire/ecrire le nom d'hote

SYNOPSIS

       #include <unistd.h>

       int gethostname(char *name, size_t len);
       int sethostname(const char *name, size_t len);

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

       gethostname() :
           Depuis la glibc 2.12 :
               _BSD_SOURCE || _XOPEN_SOURCE >= 500 ||
               _POSIX_C_SOURCE >= 200112L
           Avant la glibc 2.12 :
               _BSD_SOURCE || _XOPEN_SOURCE >= 500
       sethostname() :
           _BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE < 500)

DESCRIPTION

       Ces  appels systeme sont utilises pour obtenir ou changer le nom d'hote
       du processeur en cours.

       sethostname() definit le nom d'hote a la valeur fournie dans le tableau
       d'octets  name.  Le  parametre  len indique le nombre d'octets dans nom
       (ainsi, name n'a pas a contenir d'octet nul de fin).

       gethostname() renvoie le nom d'hote, avec un octet nul de fin, dans  le
       tableau  d'octets  name,  qui  a  une longueur de len octets. Si le nom
       d'hote avec son octet nul de fin est trop long pour tenir, alors le nom
       est tronque, et aucune erreur n'est renvoyee (mais consultez la section
       NOTES ci-dessous). POSIX.1-2001 indique que dans le cas ou le  nom  est
       tronque,  il  n'est pas specifie si le tableau renvoye inclut ou pas un
       octet nul de fin.

VALEUR RENVOY'EE

       S'il reussit, cet appel systeme renvoie 0. S'il echoue, il  renvoie  -1
       et remplit errno en consequence.

ERREURS

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

       EINVAL len  est  negatif ou, pour sethostname(), len est plus grand que
              la taille maximale autorisee.

       ENAMETOOLONG
              (gethostname() de la glibc) len est plus petit que la  veritable
              taille  (avant  la  glibc 2.1, la glibc utilisait EINVAL dans ce
              cas).

       EPERM  Pour   sethostname(),   l'appelant   n'a   pas    la    capacite
              CAP_SYS_ADMIN.

CONFORMIT'E

       SVr4, BSD 4.4 (ces interfaces sont apparues dans BSD 4.2). POSIX.1-2001
       definit gethostname() mais pas sethostname().

NOTES

       SUSv2 garantit que << les noms d'hotes sont limites  a  255  octets >>.
       POSIX.1-2001 garantit que << les noms d'hotes (non compris le caractere
       NUL  final)  sont  limites  a  HOST_NAME_MAX  octets >>.  Sous   Linux,
       HOST_NAME_MAX  vaut  la valeur 64, qui a ete la limite depuis Linux 1.0
       (les noyaux plus anciens imposaient une limite de 8 octets).

   Notes sur la glibc
       La bibliotheque C GNU n'utilise pas l'appel systeme  gethostname() ;  a
       la   place,   gethostname()  est  implementee  comme  une  fonction  de
       bibliotheque qui appelle uname(2) et copie jusqu'a len octets depuis le
       champ  nodename  renvoye dans name. Apres la copie, la fonction verifie
       si la longueur de nodename etait superieure ou egale a len, et si c'est
       le  cas,  la  fonction renvoie -1 en positionnant errno a ENAMETOOLONG.
       Les versions de glibc anterieures a 2.2 gerent le cas ou la longueur de
       nodename  est  superieur ou egal a len de facon differente : rien n'est
       copie dans name, et la fonction renvoie  -1  en  positionnant  errno  a
       ENAMETOOLONG ;  dans  ce  cas,  aucun caractere nul de fin n'est inclus
       dans la valeur name renvoyee.

       Les versions de la glibc anterieures  a  la  version  2.2  prennent  en
       charge differemment le cas ou la longueur de nodename est superieure ou
       egal a len : rien n'est copie dans name et la fonction  renvoie  -1  en
       positionnant errno a ENAMETOOLONG.

VOIR AUSSI

       getdomainname(2), setdomainname(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> >>.