Man page 3 : getfsent

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

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.

Ces fonctions ne sont pas dans POSIX.1-2001. Plusieurs systèmes d'exploitation les proposent : BSD*, SunOS, Digital UNIX, AIX (qui possède é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 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.

getmntent(3), fstab(5)

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

Depuis 2010, cette traduction est maintenue à l'aide de l'outil po4a <http://po4a.alioth.debian.org/> par l'équipe de traduction francophone au sein du projet perkamon <http://perkamon.alioth.debian.org/>.

Christophe Blaess <http://www.blaess.fr/christophe/> (1996-2003), Alain Portal <http://manpagesfr.free.fr/> (2003-2006). Florentin Duneau et l'équipe francophone de traduction de Debian (2006-2009).

Veuillez signaler toute erreur de traduction en écrivant à <>.

Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande « LC_ALL=C man <section> <page_de_man> ».