NOM

       getmntent,   setmntent,   addmntent,  endmntent,  hasmntopt,  getmntent_r  -  Obtenir  des
       descriptions d'un système de fichiers

BIBLIOTHÈQUE

       Bibliothèque C standard (libc, -lc)

SYNOPSIS

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

       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 <mntent.h>

       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   fonctionnalités   pour    la    glibc    (consulter
   feature_test_macros(7)) :

       getmntent_r() :
           Depuis la glibc 2.19 :
               _DEFAULT_SOURCE
           glibc 2.19 et antérieures :
               _BSD_SOURCE || _SVID_SOURCE

DESCRIPTION

       Ces  routines  permettent  d'accéder  au  fichier  de description des systèmes de fichiers
       /etc/fstab et au fichier de description des systèmes de fichiers montés /etc/mtab.

       La  fonction  setmntent()  ouvre  le  fichier  de  description  de  systèmes  de  fichiers
       nom_fichier  et renvoie un pointeur de fichier utilisable par 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). Pour fermer le flux renvoyé, il est préférable d'utiliser endmntent() plutôt que
       fclose(3).

       La fonction getmntent() lit la ligne suivante du fichier de  description  de  systèmes  de
       fichiers  sur  flux  et  renvoie  un pointeur vers une structure contenant une ligne de ce
       fichier décomposée en champs. Il s'agit d'un pointeur vers une zone de données  statiques,
       dont le contenu est écrasée par des appels ultérieurs à getmntent().

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

       La  fonction  endmntent()  ferme  le flux associé au fichier de description de systèmes de
       fichiers.

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

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

       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 */
           };

       Comme les champs dans les fichiers mtab  et  fstab  sont  séparés  par  des  espaces,  des
       échappements  en  valeurs  octales  sont  utilisés  pour représenter les caractères espace
       (\040), tabulation (\011), nouvelle ligne (\012) et barre oblique inverse  (\\)  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.  Lors de la conversion vers une représentation
       échappée, la séquence \134 est aussi convertie en barre oblique inverse.

VALEUR RENVOYÉE

       Les fonctions getmntent() et getmntent_r() renvoient un pointeur sur la structure de  type
       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 dans le cas contraire.

FICHIERS

       /etc/fstab
              fichier de description des systèmes de fichiers

       /etc/mtab
              fichier de description des systèmes de fichiers montés

ATTRIBUTS

       Pour une explication des termes utilisés dans cette section, consulter attributes(7).

       ┌─────────────────────────┬──────────────────────┬────────────────────────────────────────┐
       │Interface                │ Attribut             │ Valeur                                 │
       ├─────────────────────────┼──────────────────────┼────────────────────────────────────────┤
       │setmntent(),             │ Sécurité des threads │ MT-Safe                                │
       │endmntent(), hasmntopt() │                      │                                        │
       ├─────────────────────────┼──────────────────────┼────────────────────────────────────────┤
       │getmntent()              │ Sécurité des threads │ MT-Unsafe race:mntentbuf locale        │
       ├─────────────────────────┼──────────────────────┼────────────────────────────────────────┤
       │addmntent()              │ Sécurité des threads │ MT-Safe race:stream locale             │
       ├─────────────────────────┼──────────────────────┼────────────────────────────────────────┤
       │getmntent_r()            │ Sécurité des threads │ MT-Safe locale                         │
       └─────────────────────────┴──────────────────────┴────────────────────────────────────────┘

STANDARDS

       Les  fonctions  non  réentrantes  viennent de SunOS 4.1.3. Une routine getmntent_r() a été
       introduite dans HP-UX 10, mais elle renvoie un entier. Le prototype ci-dessus n'est fourni
       que par 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 utilisé. 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

       La  traduction  française  de  cette  page  de  manuel  a  été créée par Christophe Blaess
       <https://www.blaess.fr/christophe/>, Stéphan  Rafin  <stephan.rafin@laposte.net>,  Thierry
       Vignaud  <tvignaud@mandriva.com>,  François Micaux, Alain Portal <aportal@univ-montp2.fr>,
       Jean-Philippe   Guérard   <fevrier@tigreraye.org>,   Jean-Luc   Coulon   (f5ibh)    <jean-
       luc.coulon@wanadoo.fr>,    Julien    Cristau    <jcristau@debian.org>,    Thomas   Huriaux
       <thomas.huriaux@gmail.com>, Nicolas François <nicolas.francois@centraliens.net>, Florentin
       Duneau  <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-bretagne.fr>, Denis
       Barbier  <barbier@debian.org>,  David  Prévot   <david@tilapin.org>   et   Lucien   Gentis
       <lucien.gentis@waika9.com>

       Cette  traduction  est  une  documentation libre ; veuillez vous reporter à la GNU General
       Public  License  version 3  ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩   concernant   les
       conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.

       Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un
       message à ⟨debian-l10n-french@lists.debian.org⟩.