105 lines
3.0 KiB
Groff
105 lines
3.0 KiB
Groff
.TH DNSUPDATERC 5
|
|
|
|
.SH NAME
|
|
.B dnsupdaterc \fP \- Configuration file for dnsupdate
|
|
|
|
.SH SYNOPSIS
|
|
.I $HOME/.dnsupdaterc
|
|
.br
|
|
.I /etc/dnsupdaterc
|
|
|
|
.SH "DESCRIPTION"
|
|
.B dnsupdate \fP obtains configuration data from the following sources in the following order:
|
|
|
|
.RS
|
|
.br
|
|
1. command-line options
|
|
.br
|
|
2. user's configuration file ($HOME/.dnsupdaterc)
|
|
.br
|
|
3. system-wide configuration file (/etc/dnsupdaterc)
|
|
.br
|
|
.RE
|
|
|
|
The configuration file has the following format:
|
|
|
|
Empty lines and lines starting with '#' are comments.
|
|
|
|
Otherwise a line is of the format "keyword arguments". Configuration options may be separated by whitespace.
|
|
|
|
The possible keywords and their meanings are as follows (note that all keywords and arguments are case-sensitive):
|
|
|
|
.B domain \fP
|
|
.RS
|
|
The name of the domain your host belongs to, i.e. example.com.
|
|
.RE
|
|
|
|
.B force \fP
|
|
.RS
|
|
You can force an update even if your name server is up to date. However all updates causes the name server to send notifications the secondary servers so it is recommended that you leave this option turned off. This option is useful if your host data must be kept alive to not get deleted.
|
|
.RE
|
|
|
|
.B hostname \fP
|
|
.RS
|
|
The name you wish to publish in the domain.
|
|
.RE
|
|
|
|
.B ipurl \fP
|
|
.RS
|
|
The complete url to a webpage which displays your IP address \fIhttp://www.showmyip.com\fP is a free service which returns it to you, but you might want to use something closer to your name server. It is important that the last IP address displayed on the webpage is your public address.
|
|
.RE
|
|
|
|
.B keyname \fP
|
|
.RS
|
|
The name of your TSIG key. If the name is incorrect the authentication with the remote name server will fail. If you have recieved a key-file from your name server administrator it might contain a line like this:
|
|
.br
|
|
.I example.com.\fP IN KEY 256 3 157 gGHF87Dnd8hmHOJhJv8vMw==
|
|
.br
|
|
The text in \fIitalics\fP is the name of the key.
|
|
.RE
|
|
|
|
.B keysecret \fP
|
|
.RS
|
|
Your TSIG key. If you have recieved a key-file from your name server administrator it might contain a line like this:
|
|
.br
|
|
example.com. IN KEY 256 3 157 \fIgGHF87Dnd8hmHOJhJv8vMw==\fP
|
|
.br
|
|
The text in \fIitalics\fP is the keysecret.
|
|
.RE
|
|
|
|
.B name server \fP
|
|
.RS
|
|
IP address to the master nameserver for the domain. This server is used to verify information before sending it. If you use a closer name server you might verify stale data
|
|
.RE
|
|
|
|
.B quiet \fP
|
|
.RS
|
|
Quiet mode suppresses all text ouput from the program. It is useful if you for instance call it from a script during boot up or cron.
|
|
.RE
|
|
|
|
.B ttl \fP
|
|
.RS
|
|
TTL - Time To Live. The number of seconds an upstream name server should cache the information before re-checking with the authorative name server. Set this to fairly short if you reboot or recieve a new IP address often.
|
|
.RE
|
|
|
|
.SH FILES
|
|
.I
|
|
/etc/dnsupdaterc
|
|
.RS
|
|
The system wide configuration file, see \fIdnsupdaterc(5)\fP for details.
|
|
.RE
|
|
.I
|
|
~/.dnsupdaterc
|
|
.RS
|
|
The per user configuration file, see \fIdnsupdaterc(5)\fP for details.
|
|
|
|
.SH "SEE ALSO"
|
|
\fIdnsupdate(1)\fP
|
|
|
|
.SH BUGS
|
|
Report bugs to <dnsupdate-bugs@wahlis.com>.
|
|
|
|
.SH AUTHOR
|
|
Fredrik Wahlberg
|
|
\fI<fredrik@wahlis.com>
|