mirrors/haproxy
1
0
Fork 0
mirror of https://git.haproxy.org/git/haproxy.git/ synced 2025-09-20 13:21:29 +02:00
Code Issues Projects Releases Wiki Activity

DOC: unreliable sockpair@ on macOS

Browse Source 
We discovered that the sockpair@ protocol is unreliable in macOS, this
is the same problem that we fixed in d7f6819. But it's not possible to
implement a acknowledgment once the socket are in non-blocking mode.

The problem was discovered in issue #3045.

Must be backported in every stable versions.
This commit is contained in:
William Lallemand 2025-08-28 15:23:02 +02:00
parent ffdccb6e04
commit 8a456399db
2 changed files with 15 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
doc/configuration.txt
View File

@ -1514,6 +1514,11 @@ socket type and the transport method.
the FD from the unix socket and uses it as if it were the FD the FD from the unix socket and uses it as if it were the FD
of an accept(). Should be used carefully. of an accept(). Should be used carefully.
Bugs: This protocol is known to be unreliable on macOS because
of an issue in the macOS sendmsg(2) implementation. The
connection might not be accepted correctly.
'unix@<path>' following string is considered as a UNIX socket <path>. this 'unix@<path>' following string is considered as a UNIX socket <path>. this
prefix is useful to declare an UNIX socket path which don't prefix is useful to declare an UNIX socket path which don't
start by slash '/'. start by slash '/'.

10
doc/management.txt
View File

@ -4380,6 +4380,11 @@ Example:
case the full command ends at the end of line or semi-colon like any regular case the full command ends at the end of line or semi-colon like any regular
command. command.
Bugs: the sockpair@ protocol used to implement communication between the
master and the worker is known to not be reliable on macOS because of an
issue in the macOS sendmsg(2) implementation. A command might end up without
response because of that.
Examples: Examples:
$ socat /var/run/haproxy-master.sock readline $ socat /var/run/haproxy-master.sock readline
@ -4446,6 +4451,11 @@ Example:
command). In this case, the prompt mode of the master socket (interactive, command). In this case, the prompt mode of the master socket (interactive,
prompt, timed) is propagated into the worker process. prompt, timed) is propagated into the worker process.
Bugs: the sockpair@ protocol used to implement communication between the
master and the worker is known to not be reliable on macOS because of an
issue in the macOS sendmsg(2) implementation. A command might end up without
response because of that.
Examples: Examples:
# gracefully close connections and delete a server once idle (wait max 10s) # gracefully close connections and delete a server once idle (wait max 10s)
$ socat -t 11 /var/run/haproxy-master.sock - <<< \ $ socat -t 11 /var/run/haproxy-master.sock - <<< \