From f7c21e46c4b5fdae516b91374c24a87671f83ea3 Mon Sep 17 00:00:00 2001 From: Andreas Gustafsson Date: Thu, 30 Nov 2000 21:33:22 +0000 Subject: [PATCH] updated ARM and the rndc usage message to reflect the current set of supported commands --- bin/rndc/rndc.c | 18 ++++--- doc/arm/Bv9ARM-book.xml | 113 +++++++++++++++++----------------------- 2 files changed, 58 insertions(+), 73 deletions(-) diff --git a/bin/rndc/rndc.c b/bin/rndc/rndc.c index a4a4c22532..270901779b 100644 --- a/bin/rndc/rndc.c +++ b/bin/rndc/rndc.c @@ -15,7 +15,7 @@ * WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. */ -/* $Id: rndc.c,v 1.33 2000/11/30 21:32:20 gson Exp $ */ +/* $Id: rndc.c,v 1.34 2000/11/30 21:33:21 gson Exp $ */ /* * Principal Author: DCL @@ -256,17 +256,21 @@ usage(void) { Usage: %s [-c config] [-s server] [-p port] [-y key] [-z zone] [-v view]\n\ command [command ...]\n\ \n\ -command is one of the following for named:\n\ +command is one of the following:\n\ \n\ + reload Reload configuration file and zones.\n\ + reload zone [class [view]]\n\ + Reload a single zone.\n\ + refresh zone [class [view]]\n\ + Schedule immediate maintenance for a zone.\n\ + stats Write server statistics to the statistics file.\n\ + querylog Toggle query logging.\n\ + stop Save pending updates to master files and stop the server.\n\ + halt Stop the server without saving pending updates.\n\ *status Display ps(1) status of named.\n\ *dumpdb Dump database and cache to /var/tmp/named_dump.db.\n\ - reload Reload configuration file and zones.\n\ - refresh Refresh zone data, reloading if necessary.\n\ - stats Dump statistics to statistics file.\n\ *trace Increment debugging level by one.\n\ *notrace Set debugging level to 0.\n\ - querylog Toggle query logging.\n\ - *stop Stop the server.\n\ *restart Restart the server.\n\ \n\ * == not yet implemented\n\ diff --git a/doc/arm/Bv9ARM-book.xml b/doc/arm/Bv9ARM-book.xml index 1c691f9a28..e3c5e65692 100644 --- a/doc/arm/Bv9ARM-book.xml +++ b/doc/arm/Bv9ARM-book.xml @@ -1,8 +1,8 @@ - + - + @@ -639,77 +639,65 @@ of a server. -c config -s server -p port - -v view -y key - -z zone command command - command is one of the following - for named: - - - - - - - -status - not yet implemented - -Display ps(1) status of named. - - -dumpdb -Dump database and cache to /var/tmp/named_dump.db. - - -refresh -Force a refresh of specified zone. - + command is one of the following: + + + + + + + reload Reload configuration file and zones. + + +reload zone class view +Reload the given zone. + + + +refresh zone class view +Schedule zone maintenance for the given zone. + + stats -Dump statistics to /var/tmp/named.stats. +Write server statistics to the statistics file. + -trace -Increment debugging level by one. - - - -notrace - -Set debugging level to 0. - - - querylog +querylog Toggle query logging. + - stop -Stop the server. +stop +Stop the server, making sure any recent changes +made through dynamic update or IXFR are first saved to the master files +of the updated zones. + - restart -Restart the server. - - - - - As noted above, only a limited number of commands are - available in BIND 9.1. The other - commands, and more, are planned to be implemented for - future releases. +halt +Stop the server immediately. Recent changes +made through dynamic update or IXFR are not saved to the master files, +but will be rolled forward from the journal files when the server +is restarted. + + + + + + +In BIND 9.1, rndc does not +yet support all the commands of the BIND 8 ndc +utility. Additonal commands will be added in future releases. A configuration file is required, since all communication with the server is authenticated with @@ -2045,15 +2033,11 @@ Usage the key_list is allowed to be used to authenticate commands and responses given over the control channel by digitally signing each message between the server and - a command client (See in ). All commands to the - control channel must be signed by one of its specified keys to + a command client (See in + ). All commands to the control channel + must be signed by one of its specified keys to be honored. - For the initial release of BIND 9.0.0, only one command - is possible over the command channel, the command to reload the - server. We will expand command set in future releases. - The UNIX control channel type of BIND 8 is not supported in BIND 9.0.0, and is not expected to be added in future releases. If it is present in the controls statement from a @@ -5602,6 +5586,3 @@ of queries resulted in a SERVFAIL reply. - - -