projects / unix-history / blobdiff
? search:
summary | tags | clone url | shortlog | log | commit | commitdiff | tree
raw | inline | side by side
BSD 4_3_Reno release
[unix-history] / usr / src / share / man / man5 / fstab.5
diff --git a/usr/src/share/man/man5/fstab.5 b/usr/src/share/man/man5/fstab.5
index a74d6a2..9c80c4f 100644 (file)
--- a/usr/src/share/man/man5/fstab.5
+++ b/usr/src/share/man/man5/fstab.5
@@ -1,24 +1,26 @@
 .\" Copyright (c) 1980, 1989 The Regents of the University of California.
 .\" All rights reserved.
 .\"
 .\" Copyright (c) 1980, 1989 The Regents of the University of California.
 .\" All rights reserved.
 .\"
-.\" Redistribution and use in source and binary forms are permitted
-.\" provided that the above copyright notice and this paragraph are
-.\" duplicated in all such forms and that any documentation,
-.\" advertising materials, and other materials related to such
-.\" distribution and use acknowledge that the software was developed
-.\" by the University of California, Berkeley.  The name of the
-.\" University may not be used to endorse or promote products derived
-.\" from this software without specific prior written permission.
-.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
-.\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
-.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
+.\" Redistribution and use in source and binary forms are permitted provided
+.\" that: (1) source distributions retain this entire copyright notice and
+.\" comment, and (2) distributions including binaries display the following
+.\" acknowledgement:  ``This product includes software developed by the
+.\" University of California, Berkeley and its contributors'' in the
+.\" documentation or other materials provided with the distribution and in
+.\" all advertising materials mentioning features or use of this software.
+.\" Neither the name of the University nor the names of its contributors may
+.\" be used to endorse or promote products derived from this software without
+.\" specific prior written permission.
+.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
+.\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
+.\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
 .\"
 .\"
-.\"    @(#)fstab.5     6.2 (Berkeley) %G%
+.\"    @(#)fstab.5     6.4 (Berkeley) 6/23/90
 .\"
 .\"
-.TH FSTAB 5  ""
+.TH FSTAB 5  "June 23, 1990"
 .UC 4
 .SH NAME
 .UC 4
 .SH NAME
-fstab \- static information about the file systems
+fstab \- static information about the filesystems
 .SH SYNOPSIS
 .B #include <fstab.h>
 .SH DESCRIPTION
 .SH SYNOPSIS
 .B #include <fstab.h>
 .SH DESCRIPTION
@@ -30,7 +32,7 @@ systems.
 is only read by programs, and not written;
 it is the duty of the system administrator to properly create 
 and maintain this file.
 is only read by programs, and not written;
 it is the duty of the system administrator to properly create 
 and maintain this file.
-Each file system is described on a separate line;
+Each filesystem is described on a separate line;
 fields on each line are separated by tabs or spaces.
 The order of records in
 .I /etc/fstab
 fields on each line are separated by tabs or spaces.
 The order of records in
 .I /etc/fstab
@@ -46,8 +48,8 @@ doing their thing.
 The first field, (\c
 .IR \|fs_spec ),
 describes the block special device or
 The first field, (\c
 .IR \|fs_spec ),
 describes the block special device or
-remote file system to be mounted.
-For file systems of type
+remote filesystem to be mounted.
+For filesystems of type
 .BR ufs ,
 the special file name is the block special file name, 
 and not the character special file name.
 .BR ufs ,
 the special file name is the block special file name, 
 and not the character special file name.
@@ -57,28 +59,48 @@ last ``/'' in the special file name.
 .PP
 The second field, (\c
 .IR \|fs_file ),
 .PP
 The second field, (\c
 .IR \|fs_file ),
-describes the mount point for the file system.
+describes the mount point for the filesystem.
 For swap partitions, this field should be specified as ``none''.
 .PP
 The third field, (\c
 .IR \|fs_vfstype ),
 For swap partitions, this field should be specified as ``none''.
 .PP
 The third field, (\c
 .IR \|fs_vfstype ),
-describes the type of the file system.
-The system currently supports three types of file systems:
+describes the type of the filesystem.
+The system currently supports four types of filesystems:
 .IP \fBufs\fR 8
 .IP \fBufs\fR 8
-the local UNIX file system
+a local UNIX filesystem
+.IP \fBmfs\fR 8
+a local memory-based UNIX filesystem
 .IP \fBnfs\fR 8
 .IP \fBnfs\fR 8
-a Sun Microsystems ``Network File System''
+a Sun Microsystems compatible ``Network File System''
 .IP \fBswap\fR 8
 a disk partition to be used for swapping
 .PP
 The fourth field, (\c
 .IR \|fs_mntops ),
 .IP \fBswap\fR 8
 a disk partition to be used for swapping
 .PP
 The fourth field, (\c
 .IR \|fs_mntops ),
-describes the mount options associated with the file system.
+describes the mount options associated with the filesystem.
 It is formatted as a comma separated list of options.
 It contains at least the type of mount (see
 .I fs_type
 below) plus any additional options
 It is formatted as a comma separated list of options.
 It contains at least the type of mount (see
 .I fs_type
 below) plus any additional options
