[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