Loading

NOM

       getmntent,  setmntent,  addmntent,  endmntent,  hasmntopt - Obtenir des
       descriptions d’un système 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  fonctionnalités  pour  la  glibc  (voir
   feature_test_macros(7)) :

       getmntent_r() : _BSD_SOURCE || _SVID_SOURCE

       Ces  routines  servent à accéder au fichier de description des systèmes
       de fichiers /etc/fstab et aux descriptions  des  systèmes  de  fichiers
       montés /etc/mtab.

       La fonction setmntent() ouvre le fichier de description des systèmes de
       fichiers filename et renvoie un pointeur  de  fichier  utilisable  avec
       getmntent().  L’argument  type  est  le  type  d’accès demandé, et peut
       prendre les même valeurs que l’argument mode de fopen(3).

       La fonction getmntent() lit la ligne suivante du fichier de description
       des  systèmes  de fichiers fp et renvoie un pointeur vers une structure
       détaillant les champs de cette ligne. Il s’agit d’un pointeur vers  une
       zone  de  données  statiques,  qui  peut  être  écrasée  par des appels
       ultérieurs à getmntent().

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

       La fonction endmntent() ferme le fichier de description des systèmes de
       fichiers fp.

       La fonction hasmntopt() parcourt le champ mnt_opts (voyez plus bas)  de
       la  structure  mntent  mnt, à la recherche d’une chaîne correspondant à
       opt. Voyez <mntent.h> et mount(8) pour les options de montage.

       La fonction ré-entrante getmntent_r() est similaire à getmntent(), mais
       enregistre  la structure mount dans le *mntbuf fourni et enregistre les
       chaînes pointées par les entrées de cette structure dans le tampon  buf
       fourni, de taille buflen.

       La structure mntent est définie dans <mntent.h> ainsi :

           struct mntent {
               char *mnt_fsname;   /* Nom du système de fichiers monté */
               char *mnt_dir;      /* Chemin d’accès au système de fichiers */
               char *mnt_type;     /* Type de montage (voir mntent.h) */
               char *mnt_opts;     /* Options de montage (voir mntent.h) */
               int   mnt_freq;     /* Fréquence de sauvegarde (en jour) */
               int   mnt_passno;   /* Ordre de passage dans fsck */
           };

       Depuis  que les champs dans les fichiers mtab et fstab sont séparés par
       des espaces, les échappements  en  valeur  octale  sont  utilisés  pour
       représentés  les  quatre  caractères  espace (\040), tabulation (\011),
       nouvelle ligne (\012) et barre oblique inverse (\134) dans ces fichiers
       lorsqu’ils  apparaissent  dans l’une des quatre chaînes d’une structure
       mntent.  Les  routines  addmntent()  et  getmntent()  convertiront   la
       représentation  des chaînes en représentations échappées et vice-versa.

VALEUR RENVOYÉE

       Les fonctions getmntent() et getmntent_r() renvoient un pointeur sur la
       structure mntent, ou NULL en cas d’échec.

       La fonction addmntent() renvoie 0 si elle réussit, et 1 si elle échoue.

       La fonction endmntent() renvoie toujours 1.

       La fonction hasmntopt() renvoie l’adresse  de  la  sous-chaîne  si  une
       correspondance est trouvée, ou NULL sinon.

FICHIERS

       /etc/fstab      Description des systèmes de fichiers
       /etc/mtab       Description des systèmes de fichiers montés

CONFORMITÉ

       Les  fonctions  non  ré-entrantes  viennent de SunOS 4.1.3. Une routine
       getmntent_r() a été 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 différent,
       ainsi que la structure renvoyée. Sous System V, le fichier  /etc/mnttab
       est  employé. BSD 4.4 et Digital Unix ont une routine getmntinfo(), qui
       sert à invoquer l’appel système getfsstat().

VOIR AUSSI

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

COLOPHON

       Cette page fait partie de  la  publication  3.23  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

       Cette  page  de  manuel  a  été  traduite et mise à jour par Christophe
       Blaess <http://www.blaess.fr/christophe/> entre 1996 et 2003, puis  par
       Alain  Portal  <aportal AT univ-montp2 DOT fr> jusqu’en 2006, et mise à
       disposition sur http://manpagesfr.free.fr/.

       Les mises à jour et corrections de la version présente dans Debian sont
       directement gérées par Florentin Duneau <fduneau@gmail.com> et l’équipe
       francophone de traduction de Debian.

       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> ».

                               15 septembre 2009                  GETMNTENT(3)