NOM

       dirfd - Obtenir un descripteur de fichier d'un répertoire

SYNOPSIS

       #include <sys/types.h>
       #include <dirent.h>

       int dirfd(DIR *dirp);

   Exigences    de    macros    de   test   de   fonctionnalités   pour   la   glibc   (consulter
   feature_test_macros(7)) :

       dirfd() :
           /* Depuis la version 2.10 de la glibc : */ _POSIX_C_SOURCE >= 200809L
               || /* Versions de la glibc <= 2.19 : */ _BSD_SOURCE || _SVID_SOURCE

DESCRIPTION

       La fonction dirfd() renvoie le descripteur de fichier associé au flux du répertoire dirp.

       This file descriptor is the one used internally by the directory stream. As a  result,  it
       is  useful  only  for functions which do not depend on or alter the file position, such as
       fstat(2)  and fchdir(2). It will be automatically closed when closedir(3)  is called.

VALEUR RENVOYÉE

       On success, dirfd()  returns a file descriptor (a nonnegative integer). On  error,  -1  is
       returned, and errno is set to indicate the error.

ERREURS

       POSIX.1.2008  définit  deux  erreurs,  aucune d'elles n'est retournée par l'implémentation
       actuelle.

       EINVAL dirp ne fait pas référence à un flux répertoire valable.

       ENOTSUP
              L'implémentation ne gère pas l'association d'un  descripteur  de  fichier  avec  un
              répertoire.

ATTRIBUTS

       Pour une explication des termes utilisés dans cette section, consulter attributes(7).

       ┌────────────────────────────────────────────────────────┬──────────────────────┬─────────┐
       │Interface                                               │ Attribut             │ Valeur  │
       ├────────────────────────────────────────────────────────┼──────────────────────┼─────────┤
       │dirfd()                                                 │ Sécurité des threads │ MT-Safe │
       └────────────────────────────────────────────────────────┴──────────────────────┴─────────┘

CONFORMITÉ

       POSIX.1.2008.  Cette  fonction  est  une  extension  BSD ;  présente dans 4.3BSD.Reno, non
       présente dans 4.2BSD.

VOIR AUSSI

       open(2),  openat(2),  closedir(3),  opendir(3),  readdir(3),   rewinddir(3),   scandir(3),
       seekdir(3), telldir(3)

COLOPHON

       Cette  page  fait partie de la publication 5.13 du projet man-pages Linux. Une description
       du projet et des instructions pour signaler des anomalies et la dernière version de  cette
       page peuvent être trouvées à l'adresse https://www.kernel.org/doc/man-pages/.

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  ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩  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⟩.