usr.sbin/bootparamd/bootparamd/bootparamd.8

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