GETHOSTID(2)

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
Lit ou écrit un identifiant unique sur 32 bits pour la station utilisée. Cet identifiant est censé être unique pour l'ensemble des stations UNIX existantes. Il correspond généralement à l'adresse Internet de la machine locale, comme renvoyé par gethostbyname(3), et est normalement fixé une fois pour toutes. L'appel de sethostid() est bien sûr limité au superutilisateur. L'argument hostid est mémorisé dans le fichier /etc/hostid.

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

FICHIERS
/etc/hostid

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 glibc, si gethostid() ne peut pas ouvrir /etc/hostid, il obtiendra le nom d'hôte avec gethostname(2), passera ce nom d'hôte à gethostbyname_r(3) afin d'obtenir l'adresse IPv4 de l'hôte et renverra une valeur obtenue par manipulation de cette adresse. (Cette valeur peut ne pas être unique.)

VOIR AUSSI
hostid(1), gethostbyname(3)

TRADUCTION

Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 15 octobre 1996 et révisée le 23 juin 2008.

L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 2 gethostid ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.