kconfig.5 (2010 09)

k
kconfig(5) kconfig(5)
Some configuration changes cannot be applied without a reboot. These changes will be held until the sys-
tem is rebooted even if the -h
option is not specified. In these cases, a warning message will be printed.
If multiple configuration changes are requested in a single invocation of one of the kernel configuration
commands, and any one of those changes requires a reboot, all of the requested changes will be held until
the system is rebooted. In particular, if a saved kernel configuration is loaded using
kconfig -l, and
that configuration cannot be used without a reboot, the state of the running system is not changed and
the specified kernel configuration is marked to be used at next boot.
If a change to a configuration is being held until next boot, and a subsequent change to the same
configuration setting is made with immediate effect, the immediate change will take precedence. The first
change will not take effect at next boot. A warning will be printed in these situations.
Changes that replace the entire currently running configuration, such as
kconfig -i (import), kcon-
fig -l (load), or kconfig -n (nextboot), cause any changes being held for next boot to be discarded.
Changes that are made to the currently running system are retained when the system is rebooted. They
remain in effect until changed, or until a saved kernel configuration is loaded.
Boot Behavior
When the system is booted, the administrator may specify the name of a saved kernel configuration on
the boot command line (see hpux (1M) and hpux.e(1M)). If so, that kernel configuration will be loaded
during boot.
If no kernel configuration is specified on the boot command line, the system will look for any kernel
configuration that had been marked for use at next boot (via a
kconfig -n,
kconfig -l,orkcon-
fig -i command). If any such configuration is found, that configuration will be loaded during boot.
If no kernel configuration is specified on the boot command line, and none is marked for use at next boot,
the system will boot using the same configuration that was in use before the reboot. If the configuration
had any changes that were being held for reboot, either because they could not be applied without a
reboot or because the
-h option was used, those changes will be applied during the boot process.
If the kernel configuration fails to boot properly, recovery can be attempted by booting the
backup
configuration and/or booting with the "failsafe boot" flag (
-tm on Itanium-based systems, -f0x40000
on PA-RISC systems). See hpux(1M) and hpux.e(1M) for details.
SYSTEM FILES
Users of past releases of HP-UX may be used to keeping kernel configuration choices in a text file called
/stand/system. Such a file is known as a "system file". A system file is automatically maintained for
the currently running kernel configuration. This file can be found at /stand/system
. System files are
also automatically maintained for each saved kernel configuration. These files can be found at
/stand/config/system, where config is the name of the saved configuration. Any time a kernel
configuration (saved or current) is changed using one of the kernel configuration commands, the
corresponding system file automatically gets rewritten to reflect the change. System files can also be gen-
erated on demand for any configuration using kconfig -e. The format of a system file is described in
system (4).
It is possible to make configuration changes by modifying a system file in a text editor and then running
kconfig -i. This command will read the system file and modify the appropriate kernel configuration
to match the contents of the system file. mk_kernel can also read a system file and modify a kernel
configuration. It is retained for compatibility with previous releases of HP-UX.
Note: Some configuration changes can be made without using one of the kernel configuration com-
mands (for example, by calling the
settune() or modload() system calls directly). In these
cases, the system files are not automatically updated. Be sure to update them manually, or re-
create them using kconfig -e before using them.
Note: Avoid putting comments in a system file. System files get re-created every time a kernel
configuration change is made, and comments are not preserved in this process.
System files can be useful for propagating kernel configurations to other systems. To do so, use
kconfig
-e to export a configuration to a system file on a source machine. Move the file to one or more target
machines and use kconfig -i to import the system file into a configuration on the target. The target
machines must have the same kernel filesets installed, or the import operation may fail. The -V flag can
be used to ensure that the target machine has exactly the same versions of kernel filesets installed.
2 Hewlett-Packard Company 2 HP-UX 11i Version 3: September 2010