Change 'graceful down' command to 'graceful restart' and update docs

The command initiating planned graceful restart including bird shutdown
should be called 'graceful restart' instead of 'graceful down', as the
later should be reserved for graceful shutdown in style of RFC 8326.

diff --git a/doc/bird.sgml b/doc/bird.sgml
index e15e3dd183e2209a52ada2241a959da607884ee1..83dec4f818f0ff2176f90454bdd0969ee4573f9b 100644 (file)
--- a/doc/bird.sgml
+++ b/doc/bird.sgml
@@ -403,6 +403,14 @@ configured for all relevant protocols and requires protocol-specific support
 (currently implemented for Kernel and BGP protocols), it is activated for
 particular boot by option <cf/-R/.
 
+<p>Some protocols (e.g. BGP) could be restarted gracefully after both
+intentional outage and crash, while others (e.g. OSPF) after intentional outage
+only. For planned graceful restart, BIRD must be shut down by
+<ref id="cli-graceful-restart" name="graceful restart"> command instead of
+regular <ref id="cli-down" name="down"> command. In this way routing neighbors
+are notified about planned graceful restart and routes are kept in kernel table
+after shutdown.
+
 
 <chapt>Configuration
 <label id="config">
@@ -1116,6 +1124,10 @@ This argument can be omitted if there exists only a single instance.
        <tag><label id="cli-down">down</tag>
        Shut BIRD down.
 
+       <tag><label id="cli-graceful-restart">graceful restart</tag>
+       Shut BIRD down for graceful restart. See <ref id="graceful-restart"
+       name="graceful restart"> section for details.
+
        <tag><label id="cli-debug">debug <m/protocol/|<m/pattern/|all all|off|{ states|routes|filters|events|packets [, <m/.../] }</tag>
        Control protocol debugging.
 
@@ -2216,7 +2228,7 @@ using the following configuration parameters:
        Define neighboring router this instance will be talking to and what AS
        it is located in. In case the neighbor is in the same AS as we are, we
        automatically switch to IBGP. Alternatively, it is possible to specify
-       just <cf/internal/ or </cf/external/ instead of AS number, in that case
+       just <cf/internal/ or <cf/external/ instead of AS number, in that case
        either local AS number, or any external AS number is accepted.
        Optionally, the remote port may also be specified. Like <cf/local/
        parameter, this parameter may also be used multiple times with different
@@ -2266,7 +2278,7 @@ using the following configuration parameters:
        dynamic BGP behavior is active. Actual names also contain numeric
        index to distinguish individual instances.  Default: "dynbgp".
 
-       <tag><label id="bgp-dynamic-name">dynamic name digits <m/number/</tag>
+       <tag><label id="bgp-dynamic-name-digits">dynamic name digits <m/number/</tag>
        Define minimum number of digits for index in names of spawned dynamic
        BGP instances. E.g., if set to 2, then the first name would be
        "dynbgp01". Default: 0.

diff --git a/sysdep/unix/config.Y b/sysdep/unix/config.Y
index b78e0e6c36855c064b40d95adf7ec1f8d45e01e2..c76eb73b80b3eb4fc12465c5f033970a4f82b9e7 100644 (file)
--- a/sysdep/unix/config.Y
+++ b/sysdep/unix/config.Y
@@ -19,6 +19,7 @@ CF_DECLS
 
 CF_KEYWORDS(LOG, SYSLOG, ALL, DEBUG, TRACE, INFO, REMOTE, WARNING, ERROR, AUTH, FATAL, BUG, STDERR, SOFT)
 CF_KEYWORDS(NAME, CONFIRM, UNDO, CHECK, TIMEOUT, DEBUG, LATENCY, LIMIT, WATCHDOG, WARNING, STATUS)
+CF_KEYWORDS(GRACEFUL, RESTART)
 
 %type <i> log_mask log_mask_list log_cat cfg_timeout
 %type <t> cfg_name
@@ -133,7 +134,7 @@ CF_CLI(CONFIGURE CHECK, cfg_name, [\"<file>\"], [[Parse configuration and check
 CF_CLI(DOWN,,, [[Shut the daemon down]])
 { cmd_shutdown(); } ;
 
-CF_CLI(GRACEFUL DOWN,,, [[Shut the daemon down for graceful restart]])
+CF_CLI(GRACEFUL RESTART,,, [[Shut the daemon down for graceful restart]])
 { cmd_graceful_restart(); } ;