LBOOT(1M)                                               LBOOT(1M)



     NAME
          lboot - configure bootable kernel

     SYNOPSIS
          /etc/lboot [-v] [-m master ] [-s system ] [-b directory ]
          [-u unix]

     DESCRIPTION
          The lboot command is used to configure a bootable UNIX
          kernel.  Master files in the directory master contain
          configuration 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.

          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
          bootable kernel.

          To create the new bootable object file, the applicable
          master 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.

          The options are:

          -m master      This option specifies the directory
                         containing 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



     Page 1                                        (last mod. 8/20/87)

     LBOOT(1M)                                               LBOOT(1M)



                         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 information
                         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.

     SEE ALSO
          master(4) in the Programmer's Reference Manual.

     ORIGIN
          AT&T V.3
















     Page 2                                        (last mod. 8/20/87)