IDBUILD(ADM)                         UNIX System V



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


     Syntax
          /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.      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 information.  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, idmkdenv 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  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:

               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(F), mtune(F), sdevice(F), sfsys(F), stune(F)


     (printed 2/15/90)                               IDBUILD(ADM)