Sun Sep 13 18:39:20 2009 UTC ()
PR# port-i386/39463: boot.cfg(8) does not mention about relative path for
	the 'load' option

Document the search behaviour of the 'load' directive when an absolute
path is not specified.


(jmcneill)
diff -r1.16 -r1.17 src/share/man/man5/boot.cfg.5
cvs diff -r1.16 -r1.17 src/share/man/man5/boot.cfg.5 (expand / switch to unified diff)

--- src/share/man/man5/boot.cfg.5 2009/09/04 10:34:16 1.16
+++ src/share/man/man5/boot.cfg.5 2009/09/13 18:39:20 1.17
@@ -1,41 +1,41 @@ @@ -1,41 +1,41 @@
1.\" $NetBSD: boot.cfg.5,v 1.16 2009/09/04 10:34:16 wiz Exp $ 1.\" $NetBSD: boot.cfg.5,v 1.17 2009/09/13 18:39:20 jmcneill Exp $
2.\" 2.\"
3.\" Copyright (c) 2007 Stephen Borrill 3.\" Copyright (c) 2007 Stephen Borrill
4.\" All rights reserved. 4.\" All rights reserved.
5.\" 5.\"
6.\" Redistribution and use in source and binary forms, with or without 6.\" Redistribution and use in source and binary forms, with or without
7.\" modification, are permitted provided that the following conditions 7.\" modification, are permitted provided that the following conditions
8.\" are met: 8.\" are met:
9.\" 1. Redistributions of source code must retain the above copyright 9.\" 1. Redistributions of source code must retain the above copyright
10.\" notice, this list of conditions and the following disclaimer. 10.\" notice, this list of conditions and the following disclaimer.
11.\" 2. Redistributions in binary form must reproduce the above copyright 11.\" 2. Redistributions in binary form must reproduce the above copyright
12.\" notice, this list of conditions and the following disclaimer in the 12.\" notice, this list of conditions and the following disclaimer in the
13.\" documentation and/or other materials provided with the distribution. 13.\" documentation and/or other materials provided with the distribution.
14.\" 3. The name of the author may not be used to endorse or promote products 14.\" 3. The name of the author may not be used to endorse or promote products
15.\" derived from this software without specific prior written permission 15.\" derived from this software without specific prior written permission
16.\" 16.\"
17.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 17.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
18.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 18.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
19.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 19.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
20.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 20.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
21.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 21.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
22.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 22.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
23.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 23.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
24.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 24.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25.\" INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 25.\" INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
26.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 26.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27.\" 27.\"
28.Dd September 4, 2009 28.Dd September 13, 2009
29.Dt BOOT.CFG 5 29.Dt BOOT.CFG 5
30.Os 30.Os
31.Sh NAME 31.Sh NAME
32.Nm boot.cfg 32.Nm boot.cfg
33.Nd configuration file for /boot 33.Nd configuration file for /boot
34.Sh DESCRIPTION 34.Sh DESCRIPTION
35The file 35The file
36.Pa /boot.cfg 36.Pa /boot.cfg
37is used to alter the behaviour of the standard boot loader described in 37is used to alter the behaviour of the standard boot loader described in
38.Xr boot 8 . 38.Xr boot 8 .
39Configuration changes include setting the timeout, choosing a console device, 39Configuration changes include setting the timeout, choosing a console device,
40altering the banner text and displaying a menu allowing boot commands to be 40altering the banner text and displaying a menu allowing boot commands to be
41easily chosen. 41easily chosen.
@@ -83,27 +83,33 @@ Should be set to one of @@ -83,27 +83,33 @@ Should be set to one of
83.Sq a 83.Sq a
84for automatic, 84for automatic,
85.Sq l 85.Sq l
86for letters and 86for letters and
87.Sq n 87.Sq n
88for numbers. 88for numbers.
89If set to automatic (the default), menu options will be displayed numerically 89If set to automatic (the default), menu options will be displayed numerically
90unless there are more than 9 options and the timeout is greater than zero. 90unless there are more than 9 options and the timeout is greater than zero.
91If there are more than 9 options with a timeout greater than zero and 91If there are more than 9 options with a timeout greater than zero and
92the format is set to number, only the first 9 options will be available. 92the format is set to number, only the first 9 options will be available.
93.It Sy load 93.It Sy load
94Used to load kernel modules, which will be passed on to the kernel for 94Used to load kernel modules, which will be passed on to the kernel for
95initialization during early boot. 95initialization during early boot.
96The argument is the complete path and file name of the module to be loaded. 96The argument is either the complete path and file name of the module to be
 97loaded, or a symbolic module name.
 98When the argument is not an absolute path, the boot loader will first
 99attempt to load
 100.Pa /stand/<machine>/<kernel_version>/modules/<name>/<name>.kmod .
 101If that file does not exist, it will then attempt to load
 102.Pa /<name> .
97May be used as many times as needed. 103May be used as many times as needed.
98.It Sy menu 104.It Sy menu
99(may be present multiple times) 105(may be present multiple times)
100Used to define a menu item to be displayed to the end-user at boot time 106Used to define a menu item to be displayed to the end-user at boot time
101which allows a series of boot commands to be run without further typing. 107which allows a series of boot commands to be run without further typing.
102The value consists of the required menu text, followed by a colon 108The value consists of the required menu text, followed by a colon
103.Pq Sq \&: 109.Pq Sq \&:
104and then the desired command(s). 110and then the desired command(s).
105Multiple commands can be specified separated by a semi-colon. 111Multiple commands can be specified separated by a semi-colon.
106If the specified menu text is empty 112If the specified menu text is empty
107(the colon appears immediately after the equals sign), 113(the colon appears immediately after the equals sign),
108then the displayed menu text is the same as the command. 114then the displayed menu text is the same as the command.
109For example: 115For example: