[master] 7fb27fbbb document varnishd -E parameter
Nils Goroll
nils.goroll at uplex.de
Mon Dec 8 15:02:05 UTC 2025
commit 7fb27fbbbba7b884e3c9afe8a972833910ffa04c
Author: Nils Goroll <nils.goroll at uplex.de>
Date: Mon Dec 8 16:00:30 2025 +0100
document varnishd -E parameter
It was mentioned in usage, but not in the actual reference documentation.
diff --git a/doc/sphinx/reference/varnishd.rst b/doc/sphinx/reference/varnishd.rst
index 8afe6dde0..bc4ec89c6 100644
--- a/doc/sphinx/reference/varnishd.rst
+++ b/doc/sphinx/reference/varnishd.rst
@@ -25,6 +25,7 @@ varnishd
[-b [host[:port]|path]]
[-C]
[-d]
+ [-E extension]
[-F]
[-f config]
[-h type[,options]]
@@ -229,6 +230,22 @@ Operations options
Execute the management commands in the file given as ``clifile``
before the worker process starts, see `CLI Command File`_.
+-E extension
+
+ Load the named extension. Extensions are modules (VMODs) which can modify
+ varnishd behavior outside VCL, for example by adding storage- or protocol
+ implementations. Extensions are always also VMODs, even if they do not provide
+ any functionality to VCL, but in most cases they will.
+
+ Any VMOD can be loaded as an extension, in which case it is simply pre-loaded
+ at startup and prevented from ever getting unloaded.
+
+ If `extension` contains any slashes ``/``, it is taken as an abslute path.
+ Otherwise, for `extention` ``ext``, a ``vmod_ext.so`` is searched for in
+ ``vmod_path``.
+
+ ``varnishd`` startup fails if loading the extension fails for any reason.
+
Tuning options
--------------
More information about the varnish-commit
mailing list