xref: /freebsd/usr.sbin/bootparamd/bootparamd/bootparams.5 (revision b2c76c41be32f904179efed29c0ca04d53f3996c)
1220e7e44SJoerg Wunsch.\"
2220e7e44SJoerg Wunsch.\" Copyright (c) 1994 Gordon W. Ross
3220e7e44SJoerg Wunsch.\" All rights reserved.
4220e7e44SJoerg Wunsch.\"
5220e7e44SJoerg Wunsch.\" Redistribution and use in source and binary forms, with or without
6220e7e44SJoerg Wunsch.\" modification, are permitted provided that the following conditions
7220e7e44SJoerg Wunsch.\" are met:
8220e7e44SJoerg Wunsch.\" 1. Redistributions of source code must retain the above copyright
9220e7e44SJoerg Wunsch.\"    notice, this list of conditions and the following disclaimer.
10220e7e44SJoerg Wunsch.\" 2. Redistributions in binary form must reproduce the above copyright
11220e7e44SJoerg Wunsch.\"    notice, this list of conditions and the following disclaimer in the
12220e7e44SJoerg Wunsch.\"    documentation and/or other materials provided with the distribution.
13220e7e44SJoerg Wunsch.\" 3. The name of the author may not be used to endorse or promote products
14220e7e44SJoerg Wunsch.\"    derived from this software without specific prior written permission.
15220e7e44SJoerg Wunsch.\"
16220e7e44SJoerg Wunsch.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
17220e7e44SJoerg Wunsch.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
18220e7e44SJoerg Wunsch.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
19220e7e44SJoerg Wunsch.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
20220e7e44SJoerg Wunsch.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
21220e7e44SJoerg Wunsch.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
22220e7e44SJoerg Wunsch.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
23220e7e44SJoerg Wunsch.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
24220e7e44SJoerg Wunsch.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
25220e7e44SJoerg Wunsch.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
26220e7e44SJoerg Wunsch.\"
27220e7e44SJoerg Wunsch.\"	from: Id: bootparams.5,v 1.2 1994/10/03 19:26:13 gwr Exp
28220e7e44SJoerg Wunsch.\"
29220e7e44SJoerg Wunsch.Dd October 2, 1994
30220e7e44SJoerg Wunsch.Dt BOOTPARAMS 5
31220e7e44SJoerg Wunsch.Os
32220e7e44SJoerg Wunsch.Sh NAME
33220e7e44SJoerg Wunsch.Nm bootparams
34220e7e44SJoerg Wunsch.Nd boot parameter database
35220e7e44SJoerg Wunsch.Sh SYNOPSIS
36220e7e44SJoerg Wunsch.Nm /etc/bootparams
37220e7e44SJoerg Wunsch.Sh DESCRIPTION
38220e7e44SJoerg WunschThe
39112eace2SPhilippe Charnier.Nm
40220e7e44SJoerg Wunschfile specifies the boot parameters that
4160ecaf37SRuslan Ermilov.Xr diskless 8
42220e7e44SJoerg Wunschclients may request when booting over the network.
43220e7e44SJoerg WunschEach client supported by this server must have an entry in the
44112eace2SPhilippe Charnier.Nm
45220e7e44SJoerg Wunschfile containing the pathnames for its
4660ecaf37SRuslan Ermilov.Dq root
47220e7e44SJoerg Wunschand (optionally)
4860ecaf37SRuslan Ermilov.Dq swap
49220e7e44SJoerg Wunschareas.
50220e7e44SJoerg Wunsch.Pp
51220e7e44SJoerg WunschEach line in the file
5260ecaf37SRuslan Ermilov(other than comment lines that begin with a
5360ecaf37SRuslan Ermilov.Ql # )
54220e7e44SJoerg Wunschspecifies the client name followed by the pathnames that
55220e7e44SJoerg Wunschthe client may request by their logical names.
56220e7e44SJoerg WunschThe components of the line are delimited with blank or tab,
57220e7e44SJoerg Wunschand may be continued onto multiple lines with a backslash.
58220e7e44SJoerg Wunsch.Pp
59220e7e44SJoerg WunschFor example:
60220e7e44SJoerg Wunsch.Bd -literal -offset indent
61c1abba55SMike Smithdummy	root=host:/export/dummy/root \\
62c1abba55SMike Smith	swap=host:/export/dummy/swap \\
63c1abba55SMike Smith	dump=host:/export/dummy/swap
64220e7e44SJoerg Wunsch.Ed
65220e7e44SJoerg Wunsch.Pp
6660ecaf37SRuslan ErmilovWhen the client named
6760ecaf37SRuslan Ermilov.Dq dummy
6860ecaf37SRuslan Ermilovrequests the pathname for its logical
6960ecaf37SRuslan Ermilov.Dq root
7060ecaf37SRuslan Ermilovit will be given the pathname
7160ecaf37SRuslan Ermilov.Dq Pa host:/export/dummy/root
72220e7e44SJoerg Wunschas the response to its
73220e7e44SJoerg Wunsch.Tn RPC
7460ecaf37SRuslan Ermilovrequest.
7560ecaf37SRuslan ErmilovThe
7660ecaf37SRuslan Ermilov.Dq host:
7760ecaf37SRuslan Ermilovcomponent must be supplied.
78220e7e44SJoerg Wunsch.Sh FILES
79220e7e44SJoerg Wunsch.Bl -tag -width /etc/bootparams -compact
80220e7e44SJoerg Wunsch.It Pa /etc/bootparams
81220e7e44SJoerg Wunschdefault configuration file
82220e7e44SJoerg Wunsch.El
83112eace2SPhilippe Charnier.Sh SEE ALSO
84e6b3e43eSBruce Evans.Xr bootparamd 8 ,
85e6b3e43eSBruce Evans.Xr diskless 8
86