xref: /netbsd-src/usr.sbin/rpc.bootparamd/rpc.bootparamd.8 (revision 5656e47ecf6fbeeb7809e33553957b0cbc6fb6b9)
1*5656e47eSreed.\" $NetBSD: rpc.bootparamd.8,v 1.17 2008/11/08 02:08:39 reed Exp $
2ae99bc57Sderaadt.\" @(#)bootparamd.8
303126e1cSkleink.Dd January 8, 1994
4*5656e47eSreed.Dt RPC.BOOTPARAMD 8
5d1407362Sgarbled.Os
6ae99bc57Sderaadt.Sh NAME
7cc47146dSjtc.Nm bootparamd ,
8cc47146dSjtc.Nm rpc.bootparamd
9ae99bc57Sderaadt.Nd boot parameter server
10ae99bc57Sderaadt.Sh SYNOPSIS
116d66b6beSlukem.Nm
12e195d590Sitojun.Op Fl ds
133422a6eaStsutsui.Op Fl i Ar interface
14e72c8b76Smikel.Op Fl r Ar router
15e72c8b76Smikel.Op Fl f Ar file
16ae99bc57Sderaadt.Sh DESCRIPTION
176d66b6beSlukem.Nm
18ae99bc57Sderaadtis a server process that provides information to diskless clients
19ae99bc57Sderaadtnecessary for booting. It consults the file
20ae99bc57Sderaadt.Dq Pa /etc/bootparams .
21ae99bc57SderaadtIt should normally be started from
22ae99bc57Sderaadt.Dq Pa /etc/rc .
23ae99bc57Sderaadt.Pp
24ae99bc57SderaadtThis version will allow the use of aliases on the hostname in the
25ae99bc57Sderaadt.Dq Pa /etc/bootparams
26ae99bc57Sderaadtfile. The hostname returned in response to the booting client's whoami request
27ae99bc57Sderaadtwill be the name that appears in the config file, not the canonical name.
28ae99bc57SderaadtIn this way you can keep the answer short enough
29ae99bc57Sderaadtso that machines that cannot handle long hostnames won't fail during boot.
30d5171077Sderaadt.Pp
31d5171077SderaadtWhile parsing, if a line containing just ``+'' is found, and
32d5171077Sderaadtthe YP subsystem is active, the YP map
33d5171077Sderaadt.Pa bootparams
34d5171077Sderaadtwill be searched immediately.
35ae99bc57Sderaadt.Sh OPTIONS
36ae99bc57Sderaadt.Bl -tag -width indent
37ae99bc57Sderaadt.It Fl d
38ae99bc57SderaadtDisplay the debugging information. The daemon does not fork in this
39ae99bc57Sderaadtcase.
40e195d590Sitojun.It Fl i Ar interface
41e195d590SitojunSpecify the interface to become the default router.
42e195d590Sitojun.Nm
43e195d590Sitojunpicks the first IPv4 address it finds on the system by default.
44e195d590SitojunWith
45e195d590Sitojun.Fl i ,
46e195d590Sitojunyou can control which interface to be used to obtain the default router address.
47e195d590Sitojun.Fl r
48e195d590Sitojunoverrides
49e195d590Sitojun.Fl i .
50ae99bc57Sderaadt.It Fl s
51e72c8b76SmikelLog the debugging information with
52e72c8b76Smikel.Xr syslog 3 .
53ae99bc57Sderaadt.It Fl r
54ae99bc57SderaadtSet the default router (a hostname or IP-address).
55ae99bc57SderaadtThis defaults to the machine running the server.
56ae99bc57Sderaadt.It Fl f
57ae99bc57SderaadtSpecify the file to use as boot parameter file instead of
58ae99bc57Sderaadt.Dq Pa /etc/bootparams .
59ae99bc57Sderaadt.El
60ae99bc57Sderaadt.Sh FILES
61ae99bc57Sderaadt.Bl -tag -width /etc/bootparams -compact
62ae99bc57Sderaadt.It Pa /etc/bootparams
63ae99bc57Sderaadtdefault configuration file
64ae99bc57Sderaadt.El
65b2275072Scgd.Sh SEE ALSO
66ae9da3f7Sgwr.Xr bootparams 5
67fa58e5cfSwiz.Sh AUTHORS
68806593a8SgrantOriginally written by
69806593a8Sgrant.An Klas Heggemann
70806593a8Sgrant.Aq klas@nada.kth.se .
71ae99bc57Sderaadt.Sh BUGS
72e72c8b76SmikelYou may find the syslog messages too verbose.
73ae99bc57Sderaadt.Pp
74e72c8b76SmikelIt's not clear if the non-canonical hack mentioned above is a good idea.
75