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 (consultez feature_test_macros(7)) :

       dirfd() :
           _BSD_SOURCE || _SVID_SOURCE
           || /* Depuis la glibc 2.10 : */
               (_POSIX_C_SOURCE >= 200809L || _XOPEN_SOURCE >= 700)

DESCRIPTION

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

       Ce  descripteur  est  celui qui utilisé en interne par le flux du répertoire. Il est donc seulement utile
       pour les fonctions qui ne dépendent pas ou n'altèrent pas la  position  du  fichier,  comme  fstat(2)  et
       fchdir(2). Il est automatiquement fermé lorsque closedir(3) est appelée.

VALEUR RENVOYÉE

       Si  elle  réussit,  cette fonction renvoie un descripteur de fichier non négatif. En cas d'erreur, -1 est
       renvoyé, et errno contient le code d'erreur.

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

   Multithreading (voir pthreads(7))
       La fonction dirfd() est sûre dans un contexte multithread.

CONFORMITÉ

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

NOTES

       Le prototype de dirfd() n'est disponible que si _BSD_SOURCE ou _SVID_SOURCE est définie.

VOIR AUSSI

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

COLOPHON

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

TRADUCTION

       Depuis 2010, cette traduction est maintenue à l'aide de l'outil po4a <http://po4a.alioth.debian.org/> par
       l'équipe de traduction francophone au sein du projet perkamon <http://perkamon.alioth.debian.org/>.

       Thierry  Vignaud  (2002),  Alain Portal <http://manpagesfr.free.fr/> (2006). Florentin Duneau et l'équipe
       francophone de traduction de Debian (2006-2009).

       Veuillez signaler toute erreur de traduction en écrivant à <debian-l10n-french@lists.debian.org>  ou  par
       un rapport de bogue sur le paquet manpages-fr.

       Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande « man -L C
       <section> <page_de_man> ».

Linux                                            5 juillet 2013                                         DIRFD(3)