srmstat(1SRM)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | ATTRIBUTES | SEE ALSO | NOTES

NAME

srmstat - report system usage rate statistics

SYNOPSIS

srmstat [ -a | u ] [ -r ] [ -k sec ] [ -c | -C n ] [ -s sec]

DESCRIPTION

srmstat outputs statistics of actual CPU usage rates by active topmost scheduling groups, which should show the share of the system being allocated to each group of users. In particular, it is possible to compare the actual working rate with the intended and effective share.

The srmstat table headings include Long-Term Target Usage (LTU) and Short-Term Target Usage (STU). For a number of reasons, there are often gaps between a user's current usage and target usage. (Target usage is the usage Solaris Resource Manager determines that a user is entitled to based on the user's shares and the number of active users.) The STU is the amount Solaris Resource Manager would allocate in the immediate future in order to lessen the gap between a user's current usage and LTU.

Since the statistics indicate actual CPU usage by default, if the srmidle user has been defined, any unused CPU capacity is shown as having been used by that user; otherwise it appears in the System line.

If srmstat is invoked without arguments, it will output the table once, then exit.

OPTIONS

The command-line options are:

-a

The table will show all users and groups instead of just scheduling groups.

-c

Continuous mode. Until the process is killed, up-to-date tables are output, each terminated by a form-feed character \f and separated by a sleep interval.

-C n

Continuous mode. Until the repeat count, n, is reached or the process is killed, up-to-date tables are output, each terminated by a form-feed character \f and separated by a sleep interval. The integer n causes srmstat to exit after n tables have been output.

-k sec

Set the half-life for decaying the displayed rate to sec seconds (the default is 4).

-r

The statistics indicate rate of accrual of usage costs (scheduling rates) rather than actual CPU usage. Scheduling rate differs from CPU usage because the cost of CPU capacity given to processes running at different nice levels is weighted according to the nice; and because the cost function may include factors other than CPU usage. Any unused CPU capacity is costed at the current per-tick charge and included in the System line; if the srmidle user has been defined, this user is included in the display to show any processing attached to that lnode.

-s sec

In continuous mode, sleep for sec seconds between tables (the default is 4).

-u

The table will show only users instead of scheduling groups.

The `No.' column of the table shows the number of actual users contained in a group.

EXAMPLES

To have a dynamically updating report of CPU usage by groups, run:

---

srmstat -c

---

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Architecture	SPARC
Availability	SUNWsrmb

SEE ALSO

srm(5SRM)

Solaris Resource Manager 1.3 System Administration Guide

NOTES

This man page is applicable to SunOS 5.6, SunOS 5.7, and SunOS 5.8.

SunOS 5.8  Last Revised 13 April 1999

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | ATTRIBUTES | SEE ALSO | NOTES