diff --git a/doc/guide/bind10-guide.html b/doc/guide/bind10-guide.html index 069f508c09..5754cf001e 100644 --- a/doc/guide/bind10-guide.html +++ b/doc/guide/bind10-guide.html @@ -6,7 +6,7 @@

This is the reference guide for BIND 10 version 20110519. The most up-to-date version of this document, along with - other documents for BIND 10, can be found at http://bind10.isc.org/docs.


Table of Contents

1. Introduction
Supported Platforms
Required Software
Starting and Stopping the Server
Managing BIND 10
2. Installation
Building Requirements
Quick start
Installation from source
Download Tar File
Retrieve from Git
Configure before the build
Build
Install
Install Hierarchy
3. Starting BIND10 with bind10
Starting BIND 10
4. Command channel
5. Configuration manager
6. Remote control daemon
Configuration specification for b10-cmdctl
7. Control and configure user interface
8. Authoritative Server
Server Configurations
Data Source Backends
Loading Master Zones Files
9. Incoming Zone Transfers
10. Outbound Zone Transfers
11. Secondary Manager
12. Recursive Name Server
Forwarding
13. Statistics

Chapter 1. Introduction

Table of Contents

Supported Platforms
Required Software
Starting and Stopping the Server
Managing BIND 10

+ other documents for BIND 10, can be found at http://bind10.isc.org/docs.


Table of Contents

1. Introduction
Supported Platforms
Required Software
Starting and Stopping the Server
Managing BIND 10
2. Installation
Building Requirements
Quick start
Installation from source
Download Tar File
Retrieve from Git
Configure before the build
Build
Install
Install Hierarchy
3. Starting BIND10 with bind10
Starting BIND 10
4. Command channel
5. Configuration manager
6. Remote control daemon
Configuration specification for b10-cmdctl
7. Control and configure user interface
8. Authoritative Server
Server Configurations
Data Source Backends
Loading Master Zones Files
9. Incoming Zone Transfers
10. Outbound Zone Transfers
11. Secondary Manager
12. Recursive Name Server
Forwarding
13. Statistics
14. Logging

Chapter 1. Introduction

Table of Contents

Supported Platforms
Required Software
Starting and Stopping the Server
Managing BIND 10

BIND is the popular implementation of a DNS server, developer interfaces, and DNS tools. BIND 10 is a rewrite of BIND 9. BIND 10 is written in C++ and Python @@ -684,4 +684,48 @@ This may be a temporary setting until then. "stats.timestamp": 1295543046.823504 }

+

Chapter 14. Logging

+ Each message written by BIND 10 to the configured logging destinations + comprises a number of components that identify the origin of the + message and, if the message indicates a problem, information about the + problem that may be useful in fixing it. +

+ Consider the message below logged to a file: +

2011-06-15 13:48:22.034 ERROR [b10-resolver.asiolink]
+    ASIODNS_OPENSOCK error 111 opening TCP socket to 127.0.0.1(53)

+

+ Note: the layout of messages written to the system logging + file (syslog) may be slightly different. This message has + been split across two lines here for display reasons; in the + logging file, it will appear on one line.) +

+ The log message comprises a number of components: + +

2011-06-15 13:48:22.034

+ The date and time at which the message was generated. +

ERROR

+ The severity of the message. +

[b10-resolver.asiolink]

+ The source of the message. This comprises two components: + the BIND 10 process generating the message (in this + case, b10-resolver) and the module + within the program from which the message originated + (which in the example is the asynchronous I/O link + module, asiolink). +

ASIODNS_OPENSOCK

+ The message identification. Every message in BIND 10 + has a unique identification, which can be used as an + index into the BIND 10 Messages + Manual (http://bind10.isc.org/docs/bind10-messages.html) from which more information can be obtained. +

error 111 opening TCP socket to 127.0.0.1(53)

+ A brief description of the cause of the problem. Within this text, + information relating to the condition that caused the message to + be logged will be included. In this example, error number 111 + (an operating system-specific error number) was encountered when + trying to open a TCP connection to port 53 on the local system + (address 127.0.0.1). The next step would be to find out the reason + for the failure by consulting your system's documentation to + identify what error number 111 means. +

+

diff --git a/doc/guide/bind10-guide.xml b/doc/guide/bind10-guide.xml index 60989e68b9..e80bc7f2e7 100644 --- a/doc/guide/bind10-guide.xml +++ b/doc/guide/bind10-guide.xml @@ -1439,19 +1439,28 @@ then change those defaults with config set Resolver/forward_addresses[0]/address - Each message written by BIND10 to the configured logging destinations + Each message written by BIND 10 to the configured logging destinations comprises a number of components that identify the origin of the message and, if the message indicates a problem, information about the problem that may be useful in fixing it. + - Consider the message below logged to a file (the layout of messages - written to the system logging file (syslog) may be slightly different). - 2011-06-15 13:48:22.034 ERROR [b10-resolver.asiolink] - ASIODNS_OPENSOCK, error 111 opening TCP socket to 127.0.0.1(53) - (The error has been split across two lines here for display reasons. - In the logging file, it will appear on one line.) The log message - comprises a number of components: + Consider the message below logged to a file: + 2011-06-15 13:48:22.034 ERROR [b10-resolver.asiolink] + ASIODNS_OPENSOCK error 111 opening TCP socket to 127.0.0.1(53) + + + + Note: the layout of messages written to the system logging + file (syslog) may be slightly different. This message has + been split across two lines here for display reasons; in the + logging file, it will appear on one line.) + + + + The log message comprises a number of components: + 2011-06-15 13:48:22.034 @@ -1459,31 +1468,39 @@ then change those defaults with config set Resolver/forward_addresses[0]/address The date and time at which the message was generated. + ERROR The severity of the message. + [b10-resolver.asiolink] - The source of the message. This comprises two components: the - BIND-10 process generating the message (in this case, the resolver - b10-resolver) and the module within the program from which the - message originated (which in the example is the asynchronous I/O - link module, asiolink). + The source of the message. This comprises two components: + the BIND 10 process generating the message (in this + case, b10-resolver) and the module + within the program from which the message originated + (which in the example is the asynchronous I/O link + module, asiolink). + ASIODNS_OPENSOCK - The message identification. Every message in BIND-10 has a unique - identification, which can be used as an index into the - BIND10 Messages Manual - from which more information can be obtained. + The message identification. Every message in BIND 10 + has a unique identification, which can be used as an + index into the BIND 10 Messages + Manual () from which more information can be obtained. + error 111 opening TCP socket to 127.0.0.1(53) @@ -1498,6 +1515,7 @@ then change those defaults with config set Resolver/forward_addresses[0]/address +