Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] gethostname, sethostname - Lire / écrire le nom d'hôte. [size=18] [b]Résumé[/b] [/size] [b]#include <unistd.h>[/b] [b][i]int gethostname(char * nom , size_t lg );[/i][/b] [b][/b] [b][i]int sethostname(const char * nom , size_t lg );[/i][/b] [size=18] [b]Description[/b] [/size] Ces fonctions sont utilisées pour lire, ou changer le nom d'hôte de la machine utilisée. La fonction [b]gethostname()[/b] place le nom d'hôte terminé par un caractère NUL (précédemment fixé avec [b]sethostname ())[/b] dans la table de caractères [i]nom[/i] contenant au moins [i]lg[/i] 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. [size=18] [b]Valeur renvoyée[/b] [/size] [b]gethostname et sethostname[/b] renvoient 0 s'ils réussissent, ou -1 s'ils échouent, auquel cas [i]errno[/i] contient le code d'erreur. [size=18] [b]Erreurs[/b] [/size] [b]EINVAL[/b] [i]len[/i] [table][row][col]    [/col][col]est négatif, ou pour [b]sethostname ,[/b] [i]len[/i] est plus grand que la longueur maximale autorisée, ou encore, pour [b]gethostname[/b] sur Linux/i386, [i]len[/i] est plus petit que la taille nécessaire. (Dans ce dernier cas, la GlibC 2.1 utilise ENAMETOOLONG).[/col][/row][/table] [b]EPERM[/b] [table][row][col]    [/col][col]Pour [b]sethostname ,[/b] l'appelant n'est pas le Super-User.[/col][/row][/table] [b]EFAULT[/b] [i]name[/i] [table][row][col]    [/col][col]pointe en dehors de l'espace d'adressage accessible.[/col][/row][/table] [size=18] [b]Conformité[/b] [/size] SVr4, 4.4BSD (Cette fonction est apparue en premier dans 4.2BSD). POSIX.1003.1-2001 définit [b]gethostname[/b] mais pas [b]sethostname .[/b] [size=18] [b]Bugs[/b] [/size] Sur de nombreux systèmes Linux / GlibC, [b]gethostname[/b] renverra une erreur au lieu de tronquer le nom d'hôte. [size=18] [b]Notes[/b] [/size] SUSv2 garantit que les "noms d'hôtes sont limités à 255 octets". Posix 1003.1-2001 garantit que les "noms d'hôtes (non compris le caractère NUL final) sont limités à HOST_NAME_MAX octets". [size=18] [b]Voir aussi[/b] [/size] [b]getdomainname (2),[/b] [b]setdomainname (2),[/b] [b]uname (2).[/b] [size=18] [b]Traduction[/b] [/size] Christophe Blaess, 1996-2003.
Fichier