Skip to content
Projects
Groups
Snippets
Help
Loading...
Help
Submit feedback
Contribute to GitLab
Sign in
Toggle navigation
V
varnish-cache
Project
Project
Details
Activity
Releases
Cycle Analytics
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Charts
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Charts
Commits
Open sidebar
varnishcache
varnish-cache
Commits
c6afd311
Commit
c6afd311
authored
Sep 18, 2023
by
Nils Goroll
Committed by
Dridi Boukelmoune
Sep 19, 2023
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Reflect API rename in docs
Ref
5df6f8d4
parent
f07a6d61
Changes
1
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
with
4 additions
and
4 deletions
+4
-4
vmod.rst
doc/sphinx/reference/vmod.rst
+4
-4
No files found.
doc/sphinx/reference/vmod.rst
View file @
c6afd311
...
...
@@ -741,15 +741,15 @@ not be left half-initialized should a failure occur.
If your VMOD is running an asynchronous background job you can hold a reference
to the VCL to prevent it from going cold too soon and get the same guarantees
as backends with ongoing requests for instance. For that, you must acquire the
reference by calling ``VRT_
ref_vcl
`` when you receive a ``VCL_EVENT_WARM`` and
later calling ``VRT_
rel_vcl
`` once the background job is over. Receiving a
reference by calling ``VRT_
VCL_Prevent_Discard
`` when you receive a ``VCL_EVENT_WARM`` and
later calling ``VRT_
VCL_Allow_Discard
`` once the background job is over. Receiving a
``VCL_EVENT_COLD`` is your cue to terminate any background job bound to a VCL.
You can find an example of VCL references in vmod-debug::
priv_vcl->vclref = VRT_
ref_vcl
(ctx, "vmod-debug");
priv_vcl->vclref = VRT_
VCL_Prevent_Discard
(ctx, "vmod-debug");
...
VRT_
rel_vcl
(&ctx, &priv_vcl->vclref);
VRT_
VCL_Allow_Discard
(&ctx, &priv_vcl->vclref);
In this simplified version, you can see that you need at least a VCL-bound data
structure like a ``PRIV_VCL`` or a VMOD object to keep track of the reference
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment