Provided by: manpages-fr-dev_3.32d0.2p4-1_all bug

NOM

       readdir, readdir_r - Consulter un repertoire

SYNOPSIS

       #include <dirent.h>

       struct dirent *readdir(DIR *dirp);

       int readdir_r(DIR *dirp, struct dirent *entry, struct dirent **result);

   Exigences  de  macros  de  test de fonctionnalites pour la glibc (consultez
   feature_test_macros(7)) :

       readdir_r() :
           _POSIX_C_SOURCE >= 1 || _XOPEN_SOURCE || _BSD_SOURCE ||
           _SVID_SOURCE || _POSIX_SOURCE

DESCRIPTION

       La  fonction  readdir()  renvoie  un  pointeur sur une structure dirent
       representant l'entree suivante du flux repertoire pointe par dirp. Elle
       renvoie NULL a la fin du repertoire, ou en cas d'erreur.

       Avec Linux, la structure dirent est definie comme suit :

           struct dirent {
               ino_t          d_ino;       /* numero d'inoeud */
               off_t          d_off;       /* decalage vers le prochain dirent */
               unsigned short d_reclen;    /* longueur de cet enregistrement */
               unsigned char  d_type;      /* type du fichier ; pas pris en
                                              charge par tous les types de
                                              systeme de fichiers */
               char           d_name[256]; /* nom du fichier */
           };

       Les  seuls  champs  exiges  par POSIX.1 pour la structure dirent sont :
       d_name[], de taille non definie, avec au plus NAME_MAX caracteres avant
       le  caractere  nul  final ;  et  (en  tant qu'extension XSI) d_ino. Les
       autres champs ne sont pas standard, et ne sont pas  presents  sur  tous
       les systemes ; voyez les NOTES ci-dessous pour plus de details.

       Les  donnees  renvoyees  par  readdir()  sont  ecrasees lors de l'appel
       suivant a readdir() sur le meme flux repertoire.

       La fonction readdir_r() est la version reentrante  de  readdir().  Elle
       lit  la  prochaine  entree de repertoire a partir du flux de repertoire
       dirp, et la renvoie dans le tampon  de  l'appelant  pointe  par  entry.
       (Consultez  la  section NOTES pour des informations sur l'allocation de
       ce tampon.) Un pointeur vers l'element renvoye est place dans *result ;
       si  la  fin du flux de repertoire est rencontree, NULL est renvoye dans
       *result.

VALEUR RENVOY'EE

       En cas de succes, readdir()  renvoie  un  pointeur  sur  une  structure
       dirent  (cette structure peut avoir ete alouee statiquement ; n'essayez
       pas de la desalouer avec free(3)). Lorsque la  fin  du  repertoire  est
       atteinte,  NULL  est  renvoye  et  errno  n'est  pas  modifiee.  En cas
       d'erreur, NULL est renvoyee et errno contient le code d'erreur.

       La fonction readdir_r() renvoie 0 si elle reussit. Si elle echoue, elle
       renvoie  un  code  d'erreur  positif (liste dans ERREURS). Si la fin du
       repertoire est atteinte, readdir_r() renvoie 0  et  renvoie  NULL  dans
       *result.

ERREURS

       EBADF  Le descripteur de flux du repertoire, dirp, n'est pas valable.

CONFORMIT'E

       SVr4, BSD 4.3, POSIX.1-2001.

NOTES

       Seuls  les champs d_name et d_ino sont specifies dans POSIX.1-2001. les
       autres champs sont disponibles sur beaucoup de systemes, mais  pas  sur
       tous.  Sur  la glibc, les programmes peuvent verifier la disponibilites
       des  champs  non  definis  dans  POSIX.1  en  testant  sir  les  macros
       _DIRENT_HAVE_D_NAMLEN,   _DIRENT_HAVE_D_RECLEN,  _DIRENT_HAVE_D_OFF  ou
       _DIRENT_HAVE_D_TYPE sont definie.

       En dehors de Linux, le champ d_type est disponible  presque  uniquement
       sur  les systemes BSD. Ce champ evite d'avoir a appeler lstat(2) si les
       actions qui suivent dependent du type de fichier. Si la macro  de  test
       de  fonctionnalites _BSD_SOURCE est definie, alors la glibc definie les
       macros suivantes pour les valeurs renvoyees dans d_type :

       DT_BLK      Il s'agit d'un peripherique bloc.

       DT_CHR      Il s'agit d'un peripherique caractere.

       DT_DIR      Il s'agit d'un repertoire

       DT_FIFO     Il s'agit d'un tube nomme (FIFO).

       DT_LNK      Il s'agit d'un lien symbolique.

       DT_REG      Il s'agit d'un fichier ordinaire.

       DT_SOCK     Il s'agit d'une socket de domaine UNIX.

       DT_UNKNOWN  Le type du fichier est inconnu.

       Si le type de fichier ne peut pas etre determine, la valeur  DT_UNKNOWN
       est renvoyee dans d_type.

       Actuellement,  seuls  certains  systemes  de  fichiers  (parmi lesquels
       Btrfs, ext2, ext3 et ext4) prennent completement en charge le  type  de
       fichier dans d_type. Toutes les applications doivent gerer correctement
       une valeur de retour valant DT_UNKNOWN.

       Puisque POSIX.1 ne specifie pas la  taille  du  champ  d_name,  et  que
       d'autres  champs  non  standard  peuvent  preceder  ce  champ  dans  la
       structure dirent,  les  applications  portables  utilisant  readdir_r()
       devraient  allouer le tampon dont l'adresse est passee dans entry de la
       facon suivante :

           len = offsetof(struct dirent, d_name) +
                     pathconf(dirpath, _PC_NAME_MAX) + 1
           entryp = malloc(len);

       (POSIX.1 demande que d_name  soit  le  dernier  champ  d'une  structure
       dirent.)

VOIR AUSSI

       getdents(2),   read(2),  closedir(3),  dirfd(3),  ftw(3),  offsetof(3),
       opendir(3), rewinddir(3), scandir(3), seekdir(3), telldir(3)

COLOPHON

       Cette page fait partie de  la  publication  3.32  du  projet  man-pages
       Linux.  Une description du projet et des instructions pour signaler des
       anomalies      peuvent      etre       trouvees       a       l'adresse
       <URL:http://www.kernel.org/doc/man-pages/>.

TRADUCTION

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

       Christophe Blaess  <URL:http://www.blaess.fr/christophe/>  (1996-2003),
       Alain  Portal  <URL:http://manpagesfr.free.fr/>  (2003-2006).   Nicolas
       Francois et l'equipe francophone de traduction de Debian (2006-2009).

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

       Vous pouvez toujours avoir acces a la version anglaise de  ce  document
       en utilisant la commande << man -L C <section> <page_de_man> >>.

                               10 septembre 2010                    READDIR(3)