1.\" $OpenBSD: rpc.bootparamd.8,v 1.13 2000/11/09 17:53:23 aaron Exp $
2.\" @(#)bootparamd.8
3.Dd January 8, 1994
4.Dt BOOTPARAMD 8
5.Os
6.Sh NAME
7.Nm bootparamd ,
8.Nm rpc.bootparamd
9.Nd boot parameter server
10.Sh SYNOPSIS
11.Nm rpc.bootparamd
12.Op Fl d
13.Op Fl s
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.
20It consults the file
21.Pa /etc/bootparams .
22It should normally be started from
23.Pa /etc/rc .
24.Pp
25This version will allow the use of aliases on the hostname in the
26.Pa /etc/bootparams
27file.
28The hostname returned in response to the booting client's whoami request
29will be the name that appears in the config file, not the canonical name.
30In this way you can keep the answer short enough
31so that machines that cannot handle long hostnames won't fail during boot.
32.Pp
33While parsing, if a line containing just
34.Dq \&+
35is found, and the YP subsystem is active, the YP map
36.Pa bootparams
37will be searched immediately.
38.Pp
39The options are as follows:
40.Bl -tag -width Ds
41.It Fl d
42Display the debugging information.
43The daemon does not fork in this case.
44.It Fl s
45Log the debugging information with syslog.
46.It Fl r
47Set the default router (a hostname or IP address).
48This defaults to the machine running the server.
49.It Fl f
50Specify the file to read boot parameters from.
51Defaults to
52.Pa /etc/bootparams .
53.El
54.Sh FILES
55.Bl -tag -width /etc/bootparams -compact
56.It Pa /etc/bootparams
57default configuration file
58.El
59.Sh SEE ALSO
60.Xr bootparams 5 ,
61.Xr diskless 8
62.Sh AUTHOR
63Originally written by Klas Heggemann <klas@nada.kth.se>
64.Sh BUGS
65You may find the syslog loggings too verbose.
66.Pp
67It's not clear if the non-canonical hack mentioned above is a good idea.
68.Sh WARNING
69If
70.Nm rpc.bootparamd
71is run on a system which is also running YP, your YP
72domainname will be made public information.
73