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
f98d28c5
Commit
f98d28c5
authored
Mar 09, 2018
by
Geoff Simmons
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Some editorial fiddling with "Upgrading to 6.0".
parent
3088b6fd
Changes
1
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
with
12 additions
and
9 deletions
+12
-9
upgrading-6.0.rst
doc/sphinx/whats-new/upgrading-6.0.rst
+12
-9
No files found.
doc/sphinx/whats-new/upgrading-6.0.rst
View file @
f98d28c5
...
...
@@ -78,9 +78,13 @@ Unix domain sockets and VCL
We have made an effort to adapt the support of Unix domain sockets in
VCL so that you may not have to change anything in your VCL deployment
at all, other than changing the version to 4.1. Most importantly, this
affects the meaning of the ``*.ip`` variables and the use of ACLs; and
there are a number of other details you should consider.
at all, other than changing the version to 4.1.
The short story is that where VCL requires an IP value, the value is
``0.0.0.0:0`` for a connection that was addressed as a UDS -- the "any
IPv4" address with port 0. So your use of IP-valued elements in VCL
will continue to work and may not have to change, but there are some
consequences that you should consider, covered in the following.
If you don't use UDSen, then nothing about VCL changes. UDS support
requires version 4.1, so if you are keeping your VCL level at 4.0 (and
...
...
@@ -90,9 +94,8 @@ concern.
``client.ip``, ``server.ip``, ``local.ip`` and ``remote.ip``
------------------------------------------------------------
When referring to a connection that was in fact addressed as a UDS,
the ``*.ip`` variables always have a value equivalent to the IPv4
address ``0.0.0.0:0`` -- the "any IPv4" address with port 0.
These variables have the value ``0.0.0.0`` for a connection that was
addressed as a UDS.
Remember that if you are using the PROXY protocol, then ``client.ip``
and ``server.ip`` are set to the addresses sent in the PROXY header by
...
...
@@ -105,9 +108,9 @@ If you have more than one UDS listener (more than one ``-a``
command-line argument specifying a socket path), then you may not be
able to use the ``*.ip`` variables to tell them apart, especially
since ``local.ip`` will be ``0.0.0.0`` for all of them. If you need to
distinguish such addresses in VCL, you can use ``local.socket``
(
which
is the name given for the ``-a`` argument
;
``a0``, ``a1`` etc. by
default) or ``local.endpoint``, which in the case of UDS is the path
distinguish such addresses in VCL, you can use ``local.socket``
,
which
is the name given for the ``-a`` argument
(
``a0``, ``a1`` etc. by
default)
,
or ``local.endpoint``, which in the case of UDS is the path
given in the ``-a`` argument. You can, for example, use string
operations such as regex matching on ``local.endpoint`` to determine
properties of the path address::
...
...
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