[master] 61573d2 More info about the -s argument
guillaume quintard
gquintard at users.noreply.github.com
Mon Dec 18 12:08:06 UTC 2017
commit 61573d29a2b503fcce075ab403969e88127b6b19
Author: Guillaume Quintard <guillaume at varnish-software.com>
Date: Thu Dec 14 18:02:39 2017 +0100
More info about the -s argument
fix: #2511
diff --git a/doc/sphinx/reference/varnishd.rst b/doc/sphinx/reference/varnishd.rst
index 6c97236..6992531 100644
--- a/doc/sphinx/reference/varnishd.rst
+++ b/doc/sphinx/reference/varnishd.rst
@@ -295,7 +295,8 @@ The following storage types are available:
-s <file,path[,size[,granularity[,advice]]]>
The file backend stores data in a file on disk. The file will be
- accessed using mmap.
+ accessed using mmap. Note that this storage is reset every time ``varnishd``
+ starts.
The path is mandatory. If path points to a directory, a temporary
file will be created in that directory and immediately unlinked. If
@@ -323,6 +324,18 @@ The following storage types are available:
storage backend has multiple issues with it and will likely be
removed from a future version of Varnish.
+
+You can also prefix the type with ``NAME=`` to explicitly name a storage::
+
+ -s myStorage=malloc,5G
+
+This allows to address it more easily in VCL::
+
+ set beresp.storage = storage.myStorage;
+
+If the name is omitted, Varnish will name storages ``sN``, starting with ``s0``
+and incrementing N for every new storage.
+
.. _ref-varnishd-opt_j:
Jail
More information about the varnish-commit
mailing list