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-2008.

HISTORIQUE

       POSIX.1-2001, 4.3BSD.

       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
       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)

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 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.

Pages du manuel de Linux 6.9.1                     2 mai 2024                                         telldir(3)