tree 48aabd6f6456b16f756d4d81ec459f93b12f17d9
parent caef19e0c7594b00aa341d8984a33ddd0f15113f
author Christopher Faulet <cfaulet@haproxy.com> 1623663798 +0200
committer Christopher Faulet <cfaulet@haproxy.com> 1623665012 +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.