'\" t
.\"     dnsutl - utilities to make DNS easier to configure
.\"     Copyright (C) 1999, 2007 Peter Miller
.\"
.\"     This program is free software; you can redistribute it and/or modify
.\"     it under the terms of the GNU General Public License as published by
.\"     the Free Software Foundation; either version 3 of the License, or
.\"     (at your option) any later version.
.\"
.\"     This program is distributed in the hope that it will be useful,
.\"     but WITHOUT ANY WARRANTY; without even the implied warranty of
.\"     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\"     GNU General Public License for more details.
.\"
.\"     You should have received a copy of the GNU General Public License
.\"     along with this program. If not, see
.\"     <http://www.gnu.org/licenses/>.
.\"
.ds n) dns-ethers-import
.TH \*(n) 1
.SH NAME
dns-ethers-import \- generate DNS tables from /etc/ethers entries
.XX "dns-ethers-import(1)" "generate DNS tables from /etc/ethers entries"
.SH SYNOPSIS
.B \*(n)
[
.IR option \&...
]
.IR filename \&...
.br
.B \*(n)
.B -Help
.br
.B \*(n)
.B -VERSion
.SH DESCRIPTION
The \fI\*(n)\fP program is used to read your \fI/etc/ethers\fP file and
produce a DNS-formatted database.  This is used to maintain a database
with the IP address and the MAC address in the same file.  This helps
find omissions and inconsistencies.
.br
.ne 1i
.SH OPTIONS
The following options are understood:
.TP 8n
\fB-Domain\fP \fIname\fP
This option may be used to set the domain name in the generated file.
Defaults to you system domain name, if set, otherwise ``example.com''.
.TP 8n
.B -Help
.br
Provide some help with using the
.I \*(n)
program.
.TP 8n
.B -VERSion
.br
Print the version of the
.I \*(n)
program being executed.
.so arglex.so
.so exit.so
.SH EXAMPLE
If you have an \fI/etc/ethers\fP file which looks like this:
.RS
.nf
.ft CW
.so example.ethers.so
.ft R
.fi
.RE
By using the following command
.RS
.nf
.ft CW
% \f(CBdns-ethers-import /etc/ethers ethers-tmp\fP
%
.ft R
.fi
.RE
You will see an output file of the form
.RS
.nf
.ft CW
.ta 8n 16n 24n 32n 40n
$origin example.com.
@               in      soa     example.com. hostmaster.example.com. (
                                3       ; serial
                                10800   ; refresh: 3 hours
                                1800    ; retry: 30 minutes
                                604800  ; expire: 1 week
                                86400 ) ; minimum: 1 day
mercury         ether   a       2:7:1:f:b7:fb
venus           ether   a       2:60:8c:2d:20:c4
earth           ether   a       8:0:20:79:1f:d
mars            ether   a       aa:0:4:0:86:53
jupiter         ether   a       8:0:2b:99:49:ad
saturn          ether   a       0:40:10:56:43:57
neptune         ether   a       0:aa:0:69:7c:5b
uranus          ether   a       0:0:e8:a4:0:25
pluto           ether   a       8:0:9:d:2a:87
.ft R
.fi
.RE
You are expected to manually edit this into the rest of the database.
You especially need to put sensable values into the SOA record.
.PP
See \fIdns-ethers\fR(1) for how to retrieve your \fI/etc/ethers\fP file once
you have imported it.
.so copyright.so
.so author.so