gethostid(3)               Library Functions Manual               gethostid(3)

NOM
       gethostid, sethostid - Lire/ecrire l'identifiant unique de l'hote

BIBLIOTHEQUE
       Bibliotheque C standard (libc, -lc)

SYNOPSIS
       #include <unistd.h>

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

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

       gethostid() :
           Depuis la glibc 2.20 :
               _DEFAULT_SOURCE || _XOPEN_SOURCE >= 500
           Pour la glibc anterieure et egale a 2.19 :
               _BSD_SOURCE || _XOPEN_SOURCE >= 500

       sethostid() :
           Depuis la glibc 2.21 :
               _DEFAULT_SOURCE
           Dans glibc 2.19 et 2.20 :
               _DEFAULT_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE < 500)
           Jusqu'a et y compris la glibc 2.19 :
               _BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE < 500)

DESCRIPTION
       gethostid() et sethostid() recuperent et definissent respectivement un
       identifiant 32 bits unique pour la machine. L'identifiant 32 bits
       etaitt suppose etre unique pour tous les systemes UNIX. En general, il
       ressemble a l'adresse internet de la machine local, comme renvoyee par
       gethostbyname(3) et il ne devrait pas etre necessaire de le definir.

       L'appel de sethostid() est bien sur limite au superutilisateur.

VALEUR RENVOYEE
       gethostid() retourne l'identifiant sur 32 bits de l'hote, tel qu'il a
       ete positionne par sethostid().

       Si elle reussit, sethostid() renvoie 0. En cas d'erreur, elle renvoie
       -1 et errno est defini pour indiquer l'erreur.

ERREURS
       sethostid() peut echouer pour les raisons suivantes :

       EACCES L'appelant n'a pas les permissions d'ecrire dans le fichier
              utilise pour sauvegarder l'ID de l'hote.

       EPERM  L'ID de l'utilisateur ou du groupe effectif du processus
              appelant ne correspond pas a l'ID reel.

ATTRIBUTS
       Pour une explication des termes utilises dans cette section, consulter
       attributes(7).

       +------------+--------------------------+------------------------------+
       |Interface   | Attribut                 | Valeur                       |
       +------------+--------------------------+------------------------------+
       |gethostid() | Securite des threads     | MT-Safe hostid env locale    |
       +------------+--------------------------+------------------------------+
       |sethostid() | Securite des threads     | MT-Unsafe const:hostid       |
       +------------+--------------------------+------------------------------+
VERSIONS
       Dans l'implementation de la glibc, hostid est sauvegarde dans le
       fichier /etc/hostid. (Avant la la glibc 2.2, le fichier /var/adm/hostid
       etait utilise).

       Dans l'implementation de la glibc, si gethostid() ne peut pas ouvrir le
       fichier contenant l'ID de l'hote, alors elle obtient le nom d'hote avec
       gethostname(2), passe ce nom d'hote a gethostbyname_r(3) de facon a
       obtenir l'adresse IPv4 de l'hote, et renvoie l'adresse IPv4 modifee par
       manipulation de bits (<< bit-twilling >>) (cette valeur peut ne pas
       etre unique).

STANDARDS
       gethostid()
              POSIX.1-2008.

       sethostid()
              Aucune.

HISTORIQUE
       4.2BSD. Abandonnees dans 4.4BSD. SVr4 er POSIX.1-2001 specifient
       gethostid(), mais pas sethostid().

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

VOIR AUSSI
       hostid(1), gethostbyname(3).

TRADUCTION
       La traduction francaise de cette page de manuel a ete creee par
       Christophe Blaess <https://www.blaess.fr/christophe/>, Stephan Rafin
       <stephan.rafin@laposte.net>, Thierry Vignaud <tvignaud@mandriva.com>,
       Francois Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe
       Guerard <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-
       luc.coulon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas
       Huriaux <thomas.huriaux@gmail.com>, Nicolas Francois
       <nicolas.francois@centraliens.net>, Florentin Duneau
       <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-
       bretagne.fr>, Denis Barbier <barbier@debian.org>, David Prevot
       <david@tilapin.org> et Jean-Pierre Giraud <jean-pierregiraud@neuf.fr>

       Cette traduction est une documentation libre ; veuillez vous reporter a
       la GNU General Public License version 3
       <https://www.gnu.org/licenses/gpl-3.0.html> concernant les conditions
       de copie et de distribution. Il n'y a aucune RESPONSABILITE LEGALE.

       Si vous decouvrez un bogue dans la traduction de cette page de manuel,
       veuillez envoyer un message a <debian-l10n-french@lists.debian.org>.

Pages du manuel de Linux 6.06   31 octobre 2023                   gethostid(3)