Debian Codegraph @

upstream/debian-unstable/man8/xtables-legacy.8

raw
1 .\"
2 .\" (C) Copyright 2016-2017, Arturo Borrero Gonzalez <[email protected]>
3 .\"
4 .\" %%%LICENSE_START(GPLv2+_DOC_FULL)
5 .\" This is free documentation; you can redistribute it and/or
6 .\" modify it under the terms of the GNU General Public License as
7 .\" published by the Free Software Foundation; either version 2 of
8 .\" the License, or (at your option) any later version.
9 .\"
10 .\" The GNU General Public License's references to "object code"
11 .\" and "executables" are to be interpreted as the output of any
12 .\" document formatting or typesetting system, including
13 .\" intermediate and printed output.
14 .\"
15 .\" This manual is distributed in the hope that it will be useful,
16 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
17 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 .\" GNU General Public License for more details.
19 .\"
20 .\" You should have received a copy of the GNU General Public
21 .\" License along with this manual; if not, see
22 .\" <http://www.gnu.org/licenses/>.
23 .\" %%%LICENSE_END
24 .\"
25 .TH XTABLES-LEGACY 8 "June 2018"
26
27 .SH NAME
28 xtables-legacy \(em iptables using old getsockopt/setsockopt-based kernel api
29
30 .SH DESCRIPTION
31 \fBxtables-legacy\fP are the original versions of iptables that use
32 old getsockopt/setsockopt-based kernel interface.
33 This kernel interface has some limitations, therefore iptables can also
34 be used with the newer nf_tables based API.
35 See
36 .B xtables\-nft(8)
37 for information about the xtables-nft variants of iptables.
38
39 .SH USAGE
40 The xtables-legacy-multi binary can be linked to the traditional names:
41
42 .nf
43 /sbin/iptables -> /sbin/iptables\-legacy\-multi
44 /sbin/ip6tables -> /sbin/ip6tables\-legacy\-multi
45 /sbin/iptables\-save -> /sbin/ip6tables\-legacy\-multi
46 /sbin/iptables\-restore -> /sbin/ip6tables\-legacy\-multi
47 .fi
48
49 The iptables version string will indicate whether the legacy API (get/setsockopt) or
50 the new nf_tables API is used:
51 .nf
52 iptables \-V
53 iptables v1.7 (legacy)
54 .fi
55
56 .SH LIMITATIONS
57
58 When inserting a rule using
59 iptables \-A or iptables \-I, iptables first needs to retrieve the current active
60 ruleset, change it to include the new rule, and then commit back the result.
61 This means that if two instances of iptables are running concurrently, one of the
62 updates might be lost. This can be worked around partially with the \-\-wait option.
63
64 There is also no method to monitor changes to the ruleset, except periodically calling
65 iptables-legacy-save and checking for any differences in output.
66 .B xtables\-monitor(8)
67 will need the
68 .B xtables\-nft(8)
69 versions to work, it cannot display changes made using the
70 .B iptables-legacy
71 tools.
72
73 .SH SEE ALSO
74 \fBxtables\-nft(8)\fP, \fBxtables\-translate(8)\fP
75
76 .SH AUTHORS
77 Rusty Russell originally wrote iptables, in early consultation with Michael Neuling.