mirror of
https://git.haproxy.org/git/haproxy.git/
synced 2026-01-30 14:31:08 +01:00
d417863828
The ABORT_NOW() macro is not much used since we have BUG_ON(), but there are situations where it makes sense, typically if the program must always die regardless od DEBUG_STRICT, or if the condition must always be evaluated (e.g. decompress something and check it). It's not convenient not to have any hint about what happened there. But providing too much info also results in wiping some registers, making the trace less exploitable, so a compromise must be found. What this patch does is to provide the support for an optional argument to ABORT_NOW(). When an argument is passed (a string), then a message will be emitted with the file name, line number, the message and a trailing LF, before the stack dump and the crash. It should be used reasonably, for example in functions that have multiple calls that need to be more easily distinguished.
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)