usr.sbin/bootparamd/bootparamd/README

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