misc/tune2fs.8.in

   1 .\" Revision 1.0 93/06/3 23:00  chk
   2 .\" Initial revision
   3 .\"
   4 .\"
   5 .TH TUNE2FS 8 "@E2FSPROGS_MONTH@ @E2FSPROGS_YEAR@" "E2fsprogs version @E2FSPROGS_VERSION@"
   6 .SH NAME
   7 tune2fs \- adjust tunable filesystem parameters on ext2/ext3/ext4 filesystems
   8 .SH SYNOPSIS
   9 .B tune2fs
  10 [
  11 .B \-l
  12 ]
  13 [
  14 .B \-c
  15 .I max-mount-counts
  16 ]
  17 [
  18 .B \-e
  19 .I errors-behavior
  20 ]
  21 [
  22 .B \-f
  23 ]
  24 [
  25 .B \-i
  26 .I interval-between-checks
  27 ]
  28 [
  29 .B \-I
  30 .I new_inode_size
  31 ]
  32 [
  33 .B \-j
  34 ]
  35 [
  36 .B \-J
  37 .I journal-options
  38 ]
  39 [
  40 .B \-m
  41 .I reserved-blocks-percentage
  42 ]
  43 [
  44 .B \-o
  45 .RI [^]mount-options [,...]
  46 ]
  47 [
  48 .B \-r
  49 .I reserved-blocks-count
  50 ]
  51 [
  52 .B \-u
  53 .I user
  54 ]
  55 [
  56 .B \-g
  57 .I group
  58 ]
  59 [
  60 .B \-C
  61 .I mount-count
  62 ]
  63 [
  64 .B \-E
  65 .I extended-options
  66 ]
  67 [
  68 .B \-L
  69 .I volume-label
  70 ]
  71 [
  72 .B \-M
  73 .I last-mounted-directory
  74 ]
  75 [
  76 .B \-O
  77 .RI [^] feature [,...]
  78 ]
  79 [
  80 .B \-Q
  81 .I quota-options
  82 ]
  83 [
  84 .B \-T
  85 .I time-last-checked
  86 ]
  87 [
  88 .B \-U
  89 .I UUID
  90 ]
  91 [
  92 .B \-z
  93 .I undo_file
  94 ]
  95 device
  96 .SH DESCRIPTION
  97 .B tune2fs
  98 allows the system administrator to adjust various tunable filesystem
  99 parameters on Linux ext2, ext3, or ext4 filesystems.  The current values
 100 of these options can be displayed by using the
 101 .B -l
 102 option to
 103 .BR tune2fs (8)
 104 program, or by using the
 105 .BR dumpe2fs (8)
 106 program.
 107 .PP
 108 The
 109 .I device
 110 specifier can either be a filename (i.e., /dev/sda1), or a LABEL or UUID
 111 specifier: "\fBLABEL=\fIvolume-label\fR" or "\fBUUID=\fIuuid\fR".  (i.e.,
 112 LABEL=home or UUID=e40486c6-84d5-4f2f-b99c-032281799c9d).
 113 .SH OPTIONS
 114 .TP
 115 .BI \-c " max-mount-counts"
 116 Adjust the number of mounts after which the filesystem will be checked by
 117 .BR e2fsck (8).
 118 If
 119 .I max-mount-counts
 120 is the string "random", tune2fs will use a random value between 20 and 40.
 121 If
 122 .I max-mount-counts
 123 is 0 or \-1, the number of times the filesystem is mounted will be disregarded
 124 by
 125 .BR e2fsck (8)
 126 and the kernel.
 127 .sp
 128 Staggering the mount-counts at which filesystems are forcibly
 129 checked will avoid all filesystems being checked at one time
 130 when using journaled filesystems.
 131 .sp
 132 Mount-count-dependent checking is disabled by default to avoid
 133 unanticipated long reboots while e2fsck does its work.  If you
 134 are concerned about file system corruptions caused by potential hardware
 135 problems of kernel bugs, a better solution than mount-count-dependent
 136 checking is to use the
 137 .BR e2scrub (8)
 138 program.  This does require placing the file system on an LVM volume,
 139 however.
 140 .TP
 141 .BI \-C " mount-count"
 142 Set the number of times the filesystem has been mounted.
 143 If set to a greater value than the max-mount-counts parameter
 144 set by the
 145 .B \-c
 146 option,
 147 .BR e2fsck (8)
 148 will check the filesystem at the next reboot.
 149 .TP
 150 .BI \-e " error-behavior"
 151 Change the behavior of the kernel code when errors are detected.
 152 In all cases, a filesystem error will cause
 153 .BR e2fsck (8)
 154 to check the filesystem on the next boot.
 155 .I error-behavior
 156 can be one of the following:
 157 .RS 1.2i
 158 .TP 1.2i
 159 .B continue
 160 Continue normal execution.
 161 .TP
 162 .B remount-ro
 163 Remount filesystem read-only.
 164 .TP
 165 .B panic
 166 Cause a kernel panic.
 167 .RE
 168 .TP
 169 .BI \-E " extended-options"
 170 Set extended options for the filesystem.  Extended options are comma
 171 separated, and may take an argument using the equals ('=') sign.
 172 The following extended options are supported:
 173 .RS 1.2i
 174 .TP
 175 .B clear_mmp
 176 Reset the MMP block (if any) back to the clean state.  Use only if
 177 absolutely certain the device is not currently mounted or being
 178 fscked, or major filesystem corruption can result.  Needs '-f'.
 179 .TP
 180 .BI mmp_update_interval= interval
 181 Adjust the initial MMP update interval to
 182 .I interval
 183 seconds.  Specifying an
 184 .I interval
 185 of 0 means to use the default interval.  The specified interval must
 186 be less than 300 seconds.  Requires that the
 187 .B mmp
 188 feature be enabled.
 189 .TP
 190 .BI stride= stride-size
 191 Configure the filesystem for a RAID array with
 192 .I stride-size
 193 filesystem blocks. This is the number of blocks read or written to disk
 194 before moving to next disk. This mostly affects placement of filesystem
 195 metadata like bitmaps at
 196 .BR mke2fs (2)
 197 time to avoid placing them on a single disk, which can hurt the performance.
 198 It may also be used by block allocator.
 199 .TP
 200 .BI stripe_width= stripe-width
 201 Configure the filesystem for a RAID array with
 202 .I stripe-width
 203 filesystem blocks per stripe. This is typically be stride-size * N, where
 204 N is the number of data disks in the RAID (e.g. RAID 5 N+1, RAID 6 N+2).
 205 This allows the block allocator to prevent read-modify-write of the
 206 parity in a RAID stripe if possible when the data is written.
 207 .TP
 208 .BI hash_alg= hash-alg
 209 Set the default hash algorithm used for filesystems with hashed b-tree
 210 directories.  Valid algorithms accepted are:
 211 .IR legacy ,
 212 .IR half_md4 ,
 213 and
 214 .IR tea .
 215 .TP
 216 .BI encoding= encoding-name
 217 Enable the
 218 .I casefold
 219 feature in the super block and set
 220 .I encoding-name
 221 as the encoding to be used.  If
 222 .I encoding-name
 223 is not specified, utf8 is used. The encoding cannot be altered if casefold
 224 was previously enabled.
 225 .TP
 226 .BI encoding_flags= encoding-flags
 227 Define parameters for file name character encoding operations.  If a
 228 flag is not changed using this parameter, its default value is used.
 229 .I encoding-flags
 230 should be a comma-separated lists of flags to be enabled.  The flags cannot be
 231 altered if casefold was previously enabled.
 232
 233 The only flag that can be set right now is
 234 .I strict
 235 which means that invalid strings should be rejected by the file system.
 236 In the default configuration, the
 237 .I strict
 238 flag is disabled.
 239 .TP
 240 .BI mount_opts= mount_option_string
 241 Set a set of default mount options which will be used when the file
 242 system is mounted.  Unlike the bitmask-based default mount options which
 243 can be specified with the
 244 .B -o
 245 option,
 246 .I mount_option_string
 247 is an arbitrary string with a maximum length of 63 bytes, which is
 248 stored in the superblock.
 249 .IP
 250 The ext4 file system driver will first apply
 251 the bitmask-based default options, and then parse the
 252 .IR mount_option_string ,
 253 before parsing the mount options passed from the
 254 .BR mount (8)
 255 program.
 256 .IP
 257 This superblock setting is only honored in 2.6.35+ kernels;
 258 and not at all by the ext2 and ext3 file system drivers.
 259 .TP
 260 .B force_fsck
 261 Set a flag in the filesystem superblock indicating that errors have been found.
 262 This will force fsck to run at the next mount.
 263 .TP
 264 .B test_fs
 265 Set a flag in the filesystem superblock indicating that it may be
 266 mounted using experimental kernel code, such as the ext4dev filesystem.
 267 .TP
 268 .B ^test_fs
 269 Clear the test_fs flag, indicating the filesystem should only be mounted
 270 using production-level filesystem code.
 271 .RE
 272 .TP
 273 .B \-f
 274 Force the tune2fs operation to complete even in the face of errors.  This
 275 option is useful when removing the
 276 .B has_journal
 277 filesystem feature from a filesystem which has
 278 an external journal (or is corrupted
 279 such that it appears to have an external journal), but that
 280 external journal is not available.   If the filesystem appears to require
 281 journal replay, the
 282 .B \-f
 283 flag must be specified twice to proceed.
 284 .sp
 285 .B WARNING:
 286 Removing an external journal from a filesystem which was not cleanly unmounted
 287 without first replaying the external journal can result in
 288 severe data loss and filesystem corruption.
 289 .TP
 290 .BI \-g " group"
 291 Set the group which can use the reserved filesystem blocks.
 292 The
 293 .I group
 294 parameter can be a numerical gid or a group name.  If a group name is given,
 295 it is converted to a numerical gid before it is stored in the superblock.
 296 .TP
 297 .B \-i " \fIinterval-between-checks\fR[\fBd\fR|\fBm\fR|\fBw\fR]"
 298 Adjust the maximal time between two filesystem checks.
 299 No suffix or
 300 .B d
 301 will interpret the number
 302 .I interval-between-checks
 303 as days,
 304 .B m
 305 as months, and
 306 .B w
 307 as weeks.  A value of zero will disable the time-dependent checking.
 308 .sp
 309 There are pros and cons to disabling these periodic checks; see the
 310 discussion under the
 311 .B \-c
 312 (mount-count-dependent check) option for details.
 313 .TP
 314 .B \-I
 315 Change the inode size used by the file system.   This requires rewriting
 316 the inode table, so it requires that the file system is checked for
 317 consistency first using
 318 .BR e2fsck (8).
 319 This operation can also take a while and the file system can be
 320 corrupted and data lost if it is interrupted while in the middle of
 321 converting the file system.  Backing up the file system before changing
 322 inode size is recommended.
 323 .IP
 324 File systems with an inode size of 128 bytes do not support timestamps
 325 beyond January 19, 2038.  Inodes which are 256 bytes or larger will
 326 support extended timestamps, project id's, and the ability to store some
 327 extended attributes in the inode table for improved performance.
 328 .TP
 329 .B \-j
 330 Add an ext3 journal to the filesystem.  If the
 331 .B \-J
 332 option is not specified, the default journal parameters will be used to create
 333 an appropriately sized journal (given the size of the filesystem)
 334 stored within the filesystem.  Note that you must be using a kernel
 335 which has ext3 support in order to actually make use of the journal.
 336 .IP
 337 If this option is used to create a journal on a mounted filesystem, an
 338 immutable file,
 339 .BR .journal ,
 340 will be created in the top-level directory of the filesystem, as it is
 341 the only safe way to create the journal inode while the filesystem is
 342 mounted.  While the ext3 journal is visible, it is not safe to
 343 delete it, or modify it while the filesystem is mounted; for this
 344 reason the file is marked immutable.
 345 While checking unmounted filesystems,
 346 .BR e2fsck (8)
 347 will automatically move
 348 .B .journal
 349 files to the invisible, reserved journal inode.  For all filesystems
 350 except for the root filesystem,  this should happen automatically and
 351 naturally during the next reboot cycle.  Since the root filesystem is
 352 mounted read-only,
 353 .BR e2fsck (8)
 354 must be run from a rescue floppy in order to effect this transition.
 355 .IP
 356 On some distributions, such as Debian, if an initial ramdisk is used,
 357 the initrd scripts will automatically convert an ext2 root filesystem
 358 to ext3 if the
 359 .B /etc/fstab
 360 file specifies the ext3 filesystem for the root filesystem in order to
 361 avoid requiring the use of a rescue floppy to add an ext3 journal to
 362 the root filesystem.
 363 .TP
 364 .BR \-J " journal-options"
 365 Override the default ext3 journal parameters. Journal options are comma
 366 separated, and may take an argument using the equals ('=')  sign.
 367 The following journal options are supported:
 368 .RS 1.2i
 369 .TP
 370 .BI size= journal-size
 371 Create a journal stored in the filesystem of size
 372 .I journal-size
 373 megabytes.   The size of the journal must be at least 1024 filesystem blocks
 374 (i.e., 1MB if using 1k blocks, 4MB if using 4k blocks, etc.)
 375 and may be no more than 10,240,000 filesystem blocks.
 376 There must be enough free space in the filesystem to create a journal of
 377 that size.
 378 .TP
 379 .BI fast_commit_size= fast-commit-size
 380 Create an additional fast commit journal area of size
 381 .I fast-commit-size
 382 kilobytes.
 383 This option is only valid if
 384 .B fast_commit
 385 feature is enabled
 386 on the file system. If this option is not specified and if
 387 .B fast_commit
 388 feature is turned on, fast commit area size defaults to
 389 .I journal-size
 390 / 64 megabytes. The total size of the journal with
 391 .B fast_commit
 392 feature set is
 393 .I journal-size
 394 + (
 395 .I fast-commit-size
 396 * 1024) megabytes. The total journal size may be no more than
 397 10,240,000 filesystem blocks or half the total file system size
 398 (whichever is smaller).
 399 .TP
 400 .BI location =journal-location
 401 Specify the location of the journal.  The argument
 402 .I journal-location
 403 can either be specified as a block number, or if the number has a units
 404 suffix (e.g., 'M', 'G', etc.) interpret it as the offset from the
 405 beginning of the file system.
 406 @JDEV@.TP
 407 @JDEV@.BI device= external-journal
 408 @JDEV@Attach the filesystem to the journal block device located on
 409 @JDEV@.IR external-journal .
 410 @JDEV@The external
 411 @JDEV@journal must have been already created using the command
 412 @JDEV@.IP
 413 @JDEV@.B mke2fs -O journal_dev
 414 @JDEV@.I external-journal
 415 @JDEV@.IP
 416 @JDEV@Note that
 417 @JDEV@.I external-journal
 418 @JDEV@must be formatted with the same block
 419 @JDEV@size as filesystems which will be using it.
 420 @JDEV@In addition, while there is support for attaching
 421 @JDEV@multiple filesystems to a single external journal,
 422 @JDEV@the Linux kernel and
 423 @JDEV@.BR e2fsck (8)
 424 @JDEV@do not currently support shared external journals yet.
 425 @JDEV@.IP
 426 @JDEV@Instead of specifying a device name directly,
 427 @JDEV@.I external-journal
 428 @JDEV@can also be specified by either
 429 @JDEV@.BI LABEL= label
 430 @JDEV@or
 431 @JDEV@.BI UUID= UUID
 432 @JDEV@to locate the external journal by either the volume label or UUID
 433 @JDEV@stored in the ext2 superblock at the start of the journal.  Use
 434 @JDEV@.BR dumpe2fs (8)
 435 @JDEV@to display a journal device's volume label and UUID.  See also the
 436 @JDEV@.B -L
 437 @JDEV@option of
 438 @JDEV@.BR tune2fs (8).
 439 .RE
 440 @JDEV@.IP
 441 @JDEV@Only one of the
 442 @JDEV@.BR size " or " device
 443 @JDEV@options can be given for a filesystem.
 444 .TP
 445 .B \-l
 446 List the contents of the filesystem superblock, including the current
 447 values of the parameters that can be set via this program.
 448 .TP
 449 .BI \-L " volume-label"
 450 Set the volume label of the filesystem.
 451 Ext2 filesystem labels can be at most 16 characters long; if
 452 .I volume-label
 453 is longer than 16 characters,
 454 .B tune2fs
 455 will truncate it and print a warning.  The volume label can be used
 456 by
 457 .BR mount (8),
 458 .BR fsck (8),
 459 and
 460 .BR /etc/fstab (5)
 461 (and possibly others) by specifying
 462 .BI LABEL= volume-label
 463 instead of a block special device name like
 464 .BR /dev/hda5 .
 465 .TP
 466 .BI \-m " reserved-blocks-percentage"
 467 Set the percentage of the filesystem which may only be allocated
 468 by privileged processes.   Reserving some number of filesystem blocks
 469 for use by privileged processes is done
 470 to avoid filesystem fragmentation, and to allow system
 471 daemons, such as
 472 .BR syslogd (8),
 473 to continue to function correctly after non-privileged processes are
 474 prevented from writing to the filesystem.  Normally, the default percentage
 475 of reserved blocks is 5%.
 476 .TP
 477 .BI \-M " last-mounted-directory"
 478 Set the last-mounted directory for the filesystem.
 479 .TP
 480 .BR \-o " [^]\fImount-option\fR[,...]"
 481 Set or clear the indicated default mount options in the filesystem.
 482 Default mount options can be overridden by mount options specified
 483 either in
 484 .BR /etc/fstab (5)
 485 or on the command line arguments to
 486 .BR mount (8).
 487 Older kernels may not support this feature; in particular,
 488 kernels which predate 2.4.20 will almost certainly ignore the
 489 default mount options field in the superblock.
 490 .IP
 491 More than one mount option can be cleared or set by separating
 492 features with commas.  Mount options prefixed with a
 493 caret character ('^') will be cleared in the filesystem's superblock;
 494 mount options without a prefix character or prefixed with a plus
 495 character ('+') will be added to the filesystem.
 496 .IP
 497 The following mount options can be set or cleared using
 498 .BR tune2fs :
 499 .RS 1.2i
 500 .TP
 501 .B debug
 502 Enable debugging code for this filesystem.
 503 .TP
 504 .B bsdgroups
 505 Emulate BSD behavior when creating new files: they will take the group-id
 506 of the directory in which they were created.  The standard System V behavior
 507 is the default, where newly created files take on the fsgid of the current
 508 process, unless the directory has the setgid bit set, in which case it takes
 509 the gid from the parent directory, and also gets the setgid bit set if it is
 510 a directory itself.
 511 .TP
 512 .B user_xattr
 513 Enable user-specified extended attributes.
 514 .TP
 515 .B acl
 516 Enable Posix Access Control Lists.
 517 .TP
 518 .B uid16
 519 Disables 32-bit UIDs and GIDs.  This is for interoperability with
 520 older kernels which only store and expect 16-bit values.
 521 .TP
 522 .B journal_data
 523 When the filesystem is mounted with journalling enabled, all data
 524 (not just metadata) is committed into the journal prior to being written
 525 into the main filesystem.
 526 .TP
 527 .B journal_data_ordered
 528 When the filesystem is mounted with journalling enabled, all data is forced
 529 directly out to the main file system prior to its metadata being committed
 530 to the journal.
 531 .TP
 532 .B journal_data_writeback
 533 When the filesystem is mounted with journalling enabled, data may be
 534 written into the main filesystem after its metadata has been committed
 535 to the journal.  This may increase throughput, however, it may allow old
 536 data to appear in files after a crash and journal recovery.
 537 .TP
 538 .B nobarrier
 539 The file system will be mounted with barrier operations in the journal
 540 disabled.  (This option is currently only supported by the ext4 file
 541 system driver in 2.6.35+ kernels.)
 542 .TP
 543 .B block_validity
 544 The file system will be mounted with the block_validity option enabled,
 545 which causes extra checks to be performed after reading or writing from
 546 the file system.  This prevents corrupted metadata blocks from causing
 547 file system damage by overwriting parts of the inode table or block
 548 group descriptors.  This comes at the cost of increased memory and CPU
 549 overhead, so it is enabled only for debugging purposes.  (This option is
 550 currently only supported by the ext4 file system driver in 2.6.35+
 551 kernels.)
 552 .TP
 553 .B discard
 554 The file system will be mounted with the discard mount option.  This will
 555 cause the file system driver to attempt to use the trim/discard feature
 556 of some storage devices (such as SSD's and thin-provisioned drives
 557 available in some enterprise storage arrays) to inform the storage
 558 device that blocks belonging to deleted files can be reused for other
 559 purposes.  (This option is currently only supported by the ext4 file
 560 system driver in 2.6.35+ kernels.)
 561 .TP
 562 .B nodelalloc
 563 The file system will be mounted with the nodelalloc mount option.  This
 564 will disable the delayed allocation feature.  (This option is currently
 565 only supported by the ext4 file system driver in 2.6.35+ kernels.)
 566 .RE
 567 .TP
 568 .BR \-O " [^]\fIfeature\fR[,...]"
 569 Set or clear the indicated filesystem features (options) in the filesystem.
 570 More than one filesystem feature can be cleared or set by separating
 571 features with commas.  Filesystem features prefixed with a
 572 caret character ('^') will be cleared in the filesystem's superblock;
 573 filesystem features without a prefix character or prefixed with a plus
 574 character ('+') will be added to the filesystem.  For a detailed
 575 description of the file system features, please see the man page
 576 .BR ext4 (5).
 577 .IP
 578 The following filesystem features can be set or cleared using
 579 .BR tune2fs :
 580 .RS 1.2i
 581 .TP
 582 .B 64bit
 583 Enable the file system to be larger than 2^32 blocks.
 584 .TP
 585 .B casefold
 586 Enable support for file system level casefolding.
 587 .B Tune2fs
 588 currently only supports setting this filesystem feature.
 589 .TP
 590 .B dir_index
 591 Use hashed b-trees to speed up lookups for large directories.
 592 .TP
 593 .B dir_nlink
 594 Allow more than 65000 subdirectories per directory.
 595 .TP
 596 .B ea_inode
 597 Allow the value of each extended attribute to be placed in the data blocks of a
 598 separate inode if necessary, increasing the limit on the size and number of
 599 extended attributes per file.
 600 .B Tune2fs
 601 currently only supports setting this filesystem feature.
 602 .TP
 603 .B encrypt
 604 Enable support for file system level encryption.
 605 .B Tune2fs
 606 currently only supports setting this filesystem feature.
 607 .TP
 608 .B extent
 609 Enable the use of extent trees to store the location of data blocks in inodes.
 610 .B Tune2fs
 611 currently only supports setting this filesystem feature.
 612 .TP
 613 .B extra_isize
 614 Enable the extended inode fields used by ext4.
 615 .TP
 616 .B filetype
 617 Store file type information in directory entries.
 618 .TP
 619 .B flex_bg
 620 Allow bitmaps and inode tables for a block group to be placed
 621 anywhere on the storage media.  \fBTune2fs\fR will not reorganize
 622 the location of the inode tables and allocation bitmaps, as
 623 .BR mke2fs (8)
 624 will do when it creates a freshly formatted file system with
 625 .B flex_bg
 626 enabled.
 627 .TP
 628 .B has_journal
 629 Use a journal to ensure filesystem consistency even across unclean shutdowns.
 630 Setting the filesystem feature is equivalent to using the
 631 .B \-j
 632 option.
 633 .TP
 634 .TP
 635 .B fast_commit
 636 Enable fast commit journaling feature to improve fsync latency.
 637 .TP
 638 .B large_dir
 639 Increase the limit on the number of files per directory.
 640 .B Tune2fs
 641 currently only supports setting this filesystem feature.
 642 .TP
 643 .B huge_file
 644 Support files larger than 2 terabytes in size.
 645 .TP
 646 .B large_file
 647 Filesystem can contain files that are greater than 2GB.
 648 .TP
 649 .B metadata_csum
 650 Store a checksum to protect the contents in each metadata block.
 651 .TP
 652 .B metadata_csum_seed
 653 Allow the filesystem to store the metadata checksum seed in the
 654 superblock, enabling the administrator to change the UUID of a filesystem
 655 using the
 656 .B metadata_csum
 657 feature while it is mounted.
 658 .TP
 659 .B mmp
 660 Enable or disable multiple mount protection (MMP) feature.
 661 .TP
 662 .B project
 663 Enable project ID tracking.  This is used for project quota tracking.
 664 .TP
 665 .B quota
 666 Enable internal file system quota inodes.
 667 .TP
 668 .B read-only
 669 Force the kernel to mount the file system read-only.
 670 .TP
 671 .B resize_inode
 672 Reserve space so the block group descriptor table may grow in the
 673 future.
 674 .B Tune2fs
 675 only supports clearing this filesystem feature.
 676 .TP
 677 .B sparse_super
 678 Limit the number of backup superblocks to save space on large filesystems.
 679 .B Tune2fs
 680 currently only supports setting this filesystem feature.
 681 .TP
 682 .B stable_inodes
 683 Prevent the filesystem from being shrunk or having its UUID changed, in order to
 684 allow the use of specialized encryption settings that make use of the inode
 685 numbers and UUID.
 686 .B Tune2fs
 687 currently only supports setting this filesystem feature.
 688 .TP
 689 .B uninit_bg
 690 Allow the kernel to initialize bitmaps and inode tables lazily, and to
 691 keep a high watermark for the unused inodes in a filesystem, to reduce
 692 .BR e2fsck (8)
 693 time.  The first e2fsck run after enabling this feature will take the
 694 full time, but subsequent e2fsck runs will take only a fraction of the
 695 original time, depending on how full the file system is.
 696 .TP
 697 .B verity
 698 Enable support for verity protected files.
 699 .B Tune2fs
 700 currently only supports setting this filesystem feature.
 701 .RE
 702 .IP
 703 After setting or clearing
 704 .BR sparse_super ,
 705 .BR uninit_bg ,
 706 .BR filetype ,
 707 or
 708 .B resize_inode
 709 filesystem features,
 710 the file system may require being checked using
 711 .BR e2fsck (8)
 712 to return the filesystem to a consistent state.
 713 .B Tune2fs
 714 will print a message requesting that the system administrator run
 715 .BR e2fsck (8)
 716 if necessary.  After setting the
 717 .B dir_index
 718 feature,
 719 .B e2fsck -D
 720 can be run to convert existing directories to the hashed B-tree format.
 721 Enabling certain filesystem features may prevent the filesystem from being
 722 mounted by kernels which do not support those features.  In particular, the
 723 .B uninit_bg
 724 and
 725 .B flex_bg
 726 features are only supported by the ext4 filesystem.
 727 .TP
 728 .BI \-r " reserved-blocks-count"
 729 Set the number of reserved filesystem blocks.
 730 .TP
 731 .BI \-Q " quota-options"
 732 Sets 'quota' feature on the superblock and works on the quota files for the
 733 given quota type. Quota options could be one or more of the following:
 734 .RS 1.2i
 735 .TP
 736 .B [^]usrquota
 737 Sets/clears user quota inode in the superblock.
 738 .TP
 739 .B [^]grpquota
 740 Sets/clears group quota inode in the superblock.
 741 .TP
 742 .B [^]prjquota
 743 Sets/clears project quota inode in the superblock.
 744 .RE
 745 .TP
 746 .BI \-T " time-last-checked"
 747 Set the time the filesystem was last checked using
 748 .BR  e2fsck .
 749 The time is interpreted using the current (local) timezone.
 750 This can be useful in scripts which use a Logical Volume Manager to make
 751 a consistent snapshot of a filesystem, and then check the filesystem
 752 during off hours to make sure it hasn't been corrupted due to
 753 hardware problems, etc.  If the filesystem was clean, then this option can
 754 be used to set the last checked time on the original filesystem.  The format
 755 of
 756 .I time-last-checked
 757 is the international date format, with an optional time specifier, i.e.
 758 YYYYMMDD[HH[MM[SS]]].   The keyword
 759 .B now
 760 is also accepted, in which case the last checked time will be set to the
 761 current time.
 762 .TP
 763 .BI \-u " user"
 764 Set the user who can use the reserved filesystem blocks.
 765 .I user
 766 can be a numerical uid or a user name.  If a user name is given, it
 767 is converted to a numerical uid before it is stored in the superblock.
 768 .TP
 769 .BI \-U " UUID"
 770 Set the universally unique identifier (UUID) of the filesystem to
 771 .IR UUID .
 772 The format of the UUID is a series of hex digits separated by hyphens,
 773 like this:
 774 "c1b9d5a2-f162-11cf-9ece-0020afc76f16".
 775 The
 776 .I UUID
 777 parameter may also be one of the following:
 778 .RS 1.2i
 779 .TP
 780 .I clear
 781 clear the filesystem UUID
 782 .TP
 783 .I random
 784 generate a new randomly-generated UUID
 785 .TP
 786 .I time
 787 generate a new time-based UUID
 788 .RE
 789 .IP
 790 The UUID may be used by
 791 .BR mount (8),
 792 .BR fsck (8),
 793 and
 794 .BR /etc/fstab (5)
 795 (and possibly others) by specifying
 796 .BI UUID= uuid
 797 instead of a block special device name like
 798 .BR /dev/hda1 .
 799 .IP
 800 See
 801 .BR uuidgen (8)
 802 for more information.
 803 If the system does not have a good random number generator such as
 804 .I /dev/random
 805 or
 806 .IR /dev/urandom ,
 807 .B tune2fs
 808 will automatically use a time-based UUID instead of a randomly-generated UUID.
 809 .TP
 810 .BI \-z " undo_file"
 811 Before overwriting a file system block, write the old contents of the block to
 812 an undo file.  This undo file can be used with e2undo(8) to restore the old
 813 contents of the file system should something go wrong.  If the empty string is
 814 passed as the undo_file argument, the undo file will be written to a file named
 815 tune2fs-\fIdevice\fR.e2undo in the directory specified via the
 816 \fIE2FSPROGS_UNDO_DIR\fR environment variable.
 817
 818 WARNING: The undo file cannot be used to recover from a power or system crash.
 819 .SH BUGS
 820 We haven't found any bugs yet.  That doesn't mean there aren't any...
 821 .SH AUTHOR
 822 .B tune2fs
 823 was written by Remy Card <Remy.Card@linux.org>.  It is currently being
 824 maintained by Theodore Ts'o <tytso@alum.mit.edu>.
 825 .B tune2fs
 826 uses the ext2fs library written by Theodore Ts'o <tytso@mit.edu>.
 827 This manual page was written by Christian Kuhtz <chk@data-hh.Hanse.DE>.
 828 Time-dependent checking was added by Uwe Ohse <uwe@tirka.gun.de>.
 829 .SH AVAILABILITY
 830 .B tune2fs
 831 is part of the e2fsprogs package and is available from
 832 http://e2fsprogs.sourceforge.net.
 833 .SH SEE ALSO
 834 .BR debugfs (8),
 835 .BR dumpe2fs (8),
 836 .BR e2fsck (8),
 837 .BR mke2fs (8),
 838 .BR ext4 (5)