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