mirror of
https://git.haproxy.org/git/haproxy.git/
synced 2025-09-23 14:51:27 +02:00
15c25d5e1d
The vast majority of calls to ci_putchk() etc are performed from applets which directly know an endpoint. Figuring the correct API (writing into input channel etc) isn't trivial for newcomers, and knowing that they must mark the flag indicating a buffer full condition isn't trivial either. Here we're adding wrappers to these functions but to be used directly from the appctx. That's already what is being done in multiple steps in the applet code, where the endp is derived from the appctx, then the cs from the endp, then the stream from the cs, then the channel from the stream, and so on. But this time the function doesn't require to know much of the internals, applet_putchr() writes a char from the appctx, and marks the buffer full if needed. Period. This will allow to remove a significant amount of obscure ci_putchk() and cs_ic() calls from the code, hence a significant number of possible mistakes.
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)