NOM

       openat - Ouvrir un fichier relativement à un descripteur de répertoire

SYNOPSIS

       #include <fcntl.h>

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

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

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

DESCRIPTION

       L'appel système openat() fonctionne de la même façon que open(2),  les  différences  étant
       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, comme pour open(2)).

       Si  pathname  est  un  chemin  relatif,  et  si dirfd a la valeur spéciale AT_FDCWD, alors
       pathname est interprété par rapport au répertoire courant  du  processus  appelant,  comme
       dans open(2).

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

VALEUR RENVOYÉE

       S'il  réussit,  openat()  renvoie  un  nouveau descripteur de fichier. En cas d'erreur, il
       renvoie -1 et errno contient le code d'erreur.

ERREURS

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

       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

       openat() 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. Un appel système similaire existe sur Solaris.

NOTES

       openat()  et  certains autres appels système avec un suffixe « at » sont fournis pour deux
       raisons.

       Tout d'abord, openat() permet à une application d'éviter les problèmes d'accès concurrents
       lors  de l'utilisation de open(2) pour ouvrir des fichiers dans des répertoires autres que
       le répertoire courant. Ces problèmes sont dus au fait que l'un des  composants  du  chemin
       donné  à  open(2)  peut  être  modifié  parallèlement à l'appel open(2). De tels problèmes
       peuvent être évités en ouvrant un descripteur de fichier sur le répertoire cible, puis  en
       fournissant ce descripteur comme argument dirfd de openat().

       Enfin,  openat()  permet  d'implémenter  un « répertoire courant » par thread, grâce à des
       descripteurs de fichier maintenus par l'application. Cette fonctionnalité  peut  également
       être obtenue en jouant avec /proc/self/fd/dirfd, mais de façon moins efficace.

VOIR AUSSI

       faccessat(2),  fchmodat(2),  fchownat(2), fstatat(2), futimesat(2), linkat(2), mkdirat(2),
       mknodat(2), open(2), readlinkat(2), renameat(2), symlinkat(2), unlinkat(2),  utimensat(2),
       mkfifoat(3), 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/>.

       Christophe    Blaess    <http://www.blaess.fr/christophe/>   (1996-2003),   Alain   Portal
       <http://manpagesfr.free.fr/>  (2003-2006).  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> ».