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