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