kconfig.5 (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

kconﬁg(5) kconﬁg(5)

NAME

kconﬁg - introduction to kernel conﬁguration commands

DESCRIPTION

HP-UX contains a set of commands used to view and modify the conﬁguration of the HP-UX kernel. The

commands are:

kconfig Operations on complete kernel conﬁgurations

kcmodule Operations on kernel modules

kctune Operations on kernel tunable parameters ("tunables")

kcpath Retrieves pathnames of kernel ﬁles

kclog Searches and displays the kernel conﬁguration log ﬁle

mk_kernel Builds a kernel conﬁguration from a system ﬁle

KERNEL CONFIGURATIONS

The set of data that controls the behavior and content of the HP-UX kernel is called a kernel

conﬁguration. System administrators may save any number of kernel conﬁgurations, and may load any

one of them at any time. A kernel conﬁguration consists of module usage choices made using

kcmodule

and tunable values chosen using kctune.

By default, these commands affect the state of the currently running system. When these commands are

given a

-c conﬁg option, they instead affect the saved kernel conﬁguration named conﬁg.

The currently running kernel conﬁguration can be saved using

kconfig -s. A saved conﬁguration can

be loaded using kconfig -l. This causes the state of the running system to be changed to match the

saved conﬁguration. A saved conﬁguration can be marked for use when the system is next booted, by

using kconfig -n. This makes no change to the state of the running system, but causes the speciﬁed

saved conﬁguration to be loaded when the system is rebooted. (See Boot Behavior below.)

Saved kernel conﬁguration names must start with a letter; contain only letters, digits, and underscores

(_); and be at most 32 characters in length. The names are case-distinct.

Backup Conﬁguration

The system maintains a saved conﬁguration called

backup, which can be used to recover from

conﬁguration errors. Depending on the selected backup behavior, the system can automatically save the

currently running conﬁguration to backup immediately before making any requested change to the

conﬁguration. The backup behavior is set using the -b behavior option to the kconfig

, kcmodule,or

kctune commands. The recognized backup behavior s are:

yes Always update the backup conﬁguration before making a change.

once Update the backup conﬁguration before making the current change. For

subsequent changes, ask whether to update it.

no Do not update the backup conﬁguration before making the current change.

For subsequent changes, ask whether to update it.

disable Never update backup conﬁguration before changes.

These behaviors can be abbreviated to one letter. For compatibility with previous releases,

-B is

accepted as an alias for -b yes, and -K is accepted as an alias for -b no. These aliases will be

removed in a future release.

After each boot, the default backup behavior is to ask whether to update the

backup conﬁguration

before each change. Changes made noninteractively assume a "no" response.

Dynamic and Static Changes

By default, the kernel conﬁguration tools will apply conﬁguration changes to the currently running sys-

tem, causing an immediate change in their behavior. System administrators can override this default by

specifying the

-h option to changes made using the kconfig, kcmodule,orkctune commands. This

option causes the change(s) to be held until the system is rebooted. HP recommends that this option be

used only when the next reboot is expected to happen soon. If the reboot doesn’t happen for months after

the change, the change could come as an unwelcome surprise to an administrator who had forgotten the

request.

HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (4 pages)

PAGE 1
kconfig(5) kconfig(5) NAME kconfig - introduction to kernel configuration commands DESCRIPTION HP-UX contains a set of commands used to view and modify the configuration of the HP-UX kernel.
PAGE 2
kconfig(5) kconfig(5) Some configuration changes cannot be applied without a reboot. These changes will be held until the system 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.
PAGE 3
kconfig(5) kconfig(5) If there are changes to the currently running kernel configuration that are being held for reboot, those changes are reflected in the system file /stand/system. LOG FILE The kernel configuration commands maintain a log file that describes all kernel configuration changes. This log file is located at /var/adm/kc.log. The kclog command can be used to search and view the log file, or to make entries that don’t correspond to configuration changes.
PAGE 4
kconfig(5) kconfig(5) This shows that module1 has no dependencies, but module2 is dependent on two other modules. New fields may be added at any time, but they will not be included in the output unless specified in a -P option. Fields will not be removed. In rare cases, future developments may render a field meaningless. In these cases, the field name will still be accepted but the corresponding lines will be omitted from the output. SEE ALSO hpux(1M), hpux.