LOADER.4TH(8)

NAME
loader.4th - loader.conf processing tools

DESCRIPTION
The file that goes by the name of loader.4th is a set of commands designed to manipulate loader.conf(5) files. The default /boot/loader.rc includes loader.4th and uses one of it's commands to automatically read and process the standard loader.conf(5) files. Other commands exists to help the user specify alternate configurations.

The commands of loader.4th by themselves are not enough for most uses. Please refer to the examples below for the most common situations, and to loader(8) for additional commands.

Before using any of the commands provided in loader.4th, it must be included through the command:

    include loader.4th

This line is present on the default /boot/loader.rc file, so it isn't needed (and should not be re-issued) in a normal setup.

The commands provided by it are:

boot-conf
    Boot as specified by the loader.conf(5) files read. It uses autoboot, so it can be stopped.

start
    Reads /boot/defaults/loader.conf, all other loader.conf(5) files specified in it, and then proceeds to boot as specified in them. This is command used on the default /boot/loader.rc file, and it uses the autoboot command (see loader(8) ), so it can be stopped for further interaction with loader(8).

initialize
    Initialize the supporting library so commands can be used without executing start first. Like start, reads /boot/defaults/loader.conf and all other loader.conf(5) files specified in it. Returns a flag on the stack to indicate if any configuration file was succesfully loaded.

read-conf filename
    Reads and processes a loader.conf(5) file. Does not proceeds to boot.

enable-module module
    Enables the loading of module.

disable-module module
    Disables the loading of module.

toggle-module module
    Toggles the loading of module on and off.

show-module module
    Shows the information gathered in the loader.conf(5) files about the module module.

retry
    Used inside loader.conf(5) files to specify the action after a module loading fails.

ignore
    Used inside loader.conf(5) files to specify the action after a module loading fails.

FILES
/boot/loader
    The loader(8).
/boot/loader.4th
    loader.4th itself.
/boot/loader.rc
    loader(8) bootstrapping script.
/boot/defaults/loader.conf
    File loaded by the start command.

EXAMPLES
Standard /boot/loader.rc:

    include /boot/loader.4th
    start

Loads a different kernel with the standard configuration:

    set kernel="kernel.old"
    unload
    boot-conf

Reads an additional configuration file and then proceeds to boot:

    unload
    read-conf /boot/special.conf
    boot-conf

Disable the loading of the splash screen module and bitmap and then proceeds to boot:

    unload
    disable-module splash_bmp
    disable-module bitmap
    boot-conf

SEE ALSO
loader.conf(5), loader(8)

HISTORY
loader.4th first appeared in FreeBSD 3.2.

AUTHORS
loader.4th was written by Daniel C. Sobral <dcs@freebsd.org>.

BUGS
A british espionage series.