.SH SYNOPSIS
.B mke2fs
[
+.B \-b
+.I block-size
+]
+[
.B \-c
|
.B \-l
.I filename
]
[
-.B \-b
-.I block-size
-]
-[
.B \-C
.I cluster-size
]
.B \-D
]
[
+.B \-e
+.I errors-behavior
+]
+[
+.B \-E
+.I extended-options
+]
+[
+.B \-F
+]
+[
.B \-g
.I blocks-per-group
]
.I journal-options
]
[
-.B \-N
-.I number-of-inodes
+.B \-L
+.I volume-label
+]
+[
+.B \-m
+.I reserved-blocks-percentage
+]
+[
+.B \-M
+.I last-mounted-directory
]
[
.B \-n
]
[
-.B \-m
-.I reserved-blocks-percentage
+.B \-N
+.I number-of-inodes
]
[
.B \-o
]
[
.B \-O
-[^]\fIfeature\fR[,...]
+.RI [\fB^\fR] feature [\fB,\fR...]
]
[
.B \-q
.I fs-revision-level
]
[
-.B \-E
-.I extended-options
-]
-[
-.B \-v
-]
-[
-.B \-F
-]
-[
-.B \-L
-.I volume-label
-]
-[
-.B \-M
-.I last-mounted-directory
-]
-[
.B \-S
]
[
.I UUID
]
[
-.B \-V
+.B \-v
]
[
-.B \-e
-.I errors-behavior
+.B \-V
]
[
.B \-z
-.I undo_file
+.I undo-file
]
.I device
[
.I fs-size
is interpreted as the number of
.I blocksize
-blocks. If the fs-size is suffixed by 'k', 'm', 'g', 't'
+blocks. If \fIfs-size\fR is suffixed by 'k', 'm', 'g', 't'
(either upper-case or lower-case), then it is interpreted in
power-of-two kilobytes, megabytes, gigabytes, terabytes, etc.
If
this option is specified twice, then a slower read-write
test is used instead of a fast read-only test.
.TP
-.B \-C " cluster-size"
-Specify the size of cluster in bytes for filesystems using the bigalloc
+.BI \-C " cluster-size"
+Specify the size of a cluster in bytes for filesystems using the bigalloc
feature. Valid cluster-size values are from 2048 to 256M bytes per
cluster. This can only be specified if the bigalloc feature is
enabled. (See the
-.B ext4 (5)
-man page for more details about bigalloc.) The default cluster size if
+.BR ext4 (5)
+man page for more details about bigalloc.) The default cluster size if
bigalloc is enabled is 16 times the block size.
.TP
.BI \-d " root-directory"
filesystem.
.TP
.B \-D
-Use direct I/O when writing to the disk. This avoids mke2fs dirtying a
+Use direct I/O when writing to the disk. This avoids \fBmke2fs\fR dirtying a
lot of buffer cache memory, which may impact other applications running
-on a busy server. This option will cause mke2fs to run much more
+on a busy server. This option will cause \fBmke2fs\fR to run much more
slowly, however, so there is a tradeoff to using direct I/O.
.TP
.BI \-e " error-behavior"
Specify the numeric user and group ID of the root directory. If no UID:GID
is specified, use the user and group ID of the user running \fBmke2fs\fR.
In \fBmke2fs\fR 1.42 and earlier the UID and GID of the root directory were
-set by default to the UID and GID of the user running the mke2fs command.
+set by default to the UID and GID of the user running the \fBmke2fs\fR command.
The \fBroot_owner=\fR option allows explicitly specifying these values,
and avoid side-effects for users that do not expect the contents of the
filesystem to change based on the user running \fBmke2fs\fR.
Do not attempt to discard blocks at mkfs time.
.TP
.B quotatype
-Specify the which quota types (usrquota, grpquota, prjquota) which
+Specify which quota types (usrquota, grpquota, prjquota)
should be enabled in the created file system. The argument of this
-extended option should be a colon separated list. This option has
+extended option should be a colon-separated list. This option has
effect only if the
.B quota
-feature is set. The default quota types to be initialized if this
-option is not specified is both user and group quotas. If the project
-feature is enabled that project quotas will be initialized as well.
+feature is set. The default quota types to be initialized if this
+option is not specified are both user and group quotas. If the project
+feature is enabled, then project quotas will be initialized as well.
.RE
.TP
.B \-F
.I inode-size
the more space the inode table will consume, and this reduces the usable
space in the filesystem and can also negatively impact performance.
-It is not
-possible to change this value after the filesystem is created.
.IP
File systems with an inode size of 128 bytes do not support timestamps
beyond January 19, 2038. Inodes which are 256 bytes or larger will
.BI \-J " journal-options"
Create the ext3 journal using options specified on the command-line.
Journal options are comma
-separated, and may take an argument using the equals ('=') sign.
+separated, and may take an argument using the equals ('=') sign.
The following journal options are supported:
.RS 1.2i
.TP
.B mke2fs
executable was compiled for.
.TP
-.B "\-O \fR[^]\fIfeature\fR[,...]"
+.BR \-O " [\fB^\fR]\fIfeature\fR[\fB,\fR...]"
Create a filesystem with the given features (filesystem options),
overriding the default filesystem options. The features that are
enabled by default are specified by the
prefix the feature name with a caret ('^') character.
Features with dependencies will not be removed successfully.
The pseudo-filesystem feature "none" will clear all filesystem features.
-.TP
-For more information about the features which can be set, please see
+.sp
+For more information about the features that can be set, see
the manual page
.BR ext4 (5).
.TP
the command was run (for example, using a name of the form mkfs.ext2,
mkfs.ext3, etc.) or via a default as defined by the
.B /etc/mke2fs.conf
-file. This option controls which filesystem options are used by
+file. This option controls which filesystem options are used by
default, based on the
.B fstypes
configuration stanza in
will create a filesystem that does not have a journal and hence will not
be supported by the ext3 filesystem code in the Linux kernel.)
.TP
-.BI \-T " usage-type[,...]"
+.BI \-T " usage-type\fR[\fB,\fR...]"
Specify how the filesystem is going to be used, so that
.B mke2fs
can choose optimal filesystem parameters for that use. The usage
types that are supported are defined in the configuration file
.BR /etc/mke2fs.conf .
The user may specify one or more usage types
-using a comma separated list.
+using a comma-separated list.
.sp
If this option is is not specified,
.B mke2fs
be created. If the filesystem size is less than 3 megabytes,
.B mke2fs
will use the filesystem type
-.IR floppy .
+.BR floppy .
If the filesystem size is greater than or equal to 3 but less than
512 megabytes,
-.BR mke2fs (8)
+.B mke2fs
will use the filesystem type
-.IR small .
+.BR small .
If the filesystem size is greater than or equal to 4 terabytes but less than
16 terabytes,
-.BR mke2fs (8)
+.B mke2fs
will use the filesystem type
-.IR big .
+.BR big .
If the filesystem size is greater than or equal to 16 terabytes,
-.BR mke2fs (8)
+.B mke2fs
will use the filesystem type
-.IR huge .
+.BR huge .
Otherwise,
-.BR mke2fs (8)
-will use the default filesystem type
-.IR default .
+.B mke2fs
+will use the filesystem type
+.BR default .
.TP
.BI \-U " UUID"
Set the universally unique identifier (UUID) of the filesystem to
parameter may also be one of the following:
.RS 1.2i
.TP
-.I clear
-clear the filesystem UUID
+.B clear
+Clear the filesystem UUID.
.TP
-.I random
-generate a new randomly-generated UUID
+.B random
+Generate a new randomly-generated UUID.
.TP
-.I time
-generate a new time-based UUID
+.B time
+Generate a new time-based UUID.
.RE
.TP
.B \-v
.B mke2fs
and exit.
.TP
-.BI \-z " undo_file"
+.BI \-z " undo-file"
Before overwriting a file system block, write the old contents of the block to
-an undo file. This undo file can be used with e2undo(8) to restore the old
+an undo file. This undo file can be used with \fBe2undo\fR(8) to restore the old
contents of the file system should something go wrong. If the empty string is
-passed as the undo_file argument, the undo file will be written to a file named
-mke2fs-\fIdevice\fR.e2undo in the directory specified via the
+passed as the \fIundo-file\fR argument, the undo file will be written to a file
+named \fBmke2fs-\fIdevice\fB.e2undo\fR in the directory specified via the
\fIE2FSPROGS_UNDO_DIR\fR environment variable or the \fIundo_dir\fR directive
in the configuration file.