idbuild(ADM)                    19 June 1992                    idbuild(ADM)


 Name

    idbuild, idmkenv, idmkunix, idconfig, idvidi, idscsi - build new UNIX
    system kernel

 Syntax

    /etc/conf/bin/idbuild

 Description

    The idbuild script builds a new UNIX system kernel using the current sys-
    tem configuration in /etc/conf.  The idconfig script builds the system
    kernel configuration files.  Kernel reconfigurations are usually per-
    formed after a device driver is installed, or system tunable parameters
    are modified.  The script uses the shell variable $ROOT from the user's
    environment as its starting path.  Except for the special case of kernel
    development in a non-root source tree, the shell variable $ROOT should
    always be set to null or to ``/''.  idbuild exits with a return code of
    zero on success and non-zero on failure.

    Building a new UNIX system image consists of generating new system con-
    figuration files, then link-editing the kernel and device driver object
    modules in the /etc/conf/pack.d object tree.  This is done by idbuild by
    calling the following commands:

    /etc/conf/bin/idconfig   To build kernel configuration files.

    /etc/conf/bin/idmkunix   To process the configuration files and link-edit
                             a new UNIX system image.

    The -p option to idbuild specifies that temporary files created during
    the build should not be deleted. This results in object modules and C
    source modules remaining on the system. These modules can be used as an
    aid to debugging. Temporary files created during earlier builds will,
    however, be removed.

    The system configuration files are built by processing the Master and
    System files representing device driver and tunable parameter specifica-
    tions.  The files /etc/conf/cf.d/mdevice, and /etc/conf/cf.d/mtune
    represent the Master information.  The file /etc/conf/cf.d/stune, and the
    files specified in /etc/conf/sdevice.d/* represent the System informa-
    tion.  The kernel also has file system type information defined in the
    files specified by /etc/conf/sfsys.d/* and /etc/conf/mfsys.d/*.

    idvidi and idscsi read the video driver and SCSI driver configurations,
    respectively.

    idconfig reads the system configuration files and reports any conflicts
    and errors.

    idmkunix links the necessary modules to create the new kernel.

    Once a new UNIX system kernel has been configured and linked, idmkenv is
    invoked to back up the current /unix and replace it with the new kernel,
    and rebuild the kernel environment.

 Diagnostics

    Since idbuild calls other system commands to accomplish system reconfigu-
    ration and link editing, it will report all errors encountered by those
    commands, then clean up intermediate files created in the process.  In
    general, the exit value 1 indicates an error was encountered by idbuild.

    The errors encountered fall into the following categories:

       Master file error messages.
       System file error messages.
       Tunable file error messages.
       Compiler and Link-editor error messages.

    All error messages are designed to be self-explanatory.

 See also

    configure(ADM), idinstall(ADM), idtune(ADM), mdevice(F), mfsys(FP),
    mtune(F), sdevice(F), sfsys(FP), stune(F)