isosize: improve style, grammar and spacing of man page

[thirdparty/util-linux.git] / disk-utils / mkfs.8

.\" -*- nroff -*-
.TH MKFS 8 "Jun 1995" "Version 1.9"
.TH MKFS "8" "June 2011" "util-linux" "System Administration Utilities"
.SH NAME
mkfs \- build a Linux file system
.SH SYNOPSIS
.SH SYNOPSIS
.B mkfs
[\fIoptions\fR] [\fI-t type fs-options\fR] \fIdevice \fR[\fIsize\fR]
.SH DESCRIPTION
.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.
.IR /dev/hda1 ,
.IR /dev/sdb2 ),
or a regular file that shall contain the file system.
The
.I size
argument is the number of blocks to be used for the file system.
.PP
The exit code returned by
.B mkfs
is 0 on success and 1 on failure.
.PP
In actuality,
.B mkfs
is simply a front-end for the various file system builders
(\fBmkfs.\fIfstype\fR)
available under Linux.
The file system-specific builder is searched for in a number
of directories like perhaps
.IR /sbin ,
.IR /sbin/fs ,
.IR /sbin/fs.d ,
.IR /etc/fs ,
.I /etc
(the precise list is defined at compile time but at least
contains
.I /sbin
and
.IR /sbin/fs ),
and finally in the directories
listed in the PATH environment variable.
Please see the file system-specific builder manual pages for
further details.
.SH OPTIONS
.TP
\fB\-t\fR, \fB\-\-type\fR=\fITYPE\fR
Specifies the type of file system to be built.
If not specified, the default file system type
(currently ext2) is used.
.TP
.I fs-options
File system-specific options to be passed to the real file
system builder.
Although not guaranteed, the following options are supported
by most file system builders.
.TP
\fB\-V\fR, \fB\-\-verbose\fR
Produce verbose output, including all file system-specific commands
that are executed.
Specifying this option more than once inhibits execution of any
file system-specific commands.
This is really only useful for testing.
.TP
\fB\-V\fR, \fB\-\-version\fR
output version information and exit
\fB\-V\fR will output version information only when it is the
only parameter.
.TP
\fB\-h\fR, \fB\-\-help\fR
Display help and exit.
.SH BUGS
All generic options must precede and not be combined with
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 fs (5),
.BR badblocks (8),
.BR fsck (8),
.BR mkdosfs (8),
.BR mke2fs (8),
.BR mkfs.bfs (8),
.BR mkfs.ext2 (8),
.BR mkfs.ext3 (8),
.BR mkfs.ext4 (8),
.BR mkfs.minix (8),
.BR mkfs.msdos (8),
.BR mkfs.vfat (8),
.BR mkfs.xfs (8),
.BR mkfs.xiafs (8)
.SH AVAILABILITY
The mkfs command is part of the util-linux package and is available from
ftp://ftp.kernel.org/pub/linux/utils/util-linux/.