Movatterモバイル変換

getfsent(3) — Linux manual page

NAME \|LIBRARY \|SYNOPSIS \|DESCRIPTION \|RETURN VALUE \|ATTRIBUTES \|VERSIONS \|STANDARDS \|HISTORY \|NOTES \|SEE ALSO \|COLOPHON

getfsent(3)              Library Functions Manualgetfsent(3)

NAME top

       getfsent, getfsspec, getfsfile, setfsent, endfsent - handle fstab       entries

LIBRARY top

       Standard C library (libc,-lc)

SYNOPSIS top

#include <fstab.h>int setfsent(void);struct fstab *getfsent(void);void endfsent(void);struct fstab *getfsfile(const char *mount_point);struct fstab *getfsspec(const char *special_file);

DESCRIPTION top

       These functions read from the file/etc/fstab.  Thestruct 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 fieldfs_type contains (on a *BSD system) one of the five       strings "rw", "rq", "ro", "sw", "xx" (read-write, read-write with       quota, read-only, swap, ignore).       The functionsetfsent() opens the file when required and positions       it at the first line.       The functiongetfsent() parses the next line from the file.       (After opening it when required.)       The functionendfsent() closes the file when required.       The functiongetfsspec() searches the file from the start and       returns the first entry found for which thefs_spec field matches       thespecial_file argument.       The functiongetfsfile() searches the file from the start and       returns the first entry found for which thefs_file field matches       themount_point argument.

RETURN VALUE top

       Upon success, the functionsgetfsent(),getfsfile(), andgetfsspec() return a pointer to astruct fstab, whilesetfsent()       returns 1.  Upon failure or end-of-file, these functions return       NULL and 0, respectively.

ATTRIBUTES top

       For an explanation of the terms used in this section, seeattributes(7).       ┌──────────────┬───────────────┬─────────────────────────────────┐       │Interface│Attribute│Value│       ├──────────────┼───────────────┼─────────────────────────────────┤       │endfsent(),  │ Thread safety │ MT-Unsafe race:fsent            │       │setfsent()   │               │                                 │       ├──────────────┼───────────────┼─────────────────────────────────┤       │getfsent(),  │ Thread safety │ MT-Unsafe race:fsent locale     │       │getfsspec(), │               │                                 │       │getfsfile()  │               │                                 │       └──────────────┴───────────────┴─────────────────────────────────┘

VERSIONS top

       Several operating systems have these functions, for example, *BSD,       SunOS, Digital UNIX, AIX (which also has agetfstype()).  HP-UX       has functions of the same names, that however use astructchecklist instead of astruct fstab, and calls these functions       obsolete, superseded bygetmntent(3).

STANDARDS top

       None.

HISTORY top

       Thegetfsent() function appeared in 4.0BSD; the other four       functions appeared in 4.3BSD.

NOTES top

       These functions are not thread-safe.       Since Linux allows mounting a block special device in several       places, and since several devices can have the same mount point,       where the last device with a given mount point is the interesting       one, whilegetfsfile() andgetfsspec() only return the first       occurrence, these two functions are not suitable for use under       Linux.

COLOPHON top

       This page is part of theman-pages (Linux kernel and C library       user-space interface documentation) project.  Information about       the project can be found at        ⟨https://www.kernel.org/doc/man-pages/⟩.  If you have a bug report       for this manual page, see       ⟨https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git/tree/CONTRIBUTING⟩.       This page was obtained from the tarball man-pages-6.15.tar.gz       fetched from       ⟨https://mirrors.edge.kernel.org/pub/linux/docs/man-pages/⟩ on       2025-08-11.  If you discover any rendering problems in this HTML       version of the page, or you believe there is a better or more up-       to-date source for the page, or you have corrections or       improvements to the information in this COLOPHON (which isnot       part of the original manual page), send a mail to       man-pages@man7.orgLinux man-pages 6.15            2025-05-17getfsent(3)

HTML rendering created 2025-09-06 byMichael Kerrisk, author ofThe Linux Programming Interface.

For details of in-depthLinux/UNIX system programming training courses that I teach, lookhere.

Hosting byjambit GmbH.