[master] b574701 Write up VMOD proxy in "Upgrading to 6.0".
Geoff Simmons
geoff at uplex.de
Wed Mar 14 20:31:08 UTC 2018
commit b574701e0436c13111f13f376776783029ce0019
Author: Geoff Simmons <geoff at uplex.de>
Date: Wed Mar 14 21:30:04 2018 +0100
Write up VMOD proxy in "Upgrading to 6.0".
diff --git a/doc/sphinx/whats-new/upgrading-6.0.rst b/doc/sphinx/whats-new/upgrading-6.0.rst
index 21ddbf0..03c7274 100644
--- a/doc/sphinx/whats-new/upgrading-6.0.rst
+++ b/doc/sphinx/whats-new/upgrading-6.0.rst
@@ -488,6 +488,26 @@ This is not available on every platform. As always, check the
documentation and test the code before you attempt something like this
in production.
+VMOD proxy
+----------
+
+:ref:`vmod_proxy(3)` provides functions to extract TLV attributes that
+may be optionally sent over a PROXYv2 connection to a Varnish listener.
+Most of these are properties of the peer component's TLS connection::
+
+ import proxy;
+
+ # Get the authority attribute -- corresponds to the SNI of a TLS
+ # connection.
+ set req.http.Authority = proxy.authority();
+
+Not all implementations send TLV attributes, and those that do don't
+necessarily support all of them; test your code to see what works in
+your configuration.
+
+See the
+`PROXY v2 specification <https://www.haproxy.org/download/1.8/doc/proxy-protocol.txt>`_ for more information about TLV attributes.
+
Packaging changes
=================
More information about the varnish-commit
mailing list