usr.sbin/rpc.bootparamd/rpc.bootparamd.8

   1 .\" $NetBSD: rpc.bootparamd.8,v 1.16 2003/08/20 13:07:41 tsutsui Exp $
   2 .\" @(#)bootparamd.8
   3 .Dd January 8, 1994
   4 .Dt RPC.BOOTPARAMD 8
   5 .Os
   6 .Sh NAME
   7 .Nm bootparamd ,
   8 .Nm rpc.bootparamd
   9 .Nd boot parameter server
  10 .Sh SYNOPSIS
  11 .Nm
  12 .Op Fl ds
  13 .Op Fl i Ar interface
  14 .Op Fl r Ar router
  15 .Op Fl f Ar file
  16 .Sh DESCRIPTION
  17 .Nm
  18 is a server process that provides information to diskless clients
  19 necessary for booting. It consults the file
  20 .Dq Pa /etc/bootparams .
  21 It should normally be started from
  22 .Dq Pa /etc/rc .
  23 .Pp
  24 This version will allow the use of aliases on the hostname in the
  25 .Dq Pa /etc/bootparams
  26 file. The hostname returned in response to the booting client's whoami request
  27 will be the name that appears in the config file, not the canonical name.
  28 In this way you can keep the answer short enough
  29 so that machines that cannot handle long hostnames won't fail during boot.
  30 .Pp
  31 While parsing, if a line containing just ``+'' is found, and
  32 the YP subsystem is active, the YP map
  33 .Pa bootparams
  34 will be searched immediately.
  35 .Sh OPTIONS
  36 .Bl -tag -width indent
  37 .It Fl d
  38 Display the debugging information. The daemon does not fork in this
  39 case.
  40 .It Fl i Ar interface
  41 Specify the interface to become the default router.
  42 .Nm
  43 picks the first IPv4 address it finds on the system by default.
  44 With
  45 .Fl i ,
  46 you can control which interface to be used to obtain the default router address.
  47 .Fl r
  48 overrides
  49 .Fl i .
  50 .It Fl s
  51 Log the debugging information with
  52 .Xr syslog 3 .
  53 .It Fl r
  54 Set the default router (a hostname or IP-address).
  55 This defaults to the machine running the server.
  56 .It Fl f
  57 Specify the file to use as boot parameter file instead of
  58 .Dq Pa /etc/bootparams .
  59 .El
  60 .Sh FILES
  61 .Bl -tag -width /etc/bootparams -compact
  62 .It Pa /etc/bootparams
  63 default configuration file
  64 .El
  65 .Sh SEE ALSO
  66 .Xr bootparams 5
  67 .Sh AUTHORS
  68 Originally written by
  69 .An Klas Heggemann
  70 .Aq klas@nada.kth.se .
  71 .Sh BUGS
  72 You may find the syslog messages too verbose.
  73 .Pp
  74 It's not clear if the non-canonical hack mentioned above is a good idea.