'\" t
.\"     dnsutl - utilities to make DNS easier to configure
.\"     Copyright (C) 1996, 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-bootparams
.TH dns-bootprms 1 dnsutl "Reference Manual"
.SH NAME
dns-bootparams \- generate /etc/bootparams entries from DNS tables
.XX "dns-bootparams(1)" "generate /etc/bootparams entries from DNS tables"
.SH SYNOPSIS
.B \*(n)
[
.IR option ...
][
.I infile
[
.I outfile
]]
.br
.B \*(n)
.B -Help
.br
.B \*(n)
.B -VERSion
.SH DESCRIPTION
The
.I \*(n)
program is used to generate the
.I /etc/bootparams
entries from DNS tables.
.PP
If the input file is not named,
or the name '-' is used,
the standard input is read.
.PP
If the output file is not named,
or the name '-' is used,
the startdard output is written.
.SH "BOOTPARAM TYPES"
The ``bootparam'' class has the following types:
.TP 8n
aarch
The application architecture.
Expects one argument.
Legal values are ``sparc'' or ``i386''.
Usually used to substitute into other records.
This can usually be derived from ``in hinfo'' records if not supplied,
so it commonly is not given explicitly.
Can still be used in $substitutions even
if derived from the ``in hinfo'' records.
.TP
boottype
The boot type.
Expects one argument.
Legal values are ``in'' and nothing else.
.TP
display
Used for i386/i86pc.
.TP
install
The server and path of the Solaris CD image.
Often contains $substitutions from other records,
particularly $server and $aarch.
.TP
install_config
Expects two arguments.
The server and path of the directory
containing the install rules script.
Often contains $substitutions from other records,
particularly $server.
.TP 8n
karch
The kernel architecture.
Expects one argument.
Legal values include: ``i86pc'', ``sun4'', ``sun4c'', ``sun4m'', etc.
.TP
keyboard
Used for i386/i86pc.
.TP
mouse
Used for i386/i86pc.
.TP 8n
root
Expects two arguments.
The server and path of the root directory to mount
as a diskless client while installing solaris on the native disk.
Often contains $substitutions from other records,
particularly $server, $aarch and $karch.
.TP
server
The name of the install server.
Expects one argument.
Used to parameterise other records.
.TP
term
The terminal type.
Expects one argument.
Legal values are terminal names from termcap,
usually ``sun''.
Specifying this makes install much faster.
.SH THE * DEFAULT
The special host name ``*'' may be used to specify defaults.
These may be over-riden by specific entries.
The most recently see default of each type anme is remembered.
This may be exploited,
for example,
to set different servers and gateways for different networks.
.PP
Substitutions are performed after the defaults are applied,
so that
.IR root ,
for example,
may contain $substitutions.
It is usually sufficient to have a single ``karch'' record trigger
the entire bootparam entry in the output.
.SH OPTIONS
The following options are understood:
.TP 8n
.B -Verbose
.br
This option may be used to see what
.I \*(n)
deciphers each resource record as.
.TP 8n
.B -Help
.br
This option may be used to get more information about
how to used th
.I \*(n)
program.
.TP 8n
.B -VERSion
.br
This option may be used to see what version of the
.I \*(n)
program is running.
.TP 8n
\fB-I\fP\fIdirectory\fP
.br
This option may be used to set the search path for include files.
.so arglex.so
.so exit.so
.so copyright.so
.so author.so