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 fonctionalité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 identificateur 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(2).

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 en tripotant les bits de l'adresse IPv4. (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 19 décembre 2007.

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.