blob: 96139e06ce1b54d5f48ac668fbebd6c0e03cd772 [file] [log] [blame]
Theodore Ts'o3839e651997-04-26 13:21:57 +00001.\" Revision 1.0 93/06/3 23:00 chk
2.\" Initial revision
3.\"
4.\"
Theodore Ts'o74becf31997-04-26 14:37:06 +00005.TH TUNE2FS 8 "@E2FSPROGS_MONTH@ @E2FSPROGS_YEAR@" "E2fsprogs version @E2FSPROGS_VERSION@"
Theodore Ts'o3839e651997-04-26 13:21:57 +00006.SH NAME
7tune2fs \- adjust tunable filesystem parameters on second extended filesystems
8.SH SYNOPSIS
9.B tune2fs
10[
Theodore Ts'of3db3561997-04-26 13:34:30 +000011.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'o521e3681997-04-29 17:48:10 +000034.B -s sparse-super-flag
35]
36[
Theodore Ts'of3db3561997-04-26 13:34:30 +000037.B -u
38.I user
39]
40[
41.B -g
42.I group
Theodore Ts'o3839e651997-04-26 13:21:57 +000043]
Theodore Ts'o1e3472c1997-04-29 14:53:37 +000044[
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'o3839e651997-04-26 13:21:57 +000060device
61.SH DESCRIPTION
62.BI tune2fs
63adjusts tunable filesystem parameters on a Linux second extended filesystem.
64.PP
Theodore Ts'o583ccdc1997-05-09 03:06:31 +000065.B Never use tune2fs to change parameters of a read/write mounted filesystem!
Theodore Ts'o3839e651997-04-26 13:21:57 +000066.PP
67.SH OPTIONS
68.TP
69.I -c max-mount-counts
70adjust the maximal mounts count between two filesystem checks.
71.TP
Theodore Ts'o583ccdc1997-05-09 03:06:31 +000072.I -e error-behavior
Theodore Ts'o3839e651997-04-26 13:21:57 +000073change the behavior of the kernel code when errors are detected.
Theodore Ts'o583ccdc1997-05-09 03:06:31 +000074.I error-behavior
75can be one of the following:
Theodore Ts'o3839e651997-04-26 13:21:57 +000076.br
77\ continue\ \ Continue normal execution.
78.br
79\ remount-ro\ Remount the filesystem read-only.
80.br
Theodore Ts'o583ccdc1997-05-09 03:06:31 +000081\ panic\ \ Cause a kernel panic.
Theodore Ts'o3839e651997-04-26 13:21:57 +000082.TP
Theodore Ts'of3db3561997-04-26 13:34:30 +000083.I -g group
84set the user group which can benefit from the reserved blocks.
85.br
86.I group
87can be a numerical gid or a group name.
88.TP
89.I -i interval-between-checks[d|m|w]
Theodore Ts'o3839e651997-04-26 13:21:57 +000090adjust the maximal time between two filesystem checks.
Theodore Ts'of3db3561997-04-26 13:34:30 +000091No postfix or `d' result in days, `m' in months, and `w' in weeks.
Theodore Ts'o3839e651997-04-26 13:21:57 +000092A value of zero will disable the timedependent checking.
93.TP
94.I -l
95list the contents of the filesystem superblock.
96.TP
97.I -m reserved-blocks-percentage
98adjust the reserved blocks percentage on the given device.
Theodore Ts'of3db3561997-04-26 13:34:30 +000099.TP
100.I -r reserved-blocks-count
101adjust the reserved blocks count on the given device.
102.TP
Theodore Ts'o521e3681997-04-29 17:48:10 +0000103.I -s sparse_super_flag
Theodore Ts'o583ccdc1997-05-09 03:06:31 +0000104set or reset the sparse_superblock flag. The sparse_superblock feature
Theodore Ts'o521e3681997-04-29 17:48:10 +0000105saves space on really big filesystems.
Theodore Ts'oa29f4d31997-04-29 21:26:48 +0000106.B Warning:
107The Linux 2.0 kernel does not properly support this feature. Neither do
108all Linux 2.1 kernels; please don't use this unless you know what you're
109doing!
Theodore Ts'o521e3681997-04-29 17:48:10 +0000110.TP
Theodore Ts'of3db3561997-04-26 13:34:30 +0000111.I -u user
112set the user who can benefit from the reserved blocks.
113.I user
114can be a numerical uid or a user name.
Theodore Ts'o1e3472c1997-04-29 14:53:37 +0000115.IP
116.I -C mount-count
117set the number of times the filesystem has been mounted.
118.TP
119.I -L volume-label
120set the volume label of the filesystem.
121.TP
122.I -M last-mounted-directory
Theodore Ts'o583ccdc1997-05-09 03:06:31 +0000123set the last-mounted directory for the filesystem.
Theodore Ts'o1e3472c1997-04-29 14:53:37 +0000124.TP
125.I -U UUID
126set the UUID of the filesystem. A sample UUID looks like this:
127"c1b9d5a2-f162-11cf-9ece-0020afc76f16". The uuid may also be "null",
128which will set the filesystem UUID to the null UUID. The uuid may also
129be "random", which will generate a new random UUID for the filesystem.
Theodore Ts'o3839e651997-04-26 13:21:57 +0000130.PP
131.SH BUGS
Theodore Ts'o583ccdc1997-05-09 03:06:31 +0000132We haven't found any bugs yet. Perhaps there are bugs but it's unlikely.
Theodore Ts'o3839e651997-04-26 13:21:57 +0000133.PP
134.SH WARNING
Theodore Ts'o583ccdc1997-05-09 03:06:31 +0000135.B Use this utility at your own risk. You're modifying a filesystem!
Theodore Ts'o3839e651997-04-26 13:21:57 +0000136.SH AUTHOR
137.B tune2fs
Theodore Ts'o583ccdc1997-05-09 03:06:31 +0000138was written by Remy Card <card@masi.ibp.fr>, the developer and maintainer
Theodore Ts'o3839e651997-04-26 13:21:57 +0000139of the ext2 fs.
140.br
141.B tune2fs
Theodore Ts'oa418d3a1997-04-26 14:00:26 +0000142uses the ext2fs library written by Theodore Ts'o <tytso@mit.edu>.
Theodore Ts'o3839e651997-04-26 13:21:57 +0000143.br
144This manual page was written by Christian Kuhtz <chk@data-hh.Hanse.DE>.
145.br
146Timedependent checking was added by Uwe Ohse <uwe@tirka.gun.de>.
147.SH AVAILABILITY
148.B tune2fs
Theodore Ts'of3db3561997-04-26 13:34:30 +0000149is available for anonymous ftp from ftp.ibp.fr and tsx-11.mit.edu in
150/pub/linux/packages/ext2fs.
Theodore Ts'o3839e651997-04-26 13:21:57 +0000151.SH SEE ALSO
152.BR dumpe2fs (8),
153.BR e2fsck (8),
154.BR mke2fs (8)