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

NOM

       gethostid, sethostid - Lire/écrire l’identifiant unique de l’hôte.

SYNOPSIS

       #include <unistd.h>

       long gethostid(void);
       int sethostid(long hostid);

   Exigences  de  macros  de  test  de  fonctionnalités  pour  la  glibc (voir
   feature_test_macros(7)) :

       sethostid() : _BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE < 500)

DESCRIPTION

       gethostid()  and sethostid()  respectively get or set a  unique  32-bit
       identifier  for the current machine.  The 32-bit identifier is intended
       to be unique among  all  Unix  systems  in  existence.   This  normally
       resembles  the  Internet  address for the local machine, as returned by
       gethostbyname(3), and thus usually never needs to be set.

       L’appel de sethostid() est bien sûr limité au super-utilisateur.

VALEUR RENVOYÉE

       gethostid() retourne l’identifiant sur 32 bits de l’hôte, tel  qu’il  a
       été positionné par sethostid().

       Si  elle  réussit, sethostid() renvoie 0. En cas d’erreur, elle renvoie
       -1 et remplit errno en conséquence.

ERREURS

       sethostid() peut échouer pour les raisons suivantes :

       EACCES L’appelant n’a pas les  permissions  d’écrire  dans  le  fichier
              utilisé pour sauvegarder l’ID de l’hôte.

       EPERM  The calling process’s effective user or group ID is not the same
              as its corresponding real ID.

CONFORMITÉ

       BSD 4.2. Ces fonctions ont été abandonnées dans BSD 4.4. SVr4  contient
       gethostid()  mais  pas  sethostid().  POSIX.1-2001 spécifie gethostid()
       mais pas sethostid().

NOTES

       In  the  glibc  implementation,  the  hostid  is  stored  in  the  file
       /etc/hostid.   (In  glibc versions before 2.2, the file /var/adm/hostid
       was used.)

       In the glibc implementation,  if  gethostid()   cannot  open  the  file
       containing   the   host   ID,   then  it  obtains  the  hostname  using
       gethostname(2), passes that hostname to gethostbyname_r(3)  in order to
       obtain  the  host’s  IPv4  address,  and  returns  a  value obtained by
       bit-twiddling the IPv4 address.  (This value may not be unique.)

BOGUES

       Il est  impossible  de  s’assurer  que  l’identifiant  est  globalement
       unique.

VOIR AUSSI

       hostid(1), gethostbyname(3).

COLOPHON

       Cette  page  fait  partie  de  la  publication 3.17 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> ».