.\" -*- 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 "2 mai 2024" "Pages du manuel de Linux 6.8" .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 \fP .P \fBlong telldir(DIR *\fP\fIdirp\fP\fB);\fP .fi .P .RS -4 Exigences de macros de test de fonctionnalités pour la glibc (consulter \fBfeature_test_macros\fP(7)) : .RE .P \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 .SH STANDARDS POSIX.1\-2008. .SH HISTORIQUE POSIX.1\-2001, 4.3BSD. .P 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. .P .\" 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 , Stéphan Rafin , Thierry Vignaud , François Micaux, Alain Portal , Jean-Philippe Guérard , Jean-Luc Coulon (f5ibh) , Julien Cristau , Thomas Huriaux , Nicolas François , Florentin Duneau , Simon Paillard , Denis Barbier et David Prévot . .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 .