idbuild(1M) INTERACTIVE UNIX 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 reconfi-
gurations 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 com-
mands:
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 tun-
able 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 prepro-
cessor 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
Rev. 1.3 Page 1
idbuild(1M) INTERACTIVE UNIX System idbuild(1M)
build command. This overrides the current value of
$ROOT.
-k suffix
Build the kernel in a manner consistent with the kcon-
fig 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 sys-
tem reconfiguration and link editing, it will report all
errors encountered by those commands, then clean up inter-
mediate 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) in the INTERACTIVE SDS Guide and Programmer's
Reference Manual.
ADDED VALUE
This entry, supplied by INTERACTIVE Systems Corporation,
contains enhancements to UNIX System V.
Rev. 1.3 Page 2