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