From: Willy Tarreau <w@1wt.eu>
Date: Sun, 27 Sep 2015 13:03:15 +0000 (+0200)
Subject: DOC: clarify how to make use of abstract sockets in socat
X-Git-Tag: v1.6-dev6~43
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=55dcaf6521779db2f924ffb8499271f181dd3137;p=thirdparty%2Fhaproxy.git

DOC: clarify how to make use of abstract sockets in socat

Socat's abstract sockets can be made compatible with haproxy's provided
that an option is passed. It's not obvious, so let's mention it in the
doc.
---

diff --git a/doc/configuration.txt b/doc/configuration.txt
index aa0062885f..a4276f569f 100644
--- a/doc/configuration.txt
+++ b/doc/configuration.txt
@@ -2190,6 +2190,12 @@ bind /<path> [, ...] [param*]
         listen external_bind_app1
             bind "fd@${FD_APP1}"
 
+  Note: regarding Linux's abstract namespace sockets, HAProxy uses the whole
+        sun_path length is used for the address length. Some other programs
+        such as socat use the string length only by default. Pass the option
+        ",unix-tightsocklen=0" to any abstract socket definition in socat to
+        make it compatible with HAProxy's.
+
   See also : "source", "option forwardfor", "unix-bind" and the PROXY protocol
              documentation, and section 5 about bind options.
 
@@ -6988,6 +6994,12 @@ server <name> <address>[:[port]] [param*]
         server www1_dc1 "${LAN_DC1}.101:80"
         server www1_dc2 "${LAN_DC2}.101:80"
 
+  Note: regarding Linux's abstract namespace sockets, HAProxy uses the whole
+        sun_path length is used for the address length. Some other programs
+        such as socat use the string length only by default. Pass the option
+        ",unix-tightsocklen=0" to any abstract socket definition in socat to
+        make it compatible with HAProxy's.
+
   See also: "default-server", "http-send-name-header" and section 5 about
              server options