Home | History | Annotate | Line # | Download | only in pfs
pfs.8 revision 1.2
      1 .Dd July 21, 2009
      2 .Dt PFS 8
      3 .Os
      4 .Sh NAME
      5 .Nm pfs 
      6 .Nd save and restore information for NAT and state tables.
      7 .Sh SYNOPSIS
      8 .Nm
      9 .Op Fl v
     10 .Fl l
     11 .Nm
     12 .Op Fl bv
     13 .Fl R
     14 .Ar filename
     15 .Nm
     16 .Op Fl bv
     17 .Fl r
     18 .Ar filename
     19 .Nm
     20 .Op Fl v
     21 .Fl u
     22 .Nm
     23 .Op Fl bv
     24 .Fl W
     25 .Ar filename
     26 .Nm
     27 .Op Fl bv
     28 .Fl w
     29 .Ar filename
     30 .Sh DESCRIPTION
     31 The
     32 .Nm
     33 command allows state information created for NAT entries and rules using
     34 .Dq keep state
     35 to be locked (modification prevented) and then saved to disk,
     36 allowing for the system to experience a reboot, followed by the restoration
     37 of that information, resulting in connections not being interrupted.
     38 .Sh OPTIONS
     39 .Bl -tag -width XrXfilenameXX
     40 .It Fl b
     41 The information are read or stored using binary format.
     42 The default format is a readable ASCII format, similar to 
     43 .Pa pfctl.conf 
     44 syntax.
     45 .It Fl l
     46 Lock state tables in the kernel.
     47 .It Fl R Ar filename
     48 Restore information from
     49 .Ar filename
     50 and load it into the kernel.
     51 The state tables are locked at the beginning of this operation and
     52 unlocked once complete.
     53 .It Fl r Ar filename
     54 Read information in from
     55 .Ar filename
     56 and load it into the kernel.
     57 This requires the state tables to have already been locked
     58 and does not change the lock once complete.
     59 .It Fl u
     60 Unlock state tables in the kernel.
     61 .It Fl v
     62 Provide a verbose description of what's being done.
     63 .It Fl W Ar filename
     64 Write information from the kernel out to
     65 .Ar filename .
     66 The state tables are locked at the beginning of this operation and
     67 unlocked once complete.
     68 .It Fl w Ar filename
     69 Write information from the kernel out to
     70 .Ar filename .
     71 This requires the state tables to have already been locked
     72 and does not change the lock once complete.
     73 .El
     74 .Sh FILES
     75 .Pa /dev/pf
     76 .Sh SEE ALSO
     77 .Xr pf 4
     78