tunestat(1M)                                                   tunestat(1M)

NAME
     tunestat - check resource usage of tunable parameters

SYNOPSIS
     /usr/sbin/tunestat [-n namelist] [-p percent] [-q] [variable ...]

DESCRIPTION
     The tunestat command prints the resource usage of structures that are
     allocated based upon tunable parameters in mtune(4) and stune(4).
     tunestat is actually a shell script that uses crash(1M) and ikdb(8) to
     retrieve most of the information.

     The tunestat command will print out the variable that tracks the
     structure (the name is in the form of tunestructure-name), the
     current usage, the high water mark since the kernel was booted, the
     maximum allowed by mtune(4) or stune(4), the percentage of the high
     water mark versus the maximum, and the associated tunable parameter(s)
     that can be modified. If no variables are given, all the structures
     that the tunestat command knows about will be printed. If a variable
     is not a valid name, an error message will be printed and the command
     will continue with the rest of the variables.

     Command line arguments to tunestat are namelist, percent, and
     variable.

     The text file namelist contains the symbol table information needed
     for symbolic access to the system memory image to be examined. The
     default namelist is /stand/unix.

     percent is used to print out only those structures whose peak usage
     compared to the maximum is greater than or equal to percent.

     The -q option invokes the quiet mode; the table header and errors will
     not be printed.

EXAMPLES
     The command to print out the statistics for tuneproc, the number of
     number of processes in the system, is:

     tunestat tuneproc

     The output would be:

     Variable     Current   Peak   Maximum   Peak %   Tunable Parameters
     --------     -------   ----   -------   ------   ------------------
     tuneproc         36     40      4116        0   "NPROC"









Page 1                       Reliant UNIX 5.44                Printed 11/98

tunestat(1M)                                                   tunestat(1M)

DIAGNOSTICS
     invalid variable:

     The argument variable given to tunestat is not in the kernel. Using
     tunestat without any variable arguments will print all the variables
     known to the kernel.

     <percent> must be between 0 and 100

     When using the -p option, percent must be between 0 and 100.

     tunestat: cannot start crash

     For some reason, tunestat was unable to start crash(1M). A common
     problem is that either the default namelist or the argument given to
     the -n option is incorrect.

FILES
     /dev/mem
          system image of currently running system

SEE ALSO
     crash(1M), mtune(4), stune(4), ikdb(8).































Page 2                       Reliant UNIX 5.44                Printed 11/98