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)