djbdnscurve6:
Section: Misc. Reference Manual Pages (tinydns-edit)
Updated: 8
Index
Return to Main Contents
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
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- APPEND MODE
-
- DATA TYPES
-
- SEE ALSO
-
- AUTHOR
-
- REFERENCE
-
This document was created by
man2html,
using the manual pages.
Time: 15:10:03 GMT, December 15, 2024