kea/src/bin/ddns/b10-ddns.8

'\" t
.\"     Title: b10-ddns
.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\"      Date: June 18, 2012
.\"    Manual: BIND10
.\"    Source: BIND10
.\"  Language: English
.\"
.TH "B10\-DDNS" "8" "June 18, 2012" "BIND10" "BIND10"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
b10-ddns \- Dynamic DNS update service
.SH "SYNOPSIS"
.HP \w'\fBb10\-ddns\fR\ 'u
\fBb10\-ddns\fR [\fB\-v\fR | \fB\-\-verbose\fR]
.SH "DESCRIPTION"
.PP
The
\fBb10\-ddns\fR
daemon provides the BIND 10 Dynamic Update (DDNS) service, as specified in RFC 2136\&. Normally it is started by the
\fBbind10\fR(8)
boss process\&.
.PP
When the
\fBb10\-auth\fR
authoritative DNS server receives an UPDATE request, it internally forwards the request to
\fBb10\-ddns\fR, which handles the rest of the request processing\&. When the processing is completed
\fBb10\-ddns\fR
will send a response to the client with the RCODE set to the value as specified in RFC 2136\&. If the zone has been changed as a result, it will internally notify
\fBb10\-auth\fR
and
\fBb10\-xfrout\fR
so the new version of the zone will be served, and other secondary servers will be notified via the DNS notify protocol\&.
.PP
This daemon communicates with BIND 10 over a
\fBb10-msgq\fR(8)
C\-Channel connection\&. If this connection is not established,
\fBb10\-ddns\fR
will exit\&. The
\fBb10\-ddns\fR
daemon also depends on some other BIND 10 components (either directly or indirectly):
\fBb10-auth\fR(8),
\fBb10-xfrout\fR(8), and
\fBb10-zonemgr\fR(8)\&.
.PP

\fBb10\-ddns\fR
receives its configurations from
\fBb10-cfgmgr\fR(8)\&.
.SH "ARGUMENTS"
.PP
The arguments are as follows:
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
Print the command line arguments and exit\&.
.RE
.PP
\fB\-v\fR, \fB\-\-verbose\fR
.RS 4
This value is ignored at this moment, but is provided for compatibility with the
\fBbind10\fR
Boss process\&.
.RE
.SH "CONFIGURATION AND COMMANDS"
.PP
The configurable settings are:
.PP

\fIzones\fR
The zones option is a list of configuration items for specific zones that can be updated with DDNS\&. Each entry is a map that can contain the following items:
\fIorigin\fR
is a textual domain name of the zone;
\fIclass\fR
(text) is the RR class of the zone; and
\fIupdate_acl\fR
is an ACL that controls permission for updates\&. See the BIND 10 Guide for configuration details\&. Note that not listing a zone in this list does not directly mean update requests for the zone are rejected, but the end result is the same because the default ACL for updates is to deny all requests\&.
.PP
The module commands are:
.PP

\fBshutdown\fR
exits
\fBb10\-ddns\fR\&. This has an optional
\fIpid\fR
argument to select the process ID to stop\&. (Note that the BIND 10 boss process may restart this service if configured\&.)
.SH "SEE ALSO"
.PP

\fBb10-auth\fR(8),
\fBb10-cfgmgr\fR(8),
\fBb10-msgq\fR(8),
\fBb10-xfrout\fR(8),
\fBb10-zonemgr\fR(8),
\fBbind10\fR(8),
BIND 10 Guide\&.
.SH "HISTORY"
.PP
The
\fBb10\-ddns\fR
daemon was first implemented in December 2011 for the ISC BIND 10 project\&. The first functional version was released in June 2012\&.
.SH "COPYRIGHT"
.br
Copyright \(co 2011-2012 Internet Systems Consortium, Inc. ("ISC")
.br