idtune(ADM)                     19 June 1992                     idtune(ADM)


 Name

    idtune - attempt to set value of a tunable parameter

 Syntax

    /etc/conf/bin/idtune [ -f | -m ] name value

 Description

    This script attempts to set the value of a tunable parameter.  The tun-
    able parameter to be changed is indicated by name.  The desired value for
    the tunable parameter is value.

    If there is already a value for this parameter (in the stune file), the
    user will normally be asked to confirm the change with the following mes-
    sage:

       Tunable Parameter name is currently set to oldvalue.
       Is it OK to change it to value? (y/n)

    If the user answers y, the change will be made.  Otherwise, the tunable
    parameter will not be changed, and the following message will be dis-
    played:

       name left at old_value.

    However, if the -f (force) option is used, the change will always be made
    and no messages will ever be given.

    If the -m (minimum) option is used and there is an existing value which
    is greater than the desired value, no change will be made and no message
    will be given.

    If system tunable parameters are being modified as part of a device
    driver or application add-on package, it may not be desirable to prompt
    the user with the above question.  The add-on package Install script may
    chose to override the existing value using the -f or -m options.  How-
    ever, care must be taken not to invalidate a tunable parameter modified
    earlier by the user or another add-on package or to set a value outside
    the minimum and maximum values allowed by the mtune file.

    In order for the change in parameter to become effective, the UNIX system
    kernel must be rebuilt and the system rebooted.

 Diagnostics

    The exit status will be non-zero if errors are encountered.

 See also

    idbuild(ADM), mtune(F), stune(F)