Imported from util-linux-2.5 tarball.

1 files changed, 39 insertions, 69 deletions

diff --git a/disk-utils/mkfs.8 b/disk-utils/mkfs.8
index 48b223425..e391f7141 100644
--- a/disk-utils/mkfs.8
+++ b/disk-utils/mkfs.8
@@ -1,12 +1,9 @@
 .\" -*- nroff -*-
-.TH FSCK 8 "Jul 1993" "Version 1.8"
+.TH MKFS 8 "Jun 1995" "Version 1.9"
 .SH NAME
-fsck \- check and repair a Linux file system
+mkfs \- build a Linux file system
 .SH SYNOPSIS
-.B fsck
-[
-.B \-A
-]
+.B mkfs
 [
 .B \-V
 ]
@@ -18,62 +15,35 @@ fsck \- check and repair a Linux file system
 .B fs-options
 ]
 .I filesys
+[
+.I blocks
+]
 .SH DESCRIPTION
-.B fsck
-is used to check and optionally repair a Linux file system.
+.B mkfs
+is used to build a Linux file system on a device, usually
+a hard disk partition.
 .I filesys
 is either the device name (e.g. /dev/hda1, /dev/sdb2) or
 the mount point (e.g. /, /usr, /home) for the file system.
+.I blocks
+is the number of blocks to be used for the file system.
 .PP
 The exit code returned by
-.B fsck
-is the sum of the following conditions:
-.br
-\	0\	\-\ No errors
-.br
-\	1\	\-\ File system errors corrected
-.br
-\	2\	\-\ File system errors corrected, system should
-.br
-\	\	\ \ be rebooted if file system was mounted
-.br
-\	4\	\-\ File system errors left uncorrected
-.br
-\	8\	\-\ Operational error
-.br
-\	16\	\-\ Usage or syntax error
-.br
-\	128\	\-\ Shared library error
-.br
-The exit code returned when all file systems are checked using the
-.B -A
-option is the bit-wise OR of the exit codes for each
-file system that is checked.
+.B mkfs
+is 0 on success and 1 on failure.
 .PP
 In actuality,
-.B fsck
-is simply a front-end for the various file system checkers
-(\fBfsck\fR.\fIfstype\fR)
+.B mkfs
+is simply a front-end for the various file system builders
+(\fBmkfs\fR.\fIfstype\fR)
 available under Linux.
-The file system-specific checker is searched for in /etc/fs first,
+The file system-specific builder is searched for in /etc/fs first,
 then in /etc and finally in the directories listed in the PATH
-environment variable.
-Please see the file system-specific checker manual pages for
+enviroment variable.
+Please see the file system-specific builder manual pages for
 further details.
 .SH OPTIONS
 .TP
-.B -A
-Walk through the
-.I /etc/fstab
-file and try to check all file systems in one run.  This option is
-typically used from the
-.I /etc/rc
-system initalization file, instead of multiple commands for checking
-a single file system.  Note, that with this option, you cannot give
-the
-.I filesys
-argument as well.
-.TP
 .B -V
 Produce verbose output, including all file system-specific commands
 that are executed.
@@ -82,7 +52,7 @@ file system-specific commands.
 This is really only useful for testing.
 .TP
 .BI -t \ fstype
-Specifies the type of file system to be checked.
+Specifies the type of file system to be built.
 If not specified, the type is deduced by searching for
 .I filesys
 in
@@ -93,24 +63,18 @@ If the type can not be deduced, the default file system type
 .TP
 .B fs-options
 File system-specific options to be passed to the real file 
-system checker.
+system builder.
 Although not guaranteed, the following options are supported
-by most file system checkers.
-.TP
-.I -a
-Automatically repair the file system without any questions (use
-this option with caution).
-.TP
-.I -l
-List all the file names in the file system.
+by most file system builders.
 .TP
-.I -r
-Interactively repair the file system (ask for confirmations).
+.B -c
+Check the device for bad blocks before building the file system.
 .TP
-.I -s
-List the super block before checking the file system.
+.BI -l \ filename
+Read the bad blocks list from
+.I filename
 .TP
-.I -v
+.B -v
 Produce verbose output.
 .SH BUGS
 All generic options must precede and not be combined with
@@ -118,16 +82,22 @@ file system-specific options.
 Some file system-specific programs do not support the
 .I -v
 (verbose) option, nor return meaningful exit codes.
+Also, some file system-specific programs do not automatically
+detect the device size and require the
+.I blocks
+parameter to be specified.
 .SH AUTHORS
 David Engel (david@ods.com)
 .br
 Fred N. van Kempen (waltje@uwalt.nl.mugnet.org)
 .br
+Ron Sommeling (sommel@sci.kun.nl)
+.br
 The manual page was shamelessly adapted from Remy Card's version
 for the ext2 file system.
 .SH SEE ALSO
-.BR mkfs (8),
-.BR fsck.minix (8),
-.BR fsck.ext (8),
-.BR fsck.ext2 (8),
-.BR fsck.xiafs (8).
+.BR fsck (8),
+.BR mkfs.minix (8),
+.BR mkfs.ext (8),
+.BR mkfs.ext2 (8),
+.BR mkfs.xiafs (8).