diff --git a/docs/shorewall_extension_scripts.xml b/docs/shorewall_extension_scripts.xml index 04fb6e31b..e0ab80ad8 100644 --- a/docs/shorewall_extension_scripts.xml +++ b/docs/shorewall_extension_scripts.xml @@ -69,83 +69,87 @@ - compile -- (Added in Shorewall-perl version 4.0.6). Invoked by - the Shorewall-perl compiler early in the compilation process. Must be - written in Perl. + compile -- (Added in Shorewall-perl version + 4.0.6). Invoked by the Shorewall-perl compiler early in the + compilation process. Must be written in Perl. - init -- invoked early in shorewall start and - shorewall restart + init -- invoked early in shorewall + start and shorewall restart - initdone -- invoked after Shorewall has flushed all existing - rules but before any rules have been added to the builtin - chains. + initdone -- invoked after Shorewall has + flushed all existing rules but before any rules have been added to the + builtin chains. - start -- invoked after the firewall has been started or - restarted. + start -- invoked after the firewall has + been started or restarted. - started -- invoked after the firewall has been marked as - 'running'. + started -- invoked after the firewall has + been marked as 'running'. - stop -- invoked as a first step when the firewall is being - stopped. + stop -- invoked as a first step when the + firewall is being stopped. - stopped -- invoked after the firewall has been stopped. + stopped -- invoked after the firewall has + been stopped. - clear -- invoked after the firewall has been cleared. + clear -- invoked after the firewall has + been cleared. - tcclear -- invoked to clear traffic shaping when CLEAR_TC=Yes in - tcclear -- invoked to clear traffic shaping + when CLEAR_TC=Yes in shorewall.conf. - refresh -- invoked while the firewall is being refreshed but - before the blacklst chains have been rebuilt. + refresh -- invoked while the firewall is + being refreshed but before the blacklst chains have been + rebuilt. - refreshed -- invoked after the firewall has been - refreshed. + refreshed -- invoked after the firewall has + been refreshed. - continue -- invoked to allow you to insert special rules to - allow traffic while Shorewall is [re]starting. Any rules added in this - script should be deleted in your start script. - This script is invoked earlier in the [re]start process than is the - initdone script described above (Not used by - Shorewall Perl). + continue -- invoked to allow you to insert + special rules to allow traffic while Shorewall is [re]starting. Any + rules added in this script should be deleted in your + start script. This script is invoked earlier in + the [re]start process than is the initdone script + described above (Not used by Shorewall Perl). - maclog -- invoked while mac filtering rules are being created. - It is invoked once for each interface having 'maclist' specified and - it is invoked just before the logging rule is added to the current - chain (the name of that chain will be in $CHAIN). + maclog -- invoked while mac filtering rules + are being created. It is invoked once for each interface having + 'maclist' specified and it is invoked just before the logging rule is + added to the current chain (the name of that chain will be in + $CHAIN). - isusable -- (Added in Shorewall-perl version 4.0.3) invoked when - Shorewall is trying to determine the usability of the network - interface associated with an optional entry in - /etc/shorewall/providers. $1 is the name of the - interface which will have been determined to be up and configured + isusable -- (Added in Shorewall-perl + version 4.0.3) invoked when Shorewall is trying to determine the + usability of the network interface associated with an optional entry + in /etc/shorewall/providers. $1 is the name of + the interface which will have been determined to be up and configured before the script is invoked. The return value from the script indicates whether or not the interface is usable (0 = usable, other = unusable). @@ -179,9 +183,17 @@ esac - save -- (Added in Shorewall version 4.2.0 Beta2). This script is - invoked during execution of the shorewall save and - shorewall-lite save commands. + save -- (Added in Shorewall version 4.2.0 + Beta2). This script is invoked during execution of the + shorewall save and shorewall-lite + save commands. + + + + restored -- (Added in Shorewall-perl + version 4.2.6). This script is invoked at the completion of a + successful shorewall restore and + shorewall-lite restore.