HP-UX Reference (11i v2 04/09) - 1M System Administration Commands A-M (vol 3)

k
kctune(1M) kctune(1M)
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 manpage. The fields will be listed in unspecified
order.
Additional fields may be added in future releases or patches.
Default Output
When kctune is called with no options, it shows all tunables associated with the kernel modules (as well
as the user-defined tunables), their current values, expressions used to compute those values, and when
changes can be made to these tunables. If there are changes that are being held for nextboot, they will be
shown as well.
On a typical system, the expression for most tunables are marked
Default meaning that the adminis-
trator is allowing the system to choose the tunable value. The changes column shows the restrictions on
when the tunable value can be changes. Tunables whose value can be changed immediately are marked
Immed. Tunables whose values are being automatically tuned by the system are marked
Auto. If the
administrator has disabled the automatic tuning by the system the tunable is marked
Imm (auto dis-
abled). The tunables which have nothing in the changes column can only be changed with a reboot.
The layout and content of the default output may change in future releases or patches of HP-UX. Scripts
or applications which need to parse the output of
kctune must use the -P option for parsable output.
RETURN VALUE
kctune returns one of the following values:
0 kctune was successful. If -D was specified, this return value indicates that there are no tunable
changes being held for next boot.
1 kctune was successful. However, there were changes requested to the currently running system
which cannot be applied until the system reboots. Therefore, all of the requested changes are being
held until next boot.
If
-D was specified, this return value indicates that there are tunable changes being held for next
boot.
2 kctune was not successful.
EXAMPLES
To see all tunables and their current values:
$ kctune
To see which tunables have new values being held until next boot:
$ kctune -D
To see verbose information about a tunable:
$ kctune -v tunablename
To set a tunable value on the running system:
$ kctune tunable=12
To set a tunable value to be used when the system reboots:
$ kctune -h tunable=12
To increase a tunable’s value by 100:
$ kctune tunable+=100
SEE ALSO
kclog(1M), kconfig(5), gettune(2), settune(2), settune_txn(2), tuneinfo2(2), Managing Kernel
Configurations White Paper available on docs.hp.com.
Section 1M−−356 Hewlett-Packard Company − 4 − HP-UX 11i Version 2: September 2004