admdns(1M) DG/UX R4.11MU05 admdns(1M)
NAME
admdns - manage DNS server databases
SYNOPSIS
admdns -o add [ -l alias-list ] [ -C comment ] -a network-address
host-name
admdns -o modify [ -N new-host-name ] [ -a network-address ] [ -l
alias-list ] [ -C comment ] host-name
admdns -o delete [ -q ] host-name ...
admdns -o list [ -qvS ] [ host-name ... ]
admdns -o get [ -v ] domain-name
admdns -o build [ -c CNAME-domain-list ] [ -h SOA-hostname ] [ -m
pref:host-list ] [ -s NS-server-list ] [ -t ] [ -u
SOA-email-addr ] [ -w ] [ -H master-file ] [ -M ] [ -O
refresh:retry:expire:minimum ] -n net[:subnet]-list
domain-name
admdns -o install [ -r ] [ -b new-namedboot-path ]
DESCRIPTION
Admdns manages the DNS master file and DNS database files located in
/etc/domain. The DNS master file (/etc/domain/dns.master) contains
the IP address to hostname/alias records used to construct the DNS
databases. It lists all hosts contained within the DNS zone. The
format of this file is identical to that of /etc/hosts. The DNS
databases constructed by admdns include named.boot, db.domain-name
(used for forward hostname to address lookups), db.network-address
(one per specified network which are used for reverse IP address to
hostname lookups), and boot.cacheonly (for use with cache only
servers). These databases are used with named(1M) to implement the
Domain Name System.
Note that each admdns -o build operation will create a new named.boot
file in /etc/domain representing only the specified domain-name. If
the DNS zone is complex and encompasses more than one domain-name
(requiring multiple admdns -o build operations), the resulting
named.boot will not reflect the complete DNS zone. Therefore,
complex DNS zones composed of multiple domains require that
/etc/named.boot be managed manually.
Operations
add Create a new DNS masterfile entry.
modify Change a host name, network address or alias list for an
existing DNS masterfile entry.
delete Delete one (or more) existing DNS masterfile entries.
list List one or more entries from the DNS masterfile. Information
is listed about each host-name specified; if host-name is all,
information about all entries is listed.
get Display the current DNS database build parameters for a
domain.
build Build the DNS database(s) using the supplied build parameters.
install
Install the DNS database(s) and optionally signal/start named
to begin serving the new information.
Options
-l alias-list
alias-list is a comma-separated list of aliases by which
the host can be referenced. If this option is not
specified for the modify operation, the current alias list
for the host is preserved. Note that for the modify
operation, any existing alias-list will be overwritten by
the new alias-list.
-C comment
The comment field is free-format text which can be used to
simply keep notes about each entry, or which can be used to
generate DNS TXT resource records if the "-t" build option
is specified. If this option is not specified for the
modify operation, the current comment field for the host is
preserved.
-a network-address
network-address is the Internet address of the host. If
this option is not specified for the modify operation, the
current Internet address for the host is preserved.
-N new-host-name
new-host-name is the new name of the host. If this option
is not specified, the current host name is preserved.
-q "Quiet." Produce an unformatted listing (i.e. no headers,
fields delimited by a single space). When this option is
used with the delete operation, no confirmation is
requested before the host-name is deleted.
-S "Sort." Sort the listing by host name.
-v "Verbose." If specified for the t operation, produce a
formatted listing with headers and aligned columns. If
specified for the t operation, display each DNS database
build parameter with header information defining each
field.
-c CNAME-domain-list
A comma-separated list of domain names which are 'aliased'
to domain-name via CNAME records. During the build
operation, each masterfile entry containing domain-name
will result in the creation of a CNAME record in this
domain pointing to the host in domain-name. If
unspecified, no CNAME records will be generated.
-h SOA-hostname
Used in the ORIGIN field of the Start-of-Authority (SOA)
record, this is the name of the host on which the DNS
databases reside. If unspecified, the hostname of the host
executing admdns will be used.
-m pref:host-list
A comma-separated list of number:name combinations. Create
MX resource records at the specified preference level with
the specified mail exchange host will be generated for each
host listed in the DNS masterfile. Note that if the "-M"
admdns option is specified, no MX resource records will be
created.
-n net:[subnet]-list
A comma-separated list of dotted-quad network address (and
optionally, network masks) which define the networks
contained within a DNS zone. Resource records will be
created for each DNS masterfile entry with an address
covered by this network address list.
-s NS-server-list
A comma-separated list of hosts acting as nameservers for
the specified domain. If unspecified, no NS records will
be generated.
-t Generate TXT records from the DNS masterfile comments. If
"[no smtp]" appears in a particular hosts comment field, it
will not be included in the resulting TXT record. If
unspecified, no TXT records will be generated.
-u SOA-email-addr
The email address for the person in charge of the domain
data. If unspecified, it will default to: root@domain-name
-w Generate WKS records that list the SMTP service over the
TCP protocol if an MX record is also created. If
unspecified, no WKS records will be generated. Note that
if the "-M" admdns option is specified, no MX resource
records will be created.
-H master-file
A file (format identical to /etc/hosts) from which the DNS
databases are built. If unspecified,
/etc/domain/dns.master will be used as the default
masterfile.
-M Disable the generation of any MX records for entries in the
DNS masterfile.
-O refresh:retry:expire:minimum
The Start of Authority timing parameters (specified in
seconds). If unspecified, the defaults are:
10800:3600:604800:86400
-r Reinit (signal/start) named and begin serving the new DNS
data. If unspecified, the database(s) will be installed
but will not be supplied by named(1M) until named is sent a
SIGHUP or is restarted manually.
-b new-namedboot-path
Pathname to the new named.boot file to install. Each
admdns -o build operation will create a new
/etc/domain/named.boot file representing only the specified
domain-name. If the DNS zone is completely defined by
domain-name (requiring only a single admdns -o build
operation), then the resulting named.boot can be installed
into /etc/named.boot via this option. However, if the DNS
zone is more complex and encompasses more than one
domain-name (requiring multiple admdns -o build
operations), /etc/named.boot must be managed manually and
this option must not be used.
EXAMPLES
To create name server data for networks 192.249.249 and 192.253.253
in movie.edu, include MX records for all hosts pointing to each host
and to the mail hub postmanrings2x.movie.edu, generate CNAME records
for masterfile entries in video.edu and film.edu, specify the host
zone_srvr as the SOA hostname, specify lights and camera as other
hosts acting as nameservers for the zone, generate TXT records from
masterfile comments, and build from masterfile
/etc/domain/dns.master:
admdns -o build -c video.edu,film.edu -h zonesrvr \
-m 20:postmanrings2x.movie.edu -n 192.249.249,192.253.253 \
-s lights,camera -t movie.edu
To create name server data for networks 192.249.249 and 192.253.253 in movie.edu:
admdns -o build -n 192.249.249,192.253.253 movie.edu
FILES
/etc/domain/dns.master DNS master file
DIAGNOSTICS
Warnings
None.
Errors
- The add operation is requested, and host-name or network-address
already exists.
- The modify operation is requested, and new-host-name or network-
address already exists.
- The network-address is not a valid Internet address.
- The delete or modify operation is requested, and host-name does
not exist.
Exit Codes
0 The operation was successful.
1 The operation was unsuccessful.
2 The operation failed due to access restrictions.
3 There was an error in the command line.
NOTES
You must have write permission to the /etc/domain directory to use
the add, delete, modify, build, and install operations. Usually,
only a user with appropriate privilege has such permission. On a
generic DG/UX system, appropriate privilege is granted by having an
effective UID of 0 (root). See the appropriateprivilege(5) man page
for more information.
On a system with DG/UX information security, appropriate privilege is
granted by having one or more specific capabilities enabled in the
effective capability set of the user. See capdefaults(5) for the
default capabilities for this command.
SEE ALSO
named(1M), h2n(1M), hosts(4)
Licensed material--property of copyright holder(s)