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