readdir(2)                    System Calls Manual                   readdir(2)

NOM
       readdir - Lire une entree de repertoire

BIBLIOTHEQUE
       Bibliotheque C standard (libc, -lc)

SYNOPSIS
       #include <sys/syscall.h>      /* Definition des constantes SYS_* */
       #include <unistd.h>

       int syscall(SYS_readdir, unsigned int fd,
                   struct old_linux_dirent *dirp, unsigned int count);

       Note : il n'existe pas de definition de struct old_linux_dirent ; voir
       NOTES.

DESCRIPTION
       Cette fonction n'est normalement pas interessante pour les
       programmeurs. Utiliser readdir(3) pour les fonctionnalites conformes
       POSIX. Cette page documente l'interface de l'appel systeme bas niveau,
       qui est remplacee par getdents(2).

       readdir() lit une structure old_linux_dirent depuis le repertoire
       reference par le descripteur de fichier fd et la place dans le tampon
       pointe par dirp. Le parametre count est ignore, au plus une structure
       old_linux_dirent est lue.

       La structure old_linux_dirent est declaree comme ceci (en prive dans le
       fichier fs/readdir.c du noyau Linux :

           struct old_linux_dirent {
               long  d_ino;              /* numero d'inoeud */
               unsigned long d_offset;  /* tete de lecture sur old_linux_dirent */
               unsigned short d_namlen;  /* longueur de d_name */
               char  d_name[1];          /* nom du fichier (termine par null) */
           }

       d_ino est un numero d'inoeud. d_off est la distance entre le debut du
       repertoire et cette structure old_linux_dirent. d_reclen est la
       longueur de d_name, sans compter l'octet nul final (<< \0 >>). d_name
       est le nom de fichier termine par un caractere nul.

VALEUR RENVOYEE
       En cas de succes, 1 est renvoye. 0 est renvoye en fin de repertoire. En
       cas d'erreur, -1 est renvoye et errno est positionne pour indiquer
       l'erreur.

ERREURS
       EBADF  fd n'est pas un descripteur de fichier valable.

       EFAULT L'argument pointe en dehors de l'espace d'adressage du processus
              appelant.

       EINVAL Le tampon de resultat est trop petit.

       ENOENT Repertoire inexistant.

       ENOTDIR
              Le descripteur de fichier ne pointe pas sur un repertoire.

VERSIONS
       Vous devrez definir la structure old_linux_dirent vous-meme. Cependant,
       readdir(3) peut avantageusement etre utilise a la place.

       Cet appel systeme n'existe pas sur x86-64.

STANDARDS
       Linux.

VOIR AUSSI
       getdents(2), readdir(3)

TRADUCTION
       La traduction francaise de cette page de manuel a ete creee par
       Christophe Blaess <https://www.blaess.fr/christophe/>, Stephan Rafin
       <stephan.rafin@laposte.net>, Thierry Vignaud <tvignaud@mandriva.com>,
       Francois Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe
       Guerard <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-
       luc.coulon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas
       Huriaux <thomas.huriaux@gmail.com>, Nicolas Francois
       <nicolas.francois@centraliens.net>, Florentin Duneau
       <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-
       bretagne.fr>, Denis Barbier <barbier@debian.org>, David Prevot
       <david@tilapin.org> et Jean-Philippe MENGUAL <jpmengual@debian.org>

       Cette traduction est une documentation libre ; veuillez vous reporter a
       la GNU General Public License version 3
       <https://www.gnu.org/licenses/gpl-3.0.html> concernant les conditions
       de copie et de distribution. Il n'y a aucune RESPONSABILITE LEGALE.

       Si vous decouvrez un bogue dans la traduction de cette page de manuel,
       veuillez envoyer un message a <debian-l10n-french@lists.debian.org>.

Pages du manuel de Linux 6.06   31 octobre 2023                     readdir(2)