usr.sbin/bootparamd/bootparamd/README

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