kmtune(1M)

NAME

kmtune — query, set, or reset system parameter

SYNOPSIS

/usr/sbin/kmtune [-l] [[-q name]...] [-S system_file]

/usr/sbin/kmtune [[-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.

Options

The following options are recognized by kmtune:

-l: Print a detail report. The -l option cannot be used with the -r or -s 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.

If the -q query option is specified, kmtune displays the following format:

Brief report without -l option

           Parameter          Value  
           =========================== 
           name                                   value 

Detailed report with -l option

           Parameter:      name
           Value:          value
           Default:        default
           Minimum:        minimum
           Module:         module

If the -l option is specified without the -q query option, a detailed report on all the parameters is displayed. The information between the parameters is separated by blank lines.

If the parameter has no minimum value specified in master file, minimum will be displayed as '-'. If the parameter is not supplied by kernel modules, module will be displayed as '-'.

If the -s set option is specified with an equal (=) separator and the minimum value of the parameter is described in a master file, the value range is checked. If the minimum value or the specified value is a formula, the check is not made.

If the -s set option with a plus (+) separator is specified and the original value is non numeric, an error is reported.

NOTES

System administrators are encouraged to use kmsystem and kmtune instead of editing description files manually. File format of description files are subject to change, and kmtune is intended to provide compatibility in case of format change.

RETURN VALUE

Upon completion, kmtune returns with one of the following exit values:

0: Successful.
1: Requested parameter is not found, the value is out of range, or the type of value is formula.
2: Syntax error.
>2: Environmental error.

Results of query requests are sent to stdout. Error and warning messages are sent to stderr.

EXAMPLES

# kmtune -q shmseg 
  Parameter            Value 
  ================================ 
  shmseg               120 
# kmtune -s shmseg=128 
# kmtune -l -q shmseg 
  Parameter:      shmseg 
  Value:          128 
  Default:        120  
  Minimum:        - 
  Module:         - 
# kmtune -r shmseg 
# kmtune -q shmseg 
 Parameter        Value 
 ================================ 
 shmseg           120 

FILES

/usr/conf/master.d/*: Master configuration tables for kernel and kernel modules
/stand/system: Default HP-UX system description file
/stand/system.d/*: Kernel module system description files

kmtune(1M)

Technical documentation

» Table of Contents

» Index