[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