HP-UX Reference (11i v1 05/09) - 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
[-l][-d][[-q name]...] [
-S system_file]
/usr/sbin/kmtune
[-u][[-s name{=|
+}value]...] [[-r name]...] [-S system_file]
DESCRIPTION
kmtune is used to query, set, or reset system parameters.
kmtune displays the value of all system
parameters when used without any options or with the
-S or -l option. kmtune reads the master files
and the system description files of the kernel and kernel modules. Information on the running kernel is
gathered with the
tuneinfo() system call.
Changes to kernel parameters generally do not take effect until the kernel has been rebuilt and the system
has been rebooted. Some kernel parameters can be changed in the running kernel.
kmtune with the -u
option will alter these parameters and avoid the need to rebuild and reboot.
Options
The following options are recognized by kmtune:
-l Print a detailed report. The -l option cannot be used with the
-r, -s,or-u options.
-d Print a brief difference report. Only parameters where the planned and current values are
different are listed. If the planned value is an 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.
-q name Query the value of the specified system parameter.
-r name Reset the value of a system parameter to the default.
-s name{=|+}value
Set the value to a 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
Specify the HP-UX system description file name. If not specified, /stand/system
is
used as the default.
-u Update the currently running kernel. This modifies the -s and -r options, to update the
running kernel as well as the system files. The values specified must be numeric. 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. When incrementing a value with the -s
option the kernel and the system files are set to the value in the system file plus the incre-
ment value.
When used alone, or with
-S, it updates all the dynamic parameters to match the numeric
values stored in the system files. A warning is reported if any static parameters have
differences. The order the parameters are listed in the system files is not important. The
-d option can be used to look at the differences to get a preview of what a lone -u will do.
Use of -u requires super user privileges.
If the -q query option is specified, kmtune displays the following format:
Brief report without -l option
Parameter Current Dyn Planned Module Version
============================================================
name value Y/- value module version
Detailed report with -l option
Parameter: name
Current: current value from running kernel
Planned: planned value from system file
HP-UX 11i Version 1: September 2005 − 1 − Hewlett-Packard Company Section 1M−−407