Content-type: text/html
doconfig - Builds the kernel described by system configuration files
/usr/sbin/doconfig [-s | -b] [-a | -m] [-c config_file] [-d -n] [-e ed_script]
The /usr/sbin/doconfig program supports the following flags: Specifies a noninteractive kernel build phase that enables all (mandatory and optional) kernel options automatically. The -a flag creates a new system configuration file in /sys/conf/SYSTEM_NAME unless you also specify the -c flag, in which case the configuration file uses the existing /sys/conf/SYSTEM_NAME. If you specify the -c flag with a specific configuration file name along with the -a flag, the kernel is built with the kernel options already included in the configuration file; you will not be prompted to edit the configuration file.
The /usr/sbin/doconfig program builds a new kernel, optionally allowing you to edit the configuration file before the new kernel is built. You might need to build a new kernel when you: Add or remove hardware from your system Add or remove kernel subsystems from the kernel Tune the performance of your operating system
Depending on how you modify the system, you might be able to make the modification without rebuilding the kernel. In this case, you use dynamic configuration commands, such as the sysconfig command, to modify the system. For information that helps you decide whether to use dynamic configuration commands or rebuild the kernel by using the /usr/sbin/doconfig program, refer to the System Administration guide. For more information about the sysconfig command, refer to the sysconfig(8) reference page.
If you need to rebuild the kernel by using the /usr/sbin/doconfig program, you usually use a text editor to modify the system configuration file (/usr/sys/conf/config_file), the /usr/sys/conf/param.c file or the layered products configuration file (/usr/sys/conf/config_file.list). For information about the contents of these files, refer to the System Administration guide and the System Configuration and Tuning guide.
After you modify the necessary files, run the /usr/sbin/doconfig program and use the -c flag.
For example, suppose you need to build a new kernel for a system named MYSYS. You edit the target configuration file, the param.c file, or the layered products configuration file and make some changes.
You then follow these steps to rebuild your kernel: Log in as root or become the superuser and set your default directory to the /usr/sys/conf directory. Save a copy of the running kernel. If possible, save the file in the root (/) directory, as follows:
Be aware that you cannot boot your system from a kernel in any directory other than the root directory. If you do not have a bootable kernel such as genvmunix in the root directory, and the new vmunix kernel is not bootable, you will have to boot the system from the distribution media to get your system to the UNIX shell. Then follow the procedures in the Installation Guide to mount the appropriate file systems and copy the saved vmunix to the root directory.
If the new vmunix kernel fails to boot, you can recover by booting the vmunix.save file that you created at the beginning of this procedure:
If you copied and saved the vmunix kernel to a directory other than the root directory, and your system does not have a bootable kernel such as genvmunix in the root directory, you will have to boot the system from the distribution media to get your system to the UNIX shell. Then follow the procedures in the Installation Guide to mount the appropriate file systems and copy the saved vmunix to the root directory.
Check all local file systems using the fsck command with the -p option as follows:
After your system boots, you can re-edit the configuration file and try to build the new kernel again by using the /usr/sbin/doconfig command.
For other examples of using the /usr/sbin/doconfig command to build a new kernel, refer to the System Administration guide.
/sys/conf/config_file
Specifies the system configuration file, where config_file is usually the name of the system converted to uppercase letters. For example, on a system named mysys, the configuration file is named MYSYS.
/sys/conf/config_file.list
Specifies the optional configuration file that is used by kernel layered products to extend the system configuration file. You can modify this file to remove kernel layered product entries by deleting or putting a comment character (#) in front of specific entries.
/sys/conf/.product.list
Specifies the optional configuration file that is used by kernel layered products to register their configuration file requirements. This file is used as the basis for the config_file.list file and should not be modified.
/sys/system_name/sysconfigtab
Specifies the name of the newly-built text file describing the kernel.
/sys/system_name/system_name.mod
/sys/system_name/EXTRAS.mod
Specifies the name of modules for a bootstrap linked kernel.
/sys/system_name/vmunix
Specifies the name of the newly-built static kernel.
/sys/system_name/.vmunix
Specifies the name of the network-bootable kernel for DMS clients.
Commands: config(8), pmerge(8), dmu(8)
Installation Guide
System Administration
Sharing Software on a Local Area Network
delim off