]>
Commit | Line | Data |
---|---|---|
6dbe3af9 | 1 | .\" -*- nroff -*- |
232dc924 | 2 | .TH MKFS 8 "June 2011" "util-linux" "System Administration" |
6dbe3af9 | 3 | .SH NAME |
c181c31d | 4 | mkfs \- build a Linux filesystem |
6dbe3af9 | 5 | .SH SYNOPSIS |
726f69e2 | 6 | .B mkfs |
449a215f BS |
7 | .RI [ options ] |
8 | .RB [ \-t | |
4ec32f6a | 9 | .IR type "] [" fs-options ] " device " [ size ] |
6dbe3af9 | 10 | .SH DESCRIPTION |
4459245f KZ |
11 | .B This mkfs frontend is deprecated in favour of filesystem specific mkfs.<type> utils. |
12 | .PP | |
726f69e2 | 13 | .B mkfs |
c181c31d BS |
14 | is used to build a Linux filesystem on a device, usually |
15 | a hard disk partition. The | |
16 | .I device | |
17 | argument is either the device name (e.g. | |
7eda085c | 18 | .IR /dev/hda1 , |
039f3531 | 19 | .IR /dev/sdb2 ), |
c181c31d | 20 | or a regular file that shall contain the filesystem. The |
63ab9524 | 21 | .I size |
c181c31d | 22 | argument is the number of blocks to be used for the filesystem. |
6dbe3af9 KZ |
23 | .PP |
24 | The exit code returned by | |
726f69e2 KZ |
25 | .B mkfs |
26 | is 0 on success and 1 on failure. | |
6dbe3af9 KZ |
27 | .PP |
28 | In actuality, | |
726f69e2 | 29 | .B mkfs |
c181c31d | 30 | is simply a front-end for the various filesystem builders |
039f3531 | 31 | (\fBmkfs.\fIfstype\fR) |
6dbe3af9 | 32 | available under Linux. |
c181c31d | 33 | The filesystem-specific builder is searched for in a number |
449a215f | 34 | of directories, like perhaps |
7eda085c KZ |
35 | .IR /sbin , |
36 | .IR /sbin/fs , | |
37 | .IR /sbin/fs.d , | |
38 | .IR /etc/fs , | |
39 | .I /etc | |
2b6fc908 | 40 | (the precise list is defined at compile time but at least |
7eda085c KZ |
41 | contains |
42 | .I /sbin | |
43 | and | |
44 | .IR /sbin/fs ), | |
45 | and finally in the directories | |
48d7b13a | 46 | listed in the PATH environment variable. |
c181c31d | 47 | Please see the filesystem-specific builder manual pages for |
6dbe3af9 KZ |
48 | further details. |
49 | .SH OPTIONS | |
50 | .TP | |
449a215f BS |
51 | .BR \-t , " \-\-type " \fItype\fR |
52 | Specify the \fItype\fR of filesystem to be built. | |
c181c31d | 53 | If not specified, the default filesystem type |
5c36a0eb | 54 | (currently ext2) is used. |
6dbe3af9 | 55 | .TP |
039f3531 | 56 | .I fs-options |
c181c31d | 57 | Filesystem-specific options to be passed to the real filesystem builder. |
6dbe3af9 | 58 | .TP |
449a215f | 59 | .BR \-V , " \-\-verbose" |
c181c31d | 60 | Produce verbose output, including all filesystem-specific commands |
63ab9524 SK |
61 | that are executed. |
62 | Specifying this option more than once inhibits execution of any | |
c181c31d | 63 | filesystem-specific commands. |
63ab9524 | 64 | This is really only useful for testing. |
6dbe3af9 | 65 | .TP |
449a215f BS |
66 | .BR \-V , " \-\-version" |
67 | Display version information and exit. (Option \fB\-V\fR will display | |
c181c31d | 68 | version information only when it is the only parameter, otherwise it |
449a215f | 69 | will work as \fB\-\-verbose\fR.) |
6dbe3af9 | 70 | .TP |
449a215f | 71 | .BR \-h , " \-\-help" |
b4362b6f | 72 | Display help text and exit. |
6dbe3af9 KZ |
73 | .SH BUGS |
74 | All generic options must precede and not be combined with | |
c181c31d | 75 | filesystem-specific options. |
b5ab5bec | 76 | Some filesystem-specific programs do not automatically |
726f69e2 | 77 | detect the device size and require the |
449a215f | 78 | .I size |
726f69e2 | 79 | parameter to be specified. |
6dbe3af9 KZ |
80 | .SH AUTHORS |
81 | David Engel (david@ods.com) | |
82 | .br | |
83 | Fred N. van Kempen (waltje@uwalt.nl.mugnet.org) | |
84 | .br | |
726f69e2 KZ |
85 | Ron Sommeling (sommel@sci.kun.nl) |
86 | .br | |
6dbe3af9 | 87 | The manual page was shamelessly adapted from Remy Card's version |
c181c31d | 88 | for the ext2 filesystem. |
6dbe3af9 | 89 | .SH SEE ALSO |
7eda085c KZ |
90 | .BR fs (5), |
91 | .BR badblocks (8), | |
726f69e2 | 92 | .BR fsck (8), |
7eda085c KZ |
93 | .BR mkdosfs (8), |
94 | .BR mke2fs (8), | |
63cccae4 | 95 | .BR mkfs.bfs (8), |
726f69e2 | 96 | .BR mkfs.ext2 (8), |
63cccae4 | 97 | .BR mkfs.ext3 (8), |
26b4e7a5 | 98 | .BR mkfs.ext4 (8), |
7eda085c KZ |
99 | .BR mkfs.minix (8), |
100 | .BR mkfs.msdos (8), | |
63cccae4 | 101 | .BR mkfs.vfat (8), |
c07ebfa1 | 102 | .BR mkfs.xfs (8), |
7eda085c | 103 | .BR mkfs.xiafs (8) |
86d62711 | 104 | .SH AVAILABILITY |
601d12fb KZ |
105 | The mkfs command is part of the util-linux package and is available from |
106 | ftp://ftp.kernel.org/pub/linux/utils/util-linux/. |