]> git.kaiwu.me - haproxy.git/commit
DOC: filters: Document how to port an existing filter
authorChristopher Faulet <cfaulet@haproxy.com>
Thu, 8 Oct 2026 12:19:29 +0000 (14:19 +0200)
committerChristopher Faulet <cfaulet@haproxy.com>
Fri, 9 Oct 2026 14:17:36 +0000 (16:17 +0200)
commita8639b910f3bfbfd21456ea35811ec83d5c4d867
tree0abb7458d20d16e85996e6025afb80107fd5805d
parentb16fcc2953e98c3bf9604dab962f9f9ae95631b6
DOC: filters: Document how to port an existing filter

The filters guide now contains a section about the conversion of a legacy
filter to the filter instance mode. It lists the changes from a filter
developer point of view, then explains the minimal changes needed to support
both declaration modes, how to fully use the instance mode, and the pitfalls
and design considerations to keep in mind.

In particular, it details the callback timing and the parsing-time
constraints, the ownership of the filter configuration and of its fields,
the enabled state and its consequences, the class registration and
placement, the legacy mode coexistence, and the lifecycle of the filters
of a proxy created at runtime.
doc/internals/api/filters.txt