From c2ca1fff602ae8955256aa0c0defc478fe8139e4 Mon Sep 17 00:00:00 2001 From: ru Date: Tue, 13 Aug 2002 13:31:54 +0000 Subject: mdoc(7) police: laundry. --- sbin/tunefs/tunefs.8 | 33 ++++++++++++++++----------------- 1 file changed, 16 insertions(+), 17 deletions(-) (limited to 'sbin/tunefs') diff --git a/sbin/tunefs/tunefs.8 b/sbin/tunefs/tunefs.8 index 7ab3665..903713f 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 -- cgit v1.1