mkboot(8)                           CLIX                           mkboot(8)



  NAME

    mkboot - Converts an object file to a bootable object file

  SYNOPSIS

    /etc/mkboot [-m master] [-d directory] [-k kernel.o] driver.o ...

  FLAGS

    -m master      Specifies the directory containing the master files to be
                   used for the object file.  The default master directory is
                   /etc/master.d.

    -d directory   Specifies the directory to be used for storing the new
                   bootable object file.  The default output directory is
                   /boot.

    -k kernel.o    Specifies the name of the object file for the CLIX
                   operating system.  The master filename used for this object
                   file is always named kernel.

    driver.out     Specifies the name of the object file for a module or
                   driver.

  DESCRIPTION

    The mkboot command is used to create a bootable object file in a format
    compatible with the self-configuration program.  It can only be used by
    the superuser.  The object file specified as an argument must have a
    corresponding master file in the /etc/master.d directory.  The master
    filename for the CLIX system kernel object file is always kernel.  The
    other master filenames derive from their associated object filenames in
    lowercase letters minus any optional path prefix or .o suffix.

    To create the new bootable object file, the applicable master file is read
    and the configuration information is extracted.  Then, the new bootable
    file is created containing this configuration information and written to
    the /boot directory.  It is given the same name, in uppercase letters and
    without the .o suffix, as the object file.  Note that if the current
    working directory is /boot when mkboot is executed, then the object file
    used is the previous bootable object file residing in this directory.
    This means that you do not have to keep separate .o files.

    The name of the object file for a module or driver is specified by the
    driver.o argument.

  EXAMPLES

    1.  The following will read the file named gentty from the directory
        newmaster for the gentty device configuration data, take the file



  2/94 - Intergraph Corporation                                              1

  mkboot(8)                           CLIX                           mkboot(8)



        gentty.o from the current directory, and create the formatted file
        /boot/GENTTY containing the configuration information for the gentty.

        mkboot -m newmaster gentty.o


    2.  The following will read the file named kernel from the directory
        /etc/master.d for the new kernel configuration data, take the file
        KERNEL from the current directory and create the formatted file
        /boot/KERNEL, which is used as the system_namelist (see mkunix(1) for
        more information).

        cd /boot; mkboot


  DIAGNOSTICS

    name.o:  not processed; cannot open /etc/master.d/name
           The name.o file was specified on the command line but there was no
           master file in the master.d directory for name.o.

    name.o: not processed
           An error has aborted processing for the named object file.

  EXIT VALUES

    Most messages are self-explanatory.

  RELATED INFORMATION

    Commands:  mkunix(1)

    Files:  master(4)





















  2                                              Intergraph Corporation - 2/94