e2fsprogs/misc/tune2fs.8.in

151 lines
3.2 KiB
Groff

.\" 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 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 -U
.I UUID
]
device
.SH DESCRIPTION
.BI tune2fs
adjusts tunable filesystem parameters on a Linux second extended filesystem.
.PP
.B Never use tune2fs on a read/write mounted filesystem to change parameters!
.PP
.SH OPTIONS
.TP
.I -c max-mount-counts
adjust the maximal mounts count between two filesystem checks.
.TP
.I -e errors-behavior
change the behavior of the kernel code when errors are detected.
.I errors-behavior
can be one of the followings:
.br
\ continue\ \ Continue normal execution.
.br
\ remount-ro\ Remount the filesystem read-only.
.br
\ panic\ \ Causes a kernel panic.
.TP
.I -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
.I -i interval-between-checks[d|m|w]
adjust the maximal time between two filesystem checks.
No postfix or `d' result in days, `m' in months, and `w' in weeks.
A value of zero will disable the timedependent checking.
.TP
.I -l
list the contents of the filesystem superblock.
.TP
.I -m reserved-blocks-percentage
adjust the reserved blocks percentage on the given device.
.TP
.I -r reserved-blocks-count
adjust the reserved blocks count on the given device.
.TP
.I -s sparse_super_flag
sets and resets the sparse_superblock flag. The sparse_superblock feature
saves space on really big filesystems.
.TP
.I -u user
set the user who can benefit from the reserved blocks.
.I user
can be a numerical uid or a user name.
.IP
.I -C mount-count
set the number of times the filesystem has been mounted.
.TP
.I -L volume-label
set the volume label of the filesystem.
.TP
.I -M last-mounted-directory
set the last-mounted direcctory for the filesystem.
.TP
.I -U UUID
set the UUID of the filesystem. A sample UUID looks like this:
"c1b9d5a2-f162-11cf-9ece-0020afc76f16". The uuid may also be "null",
which will set the filesystem UUID to the null UUID. The uuid may also
be "random", which will generate a new random UUID for the filesystem.
.PP
.SH BUGS
We didn't find any bugs yet. Perhaps there are bugs but it's unlikely.
.PP
.SH WARNING
.B Use this utility on your own risk. You're modifying filesystems.
.SH AUTHOR
.B tune2fs
has been written by Remy Card <card@masi.ibp.fr>, the developer and maintainer
of the ext2 fs.
.br
.B tune2fs
uses the ext2fs library written by Theodore Ts'o <tytso@mit.edu>.
.br
This manual page was written by Christian Kuhtz <chk@data-hh.Hanse.DE>.
.br
Timedependent checking was added by Uwe Ohse <uwe@tirka.gun.de>.
.SH AVAILABILITY
.B tune2fs
is available for anonymous ftp from ftp.ibp.fr and tsx-11.mit.edu in
/pub/linux/packages/ext2fs.
.SH SEE ALSO
.BR dumpe2fs (8),
.BR e2fsck (8),
.BR mke2fs (8)