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