GETHOSTNAME(2)     Manuel du programmeur Linux     GETHOSTNAME(2)


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.

VALEUR RENVOYÉE
       gethostname et sethostname renvoient 0 s'ils  réussissent,
       ou  -1  s'ils  échouent, auquel cas errno contient le code
       d'erreur.

ERREURS
       EINVAL len est négatif, ou pour sethostname, len est  plus
              grand que la longeur maximale autorisée, ou encore,
              pour gethostname sur Linux/i386, len est plus petit
              que la taille nécessaire.

       EPERM  Pour   sethostname,   l'appelant   n'est   pas   le
              Super-User.

       EFAULT name  pointe  en  dehors  de  l'espace  d'adressage
              accessible.

CONFORMITÉ
       SVr4,  4.4BSD  (Cette fonction est apparue en premier dans
       4.2BSD).  POSIX.1  ne  définit  pas  ces  fonctions,  mais
       ISO/IEC 9945-1:1990 les mentionne au paragraphe B.4.4.1.

BUGS
       Certaines  implémentations  de  gethostname  retourne sans
       erreurs  len  octets  même  si  name   est   plus   grand.
       Linux/Alpha se comporte ainsi.  Linux/i386, toutefois ren­
       voie EINVAL dans ce cas (dans la bibliothèque DLL 4.6.27).

NOTES
       Sous  Linux/Alpha, gethostname est un appel système.  Sous
       Linux/i386, gethostname  est  implémenté  au  niveau  bib­
       liothèque en appelant uname(2).

VOIR AUSSI
       getdomainname(2), setdomainname(2), uname(2)


TRADUCTION
       Christophe Blaess, 1997.





Linux                      8 Avril 1997                         1