Provided by:
manpages-fr-dev_3.27fr1.4-1_all 
NOM
gethostid, sethostid - Lire/ecrire l'identifiant unique de l'hote
SYNOPSIS
#include <unistd.h>
long gethostid(void);
int sethostid(long hostid);
Exigences de macros de test de fonctionnalites 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() recuperent et definissent respectivement un
identifiant 32 bits unique pour la machine. L'identifiant 32 bits est
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 RENVOY'EE
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 remplit errno en consequence.
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.
CONFORMIT'E
BSD 4.2. Ces fonctions ont ete abandonnees dans BSD 4.4. SVr4 contient
gethostid() mais pas sethostid(). POSIX.1-2001 specifie gethostid()
mais pas sethostid().
NOTES
Dans l'implementation de la glibc, hostid est sauvegarde dans le
fichier /etc/hostid (pour les versions anterieures a la glibc 2.2,
/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).
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.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> >>.