Theodore Ts'o | 3839e65 | 1997-04-26 13:21:57 +0000 | [diff] [blame] | 1 | .\" Revision 1.0 93/06/3 23:00 chk |
| 2 | .\" Initial revision |
| 3 | .\" |
| 4 | .\" |
Theodore Ts'o | 74becf3 | 1997-04-26 14:37:06 +0000 | [diff] [blame] | 5 | .TH TUNE2FS 8 "@E2FSPROGS_MONTH@ @E2FSPROGS_YEAR@" "E2fsprogs version @E2FSPROGS_VERSION@" |
Theodore Ts'o | 3839e65 | 1997-04-26 13:21:57 +0000 | [diff] [blame] | 6 | .SH NAME |
| 7 | tune2fs \- adjust tunable filesystem parameters on second extended filesystems |
| 8 | .SH SYNOPSIS |
| 9 | .B tune2fs |
| 10 | [ |
Theodore Ts'o | f3db356 | 1997-04-26 13:34:30 +0000 | [diff] [blame] | 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 | [ |
Theodore Ts'o | 521e368 | 1997-04-29 17:48:10 +0000 | [diff] [blame] | 34 | .B -s sparse-super-flag |
| 35 | ] |
| 36 | [ |
Theodore Ts'o | f3db356 | 1997-04-26 13:34:30 +0000 | [diff] [blame] | 37 | .B -u |
| 38 | .I user |
| 39 | ] |
| 40 | [ |
| 41 | .B -g |
| 42 | .I group |
Theodore Ts'o | 3839e65 | 1997-04-26 13:21:57 +0000 | [diff] [blame] | 43 | ] |
Theodore Ts'o | 1e3472c | 1997-04-29 14:53:37 +0000 | [diff] [blame] | 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 | ] |
Theodore Ts'o | 3839e65 | 1997-04-26 13:21:57 +0000 | [diff] [blame] | 60 | device |
| 61 | .SH DESCRIPTION |
| 62 | .BI tune2fs |
| 63 | adjusts tunable filesystem parameters on a Linux second extended filesystem. |
| 64 | .PP |
Theodore Ts'o | 583ccdc | 1997-05-09 03:06:31 +0000 | [diff] [blame] | 65 | .B Never use tune2fs to change parameters of a read/write mounted filesystem! |
Theodore Ts'o | 3839e65 | 1997-04-26 13:21:57 +0000 | [diff] [blame] | 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 |
Theodore Ts'o | 583ccdc | 1997-05-09 03:06:31 +0000 | [diff] [blame] | 72 | .I -e error-behavior |
Theodore Ts'o | 3839e65 | 1997-04-26 13:21:57 +0000 | [diff] [blame] | 73 | change the behavior of the kernel code when errors are detected. |
Theodore Ts'o | 583ccdc | 1997-05-09 03:06:31 +0000 | [diff] [blame] | 74 | .I error-behavior |
| 75 | can be one of the following: |
Theodore Ts'o | 3839e65 | 1997-04-26 13:21:57 +0000 | [diff] [blame] | 76 | .br |
| 77 | \ continue\ \ Continue normal execution. |
| 78 | .br |
| 79 | \ remount-ro\ Remount the filesystem read-only. |
| 80 | .br |
Theodore Ts'o | 583ccdc | 1997-05-09 03:06:31 +0000 | [diff] [blame] | 81 | \ panic\ \ Cause a kernel panic. |
Theodore Ts'o | 3839e65 | 1997-04-26 13:21:57 +0000 | [diff] [blame] | 82 | .TP |
Theodore Ts'o | f3db356 | 1997-04-26 13:34:30 +0000 | [diff] [blame] | 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] |
Theodore Ts'o | 3839e65 | 1997-04-26 13:21:57 +0000 | [diff] [blame] | 90 | adjust the maximal time between two filesystem checks. |
Theodore Ts'o | f3db356 | 1997-04-26 13:34:30 +0000 | [diff] [blame] | 91 | No postfix or `d' result in days, `m' in months, and `w' in weeks. |
Theodore Ts'o | 3839e65 | 1997-04-26 13:21:57 +0000 | [diff] [blame] | 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. |
Theodore Ts'o | f3db356 | 1997-04-26 13:34:30 +0000 | [diff] [blame] | 99 | .TP |
| 100 | .I -r reserved-blocks-count |
| 101 | adjust the reserved blocks count on the given device. |
| 102 | .TP |
Theodore Ts'o | 521e368 | 1997-04-29 17:48:10 +0000 | [diff] [blame] | 103 | .I -s sparse_super_flag |
Theodore Ts'o | 583ccdc | 1997-05-09 03:06:31 +0000 | [diff] [blame] | 104 | set or reset the sparse_superblock flag. The sparse_superblock feature |
Theodore Ts'o | 521e368 | 1997-04-29 17:48:10 +0000 | [diff] [blame] | 105 | saves space on really big filesystems. |
Theodore Ts'o | a29f4d3 | 1997-04-29 21:26:48 +0000 | [diff] [blame] | 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! |
Theodore Ts'o | 521e368 | 1997-04-29 17:48:10 +0000 | [diff] [blame] | 110 | .TP |
Theodore Ts'o | f3db356 | 1997-04-26 13:34:30 +0000 | [diff] [blame] | 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. |
Theodore Ts'o | 1e3472c | 1997-04-29 14:53:37 +0000 | [diff] [blame] | 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 | .TP |
| 122 | .I -M last-mounted-directory |
Theodore Ts'o | 583ccdc | 1997-05-09 03:06:31 +0000 | [diff] [blame] | 123 | set the last-mounted directory for the filesystem. |
Theodore Ts'o | 1e3472c | 1997-04-29 14:53:37 +0000 | [diff] [blame] | 124 | .TP |
| 125 | .I -U UUID |
| 126 | set the UUID of the filesystem. A sample UUID looks like this: |
| 127 | "c1b9d5a2-f162-11cf-9ece-0020afc76f16". The uuid may also be "null", |
| 128 | which will set the filesystem UUID to the null UUID. The uuid may also |
| 129 | be "random", which will generate a new random UUID for the filesystem. |
Theodore Ts'o | 3839e65 | 1997-04-26 13:21:57 +0000 | [diff] [blame] | 130 | .PP |
| 131 | .SH BUGS |
Theodore Ts'o | 583ccdc | 1997-05-09 03:06:31 +0000 | [diff] [blame] | 132 | We haven't found any bugs yet. Perhaps there are bugs but it's unlikely. |
Theodore Ts'o | 3839e65 | 1997-04-26 13:21:57 +0000 | [diff] [blame] | 133 | .PP |
| 134 | .SH WARNING |
Theodore Ts'o | 583ccdc | 1997-05-09 03:06:31 +0000 | [diff] [blame] | 135 | .B Use this utility at your own risk. You're modifying a filesystem! |
Theodore Ts'o | 3839e65 | 1997-04-26 13:21:57 +0000 | [diff] [blame] | 136 | .SH AUTHOR |
| 137 | .B tune2fs |
Theodore Ts'o | 583ccdc | 1997-05-09 03:06:31 +0000 | [diff] [blame] | 138 | was written by Remy Card <card@masi.ibp.fr>, the developer and maintainer |
Theodore Ts'o | 3839e65 | 1997-04-26 13:21:57 +0000 | [diff] [blame] | 139 | of the ext2 fs. |
| 140 | .br |
| 141 | .B tune2fs |
Theodore Ts'o | a418d3a | 1997-04-26 14:00:26 +0000 | [diff] [blame] | 142 | uses the ext2fs library written by Theodore Ts'o <tytso@mit.edu>. |
Theodore Ts'o | 3839e65 | 1997-04-26 13:21:57 +0000 | [diff] [blame] | 143 | .br |
| 144 | This manual page was written by Christian Kuhtz <chk@data-hh.Hanse.DE>. |
| 145 | .br |
| 146 | Timedependent checking was added by Uwe Ohse <uwe@tirka.gun.de>. |
| 147 | .SH AVAILABILITY |
| 148 | .B tune2fs |
Theodore Ts'o | f3db356 | 1997-04-26 13:34:30 +0000 | [diff] [blame] | 149 | is available for anonymous ftp from ftp.ibp.fr and tsx-11.mit.edu in |
| 150 | /pub/linux/packages/ext2fs. |
Theodore Ts'o | 3839e65 | 1997-04-26 13:21:57 +0000 | [diff] [blame] | 151 | .SH SEE ALSO |
| 152 | .BR dumpe2fs (8), |
| 153 | .BR e2fsck (8), |
| 154 | .BR mke2fs (8) |