get_device_by_label.c (init_lvm): Fix bug which caused

[tools/e2fsprogs.git] / misc / tune2fs.8.in

diff --git a/misc/tune2fs.8.in b/misc/tune2fs.8.in
index 060e87c..3a15a58 100644 (file)
--- a/misc/tune2fs.8.in
+++ b/misc/tune2fs.8.in
@@ -19,6 +19,9 @@ tune2fs \- adjust tunable filesystem parameters on second extended filesystems
 .I errors-behavior
 ]
 [
+.B \-f
+]
+[
 .B \-i
 .I interval-between-checks
 ]
@@ -66,6 +69,10 @@ tune2fs \- adjust tunable filesystem parameters on second extended filesystems
 .RI [^] feature [,...]
 ]
 [
+.B \-T
+.I time-last-checked
+]
+[
 .B \-U
 .I UUID
 ]
@@ -126,6 +133,20 @@ Remount filesystem read-only.
 Cause a kernel panic.
 .RE
 .TP
+.B \-f
+Force the tune2fs operation to complete even in the face of errors.  This 
+option is useful when removing the 
+.B has_journal
+filesystem feature from a filesystem which has 
+an external journal (or is corrupted
+such that it appears to have an external journal), but that 
+external journal is not available.   
+.sp
+.B WARNING:
+Removing an external journal from a filesystem which was not cleanly unmounted
+without first replaying the external journal can result in
+severe data loss and filesystem corruption.
+.TP
 .BI \-g " group"
 Set the group which can use reserved filesystem blocks.
 The 
@@ -189,6 +210,20 @@ that size.
 @JDEV@.I external-journal
 @JDEV@must be formatted with the same block
 @JDEV@size as filesystems which will be using it.
+@JDEV@.IP
+@JDEV@Instead of specifying a device name directly,
+@JDEV@.I external-journal
+@JDEV@can also be specified by either
+@JDEV@.BI LABEL= label
+@JDEV@or
+@JDEV@.BI UUID= UUID
+@JDEV@to locate the external journal by either the volume label or UUID
+@JDEV@stored in the ext2 superblock at the start of the journal.  Use
+@JDEV@.BR dumpe2fs (8)
+@JDEV@to display a journal device's volume label and UUID.  See also the
+@JDEV@.B -L
+@JDEV@option of
+@JDEV@.BR tune2fs (8).
 .RE
 @JDEV@.IP
 @JDEV@Only one of the
@@ -204,7 +239,16 @@ Ext2 filesystem labels can be at most 16 characters long; if
 .I volume-label 
 is longer than 16 characters, 
 .B tune2fs
-will truncate it and print a warning.  
+will truncate it and print a warning.  The volume label can be used
+by
+.BR mount (8),
+.BR fsck (8),
+and
+.BR /etc/fstab (5)
+(and possibly others) by specifying
+.BI LABEL= volume_label
+instead of a block special device name like
+.BR /dev/hda5 .
 .TP
 .BI \-m " reserved-blocks-percentage"
 Set the percentage of reserved filesystem blocks.
@@ -236,9 +280,17 @@ Create an ext3 journal (as if using the
 option).
 .RE
 .IP
-After setting or clearing any filesystem feature,
+After setting or clearing 
+.B sparse_super
+and 
+.B filetype 
+filesystem features,
 .BR e2fsck (8)
 must be run on the filesystem to return the filesystem to a consistent state.
+.B Tune2fs
+will print a message requesting that the system administrator run
+.BR e2fsck (8)
+if necessary.
 .IP
 .B Warning:
 Linux kernels before 2.0.39 and many 2.1 series kernels do not support
@@ -263,6 +315,22 @@ doing!  You need to run
 on the filesystem after changing this feature in order to have a valid
 filesystem.
 .TP
+.BI \-T " time-last-checked"
+Set the time the filesystem was last checked using
+.BR  e2fsck .
+This can be useful in scripts which use a Logical Volume Manager to make
+a consistent snapshot of a filesystem, and then check the filesystem 
+during off hours to make sure it hasn't been corrupted due to 
+hardware problems, etc.  If the filesystem was clean, then this option can 
+be used to set the last checked time on the original filesystem.  The format 
+of 
+.I time-last-checked
+is the international date format, with an optional time specifier, i.e.
+YYYYMMDD[[HHMM]SS].   The keyword 
+.B now
+is also accepted, in which case the last checked time will be set to the 
+current time.
+.TP
 .BI \-u " user"
 Set the user who can use the reserved filesystem blocks.
 .I user
@@ -272,7 +340,7 @@ is converted to a numerical uid before it is stored in the superblock.
 .BI \-U " UUID"
 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, 
+The format of the UUID is a series of hex digits separated by hyphens, 
 like this: 
 "c1b9d5a2-f162-11cf-9ece-0020afc76f16".  
 The 
@@ -290,6 +358,16 @@ generate a new randomly-generated UUID
 generate a new time-based UUID
 .RE
 .IP
+The UUID may be used by
+.BR mount (8),
+.BR fsck (8),
+and
+.BR /etc/fstab (5)
+(and possibly others) by specifying
+.BI UUID= uuid
+instead of a block special device name like
+.BR /dev/hda1 .
+.IP
 See
 .BR uuidgen (8)
 for more information.