.\" -*- coding: UTF-8 -*- .\" Copyright 1993 Rickard E. Faith (faith@cs.unc.edu) .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" Modified 1997-08-25 by Nicolás Lichtmaier .\" Modified 2004-06-17 by Michael Kerrisk .\" Modified 2008-11-27 by mtk .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH getdomainname 2 "30 mars 2023" "Pages du manuel de Linux 6.05.01" .SH NOM getdomainname, setdomainname \- Lire et écrire le nom de domaine NIS .SH BIBLIOTHÈQUE Bibliothèque C standard (\fIlibc\fP, \fI\-lc\fP) .SH SYNOPSIS .nf \fB#include \fP .PP \fBint getdomainname(char *\fP\fIname\fP\fB, size_t \fP\fIlen\fP\fB);\fP \fBint setdomainname(const char *\fP\fIname\fP\fB, size_t \fP\fIlen\fP\fB);\fP .fi .PP .RS -4 Exigences de macros de test de fonctionnalités pour la glibc (consulter \fBfeature_test_macros\fP(7))\ : .RE .PP \fBgetdomainname\fP(), \fBsetdomainname\fP()\ : .nf .\" commit 266865c0e7b79d4196e2cc393693463f03c90bd8 Depuis la glibc 2.21 : _DEFAULT_SOURCE Dans glibc 2.19 et 2.20 : _DEFAULT_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE < 500) Jusqu'à et y compris la glibc 2.19 : _BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE < 500) .fi .SH DESCRIPTION Ces fonctions sont utilisées pour obtenir ou changer le nom de domaine NIS du système hôte. Plus précisément, elles agissent sur le nom de domaine NIS associé à l'espace de noms UTS du processus appelant. .PP \fBsetdomainname\fP() définit le nom de domaine à la valeur fournie dans le tableau de caractères \fIname\fP. Le paramètre \fIlen\fP indique le nombre d'octets de \fIname\fP (\fIname\fP n'a donc pas à se terminer par un octet NULL). .PP \fBgetdomainname\fP() renvoie le nom de domaine terminé par NULL dans le tableau de caractères \fIname\fP, ayant une longueur de \fIlen\fP octets. Si le nom de domaine terminé par NULL nécessite plus de \fIlen\fP octets, \fBgetdomainname\fP() renvoie les premiers \fIlen\fP octets (glibc) ou produit une erreur (libc). .SH "VALEUR RENVOYÉE" En cas de succès, zéro est renvoyé. En cas d'erreur, \fB\-1\fP est renvoyé et \fIerrno\fP est définie pour préciser l'erreur. .SH ERREURS \fBsetdomainname\fP() peut échouer avec les erreurs suivantes\ : .TP \fBEFAULT\fP \fIname\fP pointe en dehors de l'espace d'adressage utilisateur. .TP \fBEINVAL\fP \fIlen\fP est négatif ou trop large. .TP \fBEPERM\fP L'appelant n'avait pas la capacité \fBCAP_SYS_ADMIN\fP dans l'espace de noms de l'utilisateur associé à son espace de noms UTS (voir \fBnamespaces\fP(7)). .PP \fBgetdomainname\fP() peut échouer avec les erreurs suivantes\ : .TP \fBEINVAL\fP Avec \fBgetdomainname\fP() et la Libc\ : \fIname\fP est NULL ou \fIname\fP est plus long que \fIlen\fP. .SH VERSIONS Sur la plupart des architectures Linux (x86 incluse), il n'y a pas d'appel système \fBgetdomainname\fP()\ ; à la place, la glibc implémente \fBgetdomainname\fP() comme une fonction de bibliothèque qui renvoie une copie du champ \fIdomainname\fP renvoyé par un appel à \fBuname\fP(2). .SH STANDARDS .\" But they appear on most systems... Aucun. .SH HISTORIQUE Depuis Linux 1.0, la limite sur la taille d'un nom de domaine, octet NULL de fin compris, est de 64\ octets. Dans les noyaux plus anciens, elle était de 8\ octets. .SH "VOIR AUSSI" \fBgethostname\fP(2), \fBsethostname\fP(2), \fBuname\fP(2), \fButs_namespaces\fP(7) .PP .SH TRADUCTION La traduction française de cette page de manuel a été créée par Christophe Blaess , Stéphan Rafin , Thierry Vignaud , François Micaux, Alain Portal , Jean-Philippe Guérard , Jean-Luc Coulon (f5ibh) , Julien Cristau , Thomas Huriaux , Nicolas François , Florentin Duneau , Simon Paillard , Denis Barbier , David Prévot et Jean-Philippe MENGUAL . .PP Cette traduction est une documentation libre ; veuillez vous reporter à la .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License version 3 .UE concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE. .PP Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à .MT debian-l10n-french@lists.debian.org .ME .