|
|
9c64ad |
Adapted version of
|
|
|
9c64ad |
|
|
|
9c64ad |
commit 65801d02a482befd2745c792d6596ec75d434934
|
|
|
9c64ad |
Author: Dan Williams <dcbw@redhat.com>
|
|
|
9c64ad |
Date: Mon Apr 10 12:35:18 2017 -0500
|
|
|
9c64ad |
|
|
|
9c64ad |
iptables-restore.8: document -w/-W options
|
|
|
9c64ad |
|
|
|
9c64ad |
Fixes: 999eaa241212 ("iptables-restore: support acquiring the lock.")
|
|
|
9c64ad |
Signed-off-by: Dan Williams <dcbw@redhat.com>
|
|
|
9c64ad |
Signed-off-by: Pablo Neira Ayuso <pablo@netfilter.org>
|
|
|
9c64ad |
|
|
|
9c64ad |
diff -up iptables-1.4.21/iptables/iptables-restore.8.in.restore_wait_man iptables-1.4.21/iptables/iptables-restore.8.in
|
|
|
9c64ad |
--- iptables-1.4.21/iptables/iptables-restore.8.in.restore_wait_man 2017-04-20 17:33:23.386401192 +0200
|
|
|
9c64ad |
+++ iptables-1.4.21/iptables/iptables-restore.8.in 2017-04-20 17:35:13.562713997 +0200
|
|
|
9c64ad |
@@ -23,9 +23,11 @@ iptables-restore \(em Restore IP Tables
|
|
|
9c64ad |
.P
|
|
|
9c64ad |
ip6tables-restore \(em Restore IPv6 Tables
|
|
|
9c64ad |
.SH SYNOPSIS
|
|
|
9c64ad |
-\fBiptables\-restore\fP [\fB\-chntvV\fP] [\fB\-M\fP \fImodprobe\fP]
|
|
|
9c64ad |
+\fBiptables\-restore\fP [\fB\-chntvV\fP] [\fB\-w\fP \fIsecs\fP]
|
|
|
9c64ad |
++[\fB\-W\fP \fIusecs\fP] [\fB\-M\fP \fImodprobe\fP]
|
|
|
9c64ad |
.P
|
|
|
9c64ad |
-\fBip6tables\-restore\fP [\fB\-chntvV\fP] [\fB\-M\fP \fImodprobe\fP]
|
|
|
9c64ad |
+\fBip6tables\-restore\fP [\fB\-chntvV\fP] [\fB\-w\fP \fIsecs\fP]
|
|
|
9c64ad |
++[\fB\-W\fP \fIusecs\fP] [\fB\-M\fP \fImodprobe\fP]
|
|
|
9c64ad |
[\fB\-T\fP \fIname\fP]
|
|
|
9c64ad |
.SH DESCRIPTION
|
|
|
9c64ad |
.PP
|
|
|
9c64ad |
@@ -54,6 +56,21 @@ Print additional debug info during rules
|
|
|
9c64ad |
\fB\-V\fP, \fB\-\-version\fP
|
|
|
9c64ad |
Print the program version number.
|
|
|
9c64ad |
.TP
|
|
|
9c64ad |
+\fB\-w\fP, \fB\-\-wait\fP [\fIseconds\fP]
|
|
|
9c64ad |
+Wait for the xtables lock.
|
|
|
9c64ad |
+To prevent multiple instances of the program from running concurrently,
|
|
|
9c64ad |
+an attempt will be made to obtain an exclusive lock at launch. By default,
|
|
|
9c64ad |
+the program will exit if the lock cannot be obtained. This option will
|
|
|
9c64ad |
+make the program wait (indefinitely or for optional \fIseconds\fP) until
|
|
|
9c64ad |
+the exclusive lock can be obtained.
|
|
|
9c64ad |
+.TP
|
|
|
9c64ad |
+\fB\-W\fP, \fB\-\-wait-interval\fP \fImicroseconds\fP
|
|
|
9c64ad |
+Interval to wait per each iteration.
|
|
|
9c64ad |
+When running latency sensitive applications, waiting for the xtables lock
|
|
|
9c64ad |
+for extended durations may not be acceptable. This option will make each
|
|
|
9c64ad |
+iteration take the amount of time specified. The default interval is
|
|
|
9c64ad |
+1 second. This option only works with \fB\-w\fP.
|
|
|
9c64ad |
+.TP
|
|
|
9c64ad |
\fB\-M\fP, \fB\-\-modprobe\fP \fImodprobe_program\fP
|
|
|
9c64ad |
Specify the path to the modprobe program. By default, iptables-restore will
|
|
|
9c64ad |
inspect /proc/sys/kernel/modprobe to determine the executable's path.
|