d/freebsd-skq
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

mdoc(7) police: laundry.

Browse Source
This commit is contained in:
ru 2002-08-13 13:31:54 +00:00
parent 49201b1ad0
commit c2ca1fff60
1 changed files with 16 additions and 17 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

33
sbin/tunefs/tunefs.8
View File

@ -45,13 +45,11 @@
.Op Fl e Ar maxbpg
.Op Fl f Ar avgfilesize
.Op Fl m Ar minfree
.Bk -words
.Op Fl n Ar enable | disable
.Op Fl o Ar space | time
.Op Fl n Cm enable | disable
.Op Fl o Cm space | time
.Op Fl p
.Op Fl s Ar avgfpdir
.Ek
.Ar special | Ar filesystem
.Ar special | filesystem
.Sh DESCRIPTION
The
.Nm
@ -59,18 +57,19 @@ utility is designed to change the dynamic parameters of a filesystem
which affect the layout policies.
The
.Nm
program cannot be run on an active filesystem.
utility cannot be run on an active filesystem.
To change an active filesystem,
you must either downgrade the filesystem to read-only
or unmount it.
it must be downgraded to read-only or unmounted.
.Pp
The parameters which are to be changed are indicated by the flags
given below:
.Bl -tag -width indent
.It Fl A
The filesystem has several backups of the super-block. Specifying
The filesystem has several backups of the super-block.
Specifying
this option will cause all backups to be modified as well as the
primary super-block. This is potentially dangerous - use with caution.
primary super-block.
This is potentially dangerous - use with caution.
.It Fl a Ar maxcontig
Specify the maximum number of contiguous blocks that will
be laid out before allowing a rotational delay.
@ -90,14 +89,13 @@ more frequently than if they were allowed to allocate all the blocks
in a cylinder group before seeking elsewhere.
For filesystems with exclusively large files,
this parameter should be set higher.
.It Fl f Ar avgfilezsize
.It Fl f Ar avgfilesize
Specify the expected average file size.
.It Fl m Ar minfree
Specify the percentage of space held back
from normal users; the minimum free space threshold.
The default value used is 8%.
Note that lowering the threshold can adversely affect performance:
.Pp
.Bl -bullet
.It
Settings of 5% and less force space optimization to
@ -113,9 +111,9 @@ factor of three over the performance obtained at a 10% threshold.
If the value is raised above the current usage level,
users will be unable to allocate files until enough files have
been deleted to get under the higher threshold.
.It Fl n Ar enable | disable
.It Fl n Cm enable | disable
Turn on/off soft updates.
.It Fl o Ar space | time
.It Fl o Cm space | time
The filesystem can either try to minimize the time spent
allocating blocks, or it can attempt to minimize the space
fragmentation on the disk.
@ -125,12 +123,13 @@ The kernel normally changes the preference automatically as
the percent fragmentation changes on the filesystem.
.It Fl p
Show a summary of what the current tunable settings
are on the selected filesystem. More detailed information can be
are on the selected filesystem.
More detailed information can be
obtained from the
.Xr dumpfs 8
or
.Xr ffsinfo 8
programs.
utilities.
.It Fl s Ar avgfpdir
Specify the expected number of files per directory.
.El
@ -160,7 +159,7 @@ specified mount point.
.%O "(reprinted in the BSD System Manager's Manual, SMM:5)"
.Re
.Sh BUGS
This program should work on active filesystems.
This utility should work on active filesystems.
.\" Take this out and a Unix Daemon will dog your steps from now until
.\" the time_t's wrap around.
.Pp