aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorRoss Williams <ross@ross-williams.net>2026-04-17 15:19:23 +0000
committerKristof Provost <kp@FreeBSD.org>2026-04-20 12:50:40 +0000
commit19eecf94fa16aac6f90a4610d2f342f70060674a (patch)
tree595a442bdb319b927e11a47fcee6b1c8861f61d5
parentff76ec3e9b287df9378f09ce29eca668162903f4 (diff)
pfctl: clarify usage of load option flags
`pfctl -A`, `-N`, `-O`, and `-R` restrict which rule types and options are loaded. The man page language ("Load only...") does not make it clear that these options can be combined to (re)load multiple rule types and/or options without reloading the entire packet filter. Add language to make it explicitly clear that these flags combine. Reviewed by: kp Signed-off-by: Ross Williams <ross@ross-williams.net>
-rw-r--r--sbin/pfctl/pfctl.824
1 files changed, 24 insertions, 0 deletions
diff --git a/sbin/pfctl/pfctl.8 b/sbin/pfctl/pfctl.8
index 05a76641ca8d..53f2c369108f 100644
--- a/sbin/pfctl/pfctl.8
+++ b/sbin/pfctl/pfctl.8
@@ -110,6 +110,12 @@ The options are as follows:
.It Fl A
Load only the queue rules present in the rule file.
Other rules and options are ignored.
+Can be combined with the
+.Fl N ,
+.Fl O ,
+and
+.Fl R
+flags to load multiple rule types without (re)loading all rules.
.It Fl a Ar anchor
Apply flags
.Fl f ,
@@ -399,11 +405,23 @@ Allows single options to be modified without disturbing the others:
.It Fl N
Load only the NAT rules present in the rule file.
Other rules and options are ignored.
+Can be combined with the
+.Fl A ,
+.Fl O ,
+and
+.Fl R
+flags to load multiple rule types without (re)loading all rules.
.It Fl n
Do not actually load rules, just parse them.
.It Fl O
Load only the options present in the rule file.
Other rules and options are ignored.
+Can be combined with the
+.Fl A ,
+.Fl N ,
+and
+.Fl R
+flags to load multiple rule types without (re)loading all rules.
.It Fl o Ar level
Control the ruleset optimizer, overriding any rule file settings.
.Pp
@@ -432,6 +450,12 @@ Only print errors and warnings.
.It Fl R
Load only the filter rules present in the rule file.
Other rules and options are ignored.
+Can be combined with the
+.Fl A ,
+.Fl N ,
+and
+.Fl O
+flags to load multiple rule types without (re)loading all rules.
.It Fl r
Perform reverse DNS lookups on states and tables when displaying them.
.Fl N