Repository navigation
Document force_actions priority option and composite promotion - #124
Open
c-rosenberg wants to merge 2 commits into
Open
c-rosenberg wants to merge 2 commits into
c-rosenberg wants to merge 2 commits into
Conversation
- add the priority option (low/normal/high/critical or 0-3) and a Priority section: the highest priority match wins regardless of registration order, invalid values are ignored with a warning, fractions are floored and out of range values are clamped - document the priority:N symbol option and the warning for combining priority with least - explain that rules referencing a composite are registered as postfilters, and that they are still starved if an earlier pre-result lacks process_all - explain that same action rules still record their result, with process_all implied, once any rule sets a priority - correct the symbol name rule: the rule name is used as is, it is not uppercased - note that priority is not available in the legacy actions format - mark the new behaviour as available since 4.2.3
- a rule without priority skips an already selected action but keeps it: a lower-priority rule matching later cannot replace it - a rule with its own priority records the selected action too, keeps the previous reply and makes the verdict passthrough - process_all is implied only for filter-stage rules below another non-least rule, not module-wide - composite rules run right after the composites, before greylisting and the require_action/honor_action rules, which run by priority - note the composites that cannot be detected, and that rules without priority now record at normal while least rules stay at low
This branch has not been deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Documents the new
force_actionspriority arbitration and automatic composite promotion. Companion to rspamd/rspamd#.Changes (
docs/modules/force_actions.md)priorityoption:low,normal(default),high,critical, or0-3.leastcombination and thepriority:Nsymbol option.process_allstops composite evaluation.process_all: clearer description of what it does.priorityis not available in the legacyactions {}format.