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.57 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> ».