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 (consultez feature_test_macros(7)) :

       gethostid() :
           _BSD_SOURCE || _XOPEN_SOURCE >= 500 || _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED
       sethostid() :
           _BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE < 500)

DESCRIPTION

       gethostid() et sethostid() récupèrent et définissent respectivement un identifiant 32 bits unique pour la
       machine.  L'identifiant  32  bits  est  supposé  être  unique pour tous les systèmes UNIX. En général, il
       ressemble à l'adresse internet de la machine local, comme renvoyée par gethostbyname(3) et il ne  devrait
       pas être nécessaire de le définir.

       L'appel de sethostid() est bien sûr limité au superutilisateur.

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  L'ID de l'utilisateur ou du groupe effectif du processus appelant ne correspond pas à l'ID réel.

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

       Dans  l'implémentation  de la glibc, hostid est sauvegardé dans le fichier /etc/hostid (pour les versions
       antérieures à la glibc 2.2, /var/adm/hostid était utilisé).

       Dans l'implémentation de la glibc, si gethostid() ne peut pas ouvrir le fichier contenant l'ID de l'hôte,
       alors elle obtient le nom d'hôte avec gethostname(2), passe ce nom d'hôte à gethostbyname_r(3) de façon à
       obtenir  l'adresse  IPv4  de  l'hôte,  et  renvoie  l'adresse  IPv4  modifée  par  manipulation  de  bits
       (« bit-twilling ») (cette valeur peut ne pas être 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.65 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

       Depuis 2010, cette traduction est maintenue à l'aide de l'outil po4a <http://po4a.alioth.debian.org/> par
       l'équipe de traduction francophone au sein du projet perkamon <http://perkamon.alioth.debian.org/>.

       Christophe      Blaess      <http://www.blaess.fr/christophe/>      (1996-2003),       Alain       Portal
       <http://manpagesfr.free.fr/>  (2003-2006).  Julien  Cristau  et  l'équipe  francophone  de  traduction de
       Debian (2006-2009).

       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> ».

Linux                                           20 septembre 2010                                   GETHOSTID(3)