.\" -*- coding: UTF-8 -*- '\" t .\" Copyright 1993 Rickard E. Faith (faith@cs.unc.edu) .\" .\" Updated with additions from Mitchum DSouza .\" Portions Copyright 1993 Mitchum DSouza .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" Modified Tue Oct 22 00:22:35 EDT 1996 by Eric S. Raymond .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH gethostid 3 "20 juillet 2023" "Pages du manuel de Linux 6.05.01" .SH NOM gethostid, sethostid \- Lire/écrire l'identifiant unique de l'hôte .SH BIBLIOTHÈQUE Bibliothèque C standard (\fIlibc\fP, \fI\-lc\fP) .SH SYNOPSIS .nf \fB#include \fP .PP \fBlong gethostid(void);\fP \fBint sethostid(long \fP\fIhostid\fP\fB);\fP .fi .PP .RS -4 Exigences de macros de test de fonctionnalités pour la glibc (consulter \fBfeature_test_macros\fP(7))\ : .RE .PP \fBgethostid\fP()\ : .nf .\" || _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED .\" || _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED Depuis la glibc 2.20 : _DEFAULT_SOURCE || _XOPEN_SOURCE >= 500 Pour la glibc antérieure et égale à 2.19 : _BSD_SOURCE || _XOPEN_SOURCE >= 500 .fi .PP \fBsethostid\fP()\ : .nf .\" commit 266865c0e7b79d4196e2cc393693463f03c90bd8 Depuis la glibc 2.21 : _DEFAULT_SOURCE Dans glibc 2.19 et 2.20 : _DEFAULT_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE < 500) Jusqu'à et y compris la glibc 2.19 : _BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE < 500) .fi .SH DESCRIPTION \fBgethostid\fP() et \fBsethostid\fP() récupèrent et définissent respectivement un identifiant 32\ bits unique pour la machine. L'identifiant 32\ bits étaitt 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 \fBgethostbyname\fP(3) et il ne devrait pas être nécessaire de le définir. .PP L'appel de \fBsethostid\fP() est bien sûr limité au superutilisateur. .SH "VALEUR RENVOYÉE" \fBgethostid\fP() retourne l'identifiant sur 32 bits de l'hôte, tel qu'il a été positionné par \fBsethostid\fP(). .PP Si elle réussit, \fBsethostid\fP() renvoie \fB0\fP. En cas d'erreur, elle renvoie \fB\-1\fP et \fIerrno\fP est défini pour indiquer l'erreur. .SH ERREURS \fBsethostid\fP() peut échouer pour les raisons suivantes\ : .TP \fBEACCES\fP L'appelant n'a pas les permissions d'écrire dans le fichier utilisé pour sauvegarder l'ID de l'hôte. .TP \fBEPERM\fP L'ID de l'utilisateur ou du groupe effectif du processus appelant ne correspond pas à l'ID réel. .SH ATTRIBUTS Pour une explication des termes utilisés dans cette section, consulter \fBattributes\fP(7). .TS allbox; lb lb lbx l l l. Interface Attribut Valeur T{ .na .nh \fBgethostid\fP() T} Sécurité des threads T{ .na .nh MT\-Safe hostid env locale T} T{ .na .nh \fBsethostid\fP() T} Sécurité des threads T{ .na .nh MT\-Unsafe const:hostid T} .TE .sp 1 .SH VERSIONS .\" libc5 used /etc/hostid; libc4 didn't have these functions Dans l'implémentation de la glibc, \fIhostid\fP est sauvegardé dans le fichier \fI/etc/hostid\fP. (Avant la la glibc\ 2.2, le fichier \fI/var/adm/hostid\fP était utilisé). .PP Dans l'implémentation de la glibc, si \fBgethostid\fP() ne peut pas ouvrir le fichier contenant l'ID de l'hôte, alors elle obtient le nom d'hôte avec \fBgethostname\fP(2), passe ce nom d'hôte à \fBgethostbyname_r\fP(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). .SH STANDARDS .TP \fBgethostid\fP() POSIX.1\-2008. .TP \fBsethostid\fP() Aucune. .SH HISTORIQUE 4.2BSD. Abandonnées dans 4.4BSD. SVr4 er POSIX.1\-2001 spécifient \fBgethostid\fP(), mais pas \fBsethostid\fP(). .SH BOGUES Il est impossible de s'assurer que l'identifiant est globalement unique. .SH "VOIR AUSSI" \fBhostid\fP(1), \fBgethostbyname\fP(3). .PP .SH TRADUCTION La traduction française de cette page de manuel a été créée par Christophe Blaess , Stéphan Rafin , Thierry Vignaud , François Micaux, Alain Portal , Jean-Philippe Guérard , Jean-Luc Coulon (f5ibh) , Julien Cristau , Thomas Huriaux , Nicolas François , Florentin Duneau , Simon Paillard , Denis Barbier , David Prévot et Jean-Pierre Giraud . .PP Cette traduction est une documentation libre ; veuillez vous reporter à la .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License version 3 .UE concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE. .PP Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à .MT debian-l10n-french@lists.debian.org .ME .