DIRFD(3)

NOM
dirfd - Obtenir un descripteur de fichier pour un répertoire

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

int dirfd(DIR *rep);

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

dirfd() : _BSD_SOURCE || _SVID_SOURCE

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

ce descripteur est celui qui est utilisé en interne par le flux de 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) ou 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é.

ERREURS
La prochaine révision POSIX.1 indique deux erreurs, aucune d'elles n'est retournée par l'actuelle implémentation.

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

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

CONFORMITÉ
Ceci est une extension BSD, présente dans BSD 4.3-Reno, mais pas dans BSD 4.2. Elle est également présente dans la libc5 (depuis la version 5.1.2) et dans la glibc 2. Cette fonction est proposée pour une inclusion dans une future révision de POSIX.1.

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)

TRADUCTION

Ce document est une traduction réalisée par Thierry Vignaud <tvignaud AT mandriva DOT com> en 2002 et révisée le 17 juillet 2008.

L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 3 dirfd ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.