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