getdomainname, setdomainname − Lire ou fixer le nom de domaine.

#include <unistd.h>

int getdomainname(char *name, size_t len);
int setdomainname(const char *name, size_t len);

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

getdomainname() et setdomainname() renvoient 0 s’ils réussissent, ou −1 s’ils échouent, auquel cas errno contient le code d’erreur.

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

Cette fonction n’est pas spécifiée par POSIX.

gethostname(2), sethostname(2), uname(2)

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 14 août 2006.

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.