-.\" -*- nroff -*-
.TH MKFS 8 "June 2011" "util-linux" "System Administration"
.SH NAME
mkfs \- build a Linux filesystem
.SH SYNOPSIS
-.SH SYNOPSIS
.B mkfs
-.RI [ options ]
+[options]
.RB [ \-t
-.IR "type fs-options" ] " device " [ size ]
+.IR type "] [" fs-options ] " device " [ size ]
.SH DESCRIPTION
+.B This mkfs frontend is deprecated in favour of filesystem specific mkfs.<type> utils.
+.PP
.B mkfs
is used to build a Linux filesystem on a device, usually
a hard disk partition. The
is simply a front-end for the various filesystem builders
(\fBmkfs.\fIfstype\fR)
available under Linux.
-The filesystem-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.
+The filesystem-specific builder is searched for via your PATH
+environment setting only.
Please see the filesystem-specific builder manual pages for
further details.
.SH OPTIONS
.TP
.I fs-options
Filesystem-specific options to be passed to the real filesystem builder.
-Although not guaranteed, the following options are supported
-by most filesystem builders.
.TP
.BR \-V , " \-\-verbose"
Produce verbose output, including all filesystem-specific commands
will work as \fB\-\-verbose\fR.)
.TP
.BR \-h , " \-\-help"
-Display help and exit.
+Display help text and exit.
.SH BUGS
All generic options must precede and not be combined with
filesystem-specific options.
-Some filesystem-specific programs do not support the
-.B -V
-(verbose) option, nor return meaningful exit codes.
-Also, some filesystem-specific programs do not automatically
+Some filesystem-specific programs do not automatically
detect the device size and require the
.I size
parameter to be specified.
.SH AUTHORS
David Engel (david@ods.com)
.br
-Fred N. van Kempen (waltje@uwalt.nl.mugnet.org)
+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 filesystem.
.SH SEE ALSO
+.na
.BR fs (5),
.BR badblocks (8),
.BR fsck (8),
.BR mkfs.minix (8),
.BR mkfs.msdos (8),
.BR mkfs.vfat (8),
-.BR mkfs.xfs (8),
-.BR mkfs.xiafs (8)
+.BR mkfs.xfs (8)
+.ad
.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/.
+https://www.kernel.org/pub/linux/utils/util-linux/.