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