[REPERTOIRE] Que fait la fonction readdir_r ?

Bonjour à tous.

J'ai réussi à faire une fonction qui enregistre le contenu d'un répertoire dans un tableau. Cette fonction utilise readdir() . J'aimerait à la place utiliser readdir_r() . Sauf qu'en lisant les pages de man sur le net, je n'arrive pas à comprendre ce qu'elle fait exactement.

Voici son prototype :

Code:

---

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

---

Pour sa valeur de retour, c'est facile, c'est zéro en cas de succès, et différent de zéro en cas d'échec.

1) Pour le premier argument (dir), je me demande si il est modifié. Est ce que c'est la structure de type DIR qui contient la position courante ? (et donc est-ce que c'est dir qui est incrémenté à chaque appel ?)

2) Pour le deuxième argument (entry), est ce que la fonction créé une structure de type "dirent" avec un malloc, remplit ses champs avec les valeurs de l'entrée courante du répertoire, et enfin fait pointer entry sur cette structure ?

3) Pour le troisième argument (result) , il pointe vers entry.


D'abord est-ce que ce que je dit est bon ? Ensuite , je ne voit pas à quoi sert result. Surement que la fonction en a besoin (mais pour quel usage ?) et qu'il ne sert à rien pour nous (on se fiche de savoir ce qu'il vaut, à part pour détecter la fin du répertoire).

Merci pour votre temps.

Dans la documentation de kernel.org, dans les notes, ils indiquent qu'il faut allouer nous-même la place de l'argument "entry" :

Citation:

---

(traduction par moi) Comme POSIX.1 ne spécifie pas la taille du champs d_name, et comme d'autres champs non-standards peuvent précéder ce champs dans la structure, les applications portables qui utilisent readdir_r() devraient allouer le buffer dont l'adresse est passée en argument comme suit :

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

---

Cependant je ne comprend pas pourquoi on a besoin de faire un malloc alors qu'il suffit de déclarer une struct dirent de manière classique et de passer son adresse en deuxième argument ...

Sur la même page, il y a la définition de struct dirent :

Code:

---

1 2 3 4 5 6 7 8

struct dirent { ino_t d_ino; /* inode number */ off_t d_off; /* offset to the next dirent */ unsigned short d_reclen; /* length of this record */ unsigned char d_type; /* type of file; not supported   by all file system types */ char d_name[256]; /* filename */ };

---

Le champs "d_name" aurait été juste un pointeur de caractère, j'aurait compris qu'on fasse un malloc, mais là il a déjà de la mémoire allouée ...

Le problème, c'est apparemment que le champ d_name n'est pas garanti avoir une taille supérieure à la taille maximale d'un nom de fichier.

Ce qui réclame d'utiliser pathconf() pour obtenir cette taille maximale, et d'allouer soi-même ce buffer (comme pour une structure à longueur variable)...

Merci ! je vient de comprendre le principe d'allocation dynamique de mémoire pour une structure, j'avait jamais pensé qu'on pouvait allouer tous les champs d'un coup, avec les trous d'alignement qu'il peut y avoir et tout ...

Quelqu'un a une idée sur l'utilité du troisième argument ?

oui ;-)

le _r de readdir_r veut dire réentrant

Pour que ce soit réentrant, il faut bien que tu aies là où tu en étais au dernier appel...

Ok ... la structure dirent contient un champs qui indique la position de la prochaine entrée du répertoire, et le troisième argument permet d'y accéder à l'appel suivant de la fonction.

En fait, ce qui était dur à comprendre c'est que le troisième argument est utile en entrée et en sortie de la fonction ...

Merci souviron du languedoc !