| Linux / Unix Command: getfsspec |
NAME
getfsent, getfsspec, getfsfile, setfsent, endfsent - handle fstab entriesSYNOPSIS
#include <fstab.h>void endfsent(void);
struct fstab *getfsent(void);
struct fstab *getfsfile(const char *mount_point);
struct fstab *getfsspec(const char *special_file);
DESCRIPTION
These functions read from the file /etc/fstab. The struct fstab is defined by
struct fstab {
char *fs_spec; /* block device name */
char *fs_file; /* mount point */
char *fs_vfstype; /* filesystem type */
char *fs_mntops; /* mount options */
const char *fs_type; /* rw/rq/ro/sw/xx option */
int fs_freq; /* dump frequency, in days */
int fs_passno; /* pass number on parallel dump */
};
Here the field
fs_type
contains (on a *BSD system)
one of the five strings "rw", "rq", "ro", "sw", "xx"
(read-write, read-write with quotas, read-only, swap, ignore).
The function setfsent() opens the file when required and positions it at the first line.
The function getfsent() parses the next line from the file. (After opening it when required.)
The function endfsent() closes the file when required.
The function getfsspec() searches the file from the start and returns the first entry found for which the fs_spec field matches the special_file argument.
The function getfsfile() searches the file from the start and returns the first entry found for which the fs_file field matches the mount_point argument.
RETURN VALUE
Upon success, the functions getfsent(), getfsfile(), and getfsspec() return a pointer to a struct fstab, while setfsent() returns 1. Upon failure or end-of-file, these functions return NULL and 0, respectively.SEE ALSO
getmntent(3), fstab(5)
Important: Use the man command (% man) to see how a command is used on your particular computer.
