| 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. |