Deleted Added
full compact
loader.4th.8 (96247) loader.4th.8 (97568)
1.\" Copyright (c) 1999 Daniel C. Sobral
2.\" All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\" notice, this list of conditions and the following disclaimer.

--- 8 unchanged lines hidden (view full) ---

17.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
18.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
19.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
21.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
22.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
23.\" SUCH DAMAGE.
24.\"
1.\" Copyright (c) 1999 Daniel C. Sobral
2.\" All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\" notice, this list of conditions and the following disclaimer.

--- 8 unchanged lines hidden (view full) ---

17.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
18.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
19.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
21.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
22.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
23.\" SUCH DAMAGE.
24.\"
25.\" $FreeBSD: head/sys/boot/forth/loader.4th.8 96247 2002-05-09 11:47:42Z joe $
25.\" $FreeBSD: head/sys/boot/forth/loader.4th.8 97568 2002-05-30 09:24:01Z schweikh $
26.\"
27.Dd April 25, 1999
28.Dt LOADER.4TH 8
29.Os
30.Sh NAME
31.Nm loader.4th
32.Nd loader.conf processing tools
33.Sh DESCRIPTION
34The file that goes by the name of
35.Nm
36is a set of commands designed to manipulate
37.Xr loader.conf 5
38files. The default
39.Pa /boot/loader.rc
40includes
41.Nm
26.\"
27.Dd April 25, 1999
28.Dt LOADER.4TH 8
29.Os
30.Sh NAME
31.Nm loader.4th
32.Nd loader.conf processing tools
33.Sh DESCRIPTION
34The file that goes by the name of
35.Nm
36is a set of commands designed to manipulate
37.Xr loader.conf 5
38files. The default
39.Pa /boot/loader.rc
40includes
41.Nm
42and uses one of it's commands to automatically read and process
42and uses one of its commands to automatically read and process
43the standard
44.Xr loader.conf 5
45files. Other commands exists to help the user specify alternate
46configurations.
47.Pp
48The commands of
49.Nm
50by themselves are not enough for most uses. Please refer to the
51examples below for the most common situations, and to
52.Xr loader 8
53for additional commands.
54.Pp
55Before using any of the commands provided in
56.Nm ,
57it must be included
58through the command:
59.Pp
60.Dl include loader.4th
61.Pp
43the standard
44.Xr loader.conf 5
45files. Other commands exists to help the user specify alternate
46configurations.
47.Pp
48The commands of
49.Nm
50by themselves are not enough for most uses. Please refer to the
51examples below for the most common situations, and to
52.Xr loader 8
53for additional commands.
54.Pp
55Before using any of the commands provided in
56.Nm ,
57it must be included
58through the command:
59.Pp
60.Dl include loader.4th
61.Pp
62This line is present on the default
62This line is present in the default
63.Pa /boot/loader.rc
64file, so it isn't needed (and should not be re-issued) in a normal setup.
65.Pp
66The commands provided by it are:
67.Bl -tag -width disable-module_module -compact -offset indent
68.It Ic boot
69.It Ic boot Ar kernelname Op Cm ...
70.It Ic boot Ar directory Op Cm ...

--- 16 unchanged lines hidden (view full) ---

87so it can be stopped.
88.Pp
89.It Ic start
90Reads
91.Pa /boot/defaults/loader.conf ,
92all other
93.Xr loader.conf 5
94files specified in it, and then proceeds to boot as specified in them. This
63.Pa /boot/loader.rc
64file, so it isn't needed (and should not be re-issued) in a normal setup.
65.Pp
66The commands provided by it are:
67.Bl -tag -width disable-module_module -compact -offset indent
68.It Ic boot
69.It Ic boot Ar kernelname Op Cm ...
70.It Ic boot Ar directory Op Cm ...

--- 16 unchanged lines hidden (view full) ---

