]> git.kaiwu.me - haproxy.git/commit
DOC: config: mention that section 8.6 does not apply to the cbor encoding
authorWilly Tarreau <w@1wt.eu>
Thu, 3 Sep 2026 04:53:11 +0000 (06:53 +0200)
committerWilly Tarreau <w@1wt.eu>
Thu, 3 Sep 2026 06:33:43 +0000 (08:33 +0200)
commitbcb60500af251bc739852e5a1a249955c8c25855
tree1334936fb7f9f81514079d99718df9696f3aa593
parent6457968043ccab554d1b52ecf04e45d35cc4c2b9
DOC: config: mention that section 8.6 does not apply to the cbor encoding

Section 8.6 of the config manual explains that the characters outside
the 32..126 range are not emitted as-is in the logs but encoded as a '#'
followed by their two hex digits, so that a log line cannot upset a
terminal.

However, this doesn't apply to cbor output, which can come as a surprise
to the reader. The reason is that cbor output already emits all bytes as
hex chars by default (hence the protection is granted), but supports raw
mode with "+bin" in which case the output will be consumed by a suitable
cbor parser and not by a terminal. In such a case we want the output to
remain verbatim and certainly not to be escaped. So let's update the doc
to explain this.
doc/configuration.txt