summaryrefslogtreecommitdiff
path: root/usr/src/man/man5/loader.4th.5
diff options
context:
space:
mode:
Diffstat (limited to 'usr/src/man/man5/loader.4th.5')
-rw-r--r--usr/src/man/man5/loader.4th.5206
1 files changed, 0 insertions, 206 deletions
diff --git a/usr/src/man/man5/loader.4th.5 b/usr/src/man/man5/loader.4th.5
deleted file mode 100644
index 6c9d20ed44..0000000000
--- a/usr/src/man/man5/loader.4th.5
+++ /dev/null
@@ -1,206 +0,0 @@
-.\" Copyright (c) 1999 Daniel C. Sobral
-.\" All rights reserved.
-.\"
-.\" Redistribution and use in source and binary forms, with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\" 1. Redistributions of source code must retain the above copyright
-.\" notice, this list of conditions and the following disclaimer.
-.\" 2. Redistributions in binary form must reproduce the above copyright
-.\" notice, this list of conditions and the following disclaimer in the
-.\" documentation and/or other materials provided with the distribution.
-.\"
-.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
-.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
-.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
-.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
-.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
-.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
-.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
-.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
-.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.Dd Apr 22, 2017
-.Dt LOADER.4TH 5
-.Os
-.Sh NAME
-.Nm loader.4th
-.Nd loader.conf processing tools
-.Sh DESCRIPTION
-The file that goes by the name of
-.Nm
-is a set of commands designed to manipulate
-.Xr loader.conf 4
-files.
-The default
-.Pa /boot/loader.rc
-includes
-.Nm
-and uses one of its commands to automatically read and process
-the standard
-.Xr loader.conf 4
-files.
-Other commands exists to help the user specify alternate
-configurations.
-.Pp
-The commands of
-.Nm
-by themselves are not enough for most uses.
-Please refer to the
-examples below for the most common situations, and to
-.Xr loader 5
-for additional commands.
-.Pp
-Before using any of the commands provided in
-.Nm ,
-it must be included
-through the command:
-.Pp
-.Dl include loader.4th
-.Pp
-This line is present in the default
-.Pa /boot/loader.rc
-file, so it is not needed (and should not be re-issued) in a normal setup.
-.Pp
-The commands provided by it are:
-.Bl -tag -width disable-module_module -compact -offset indent
-.It Ic boot
-.It Ic boot Ar kernelname Op Cm ...
-.It Ic boot Ar directory Op Cm ...
-.It Ic boot Fl flag Cm ...
-Boot as specified by the
-.Xr loader.conf 4
-files read.
-.Pp
-Depending on the arguments passed, it can override boot flags and
-either the kernel name or the search path for kernel and modules.
-.Pp
-.It Ic boot-conf
-.It Ic boot-conf Ar kernelname Op Cm ...
-.It Ic boot-conf Ar directory Op Cm ...
-.It Ic boot-conf Fl flag Cm ...
-Works like
-.Ic boot
-described above, but instead of booting immediately, uses
-.Ic autoboot ,
-so it can be stopped.
-.Pp
-.It Ic start
-Reads
-.Pa /boot/defaults/loader.conf ,
-all other
-.Xr loader.conf 4
-files specified in it, then loads the desired kernel and modules
-.Pq if not already loaded .
-After which you can use the
-.Ic boot
-or
-.Ic autoboot
-commands or simply exit (provided
-.Va autoboot_delay
-is not set to NO) to boot the system.
-.Ic start
-is the command used in the default
-.Pa /boot/loader.rc
-file
-.Pq see Xr loader 5 .
-.Pp
-.It Ic initialize
-Initialize the support library so commands can be used without executing
-.Ic start
-first.
-Like
-.Ic start ,
-it reads
-.Pa /boot/defaults/loader.conf
-and all other
-.Xr loader.conf 4
-files specified in it
-.Pq but does not load kernel or modules .
-Returns a flag on the stack to indicate
-if any configuration files were successfully loaded.
-.Pp
-.It Ic read-conf Ar filename
-Reads and processes a
-.Xr loader.conf 4
-file.
-Does not proceed to boot.
-.Pp
-.It Ic enable-module Ar module
-Enables the loading of
-.Ar module .
-.Pp
-.It Ic disable-module Ar module
-Disables the loading of
-.Ar module .
-.Pp
-.It Ic toggle-module Ar module
-Toggles the loading of
-.Ar module
-on and off.
-.Pp
-.It Ic show-module Ar module
-Shows the information gathered in the
-.Xr loader.conf 4
-files about the module
-.Ar module .
-.Pp
-.It Ic show-module-options
-Shows all modules defined in current
-.Xr loader.conf 4
-configuration.
-.Pp
-.It Ic retry
-Used inside
-.Xr loader.conf 4
-files to specify the action after a module loading fails.
-.Pp
-.It Ic ignore
-Used inside
-.Xr loader.conf 4
-files to specify the action after a module loading fails.
-.It Ic try-include Ar file Op Ar
-Process script files if they exist.
-Each file, in turn, is completely read into memory,
-and then each of its lines is passed to the command line interpreter.
-If any error is returned by the interpreter, the try-include
-command aborts immediately, without reading any other files, and
-silently returns without error.
-.El
-.Sh FILES
-.Bl -tag -width /boot/forth/loader.4th -compact
-.It Pa /boot/loader
-The
-.Xr loader 5 .
-.It Pa /boot/forth/loader.4th
-.Nm
-itself.
-.It Pa /boot/loader.rc
-.Xr loader 5
-bootstrapping script.
-.It Pa /boot/defaults/loader.conf
-File loaded by the
-.Ic start
-command.
-.El
-.Sh EXAMPLES
-Standard
-.Pa /boot/loader.rc :
-.Pp
-.Bd -literal -offset indent -compact
-include /boot/forth/loader.4th
-start
-.Ed
-.Pp
-Read an additional configuration file and then proceed to boot:
-.Pp
-.Bd -literal -offset indent -compact
-unload
-read-conf /boot/special.conf
-boot-conf
-.Ed
-.Sh SEE ALSO
-.Xr loader.conf 4 ,
-.Xr loader 5