1DDNS-CONFGEN(8)                      BIND9                     DDNS-CONFGEN(8)
2
3
4

NAME

6       ddns-confgen - ddns key generation tool
7

SYNOPSIS

9       ddns-confgen [-a algorithm] [-h] [-k keyname] [-r randomfile] [-s name
10                    | -z zone] [-q] [name]
11

DESCRIPTION

13       ddns-confgen generates a key for use by nsupdate and named. It
14       simplifies configuration of dynamic zones by generating a key and
15       providing the nsupdate and named.conf syntax that will be needed to use
16       it, including an example update-policy statement.
17
18       If a domain name is specified on the command line, it will be used in
19       the name of the generated key and in the sample named.conf syntax. For
20       example, ddns-confgen example.com would generate a key called
21       "ddns-key.example.com", and sample named.conf command that could be
22       used in the zone definition for "example.com".
23
24       Note that named itself can configure a local DDNS key for use with
25       nsupdate -l.  ddns-confgen is only needed when a more elaborate
26       configuration is required: for instance, if nsupdate is to be used from
27       a remote system.
28

OPTIONS

30       -a algorithm
31           Specifies the algorithm to use for the TSIG key. Available choices
32           are: hmac-md5, hmac-sha1, hmac-sha224, hmac-sha256, hmac-sha384 and
33           hmac-sha512. The default is hmac-sha256.
34
35       -h
36           Prints a short summary of the options and arguments to
37           ddns-confgen.
38
39       -k keyname
40           Specifies the key name of the DDNS authentication key. The default
41           is ddns-key when neither the -s nor -z option is specified;
42           otherwise, the default is ddns-key as a separate label followed by
43           the argument of the option, e.g., ddns-key.example.com.  The key
44           name must have the format of a valid domain name, consisting of
45           letters, digits, hyphens and periods.
46
47       -q
48           Quiet mode: Print only the key, with no explanatory text or usage
49           examples.
50
51       -r randomfile
52           Specifies a source of random data for generating the authorization.
53           If the operating system does not provide a /dev/random or
54           equivalent device, the default source of randomness is keyboard
55           input.  randomdev specifies the name of a character device or file
56           containing random data to be used instead of the default. The
57           special value keyboard indicates that keyboard input should be
58           used.
59
60       -s name
61           Single host mode: The example named.conf text shows how to set an
62           update policy for the specified name using the "name" nametype. The
63           default key name is ddns-key.name. Note that the "self" nametype
64           cannot be used, since the name to be updated may differ from the
65           key name. This option cannot be used with the -z option.
66
67       -z zone
68           zone mode: The example named.conf text shows how to set an update
69           policy for the specified zone using the "zonesub" nametype,
70           allowing updates to all subdomain names within that zone. This
71           option cannot be used with the -s option.
72

SEE ALSO

74       nsupdate(1), named.conf(5), named(8), BIND 9 Administrator Reference
75       Manual.
76

AUTHOR

78       Internet Systems Consortium
79

81       Copyright © 2009 Internet Systems Consortium, Inc. ("ISC")
82
83
84
85BIND9                            Jan 29, 2009                  DDNS-CONFGEN(8)
Impressum