idbuild(1M)               UNIX System V(Base System)                idbuild(1M)


NAME
      idbuild - build new UNIX System kernel

SYNOPSIS
      /etc/conf/bin/idbuild

DESCRIPTION
      This script builds a new UNIX System kernel using the current system
      configuration in etc/conf/.  Kernel reconfigurations are usually done
      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
      configuration 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 system configuration files are built by processing the Master and
      System files representing device driver and tunable parameter
      specifications.  For the i386 UNIX System the files
      etc/conf/cf.d/mdevice, and etc/conf/cf.d/mtune represent the Master
      information.  The files etc/conf/cf.d/stune, and the files specified in
      etc/conf/sdevice.d/* represent the System information.  The kernel also
      has file system type information defined in the files specified by
      etc/conf/sfsys.d/* and etc/conf/mfsys.d/* .

      Once a new UNIX System kernel has been configured, a lock file is set in
      etc/.newunix which causes the new kernel to replace /unix on the next
      system shutdown (i.e., on the next entry to the init 0 state).  Upon the
      next system boot, the new kernel will be executed.

ERROR MESSAGES
      Since idbuild calls other system commands to accomplish system
      reconfiguration 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:




10/89                                                                    Page 1

idbuild(1M)               UNIX System V(Base System)                idbuild(1M)


            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
      idinstall(1m), idtune(1m).
      mdevice(4), mfsys(4), mtune(4), sdevice(4), sfsys(4), stune(4) in the
      Programmer's Reference Manual.











































Page 2                                                                    10/89