.\" -*- coding: UTF-8 -*- .\" Copyright (C) 1995 Andries Brouwer (aeb@cwi.nl) .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" Written 11 June 1995 by Andries Brouwer .\" Modified 22 July 1995 by Michael Chastain : .\" In 1.3.X, returns only one entry each time; return value is different. .\" Modified 2004-12-01, mtk, fixed headers listed in SYNOPSIS .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH readdir 2 "30 mars 2023" "Pages du manuel de Linux 6.05.01" .SH NOM readdir \- Lire une entrée de répertoire .SH BIBLIOTHÈQUE Bibliothèque C standard (\fIlibc\fP, \fI\-lc\fP) .SH SYNOPSIS .nf \fB#include \fP /* Définition des constantes \fBSYS_*\fP */ \fB#include \fP .PP \fBint syscall(SYS_readdir, unsigned int \fP\fIfd\fP\fB,\fP \fB struct old_linux_dirent *\fP\fIdirp\fP\fB, unsigned int \fP\fIcount\fP\fB);\fP .fi .PP \fINote\fP\ : il n'existe pas de définition de \fBstruct old_linux_dirent\fP\ ; voir NOTES. .SH DESCRIPTION Cette fonction n'est normalement pas intéressante pour les programmeurs. Utiliser \fBreaddir\fP(3) pour les fonctionnalités conformes POSIX. Cette page documente l'interface de l'appel système bas niveau, qui est remplacée par \fBgetdents\fP(2). .PP \fBreaddir\fP() lit une structure \fIold_linux_dirent\fP depuis le répertoire référencé par le descripteur de fichier \fIfd\fP et la place dans le tampon pointé par \fIdirp\fP. Le paramètre \fIcount\fP est ignoré, au plus une structure \fIold_linux_dirent\fP est lue. .PP La structure \fIold_linux_dirent\fP est déclarée comme ceci (en privé dans le fichier \fBfs/readdir.c\fP du noyau Linux\ : .PP .in +4n .EX struct old_linux_dirent { long d_ino; /* numéro d'inœud */ unsigned long d_offset; /* tête de lecture sur \fIold_linux_dirent\fP */ unsigned short d_namlen; /* longueur de \fId_name\fP */ char d_name[1]; /* nom du fichier (terminé par null) */ } .EE .in .PP \fId_ino\fP est un numéro d'inœud. \fId_off\fP est la distance entre le début du répertoire et cette structure \fIold_linux_dirent\fP. \fId_reclen\fP est la longueur de \fId_name\fP, sans compter l'octet nul final («\ \e0\ »). \fId_name\fP est le nom de fichier terminé par un caractère nul. .SH "VALEUR RENVOYÉE" En cas de succès, \fB1\fP est renvoyé. \fB0\fP est renvoyé en fin de répertoire. En cas d'erreur, \fB\-1\fP est renvoyé et \fIerrno\fP est positionné pour indiquer l'erreur. .SH ERREURS .TP \fBEBADF\fP \fIfd\fP n'est pas un descripteur de fichier valable. .TP \fBEFAULT\fP L'argument pointe en dehors de l'espace d'adressage du processus appelant. .TP \fBEINVAL\fP Le tampon de résultat est trop petit. .TP \fBENOENT\fP Répertoire inexistant. .TP \fBENOTDIR\fP Le descripteur de fichier ne pointe pas sur un répertoire. .SH VERSIONS Vous devrez définir la structure \fIold_linux_dirent\fP vous\-même. Cependant, \fBreaddir\fP(3) peut avantageusement être utilisé à la place. .PP Cet appel système n'existe pas sur x86\-64. .SH STANDARDS Linux. .SH "VOIR AUSSI" \fBgetdents\fP(2), \fBreaddir\fP(3) .PP .SH TRADUCTION La traduction française de cette page de manuel a été créée par Christophe Blaess , Stéphan Rafin , Thierry Vignaud , François Micaux, Alain Portal , Jean-Philippe Guérard , Jean-Luc Coulon (f5ibh) , Julien Cristau , Thomas Huriaux , Nicolas François , Florentin Duneau , Simon Paillard , Denis Barbier , David Prévot et Jean-Philippe MENGUAL . .PP Cette traduction est une documentation libre ; veuillez vous reporter à la .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License version 3 .UE concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE. .PP Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à .MT debian-l10n-french@lists.debian.org .ME .