[prev in list] [next in list] [prev in thread] [next in thread]
List: varnish-commit
Subject: [master] 175655234 improve varnishd -s documentation
From: Nils Goroll <nils.goroll () uplex ! de>
Date: 2019-10-29 9:24:06
Message-ID: 20191029092406.8EDA762515 () lists ! varnish-cache ! org
[Download RAW message or body]
commit 1756552343a6d62192de8f7306e71cd7468b3f11
Author: Nils Goroll <nils.goroll@uplex.de>
Date: Tue Oct 29 10:21:56 2019 +0100
improve varnishd -s documentation
* clarify defaults
* document Transient
Fixes #3108
diff --git a/doc/sphinx/reference/varnishd.rst b/doc/sphinx/reference/varnishd.rst
index 53488b175..44e2caf8f 100644
--- a/doc/sphinx/reference/varnishd.rst
+++ b/doc/sphinx/reference/varnishd.rst
@@ -304,7 +304,36 @@ The following hash algorithms are available:
Storage Backend
---------------
-The following storage types are available:
+The argument format to define storage backends is:
+
+-s <[name]=kind[,options]>
+
+ If *name* is omitted, Varnish will name storages ``s``\ *N*,
+ starting with ``s0`` and incrementing *N* for every new storage.
+
+ For *kind* and *options* see details below.
+
+Storages can be used in vcl as ``storage.``\ *name*, so, for
+example if ``myStorage`` was defined by ``-s myStorage=malloc,5G``, it
+could be used in VCL like so::
+
+ set beresp.storage = storage.myStorage;
+
+A special *name* is ``Transient`` which is the default storage for
+uncacheable objects as resulting from a pass, hit-for-miss or
+hit-for-pass.
+
+If no ``-s`` options are given, the default is::
+
+ -s malloc=100m
+
+If no ``Transient`` storage is defined, the default is an unbound
+``malloc`` storage as if defined as::
+
+ -s Transient,malloc
+
+
+The following storage types and options are available:
-s <default[,size]>
@@ -354,18 +383,6 @@ 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
_______________________________________________
varnish-commit mailing list
varnish-commit@varnish-cache.org
https://www.varnish-cache.org/lists/mailman/listinfo/varnish-commit
[prev in list] [next in list] [prev in thread] [next in thread]
Configure |
About |
News |
Add a list |
Sponsored by KoreLogic