Provided by:
manpages-fr-dev_2.64.1-1_all 
NOM
gethostname, sethostname - Lire/écrire le nom d’hôte
SYNOPSIS
#include <unistd.h>
int gethostname(char *name, size_t len);
int sethostname(const char *name, size_t len);
Exigences pour les macros de test de fonctionnalité de la glibc (consultez
feature_test_macros(7)) :
gethostname() : _BSD_SOURCE || _XOPEN_SOURCE >= 500
sethostname() : _BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE < 500)
DESCRIPTION
Ces fonctions sont utilisées pour lire, ou changer le nom d’hôte de la
machine utilisée. La fonction gethostname() place le nom d’hôte terminé
par un caractère NUL (précédemment fixé avec sethostname()) dans la
table de caractères name contenant au moins len octets. Si le nom
d’hôte suivi d’un NUL ne tient pas dans cette zone mémoire, il est
tronqué sans qu’aucune erreur ne soit signalée. Il n’est pas précisé si
le nom d’hôte tronqué est terminé ou non par un NUL.
VALEUR RENVOYÉE
L’appel renvoie 0 quand il réussit, ou -1 s’il échoue, auquel cas errno
contient le code d’erreur.
ERREURS
EFAULT name pointe en dehors de l’espace d’adressage accessible.
EINVAL len est négatif, ou pour sethostname(), len est plus grand que
la longueur maximale autorisée, ou encore, pour gethostname()
sur Linux/i386, len est plus petit que la taille nécessaire.
(Dans ce dernier cas, la glibc 2.1 utilise ENAMETOOLONG).
EPERM Pour sethostname(), l’appelant n’a pas la capacité
CAP_SYS_ADMIN.
CONFORMITÉ
SVr4, BSD 4.4 (ces interfaces sont apparues dans BSD 4.2). POSIX.1-2001
définit gethostname() mais pas sethostname().
NOTES
SUSv2 garantit que « les noms d’hôtes sont limités à 255 octets ».
POSIX.1-2001 garantit que « les noms d’hôtes (non compris le caractère
NUL final) sont limités à HOST_NAME_MAX octets ».
Notes sur la glibc
La bibliothèque C GNU implémente gethostname() comme une fonction de
bibliothèque qui appelle uname(2) et copie jusqu’à len octets depuis le
champ nodename renvoyé dans name. Après la copie, la fonction vérifie
si la longueur de nodename était supérieure ou égale à len, et si c’est
le cas, la fonction renvoie -1 en positionnant errno à ENAMETOOLONG.
Les versions de glibc antérieures à 2.2 gèrent le cas où la longueur de
nodename est supérieur ou égal à len de façon différente : rien n’est
copié dans name, et la fonction renvoie -1 en positionnant errno à
ENAMETOOLONG.
VOIR AUSSI
getdomainname(2), setdomainname(2), uname(2).
TRADUCTION
Cette page de manuel a été traduite et mise à jour par Christophe
Blaess <http://www.blaess.fr/christophe/> entre 1996 et 2003, puis par
Alain Portal <aportal AT univ-montp2 DOT fr> jusqu’en 2006, et mise à
disposition sur http://manpagesfr.free.fr/.
Les mises à jour et corrections de la version présente dans Debian sont
directement gérées par Julien Cristau <jcristau@debian.org> et l’équipe
francophone de traduction de Debian.
Veuillez signaler toute erreur de traduction en écrivant à
<debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le
paquet manpages-fr.
Vous pouvez toujours avoir accès à la version anglaise de ce document
en utilisant la commande « man -L C <section> <page_de_man> ».