GETDOMAINNAME
Section : Manuel du programmeur Linux (
2)
Mise à jour de la version anglaise : 26 juillet 2007
Index
Menu principal
NOM
getdomainname, setdomainname - Lire ou fixer le nom de domaine
SYNOPSIS
#include <unistd.h>
int getdomainname(char *name, size_t len);
int setdomainname(const char *name, size_t len);
Exigences de macros de test de fonctionnalités pour la glibc (voir
feature_test_macros(7)) :
getdomainame(),
setdomainame() :
_BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE < 500)
DESCRIPTION
Ces deux fonctions servent à lire ou à changer le nom de domaine de
l'hôte concerné.
Si le nom de domaine, suivi d'un octet nul, nécessite plus de
len
octets pour être stocké,
getdomainname()
renvoie les
len
premiers octets (glibc), ou une erreur (libc).
VALEUR RENVOYÉE
Ces appels systèmes renvoient 0 s'ils réussissent,
ou -1 s'ils échouent, auquel cas
errno
est renseignée en conséquence.
ERREURS
- EFAULT
-
Pour
setdomainname(),
name
pointe en dehors de l'espace d'adressage disponible.
- EINVAL
-
Avec
getdomainname()
et la Libc :
name
est NULL ou
name
est plus long que
len.
- EINVAL
-
Avec
setdomainname() :
len
est négatif ou trop grand.
- EPERM
-
Pour
setdomainname() :
l'appelant n'est pas privilégié (Linux : n'a pas la capacité
CAP_SYS_ADMIN).
CONFORMITÉ
Cette fonction n'est pas spécifiée par POSIX.
VOIR AUSSI
gethostname(2),
sethostname(2),
uname(2)
TRADUCTION
Ce document est une traduction réalisée par Christophe Blaess
<http://www.blaess.fr/christophe/> le 10 octobre 1996
et révisée le 23 juin 2008.
L'équipe de traduction a fait le maximum pour réaliser une adaptation
française de qualité. La version anglaise la plus à jour de ce document est
toujours consultable via la commande : « LANG=C man 2 getdomainname ».
N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute
erreur dans cette page de manuel.
Index
- NOM
-
- SYNOPSIS
-
- DESCRIPTION
-
- VALEUR RENVOYÉE
-
- ERREURS
-
- CONFORMITÉ
-
- VOIR AUSSI
-
- TRADUCTION
-
Dernière mise à jour : 23 juin 2008