87so it can be stopped.
88.Pp
89.It Ic start
90Reads
91.Pa /boot/defaults/loader.conf ,
92all other
93.Xr loader.conf 5
94files specified in it, and then proceeds to boot as specified in them. This
95is command used on the default
95is the command used in the default
96.Pa /boot/loader.rc
97file, and it uses the
98.Pa autoboot
99command (see
100.Xr loader 8 ) ,
101so it can be stopped for further interaction with
102.Xr loader 8 .
103.Pp
104.It Ic initialize
105Initialize the supporting library so commands can be used without
106executing
107.Ic start
108first. Like
109.Ic start ,
110reads
111.Pa /boot/defaults/loader.conf
112and all other
113.Xr loader.conf 5
114files specified in it. Returns a flag on the stack to indicate
96.Pa /boot/loader.rc
97file, and it uses the
98.Pa autoboot
99command (see
100.Xr loader 8 ) ,
101so it can be stopped for further interaction with
102.Xr loader 8 .
103.Pp
104.It Ic initialize
105Initialize the supporting library so commands can be used without
106executing
107.Ic start
108first. Like
109.Ic start ,
110reads
111.Pa /boot/defaults/loader.conf
112and all other
113.Xr loader.conf 5
114files specified in it. Returns a flag on the stack to indicate
115if any configuration file was succesfully loaded.
115if any configuration file was successfully loaded.
116.Pp
117.It Ic read-conf Ar filename
118Reads and processes a
119.Xr loader.conf 5
116.Pp
117.It Ic read-conf Ar filename
118Reads and processes a
119.Xr loader.conf 5
120file. Does not proceeds to boot.
120file. Does not proceed to boot.
121.Pp
122.It Ic enable-module Ar module
123Enables the loading of
124.Ar module .
125.Pp
126.It Ic disable-module Ar module
127Disables the loading of
128.Ar module .

--- 39 unchanged lines hidden (view full) ---

168Standard
169.Pa /boot/loader.rc :
170.Pp
171.Bd -literal -offset indent -compact
172include /boot/loader.4th
173start
174.Ed
175.Pp
121.Pp
122.It Ic enable-module Ar module
123Enables the loading of
124.Ar module .
125.Pp
126.It Ic disable-module Ar module
127Disables the loading of
128.Ar module .

--- 39 unchanged lines hidden (view full) ---

168Standard
169.Pa /boot/loader.rc :
170.Pp
171.Bd -literal -offset indent -compact
172include /boot/loader.4th
173start
174.Ed
175.Pp
176Loads a different kernel with the standard configuration:
176Load a different kernel with the standard configuration:
177.Pp
178.Bd -literal -offset indent -compact
179set kernel="/boot/kernel.old/kernel"
180unload
181boot-conf
182.Ed
183.Pp
177.Pp
178.Bd -literal -offset indent -compact
179set kernel="/boot/kernel.old/kernel"
180unload
181boot-conf
182.Ed
183.Pp
184Reads an additional configuration file and then proceeds to boot:
184Read an additional configuration file and then proceed to boot:
185.Pp
186.Bd -literal -offset indent -compact
187unload
188read-conf /boot/special.conf
189boot-conf
190.Ed
191.Pp
192Disable the loading of the splash screen module and bitmap and then
185.Pp
186.Bd -literal -offset indent -compact
187unload
188read-conf /boot/special.conf
189boot-conf
190.Ed
191.Pp
192Disable the loading of the splash screen module and bitmap and then
193proceeds to boot:
193proceed to boot:
194.Pp
195.Bd -literal -offset indent -compact
196unload
197disable-module splash_bmp
198disable-module bitmap
199boot-conf
200.Ed
201.Sh SEE ALSO
202.Xr loader.conf 5 ,
203.Xr loader 8
204.Sh HISTORY
205.Nm
206first appeared in
207.Fx 3.2 .
208.Sh AUTHORS
209.Nm
210was written by
211.An Daniel C. Sobral Aq dcs@FreeBSD.org .
212.Sh BUGS
194.Pp
195.Bd -literal -offset indent -compact
196unload
197disable-module splash_bmp
198disable-module bitmap
199boot-conf
200.Ed
201.Sh SEE ALSO
202.Xr loader.conf 5 ,
203.Xr loader 8
204.Sh HISTORY
205.Nm
206first appeared in
207.Fx 3.2 .
208.Sh AUTHORS
209.Nm
210was written by
211.An Daniel C. Sobral Aq dcs@FreeBSD.org .
212.Sh BUGS
213A british espionage series.
213A British espionage series.