]> October 3, 2012 b10-auth 8 BIND10 b10-auth Authoritative DNS server 2010-2012 Internet Systems Consortium, Inc. ("ISC") b10-auth DESCRIPTION The b10-auth daemon provides the BIND 10 authoritative DNS server. Normally it is started by the bind108 boss process. This daemon communicates with other BIND 10 components over a b10-msgq8 C-Channel connection. If this connection is not established, b10-auth will exit. It receives its configurations from b10-cfgmgr8. OPTIONS The arguments are as follows: Enable verbose logging mode. This enables logging of diagnostic messages at the maximum debug level. CONFIGURATION AND COMMANDS The configurable settings are: database_file defines the path to the SQLite3 zone file when using the sqlite datasource. The default is @@LOCALSTATEDIR@@/bind10-devel/zone.sqlite3. datasources configures data sources. The list items include: type to define the required data source type (such as memory); class to optionally select the class (it defaults to IN); and zones to define the file path name, origin (default domain), and optional filetype. By default, zones is empty. For the in-memory data source (i.e., the type is memory), the optional filetype configuration item for zones can be specified so the in-memory zone data can be built from another data source that is based on a database backend (in practice with current implementation, it would be an SQLite3 database file for the SQLite3 data source). See the BIND 10 Guide for configuration details. Only the IN class is supported at this time. By default, the memory data source is disabled. Also, currently the zone file must be canonical such as generated by named-compilezone -D. listen_on is a list of addresses and ports for b10-auth to listen on. The list items are the address string and port number. By default, b10-auth listens on port 53 on the IPv6 (::) and IPv4 (0.0.0.0) wildcard addresses. tcp_recv_timeout is the timeout used on incoming TCP connections, in milliseconds. If the query is not sent within this time, the connection is closed. Setting this to 0 will disable TCP timeouts completely. The configuration commands are: loadzone tells b10-auth to load or reload a zone file. The arguments include: class which optionally defines the class (it defaults to IN); origin is the domain name of the zone; and datasrc optionally defines the type of datasource (it defaults to memory). In this development version, currently this only supports the IN class and the memory data source. getstats tells b10-auth to send its statistics data. shutdown exits b10-auth. This has an optional pid argument to select the process ID to stop. (Note that the BIND 10 boss process may restart this service if configured.) STATISTICS DATA The statistics data collected by the b10-stats daemon for Auth include: Opcode of a request message will not be counted if: The request message is too short to parse the message header The request message is a response (i.e. QR bit is set) Request attributes except for opcode will not be counted if TSIG validation failed as they are not reliable. We always count opcode mainly for compatibility with BIND 9, but remember that if there's any error related to TSIG, some of the counted opcode may not be trustworthy. FILES @@LOCALSTATEDIR@@/bind10-devel/zone.sqlite3 — Location for the SQLite3 zone database when database_file configuration is not defined. SEE ALSO b10-cfgmgr8 , b10-loadzone8 , b10-msgq8 , b10-stats8 , b10-zonemgr8 , bind108 , BIND 10 Guide. HISTORY The b10-auth daemon was first coded in October 2009.