kconfig(1M)kconfig(1M)NAMEkconfig - 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 running
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 configura‐
tions. See kconfig(5) for more information about kernel configura‐
tions.
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 informa‐
tion about each configuration will be followed by the
outputs of:
for the configuration, so as to include all configura‐
tion 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 speci‐
fies 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 kernel configuration log file, see kclog(1M).
Note that it will usually be necessary to quote the com‐
ment 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 exe‐
cute:
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 system(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 result‐
ing 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 ker‐
nel 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 noth‐
ing on first invocation.
will remove these files from the machine and will dis‐
able 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 kernel, the creation date and time, etc.
Requests strict version checking. With this option, an import opera‐
tion
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 iden‐
tify it.
Note that this source information does not imply that
the currently running configuration matches its original
source. may say that the currently running configura‐
tion 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 output 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 con‐
figuration 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 ALSOkclog(1M), kcmodule(1M), kcpath(1M), kctune(1M), mk_kernel(1M), sys‐
tem(4), kconfig(5).
available on
kconfig(1M)