Skip to content

Commit 7fb27fb

Browse files
committed
document varnishd -E parameter
It was mentioned in usage, but not in the actual reference documentation.
1 parent 107f606 commit 7fb27fb

File tree

1 file changed

+17
-0
lines changed

1 file changed

+17
-0
lines changed

doc/sphinx/reference/varnishd.rst

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -25,6 +25,7 @@ varnishd
2525
[-b [host[:port]|path]]
2626
[-C]
2727
[-d]
28+
[-E extension]
2829
[-F]
2930
[-f config]
3031
[-h type[,options]]
@@ -229,6 +230,22 @@ Operations options
229230
Execute the management commands in the file given as ``clifile``
230231
before the worker process starts, see `CLI Command File`_.
231232

233+
-E extension
234+
235+
Load the named extension. Extensions are modules (VMODs) which can modify
236+
varnishd behavior outside VCL, for example by adding storage- or protocol
237+
implementations. Extensions are always also VMODs, even if they do not provide
238+
any functionality to VCL, but in most cases they will.
239+
240+
Any VMOD can be loaded as an extension, in which case it is simply pre-loaded
241+
at startup and prevented from ever getting unloaded.
242+
243+
If `extension` contains any slashes ``/``, it is taken as an abslute path.
244+
Otherwise, for `extention` ``ext``, a ``vmod_ext.so`` is searched for in
245+
``vmod_path``.
246+
247+
``varnishd`` startup fails if loading the extension fails for any reason.
248+
232249
Tuning options
233250
--------------
234251

0 commit comments

Comments
 (0)