1.\" $OpenBSD: rpc.bootparamd.8,v 1.19 2013/07/16 11:13:34 schwarze Exp $
2.\" @(#)bootparamd.8
3.\"
4.\" This code is not copyright, and is placed in the public domain.
5.\" Feel free to use and modify. Please send modifications and/or
6.\" suggestions + bug fixes to Klas Heggemann <klas@nada.kth.se>
7.\"
8.\" Various small changes by Theo de Raadt <deraadt@fsa.ca>
9.\" Parser rewritten (adding YP support) by Roland McGrath <roland@frob.com>
10.\"
11.Dd $Mdocdate: July 16 2013 $
12.Dt BOOTPARAMD 8
13.Os
14.Sh NAME
15.Nm bootparamd ,
16.Nm rpc.bootparamd
17.Nd boot parameter server
18.Sh SYNOPSIS
19.Nm rpc.bootparamd
20.Op Fl ds
21.Op Fl f Ar file
22.Op Fl r Ar router
23.Sh DESCRIPTION
24.Nm
25is a server process that provides information to diskless clients
26necessary for booting.
27It consults the file
28.Pa /etc/bootparams .
29It should normally be started from
30.Pa /etc/rc .
31.Pp
32This version will allow the use of aliases on the hostname in the
33.Pa /etc/bootparams
34file.
35The hostname returned in response to the booting client's whoami request
36will be the name that appears in the config file, not the canonical name.
37In this way you can keep the answer short enough
38so that machines that cannot handle long hostnames won't fail during boot.
39.Pp
40While parsing, if a line containing just
41.Dq \&+
42is found, and the YP subsystem is active, the YP map
43.Pa bootparams
44will be searched immediately.
45.Pp
46The options are as follows:
47.Bl -tag -width Ds
48.It Fl d
49Display the debugging information.
50The daemon does not fork in this case.
51.It Fl f Ar file
52Specify the
53.Ar file
54to read boot parameters from.
55Defaults to
56.Pa /etc/bootparams .
57.It Fl r Ar router
58Set the default
59.Ar router
60(a hostname or IP address).
61This defaults to the machine running the server.
62.It Fl s
63Log the debugging information with syslog.
64.El
65.Sh FILES
66.Bl -tag -width /etc/bootparams -compact
67.It Pa /etc/bootparams
68default configuration file
69.El
70.Sh SEE ALSO
71.Xr bootparams 5 ,
72.Xr diskless 8
73.Sh AUTHORS
74Originally written by
75.An Klas Heggemann Aq Mt klas@nada.kth.se .
76.Sh BUGS
77You may find the syslog loggings too verbose.
78.Pp
79It's not clear if the non-canonical hack mentioned above is a good idea.
80.Sh WARNING
81If
82.Nm rpc.bootparamd
83is run on a system which is also running YP, your YP
84domainname will be made public information.
85