From: des <des@d4fa192b-c00b-0410-8231-f00ffab90ce4>
Date: Wed, 16 May 2007 12:45:53 +0000 (+0000)
Subject: Explain in more detail how the storage file size is specified.
X-Git-Url: https://err.no/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=ae9ea8698cd05635907a4e3d67c972b9c4dd9d0f;p=varnish

Explain in more detail how the storage file size is specified.


git-svn-id: svn+ssh://projects.linpro.no/svn/varnish/trunk@1432 d4fa192b-c00b-0410-8231-f00ffab90ce4
---

diff --git a/varnish-cache/bin/varnishd/varnishd.1 b/varnish-cache/bin/varnishd/varnishd.1
index 1d16a682..811de0fd 100644
--- a/varnish-cache/bin/varnishd/varnishd.1
+++ b/varnish-cache/bin/varnishd/varnishd.1
@@ -28,7 +28,7 @@
 .\"
 .\" $Id$
 .\"
-.Dd May 14, 2007
+.Dd May 16, 2007
 .Dt VARNISHD 1
 .Os
 .Sh NAME
@@ -180,6 +180,8 @@ A simple doubly-linked list.
 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 @@ Storage for each object is allocated with
 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 default is
 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