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 second extended 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 -i
  23 .I interval-between-checks
  24 ]
  25 [
  26 .B -m
  27 .I reserved-blocks-percentage
  28 ]
  29 [
  30 .B -r
  31 .I reserved-blocks-count
  32 ]
  33 [
  34 .B -s sparse-super-flag
  35 ]
  36 [
  37 .B -u
  38 .I user
  39 ]
  40 [
  41 .B -g
  42 .I group
  43 ]
  44 [
  45 .B -C
  46 .I mount-count
  47 ]
  48 [
  49 .B -L
  50 .I volume-name
  51 ]
  52 [
  53 .B -M
  54 .I last-mounted-directory
  55 ]
  56 [
  57 .B -U
  58 .I UUID
  59 ]
  60 device
  61 .SH DESCRIPTION
  62 .BI tune2fs
  63 adjusts tunable filesystem parameters on a Linux second extended filesystem.
  64 .PP
  65 .B Never use tune2fs to change parameters of a read/write mounted filesystem!
  66 .PP
  67 .SH OPTIONS
  68 .TP
  69 .I -c max-mount-counts
  70 adjust the maximal mounts count between two filesystem checks.
  71 .TP
  72 .I -e error-behavior
  73 change the behavior of the kernel code when errors are detected.
  74 .I error-behavior
  75 can be one of the following:
  76 .br
  77 \       continue\       \       Continue normal execution.
  78 .br
  79 \       remount-ro\     Remount the filesystem read-only.
  80 .br
  81 \       panic\  \       Cause a kernel panic.
  82 .TP
  83 .I -g group
  84 set the user group which can benefit from the reserved blocks.
  85 .br
  86 .I group
  87 can be a numerical gid or a group name.
  88 .TP
  89 .I -i interval-between-checks[d|m|w]
  90 adjust the maximal time between two filesystem checks.
  91 No postfix or `d' result in days, `m' in months, and `w' in weeks.
  92 A value of zero will disable the timedependent checking.
  93 .TP
  94 .I -l
  95 list the contents of the filesystem superblock.
  96 .TP
  97 .I -m reserved-blocks-percentage
  98 adjust the reserved blocks percentage on the given device.
  99 .TP
 100 .I -r reserved-blocks-count
 101 adjust the reserved blocks count on the given device.
 102 .TP
 103 .I -s sparse_super_flag
 104 set or reset the sparse_superblock flag.  The sparse_superblock feature
 105 saves space on really big filesystems.
 106 .B Warning:
 107 The Linux 2.0 kernel does not properly support this feature.  Neither do
 108 all Linux 2.1 kernels; please don't use this unless you know what you're
 109 doing!
 110 .TP
 111 .I -u user
 112 set the user who can benefit from the reserved blocks.
 113 .I user
 114 can be a numerical uid or a user name.
 115 .IP
 116 .I -C mount-count
 117 set the number of times the filesystem has been mounted.
 118 .TP
 119 .I -L volume-label
 120 set the volume label of the filesystem.
 121 Ext2 filesystem labels can be at most 16 characters long; if
 122 .I volume-label
 123 is longer than 16 characters,
 124 .B tune2fs
 125 will truncate it and print a warning message.
 126 .TP
 127 .I -M last-mounted-directory
 128 set the last-mounted directory for the filesystem.
 129 .TP
 130 .I -U UUID
 131 set the UUID of the filesystem.  A sample UUID looks like this:
 132 "c1b9d5a2-f162-11cf-9ece-0020afc76f16".  The uuid may also be "null",
 133 which will set the filesystem UUID to the null UUID.  The uuid may also
 134 be "random", which will generate a new random UUID for the filesystem.
 135 .PP
 136 .SH BUGS
 137 We haven't found any bugs yet. Perhaps there are bugs but it's unlikely.
 138 .PP
 139 .SH WARNING
 140 .B Use this utility at your own risk. You're modifying a filesystem!
 141 .SH AUTHOR
 142 .B tune2fs
 143 was written by Remy Card <card@masi.ibp.fr>, the developer and maintainer
 144 of the ext2 fs.
 145 .br
 146 .B tune2fs
 147 uses the ext2fs library written by Theodore Ts'o <tytso@mit.edu>.
 148 .br
 149 This manual page was written by Christian Kuhtz <chk@data-hh.Hanse.DE>.
 150 .br
 151 Timedependent checking was added by Uwe Ohse <uwe@tirka.gun.de>.
 152 .SH AVAILABILITY
 153 .B tune2fs
 154 is part of the e2fsprogs package and is available for anonymous
 155 ftp from tsx-11.mit.edu in /pub/linux/packages/ext2fs.
 156 .SH SEE ALSO
 157 .BR dumpe2fs (8),
 158 .BR e2fsck (8),
 159 .BR mke2fs (8)