1.\" $NetBSD: rpc.bootparamd.8,v 1.17 2008/11/08 02:08:39 reed Exp $
2.\" @(#)bootparamd.8
3.Dd January 8, 1994
4.Dt RPC.BOOTPARAMD 8
5.Os
6.Sh NAME
7.Nm bootparamd ,
8.Nm rpc.bootparamd
9.Nd boot parameter server
10.Sh SYNOPSIS
11.Nm
12.Op Fl ds
13.Op Fl i Ar interface
14.Op Fl r Ar router
15.Op Fl f Ar file
16.Sh DESCRIPTION
17.Nm
18is a server process that provides information to diskless clients
19necessary for booting. It consults the file
20.Dq Pa /etc/bootparams .
21It should normally be started from
22.Dq Pa /etc/rc .
23.Pp
24This version will allow the use of aliases on the hostname in the
25.Dq Pa /etc/bootparams
26file. The hostname returned in response to the booting client's whoami request
27will be the name that appears in the config file, not the canonical name.
28In this way you can keep the answer short enough
29so that machines that cannot handle long hostnames won't fail during boot.
30.Pp
31While parsing, if a line containing just ``+'' is found, and
32the YP subsystem is active, the YP map
33.Pa bootparams
34will be searched immediately.
35.Sh OPTIONS
36.Bl -tag -width indent
37.It Fl d
38Display the debugging information. The daemon does not fork in this
39case.
40.It Fl i Ar interface
41Specify the interface to become the default router.
42.Nm
43picks the first IPv4 address it finds on the system by default.
44With
45.Fl i ,
46you can control which interface to be used to obtain the default router address.
47.Fl r
48overrides
49.Fl i .
50.It Fl s
51Log the debugging information with
52.Xr syslog 3 .
53.It Fl r
54Set the default router (a hostname or IP-address).
55This defaults to the machine running the server.
56.It Fl f
57Specify the file to use as boot parameter file instead of
58.Dq Pa /etc/bootparams .
59.El
60.Sh FILES
61.Bl -tag -width /etc/bootparams -compact
62.It Pa /etc/bootparams
63default configuration file
64.El
65.Sh SEE ALSO
66.Xr bootparams 5
67.Sh AUTHORS
68Originally written by
69.An Klas Heggemann
70.Aq klas@nada.kth.se .
71.Sh BUGS
72You may find the syslog messages too verbose.
73.Pp
74It's not clear if the non-canonical hack mentioned above is a good idea.
75