tinydyndns-data - add or remove TYPE A record to or from data.cdb
consists of one or more argument, each specifying a fully qualified
domain name (fqdn).
adds a TYPE A record to or removes it from data.cdb in
the current directory. Other than tinydns-data
does not know about the source file data but changes
the binary database data.cdb directly.
reads data.cdb and copies its data to data.tmp. While
reading the records, tinydyndns-data
checks for each fqdn
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
then adds all new
s to data.tmp. The data of the newly created records can optionally
be controlled through the environment, see below. Finally
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
- For each fqdn in fqdns, remove all TYPE A
records for fqdn from data.cdb.
- 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.
- location. $LOC must be two characters long. If
LOC is set, it specifies the client location for newly created
exits 111 if anything goes wrong and leaves data.cdb
exits 0 if all fqdns
were processed and the new
data.cdb was written.
For each fqdn
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>