From 50947b7f56b4f850b2848c8ea7380970e7ba8cad Mon Sep 17 00:00:00 2001 From: ru Date: Thu, 14 Dec 2000 08:01:59 +0000 Subject: Mdoc(7)ify. --- usr.sbin/bootparamd/bootparamd/bootparamd.8 | 43 +++++++++++++++++++---------- usr.sbin/bootparamd/bootparamd/bootparams.5 | 24 ++++++++++------ 2 files changed, 45 insertions(+), 22 deletions(-) (limited to 'usr.sbin/bootparamd') diff --git a/usr.sbin/bootparamd/bootparamd/bootparamd.8 b/usr.sbin/bootparamd/bootparamd/bootparamd.8 index acbac3d..622e7cb 100644 --- a/usr.sbin/bootparamd/bootparamd/bootparamd.8 +++ b/usr.sbin/bootparamd/bootparamd/bootparamd.8 @@ -1,6 +1,6 @@ .\" @(#)bootparamd.8 .\" $FreeBSD$ -.Dd November 8, 1989 +.Dd December 14, 2000 .Dt BOOTPARAMD 8 .Os .Sh NAME @@ -13,8 +13,9 @@ .Op Fl f Ar file .Sh DESCRIPTION .Nm Bootparamd -is a server process that provides information to diskless clients -necessary for booting. +is a server process that provides information to +.Xr diskless 8 +clients necessary for booting. It consults the .Pa /etc/bootparams file. @@ -22,18 +23,21 @@ file. This version will allow the use of aliases on the hostname in the .Pa /etc/bootparams file. -The returned hostname to the whoami request done by the booting client +The returned hostname to the +.Em whoami +request done by the booting client will be the name that appears in .Pa /etc/bootparams and not the canonical name. In this way you can keep the answer short enough -so that machines that can not handle long hostnames won't fail during boot. +so that machines that can not handle long hostnames will not fail during boot. .Sh OPTIONS .Bl -tag -width Fl .It Fl d Display the debugging information. .It Fl s -Log the debugging information with syslog. +Log the debugging information with +.Xr syslog 3 . .It Fl r Ar router The default router (a machine or an IP-address). This defaults to the machine running the server. @@ -44,17 +48,28 @@ The file to use as boot parameter file instead of .Sh FILES .Bl -tag -width /etc/bootparams -compact .It /etc/bootparams +default boot parameter file .El .Sh EXAMPLES When netbooting diskless SunOS/Xkernel SPARCstations the booted SunOS kernel -also broadcasts to the all-0 address. The SunOS kernel hangs until it -receives a reply. To accomodate this behaviour add an alias address -that responds to an all-0 broadcast. So, add something like 'ifconfig xl0 -192.168.200.254 netmask 255.255.255.255 broadcast 192.168.200.0 alias' -on the relevant network interface on your bootparamd server. The alias -address must of course be free for use. +also broadcasts to the all-0 address. +The SunOS kernel hangs until it receives a reply. +To accommodate this behaviour add an alias address +that responds to an all-0 broadcast. +So, add something like +.Ql "ifconfig xl0 192.168.200.254 netmask 255.255.255.255 broadcast 192.168.200.0 alias +on the relevant network interface on your +.Nm +server. +The alias address must of course be free for use. +.Sh SEE ALSO +.Xr syslog 3 , +.Xr bootparams 5 , +.Xr diskless 8 .Sh BUGS -You may find the syslog loggings to be verbose. +You may find the +.Xr syslog 3 +loggings to be verbose. .Sh AUTHORS Written by -.An Klas Heggemann Aq klas@nada.kth.se +.An Klas Heggemann Aq klas@nada.kth.se . diff --git a/usr.sbin/bootparamd/bootparamd/bootparams.5 b/usr.sbin/bootparamd/bootparamd/bootparams.5 index 85f4c98..0ab47e4 100644 --- a/usr.sbin/bootparamd/bootparamd/bootparams.5 +++ b/usr.sbin/bootparamd/bootparamd/bootparams.5 @@ -1,3 +1,4 @@ +.hlm 0 .\" .\" Copyright (c) 1994 Gordon W. Ross .\" All rights reserved. @@ -39,18 +40,19 @@ The .Nm file specifies the boot parameters that -diskless +.Xr diskless 8 clients may request when booting over the network. Each client supported by this server must have an entry in the .Nm file containing the pathnames for its -.Nm root +.Dq root and (optionally) -.Nm swap +.Dq swap areas. .Pp Each line in the file -(other than comment lines that begin with a #) +(other than comment lines that begin with a +.Ql # ) specifies the client name followed by the pathnames that the client may request by their logical names. The components of the line are delimited with blank or tab, @@ -63,12 +65,18 @@ dummy root=host:/export/dummy/root \\ dump=host:/export/dummy/swap .Ed .Pp -When the client named "dummy" requests the pathname for -its logical "root" it will be given the pathname -.Dq Pa "host:/export/dummy/root" +When the client named +.Dq dummy +requests the pathname for its logical +.Dq root +it will be given the pathname +.Dq Pa host:/export/dummy/root as the response to its .Tn RPC -request. The "host:" component must be supplied. +request. +The +.Dq host: +component must be supplied. .Sh FILES .Bl -tag -width /etc/bootparams -compact .It Pa /etc/bootparams -- cgit v1.1