NAME

       fwb_pf - Policy compiler for OpenBSD packet filter "pf"

SYNOPSIS

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

DESCRIPTION

       fwb_pf  is  a  firewall  policy  compiler component of Firewall Builder (see fwbuilder(1)). This compiler
       generates code  for  OpenBSD  Packet  Filter  (pf).  Compiler  reads  objects  definitions  and  firewall
       description  from  the  data  file  specified  with  "-f" option and generates pf configuration files and
       firewall activation script.

       All generated files have names that start with the name  of  the  firewall  object.  Firewall  activation
       script  has  extension ".fw" and is simple shell script that flushes current policy, loads new filter and
       nat rules and then activates pf.  PF configuration file name starts with the name of the firewall object,
       plus "-pf.conf".  NAT configuration file name also starts with the name  of  the  firewall  object,  plus
       "-nat.conf".  For  example,  if  firewall  object  has name "myfirewall", then compiler will create three
       files: "myfirewall.fw", "myfirewall-pf.conf", "myfirewall-nat.conf".

       The data file and the name of the firewall objects must be specified on the command line.  Other  command
       line parameters are optional.

OPTIONS

       -f FILE
              Specify the name of the data file to be processed.

       -o output.fw
              Specify output file name

       -d wdir
              Specify   working   directory.  Compiler  creates  firewall activation script and PF configuration
              files in this directory.  If this parameter is missing, then all  files  will  be  placed  in  the
              current working directory.

       -v     Be verbose: compiler prints diagnostic messages when it works.

       -V     Print version number and quit.

       -i     When  this  option  is  present,  the last argument on the command line is supposed to be firewall
              object ID rather than its name

       -x     Generate debugging information while working. This option is intended for debugging only  and  may
              produce lots of cryptic messages.

NOTES

       Support for PF has been introduced in version 1.0.1 of Firewall Builder

       Supported features:

       o      both pf.conf and nat.conf files are generated

       o      negation in policy and NAT rules

       o      grouping in "from", "to" and ports using '{' '}' syntax

       o      if  checkbox  "Scrub"  is  checked  in  the  rule options dialog, and rule's action is Accept, the
              compiler generates two (almost) identical rules: first with action 'scrub'  and  the  second  with
              action 'pass quick'

       o      stateful  inspection  in  individual  rule  can  be  turned off in rule options dialog. By default
              compiler adds "keep state" or "modulate state" to each rule with action 'pass'

       o      rule options dialog provides a choice of icmp or tcp rst replies for rules with action "Reject"

       o      compiler adds flag "allow-opts" if match on ip options is needed

       o      compiler can generate rules matching on TCP flags

       o      compiler can generate script adding ip aliases for NAT rules using addresses that do not belong to
              any interface of the firewall

       o      compiler always adds rule "block quick all" at the very bottom of the script to ensure "block  all
              by default" policy even if the policy is empty.

       o      Address ranges in both policy and NAT

       Features that are not supported (yet)

       o      custom services

       What will not be supported (at least not anytime soon)

       o      policy routing

URL

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

BUGS

       Please report bugs using bug tracking system on SourceForge:

       http://sourceforge.net/tracker/?group_id=5314&atid=105314

SEE ALSO

       fwbuilder(1), fwb_ipt(1), fwb_ipf(1)

FWB                                                                                                    fwb_pf(1)