1.\" @(#)bootparamd.8
2.\" $FreeBSD: src/usr.sbin/bootparamd/bootparamd/bootparamd.8,v 1.15 2005/01/18 20:02:31 ru Exp $
3.Dd December 14, 2000
4.Dt BOOTPARAMD 8
5.Os
6.Sh NAME
7.Nm bootparamd
8.Nd boot parameter server
9.Sh SYNOPSIS
10.Nm
11.Op Fl ds
12.Op Fl r Ar router
13.Op Fl f Ar file
14.Sh DESCRIPTION
15The
16.Nm
17utility is a server process that provides information to
18.Xr diskless 8
19clients necessary for booting.
20It consults the
21.Pa /etc/bootparams
22file.
23.Pp
24This version will allow the use of aliases on the hostname in the
25.Pa /etc/bootparams
26file.
27The returned hostname to the
28.Em whoami
29request done by the booting client
30will be the name that appears in
31.Pa /etc/bootparams
32and not the canonical name.
33In this way you can keep the answer short enough
34so that machines that cannot handle long hostnames will not fail during boot.
35.Sh OPTIONS
36.Bl -tag -width Fl
37.It Fl d
38Display the debugging information.
39.It Fl s
40Log the debugging information with
41.Xr syslog 3 .
42.It Fl r Ar router
43The default router (a machine or an IP-address).
44This defaults to the machine running the server.
45.It Fl f Ar file
46The file to use as boot parameter file instead of
47.Pa /etc/bootparams .
48.El
49.Sh FILES
50.Bl -tag -width /etc/bootparams -compact
51.It /etc/bootparams
52default boot parameter file
53.El
54.Sh EXAMPLES
55When netbooting diskless SunOS/Xkernel SPARCstations the booted SunOS kernel
56also broadcasts to the all-0 address.
57The SunOS kernel hangs until it receives a reply.
58To accommodate this behaviour add an alias address
59that responds to an all-0 broadcast.
60So, add something like
61.Ql "ifconfig xl0 192.168.200.254 netmask 255.255.255.255 broadcast 192.168.200.0 alias"
62on the relevant network interface on your
63.Nm
64server.
65The alias address must of course be free for use.
66.Sh SEE ALSO
67.Xr syslog 3 ,
68.Xr bootparams 5 ,
69.Xr diskless 8
70.Sh AUTHORS
71Written by
72.An Klas Heggemann Aq Mt klas@nada.kth.se .
73.Sh BUGS
74You may find the
75.Xr syslog 3
76loggings to be verbose.
77