Provided by:
manpages-fr-dev_3.32d0.2p4-1_all 
NOM
gethostname, sethostname - Lire/ecrire le nom d'hote
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 fonctionnalites 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 systeme sont utilises pour obtenir ou changer le nom d'hote
du processeur en cours.
sethostname() definit le nom d'hote a la valeur fournie dans le tableau
d'octets name. Le parametre len indique le nombre d'octets dans nom
(ainsi, name n'a pas a contenir d'octet nul de fin).
gethostname() renvoie le nom d'hote, avec un octet nul de fin, dans le
tableau d'octets name, qui a une longueur de len octets. Si le nom
d'hote avec son octet nul de fin est trop long pour tenir, alors le nom
est tronque, et aucune erreur n'est renvoyee (mais consultez la section
NOTES ci-dessous). POSIX.1-2001 indique que dans le cas ou le nom est
tronque, il n'est pas specifie si le tableau renvoye inclut ou pas un
octet nul de fin.
VALEUR RENVOY'EE
S'il reussit, cet appel systeme renvoie 0. S'il echoue, il renvoie -1
et remplit errno en consequence.
ERREURS
EFAULT name pointe en dehors de l'espace d'adressage accessible.
EINVAL len est negatif ou, pour sethostname(), len est plus grand que
la taille maximale autorisee.
ENAMETOOLONG
(gethostname() de la glibc) len est plus petit que la veritable
taille (avant la glibc 2.1, la glibc utilisait EINVAL dans ce
cas).
EPERM Pour sethostname(), l'appelant n'a pas la capacite
CAP_SYS_ADMIN.
CONFORMIT'E
SVr4, BSD 4.4 (ces interfaces sont apparues dans BSD 4.2). POSIX.1-2001
definit gethostname() mais pas sethostname().
NOTES
SUSv2 garantit que << les noms d'hotes sont limites a 255 octets >>.
POSIX.1-2001 garantit que << les noms d'hotes (non compris le caractere
NUL final) sont limites a HOST_NAME_MAX octets >>. Sous Linux,
HOST_NAME_MAX vaut la valeur 64, qui a ete la limite depuis Linux 1.0
(les noyaux plus anciens imposaient une limite de 8 octets).
Notes sur la glibc
La bibliotheque C GNU n'utilise pas l'appel systeme gethostname() ; a
la place, gethostname() est implementee comme une fonction de
bibliotheque qui appelle uname(2) et copie jusqu'a len octets depuis le
champ nodename renvoye dans name. Apres la copie, la fonction verifie
si la longueur de nodename etait superieure ou egale a len, et si c'est
le cas, la fonction renvoie -1 en positionnant errno a ENAMETOOLONG.
Les versions de glibc anterieures a 2.2 gerent le cas ou la longueur de
nodename est superieur ou egal a len de facon differente : rien n'est
copie dans name, et la fonction renvoie -1 en positionnant errno a
ENAMETOOLONG ; dans ce cas, aucun caractere nul de fin n'est inclus
dans la valeur name renvoyee.
Les versions de la glibc anterieures a la version 2.2 prennent en
charge differemment le cas ou la longueur de nodename est superieure ou
egal a len : rien n'est copie dans name et la fonction renvoie -1 en
positionnant errno a ENAMETOOLONG.
VOIR AUSSI
getdomainname(2), setdomainname(2), uname(2).
COLOPHON
Cette page fait partie de la publication 3.32 du projet man-pages
Linux. Une description du projet et des instructions pour signaler des
anomalies peuvent etre trouvees a l'adresse
<URL:http://www.kernel.org/doc/man-pages/>.
TRADUCTION
Depuis 2010, cette traduction est maintenue a l'aide de l'outil po4a
<URL:http://po4a.alioth.debian.org/> par l'equipe de traduction
francophone au sein du projet perkamon
<URL:http://perkamon.alioth.debian.org/>.
Christophe Blaess <URL:http://www.blaess.fr/christophe/> (1996-2003),
Alain Portal <URL:http://manpagesfr.free.fr/> (2003-2006). Julien
Cristau et l'equipe francophone de traduction de Debian (2006-2009).
Veuillez signaler toute erreur de traduction en ecrivant a
<debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le
paquet manpages-fr.
Vous pouvez toujours avoir acces a la version anglaise de ce document
en utilisant la commande << man -L C <section> <page_de_man> >>.