GETHOSTNAME

Index

NOM
SYNOPSIS
DESCRIPTION
VALEUR RENVOYÉE
ERREURS
CONFORMITÉ
NOTES
NOTES SUR LA GLIBC
VOIR AUSSI
TRADUCTION

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);

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.
La traduction de cette page de manuel est basée sur les traductions disponibles sur http://manpagesfr.free.fr/, mais est gérée par l'équipe francophone de traduction de Debian au travers de la liste de discussion debian-l10n-french.
Veuillez signaler toute erreur de traduction 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> ».

Création : octobre 2007