GETHOSTNAME(2)

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

DESCRIPTION
Ces fonctions sont utilisees pour lire, ou changer le nom d'hote de la machine utilisee.

VALEUR RENVOYEE
gethostname et sethostname renvoient 0 s'ils reussissent, ou -1 s'ils echouent, auquel cas errno contient le code d'erreur.

ERREURS

EINVAL
    len est negatif, ou pour sethostname, len est plus grand que la longeur maximale autorisee, ou encore, pour gethostname sur Linux/i386, len est plus petit que la taille necessaire.

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

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

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

BUGS
Certaines implementations de gethostname retourne sans erreurs len octets meme si name est plus grand. Linux/Alpha se comporte ainsi. Linux/i386, toutefois renvoie EINVAL dans ce cas (dans la bibliotheque DLL 4.6.27).

NOTES
Sous Linux/Alpha, gethostname est un appel systeme. Sous Linux/i386, gethostname est implemente au niveau bibliotheque en appelant uname(2).

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