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