0f6e222d18de80a9c417add374ae2fdbc4354552
[dragonfly.git] / usr.sbin / bootparamd / bootparamd / bootparamd.8
1 .\" @(#)bootparamd.8
2 .\" $FreeBSD: src/usr.sbin/bootparamd/bootparamd/bootparamd.8,v 1.9.2.5 2003/03/11 21:13:48 trhodes Exp $
3 .\" $DragonFly: src/usr.sbin/bootparamd/bootparamd/bootparamd.8,v 1.2 2003/06/17 04:29:52 dillon 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
16 The
17 .Nm
18 utility is a server process that provides information to
19 .Xr diskless 8
20 clients necessary for booting.
21 It consults the
22 .Pa /etc/bootparams
23 file.
24 .Pp
25 This version will allow the use of aliases on the hostname in the
26 .Pa /etc/bootparams
27 file.
28 The returned hostname to the
29 .Em whoami
30 request done by the booting client
31 will be the name that appears in
32 .Pa /etc/bootparams
33 and not the canonical name.
34 In this way you can keep the answer short enough
35 so that machines that cannot handle long hostnames will not fail during boot.
36 .Sh OPTIONS
37 .Bl -tag -width Fl
38 .It Fl d
39 Display the debugging information.
40 .It Fl s
41 Log the debugging information with
42 .Xr syslog 3 .
43 .It Fl r Ar router
44 The default router (a machine or an IP-address).
45 This defaults to the machine running the server.
46 .It Fl f Ar file
47 The 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
53 default boot parameter file
54 .El
55 .Sh EXAMPLES
56 When netbooting diskless SunOS/Xkernel SPARCstations the booted SunOS kernel
57 also broadcasts to the all-0 address.
58 The SunOS kernel hangs until it receives a reply.
59 To accommodate this behaviour add an alias address
60 that responds to an all-0 broadcast.
61 So, add something like
62 .Ql "ifconfig xl0 192.168.200.254 netmask 255.255.255.255 broadcast 192.168.200.0 alias
63 on the relevant network interface on your
64 .Nm
65 server.
66 The 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 BUGS
72 You may find the
73 .Xr syslog 3
74 loggings to be verbose.
75 .Sh AUTHORS
76 Written by
77 .An Klas Heggemann Aq klas@nada.kth.se .