Provided by: manpages-fr-dev_2.64.1-1_all bug

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);

   Feature Test Macro Requirements for glibc (see feature_test_macros(7)):

       gemntent_r(): _BSD_SOURCE || _SVID_SOURCE

DESCRIPTION

       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   fp  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 retourne un entier.
       Le prototype ci-dessus ne concerne que la glibc. LSB rend obsolètes les
       fonctions endhostent(), sethostent() et setmntent().

NOTES

       Système V  a aussi une fonction getmntent() mais l’appel est différent,
       ainsi que la structure renvoyée. Sous Système 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)

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

                                  2007-07-26                      GETMNTENT(3)