NAME
tinydyndns-update - update TYPE A record in data.cdb
SYNOPSIS
tinydyndns-update fqdn dynip
DESCRIPTION
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 data.cdb directly.
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.
ENVIRONMENT
TTL 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.
TTD 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 location. $LOC must be two characters long. If LOC is set, it
specifies the client location for records to be updated.
EXIT CODES
If tinydyndns-update cannot find a TYPE A record for fqdn in data.cdb,
it prints a warning and exits 114.
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.
FILES
./data.cdb
./data.tmp
SEE ALSO
tinydyndns-data(8), tinydyndns-conf(8)
http://smarden.org/tinydyndns/
AUTHOR
Gerrit Pape <pape@smarden.org>
tinydyndns-update(8)