Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] readdir - Lire une entrée de répertoire. [size=18] [b]Résumé[/b] [/size] .nf [b]#include <unistd.h>[/b] [b]#include <linux/dirent.h>[/b] [b]#include <linux/unistd.h>[/b] [b]_syscall3(int, readdir, uint, fd, struct dirent , dirp, uint, count);[/b] [b][i]int readdir(unsigned int fd , struct dirent dirp , unsigned int count );[/i][/b] .fi [size=18] [b]Description[/b] [/size] Cette fonction n'est normalement pas intéressante pour les programmeurs. Utiliser [b]readdir (3)[/b] pour les fonctionnalités conformes POSIX. Cette page documente l'interface de l'appel système bas-niveau, qui peut changer, et qui est remplacée par [b]getdents (2).[/b] [b]readdir[/b] lit une structure [i]dirent[/i] depuis le répertoire pointé par [i]fd[/i] et la place en mémoire dans la zone pointée par [b]dirp.[/b] Le paramètre [i]count[/i] est ignoré, au plus une structure dirent est lue. La structure [i]dirent[/i] est déclarée comme suit : [table][row][col]    [/col][col] .nf struct dirent { long d_ino; /* inode number / off_t d_off; / offset to this [i]dirent[/i] / unsigned short d_reclen; / length of this [i]d_name[/i] / char d_name [NAME_MAX+1]; / file name (null-terminated) */ } .fi[/col][/row][/table] [i]d_ino[/i] est un numéro d'i-node. [i]d_off[/i] est la distance entre le début du répertoire et cette structure [b]dirent.[/b] [i]d_reclen[/i] est la longueur [b]d_name,[/b] sans compter le caractère nul final. [i]d_name[/i] est le nom de fichier terminé par un caractère nul. [size=18] [b]Valeur renvoyée[/b] [/size] [b]readdir[/b] renvoie 1 s'il réussit, 0 en fin de répertoire, ou -1 s'il échoue, auquel cas [i]errno[/i] contient le code d'erreur. [size=18] [b]Erreurs[/b] [/size] [b]EBADF[/b] [b]fd[/b] [table][row][col]    [/col][col]est invalide.[/col][/row][/table] [b]EFAULT[/b] [table][row][col]    [/col][col]L'argument pointe en dehors de l'espace d'adressage.[/col][/row][/table] [b]EINVAL[/b] [table][row][col]    [/col][col]Le buffer de résultat est trop petit.[/col][/row][/table] [b]ENONENT[/b] [table][row][col]    [/col][col]Répertoire inexistant.[/col][/row][/table] [b]ENOTDIR[/b] [table][row][col]    [/col][col]Le descripteur est associé à un fichier, pas à un répertoire.[/col][/row][/table] [size=18] [b]Conformité[/b] [/size] Cet appel-système est spécifique à Linux. [size=18] [b]Voir aussi[/b] [/size] [b]getdents (2),[/b] [b]readdir (3)[/b] [size=18] [b]Traduction[/b] [/size] Christophe Blaess, 1996-2003.
Fichier