tree 6997731accf404231cece88795e99b8434731403
parent 88b604adbca4f91e99eeffaafb7fb34500862b47
author Christopher Faulet <cfaulet@haproxy.com> 1623663798 +0200
committer Christopher Faulet <cfaulet@haproxy.com> 1624006842 +0200

DOC: lua: Add a warning about buffers modification in HTTP

Since the 1.9, it is forbidden to alter the channel buffer from an HTTP
stream because there is no way to keep the HTTP parser synchronized if the
buffer content is altered. In addition, since the HTX is the only
reprensentation for HTTP messages, the data in HTTP buffers are structured
and cannot be read or updated in a raw fashion.

A warning is triggered when a user tries to alter an HTTP buffer. However,
it was not documented. This patch adds a warning in the lua documentation.

This patch is related to the issue #1287. It may be backported as far as
2.0.

(cherry picked from commit 095303956708a3f87594ae60cd9d7df12d12d905)
Signed-off-by: Willy Tarreau <w@1wt.eu>
(cherry picked from commit 1cda6c8bd2461819cfc7b3c9625b2cb49d808406)
Signed-off-by: Willy Tarreau <w@1wt.eu>
(cherry picked from commit 52e53bdc43d924c789f7b82aac7b9f4ce384ec31)
Signed-off-by: Christopher Faulet <cfaulet@haproxy.com>
(cherry picked from commit 970032c65d69ee73a1c22cd9f5512d9cf177cd64)
Signed-off-by: Christopher Faulet <cfaulet@haproxy.com>