NOM

       opendir, fdopendir - Ouvrir un répertoire

SYNOPSIS

       #include <sys/types.h>
       #include <dirent.h>

       DIR *opendir(const char *nom);
       DIR *fdopendir(int fd);

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

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

DESCRIPTION

       La fonction opendir() ouvre un flux répertoire correspondant au répertoire nom, et renvoie
       un pointeur sur ce flux. Le flux est positionné sur la première entrée du répertoire.

       La fonction fdopendir() est similaire à opendir(), mais renvoie un flux de répertoire pour
       le répertoire demandé avec le descripteur de fichier fd ouvert. Après un  appel  réussi  à
       fdopendir(),  fd est utilisé en interne par l'implémentation, et ne doit plus être utilisé
       par l'application.

VALEUR RENVOYÉE

       Les fonctions opendir() et fdopendir() renvoient un pointeur sur le  flux  répertoire.  Si
       une erreur se produit, NULL est renvoyé, et errno contient le code d'erreur.

ERREURS

       EACCES Accès interdit.

       EBADF  fd n'est pas un descripteur de fichier valable ouvert en lecture.

       EMFILE Trop de descripteurs de fichier pour le processus en cours.

       ENFILE Trop de fichiers ouverts simultanément sur le système.

       ENOENT Le répertoire n'existe pas, ou nom est une chaîne vide.

       ENOMEM Pas assez de mémoire pour terminer l'opération.

       ENOTDIR
              nom n'est pas un répertoire

VERSIONS

       fdopendir() est disponible dans la glibc depuis la version 2.4.

CONFORMITÉ

       opendir()  est présente dans SVr4, BSD 4.3 et spécifiée dans POSIX.1-2001. fdopendir() est
       spécifiée dans POSIX.1-2008.

NOTES

       Le descripteur sous-jacent à un flux répertoire peut être obtenu avec dirfd(3).

       La fonction opendir() définit l'attribut « close-on-exec » pour le descripteur de  fichier
       sous-jacent  à  DIR  *.  La  fonction  fdopendir()  laisse  inchangée  la configuration de
       l'attribut « close-on-exec » pour le descripteur de fichier fd. POSIX.1-200x laisse ouvert
       la  le  fait  que l'attribut close-on-exec du descripteur de fichier fd soit positionné ou
       non par un appel réussi à fdopendir().

VOIR AUSSI

       open(2),  closedir(3),  dirfd(3),  readdir(3),   rewinddir(3),   scandir(3),   seekdir(3),
       telldir(3)

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). Nicolas  François  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> ».