NOM

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

BIBLIOTHÈQUE

       Bibliothèque C standard (libc, -lc)

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
              || /* glibc >= 2.19 : */ _DEFAULT_SOURCE
              || /* 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 │
       └──────────────────────────────────────────────────────────────────────┴──────────────────────┴─────────┘

STANDARDS

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

NOTES

       Jusqu'à la glibc 2.1.1, le type de retour de telldir() était off_t. POSIX.1-2001 spécifie  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 fi‐
       chier  à 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)

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 <tvi‐
       gnaud@mandriva.com>, François Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe  Guérard  <fe‐
       vrier@tigreraye.org>,  Jean-Luc Coulon (f5ibh) <jean-luc.coulon@wanadoo.fr>, Julien Cristau <jcristau@de‐
       bian.org>,  Thomas  Huriaux  <thomas.huriaux@gmail.com>,   Nicolas   François   <nicolas.francois@centra‐
       liens.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 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 à  de‐
       bian-l10n-french@lists.debian.org.

Pages du manuel de Linux 6.03                    5 février 2023                                       telldir(3)