1 .\" Copyright (C) 2004, 2005 Internet Systems Consortium, Inc. ("ISC")
2 .\" Copyright (C) 2001, 2003 Internet Software Consortium.
4 .\" Permission to use, copy, modify, and distribute this software for any
5 .\" purpose with or without fee is hereby granted, provided that the above
6 .\" copyright notice and this permission notice appear in all copies.
8 .\" THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
9 .\" REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
10 .\" AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
11 .\" INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
12 .\" LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
13 .\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
14 .\" PERFORMANCE OF THIS SOFTWARE.
16 .\" $Id: rndc-confgen.8,v 1.3.2.5.2.7 2005/10/13 02:33:50 marka Exp $
20 .\" ** You probably do not want to edit this file directly **
21 .\" It was generated using the DocBook XSL Stylesheets (version 1.69.1).
22 .\" Instead of manually editing it, you probably should edit the DocBook XML
23 .\" source for it and then use the DocBook XSL Stylesheets to regenerate it.
24 .TH "RNDC\-CONFGEN" "8" "Aug 27, 2001" "BIND9" "BIND9"
25 .\" disable hyphenation
27 .\" disable justification (adjust text to left margin only)
30 rndc\-confgen \- rndc key generation tool
33 \fBrndc\-confgen\fR [\fB\-a\fR] [\fB\-b\ \fR\fB\fIkeysize\fR\fR] [\fB\-c\ \fR\fB\fIkeyfile\fR\fR] [\fB\-h\fR] [\fB\-k\ \fR\fB\fIkeyname\fR\fR] [\fB\-p\ \fR\fB\fIport\fR\fR] [\fB\-r\ \fR\fB\fIrandomfile\fR\fR] [\fB\-s\ \fR\fB\fIaddress\fR\fR] [\fB\-t\ \fR\fB\fIchrootdir\fR\fR] [\fB\-u\ \fR\fB\fIuser\fR\fR]
37 generates configuration files for
38 \fBrndc\fR. It can be used as a convenient alternative to writing the
40 file and the corresponding
46 by hand. Alternatively, it can be run with the
50 file and avoid the need for a
60 configuration. This creates a file
68 was built) that is read by both
74 file defines a default command channel and authentication key allowing
78 on the local host with no further configuration.
81 \fBrndc\-confgen \-a\fR
84 to be used as drop\-in replacements for BIND 8 and
85 \fBndc\fR, with no changes to the existing BIND 8
89 If a more elaborate configuration than that generated by
90 \fBrndc\-confgen \-a\fR
91 is required, for example if rndc is to be used remotely, you should run
102 Specifies the size of the authentication key in bits. Must be between 1 and 512 bits; the default is 128.
107 option to specify an alternate location for
111 Prints a short summary of the options and arguments to
115 Specifies the key name of the rndc authentication key. This must be a valid domain name. The default is
119 Specifies the command channel port where
121 listens for connections from
122 \fBrndc\fR. The default is 953.
125 Specifies a source of random data for generating the authorization. If the operating system does not provide a
127 or equivalent device, the default source of randomness is keyboard input.
129 specifies the name of a character device or file containing random data to be used instead of the default. The special value
131 indicates that keyboard input should be used.
134 Specifies the IP address where
136 listens for command channel connections from
137 \fBrndc\fR. The default is the loopback address 127.0.0.1.
142 option to specify a directory where
144 will run chrooted. An additional copy of the
146 will be written relative to this directory so that it will be found by the chrooted
152 option to set the owner of the
156 is also specified only the file in the chroot area has its owner changed.
161 to be used with no manual configuration, run
163 \fBrndc\-confgen \-a\fR
167 file and corresponding
171 statements to be manually inserted into
172 \fInamed.conf\fR, run
180 BIND 9 Administrator Reference Manual.
183 Internet Systems Consortium