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   (consulter
   feature_test_macros(7)) :

       telldir() :
        _XOPEN_SOURCE
           || /* Depuis la version 2.19 de la glibc : */ _DEFAULT_SOURCE
           || /* Versions de la glibc <= 2.19 : */ _BSD_SOURCE || _SVID_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 répertoire dirp n'est pas valable.

ATTRIBUTS

       Pour une explication des termes utilisés dans cette section, consulter attributes(7).

       ┌──────────┬──────────────────────┬─────────┐
       │Interface │ Attribut             │ Valeur  │
       ├──────────┼──────────────────────┼─────────┤
       │telldir() │ Sécurité des threads │ MT-Safe │
       └──────────┴──────────────────────┴─────────┘

CONFORMITÉ

       POSIX.1-2001, POSIX.1-2008, 4.3BSD.

NOTES

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

       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éduire la 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 5.10 du projet man-pages Linux.  Une  description
       du  projet et des instructions pour signaler des anomalies et la dernière version de cette
       page peuvent être trouvées à l'adresse https://www.kernel.org/doc/man-pages/.

TRADUCTION

       La traduction française de cette  page  de  manuel  a  été  créée  par  Christophe  Blaess
       <https://www.blaess.fr/christophe/>,  Stéphan  Rafin  <stephan.rafin@laposte.net>, Thierry
       Vignaud <tvignaud@mandriva.com>, François Micaux, Alain  Portal  <aportal@univ-montp2.fr>,
       Jean-Philippe    Guérard   <fevrier@tigreraye.org>,   Jean-Luc   Coulon   (f5ibh)   <jean-
       luc.coulon@wanadoo.fr>,   Julien    Cristau    <jcristau@debian.org>,    Thomas    Huriaux
       <thomas.huriaux@gmail.com>, Nicolas François <nicolas.francois@centraliens.net>, Florentin
       Duneau <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-bretagne.fr>,  Denis
       Barbier <barbier@debian.org> et David Prévot <david@tilapin.org>

       Cette  traduction  est  une  documentation libre ; veuillez vous reporter à la GNU General
       Public  License  version 3  ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩   concernant   les
       conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.

       Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un
       message à debian-l10n-french@lists.debian.org ⟨⟩.

                                        15 septembre 2017                              TELLDIR(3)