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
2423a578
Commit
2423a578
authored
Sep 11, 2018
by
Nils Goroll
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
release docs: fix PRIV_TASK/PRIV_TOP
parent
780cc21b
Changes
1
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
with
23 additions
and
10 deletions
+23
-10
upgrading-6.1.rst
doc/sphinx/whats-new/upgrading-6.1.rst
+23
-10
No files found.
doc/sphinx/whats-new/upgrading-6.1.rst
View file @
2423a578
...
...
@@ -331,16 +331,29 @@ Other changes
* The Varnish API soname version (for libvarnishapi.so) has been
bumped to 2.0.0.
* When ``PRIV_TASK`` and ``PRIV_TOP`` parameters are defined for a
VMOD method or function, space for the ``struct vrt_priv`` object
is allocated on the appropriate workspace before invocation -- the
task workspace (client or backend) for ``PRIV_TASK``, and the
client workspace for ``PRIV_TOP``. So it is no longer necessary
for the VMOD code to do the allocation. The address of the
allocated object is passed as the parameter to your implementation
of the method or function. If the address is NULL, then allocation
failed, probably due to workspace exhaustion (so your VMOD should
check for that).
* Space required by varnish for maintaining the ``PRIV_TASK`` and
``PRIV_TOP`` parameters is now taken from the appropriate
workspace rather than from the heap as before. For a failing
allocation, a VCL failure is triggered.
The net effect of this change is that in cases of a workspace
shortage, the almost unavoidable failure will happen earlier. The
amount of workspace required is slightly increased and scales with
the number of vmods per ``PRIV_TASK`` and ``PRIV_TOP`` parameter.
The VCL compiler (VCC) guarantees that if a vmod function is
called with a ``PRIV_*`` argument, that argument value is set.
There is no change with respect to the API the ``PRIV_*`` vmod
function arguments provide.
* ``VRT_priv_task()``, the function implementing the allocation of
the ``PRIV_TASK`` and ``PRIV_TOP`` parameters as described above,
is now more likely to return ``NULL`` for allocation failures for
the same reason.
Notice that explicit use of this function from within VMODs is
considered experimental as this interface may change.
* We have improved support for the ``STRANDS`` data type, which you
may find easier to use than the varargs-based ``STRING_LIST``. See
...
...
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