NOM¶
opendir, fdopendir - Ouvrir un répertoire
SYNOPSIS¶
#include <sys/types.h>
#include <dirent.h>
DIR *opendir(const char *nom);
DIR *fdopendir(int fd);
Exigences de macros de test de fonctionnalités pour la glibc (consultez
feature_test_macros(7)) :
fdopendir():
- Depuis la glibc 2.10 :
- _XOPEN_SOURCE >= 700 ||
_POSIX_C_SOURCE >= 200809L
- Avant la glibc 2.10 :
- _GNU_SOURCE
DESCRIPTION¶
La fonction
opendir() ouvre un flux répertoire correspondant au
répertoire
nom, et renvoie un pointeur sur ce flux. Le flux est
positionné sur la première entrée du répertoire.
La fonction
fdopendir() est similaire à
opendir(), mais
renvoie un flux de répertoire pour le répertoire demandé avec
le descripteur de fichier
fd ouvert. Après un appel réussi
à
fdopendir(),
fd est utilisé en interne par
l'implémentation, et ne doit plus être utilisé par
l'application.
VALEUR RENVOYÉE¶
Les fonctions
opendir() et
fdopendir() renvoient un pointeur sur
le flux répertoire. Si une erreur se produit, NULL est renvoyé, et
errno contient le code d'erreur.
ERREURS¶
- EACCES
- Accès interdit.
- EBADF
- fd n'est pas un descripteur de fichier valable
ouvert en lecture.
- EMFILE
- Trop de descripteurs de fichier pour le processus en
cours.
- ENFILE
- Trop de fichiers ouverts simultanément sur le
système.
- ENOENT
- Le répertoire n'existe pas, ou nom est une
chaîne vide.
- ENOMEM
- Pas assez de mémoire pour terminer
l'opération.
- ENOTDIR
- nom n'est pas un répertoire
VERSIONS¶
fdopendir() est disponible dans la glibc depuis la version 2.4.
opendir() est présente dans SVr4, BSD 4.3 et
spécifiée dans POSIX.1-2001.
fdopendir() est
spécifiée dans POSIX.1-2008.
NOTES¶
Le descripteur sous-jacent à un flux répertoire peut être obtenu
avec
dirfd(3).
La fonction
opendir() définit l'attribut
« close-on-exec » pour le descripteur de fichier
sous-jacent à
DIR *. La fonction
fdopendir() laisse
inchangée la configuration de l'attribut
« close-on-exec » pour le descripteur de fichier
fd. POSIX.1-200x laisse ouvert la le fait que l'attribut close-on-exec
du descripteur de fichier
fd soit positionné ou non par un appel
réussi à
fdopendir().
VOIR AUSSI¶
open(2),
closedir(3),
dirfd(3),
readdir(3),
rewinddir(3),
scandir(3),
seekdir(3),
telldir(3)
COLOPHON¶
Cette page fait partie de la publication 3.44 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/>.
Christophe Blaess <
http://www.blaess.fr/christophe/> (1996-2003), Alain
Portal <
http://manpagesfr.free.fr/> (2003-2006). Nicolas François
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> ».