mirror of
https://git.haproxy.org/git/haproxy.git/
synced 2025-09-21 05:41:26 +02:00
c75c41c35f
While this used to work fine with legacy mailers, IPV6 server support for lua mailers script was overlooked so it is currently broken. Indeed, within the lua script, server address was parsed as an IPV4 address to extract both ip and port and pass them to smtp_send_email() function from Thierry FOURNIER. From lua point of view: when fetching server address from ProxyMailers.mailservers, server ip and port are not separated. Each server address is represented using haproxy server address custom-format (the one used to specify server addresses within haproxy config, see 11. Address formats in haproxy configuration manual): It is a string that contains both proto hint, ip and port. (Such addresses are manipulated using str2sa_range() and sa2str() in haproxy's code) Parsing these custom-format addresses from lua to support multiple address families is feasible since the format is properly documented in haproxy configuration. However, to keep things simple, and given that smtp_send_email() relies on Socket.connect() function to set-up the tcp connection: Socket.connect() already supports the full server address custom-format when no explicit port argument is provided. Thus with minor code changes we're able to pass the server string as it is. With this, IPV6 smtp servers from mailers section are now automatically supported when using lua mailers script.
The HAProxy documentation has been split into a number of different files for ease of use. Please refer to the following files depending on what you're looking for : - INSTALL for instructions on how to build and install HAProxy - BRANCHES to understand the project's life cycle and what version to use - LICENSE for the project's license - CONTRIBUTING for the process to follow to submit contributions The more detailed documentation is located into the doc/ directory : - doc/intro.txt for a quick introduction on HAProxy - doc/configuration.txt for the configuration's reference manual - doc/lua.txt for the Lua's reference manual - doc/SPOE.txt for how to use the SPOE engine - doc/network-namespaces.txt for how to use network namespaces under Linux - doc/management.txt for the management guide - doc/regression-testing.txt for how to use the regression testing suite - doc/peers.txt for the peers protocol reference - doc/coding-style.txt for how to adopt HAProxy's coding style - doc/internals for developer-specific documentation (not all up to date)