1.TH IPFS 8
2.SH NAME
3ipfs \- saves and restores information for NAT and state tables.
4.SH SYNOPSIS
5.B ipfs
6[-nv] -l
7.PP
8.B ipfs
9[-nv] -u
10.PP
11.B ipfs
12[-nv] [
13.B \-d
14<\fIdirname\fP>
15] -R
16.PP
17.B ipfs
18[-nv] [
19.B \-d
20<\fIdirname\fP>
21] -W
22.PP
23.B ipfs
24[-nNSv] [
25.B \-f
26<\fIfilename\fP>
27] -r
28.PP
29.B ipfs
30[-nNSv] [
31.B \-f
32<\fIfilename\fP>
33] -w
34.PP
35.B ipfs
36[-nNSv]
37.B \-f
38<\fIfilename\fP>
39.B \-i
40<if1>,<if2>
41.SH DESCRIPTION
42.PP
43\fBipfs\fP allows state information created for NAT entries and rules using
44\fIkeep state\fP to be locked (modification prevented) and then saved to disk,
45allowing for the system to experience a reboot, followed by the restoration
46of that information, resulting in connections not being interrupted.
47.SH OPTIONS
48.TP
49.B \-d
50Change the default directory used with
51.B \-R
52and
53.B \-W
54options for saving state information.
|
| 55.TP |
56.B \-n
57Don't actually take any action that would effect information stored in
58the kernel or on disk.
59.TP
60.B \-v
61Provides a verbose description of what's being done.
62.TP
|
63.B \-i <ifname1>,<ifname2>
64Change all instances of interface name ifname1 in the state save file to
65ifname2. Useful if you're restoring state information after a hardware
66reconfiguration or change.
67.TP |
68.B \-N
69Operate on NAT information.
70.TP
71.B \-S
72Operate on filtering state information.
73.TP
74.B \-u
75Unlock state tables in the kernel.
76.TP
77.B \-l
|
72Unlock state tables in the kernel.
|
| 78Lock state tables in the kernel. |
79.TP
80.B \-r
81Read information in from the specified file and load it into the
82kernel. This requires the state tables to have already been locked
83and does not change the lock once comlete.
84.TP
85.B \-w
86Write information out to the specified file and from the kernel.
87This requires the state tables to have already been locked
88and does not change the lock once comlete.
89.TP
90.B \-R
91Restores all saved state information, if any, from two files,
92\fIipstate.ipf\fP and \fIipnat.ipf\fP, stored in the \fI/var/db/ipf\fP
93directory unless otherwise specified the
94.B \-d
95option is used. The state tables are locked at the beginning of this
96operation and unlocked once complete.
97.TP
98.B \-W
99Saves in-kernel state information, if any, out to two files,
100\fIipstate.ipf\fP and \fIipnat.ipf\fP, stored in the \fI/var/db/ipf\fP
101directory unless otherwise specified the
102.B \-d
103option is used. The state tables are locked at the beginning of this
104operation and unlocked once complete.
105.DT
106.SH FILES
107/var/db/ipf/ipstate.ipf
108.br
109/var/db/ipf/ipnat.ipf
110.br
111/dev/ipl
112.br
113/dev/ipstate
114.br
115/dev/ipnat
116.SH SEE ALSO
117ipf(8), ipl(4), ipmon(8), ipnat(8)
118.SH DIAGNOSTICS
119.PP
120Perhaps the -W and -R operations should set the locking but rather than
121undo it, restore it to what it was previously. Fragment table information
122is currently not saved.
123.SH BUGS
124.PP
125If you find any, please send email to me at darrenr@pobox.com
|