tinydyndns-update - update TYPE A record in data.cdb
tinydyndns-update changes the data of a TYPE A record
in data.cdb in the current directory. Other than tinydns-data(8), tinydndns-update
does not know about the source file data but changes the binary database
First tinydyndns-update checks if the given fqdn has a
TYPE A record in data.cdb. Then it checks if the given IP address differs
from the one in the TYPE A record in data.cdb, or if the record’s timestamp
should be updated. Finally if data.cdb needs to change, tinydyndns-update
copies data.cdb to data.tmp, changes the IP address of the TYPE A record
of fqdn to dynip in data.tmp, optionally adjusts time-to-live or time-to-die,
and renames data.tmp to data.cdb.
If tinydyndns-update cannot
find a TYPE A record for fqdn in data.cdb, it prints a warning and exits
- time-to-live. The environment
variable TTL overrides the default time-to-live in seconds (0 if TTD is set,
otherwise 5). If TTL is not set or zero, the time-to-live of the record will
not change. $TTL must be an integer.
- time-to-die. $TTD must be an integer,
specifying a number of seconds. If TTD is set, the timestamp of the record
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 must be two characters long. If LOC is set, it specifies the client
location for records to be updated.
If dynip does not differ from the IP address of the TYPE A record of
fqdn in data.cdb, and the environment variable TTD is not set, tinydyndns-update
prints a note and exits 0.
tinydyndns-update exits 100 if it has trouble
opening data.cdb, and leaves data.cdb unchanged.
tinydyndns-update exits 111
on temporary error, and leaves data.cdb unchanged.
If data.cdb was changed
successfully, tinydyndns-update exits 0.
Gerrit Pape <firstname.lastname@example.org>
Table of Contents