From 735e255367c6dde404bddd4e7f8290a779d278cd Mon Sep 17 00:00:00 2001 From: Phil Sutter Date: Thu, 17 Jun 2021 18:44:28 +0200 Subject: [PATCH] doc: Add deprecation notices to all relevant man pages This is RHEL9 trying to friendly kick people towards nftables. --- iptables/arptables-nft-restore.8 | 4 ++++ iptables/arptables-nft-save.8 | 4 ++++ iptables/arptables-nft.8 | 4 ++++ iptables/ebtables-nft.8 | 4 ++++ iptables/iptables-apply.8.in | 4 ++++ iptables/iptables-restore.8.in | 6 ++++++ iptables/iptables-save.8.in | 4 ++++ iptables/iptables.8.in | 5 +++++ iptables/xtables-legacy.8 | 6 ++++++ iptables/xtables-monitor.8.in | 4 ++++ iptables/xtables-nft.8 | 6 ++++++ 11 files changed, 51 insertions(+) diff --git a/iptables/arptables-nft-restore.8 b/iptables/arptables-nft-restore.8 index 09d9082cf9fd3..986c448f4d589 100644 --- a/iptables/arptables-nft-restore.8 +++ b/iptables/arptables-nft-restore.8 @@ -32,6 +32,10 @@ Use I/O redirection provided by your shell to read from a file .TP .B arptables-restore flushes (deletes) all previous contents of the respective ARP Table. +.SH NOTES +This tool is deprecated in Red Hat Enterprise Linux. It is maintenance only and +will not receive new features. New setups should use \fBnft\fP(8). Existing +setups should migrate to \fBnft\fP(8) when possible. .SH AUTHOR Jesper Dangaard Brouer .SH SEE ALSO diff --git a/iptables/arptables-nft-save.8 b/iptables/arptables-nft-save.8 index 905e59854cc28..438955098aafc 100644 --- a/iptables/arptables-nft-save.8 +++ b/iptables/arptables-nft-save.8 @@ -40,6 +40,10 @@ Include the current values of all packet and byte counters in the output. .TP \fB\-V\fR, \fB\-\-version\fR Print version information and exit. +.SH NOTES +This tool is deprecated in Red Hat Enterprise Linux. It is maintenance only and +will not receive new features. New setups should use \fBnft\fP(8). Existing +setups should migrate to \fBnft\fP(8) when possible. .SH AUTHOR Jesper Dangaard Brouer .SH SEE ALSO diff --git a/iptables/arptables-nft.8 b/iptables/arptables-nft.8 index ea31e0842acd4..81b79740c82f3 100644 --- a/iptables/arptables-nft.8 +++ b/iptables/arptables-nft.8 @@ -340,6 +340,10 @@ bridges, the same may be achieved using chain in .BR ebtables . +This tool is deprecated in Red Hat Enterprise Linux. It is maintenance only and +will not receive new features. New setups should use \fBnft\fP(8). Existing +setups should migrate to \fBnft\fP(8) when possible. + .SH MAILINGLISTS .BR "" "See " http://netfilter.org/mailinglists.html .SH SEE ALSO diff --git a/iptables/ebtables-nft.8 b/iptables/ebtables-nft.8 index 1fa5ad9388cc0..1444ddafdccb6 100644 --- a/iptables/ebtables-nft.8 +++ b/iptables/ebtables-nft.8 @@ -1104,6 +1104,10 @@ arp message and the hardware address length in the arp header is 6 bytes. .I EBTABLES_ATOMIC_FILE .SH MAILINGLISTS .BR "" "See " http://netfilter.org/mailinglists.html +.SH NOTES +This tool is deprecated in Red Hat Enterprise Linux. It is maintenance only and +will not receive new features. New setups should use \fBnft\fP(8). Existing +setups should migrate to \fBnft\fP(8) when possible. .SH BUGS The version of ebtables this man page ships with does not support the .B broute diff --git a/iptables/iptables-apply.8.in b/iptables/iptables-apply.8.in index f0ed4e5f8d450..5df8cc99d6733 100644 --- a/iptables/iptables-apply.8.in +++ b/iptables/iptables-apply.8.in @@ -45,6 +45,10 @@ Display usage information. .TP \fB\-V\fP, \fB\-\-version\fP Display version information. +.SH NOTES +This tool is deprecated in Red Hat Enterprise Linux. It is maintenance only and +will not receive new features. New setups should use \fBnft\fP(8). Existing +setups should migrate to \fBnft\fP(8) when possible. .SH "SEE ALSO" .PP \fBiptables-restore\fP(8), \fBiptables-save\fP(8), \fBiptables\fR(8). diff --git a/iptables/iptables-restore.8.in b/iptables/iptables-restore.8.in index b4b62f92740d1..de7d2e8efc069 100644 --- a/iptables/iptables-restore.8.in +++ b/iptables/iptables-restore.8.in @@ -79,6 +79,12 @@ inspect /proc/sys/kernel/modprobe to determine the executable's path. .TP \fB\-T\fP, \fB\-\-table\fP \fIname\fP Restore only the named table even if the input stream contains other ones. +.SH NOTES +This tool is deprecated in Red Hat Enterprise Linux. It is maintenance only and +will not receive new features. New setups should use \fBnft\fP(8). Existing +setups should migrate to \fBnft\fP(8) when possible, see +\fBiptables\-restore\-translate\fP/\fBip6tables\-restore\-translate\fP for help +doing so. .SH BUGS None known as of iptables-1.2.1 release .SH AUTHORS diff --git a/iptables/iptables-save.8.in b/iptables/iptables-save.8.in index 7683fd3780f72..610be412a09c8 100644 --- a/iptables/iptables-save.8.in +++ b/iptables/iptables-save.8.in @@ -53,6 +53,10 @@ module loading, an attempt will be made to load the appropriate module for that table if it is not already there. .br If not specified, output includes all available tables. +.SH NOTES +This tool is deprecated in Red Hat Enterprise Linux. It is maintenance only and +will not receive new features. New setups should use \fBnft\fP(8). Existing +setups should migrate to \fBnft\fP(8) when possible. .SH BUGS None known as of iptables-1.2.1 release .SH AUTHORS diff --git a/iptables/iptables.8.in b/iptables/iptables.8.in index 999cf339845f9..3aa008edcc4c6 100644 --- a/iptables/iptables.8.in +++ b/iptables/iptables.8.in @@ -414,6 +414,11 @@ Various error messages are printed to standard error. The exit code is 0 for correct functioning. Errors which appear to be caused by invalid or abused command line parameters cause an exit code of 2, and other errors cause an exit code of 1. +.SH NOTES +This tool is deprecated in Red Hat Enterprise Linux. It is maintenance only and +will not receive new features. New setups should use \fBnft\fP(8). Existing +setups should migrate to \fBnft\fP(8) when possible, see +\fBiptables\-translate\fP/\fBip6tables\-translate\fP for help doing so. .SH BUGS Bugs? What's this? ;-) Well, you might want to have a look at http://bugzilla.netfilter.org/ diff --git a/iptables/xtables-legacy.8 b/iptables/xtables-legacy.8 index 6db7d2cb4357a..48099508a12ca 100644 --- a/iptables/xtables-legacy.8 +++ b/iptables/xtables-legacy.8 @@ -71,6 +71,12 @@ versions to work, it cannot display changes made using the .B iptables-legacy tools. +.SH NOTES +This tool is deprecated in Red Hat Enterprise Linux. It is maintenance only and +will not receive new features. New setups should use \fBnft\fP(8). Existing +setups should migrate to \fBnft\fP(8) when possible, see +\fBxtables-translate\fP(8) for help doing so. + .SH SEE ALSO \fBxtables\-nft(8)\fP, \fBxtables\-translate(8)\fP diff --git a/iptables/xtables-monitor.8.in b/iptables/xtables-monitor.8.in index b647a79eb64ed..37485c5c89cff 100644 --- a/iptables/xtables-monitor.8.in +++ b/iptables/xtables-monitor.8.in @@ -86,6 +86,10 @@ become active, i.e., the rule set changes are now active. This also lists the p .B xtables-monitor only works with rules added using iptables-nftables, rules added using iptables-legacy cannot be monitored. +.SH NOTES +This tool is deprecated in Red Hat Enterprise Linux. It is maintenance only and +will not receive new features. New setups should use \fBnft\fP(8). Existing +setups should migrate to \fBnft\fP(8) when possible. .SH BUGS Should be reported or by sending email to netfilter-devel@vger.kernel.org or by filing a report on https://bugzilla.netfilter.org/. diff --git a/iptables/xtables-nft.8 b/iptables/xtables-nft.8 index 702bf95408a1a..875f3abeb9b89 100644 --- a/iptables/xtables-nft.8 +++ b/iptables/xtables-nft.8 @@ -195,6 +195,12 @@ The CLUSTERIP target is not supported. To get up-to-date information about this, please head to \fBhttp://wiki.nftables.org/\fP. +.SH NOTES +This tool is deprecated in Red Hat Enterprise Linux. It is maintenance only and +will not receive new features. New setups should use \fBnft\fP(8). Existing +setups should migrate to \fBnft\fP(8) when possible, see +\fBxtables-translate\fP(8) for help doing so. + .SH SEE ALSO \fBnft(8)\fP, \fBxtables\-translate(8)\fP, \fBxtables\-monitor(8)\fP -- 2.31.1