NOM

       getfsent, getfsspec, getfsfile, setfsent, endfsent - Gérer la table des systèmes de fichiers

SYNOPSIS

       #include <fstab.h>

       void endfsent(void);

       struct fstab *getfsent(void);

       struct fstab *getfsfile(const char *mount_point);

       struct fstab *getfsspec(const char *special_file);

       int setfsent(void);

DESCRIPTION

       Ces fonctions lisent depuis le fichier /etc/fstab. La structure fstab est définie ainsi :

           struct fstab {
                char *fs_spec;          /* nom du périphérique bloc */
                char *fs_file;          /* point de montage */
                char *fs_vfstype;       /* type système de fichiers */
                char *fs_mntops;        /* options de montage */
                const char *fs_type;    /* option rw/rq/ro/sw/xx */
                int fs_freq;            /* période sauvegarde en jours */
                int fs_passno;          /* numéro de passage parallèle */
           };

       Ici,  le champ fs_type contient (sur un système type BSD)  l'une des cinq chaînes « rw », « rq », « ro »,
       « sw », « xx » (read-write, read-write et quota, read-only, swap, ignore).

       La fonction setfsent() ouvre le fichier au besoin et se positionne sur la première ligne.

       La fonction getfsent() examine la ligne suivante du fichier (après ouverture si besoin).

       La fonction endfsent() ferme le fichier si nécessaire.

       La fonction getfsspec() recherche dans le fichier la première  entrée  pour  laquelle  le  champ  fs_spec
       correspond à l'argument special_file.

       La  fonction  getfsfile()  recherche  dans  le  fichier la première entrée pour laquelle le champ fs_file
       correspond à l'argument mount_point.

VALEUR RENVOYÉE

       Si elles réussissent, les fonctions getfsent(), getfsfile() et getfsspec() renvoient un pointeur sur  une
       structure  fstab,  et  setfsent() renvoie 1. En cas d'échec ou de fin de fichier, ces fonctions renvoient
       NULL et 0, respectivement.

ATTRIBUTS

       Pour une explication des termes utilisés dans cette section, consulter attributes(7).
       ┌──────────────┬──────────────────────┬─────────────────────────────┐
       │ Interface    │ Attribut             │ Valeur                      │
       ├──────────────┼──────────────────────┼─────────────────────────────┤
       │ endfsent(),  │ Sécurité des threads │ MT-Unsafe race:fsent        │
       │ setfsent()   │                      │                             │
       ├──────────────┼──────────────────────┼─────────────────────────────┤
       │ getfsent(),  │ Sécurité des threads │ MT-Unsafe race:fsent locale │
       │ getfsspec(), │                      │                             │
       │ getfsfile()  │                      │                             │
       └──────────────┴──────────────────────┴─────────────────────────────┘

CONFORMITÉ

       These functions are not in POSIX.1. Several operating  systems  have  them,  for  example,  *BSD,  SunOS,
       Digital UNIX, AIX (which also has a getfstype()). HP-UX has functions of the same names, that however use
       a  struct  checklist  instead  of  a  struct  fstab,  and  calls  these functions obsolete, superseded by
       getmntent(3).

NOTES

       Ces routines ne sont pas sûres dans un contexte multithread.

       Comme  Linux  autorise  le  montage  d'un  périphérique  bloc  en  plusieurs  endroits,  comme  plusieurs
       périphériques  peuvent  avoir  le  même  point  de  montage  (le  dernier est celui qui compte), et comme
       getfsfile() et getfsspec() ne renvoient que les premières occurrences, ces deux  fonctions  ne  sont  pas
       très utilisables sous Linux.

VOIR AUSSI

       getmntent(3), fstab(5)

COLOPHON

       Cette page fait partie de la publication 5.10 du projet man-pages Linux. Une description du projet et des
       instructions  pour  signaler  des  anomalies et la dernière version de cette page peuvent être trouvées à
       l'adresse https://www.kernel.org/doc/man-pages/.

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>   et    David    Prévot
       <david@tilapin.org>

       Cette  traduction  est  une  documentation libre ; veuillez vous reporter à la GNU General Public License
       version 3 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.

GNU                                             15 septembre 2017                                    GETFSENT(3)