tinydyndns-data - add or remove TYPE A record to or from data.cdb
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.
- For each fqdn in fqdns, add a TYPE A record for fqdn to data.cdb with the
default IP address (127.14.14.14).
- For each fqdn in fqdns, remove all
TYPE A records for fqdn from data.cdb.
tinydyndns-data exits 111 if
anything goes wrong and leaves data.cdb unchanged.
- The environment variable
IP overrides the default IP address (‘‘127.14.14.14’’) for newly created records.
$IP must be a valid IP address.
- 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.
- 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 must be two characters long. If LOC is set, it specifies the client
location for newly created records.
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).
Gerrit Pape <email@example.com>
Table of Contents