NOM

       mkdirat - Créer un répertoire relatif à un descripteur

SYNOPSIS

       #include <fcntl.h> /* Définition des constantes AT_* */
       #include <sys/stat.h>

       int mkdirat(int dirfd, const char *pathname, mode_t mode);

   Exigences de macros de test de fonctionnalités pour la glibc (consultez feature_test_macros(7)) :

       mkdirat() :
           Depuis la glibc 2.10 :
               _XOPEN_SOURCE >= 700 || _POSIX_C_SOURCE >= 200809L
           Avant la glibc 2.10 :
               _ATFILE_SOURCE

DESCRIPTION

       L'appel  système  mkdirat()  fonctionne  exactement  comme  mkdir(2), les seules différences étant celles
       décrites dans cette page.

       Si le chemin donné dans pathname est relatif, il est interprété par rapport au répertoire  référencé  par
       le  descripteur  de  fichier  dirfd  (plutôt que par rapport au répertoire courant du processus appelant,
       comme dans mkdir(2)).

       Si pathname est relatif et dirfd a la valeur spéciale AT_FDCWD, pathname est interprété  relativement  au
       répertoire courant du processus appelant, comme dans mkdir(2).

       Si pathname est un chemin absolu, dirfd est ignoré.

VALEUR RENVOYÉE

       S'il  réussit,  mkdirat()  renvoie  zéro.  En cas d'erreur, il renvoie -1 et remplit errno avec la valeur
       d'erreur.

ERREURS

       Les erreurs renvoyées par mkdir(2) peuvent  aussi  l'être  par  mkdirat().  Les  erreurs  supplémentaires
       suivantes peuvent également se produire pour mkdirat() :

       EBADF  dirfd n'est pas un descripteur de fichier valable.

       ENOTDIR
              pathname  est  relatif,  et  le  descripteur  de  fichier dirfd est associé à un fichier, pas à un
              répertoire.

VERSIONS

       mkdirat() a été ajouté au noyau Linux dans sa version 2.6.16 ; la glibc le gère depuis la version 2.4.

CONFORMITÉ

       POSIX.1-2008.

NOTES

       Consultez openat(2) pour une explication de la nécessité de mkdirat().

VOIR AUSSI

       mkdir(2), openat(2), path_resolution(7)

COLOPHON

       Cette page fait partie de la publication 3.57 du projet man-pages Linux. Une description du projet et des
       instructions    pour    signaler    des    anomalies    peuvent     être     trouvées     à     l'adresse
       http://www.kernel.org/doc/man-pages/.

TRADUCTION

       Depuis 2010, cette traduction est maintenue à l'aide de l'outil po4a <http://po4a.alioth.debian.org/> par
       l'équipe de traduction francophone au sein du projet perkamon <http://perkamon.alioth.debian.org/>.

       Julien Cristau et l'équipe francophone de traduction de Debian (2006-2009).

       Veuillez  signaler  toute erreur de traduction en écrivant à <debian-l10n-french@lists.debian.org> ou par
       un rapport de bogue sur le paquet manpages-fr.

       Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande « man -L C
       <section> <page_de_man> ».

Linux                                              4 mai 2012                                         MKDIRAT(2)