Mdoc(7)ify.

This commit is contained in:
Ruslan Ermilov 2000-12-14 08:01:59 +00:00
parent 7d8e3aa013
commit 60ecaf3730
Notes: svn2git 2020-12-20 02:59:44 +00:00
svn path=/head/; revision=70008
2 changed files with 45 additions and 22 deletions

View File

@ -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 .

View File

@ -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