[svn] commit: r2693 - in /trunk: ChangeLog src/bin/auth/b10-auth.xml src/bin/bind10/bind10.xml src/bin/msgq/msgq.xml
BIND 10 source code commits
bind10-changes at lists.isc.org
Tue Aug 10 20:11:46 UTC 2010
Author: jreed
Date: Tue Aug 10 20:11:46 2010
New Revision: 2693
Log:
Add or change some options in manual pages.
Features were changed in previous commits, but docs not done at same time.
Also update old ChangeLog entry to mention the removed or changed
options specifically. This was for a previous release and nobody
noticed, but I am doing this for an example for future release
notes.
Modified:
trunk/ChangeLog
trunk/src/bin/auth/b10-auth.xml
trunk/src/bin/bind10/bind10.xml
trunk/src/bin/msgq/msgq.xml
Modified: trunk/ChangeLog
==============================================================================
--- trunk/ChangeLog (original)
+++ trunk/ChangeLog Tue Aug 10 20:11:46 2010
@@ -218,7 +218,11 @@
a remote server. (Trac #218, svn r2038)
49. [func]* jelte
- Use unix domain sockets for msgq. (Trac #183, svn r2009)
+ Use unix domain sockets for msgq. For b10-msgq, the command
+ line options --msgq-port and -m were removed. For bind10,
+ the -msgq-port option was removed, and the -m command line
+ option was changed to be a filename (instead of port number).
+ (Trac #183, svn r2009)
48. [func] jelte
bin/auth: Use asio's io_service for the msgq handling.
Modified: trunk/src/bin/auth/b10-auth.xml
==============================================================================
--- trunk/src/bin/auth/b10-auth.xml (original)
+++ trunk/src/bin/auth/b10-auth.xml Tue Aug 10 20:11:46 2010
@@ -21,7 +21,7 @@
<refentry>
<refentryinfo>
- <date>March 16, 2010</date>
+ <date>July 29, 2010</date>
</refentryinfo>
<refmeta>
@@ -47,6 +47,8 @@
<command>b10-auth</command>
<arg><option>-4</option></arg>
<arg><option>-6</option></arg>
+ <arg><option>-a <replaceable>address</replaceable></option></arg>
+ <arg><option>-n</option></arg>
<arg><option>-p <replaceable>number</replaceable></option></arg>
<arg><option>-u <replaceable>username</replaceable></option></arg>
<arg><option>-v</option></arg>
@@ -96,7 +98,8 @@
<term><option>-4</option></term>
<listitem><para>
Enables IPv4 only mode.
- This switch may not be used with <option>-6</option>.
+ This switch may not be used with <option>-6</option> nor
+ <option>-a</option>.
By default, it listens on both IPv4 and IPv6 (if capable).
</para></listitem>
</varlistentry>
@@ -105,8 +108,33 @@
<term><option>-6</option></term>
<listitem><para>
Enables IPv6 only mode.
- This switch may not be used with <option>-4</option>.
+ This switch may not be used with <option>-4</option> nor
+ <option>-a</option>.
By default, it listens on both IPv4 and IPv6 (if capable).
+ </para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-a <replaceable>address</replaceable></option></term>
+
+ <listitem>
+ <para>The IPv4 or IPv6 address to listen on.
+ This switch may not be used with <option>-4</option> nor
+ <option>-6</option>.
+ The default is to listen on all addresses.
+ (This is a short term workaround. This argument may change.)
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-n</option></term>
+ <listitem><para>
+ Do not cache answers in memory.
+ The default is to use the cache for faster responses.
+ The cache keeps the most recent 30,000 answers (positive
+ and negative) in memory for 30 seconds (instead of querying
+ the data source, such as SQLite3 database, each time).
</para></listitem>
</varlistentry>
Modified: trunk/src/bin/bind10/bind10.xml
==============================================================================
--- trunk/src/bin/bind10/bind10.xml (original)
+++ trunk/src/bin/bind10/bind10.xml Tue Aug 10 20:11:46 2010
@@ -21,7 +21,7 @@
<refentry>
<refentryinfo>
- <date>April 19, 2010</date>
+ <date>July 29, 2010</date>
</refentryinfo>
<refmeta>
@@ -45,12 +45,18 @@
<refsynopsisdiv>
<cmdsynopsis>
<command>bind10</command>
- <arg><option>-m <replaceable>number</replaceable></option></arg>
+ <arg><option>-a <replaceable>address</replaceable></option></arg>
+ <arg><option>-m <replaceable>file</replaceable></option></arg>
+ <arg><option>-n</option></arg>
<arg><option>-p <replaceable>number</replaceable></option></arg>
+ <arg><option>-u <replaceable>user</replaceable></option></arg>
<arg><option>-v</option></arg>
- <arg><option>-msgq-port <replaceable>number</replaceable></option></arg>
- <arg><option>-port <replaceable>number</replaceable></option></arg>
- <arg><option>-verbose</option></arg>
+ <arg><option>--address <replaceable>address</replaceable></option></arg>
+ <arg><option>--msgq-socket-file <replaceable>file</replaceable></option></arg>
+ <arg><option>--no-cache</option></arg>
+ <arg><option>--port <replaceable>number</replaceable></option></arg>
+ <arg><option>--user <replaceable>user</replaceable></option></arg>
+ <arg><option>--verbose</option></arg>
</cmdsynopsis>
</refsynopsisdiv>
@@ -80,14 +86,40 @@
<variablelist>
<varlistentry>
- <term><option>-m</option> <replaceable>number</replaceable>, <option>--msgq-port</option> <replaceable>number</replaceable></term>
-
- <listitem>
- <para>The port number for the
+ <term><option>-a</option> <replaceable>address</replaceable>, <option>--address</option> <replaceable>address</replaceable></term>
+
+ <listitem>
+ <para>The IPv4 or IPv6 address for the
+ <citerefentry><refentrytitle>b10-auth</refentrytitle><manvolnum>8</manvolnum></citerefentry>
+ daemon to listen on.
+ The default is to listen on all addresses.
+ (This is a short term workaround. This argument may change.)
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-m</option> <replaceable>file</replaceable>,
+ <option>--msgq-socket-file</option> <replaceable>file</replaceable></term>
+
+ <listitem>
+ <para>The UNIX domain socket file for the
<citerefentry><refentrytitle>b10-msgq</refentrytitle><manvolnum>8</manvolnum></citerefentry>
- daemon to listen on.
- The default is 9912.</para>
- </listitem>
+ daemon to use.
+ The default is
+ <filename>/usr/local/var/bind10-devel/msg_socket</filename>.
+<!-- @localstatedir@/@PACKAGE_NAME@/msg_socket -->
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-n</option>, <option>--no-cache</option></term>
+ <listitem>
+ <para>Disables the hot-spot caching used by the
+ <citerefentry><refentrytitle>b10-auth</refentrytitle><manvolnum>8</manvolnum></citerefentry>
+ daemon.</para>
+ </listitem>
</varlistentry>
<varlistentry>
@@ -105,6 +137,18 @@
</varlistentry>
<varlistentry>
+ <term><option>-u</option> <replaceable>user</replaceable>, <option>--user</option> <replaceable>name</replaceable></term>
+
+ <listitem>
+ <para>The username for <command>bind10</command> to run as.
+<!-- TODO: example more detail. -->
+ <command>bind10</command> must be initially ran as the
+ root user to use this option.
+ The default is to run as the current user.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
<term><option>-v</option>, <option>--verbose</option></term>
<listitem>
<para>Display more about what is going on for
@@ -112,6 +156,7 @@
<!-- TODO: not true about all children yet -->
</listitem>
</varlistentry>
+
</variablelist>
</refsect1>
Modified: trunk/src/bin/msgq/msgq.xml
==============================================================================
--- trunk/src/bin/msgq/msgq.xml (original)
+++ trunk/src/bin/msgq/msgq.xml Tue Aug 10 20:11:46 2010
@@ -21,7 +21,7 @@
<refentry>
<refentryinfo>
- <date>April 19, 2010</date>
+ <date>August 4, 2010</date>
</refentryinfo>
<refmeta>
@@ -45,9 +45,9 @@
<refsynopsisdiv>
<cmdsynopsis>
<command>b10-msgq</command>
- <arg><option>-m <replaceable>number</replaceable></option></arg>
+ <arg><option>-s <replaceable>file</replaceable></option></arg>
<arg><option>-v</option></arg>
- <arg><option>--msgq-port <replaceable>number</replaceable></option></arg>
+ <arg><option>--socket-file <replaceable>file</replaceable></option></arg>
<arg><option>--verbose</option></arg>
</cmdsynopsis>
</refsynopsisdiv>
@@ -111,12 +111,14 @@
<variablelist>
<varlistentry>
- <term><option>-m <replaceable>number</replaceable></option>,
- <option>--msgq-port <replaceable>number</replaceable></option></term>
+ <term><option>-s <replaceable>file</replaceable></option>,
+ <option>--socket-file <replaceable>file</replaceable></option></term>
<listitem><para>
- The port number that <command>b10-msgq</command> will listen on.
- The default is 9912.</para>
- </listitem>
+ The UNIX domain socket file this daemon will use.
+ The default is
+ <filename>/usr/local/var/bind10-devel/msg_socket</filename>.
+<!-- @localstatedir@/@PACKAGE_NAME@/msg_socket -->
+ </para></listitem>
</varlistentry>
<varlistentry>
More information about the bind10-changes
mailing list