fwb_pf(1)

1fwb_pf(1)                      Firewall Builder                      fwb_pf(1)
2
3
4

NAME

6       fwb_pf - Policy compiler for OpenBSD packet filter "pf"
7

SYNOPSIS

9       fwb_pf   [-vVx]   [-d   wdir]  [-o  output.fw]  [-i]  -f  data_file.xml
10       object_name
11
12

DESCRIPTION

14       fwb_pf is a firewall policy compiler component of Firewall Builder (see
15       fwbuilder(1)).  This  compiler generates code for OpenBSD Packet Filter
16       (pf). Compiler reads objects definitions and firewall description  from
17       the data file specified with "-f" option and generates pf configuration
18       files and firewall activation script.
19
20       All generated files have names that start with the name of the firewall
21       object.  Firewall  activation  script has extension ".fw" and is simple
22       shell script that flushes current policy,  loads  new  filter  and  nat
23       rules  and  then  activates pf.  PF configuration file name starts with
24       the name of the firewall object, plus  "-pf.conf".   NAT  configuration
25       file  name  also  starts  with  the  name  of the firewall object, plus
26       "-nat.conf". For example, if firewall  object  has  name  "myfirewall",
27       then  compiler  will  create three files: "myfirewall.fw", "myfirewall-
28       pf.conf", "myfirewall-nat.conf".
29
30       The data file and the name of the firewall objects must be specified on
31       the command line. Other command line parameters are optional.
32
33
34

OPTIONS

36       -f FILE
37              Specify the name of the data file to be processed.
38
39
40       -o output.fw
41              Specify output file name
42
43
44       -d wdir
45              Specify   working  directory.  Compiler  creates  firewall acti‐
46              vation script and PF configuration files in this directory.   If
47              this  parameter is missing, then all files will be placed in the
48              current working directory.
49
50
51       -v     Be verbose: compiler prints diagnostic messages when it works.
52
53
54       -V     Print version number and quit.
55
56
57       -i     When this option is present, the last argument  on  the  command
58              line is supposed to be firewall object ID rather than its name
59
60
61       -x     Generate  debugging  information  while  working. This option is
62              intended for debugging only and may produce lots of cryptic mes‐
63              sages.
64
65

NOTES

67       Support for PF has been introduced in version 1.0.1 of Firewall Builder
68
69
70       Supported features:
71
72
73       o      both pf.conf and nat.conf files are generated
74
75
76       o      negation in policy and NAT rules
77
78
79       o      grouping in "from", "to" and ports using '{' '}' syntax
80
81
82       o      if  checkbox  "Scrub" is checked in the rule options dialog, and
83              rule's action is Accept, the  compiler  generates  two  (almost)
84              identical  rules:  first with action 'scrub' and the second with
85              action 'pass quick'
86
87
88       o      stateful inspection in individual rule can be turned off in rule
89              options  dialog. By default compiler adds "keep state" or "modu‐
90              late state" to each rule with action 'pass'
91
92
93       o      rule options dialog provides a choice of icmp or tcp rst replies
94              for rules with action "Reject"
95
96
97       o      compiler adds flag "allow-opts" if match on ip options is needed
98
99
100       o      compiler can generate rules matching on TCP flags
101
102
103       o      compiler  can  generate  script  adding ip aliases for NAT rules
104              using addresses that do not belong to any interface of the fire‐
105              wall
106
107
108       o      compiler  always  adds rule "block quick all" at the very bottom
109              of the script to ensure "block all by default"  policy  even  if
110              the policy is empty.
111
112
113       o      Address ranges in both policy and NAT
114
115
116
117       Features that are not supported (yet)
118
119
120       o      custom services
121
122
123
124       What will not be supported (at least not anytime soon)
125
126
127       o      policy routing
128
129

URL

131       Firewall   Builder   home   page  is  located  at  the  following  URL:
132       http://www.fwbuilder.org/
133
134

BUGS

136       Please report bugs using bug tracking system on SourceForge:
137
138       http://sourceforge.net/tracker/?group_id=5314&atid=105314
139
140
141