aboutsummaryrefslogtreecommitdiff
path: root/sbin/tunefs
diff options
context:
space:
mode:
authorRuslan Ermilov <ru@FreeBSD.org>2002-08-13 13:31:54 +0000
committerRuslan Ermilov <ru@FreeBSD.org>2002-08-13 13:31:54 +0000
commit3c5bd3e3caf98e933e9ca4ce1be8e90e5bf1fa3d (patch)
tree833744505cc43393d9a04f55ac5f69fd1bfc251a /sbin/tunefs
parent3e40554f0654aa8096f60809c25bfc1078dbe060 (diff)
downloadsrc-3c5bd3e3caf98e933e9ca4ce1be8e90e5bf1fa3d.tar.gz
src-3c5bd3e3caf98e933e9ca4ce1be8e90e5bf1fa3d.zip
mdoc(7) police: laundry.
Notes
Notes: svn path=/head/; revision=101802
Diffstat (limited to 'sbin/tunefs')
-rw-r--r--sbin/tunefs/tunefs.833
1 files changed, 16 insertions, 17 deletions
diff --git a/sbin/tunefs/tunefs.8 b/sbin/tunefs/tunefs.8
index 7ab3665bd812..903713f2a110 100644
--- a/sbin/tunefs/tunefs.8
+++ b/sbin/tunefs/tunefs.8
@@ -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