usr.sbin/bootparamd/bootparamd/bootparamd.8

   1 .\" @(#)bootparamd.8
   2 .\" $FreeBSD$
   3 .Dd December 14, 2000
   4 .Dt BOOTPARAMD 8
   5 .Os
   6 .Sh NAME
   7 .Nm bootparamd
   8 .Nd boot parameter server
   9 .Sh SYNOPSIS
  10 .Nm
  11 .Op Fl ds
  12 .Op Fl r Ar router
  13 .Op Fl f Ar file
  14 .Sh DESCRIPTION
  15 .Nm Bootparamd
  16 is a server process that provides information to
  17 .Xr diskless 8
  18 clients necessary for booting.
  19 It consults the
  20 .Pa /etc/bootparams
  21 file.
  22 .Pp
  23 This version will allow the use of aliases on the hostname in the
  24 .Pa /etc/bootparams
  25 file.
  26 The returned hostname to the
  27 .Em whoami
  28 request done by the booting client
  29 will be the name that appears in
  30 .Pa /etc/bootparams
  31 and not the canonical name.
  32 In this way you can keep the answer short enough
  33 so that machines that cannot handle long hostnames will not fail during boot.
  34 .Sh OPTIONS
  35 .Bl -tag -width Fl
  36 .It Fl d
  37 Display the debugging information.
  38 .It Fl s
  39 Log the debugging information with
  40 .Xr syslog 3 .
  41 .It Fl r Ar router
  42 The default router (a machine or an IP-address).
  43 This defaults to the machine running the server.
  44 .It Fl f Ar file
  45 The file to use as boot parameter file instead of
  46 .Pa /etc/bootparams .
  47 .El
  48 .Sh FILES
  49 .Bl -tag -width /etc/bootparams -compact
  50 .It /etc/bootparams
  51 default boot parameter file
  52 .El
  53 .Sh EXAMPLES
  54 When netbooting diskless SunOS/Xkernel SPARCstations the booted SunOS kernel
  55 also broadcasts to the all-0 address.
  56 The SunOS kernel hangs until it receives a reply.
  57 To accommodate this behaviour add an alias address
  58 that responds to an all-0 broadcast.
  59 So, add something like
  60 .Ql "ifconfig xl0 192.168.200.254 netmask 255.255.255.255 broadcast 192.168.200.0 alias
  61 on the relevant network interface on your
  62 .Nm
  63 server.
  64 The alias address must of course be free for use.
  65 .Sh SEE ALSO
  66 .Xr syslog 3 ,
  67 .Xr bootparams 5 ,
  68 .Xr diskless 8
  69 .Sh BUGS
  70 You may find the
  71 .Xr syslog 3
  72 loggings to be verbose.
  73 .Sh AUTHORS
  74 Written by
  75 .An Klas Heggemann Aq klas@nada.kth.se .