Commit 852e369a authored by Jeremy C. Reed's avatar Jeremy C. Reed
Browse files

[master] regenerate log messages docs

parent 53c587e4
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>BIND 10 Messages Manual</title><link rel="stylesheet" href="./bind10-guide.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="description" content="BIND 10 is a Domain Name System (DNS) suite managed by Internet Systems Consortium (ISC). It includes DNS libraries and modular components for controlling authoritative and recursive DNS servers. This is the messages manual for BIND 10 version 20120712. The most up-to-date version of this document, along with other documents for BIND 10, can be found at ."></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="book" title="BIND 10 Messages Manual"><div class="titlepage"><div><div><h1 class="title"><a name="id1168229451102"></a>BIND 10 Messages Manual</h1></div><div><p class="releaseinfo">This is the messages manual for BIND 10 version
20120712.</p></div><div><p class="copyright">Copyright © 2011-2012 Internet Systems Consortium, Inc.</p></div><div><div class="abstract" title="Abstract"><p class="title"><b>Abstract</b></p><p>BIND 10 is a Domain Name System (DNS) suite managed by
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>BIND 10 Messages Manual</title><link rel="stylesheet" href="./bind10-guide.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="description" content="BIND 10 is a Domain Name System (DNS) suite managed by Internet Systems Consortium (ISC). It includes DNS libraries and modular components for controlling authoritative and recursive DNS servers. This is the messages manual for BIND 10 version 20120817. The most up-to-date version of this document, along with other documents for BIND 10, can be found at ."></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="book" title="BIND 10 Messages Manual"><div class="titlepage"><div><div><h1 class="title"><a name="id1168229451102"></a>BIND 10 Messages Manual</h1></div><div><p class="releaseinfo">This is the messages manual for BIND 10 version
20120817.</p></div><div><p class="copyright">Copyright © 2011-2012 Internet Systems Consortium, Inc.</p></div><div><div class="abstract" title="Abstract"><p class="title"><b>Abstract</b></p><p>BIND 10 is a Domain Name System (DNS) suite managed by
Internet Systems Consortium (ISC). It includes DNS libraries
and modular components for controlling authoritative and
recursive DNS servers.
</p><p>
This is the messages manual for BIND 10 version 20120712.
This is the messages manual for BIND 10 version 20120817.
The most up-to-date version of this document, along with
other documents for BIND 10, can be found at
<a class="ulink" href="http://bind10.isc.org/docs" target="_top">http://bind10.isc.org/docs</a>.
......@@ -154,10 +154,6 @@ This debug message is logged by the authoritative server when it receives
a NOTIFY packet that an RR type of something other than SOA in the
question section. (The RR type received is included in the message.) The
server will return a FORMERR error to the sender.
</p></dd><dt><a name="AUTH_NO_STATS_SESSION"></a><span class="term">AUTH_NO_STATS_SESSION session interface for statistics is not available</span></dt><dd><p>
The authoritative server had no session with the statistics module at the
time it attempted to send it data: the attempt has been abandoned. This
could be an error in configuration.
</p></dd><dt><a name="AUTH_NO_XFRIN"></a><span class="term">AUTH_NO_XFRIN received NOTIFY but XFRIN session is not running</span></dt><dd><p>
This is a debug message produced by the authoritative server when it receives
a NOTIFY packet but the XFRIN process is not running. The packet will be
......@@ -193,11 +189,6 @@ This is a debug message issued when the authoritative server has received
a command on the command channel.
</p></dd><dt><a name="AUTH_RECEIVED_NOTIFY"></a><span class="term">AUTH_RECEIVED_NOTIFY received incoming NOTIFY for zone name %1, zone class %2</span></dt><dd><p>
This is a debug message reporting that an incoming NOTIFY was received.
</p></dd><dt><a name="AUTH_RECEIVED_SENDSTATS"></a><span class="term">AUTH_RECEIVED_SENDSTATS command 'sendstats' received</span></dt><dd><p>
This is a debug message issued when the authoritative server has received
a command from the statistics module to send it data. The 'sendstats'
command is handled differently to other commands, which is why the debug
message associated with it has its own code.
</p></dd><dt><a name="AUTH_RESPONSE_FAILURE"></a><span class="term">AUTH_RESPONSE_FAILURE exception while building response to query: %1</span></dt><dd><p>
This is a debug message, generated by the authoritative server when an
attempt to create a response to a received DNS packet has failed. The
......@@ -222,7 +213,7 @@ Note: This message includes the packet sent, rendered in the form of
multiple lines of text. For this reason, it is suggested that this log message
not be routed to the syslog file, where the multiple lines could confuse
programs that expect a format of one message per line.
</p></dd><dt><a name="AUTH_SEND_NORMAL_RESPONSE"></a><span class="term">AUTH_SEND_NORMAL_RESPONSE sending an error response (%1 bytes):\n%2</span></dt><dd><p>
</p></dd><dt><a name="AUTH_SEND_NORMAL_RESPONSE"></a><span class="term">AUTH_SEND_NORMAL_RESPONSE sending a normal response (%1 bytes):\n%2</span></dt><dd><p>
This is a debug message recording that the authoritative server is sending
a response to the originator of a query.
</p><p>
......@@ -254,31 +245,6 @@ that it should internally forward UPDATE message to b10-ddns. When b10-ddns
is not running, b10-auth will respond to UPDATE requests with rcode NOTIMP.
When b10-ddns is running, b10-ddns will handle and respond to the UPDATE
message.
</p></dd><dt><a name="AUTH_STATS_CHANNEL_CREATED"></a><span class="term">AUTH_STATS_CHANNEL_CREATED STATS session channel created</span></dt><dd><p>
This is a debug message indicating that the authoritative server has
created a channel to the statistics process. It is issued during server
startup is an indication that the initialization is proceeding normally.
</p></dd><dt><a name="AUTH_STATS_CHANNEL_ESTABLISHED"></a><span class="term">AUTH_STATS_CHANNEL_ESTABLISHED STATS session channel established</span></dt><dd><p>
This is a debug message indicating that the authoritative server
has established communication over the previously created statistics
channel. It is issued during server startup is an indication that the
initialization is proceeding normally.
</p></dd><dt><a name="AUTH_STATS_COMMS"></a><span class="term">AUTH_STATS_COMMS communication error in sending statistics data: %1</span></dt><dd><p>
An error was encountered when the authoritative server tried to send data
to the statistics daemon. The message includes additional information
describing the reason for the failure.
</p></dd><dt><a name="AUTH_STATS_TIMEOUT"></a><span class="term">AUTH_STATS_TIMEOUT timeout while sending statistics data: %1</span></dt><dd><p>
The authoritative server sent data to the statistics daemon but received
no acknowledgement within the specified time. The message includes
additional information describing the reason for the failure.
</p></dd><dt><a name="AUTH_STATS_TIMER_DISABLED"></a><span class="term">AUTH_STATS_TIMER_DISABLED statistics timer has been disabled</span></dt><dd><p>
This is a debug message indicating that the statistics timer has been
disabled in the authoritative server and no statistics information is
being produced.
</p></dd><dt><a name="AUTH_STATS_TIMER_SET"></a><span class="term">AUTH_STATS_TIMER_SET statistics timer set to %1 second(s)</span></dt><dd><p>
This is a debug message indicating that the statistics timer has been
enabled and that the authoritative server will produce statistics data
at the specified interval.
</p></dd><dt><a name="AUTH_STOP_DDNS_FORWARDER"></a><span class="term">AUTH_STOP_DDNS_FORWARDER DDNS UPDATE handling stopped</span></dt><dd><p>
This is a debug message indicating that b10-auth has received a message
that it should stop internally forwarding UPDATE message to b10-ddns.
......@@ -1111,6 +1077,10 @@ is provided as a master file and it can be served from memory cache only.
Therefore, the zone will not be available for this process. If this is
a problem, you should move the zone to some database backend (sqlite3, for
example) and use it from there.
</p></dd><dt><a name="DATASRC_MASTERLOAD_ERROR"></a><span class="term">DATASRC_MASTERLOAD_ERROR %1</span></dt><dd><p>
An error was found in the zone data for a MasterFiles zone. The zone
is not loaded. The specific error is shown in the message, and should
be addressed.
</p></dd><dt><a name="DATASRC_MEM_ADD_RRSET"></a><span class="term">DATASRC_MEM_ADD_RRSET adding RRset '%1/%2' into zone '%3'</span></dt><dd><p>
Debug information. An RRset is being added to the in-memory data source.
</p></dd><dt><a name="DATASRC_MEM_ADD_WILDCARD"></a><span class="term">DATASRC_MEM_ADD_WILDCARD adding wildcards for '%1'</span></dt><dd><p>
......@@ -1479,10 +1449,19 @@ for and not found, the software searches for the "previous" name,
example.com). However, this name is not contained in any zone in the
data source. This is an error since it indicates a problem in the earlier
processing of the query.
</p></dd><dt><a name="DATASRC_SQLITE_SETUP"></a><span class="term">DATASRC_SQLITE_SETUP setting up SQLite database</span></dt><dd><p>
</p></dd><dt><a name="DATASRC_SQLITE_SETUP"></a><span class="term">DATASRC_SQLITE_SETUP setting up new SQLite3 database in '%1'</span></dt><dd><p>
The database for SQLite data source was found empty. It is assumed this is the
first run and it is being initialized with current schema. It'll still contain
no data, but it will be ready for use. If this is indeed the first run of
BIND 10, it is to be expected and completely harmless. If you just configured
a data source to point to an existing file and you see this, you may have
misspelled the file name.
</p></dd><dt><a name="DATASRC_SQLITE_SETUP_OLD_API"></a><span class="term">DATASRC_SQLITE_SETUP_OLD_API setting up new SQLite database</span></dt><dd><p>
The database for SQLite data source was found empty. It is assumed this is the
first run and it is being initialized with current schema. It'll still contain
no data, but it will be ready for use.
no data, but it will be ready for use. This is similar to DATASRC_SQLITE_SETUP
message, but it is logged from the old API. You should never see it, since the
API is deprecated.
</p></dd><dt><a name="DATASRC_STATIC_CLASS_NOT_CH"></a><span class="term">DATASRC_STATIC_CLASS_NOT_CH static data source can handle CH class only</span></dt><dd><p>
An error message indicating that a query requesting a RR for a class other
that CH was sent to the static data source (which only handles CH queries).
......@@ -2773,6 +2752,9 @@ not start.
The stats module was unable to connect to the BIND 10 command and
control bus. A likely problem is that the message bus daemon
(b10-msgq) is not running. The stats module will now shut down.
</p></dd><dt><a name="STATS_RECEIVED_INVALID_STATISTICS_DATA"></a><span class="term">STATS_RECEIVED_INVALID_STATISTICS_DATA received invalid statistics data from %1</span></dt><dd><p>
Invalid statistics data has been received from the module while
polling and it has been discarded.
</p></dd><dt><a name="STATS_RECEIVED_NEW_CONFIG"></a><span class="term">STATS_RECEIVED_NEW_CONFIG received new configuration: %1</span></dt><dd><p>
This debug message is printed when the stats module has received a
configuration update from the configuration manager.
......@@ -2794,8 +2776,8 @@ response indicating that it is running normally.
</p></dd><dt><a name="STATS_RECEIVED_UNKNOWN_COMMAND"></a><span class="term">STATS_RECEIVED_UNKNOWN_COMMAND received unknown command: %1</span></dt><dd><p>
An unknown command has been sent to the stats module. The stats module
will respond with an error and the command will be ignored.
</p></dd><dt><a name="STATS_SEND_REQUEST_BOSS"></a><span class="term">STATS_SEND_REQUEST_BOSS requesting boss to send statistics</span></dt><dd><p>
This debug message is printed when a request is sent to the boss module
</p></dd><dt><a name="STATS_SEND_STATISTICS_REQUEST"></a><span class="term">STATS_SEND_STATISTICS_REQUEST requesting %1 to send statistics</span></dt><dd><p>
This debug message is printed when a request is sent to the module
to send its data to the stats module.
</p></dd><dt><a name="STATS_STARTING"></a><span class="term">STATS_STARTING starting</span></dt><dd><p>
The stats module will be now starting.
......
......@@ -341,15 +341,6 @@ server will return a FORMERR error to the sender.
</para></listitem>
</varlistentry>
<varlistentry id="AUTH_NO_STATS_SESSION">
<term>AUTH_NO_STATS_SESSION session interface for statistics is not available</term>
<listitem><para>
The authoritative server had no session with the statistics module at the
time it attempted to send it data: the attempt has been abandoned. This
could be an error in configuration.
</para></listitem>
</varlistentry>
<varlistentry id="AUTH_NO_XFRIN">
<term>AUTH_NO_XFRIN received NOTIFY but XFRIN session is not running</term>
<listitem><para>
......@@ -465,7 +456,7 @@ programs that expect a format of one message per line.
</varlistentry>
<varlistentry id="AUTH_SEND_NORMAL_RESPONSE">
<term>AUTH_SEND_NORMAL_RESPONSE sending an error response (%1 bytes):\n%2</term>
<term>AUTH_SEND_NORMAL_RESPONSE sending a normal response (%1 bytes):\n%2</term>
<listitem><para>
This is a debug message recording that the authoritative server is sending
a response to the originator of a query.
......@@ -531,61 +522,6 @@ message.
</para></listitem>
</varlistentry>
<varlistentry id="AUTH_STATS_CHANNEL_CREATED">
<term>AUTH_STATS_CHANNEL_CREATED STATS session channel created</term>
<listitem><para>
This is a debug message indicating that the authoritative server has
created a channel to the statistics process. It is issued during server
startup is an indication that the initialization is proceeding normally.
</para></listitem>
</varlistentry>
<varlistentry id="AUTH_STATS_CHANNEL_ESTABLISHED">
<term>AUTH_STATS_CHANNEL_ESTABLISHED STATS session channel established</term>
<listitem><para>
This is a debug message indicating that the authoritative server
has established communication over the previously created statistics
channel. It is issued during server startup is an indication that the
initialization is proceeding normally.
</para></listitem>
</varlistentry>
<varlistentry id="AUTH_STATS_COMMS">
<term>AUTH_STATS_COMMS communication error in sending statistics data: %1</term>
<listitem><para>
An error was encountered when the authoritative server tried to send data
to the statistics daemon. The message includes additional information
describing the reason for the failure.
</para></listitem>
</varlistentry>
<varlistentry id="AUTH_STATS_TIMEOUT">
<term>AUTH_STATS_TIMEOUT timeout while sending statistics data: %1</term>
<listitem><para>
The authoritative server sent data to the statistics daemon but received
no acknowledgement within the specified time. The message includes
additional information describing the reason for the failure.
</para></listitem>
</varlistentry>
<varlistentry id="AUTH_STATS_TIMER_DISABLED">
<term>AUTH_STATS_TIMER_DISABLED statistics timer has been disabled</term>
<listitem><para>
This is a debug message indicating that the statistics timer has been
disabled in the authoritative server and no statistics information is
being produced.
</para></listitem>
</varlistentry>
<varlistentry id="AUTH_STATS_TIMER_SET">
<term>AUTH_STATS_TIMER_SET statistics timer set to %1 second(s)</term>
<listitem><para>
This is a debug message indicating that the statistics timer has been
enabled and that the authoritative server will produce statistics data
at the specified interval.
</para></listitem>
</varlistentry>
<varlistentry id="AUTH_STOP_DDNS_FORWARDER">
<term>AUTH_STOP_DDNS_FORWARDER DDNS UPDATE handling stopped</term>
<listitem><para>
......@@ -2508,6 +2444,15 @@ example) and use it from there.
</para></listitem>
</varlistentry>
<varlistentry id="DATASRC_MASTERLOAD_ERROR">
<term>DATASRC_MASTERLOAD_ERROR %1</term>
<listitem><para>
An error was found in the zone data for a MasterFiles zone. The zone
is not loaded. The specific error is shown in the message, and should
be addressed.
</para></listitem>
</varlistentry>
<varlistentry id="DATASRC_MEM_ADD_RRSET">
<term>DATASRC_MEM_ADD_RRSET adding RRset '%1/%2' into zone '%3'</term>
<listitem><para>
......@@ -3422,11 +3367,25 @@ processing of the query.
</varlistentry>
<varlistentry id="DATASRC_SQLITE_SETUP">
<term>DATASRC_SQLITE_SETUP setting up SQLite database</term>
<term>DATASRC_SQLITE_SETUP setting up new SQLite3 database in '%1'</term>
<listitem><para>
The database for SQLite data source was found empty. It is assumed this is the
first run and it is being initialized with current schema. It'll still contain
no data, but it will be ready for use.
no data, but it will be ready for use. If this is indeed the first run of
BIND 10, it is to be expected and completely harmless. If you just configured
a data source to point to an existing file and you see this, you may have
misspelled the file name.
</para></listitem>
</varlistentry>
<varlistentry id="DATASRC_SQLITE_SETUP_OLD_API">
<term>DATASRC_SQLITE_SETUP_OLD_API setting up new SQLite database</term>
<listitem><para>
The database for SQLite data source was found empty. It is assumed this is the
first run and it is being initialized with current schema. It'll still contain
no data, but it will be ready for use. This is similar to DATASRC_SQLITE_SETUP
message, but it is logged from the old API. You should never see it, since the
API is deprecated.
</para></listitem>
</varlistentry>
......@@ -6045,6 +6004,14 @@ control bus. A likely problem is that the message bus daemon
</para></listitem>
</varlistentry>
<varlistentry id="STATS_RECEIVED_INVALID_STATISTICS_DATA">
<term>STATS_RECEIVED_INVALID_STATISTICS_DATA received invalid statistics data from %1</term>
<listitem><para>
Invalid statistics data has been received from the module while
polling and it has been discarded.
</para></listitem>
</varlistentry>
<varlistentry id="STATS_RECEIVED_NEW_CONFIG">
<term>STATS_RECEIVED_NEW_CONFIG received new configuration: %1</term>
<listitem><para>
......@@ -6106,10 +6073,10 @@ will respond with an error and the command will be ignored.
</para></listitem>
</varlistentry>
<varlistentry id="STATS_SEND_REQUEST_BOSS">
<term>STATS_SEND_REQUEST_BOSS requesting boss to send statistics</term>
<varlistentry id="STATS_SEND_STATISTICS_REQUEST">
<term>STATS_SEND_STATISTICS_REQUEST requesting %1 to send statistics</term>
<listitem><para>
This debug message is printed when a request is sent to the boss module
This debug message is printed when a request is sent to the module
to send its data to the stats module.
</para></listitem>
</varlistentry>
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment