kmtune(1M)

NAME

kmtune — query, set, or reset system parameters

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 planned values of all system parameters when used without any options or with the -S or -l option. kmtune reads traditional and modular kernel configuration files. [See config(1M), master(4) and system(4).]

Changes to system parameters not associated to dynamically loadable kernel modules do not take effect until the kernel has been rebuilt and the system has been rebooted. Changes to parameters associated to dynamically loadable kernel modules do not take effect until the module is re-configured and registered with the running kernel. [See config(1M) and kmupdate(1M).]

Options

The following options are recognized by kmtune:

-l: Print a detailed 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 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: Specify the HP-UX system description file name (traditional system file). 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        Current Dyn Planned          Module Version  
    ============================================================  
    name                                     - -   value                                    [ "module 0.1.0] 

Detailed report with -l option

    Parameter:      name
    Current:        - 
    Planned:        planned value for next kernel or module build
    Default:        default value
    Minimum:        minimum
    Module:         {"module" |-} 
    Version:        {0.1.0|-} 
    Dynamic:        No 

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 its master file, minimum will be displayed as '-' (dash).

In the brief report, the Module and Version fields are blank unless the parameter is associated to a modularly packaged module. [See config(1M).] In the detailed report, the Module and Version fields are '-' unless the parameter is associated to a modularly packaged module. Multiple module versioning is planned for future releases. Currently, all modularly packaged modules are assigned default version number 0.1.0.

The Current and Dynamic fields are reserved for future releases. In the brief report, a '-' is displayed for the Current and Dyn fields. In the detailed report, the values for Current and Dynamic are always '-' and 'No', respectively.

If the -s set option is specified with an equal (=) separator and the minimum value of the parameter is described in its 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 not numeric, an error is reported.

NOTES

System administrators must use kmsystem(1M) and kmtune(1M) instead of editing files manually. The format of kernel configuration files is subject to change, and kmtune is intended to provide compatibility in case of format change. System parameters can be associated to a specific kernel module even if the module is not capable of dynamic loading, as long as the kernel module is modularly packaged. [See config(1M), master(4) and system(4).]

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 format of the value is not valid.
2: Syntax error.
>2: Environmental error.

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

EXAMPLES

# kmtune -q shmseg 
  Parameter        Current Dyn Planned    Module Version 
  ======================================================== 
  shmseg                 -  -  120 
# kmtune -s shmseg=155 
# kmtune -l -q shmseg 
  Parameter:      shmseg 
  Current:        - 
  Planned:        155 
  Default:        120  
  Minimum:        - 
  Module:         - 
  Version:        - 
  Dynamic:        No   
# kmtune -r shmseg 
# kmtune -q shmseg 
  Parameter        Current Dyn Planned    Module Version 
  ======================================================== 
  shmseg                 -  -  120 

FILES

/usr/conf/master.d/*: Traditional and modular master configuration files
/stand/system: Default HP-UX system description file (traditional system file)
/stand/system.d/*: Modular system files

kmtune(1M)

Technical documentation

» Table of Contents

» Index