Provided by: manpages-fr-dev_3.57d1p1-1_all 
NOM
gethostname, sethostname - Lire et é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 de macros de test de fonctionnalités pour la glibc (consultez
feature_test_macros(7)) :
gethostname() :
Depuis la glibc 2.12 : _BSD_SOURCE || _XOPEN_SOURCE >= 500
|| /* Depuis la glibc 2.12 : */ _POSIX_C_SOURCE >= 200112L
sethostname() :
_BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE < 500)
DESCRIPTION
Ces appels système sont utilisés pour obtenir ou changer le nom d'hôte du processeur en
cours.
sethostname() définit le nom d'hôte à la valeur fournie dans le tableau d'octets name. Le
paramètre len indique le nombre d'octets dans nom (ainsi, name n'a pas à contenir d'octet
nul de fin).
gethostname() renvoie le nom d'hôte, avec un octet nul de fin, dans le tableau d'octets
name, qui a une longueur de len octets. Si le nom d'hôte avec son octet nul de fin est
trop long pour tenir, alors le nom est tronqué, et aucune erreur n'est renvoyée (mais
consultez la section NOTES ci-dessous). POSIX.1-2001 indique que dans le cas ou le nom est
tronqué, il n'est pas spécifié si le tableau renvoyé inclut ou pas un octet nul de fin.
VALEUR RENVOYÉE
S'il réussit, cet appel système renvoie 0. S'il échoue, il renvoie -1 et remplit errno en
conséquence.
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 taille maximale
autorisée.
ENAMETOOLONG
(gethostname() de la glibc) len est plus petit que la véritable taille (avant la
glibc 2.1, la glibc utilisait EINVAL dans ce cas).
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 ». Sous Linux, HOST_NAME_MAX vaut la valeur 64, qui a été la limite depuis Linux
1.0 (les noyaux plus anciens imposaient une limite de 8 octets).
Notes sur la glibc
La bibliothèque C GNU n'utilise pas l'appel système gethostname() ; à la place,
gethostname() est implémentée 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 ; dans ce cas, aucun caractère nul de fin n'est inclus dans la valeur
name renvoyée.
Les versions de la glibc antérieures à la version 2.2 prennent en charge différemment le
cas où la longueur de nodename est supérieure ou égal à len : rien n'est copié dans name
et la fonction renvoie -1 en positionnant errno à ENAMETOOLONG.
VOIR AUSSI
getdomainname(2), setdomainname(2), uname(2).
COLOPHON
Cette page fait partie de la publication 3.57 du projet man-pages Linux. Une description
du projet et des instructions pour signaler des anomalies peuvent être trouvées à
l'adresse http://www.kernel.org/doc/man-pages/.
TRADUCTION
Depuis 2010, cette traduction est maintenue à l'aide de l'outil po4a
<http://po4a.alioth.debian.org/> par l'équipe de traduction francophone au sein du projet
perkamon <http://perkamon.alioth.debian.org/>.
Christophe Blaess <http://www.blaess.fr/christophe/> (1996-2003), Alain Portal
<http://manpagesfr.free.fr/> (2003-2006). Julien Cristau et l'équipe francophone de
traduction de Debian (2006-2009).
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> ».