DIRFD

Section : Manuel du programmeur Linux (3)
Mise à jour de la version anglaise : 2 juillet 2008
Index Menu principal

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.

Dernière mise à jour : 17 juillet 2008