Whamcloud - gitweb
9b927112ac552bfb83cdba5b68845177c95b409c
[tools/e2fsprogs.git] / 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 -u
35 .I user
36 ]
37 [
38 .B -g
39 .I group
40 ]
41 [
42 .B -C
43 .I mount-count
44 ]
45 [
46 .B -L
47 .I volume-name
48 ]
49 [
50 .B -M
51 .I last-mounted-directory
52 ]
53 [
54 .B -U
55 .I UUID
56 ]
57 device
58 .SH DESCRIPTION
59 .BI tune2fs
60 adjusts tunable filesystem parameters on a Linux second extended filesystem.
61 .PP
62 .B Never use tune2fs on a read/write mounted filesystem to change parameters!
63 .PP
64 .SH OPTIONS
65 .TP
66 .I -c max-mount-counts
67 adjust the maximal mounts count between two filesystem checks.
68 .TP
69 .I -e errors-behavior
70 change the behavior of the kernel code when errors are detected.
71 .I errors-behavior
72 can be one of the followings:
73 .br
74 \       continue\       \       Continue normal execution.
75 .br
76 \       remount-ro\     Remount the filesystem read-only.
77 .br
78 \       panic\  \       Causes a kernel panic.
79 .TP
80 .I -g group
81 set the user group which can benefit from the reserved blocks.
82 .br
83 .I group
84 can be a numerical gid or a group name.
85 .TP
86 .I -i interval-between-checks[d|m|w]
87 adjust the maximal time between two filesystem checks. 
88 No postfix or `d' result in days, `m' in months, and `w' in weeks.
89 A value of zero will disable the timedependent checking.
90 .TP
91 .I -l
92 list the contents of the filesystem superblock.
93 .TP
94 .I -m reserved-blocks-percentage
95 adjust the reserved blocks percentage on the given device.
96 .TP
97 .I -r reserved-blocks-count
98 adjust the reserved blocks count on the given device.
99 .TP
100 .I -u user
101 set the user who can benefit from the reserved blocks.
102 .I user
103 can be a numerical uid or a user name.
104 .IP
105 .I -C mount-count
106 set the number of times the filesystem has been mounted.
107 .TP
108 .I -L volume-label
109 set the volume label of the filesystem.
110 .TP
111 .I -M last-mounted-directory
112 set the last-mounted direcctory for the filesystem.
113 .TP
114 .I -U UUID
115 set the UUID of the filesystem.  A sample UUID looks like this: 
116 "c1b9d5a2-f162-11cf-9ece-0020afc76f16".  The uuid may also be "null", 
117 which will set the filesystem UUID to the null UUID.  The uuid may also 
118 be "random", which will generate a new random UUID for the filesystem.
119 .PP
120 .SH BUGS
121 We didn't find any bugs yet. Perhaps there are bugs but it's unlikely.
122 .PP
123 .SH WARNING
124 .B Use this utility on your own risk. You're modifying filesystems.
125 .SH AUTHOR
126 .B tune2fs 
127 has been written by Remy Card <card@masi.ibp.fr>, the developer and maintainer
128 of the ext2 fs.
129 .br
130 .B tune2fs
131 uses the ext2fs library written by Theodore Ts'o <tytso@mit.edu>.
132 .br
133 This manual page was written by Christian Kuhtz <chk@data-hh.Hanse.DE>.
134 .br
135 Timedependent checking was added by Uwe Ohse <uwe@tirka.gun.de>.
136 .SH AVAILABILITY
137 .B tune2fs
138 is available for anonymous ftp from ftp.ibp.fr and tsx-11.mit.edu in
139 /pub/linux/packages/ext2fs.
140 .SH SEE ALSO
141 .BR dumpe2fs (8),
142 .BR e2fsck (8),
143 .BR mke2fs (8)