Updates from gluk@ that describe new options that can be used to tweak the

new directory allocation policy.

1 files changed, 34 insertions, 6 deletions

diff --git a/sbin/tunefs/tunefs.8 b/sbin/tunefs/tunefs.8
index 04aab774887..8d64759491c 100644
--- a/sbin/tunefs/tunefs.8
+++ b/sbin/tunefs/tunefs.8
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: tunefs.8,v 1.15 2001/04/08 00:00:43 gluk Exp $
+.\"	$OpenBSD: tunefs.8,v 1.16 2001/04/08 19:42:28 aaron Exp $
 .\"	$NetBSD: tunefs.8,v 1.8 1995/03/18 15:01:29 cgd Exp $
 .\"
 .\" Copyright (c) 1983, 1991, 1993
@@ -93,6 +93,19 @@ more frequently than if they were allowed to allocate all the blocks
 in a cylinder group before seeking elsewhere.
 For file systems with exclusively large files,
 this parameter should be set higher.
+.It Fl f Ar avgfilesize
+Specifies the expected average file size in bytes.
+This value could be used for various optimizations, but for now it is only
+used together with 
+.Ar avgfpdir
+to optimize the directory allocation policy.
+To take effect, both
+.Ar avgfpdir
+and
+.Ar avgfilesize
+must be greater than zero.
+(Also see
+.Ar avgfpdir . )
 .It Fl m Ar minfree
 This value specifies the percentage of space held back
 from normal users; the minimum free space threshold.
@@ -103,6 +116,21 @@ threshold.
 Note that 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 avgfpdir
+Specifies the expected average number of files per directory in
+the file system.
+This value is used only if both
+.Ar avgfilesize
+and
+.Ar avgfpdir
+are greater than zero.
+It is used to limit number of directories which may be allocated one after
+another in the same cylinder group without intervention by regular files.
+This value does not affect most file system operations but is useful for
+applications which at first create a directory structure and then populate
+with files later.
+(Also see
+.Ar avgfilesize . )
 .It Fl o Ar optimize_preference
 The file system can either try to minimize the time spent
 allocating blocks, or it can attempt to minimize the space
@@ -140,6 +168,11 @@ manual page.
 .%D August 1984
 .%O "(reprinted in the BSD System Manager's Manual, SMM:5)"
 .Re
+.Sh HISTORY
+The
+.Nm
+command appeared in
+.Bx 4.2 .
 .Sh BUGS
 This program should work on mounted and active file systems.
 Because the super-block is not kept in the buffer cache,
@@ -151,8 +184,3 @@ after the file system is tuned.
 .\" Take this out and a Unix Demon will dog your steps from now until
 .\" the time_t's wrap around.
 You can tune a file system, but you can't tune a fish.
-.Sh HISTORY
-The
-.Nm
-command appeared in
-.Bx 4.2 .