r1432 - trunk/varnish-cache/bin/varnishd

[des at projects.linpro.no]

Author: des
Date: 2007-05-16 14:45:53 +0200 (Wed, 16 May 2007)
New Revision: 1432

Modified:
   trunk/varnish-cache/bin/varnishd/varnishd.1
Log:
Explain in more detail how the storage file size is specified.


Modified: trunk/varnish-cache/bin/varnishd/varnishd.1
===================================================================
--- trunk/varnish-cache/bin/varnishd/varnishd.1	2007-05-16 11:38:08 UTC (rev 1431)
+++ trunk/varnish-cache/bin/varnishd/varnishd.1	2007-05-16 12:45:53 UTC (rev 1432)
@@ -28,7 +28,7 @@
 .\"
 .\" $Id$
 .\"
-.Dd May 14, 2007
+.Dd May 16, 2007
 .Dt VARNISHD 1
 .Os
 .Sh NAME
@@ -180,6 +180,8 @@
 Not recommended for production use.
 .It Cm classic Ns Op Ns , Ns Ar buckets
 A standard hash table.
+This is the default.
+.Pp
 The hash key is the CRC32 of the object's URL modulo the size of the
 hash table.
 Each table entry points to a list of elements which share the same
@@ -199,6 +201,7 @@
 Not recommended for production use.
 .It Cm file Ns Op Ns , Ns Ar path Ns Op Ns , Ns Ar size
 Storage for each object is allocated from an arena backed by a file.
+This is the default.
 .Pp
 The
 .Ar path
@@ -212,6 +215,24 @@
 The
 .Ar size
 parameter specifies the size of the backing file.
+The size is assumed to be in bytes, unless followed by one of the
+following suffixes:
+.Bl -tag -width indent
+.It K, k
+The size is expressed in kibibytes.
+.It M, m
+The size is expressed in mebibytes.
+.It G, g
+The size is expressed in gibibytes.
+.It T, t
+The size is expressed in tebibytes.
+.It %
+The size is expressed as a percentage of the free space on the file
+system where it resides.
+.El
+.Pp
+The default size is 50%.
+.Pp
 If the backing file already exists, it will be truncated or expanded
 to the specified size.
 .Pp