1$FreeBSD: src/usr.sbin/bootparamd/bootparamd/README,v 1.2 2001/07/23 12:05:27 kris Exp $
2
3This directory contains a version of the rpc.bootparamd, which have been
4written using the Sun's RPC protocol for bootparamd. To use it you must
5have a copy of the bootparam_prot.x file which on Sun systems you find in
6
7	/usr/include/rpcsvc/bootparam_prot.x
8
9(( This file was retrieved from the Sun-RPC source package ))
10
11
12This code is not copyright, and is placed in the public domain. Feel free to
13use and modify. Please send modifications and/or suggestions + bug fixes to
14
15	Klas Heggemann <klas@nada.kth.se>
16
17
18RPC.BOOTPARAMD
19
20
21The rpc.bootparamd program does NOT use the yellow pages for the bootparams
22database. This data should recide in /etc/bootparams on the local host,
23or another file given when the server is started.
24
25The default router is set to the address of the machine running the server.
26This may not be a good thing to do, so it can be modified using the -r
27option when startning the daemon.
28
29This program was written with the need to keep short hostnames in the
30/etc/bootparams file and long (canonical) names in the hosts database.
31It probably also will work in conjunction with a nameserver, since matching
32is done by comparing the canonical name of the booting machine with the
33canonical name of the hosts found in the bootparams database.
34
35It is kept simple, e g there is no caching of data, but the bootparameter file
36is read at each request.
37
38
39CALLBOOTD
40
41The debugging tool callbootd is used to check the response you get
42to a specific (booting) request. It can be used as
43	callbootd server inet-address
44or
45	callbootd server hostname file
46where "server" is a machine running the rpc.bootparamd program, "inet-address"
47is the internet address of a booting machine, "hostname" is the name of a
48booting machine and "file" the requested file, typically "root", "swap" or
49"dump".
50
51You may also use "all" instead of a specific server, in which case a RPC
52broadcast is performed. The broadcast is performed 4 times and then the
53program times out, after printing all responses.
54
55
56TODO
57
58Cache the date, instead of rereading it.
59Maybe match by comparing the inet address instead. (But beware that caching
60will prevent the server from detecting that a machine has changed name
61or address.)
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76