getmntent(3) Library Functions Manual getmntent(3) NOM getmntent, setmntent, addmntent, endmntent, hasmntopt, getmntent_r - Obtenir des descriptions d'un systeme de fichiers BIBLIOTHEQUE Bibliotheque C standard (libc, -lc) SYNOPSIS #include #include FILE *setmntent(const char *nom_fichier, const char *type); struct mntent *getmntent(FILE *flux); int addmntent(FILE *restrict flux, const struct mntent *restrict mnt); int endmntent(FILE *streamp); char *hasmntopt(const struct mntent *mnt, const char *opt); /* GNU extension */ #include struct mntent *getmntent_r(FILE *restrict streamp, struct mntent *restrict tampon_mnt, char tampon[restrict .taille_tampon], int taille_tampon); Exigences de macros de test de fonctionnalites pour la glibc (consulter feature_test_macros(7)) : getmntent_r() : Depuis la glibc 2.19 : _DEFAULT_SOURCE glibc 2.19 et anterieures : _BSD_SOURCE || _SVID_SOURCE DESCRIPTION Ces routines permettent d'acceder au fichier de description des systemes de fichiers /etc/fstab et au fichier de description des systemes de fichiers montes /etc/mtab. La fonction setmntent() ouvre le fichier de description de systemes de fichiers nom_fichier et renvoie un pointeur de fichier utilisable par getmntent(). L'argument type est le type d'acces demande, et peut prendre les meme valeurs que l'argument mode de fopen(3). Pour fermer le flux renvoye, il est preferable d'utiliser endmntent() plutot que fclose(3). La fonction getmntent() lit la ligne suivante du fichier de description de systemes de fichiers sur flux et renvoie un pointeur vers une structure contenant une ligne de ce fichier decomposee en champs. Il s'agit d'un pointeur vers une zone de donnees statiques, dont le contenu est ecrasee par des appels ulterieurs a getmntent(). La fonction addmntent() ajoute la structure mntent mnt a la fin du flux ouvert. La fonction endmntent() ferme le flux associe au fichier de description de systemes de fichiers. La fonction hasmntopt() parcourt le champ mnt_opts (voir plus bas) de la structure mntent mnt a la recherche d'une chaine correspondant a opt. Voir et mount(8) pour les options de montage valables. La fonction reentrante getmntent_r() est similaire a getmntent(), mais enregistre la structure mntent dans le *tampon_mnt fourni et enregistre les chaines pointees par les entrees de cette structure dans le tampon fourni de taille taille_tampon. La structure mntent est definie dans ainsi : struct mntent { char *mnt_fsname; /* Nom du systeme de fichiers monte */ char *mnt_dir; /* Chemin d'acces au systeme de fichiers */ char *mnt_type; /* Type de montage (voir mntent.h) */ char *mnt_opts; /* Options de montage (voir mntent.h) */ int mnt_freq; /* Frequence de sauvegarde (en jour) */ int mnt_passno; /* Ordre de passage dans fsck */ }; Comme les champs dans les fichiers mtab et fstab sont separes par des espaces, des echappements en valeurs octales sont utilises pour representer les caracteres espace (\040), tabulation (\011), nouvelle ligne (\012) et barre oblique inverse (\\) dans ces fichiers lorsqu'ils apparaissent dans l'une des quatre chaines d'une structure mntent. Les routines addmntent() et getmntent() convertiront la representation des chaines en representations echappees et vice-versa. Lors de la conversion vers une representation echappee, la sequence \134 est aussi convertie en barre oblique inverse. VALEUR RENVOYEE Les fonctions getmntent() et getmntent_r() renvoient un pointeur sur la structure de type mntent, ou NULL en cas d'echec. La fonction addmntent() renvoie 0 si elle reussit et 1 si elle echoue. La fonction endmntent() renvoie toujours 1. La fonction hasmntopt() renvoie l'adresse de la sous-chaine si une correspondance est trouvee, ou NULL dans le cas contraire. FICHIERS /etc/fstab fichier de description des systemes de fichiers /etc/mtab fichier de description des systemes de fichiers montes ATTRIBUTS Pour une explication des termes utilises dans cette section, consulter attributes(7). +--------------+--------------------------+----------------------------+ |Interface | Attribut | Valeur | +--------------+--------------------------+----------------------------+ |setmntent(), | Securite des threads | MT-Safe | |endmntent(), | | | |hasmntopt() | | | +--------------+--------------------------+----------------------------+ |getmntent() | Securite des threads | MT-Unsafe race:mntentbuf | | | | locale | +--------------+--------------------------+----------------------------+ |addmntent() | Securite des threads | MT-Safe race:stream locale | +--------------+--------------------------+----------------------------+ |getmntent_r() | Securite des threads | MT-Safe locale | +--------------+--------------------------+----------------------------+ STANDARDS Aucune. HISTORIQUE Les fonctions non reentrantes viennent de SunOS 4.1.3. Une routine getmntent_r() a ete introduite dans HP-UX 10, mais elle renvoie un entier. Le prototype ci-dessus n'est fourni que par la glibc. System V a aussi une fonction getmntent(), mais l'appel est different, ainsi que la structure renvoyee. Sous System V, le fichier /etc/mnttab est utilise. 4.4BSD et Digital UNIX ont une routine getmntinfo() qui sert a invoquer l'appel systeme getfsstat(). VOIR AUSSI fopen(3), fstab(5), mount(8) TRADUCTION La traduction francaise de cette page de manuel a ete creee par Christophe Blaess , Stephan Rafin , Thierry Vignaud , Francois Micaux, Alain Portal , Jean-Philippe Guerard , Jean-Luc Coulon (f5ibh) , Julien Cristau , Thomas Huriaux , Nicolas Francois , Florentin Duneau , Simon Paillard , Denis Barbier , David Prevot et Lucien Gentis Cette traduction est une documentation libre ; veuillez vous reporter a la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITE LEGALE. Si vous decouvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message a . Pages du manuel de Linux 6.8 2 mai 2024 getmntent(3)