man: iptables-restore.8: document flush behaviour for user-defined chains
Florian Westphal
maintainerPATCH 1/1 man: iptables-restore.8: document flush behaviour for user-defined chains
There is no way we can change this after two decades. Add an example and document that declaring a user defined chain will flush its contents in --noflush mode.
Signed-off-by Florian Westphal <[email protected]>
--- iptables/iptables-restore.8.in | 14 ++++++++++++++ 1 file changed, 14 insertions(+)
iptables/iptables-restore.8.in +14 -0
@@ -48,6 +48,20 @@ Print a short option summary. \fB\-n\fR, \fB\-\-noflush\fR Don't flush the previous contents of the table. If not specified, both commands flush (delete) all previous contents of the respective table. +Note that this option will flush user-defined chains if they are declared. +Example: +.P +.in +4n +.EX +*filter +:FILTERS - [0:0] +-A FILTERS ... +.EE + +will flush and re-build the FILTERS chain from scratch, +while retaining the content of all other chains in the table. +.in +.P .TP \fB\-t\fP, \fB\-\-test\fP Only parse and construct the ruleset, but do not commit it.
Signature · 1 line
2.51.0
Quoted 6 lines · Florian Westphal
There is no way we can change this after two decades. Add an example and document that declaring a user defined chain will flush its contents in --noflush mode.
Thanks.
Quoted 33 lines
--- iptables/iptables-restore.8.in | 14 ++++++++++++++ 1 file changed, 14 insertions(+)iptables/iptables-restore.8.in +14
-0@@ -48,6 +48,20 @@ Print a short option summary. \fB\-n\fR, \fB\-\-noflush\fR Don't flush the previous contents of the table. If not specified, both commands flush (delete) all previous contents of the respective table. +Note that this option will flush user-defined chains if they are declared. +Example: +.P +.in +4n +.EX +*filter +:FILTERS - [0:0] +-A FILTERS ... +.EE + +will flush and re-build the FILTERS chain from scratch, +while retaining the content of all other chains in the table. +.in +.P .TP \fB\-t\fP, \fB\-\-test\fP Only parse and construct the ruleset, but do not commit it.Signature · 1 line
2.51.0