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