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)