man getfsent (Fonctions bibliothèques) - Lire la table des systèmes de fichiers.
NOM
getfsent, getfsspec, getfsfile, setfsent, endfsent - Lire 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 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 quotas, 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.
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 échec ou en fin de fichier, ces fonctions renvoient NULL et 0, respectivement.
HISTORIQUE
La fonction getfsent() est apparue dans 4.0BSD, les quatre autres fonctions dans 4.3BSD.
CONFORMITÉ
Ces fonctions ne sont pas dans POSIX. 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 struct checklist plutôt que la struct fstab, et ces fonctions sont obsolètes, remplacées par getmntent(3).
NOTES
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.
VOIR AUSSI
TRADUCTION
Christophe Blaess, 2003.