NOM

       telldir - Obtenir la position actuelle dans un flux répertoire

SYNOPSIS

       #include <dirent.h>

       long telldir(DIR *dirp);

   Exigences de macros de test de fonctionnalités pour la glibc (consultez feature_test_macros(7)) :

       telldir() : _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE

DESCRIPTION

       La fonction telldir() renvoie la position actuelle du pointeur d'un flux répertoire dirp.

VALEUR RENVOYÉE

       La  fonction  telldir()  renvoie  l'emplacement  actuel  dans le flux répertoire. En cas d'erreur, -1 est
       renvoyé, et errno contient le code d'erreur.

ERREURS

       EBADF  Le descripteur de flux du répertoire, dirp, n'est pas valable.

ATTRIBUTS

   Multithreading (voir pthreads(7))
       La fonction telldir() est sûre dans un contexte multithread.

CONFORMITÉ

       BSD 4.3, POSIX.1-2001.

NOTES

       Dans la glibc avant la version 2.1.1, le type de retour de telldir() était off_t.  POSIX.1-2001  spécifie
       un long, ce qui est également le type utilisé depuis la glibc 2.1.2.

       Dans  les  premiers  systèmes  de fichiers, la valeur renvoyée par telldir() était une simple position de
       fichier à l'intérieur d'un répertoire.  Les  systèmes  de  fichiers  modernes  utilisent  des  structures
       d'arbres  ou de hachage, plutôt que des tableaux plats, pour représenter des répertoires. Sur ce genre de
       systèmes de fichiers, la valeur renvoyée par telldir() (et utilisée en interne  par  readdir(3))  est  un
       « cookie »  utilisé  par  l'implémentation  pour  dériver une position à l'intérieur d'un répertoire. Les
       programmes des applications devraient traiter cela strictement comme une valeur opaque, sans faire aucune
       supposition sur son contenu.

VOIR AUSSI

       closedir(3), opendir(3), readdir(3), rewinddir(3), scandir(3), seekdir(3)

COLOPHON

       Cette page fait partie de la publication 3.65 du projet man-pages Linux. Une description du projet et des
       instructions    pour    signaler    des    anomalies    peuvent     être     trouvées     à     l'adresse
       http://www.kernel.org/doc/man-pages/.

TRADUCTION

       Depuis 2010, cette traduction est maintenue à l'aide de l'outil po4a <http://po4a.alioth.debian.org/> par
       l'équipe de traduction francophone au sein du projet perkamon <http://perkamon.alioth.debian.org/>.

       Christophe       Blaess       <http://www.blaess.fr/christophe/>      (1996-2003),      Alain      Portal
       <http://manpagesfr.free.fr/> (2003-2006). Nicolas François  et  l'équipe  francophone  de  traduction  de
       Debian (2006-2009).

       Veuillez  signaler  toute erreur de traduction en écrivant à <debian-l10n-french@lists.debian.org> ou par
       un rapport de bogue sur le paquet manpages-fr.

       Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande « man -L C
       <section> <page_de_man> ».

                                                2 septembre 2013                                      TELLDIR(3)