Provided by: manpages-fr-dev_3.27fr1.4-1_all bug

NOM

       getmntent,  setmntent,  addmntent,  endmntent,  hasmntopt - Obtenir des
       descriptions d'un systeme de fichiers

SYNOPSIS

       #include <stdio.h>
       #include <mntent.h>

       FILE *setmntent(const char *filename, const char *type);

       struct mntent *getmntent(FILE *fp);

       int addmntent(FILE *fp, const struct mntent *mnt);

       int endmntent(FILE *fp);

       char *hasmntopt(const struct mntent *mnt, const char *opt);

       /* GNU extension */
       #include <mntent.h>

       struct mntent *getmntent_r(FILE *fp, struct mntent *mntbuf,
                                  char *buf, int buflen);

   Exigences de macros de test de fonctionnalites  pour  la  glibc  (consultez
   feature_test_macros(7)) :

       getmntent_r() : _BSD_SOURCE || _SVID_SOURCE

DESCRIPTION

       Ces  routines  servent a acceder au fichier de description des systemes
       de fichiers /etc/fstab et aux descriptions  des  systemes  de  fichiers
       montes /etc/mtab.

       La fonction setmntent() ouvre le fichier de description des systemes de
       fichiers filename et renvoie un pointeur  de  fichier  utilisable  avec
       getmntent().  L'argument  type  est  le  type  d'acces demande, et peut
       prendre les meme valeurs que l'argument mode de fopen(3).

       La fonction getmntent() lit la ligne suivante du fichier de description
       des  systemes  de fichiers fp et renvoie un pointeur vers une structure
       detaillant les champs de cette ligne. Il s'agit d'un pointeur vers  une
       zone  de  donnees  statiques,  qui  peut  etre  ecrasee  par des appels
       ulterieurs a getmntent().

       La fonction addmntent() ajoute la structure mntent  mnt  a  la  fin  du
       fichier ouvert fp.

       La fonction endmntent() ferme le fichier de description des systemes de
       fichiers fp.

       La fonction hasmntopt() parcourt le champ mnt_opts (consultez plus bas)
       de la structure mntent mnt, a la recherche d'une chaine correspondant a
       opt. Consultez <mntent.h> et mount(8) pour les options de montage.

       La fonction reentrante getmntent_r() est similaire a getmntent(),  mais
       enregistre  la structure mount dans le *mntbuf fourni et enregistre les
       chaines pointees par les entrees de cette structure dans le tampon  buf
       fourni, de taille buflen.

       La structure mntent est definie dans <mntent.h> 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 */
           };

       Depuis  que les champs dans les fichiers mtab et fstab sont separes par
       des espaces, les echappements  en  valeur  octale  sont  utilises  pour
       representes  les  quatre  caracteres  espace (\040), tabulation (\011),
       nouvelle ligne (\012) et barre oblique inverse (\134) 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.

VALEUR RENVOY'EE

       Les fonctions getmntent() et getmntent_r() renvoient un pointeur sur la
       structure 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 sinon.

FICHIERS

       /etc/fstab      Description des systemes de fichiers
       /etc/mtab       Description des systemes de fichiers montes

CONFORMIT'E

       Les  fonctions  non  reentrantes  viennent  de SunOS 4.1.3. Une routine
       getmntent_r() a ete introduite dans HP-UX 10,  mais  elle  retourne  un
       entier. Le prototype ci-dessus ne concerne que la glibc.

NOTES

       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  employe. BSD 4.4 et Digital Unix ont une routine getmntinfo(), qui
       sert a invoquer l'appel systeme getfsstat().

VOIR AUSSI

       fopen(3), fstab(5), mount(8)

COLOPHON

       Cette page fait partie de  la  publication  3.27  du  projet  man-pages
       Linux.  Une description du projet et des instructions pour signaler des
       anomalies      peuvent      etre       trouvees       a       l'adresse
       <URL:http://www.kernel.org/doc/man-pages/>.

TRADUCTION

       Depuis  2010,  cette  traduction est maintenue a l'aide de l'outil po4a
       <URL:http://po4a.alioth.debian.org/>   par   l'equipe   de   traduction
       francophone        au        sein        du       projet       perkamon
       <URL:http://perkamon.alioth.debian.org/>.

       Christophe Blaess  <URL:http://www.blaess.fr/christophe/>  (1996-2003),
       Alain  Portal  <URL:http://manpagesfr.free.fr/> (2003-2006).  Florentin
       Duneau et l'equipe francophone de traduction de Debian (2006-2009).

       Veuillez  signaler  toute  erreur   de   traduction   en   ecrivant   a
       <debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le
       paquet manpages-fr.

       Vous pouvez toujours avoir acces a la version anglaise de  ce  document
       en utilisant la commande << man -L C <section> <page_de_man> >>.

                               15 septembre 2009                  GETMNTENT(3)