mkfs(8)

mkfs8

Build a linux filesystem

Usage

mkfs [options] [-t type] [fs-options] device [size]

Overview

This mkfs frontend is deprecated in favour of filesystem specific mkfs.<type> utils.

mkfs is used to build a Linux filesystem on a device, usually a hard disk partition. The device argument is either the device name (e.g., /dev/hda1, /dev/sdb2), or a regular file that shall contain the filesystem. The size argument is the number of blocks to be used for the filesystem.

The exit status returned by mkfs is 0 on success and 1 on failure.

In actuality, mkfs is simply a front-end for the various filesystem builders (mkfs.fstype) available under Linux. The filesystem-specific builder is searched for via your PATH environment setting only. Please see the filesystem-specific builder manual pages for further details.

Options

-t, --type type

Specify the type of filesystem to be built. If not specified, the default filesystem type (currently ext2) is used.

fs-options

Filesystem-specific options to be passed to the real filesystem builder.

-V, --verbose

Produce verbose output, including all filesystem-specific commands that are executed. Specifying this option more than once inhibits execution of any filesystem-specific commands. This is really only useful for testing.

-h, --help

Display help text and exit.

-V, --version

Display version and exit. (Option -V will display version information only when it is the only parameter, otherwise it will work as --verbose.)

Releases

19 releases since Debian 1.1 (Buzz); the text changed 14 times.

  1. 1.1–2.0
  2. 2.1
  3. 2.2
  4. 3.0
  5. 3.1–4.0
  6. 5.0
  7. 6.0
  8. 7
  9. 8
  10. 9
  11. 10
  12. 11
  13. 12
  14. 13
  15. Arch

--help since Debian 7 (Wheezy); --type since Debian 7 (Wheezy); --verbose since Debian 7 (Wheezy); --version since Debian 7 (Wheezy); -h since Debian 7 (Wheezy); -t since Debian 7 (Wheezy).

-c until Debian 6.0 (Squeeze); -v until Debian 6.0 (Squeeze).

Bugs

All generic options must precede and not be combined with filesystem-specific options. Some filesystem-specific programs do not automatically detect the device size and require the size parameter to be specified.

Authors

David Engel <[email protected]>, Fred N. van Kempen <[email protected]>, Ron Sommeling <[email protected]>.

The manual page was shamelessly adapted from Remy Card’s version for the ext2 filesystem.

Reporting bugs

For bug reports, use the issue tracker <https://github.com/util-linux/util-linux/issues>.

Availability

The mkfs command is part of the util-linux package which can be downloaded from Linux Kernel Archive <https://www.kernel.org/pub/linux/utils/util-linux/>.

From util-linux 2.42.4-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.