telldir(3)                 Library Functions Manual                 telldir(3)

NOM
       telldir - Obtenir la position actuelle dans un flux repertoire

BIBLIOTHEQUE
       Bibliotheque C standard (libc, -lc)

SYNOPSIS
       #include <dirent.h>

       long telldir(DIR *dirp);

   Exigences de macros de test de fonctionnalites 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 repertoire dirp.

VALEUR RENVOYEE
       La fonction telldir() renvoie l'emplacement actuel dans le flux
       repertoire. En cas d'erreur, -1 est renvoye et errno contient le code
       d'erreur.

ERREURS
       EBADF  Le descripteur de flux repertoire dirp n'est pas valable.

ATTRIBUTS
       Pour une explication des termes utilises dans cette section, consulter
       attributes(7).

       +---------------------------------+--------------------------+---------+
       |Interface                        | Attribut                 | Valeur  |
       +---------------------------------+--------------------------+---------+
       |telldir()                        | Securite des threads     | MT-Safe |
       +---------------------------------+--------------------------+---------+
STANDARDS
       POSIX.1-2008.

HISTORIQUE
       POSIX.1-2001, 4.3BSD.

       Jusqu'a la glibc 2.1.1, le type de retour de telldir() etait off_t.
       POSIX.1-2001 specifie long, ce qui est egalement le type utilise depuis
       la glibc 2.1.2.

       Dans les premiers systemes de fichiers, la valeur renvoyee par
       telldir() etait une simple position de fichier a l'interieur d'un
       repertoire. Les systemes de fichiers modernes utilisent des structures
       d'arbres ou de hachage, plutot que des tableaux plats, pour representer
       des repertoires. Sur ce genre de systemes de fichiers, la valeur
       renvoyee par telldir() (et utilisee en interne par readdir(3)) est un
       << cookie >> utilise par l'implementation pour deduire la position a
       l'interieur d'un repertoire. 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 francaise de cette page de manuel a ete creee par
       Christophe Blaess <https://www.blaess.fr/christophe/>, Stephan Rafin
       <stephan.rafin@laposte.net>, Thierry Vignaud <tvignaud@mandriva.com>,
       Francois Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe
       Guerard <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-
       luc.coulon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas
       Huriaux <thomas.huriaux@gmail.com>, Nicolas Francois
       <nicolas.francois@centraliens.net>, Florentin Duneau
       <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-
       bretagne.fr>, Denis Barbier <barbier@debian.org> et David Prevot
       <david@tilapin.org>

       Cette traduction est une documentation libre ; veuillez vous reporter a
       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 RESPONSABILITE LEGALE.

       Si vous decouvrez un bogue dans la traduction de cette page de manuel,
       veuillez envoyer un message a <debian-l10n-french@lists.debian.org>.

Pages du manuel de Linux 6.06   31 octobre 2023                     telldir(3)