Return to fstab.5 CVS log

Up to [CSRG BSD Unix] / 43BSDTahoe / man / man5

Annotation of 43BSDTahoe/man/man5/fstab.5, revision 1.1.1.1

1.1       root        1: .\" Copyright (c) 1980 Regents of the University of California.
                      2: .\" All rights reserved.  The Berkeley software License Agreement
                      3: .\" specifies the terms and conditions for redistribution.
                      4: .\"
                      5: .\"    @(#)fstab.5     6.1 (Berkeley) 5/15/85
                      6: .\"
                      7: .TH FSTAB 5  "May 15, 1985"
                      8: .UC 4
                      9: .SH NAME
                     10: fstab \- static information about the filesystems
                     11: .SH SYNOPSIS
                     12: .B #include <fstab.h>
                     13: .SH DESCRIPTION
                     14: The file
                     15: .I /etc/fstab
                     16: contains descriptive information about the various file
                     17: systems.
                     18: .I /etc/fstab
                     19: is only
                     20: .I read
                     21: by programs, and not written;
                     22: it is the duty of the system administrator to properly create 
                     23: and maintain this file.
                     24: The order of records in
                     25: .I /etc/fstab
                     26: is important because
                     27: .I fsck,
                     28: .I mount,
                     29: and
                     30: .I umount
                     31: sequentially iterate through
                     32: .I /etc/fstab
                     33: doing their thing.
                     34: .PP
                     35: The special file name is the 
                     36: .B block
                     37: special file name, 
                     38: and not the character special file name.
                     39: If a program needs the character special file name,
                     40: the program must create it by appending a ``r'' after the
                     41: last ``/'' in the special file name.
                     42: .PP
                     43: If
                     44: .I fs_type
                     45: is ``rw'' or ``ro'' then the file system whose name is given in the
                     46: .I fs_file
                     47: field is normally mounted read-write or read-only on the
                     48: specified special file.  If
                     49: .I fs_type
                     50: is ``rq'', then the file system is normally mounted read-write
                     51: with disk quotas enabled.
                     52: The
                     53: .I fs_freq
                     54: field is used for these file systems by the
                     55: .IR dump (8)
                     56: command to determine which file systems need to be dumped.
                     57: The
                     58: .I fs_passno
                     59: field is used by the
                     60: .IR fsck (8)
                     61: program to determine the order in which file system checks are done
                     62: at reboot time.
                     63: The root file system should be specified with a
                     64: .I fs_passno
                     65: of 1, and other file systems should have larger numbers.  File systems
                     66: within a drive should have distinct numbers, but file systems on different
                     67: drives can be checked on the same pass to utilize parallelism available in
                     68: the hardware.
                     69: .PP
                     70: If
                     71: .I fs_type
                     72: is ``sw'' then the special file is made available as a piece of swap
                     73: space by the
                     74: .IR swapon (8)
                     75: command at the end of the system reboot procedure.
                     76: The fields other than
                     77: .I fs_spec
                     78: and
                     79: .I fs_type
                     80: are not used in this case.
                     81: .PP
                     82: If
                     83: .I fs_type
                     84: is ``rq'' then at boot time the file system is automatically
                     85: processed by the
                     86: .IR quotacheck (8)
                     87: command and disk quotas are then enabled with
                     88: .IR quotaon (8).
                     89: File system quotas are maintained in a file ``quotas'', which is
                     90: located at the root of the associated file system.
                     91: .PP
                     92: If
                     93: .I fs_type
                     94: is specified as ``xx'' the entry is ignored.
                     95: This is useful to show disk partitions which are currently not used.
                     96: .sp 1
                     97: .nf
                     98: .DT
                     99: #define        FSTAB_RW        "rw"    /* read-write device */
                    100: #define        FSTAB_RO        "ro"    /* read-only device */
                    101: #define        FSTAB_RQ        "rq"    /* read-write with quotas */
                    102: #define        FSTAB_SW        "sw"    /* swap device */
                    103: #define        FSTAB_XX        "xx"    /* ignore totally */
                    104: .PP
                    105: .ta \w'#define 'u +\w'char\ \ 'u +\w'fs_passno; 'u
                    106: struct fstab {
                    107:        char    *fs_spec;       /* block special device name */
                    108:        char    *fs_file;       /* file system path prefix */
                    109:        char    *fs_type;               /* rw,ro,sw or xx */
                    110:        int     fs_freq;                /* dump frequency, in days */
                    111:        int     fs_passno;              /* pass number on parallel dump */
                    112: };
                    113: .fi
                    114: .PP
                    115: The proper way to read records from
                    116: .I /etc/fstab
                    117: is to use the routines getfsent(), getfsspec(), getfstype(),
                    118: and getfsfile().
                    119: .SH FILES
                    120: /etc/fstab
                    121: .SH SEE ALSO
                    122: getfsent(3X)

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.