Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
HP-UX Reference > K

kconfig(1M)

HP-UX 11i Version 3: February 2007
» 

Technical documentation

» Feedback
Content starts here

 » Table of Contents

 » Index

NAME

kconfig — manage kernel configurations

SYNOPSIS

kconfig -DSw

kconfig [-av] [-P fields] [config]...

kconfig -b behavior

kconfig -c [-C comment] src dest

kconfig -d [-C comment] config

kconfig -e [-C comment] [config] filename

kconfig -H [-C comment]

kconfig -i [-C comment] [-b behavior] [-fhV] [config] filename

kconfig -l [-C comment] [-b behavior] [-f] config

kconfig -n [-C comment] [-b behavior] [-f] config

kconfig -r [-C comment] old new

kconfig -s [-C comment] [-f] config

kconfig -t [-C comment] config title

DESCRIPTION

kconfig is the administrative command for HP-UX kernel configurations. In the first form, kconfig will give summary information about the currently running kernel configuration. In the second form, kconfig 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, kconfig supports various administrative tasks on kernel configurations. See kconfig(5) for more information about kernel configurations.

Only users with appropriate privileges can specify the -b, -c, -d, -H, -i, -l, -n, -r, -s, or -t options.

Options

-a

Includes detailed information about each kernel configuration in the output listing (see -v below). In addition, the information about each configuration will be followed by the outputs of:

kcmodule -a -v

kctune -v

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.

-b behavior

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, -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.

-c src dest

kconfig will make a copy of the saved kernel configuration named src. The copy will be named dest. dest must not already exist.

-C comment

The specified comment will be included in the kernel configuration log file entry made for this invocation of kconfig. For more details on the kernel 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.

-d config

kconfig 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.

-D

kconfig will display all changes to the current kernel configuration that are being held for next boot. In other words, it will execute

kcmodule -D

kctune -D

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 kconfig will be 1 if there are any such changes; see the RETURN VALUE section below. Not valid in combination with any other flags.

-e [config] filename

kconfig 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 kconfig -i on this system or any other system with compatible HP-UX software. See kconfig(5) and system(4) for more information about system files.

-f

Tells kconfig to proceed with the requested operation despite its potentially dangerous nature. When kconfig 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 kconfig command with the -f option.

-h

Tells kconfig to hold the requested changes until the next boot, even if they could be applied immediately.

-H

Discards all changes being held pending for next boot. The currently running configuration will be used at next boot.

-i [config] filename

kconfig will import a kernel configuration from the system file named filename, which may have been created by an invocation of kconfig -e (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 -h 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 -V option below.

-l config

kconfig 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.

-n config

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.

-P fields

Tells kconfig to include only the specified fields in its output, and to print them in the machine-readable form described in kconfig(5). See the Developers Note below. Not valid in combination with -v.

-r old new

The saved kernel configuration named old will be renamed new. The name new must not already be in use.

-s config

kconfig will save the running kernel configuration under the name config.

-S

kconfig will display all settings of the currently running configuration that are not at their default value. In other words, it will execute

kcmodule -S

kctune -S

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.

-t config title

kconfig 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.

-v

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.

-V

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.

-w

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. kconfig -w may say that the currently running configuration was loaded from the saved configuration foo, 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 kconfig's output may change without notice, except when -P fields is specified. Scripts or applications that need to parse the output of kconfig are expected to use the -P fields option. See kconfig(5) for details.

The fields supported in a kconfig request are:

name

The name of the saved kernel configuration.

title

The title for the saved kernel configuration. If the configuration does not have a title, this field will be empty.

savetime

The date and time of the last save (kconfig -s) of the configuration, in the format returned by ctime().

createtime

The date and time when the configuration was created, in the format returned by ctime().

createuser

The username of the user who created the configuration, if available.

modifytime

The date and time of the last change to the saved configuration, in the format returned by ctime().

modifyuser

The username of the user who made the last change to the saved configuration, if available.

kernel

The pathname of the corresponding kernel directory.

The special field name ALL 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

kconfig returns one of the following values:

0

The requested operation was successful. If -D was specified, this return value indicates that there are no configuration changes being held for next boot.

1

The requested operation could not be performed immediately as requested, and is being held pending until the next boot. If -D was specified, this return value indicates that there are configuration changes being held for next boot.

2

The requested operation failed. A diagnostic message is printed.

EXAMPLES

To save the current kernel configuration to "myconfig": $ kconfig -s myconfig To delete the saved configuration "useless": $ kconfig -d useless To export the current kernel configuration: $ kconfig -e /tmp/myconfig.system To import a kernel configuration: $ kconfig -i /tmp/myconfig.system To rename a configuration: $ kconfig -r myconfig savedconfig To load the "nighttime" configuration and apply it immediately: $ kconfig -l nighttime To use the "approved" configuration at next boot: $ kconfig -n approved To discard changes being held pending for next boot: $ kconfig -H To add a description to a configuration: $ kconfig -t approved "Changes approved by management" To get a list of all saved configurations: $ kconfig To get details of a saved configuration: $ kconfig -v myconfig

SEE ALSO

kclog(1M), kcmodule(1M), kcpath(1M), kctune(1M), mk_kernel(1M), system(4), kconfig(5).

HP-UX System Administrator's Guide: Configuration Management, available on http://docs.hp.com.

Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© 1983-2007 Hewlett-Packard Development Company, L.P.