vxmemstat(1M)vxmemstat(1M)NAME
vxmemstat - display memory statistics for Veritas Volume Manager
SYNOPSIS
vxmemstat [-e] [-i interval [-t count]]
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:
vxmemstat -i 5 -t 2
SEE ALSO vxintro(1M), vxstat(1M)VxVM 5.0.31.1 24 Mar 2008 vxmemstat(1M)
Check Out this Related Man Page
poolstat(1M)poolstat(1M)NAME
poolstat - report active pool statistics
SYNOPSIS
poolstat [-p pool-list] [-r rset-list] [interval [count]]
poolstat [-p pool-list] [-o format -r rset-list] [interval [count]]
The poolstat utility iteratively examines all active pools on the system. It reports statistics based on the selected output mode. poolstat
provides options to examine only specified pools and report resource set-specific statistics.
Without options, poolstat examines all pools, reports basic statistics for their resource sets, and exits.
DISPLAY FORMATS
In default output format, poolstat outputs a header line and a line for each pool. The line begins with the pool ID and its name, followed
by a column of statistical data for the processor set attached to the pool.
The columns are defined as follows:
id Pool ID.
pool Pool name.
rid Resource set id.
rset Resource set name.
type Resource set type.
min Minimum resource set size.
max Maximum resource set size.
size Current resource set size.
used The measure of how much of the resource set is currently is use. This is calculated as the percentage utilization of the
resource set multiplied by its size. If resource set has been reconfigured during last sampling interval, this value might
be not reported (-).
load The absolute representation of the load that is put on the resource set. For the definition of this property see
libpool(3LIB).
The following options are supported:
-o format Report statistics according to the format specification given in format. See DISPLAY FORMATS.
The -o option accepts lists as arguments. Items in a list can be either separated by commas or enclosed in quotes and sepa-
rated by commas or spaces.
You can specify multiple -o options. The format specification is interpreted as the whitespace separated concatenation of
all the format option arguments.
The -o option must be used in conjunction with the -r option.
-p pool-list Report only pools whose names are in the given list. If the -r option is also used, this option selects only resource sets
which belong to pools in the given list. Statistics for pools or resource sets are reported in the same order in which pool
names are listed on the pool-list. Pool can be specified by name or by ID.
The -p option accepts lists as arguments. Items in a pool-list can only be separated by spaces.
-r rset-list Report resource set statistics. If the rset-list argument is "all", then all possible resource set types are selected.
The -r option accepts lists as arguments. Items in a list can be either separated by commas or enclosed in quotes and sepa-
rated by commas or spaces.
The following resource set types are supported:
all All resource set types
pset Processor set
The following operands are supported:
count The number of times that the statistics are repeated. By default, poolstat reports statistics only once.
If neither interval nor count are specified, statistics are reported once. If interval is specified and count is
not, statistics are reported indefinitely.
interval The sampling interval in seconds.
If neither interval nor count are specified, statistics are reported once. If interval is specified and count is
not, statistics are reported indefinitely.
Example 1: Using poolstat
The following example shows the default output from the poolstat utility:
% poolstat
pset
id pool size used load
0 pool_default 4 3.6 6.2
1 pool_admin 4 3.3 8.4
Example 2: Reporting Resource Set Statistics
The following example reports resource set statistics.
% poolstat -r pset
id pool type rid rset min max size used load
0 pool_default pset -1 pset_default 1 65K 2 1.2 8.3
1 pool_admin pset 1 pset_admin 1 1 1 0.4 5.2
2 pool_other pset -1 pset_default 1 65K 2 1.2 8.3
Resource sets attached to multiple pools, as pset_default in the example above, are listed multiple times, once for each pool.
Example 3: Restricting the Output to the List of Pools
The following example restricts the output to the list of pools
% poolstat -p pool_default
pset
id pool size used load
0 pool_default 8 5.3 10.3
% poolstat -p 'pool_admin pool_default'
pset
id pool size used load
1 pool_admin 6 4.3 5.3
0 pool_default 2 1.9 2.0
% poolstat -r all -p 'pool_admin pool_default'
id pool type rid rset min max size used load
1 pool_admin pset 1 pset_admin 1 1 1 0.9 2.3
2 pool_default pset -1 pset_default 1 65K 2 2.0 2.0
Example 4: Customizing Output
The following example customizes output:
% poolstat -r -o pool,rset,size,load
pool rset size load
pool_default pset_default 4 4.5
pool_admin pset_admin 4 2.1
The following exit values are returned:
0 Successful completion.
1 An error occurred.
2 Invalid command line options were specified.
See attributes(5) for descriptions of the following attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|Availability |SUNWpool |
+-----------------------------+-----------------------------+
|Stability |Evolving |
+-----------------------------+-----------------------------+
libpool(3LIB), attributes(5)
The system ids associated with resources can change after the system reboots or the resource configuration is altered.
15 Feb 2005 poolstat(1M)