+2001-05-14 Theodore Tso <tytso@valinux.com>
+
+ * tune2fs.c (update_feature_set): Clean up some printf messages.
+
+ * fsck.8.in, mke2fs.8.in, tune2fs.8.in: Fix typo's and make other
+ clarifications suggested by Andreas Dilger.
+
2001-05-13 Theodore Tso <tytso@valinux.com>
* mke2fs.c (PRS): Integrated changes from Andreas Dilger which
2001-03-26 Theodore Tso <tytso@valinux.com>
* mke2fs.8.in, tune2fs.8.in: Change man paegs to document that the
- journal must be bewteen 1024 and 10,240 file system
+ journal must be bewteen 1024 and 102,400 file system
blocks.
* mke2fs.c, tune2fs.c: Change to use figure_journal_size()
1999-01-05 Theodore Ts'o <tytso@rsts-11.mit.edu>
- * mke2fs.c (PRS): Allow the user to specify exactly how many
- inodes he/she wishes.
+ * mke2fs.c (PRS): Add -N option to allow the user to specify
+ exactly how many inodes he/she wishes.
* chattr.c, lsattr.c: Only print the version information for the
program if the -V option is given.
.I fs_passno
value of 0 are skipped and are not checked at all.
If there are multiple filesystems with the same pass number,
-e2fsck will attempt to check them in parallel, although it will avoid running
+fsck will attempt to check them in parallel, although it will avoid running
multiple filesystem checks on the same physical disk.
-Hence,
-a very common configuration in
+Hence, a very common configuration in
.I /etc/fstab
files is to set the root filesystem to have a
.I fs_passno
.B fsck
to automatically run filesystem checkers in parallel if it is advantageous
to do so. System administrators might choose
-not to use this configuration if they need to avoid multiple filesystem
+not to use this configuration if they need to avoid multiple filesystem
checks running in parallel for some reason --- for example, if the
machine in question is short on memory so that
excessive paging is a concern.
.I blocks-count
]
@JDEV@.sp
-@JDEV@.B "mke2fs \-O journal-dev"
+@JDEV@.B "mke2fs \-O journal_dev"
@JDEV@[
@JDEV@.B \-b
@JDEV@.I block-size
@JDEV@]
-.\" No journal-device specific journal options yet (size is ignored)
+.\" No external-journal specific journal options yet (size is ignored)
.\" @JDEV@[
.\" @JDEV@.B \-J
.\" @JDEV@.I journal-options
@JDEV@[
@JDEV@.B \-v
@JDEV@]
-@JDEV@.I journal-device
+@JDEV@.I external-journal
.SH DESCRIPTION
.B mke2fs
is used to create a Linux second extended file system on a device (usually
.TP
.BI size= journal-size
Create a journal stored in the filesystem of size
-.IR journal-size .
+.I journal-size
+megabytes.
The size of the journal must be at least 1024 filesystem blocks
(i.e., 1MB if using 1k blocks, 4MB if using 4k blocks, etc.)
-and may be no more than 10,240 filesystem blocks.
+and may be no more than 102,400 filesystem blocks.
The journal must fit within the newly created filesystem.
@JDEV@.TP
@JDEV@.BI device= external-journal
-@JDEV@Add an external journal found on a block device named by
-@JDEV@.I external-journal
-@JDEV@to the filesystem. The external
-@JDEV@journal must have been already created using the command
-@JDEV@.sp
-@JDEV@.B mke2fs \-O journal-dev
-@JDEV@.IR journal\-device
-@JDEV@.sp
+@JDEV@Attach the filesystem to the journal block device located on
+@JDEV@.IR external-journal .
+@JDEV@The external
+@JDEV@journal must already have been created using the command
+@JDEV@.IP
+@JDEV@.B mke2fs -O journal_dev
+@JDEV@.IR external-journal
+@JDEV@.IP
+@JDEV@Note that
+@JDEV@.I external-journal
+@JDEV@must have been created with the
+@JDEV@same block size as the new filesystem.
+.RE
+@JDEV@.IP
@JDEV@Only one of the
@JDEV@.BR size " or " device
@JDEV@options can be given for a filesystem.
-.RE
.TP
.BI \-l " filename"
Read the bad blocks list from
.BI \-m " reserved-blocks-percentage"
Specify the percentage of the filesystem blocks reserved for
the super-user. This value defaults to 5%.
-.\" .TP
-.\" .BI \-t " test"
-.\" Check the device for bad blocks before creating the file system
-.\" using the specified test.
.TP
.B \-M
Set the last mounted directory for the filesystem. This might be useful
.B mke2fs
executable.
.TP
-.B \-O "\fIfeature\fR[,...]"
+.B "\-O \fIfeature\fR[,...]"
Create filesystem with given features (filesystem options).
Currently, the
.B sparse_super
.B Warning:
Linux kernels before 2.0.39 and many 2.1 series kernels do not support
filesystems that use any of these features. Filesystems that
-may need to mounted on pre-2.2 kernels should be created with the
+may need to mounted on pre-2.2 kernels should be created with
.B "\-O none"
(or
.B "\-r 0"
.B \-j
option).
@JDEV@.TP
-@JDEV@.B journal-dev
+@JDEV@.B journal_dev
@JDEV@Create an external ext3 journal on the given device
-@JDEV@instead of a regular ext2 filesystem. The external ext3
-@JDEV@journal can be shared by multiple ext2 filesystems.
+@JDEV@instead of a regular ext2 filesystem.
+@JDEV@Note that
+@JDEV@.I external-journal
+@JDEV@must be created with the same
+@JDEV@block size as the filesystems that will be using it.
.RE
.TP
+.B \-q
+Quiet execution. Useful if
+.B mke2fs
+is run in a script.
+.TP
.BI \-r " revision"
Set the filesystem revision for the new filesystem. Note that 1.2
kernels only support revision 0 filesystems. The default is to
.TP
.BI \-R " raid-options"
Set raid-related options for the filesystem. Raid options are comma
-separated, and may take an argument using the equals ('=') sign. The
+separated, and may take an argument using the equals ('=') sign. The
following options are supported:
.RS 1.2i
.TP
.BI stride= stripe-size
Configure the filesystem for a RAID array with
-.I strip-size
+.I stripe-size
filesystem blocks per stripe.
.RE
.TP
-.B \-q
-Quiet execution. Useful if
-.B mke2fs
-is run in a script.
-.TP
.B \-S
Write superblock and group descriptors only. This is useful if all of
the superblock and backup superblocks are corrupted, and a last-ditch
is no guarantee that any data will be salvageable. It is critical to
specify the correct filesystem blocksize when using this option,
or there is no chance of recovery.
+.\" .TP
+.\" .BI \-t " test"
+.\" Check the device for bad blocks before creating the file system
+.\" using the specified test.
.TP
.BI \-T " fs-type"
Specify how the filesystem is going to be used, so that mke2fs can
.B -j
Add an ext3 journal to the filesystem. If the
.B \-J
-option is not specified, the default journal parameters will used will create
+option is not specified, the default journal parameters will be used to create
an appropriately sized journal (given the size of the filesystem)
stored within the filesystem. Note that you must be using a kernel
which has ext3 support in order to actually make use of the journal.
.TP
-.BR \-J " journal_options"
+.BR \-J " journal-options"
Override the default ext3 journal parameters. Journal options are comma
separated, and may take an argument using the equals ('=') sign.
The following journal options are supported:
is converted to a numerical uid before it is stored in the superblock.
.TP
.BI \-U " UUID"
-set the universally unique identifier (UUID) of the filesystem to
+Set the universally unique identifier (UUID) of the filesystem to
.IR UUID .
The format of the UUID is a series of hex digits separated by hypthens,
like this:
if ((mount_flags & EXT2_MF_MOUNTED) &&
!(mount_flags & EXT2_MF_READONLY)) {
fprintf(stderr,
- _("The HAS_JOURNAL flag may only be "
+ _("The has_journal flag may only be "
"cleared when the filesystem is\n"
"unmounted or mounted "
"read-only.\n"));
if (sb->s_feature_incompat &
EXT3_FEATURE_INCOMPAT_RECOVER) {
fprintf(stderr,
- _("The NEEDS_RECOVERY flag is set. "
+ _("The needs_recovery flag is set. "
"Please run e2fsck before clearing\n"
"the HAS_JOURNAL flag.\n"));
exit(1);
retval = ext2fs_add_journal_device(fs, jfs);
if (retval) {
com_err (program_name, retval,
- _("while trying to create journal on device %s"),
+ _("while adding filesystem to journal on %s"),
journal_device);
exit(1);
}