djbdnscurve6:(tinydns-edit)

NAME
tinydns-edit - append entries to the DNS resource file

SYNOPSIS
tinydns-edit data data.tmp add type name address

DESCRIPTION
tinydns-edit edits the data file, which is the source form of the database that is compiled by tinydns-data and that is served by tinydns and axfrdns. The update to data is performed atomically, by first writing the updated data content to the file data.tmp and then renaming data.tmp to data. The two files must, of course, reside on the same volume in order to achieve this. IPv4 address is given in the standard decimal-dotted format, while IPv6 address is expressed in their compactified format.

APPEND MODE
tinydns-edit reads the provided data file with the resource records in their particular format and adds the given DNS settings to data. On success, tinydns-edit returns zero. If the particular entry already exists, or an error occures, data will not be changed. However, for entries of given type like ns and mx tinydns-edit appends to the existing data file a new record with a syntheszied and automatically incremented hostname for the given name and address. After a customized installation of tinydns with tinydns-conf you may use add-alias, add-childns, add-host, add-host6, add-mx and add-ns to append those specfic DNS records to your existing data file. In order to transform data to data.cdb, which is required by tinydns and axfrdns, you need to compile it by means of tinydns-data.

DATA TYPES
The record types generated by tinydns-edit are indidcated via a token in the first column. type can be one of:

ns  A '.' record is created. This record specifies that the domain name is published by a DNS content server that is listening on the IPv4/IPv6 address.

    The name of the DNS content server is not directly specifiable. Names are automatically assigned by tinydns-edit itself, following the pattern [a-z].ns.name. tinydns-edit will assign the first letter of the alphabet that is not already used in another '.' or '&' record as the name of a DNS content server. If no letters of the alphabet remain unused, tinydns-edit will fail.

    If a '.' or '&' record for the domain already exists, proxy DNS servers are allowed to cache the new record for the same length of time as they are allowed to cache the existing records. Otherwise, proxy DNS servers are allowed to cache the record for up to 3 days.

childns
    A '&' record is created. This record specifies that queries for names in the domain name should be referred to a ("child") DNS content server that is listening on the IPv4/IPv6 address.

    The name of the DNS content server is not directly specifiable. Names are automatically assigned by tinydns-edit itself, following the pattern [a-z].ns.name. tinydns-edit will assign the first letter of the alphabet that is not already used in another '.' or '&' record as the name of a DNS content server. If no letters of the alphabet remain unused, tinydns-edit will fail.

    If a '.' or '&' record for the domain already exists, proxy DNS servers are allowed to cache the new record for the same length of time as they are allowed to cache the existing records. Otherwise, proxy DNS servers are allowed to cache the record for up to 3 days.

mx  A '@' record is created. This record specifies that mail to names in the domain name should be sent to an SMTP server that is listening on the IPv4/IPv6 address.

    The name of the SMTP server is not directly specifiable. Names are automatically assigned by tinydns-edit itself, following the pattern [a-z].mx.name. tinydns-edit will assign the first letter of the alphabet that is not already used in another '@' record as the name of an SMTP server. If no letters of the alphabet remain unused, tinydns-edit will fail.

    It is not possible to specify the distance value for the SMTP server. tinydns-edit will leave that field blank, meaning that tinydns-data will use whatever the default value is.

    If a '@' record for the domain already exists, proxy DNS servers are allowed to cache the new record for the same length of time as they are allowed to cache the existing records. Otherwise, proxy DNS servers are allowed to cache the record for up to 1 day.

host
    A '=' record is created, that proxy DNS servers are allowed to cache for up to 1 day. This record specifies that name maps to IPv4 address and vice versa.

host6
    A '~' record is created, that proxy DNS servers are allowed to cache for up to 1 day. This record specifies that name maps to IPv6 address and vice versa.

    tinydns-edit will fail if a '=' or '~' record already exists that uses either the same name or address.

alias
    A '+' record is created, that proxy DNS servers are allowed to cache for up to 1 day. This record specifies that name maps to IPv4 address but that there is no reverse mapping.

alias6
    A '-' record is created, that proxy DNS servers are allowed to cache for up to 1 day. This record specifies that name maps to IPv6 address but that there is no reverse mapping.

    Because these are alias records, tinydns-edit will not fail for distinct '+' or '-' entries pointing to the same address.

SEE ALSO
axfrdns(8), tinydns(8), tinydns-data(8)

AUTHOR
This manual page was created by Jonathan de Boyne Pollard including now IPv6 extensions and major clearifications.

REFERENCE
http://cr.yp.to/djbdns.html