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 after 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 nonzero 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 INTERACTIVE UNIX Operating System, 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/*.  The file /etc/conf/cf.d/defines and the files specified in /etc/conf/define.d represent the preprocessor define symbols needed to compile and link the kernel. 

Once a new UNIX System kernel has been configured, a lock file is set in etc/.new_unix 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. 

The command line options are:

−r root_dir
Set environment variable $ROOT to root_dir for the build command.  This overrides the current value of $ROOT. 

−k suffix
Build the kernel in a manner consistent with the kconfig command.  The following differences will be noted:

The output of idconfig will be left in the $ROOT/etc/conf/tmp directory. 

The lock file /etc/.new_unix is not set. 

The new kernel is named unix.suffix. 

The resulting kernel and configuration files are saved in $ROOT/etc/conf/kconfig.d/unix.suffix.d. 

This option is intended for use by the kconfig command. 

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:

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

idconfig(1M), idinstall(1M), idmkunix(1M), idtune(1M), mdevice(4), mfsys(4), mtune(4), sdevice(4), sfsys(4), stune(4). 

ADDED VALUE

This entry, supplied by SunSoft, Inc., contains enhancements to UNIX System V. 

\*U  —  Version 1.0