-appropriate to the file system type.
+appropriate to the filesystem type.
+.PP
+If the options ``userquota'' and/or ``groupquota'' are specified,
+the filesystem is automatically processed by the
+.IR quotacheck (8)
+command, and user and/or group disk quotas are enabled with
+.IR quotaon (8).
+By default,
+filesystem quotas are maintained in files named
+.I quota.user
+and
+.I quota.group
+which are located at the root of the associated filesystem.
+These defaults may be overridden by putting an equal sign
+and an alternative absolute pathname following the quota option.
+Thus, if the user quota file for /tmp is stored in /var/quotas/tmp.user,
+this location can be specified as:
+.IP
+       userquota=/var/quotas/tmp.user
 .PP
 The type of the mount is extracted from the
 .I fs_mntops
 .PP
 The type of the mount is extracted from the
 .I fs_mntops
@@ -89,18 +111,10 @@ field (it is not deleted from the
 field).
 If
 .I fs_type
 field).
 If
 .I fs_type
-is ``rw'' or ``ro'' then the file system whose name is given in the
+is ``rw'' or ``ro'' then the filesystem whose name is given in the
 .I fs_file
 field is normally mounted read-write or read-only on the
 .I fs_file
 field is normally mounted read-write or read-only on the
-specified special file.  If
-.I fs_type
-is ``rq'', then the file system is normally mounted read-write,
-the file system is automatically processed by the
-.IR quotacheck (8)
-command, and disk quotas are enabled with
-.IR quotaon (8).
-File system quotas are maintained in a file ``quotas'', which is
-located at the root of the associated file system.
+specified special file.
 If
 .I fs_type
 is ``sw'' then the special file is made available as a piece of swap
 If
 .I fs_type
 is ``sw'' then the special file is made available as a piece of swap
@@ -119,42 +133,44 @@ This is useful to show disk partitions which are currently unused.
 .PP
 The fifth field, (\c
 .IR \|fs_freq ),
 .PP
 The fifth field, (\c
 .IR \|fs_freq ),
-is used for these file systems by the
+is used for these filesystems by the
 .IR dump (8)
 .IR dump (8)
-command to determine which file systems need to be dumped.
+command to determine which filesystems need to be dumped.
 If the fifth field is not present, a value of zero is returned and
 .I dump
 If the fifth field is not present, a value of zero is returned and
 .I dump
-will assume that the file system does not need to be dumped.
+will assume that the filesystem does not need to be dumped.
 .PP
 The sixth field, (\c
 .IR \|fs_passno ),
 is used by the
 .IR fsck (8)
 .PP
 The sixth field, (\c
 .IR \|fs_passno ),
 is used by the
 .IR fsck (8)
-program to determine the order in which file system checks are done
+program to determine the order in which filesystem checks are done
 at reboot time.
 at reboot time.
-The root file system should be specified with a
+The root filesystem should be specified with a
+.I fs_passno
+of 1, and other filesystems should have a 
 .I fs_passno
 .I fs_passno
-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 the sixth field is not present, a value of zero is returned and
+of 2.
+Filesystems within a drive will be checked sequentially,
+but filesystems on different drives will be checked at the
+same time to utilize parallelism available in the hardware.
+If the sixth field is not present or zero,
+a value of zero is returned and
 .I fsck
 .I fsck
-will assume that the file system does not need to be checked.
+will assume that the filesystem does not need to be checked.
 .sp 1
 .nf
 .DT
 #define        FSTAB_RW        "rw"    /* read-write device */
 #define        FSTAB_RO        "ro"    /* read-only device */
 .sp 1
 .nf
 .DT
 #define        FSTAB_RW        "rw"    /* read-write device */
 #define        FSTAB_RO        "ro"    /* read-only device */
-#define        FSTAB_RQ        "rq"    /* read-write with quotas */
 #define        FSTAB_SW        "sw"    /* swap device */
 #define        FSTAB_XX        "xx"    /* ignore totally */
 .PP
 .ta \w'#define 'u +\w'char\ \ 'u +\w'*fs_vfstype;\ \ 'u
 struct fstab {
        char    *fs_spec;       /* block special device name */
 #define        FSTAB_SW        "sw"    /* swap device */
 #define        FSTAB_XX        "xx"    /* ignore totally */
 .PP
 .ta \w'#define 'u +\w'char\ \ 'u +\w'*fs_vfstype;\ \ 'u
 struct fstab {
        char    *fs_spec;       /* block special device name */
-       char    *fs_file;       /* file system path prefix */
-       char    *fs_vfstype;    /* type of file system */
+       char    *fs_file;       /* filesystem path prefix */
+       char    *fs_vfstype;    /* type of filesystem */
        char    *fs_mntops;     /* comma separated mount options */
        char    *fs_type;       /* rw, ro, sw, or xx */
        int     fs_freq;        /* dump frequency, in days */
        char    *fs_mntops;     /* comma separated mount options */
        char    *fs_type;       /* rw, ro, sw, or xx */
        int     fs_freq;        /* dump frequency, in days */
Continuous source code history from original PDP-7 UNIX to FreeBSD 2, the first fully unencumbered FreeBSD release.