kconfig(1M) kconfig(1M)
NAME
kconfig - manage kernel configurations
SYNOPSIS
fields] [config]...
comment] src dest
comment] config
comment] [config] filename
comment]
comment] behavior] [config] filename
comment] behavior] config
comment] behavior] config
comment] old new
comment] config
comment] config title
DESCRIPTION
is the administrative command for HP-UX kernel configurations. In the first form, will give summary information about the currently run-
ning kernel configuration. In the second form, will give information about saved kernel configurations. If configuration names are listed
on the command line, the output is restricted to those configurations. In the other forms, supports various administrative tasks on kernel
configurations. See kconfig(5) for more information about kernel configurations.
Only users with appropriate privileges can specify the or options.
Options
Includes detailed information about each kernel configuration in the
output listing (see below). In addition, the information about each configuration will be followed by the outputs of:
for the configuration, so as to include all configuration data. Note: if additional configuration data are available in
future releases of HP-UX, they will be included as well.
Specifies whether or not to update the automatic backup
configuration before the requested change. Also specifies the default backup behavior for future changes. See kconfig(5)
for a description of the various backup behaviors.
For compatibility with old releases, is accepted as an alias for and is accepted as an alias for These aliases will be
removed in a future release.
will make a copy of the saved kernel configuration named
src. The copy will be named dest. dest must not already exist.
The specified comment will be included in the kernel configuration log file entry made for this invocation of For more details on the ker-
nel configuration log file, see kclog(1M). Note that it will usually be necessary to quote the comment in order to avoid
interpretation by the shell.
will delete the saved kernel configuration named
config, and any files associated with it. Some files are shared between saved configurations; these files are not deleted
until all of the saved configurations using them have been deleted.
will display all changes to the current kernel configuration that are
being held for next boot. In other words, it will execute:
If any additional kernel configuration data become available in future HP-UX releases, changes to them will be included as
well. The return value of will be 1 if there are any such changes; see the section below. Not valid in combination with
any other flags.
will export the saved kernel configuration named
config to a system file named filename, replacing the file if it already exists. If no config is specified, the currently
running kernel configuration will be exported, including any changes to it that are being held for next boot. The exported
file can be later imported using on this system or any other system with compatible HP-UX software. See kconfig(5) and sys-
tem(4) for more information about system files.
Tells to proceed with the requested operation despite its potentially dangerous nature. When is asked to make a change that could
result in unintended data loss, it will ask for confirmation if being run interactively, or print an error message and stop
otherwise. The change can be made, and the interactive confirmation bypassed, by running the command with the option.
Tells to hold the requested changes until the next boot, even if they could be applied immediately.
Discards all changes being held pending for next boot. The currently
running configuration will be used at next boot.
will import a kernel configuration from the system file named
filename, which may have been created by an invocation of (on any system). If config is specified, the resulting kernel
configuration will be saved under that name. Otherwise, the resulting kernel configuration will be applied to the currently
running system, overwriting any changes that were being held for next boot. The new configuration changes will be held
until next boot if they cannot be applied immediately, or if the option is specified.
When duplicate entries for particular tunable or module are found in the system file, only the last entry found is used.
A kernel configuration cannot be imported successfully unless the running system has all of the necessary kernel software
installed. If the importing system is missing kernel software components that were in use on the exporting system, the
import will fail. See the option below.
Enables and disables saving of system files as
and
is a copy of system file from which the machine boots. When the feature is switched ON for the first time, is a copy of the
system file at that point. is the copy of the system file from which the machine was booted last time. These files are
created in will save the current system file as and will keep updating it on every reboot. It will also create a file which
contains nothing on first invocation.
will remove these files from the machine and will disable this feature.
will load the saved kernel configuration named
config, overwriting any changes that were being held for next boot. The state of the currently running system will be
changed to match the saved configuration. If the changes cannot be applied without a reboot, they will be marked to take
effect at next boot.
The saved kernel configuration named
config will be marked for use at next boot. Any changes to the currently running configuration that are being held for next
boot are discarded.
Tells to include only the specified fields in its output, and to print them in the machine-readable form described in kconfig(5).
See the below. Not valid in combination with
The saved kernel configuration named
old will be renamed new. The name new must not already be in use.
will save the running kernel configuration under the name
config.
will display all settings of the currently running configuration
that are not at their default value. In other words, it will execute:
If any additional kernel configuration data become available in future HP-UX releases, settings of them will be included as
well. Not valid in combination with any other flags.
will change the title of the saved kernel configuration named
config to the given title. title will usually need to be quoted to avoid interpretation by the shell.
Includes verbose information about each saved kernel configuration in
the output listing. The information includes the name and title of the configuration, the pathname of the associated ker-
nel, the creation date and time, etc.
Requests strict version checking. With this option, an import operation
will only succeed if the kernel components installed on the importing system are the exact same versions as those installed
on the exporting system.
Prints information about the original source of the currently running
configuration. Specifically, it describes the source of the most recent complete kernel configuration operation (load,
boot, or import). Also, if a saved configuration is marked for use at next boot, this option will identify it.
Note that this source information does not imply that the currently running configuration matches its original source. may
say that the currently running configuration was loaded from the saved configuration but that does not mean that the two are
identical. Either one may have been changed since the load occurred.
Developer's Note
The layout and content of output may change without notice, except when is specified. Scripts or applications that need to parse the out-
put of are expected to use the option. See kconfig(5) for details.
The fields supported in a request are:
The name of the saved kernel configuration.
The title for the saved kernel configuration. If the
configuration does not have a title, this field will be empty.
The date and time of the last save
of the configuration, in the format returned by
The date and time when the configuration was created, in the format returned by
The username of the user who created the configuration, if available.
The date and time of the last change to the saved configuration, in
the format returned by
The username of the user who made the last change to the saved configuration,
if available.
The pathname of the corresponding kernel directory.
The special field name may be specified to indicate that all defined fields should be included in the output. The output may include
fields not listed in this man page. The fields will be listed in unspecified order.
Additional fields may be added in future releases or in patches.
RETURN VALUE
returns one of the following values:
The requested operation was successful. If
was specified, this return value indicates that there are no configuration changes being held for next boot.
The requested operation could not be performed immediately as requested,
and is being held pending until the next boot. If was specified, this return value indicates that there are configuration changes
being held for next boot.
The requested operation failed. A diagnostic message is printed.
EXAMPLES
To save the current kernel configuration to "myconfig":
To delete the saved configuration "useless":
To export the current kernel configuration:
To import a kernel configuration:
To rename a configuration:
To load the "nighttime" configuration and apply it immediately:
To use the "approved" configuration at next boot:
To discard changes being held pending for next boot:
To add a description to a configuration:
To get a list of all saved configurations:
To get details of a saved configuration:
SEE ALSO
kclog(1M), kcmodule(1M), kcpath(1M), kctune(1M), mk_kernel(1M), system(4), kconfig(5).
available on
kconfig(1M)
