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

k
kmtune(1M) kmtune(1M)
NAME
kmtune - query, set, or reset system parameters
SYNOPSIS
/usr/sbin/kmtune
[-d][-l][[-q name]... ] [
-S system_file]
/usr/sbin/kmtune
[-u][[-s name{=|
+}value]... ] [[-r name]... ] [
-c comment][-S system_file]
/usr/sbin/kmtune
[[-e value] ...]
DESCRIPTION
kmtune is an obsolete command that is replaced by kctune(1M). Users are encouraged to migrate to
kctune(1M).
kmtune will be removed in a future release of HP-UX. The behavior of some of
kmtune’s
options have changed and they are noted in the appropriate sections below.
kmtune is used to query, set, or reset system parameters.
kmtune displays the planned values of all sys-
tem parameters when used without any options or with the
-l option. kmtune gathers information on
the running kernel using the
tuneinfo2() system call.
By default,
kmtune’s changes affect the currently running kernel configuration, marked to take effect at
next boot. If the -u option is specified, kmtune’s changes affect the current configuration, and take effect
immediately. See kconfig(5) for more information on kernel configurations.
Options
The following options are recognized by kmtune:
-c text Specify an optional comment string. All changes to the kernel parameters are logged with
the date, old value, new value, user id and this comment. This option is used with -r
and
-s. The comment text will generally need to be quoted so that it is interpreted as a single
parameter by the shell. The comment text may contain newlines. The log is written to the
file /var/adm/kc.log
. See kconfig(5) and kclog(1M) for more information about the
kernel configuration log file.
-d Print a brief difference report. Only parameters where the planned and current values are
different are listed. If the planned value is a formula, it is NOT considered different from
the current value. This option is useful to insure that only desired changes will be made on
a subsequent invocation of
kmtune -u. The -d option cannot be used with the -r
, -s,
or
-u options.
-e value Evaluate the expression given by "value". The expression is anything allowed in the
-s
option. The output will always be in decimal.
-l Print a detailed report. The -l option cannot be used with the
-r, -s or -u options.
-q name Query the value of the specified system parameter.
-r name Reset the value of the specified system parameter to the default.
-s name{=|+}value
Set the value of the specified system parameter. If the separator is an equal sign (
=), the
parameter is set to the value specified. If the separator is a plus sign (
+), the parameter is
incremented by the value specified. Negative values cannot be used with plus sign (
+). The
name{=|+}value format must not include spaces or tabs.
-S system_file
This option is obsolete. It is accepted for compatibility purposes but has no effect.
-u Update the current kernel configuration. This modifies the -s and -r options so that
their effects take effect immediately rather than at next boot. The whole command will fail
if any non dynamic parameters are being set. The -s and -r options are processed in the
order they are listed. At least one -s or -r option must be specified.
The expressions used with the -s and -e options are built of literal values, the upper case names of other
kernel parameters, and the following operators: ( and ), the unary operators ˜, !, -, and +, the binary
operators *, /, %, +, -, <<, >>, <, <=, >, >=, &, ˜, |, ==, !=, &&
, and ||, and the ternary operator ?:.
Using
-s to create a circular dependency in the values of the kernel parameters is not allowed.
446 Hewlett-Packard Company − 1 − HP-UX 11i Version 2: December 2007 Update