vxmemstat

NAME

vxmemstat - display memory statistics for VERITAS Volume Manager

SYNOPSIS

DESCRIPTION

The vxmemstat utility prints memory statistics information. This information can be system-wide, or it can be specific to a VERITAS Volume Replicator object.

OPTIONS

-e

Prints extended memory statistics.

-i interval

Prints memory statistics every interval seconds.

-t count

Prints the local system time every count intervals. The time interval is specified using the -i interval option.

OUTPUT FORMAT

The statistics are prefaced by a timestamp showing the current local time on the system. Statistics are printed as a one-line output record for each memory pool. The records are preceded by two header lines. The output line consists of blank-separated fields. All numeric fields are in units of kilobytes.

The following fields are displayed on each line:

Pool

Name of the memory pool. Memory consumers allocate memory from different pools for different purposes.

DG

Name of the disk group in which the RVG is present.

Min Size

Minimum amount of memory always reserved for use by consumers of the pool. As consumers require more memory, additional memory is allocated to the pool for distribution to them.

Max Size

Maximum amount of memory that can be allocated to the pool. This is equal to the value assigned to the maximum pool size system tunable that corresponds to the pool.

In Use

Amount of memory (out of that allocated) currently being used by consumers of the memory pool.

Allocated

Amount of memory currently allocated to the memory pool. The amount of memory allocated to a pool ranges between the minimum and the maximum pool size. The amount of allocated memory increases as more memory is needed and decreases as it is relinquished.

Max Used

Maximum amount of memory used by consumers from this pool since system startup.

This field is not shown if the -e option is specified.

Max Pool Used

Maximum amount of memory used by consumers from this pool at any time since the last reboot. The value shows the maximum usage even if usage by the pool has varied over this time period.

This field is shown if the -e option is specified.

Waiting

Indicates if any I/O is waiting to allocate memory from this pool. This usually indicates that the corresponding tunable for the maximum size of this pool needs to be increased.

This field is not shown if the -e option is specified.

Waiters

The number of requests that are waiting to allocate memory from this pool.

This field is shown if the -e option is specified.

EXIT CODES

The vxmemstat utility exits with a non-zero status if the attempted operation fails. A non-zero exit code is not a complete indicator of the problems encountered, but rather denotes the first condition that prevented further execution of the utility.

See vxintro(1M) for a list of standard exit codes.

EXAMPLES

To display statistics every 5 seconds and time stamp the output every alternate interval, use the command:

SEE ALSO

vxintro (1M), vxstat (1M)