tinydyndns-data(8) System Manager's Manual tinydyndns-data(8)
NAME
tinydyndns-data - add or remove TYPE A record to or from data.cdb
SYNOPSIS
tinydyndns-data add|remove fqdns
DESCRIPTION
fqdns consists of one or more argument, each specifying a fully qualified domain name (fqdn).
tinydyndns-data adds a TYPE A record to or removes it from data.cdb in the current directory. Other than tinydns-data(8), tinydyndns-data
does not know about the source file data but changes the binary database data.cdb directly.
tinydyndns-data reads data.cdb and copies its data to data.tmp. While reading the records, tinydyndns-data checks for each fqdn in fqdns
if this hostname has a TYPE A record in data.cdb, drops the record when called with the option remove, or refuses to add the record when
called with the option add.
When called with the option add, tinydyndns-data then adds all new fqdns to data.tmp. The data of the newly created records can optionally
be controlled through the environment, see below. Finally tinydyndns-data renames data.tmp to data.cdb.
OPTIONS
add For each fqdn in fqdns, add a TYPE A record for fqdn to data.cdb with the default IP address (127.14.14.14).
remove For each fqdn in fqdns, remove all TYPE A records for fqdn from data.cdb.
ENVIRONMENT
IP The environment variable IP overrides the default IP address (``127.14.14.14'') for newly created records. $IP must be a valid IP
address.
TTL time-to-live. The environment variable TTL overrides the default time-to-live in seconds (0 if TTD is set, otherwise 5). $TTL must
be an integer.
TTD time-to-die. $TTD must be an integer, specifying a number of seconds. If TTD is set, the timestamp of newly created records is set
to the current time plus $TTD seconds, and TTL is set to zero by default, so that tinydns(8) interpretes the timestamp as time-to-
die. Note: you probably want to adjust SOA ttl, or create a wildcard record, to prevent DNS caches from caching nxdomain, when
using this feature.
LOC location. $LOC must be two characters long. If LOC is set, it specifies the client location for newly created records.
EXIT CODES
tinydyndns-data exits 111 if anything goes wrong and leaves data.cdb unchanged.
tinydyndns-data exits 0 if all fqdns were processed and the new data.cdb was written.
For each fqdn in fqdns that tinydyndns-data was not able to remove or add (e.g., not there, or already there), it increases the exit code
by one and exits non-zero (maximum is 100).
FILES
./data.cdb
./data.tmp
SEE ALSO
tinydyndns-update(8), tinydyndns-conf(8)
http://smarden.org/tinydyndns/
AUTHOR
Gerrit Pape <pape@smarden.org>
tinydyndns-data(8)