DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH
 

idbuild(ADM)


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

Syntax

/etc/conf/bin/idbuild [ -p ]

Description

The idbuild script builds a new UNIX system kernel using the current system configuration in /etc/conf. The idconfig script builds the system kernel configuration files. Kernel reconfigurations are usually performed 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/idmkreg
To build the device information database (/etc/conf/cf.d/sysRegistry).

/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 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 filesystem 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 (using the files /etc/conf/node.d/*).

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 that idbuild encountered an error.

The errors encountered fall into the following categories:

All error messages are designed to be self-explanatory.

See also

configure(ADM), idinstall(ADM), idtune(ADM), mdevice(F), mfsys(FP), mtune(F), sassign(F), sdevice(F), sfsys(FP), stune(F)
© 2003 Caldera International, Inc. All rights reserved.
SCO OpenServer Release 5.0.7 -- 11 February 2003