Provided by:
manpages-fr-dev_3.27fr1.4-1_all 
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 de l'inode */
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),
feature_test_macros(7)
COLOPHON
Cette page fait partie de la publication 3.27 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)