This is an automated email from the ASF dual-hosted git repository.
maskit pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/trafficserver.git
The following commit(s) were added to refs/heads/master by this push:
new 9a847a59e6 doc: clarify run-plugin argument is fixed at load time
(#13429)
9a847a59e6 is described below
commit 9a847a59e64b1af7990217f2316658c3c05b0ea4
Author: Masakazu Kitajo <[email protected]>
AuthorDate: Tue Jul 28 19:48:04 2026 -0600
doc: clarify run-plugin argument is fixed at load time (#13429)
The run-plugin action's plugin-argument is parsed once when the
rule loads, like a remap.config argument, and is never
re-evaluated per request, so variable interpolation (e.g.
%{HEADER:bar}) does not work there.
---
doc/admin-guide/plugins/header_rewrite.en.rst | 6 ++++++
1 file changed, 6 insertions(+)
diff --git a/doc/admin-guide/plugins/header_rewrite.en.rst
b/doc/admin-guide/plugins/header_rewrite.en.rst
index 2d57f64f97..da44687320 100644
--- a/doc/admin-guide/plugins/header_rewrite.en.rst
+++ b/doc/admin-guide/plugins/header_rewrite.en.rst
@@ -1171,6 +1171,12 @@ run-plugin
This allows to run an existing remap plugin, conditionally, from within a
header rewrite rule.
+.. note::
+ ``<plugin-argument>`` is fixed when the rule is loaded (or reloaded);
+ it behaves the same as a plugin argument in ``remap.config``. It is
+ not re-evaluated per request, so variable interpolation (e.g.
+ ``%{HEADER:bar}``) does not work here.
+
set-body
~~~~~~~~
::
