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

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

Ces fonctions lisent dans 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 corresponde à l’argument special_file.

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

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

La fonction getfsent() est apparue dans BSD 4.0, les quatre autres fonctions dans 4.3BSD.

Ces fonctions ne sont pas dans POSIX.1-2001. Plusieurs systèmes d’exploitation les proposent : BSD*, SunOS, Digital Unix, AIX (qui a également une fonction getfstype()). HP-UX a des fonctions avec les mêmes noms, mais utilise une structure checklist plutôt que la structure fstab, et ces fonctions sont obsolètes, remplacées par getmntent(3).

Ces routines ne sont pas sûres dans un contexte multi-threads.

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.

getmntent(3), fstab(5)

Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 21 juillet 2003 et révisée le 14 août 2006.

L’équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 3 getfsent ». N’hésitez pas à signaler à l’auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.