mir/bind
2
0
Fork 0
mirror of https://gitlab.isc.org/isc-projects/bind9 synced 2025-08-30 14:07:59 +00:00
Code Issues Releases Wiki Activity

updated ARM and the rndc usage message to reflect the current

Browse Source 
set of supported commands
This commit is contained in:
Andreas Gustafsson
2000-11-30 21:33:22 +00:00
parent 091ea9e38d
commit f7c21e46c4
2 changed files with 58 additions and 73 deletions
Download Patch File Download Diff File Expand all files Collapse all files

18
bin/rndc/rndc.c
View File

@@ -15,7 +15,7 @@
* WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. * 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 * Principal Author: DCL
@@ -256,17 +256,21 @@ usage(void) {
Usage: %s [-c config] [-s server] [-p port] [-y key] [-z zone] [-v view]\n\ Usage: %s [-c config] [-s server] [-p port] [-y key] [-z zone] [-v view]\n\
command [command ...]\n\ command [command ...]\n\
\n\ \n\
command is one of the following for named:\n\ command is one of the following:\n\
\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\ *status Display ps(1) status of named.\n\
*dumpdb Dump database and cache to /var/tmp/named_dump.db.\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\ *trace Increment debugging level by one.\n\
*notrace Set debugging level to 0.\n\ *notrace Set debugging level to 0.\n\
querylog Toggle query logging.\n\
*stop Stop the server.\n\
*restart Restart the server.\n\ *restart Restart the server.\n\
\n\ \n\
* == not yet implemented\n\ * == not yet implemented\n\

113
doc/arm/Bv9ARM-book.xml
View File

@@ -1,8 +1,8 @@
<?xml version='1.0'?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.0//EN" <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.0//EN"
"http://www.oasis-open.org/docbook/xml/4.0/docbookx.dtd"> "http://www.oasis-open.org/docbook/xml/4.0/docbookx.dtd">
<!-- File: $Id: Bv9ARM-book.xml,v 1.58 2000/11/30 00:29:35 gson Exp $ --> <!-- File: $Id: Bv9ARM-book.xml,v 1.59 2000/11/30 21:33:22 gson Exp $ -->
<book> <book>
@@ -639,77 +639,65 @@ of a server.</para>
<arg>-c <replaceable>config</replaceable></arg> <arg>-c <replaceable>config</replaceable></arg>
<arg>-s <replaceable>server</replaceable></arg> <arg>-s <replaceable>server</replaceable></arg>
<arg>-p <replaceable>port</replaceable></arg> <arg>-p <replaceable>port</replaceable></arg>
<arg>-v <replaceable>view</replaceable></arg>
<arg>-y <replaceable>key</replaceable></arg> <arg>-y <replaceable>key</replaceable></arg>
<arg>-z <replaceable>zone</replaceable></arg>
<arg choice="plain"><replaceable>command</replaceable></arg> <arg choice="plain"><replaceable>command</replaceable></arg>
<arg rep="repeat"><replaceable>command</replaceable></arg> <arg rep="repeat"><replaceable>command</replaceable></arg>
</cmdsynopsis> </cmdsynopsis>
<para><command>command</command> is one of the following <para><command>command</command> is one of the following:</para>
for <command>named</command>:</para>
<informaltable colsep = "0" rowsep = "0"> <informaltable colsep = "0" rowsep = "0">
<tgroup cols = "2" <tgroup cols = "2" colsep = "0" rowsep = "0" tgroupstyle = "4Level-table">
colsep = "0" rowsep = "0" tgroupstyle = "4Level-table"> <colspec colname = "1" colnum = "1" colsep = "0" colwidth = "3.000in"/>
<colspec colname = "1" colnum = "1" <colspec colname = "2" colnum = "2" colsep = "0" colwidth = "3.000in"/>
colsep = "0" colwidth = "1.500in"/> <tbody>
<colspec colname = "2" colnum = "2" colsep = "0"
colwidth = "3.000in"/>
<tbody>
<row rowsep = "0">
<entry colname = "1">
<para><userinput>status</userinput><footnote id="nyi1">
<para>not yet implemented</para>
</footnote></para></entry>
<entry colname = "2"><para>Display ps(1) status of named.</para></entry>
</row>
<row rowsep = "0">
<entry colname = "1"><para><userinput>dumpdb</userinput><footnoteref linkend="nyi1"/></para></entry>
<entry colname = "2"><para>Dump database and cache to /var/tmp/named_dump.db.</para></entry>
</row>
<row rowsep = "0">
<entry colname = "1"><para><userinput>refresh</userinput></para></entry>
<entry colname = "2"><para>Force a refresh of specified zone.</para></entry>
</row>
<row rowsep = "0"> <row rowsep = "0">
<entry colname = "1"><para><userinput>reload</userinput></para></entry> <entry colname = "1"><para><userinput>reload</userinput></para></entry>
<entry colname = "2"><para>Reload configuration file and zones.</para></entry> <entry colname = "2"><para>Reload configuration file and zones.</para></entry>
</row> </row>
<row rowsep = "0">
<entry colname = "1"><para><userinput>reload <replaceable>zone</replaceable> <optional><replaceable>class</replaceable> <optional><replaceable>view</replaceable></optional></optional></userinput></para></entry>
<entry colname = "2"><para>Reload the given zone.</para></entry>
</row>
<row rowsep = "0">
<entry colname = "1"><para><userinput>refresh <replaceable>zone</replaceable> <optional><replaceable>class</replaceable> <optional><replaceable>view</replaceable></optional></optional></userinput></para></entry>
<entry colname = "2"><para>Schedule zone maintenance for the given zone.</para></entry>
</row>
<row rowsep = "0"> <row rowsep = "0">
<entry colname = "1"><para><userinput>stats</userinput></para></entry> <entry colname = "1"><para><userinput>stats</userinput></para></entry>
<entry colname = "2"><para>Dump statistics to /var/tmp/named.stats.</para></entry> <entry colname = "2"><para>Write server statistics to the statistics file.</para></entry>
</row> </row>
<row rowsep = "0"> <row rowsep = "0">
<entry colname = "1"><para><userinput>trace</userinput><footnoteref linkend="nyi1"/></para></entry> <entry colname = "1"><para><userinput>querylog</userinput></para></entry>
<entry colname = "2"><para>Increment debugging level by one.</para></entry>
</row>
<row rowsep = "0">
<entry colname = "1">
<para><userinput>notrace</userinput><footnoteref linkend="nyi1"/>
</para></entry>
<entry colname = "2"><para>Set debugging level to 0.</para></entry>
</row>
<row rowsep = "0">
<entry colname =
"1"><para><userinput>querylog</userinput></para></entry>
<entry colname = "2"><para>Toggle query logging.</para></entry> <entry colname = "2"><para>Toggle query logging.</para></entry>
</row> </row>
<row rowsep = "0"> <row rowsep = "0">
<entry colname = <entry colname = "1"><para><userinput>stop</userinput></para></entry>
"1"><para><userinput>stop</userinput><footnoteref linkend="nyi1"/></para></entry> <entry colname = "2"><para>Stop the server, making sure any recent changes
<entry colname = "2"><para>Stop the server.</para></entry> made through dynamic update or IXFR are first saved to the master files
of the updated zones.</para></entry>
</row> </row>
<row rowsep = "0"> <row rowsep = "0">
<entry colname = <entry colname = "1"><para><userinput>halt</userinput></para></entry>
"1"><para><userinput>restart</userinput><footnoteref linkend="nyi1"/></para></entry> <entry colname = "2"><para>Stop the server immediately. Recent changes
<entry colname = "2"><para>Restart the server.</para></entry> made through dynamic update or IXFR are not saved to the master files,
</row> but will be rolled forward from the journal files when the server
</tbody> is restarted.</para></entry>
</tgroup> </row>
</informaltable>
<para>As noted above, only a limited number of commands are </tbody>
available in <acronym>BIND</acronym> 9.1. The other </tgroup>
commands, and more, are planned to be implemented for </informaltable>
future releases.</para>
<para>In <acronym>BIND</acronym> 9.1, <command>rndc</command> does not
yet support all the commands of the BIND 8 <command>ndc</command>
utility. Additonal commands will be added in future releases.</para>
<para>A configuration file is required, since all <para>A configuration file is required, since all
communication with the server is authenticated with communication with the server is authenticated with
@@ -2045,15 +2033,11 @@ Usage</title>
the <command>key_list</command> is allowed to be used to the <command>key_list</command> is allowed to be used to
authenticate commands and responses given over the control authenticate commands and responses given over the control
channel by digitally signing each message between the server and channel by digitally signing each message between the server and
a command client (See <xref linkend="rndc"/> in <xref a command client (See <xref linkend="rndc"/> in
linkend="admin_tools"/>). All commands to the <xref linkend="admin_tools"/>). All commands to the control channel
control channel must be signed by one of its specified keys to must be signed by one of its specified keys to
be honored.</para> be honored.</para>
<para> For the initial release of <acronym>BIND</acronym> 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.</para>
<para>The UNIX control channel type of <acronym>BIND</acronym> 8 is not supported <para>The UNIX control channel type of <acronym>BIND</acronym> 8 is not supported
in <acronym>BIND</acronym> 9.0.0, and is not expected to be added in future in <acronym>BIND</acronym> 9.0.0, and is not expected to be added in future
releases. If it is present in the controls statement from a releases. If it is present in the controls statement from a
@@ -5602,6 +5586,3 @@ of queries resulted in a SERVFAIL reply.</para></entry>
</appendix> </appendix>
</book> </book>