FSTAB(5)            UNIX Programmer's Manual             FSTAB(5)

NAME
     fstab - static information about the file systems

SYNOPSIS
     #include <fstab.h>

DESCRIPTION
     The file /_e_t_c/_f_s_t_a_b contains descriptive information about
     the various file systems.  /_e_t_c/_f_s_t_a_b is only _r_e_a_d by pro-
     grams, and not written; it is the duty of the system
     administrator to properly create and maintain this file.

     These programs use /_e_t_c/_f_s_t_a_b: _m_o_u_n_t, _u_m_o_u_n_t, _f_s_c_k and _d_f.
     The order of records in /_e_t_c/_f_s_t_a_b is important, for _f_s_c_k,
     _m_o_u_n_t, and _u_m_o_u_n_t sequentially iterate through /_e_t_c/_f_s_t_a_b
     doing their thing.

     The special file name is the block special file name, and
     not the character special file name.  If a program needs the
     character special file name, the program must create it by
     appending a ``r'' after the last ``/'' in the special file
     name.

     If _f_s__t_y_p_e is ``rw'' or ``ro'' then the file system whose
     name is given in the _f_s__f_i_l_e field is normally mounted
     read-write or read-only on the specified special file.  The
     _f_s__f_r_e_q field is used for these file systems by the _d_u_m_p(8)
     command to determine which file systems need to be dumped
     (this feature is not currently available on all PDP11s due
     to size restrictions).  The _f_s__p_a_s_s_n_o field is used by the
     _f_s_c_k(8) program (with the -p option) to determine the order
     in which file system checks are done at reboot time.  The
     root file system should be specified with a _f_s__p_a_s_s_n_o of 1,
     and other file systems should have larger numbers.  File
     systems within a drive should have distinct numbers, but
     file systems on different drives can be checked on the same
     pass to utilize parallelism available in the hardware.

     If _f_s__t_y_p_e is ``sw'' then the special file is assumed to be
     used for swapping.  The fields other than _f_s__s_p_e_c and
     _f_s__t_y_p_e are not used in this case.

     _F_s__t_y_p_e may be specified as ``xx'' to cause an entry to be
     ignored.  This is useful to show disk partitions which are
     currently not used but will be used later.

     #define FSTAB                  "/etc/fstab"
     #define FSNMLG                 16

     #define FSTABFMT    "%16s:%16s:%2s:%d:%d\n"
     #define FSTABARG(p) (p)->fs_spec, (p)->fs_file, \
                         (p)->fs_type, &(p)->fs_freq, &(p)->fs_passno

Printed 7/30/83                                                 1

FSTAB(5)            UNIX Programmer's Manual             FSTAB(5)

     #define FSTABNARGS  5

     #define FSTAB_RW    "rw"       /* read write device */
     #define FSTAB_RO    "ro"       /* read only device */
     #define FSTAB_SW    "sw"       /* swap device */
     #define FSTAB_XX    "xx"       /* ignore totally */

     struct fstab {
             char  fs_spec[FSNMLG]; /* block special device name */
             char  fs_file[FSNMLG]; /* file system path prefix */
             char  fs_type[3];      /* rw,ro,sw or xx */
             int   fs_freq;         /* dump frequency, in days */
             int   fs_passno;       /* pass number on parallel dump */
     };

     The proper way to read records from /_e_t_c/_f_s_t_a_b is to use the
     routines getfsent(), getfsspec() or getfsfile().

FILES
     /etc/fstab

SEE ALSO
     getfsent(3)

Printed 7/30/83                                                 2