.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk)
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\" References consulted:
.\"     Linux libc source code
.\"     Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991)
.\"     386BSD man pages
.\" Modified Sat Jul 24 17:48:42 1993 by Rik Faith (faith@cs.unc.edu)
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH telldir 3 "20 juillet 2023" "Pages du manuel de Linux 6.05.01" 
.SH NOM
telldir \- Obtenir la position actuelle dans un flux répertoire
.SH BIBLIOTHÈQUE
Bibliothèque C standard (\fIlibc\fP, \fI\-lc\fP)
.SH SYNOPSIS
.nf
\fB#include <dirent.h>\fP
.PP
\fBlong telldir(DIR *\fP\fIdirp\fP\fB);\fP
.fi
.PP
.RS -4
Exigences de macros de test de fonctionnalités pour la glibc (consulter
\fBfeature_test_macros\fP(7))\ :
.RE
.PP
\fBtelldir\fP()\ :
.nf
   _XOPEN_SOURCE
       || /* glibc >= 2.19 : */ _DEFAULT_SOURCE
       || /* glibc <= 2.19 : */ _BSD_SOURCE || _SVID_SOURCE
.fi
.SH DESCRIPTION
La fonction \fBtelldir\fP() renvoie la position actuelle du pointeur d'un flux
répertoire \fIdirp\fP.
.SH "VALEUR RENVOYÉE"
La fonction \fBtelldir\fP() renvoie l'emplacement actuel dans le flux
répertoire. En cas d'erreur, \fB\-1\fP est renvoyé et \fIerrno\fP contient le code
d'erreur.
.SH ERREURS
.TP 
\fBEBADF\fP
Le descripteur de flux répertoire \fIdirp\fP n'est pas valable.
.SH ATTRIBUTS
Pour une explication des termes utilisés dans cette section, consulter
\fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
Interface	Attribut	Valeur
T{
.na
.nh
\fBtelldir\fP()
T}	Sécurité des threads	MT\-Safe
.TE
.sp 1
.SH STANDARDS
POSIX.1\-2008.
.SH HISTORIQUE
POSIX.1\-2001, 4.3BSD.
.PP
Jusqu'à la glibc\ 2.1.1, le type de retour de \fBtelldir\fP() était
\fIoff_t\fP. POSIX.1\-2001 spécifie \fIlong\fP, ce qui est également le type
utilisé depuis la glibc\ 2.1.2.
.PP
.\" https://lwn.net/Articles/544298/
Dans les premiers systèmes de fichiers, la valeur renvoyée par \fBtelldir\fP()
é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
\fBtelldir\fP() (et utilisée en interne par \fBreaddir\fP(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 \fBaucune\fP supposition sur
son contenu.
.SH "VOIR AUSSI"
\fBclosedir\fP(3), \fBopendir\fP(3), \fBreaddir\fP(3), \fBrewinddir\fP(3),
\fBscandir\fP(3), \fBseekdir\fP(3)
.PP
.SH 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>
.
.PP
Cette traduction est une documentation libre ; veuillez vous reporter à la
.UR https://www.gnu.org/licenses/gpl-3.0.html
GNU General Public License version 3
.UE
concernant les conditions de copie et 
de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.
.PP
Si vous découvrez un bogue dans la traduction de cette page de manuel, 
veuillez envoyer un message à
.MT debian-l10n-french@lists.debian.org
.ME .