From: CSRG <csrg@ucbvax.Berkeley.EDU>
Date: Thu, 28 Jul 1983 16:48:39 +0000 (-0800)
Subject: BSD 4_2 development
X-Git-Tag: BSD-4_3^2~292
X-Git-Url: https://git.subgeniuskitty.com/unix-history/.git/commitdiff_plain/92feda313501033220818e3116e03786a1294ad7

BSD 4_2 development
Work on file usr/man/man5/fstab.5

Synthesized-from: CSRG/cd1/4.2
---

diff --git a/usr/man/man5/fstab.5 b/usr/man/man5/fstab.5
new file mode 100644
index 0000000000..77f94de5ab
--- /dev/null
+++ b/usr/man/man5/fstab.5
@@ -0,0 +1,116 @@
+.TH FSTAB 5  "26 June 1983"
+.UC 4
+.SH NAME
+fstab \- static information about the filesystems
+.SH SYNOPSIS
+.B #include <fstab.h>
+.SH DESCRIPTION
+The file
+.I /etc/fstab
+contains descriptive information about the various file
+systems.
+.I /etc/fstab
+is only
+.I read
+by programs, and not written;
+it is the duty of the system administrator to properly create 
+and maintain this file.
+The order of records in
+.I /etc/fstab
+is important because
+.I fsck,
+.I mount,
+and
+.I umount
+sequentially iterate through
+.I /etc/fstab
+doing their thing.
+.PP
+The special file name is the 
+.B 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.
+.PP
+If
+.I fs_type
+is ``rw'' or ``ro'' then the file system whose name is given in 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
+with disk quotas enabled.
+The
+.I fs_freq
+field is used for these file systems by the
+.IR dump (8)
+command to determine which file systems need to be dumped.
+The
+.I fs_passno
+field is used by the
+.IR fsck (8)
+program to determine the order in which file system checks are done
+at reboot time.
+The root file system should be specified with a
+.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.
+.PP
+If
+.I fs_type
+is ``sw'' then the special file is made available as a piece of swap
+space by the
+.IR swapon (8)
+command at the end of the system reboot procedure.
+The fields other than
+.I fs_spec
+and
+.I fs_type
+are not used in this case.
+.PP
+If
+.I fs_type
+is ``rq'' then at boot time the file system is automatically
+processed by the
+.IR quotacheck (8)
+command and disk quotas are then 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.
+.PP
+If
+.I fs_type
+is specified as ``xx'' the entry is ignored.
+This is useful to show disk partitions which are currently not used.
+.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_passno; 'u
+struct fstab {
+	char	*fs_spec;	/* block special device name */
+	char	*fs_file;	/* file system path prefix */
+	char	*fs_type;		/* rw,ro,sw or xx */
+	int	fs_freq;		/* dump frequency, in days */
+	int	fs_passno;		/* pass number on parallel dump */
+};
+.fi
+.PP
+The proper way to read records from
+.I /etc/fstab
+is to use the routines getfsent(), getfsspec(), getfstype(),
+and getfsfile().
+.SH FILES
+/etc/fstab
+.SH SEE ALSO
+getfsent(3X)