LBOOT(1M-SysV) RISC/os Reference Manual LBOOT(1M-SysV)
NAME
lboot, mboot - configure bootable kernel
SYNOPSIS
/etc/lboot [-v] [-m master ] [-s system ] [-b directory ]
[-u unix]
/etc/mboot [-v] [-m master ] [-s system[.suffix] ] [-b
directory ] [-u unix]
DESCRIPTION
The lboot command is used to configure a bootable UNIX ker-
nel. Master files in the directory master contain confi-
guration information used by lboot when creating a kernel.
The file system is used by lboot to determine which modules
are to be configured into the kernel.
The mboot command is used to help configure a bootable UNIX
kernel. Master files in the directory master contain confi-
guration information which is used to create
master[.suffix].c. mboot also creates a file called
objlist[.suffix] which contains a list of the objects needed
to be linked into the kernel. When the file
master[.suffix].c is compiled, it can then be linked with
kernel.o and all the objects listed in objlist[.suffix] the
achieve a fully resolved and bootable UNIX kernel.
If a module in master is specified in the system file via
"INCLUDE:", that module will be included in the bootable
kernel. For all included modules, lboot searches the boot
directory for an object file with the same name as the file
in master, but with a ".o" or ".a" appended. If found, this
object is included when building the bootable kernel.
For every module in the system file specified via "VECTOR:",
lboot takes actions to determine if a hardware device
corresponding to the specified module exists. Generally,
the action is a memory read at a specified base, of the
specfied size. If the read succeeds, the device is assumed
to exist, and its module will also be included in the boot-
able kernel.
To create the new bootable object file, the applicable mas-
ter files are read and the configuration information is
extracted and compiled. The output of this compilation is
then linked with all included object files.
Master files that are specified in the system file via
"EXCLUDE:" are also examined; stubs are created for routines
specified in the excluded master files that are not found in
the included objects.
Printed 1/15/91 Page 1
LBOOT(1M-SysV) RISC/os Reference Manual LBOOT(1M-SysV)
The options are:
-m master This option specifies the directory con-
taining the master files to be used for
the bootable kernel. The default master
directory is $ROOT/usr/sysgen/master.d.
-s system This option specifies the name of the
system file. The default system file is
$ROOT/usr/sysgen/system.
-b directory This option specifies the directory
where object files are to be found. The
default output directory is
$ROOT/usr/sysgen/boot.
-v This option makes lboot slightly more
verbose.
-u unix This option specifies the name of the
target kernel. By default, it is
unix.new, unless the -t option is used,
in which case the default is
unix.install.
-d This option displays debugging informa-
tion about the devices and modules put
in the kernel.
-t This option tests if the existing kernel
is up-to-date. If the kernel is not
up-to-date, it prompts you to proceed.
It compares the modification dates of
the system file, the object files in the
boot directory, and the configuration
files in the master directory with that
of the output kernel. It also
``probes'' for the devices specified
with "VECTOR:" lines in the system file.
If the devices have been added or
removed, or if the kernel is out-of-
date, it builds a new kernel, adding
``.install'' to the target name.
EXAMPLE
lboot -s newsystem
This will read the file named newsystem to determine which
objects should be configured into the bootable object.
Page 2 Printed 1/15/91
LBOOT(1M-SysV) RISC/os Reference Manual LBOOT(1M-SysV)
SEE ALSO
master(4), system(4)
Printed 1/15/91 Page 3