1poolstat(1M) System Administration Commands poolstat(1M)
2
6 poolstat - report active pool statistics
7
9 poolstat [-p pool-list] [-r rset-list] [-T u | d ] [interval [count]]
10 poolstat [-p pool-list] [-o format -r rset-list]
13 [-T u | d ] [interval [count]]
14
17 The poolstat utility iteratively examines all active pools on the sys‐
18 tem. It reports statistics based on the selected output mode. poolstat
19 provides options to examine only specified pools and report resource
20 set-specific statistics.
21 Without options, poolstat examines all pools, reports basic statistics
24 for their resource sets, and exits.
25 DISPLAY FORMATS
27 In default output format, poolstat outputs a header line and a line for
28 each pool. The line begins with the pool ID and its name, followed by a
29 column of statistical data for the processor set attached to the pool.
30 The columns are defined as follows:
33 id Pool ID.
35 pool Pool name.
38 rid Resource set id.
41 rset Resource set name.
44 type Resource set type.
47 min Minimum resource set size.
50 max Maximum resource set size.
53 size Current resource set size.
56 used The measure of how much of the resource set is currently is
59 use. This is calculated as the percentage utilization of the
60 resource set multiplied by its size. If resource set has been
61 reconfigured during last sampling interval, this value might be
62 not reported (-).
63 load The absolute representation of the load that is put on the
66 resource set. For the definition of this property see
67 libpool(3LIB).
68
71 The following options are supported:
72 -o format Report statistics according to the format specification
74 given in format. See DISPLAY FORMATS.
75 The -o option accepts lists as arguments. Items in a
77 list can be either separated by commas or enclosed in
78 quotes and separated by commas or spaces.
79 You can specify multiple -o options. The format speci‐
81 fication is interpreted as the whitespace separated
82 concatenation of all the format option arguments.
83 The -o option must be used in conjunction with the -r
85 option.
86 -p pool-list Report only pools whose names are in the given list. If
89 the -r option is also used, this option selects only
90 resource sets which belong to pools in the given list.
91 Statistics for pools or resource sets are reported in
92 the same order in which pool names are listed on the
93 pool-list. Pool can be specified by name or by ID.
94 The -p option accepts lists as arguments. Items in a
96 pool-list can only be separated by spaces.
97 -r rset-list Report resource set statistics. If the rset-list argu‐
100 ment is "all", then all possible resource set types are
101 selected.
102 The -r option accepts lists as arguments. Items in a
104 list can be either separated by commas or enclosed in
105 quotes and separated by commas or spaces.
106 The following resource set types are supported:
108 all All resource set types
110 pset Processor set
113 -T u | d Display a time stamp.
117 Specify u for a printed representation of the internal
119 representation of time. See time(2). Specify d for
120 standard date format. See date(1).
121
124 The following operands are supported:
125 count The number of times that the statistics are repeated. By
127 default, poolstat reports statistics only once.
128 If neither interval nor count are specified, statistics are
130 reported once. If interval is specified and count is not,
131 statistics are reported indefinitely.
132 interval The sampling interval in seconds.
135 If neither interval nor count are specified, statistics are
137 reported once. If interval is specified and count is not,
138 statistics are reported indefinitely.
139
142 Example 1 Using poolstat
143 The following example shows the default output from the poolstat util‐
146 ity:
147 % poolstat
150 pset
151 id pool size used load
152 0 pool_default 4 3.6 6.2
153 1 pool_admin 4 3.3 8.4
154 Example 2 Reporting Resource Set Statistics
158 The following example reports resource set statistics.
161 % poolstat -r pset
165 id pool type rid rset min max size used load
166 0 pool_default pset -1 pset_default 1 65K 2 1.2 8.3
167 1 pool_admin pset 1 pset_admin 1 1 1 0.4 5.2
168 2 pool_other pset -1 pset_default 1 65K 2 1.2 8.3
169 Resource sets attached to multiple pools, as pset_default in the exam‐
174 ple above, are listed multiple times, once for each pool.
175 Example 3 Restricting the Output to the List of Pools
178 The following example restricts the output to the list of pools
181 % poolstat -p pool_default
184 pset
185 id pool size used load
186 0 pool_default 8 5.3 10.3
187 % poolstat -p 'pool_admin pool_default'
189 pset
190 id pool size used load
191 1 pool_admin 6 4.3 5.3
192 0 pool_default 2 1.9 2.0
193 % poolstat -r all -p 'pool_admin pool_default'
195 id pool type rid rset min max size used load
196 1 pool_admin pset 1 pset_admin 1 1 1 0.9 2.3
197 2 pool_default pset -1 pset_default 1 65K 2 2.0 2.0
198 Example 4 Customizing Output
202 The following example customizes output:
205 % poolstat -r -o pool,rset,size,load
208 pool rset size load
209 pool_default pset_default 4 4.5
210 pool_admin pset_admin 4 2.1
211
215 The following exit values are returned:
216 0 Successful completion.
218 1 An error occurred.
221 2 Invalid command line options were specified.
224
227 See attributes(5) for descriptions of the following attributes:
228 ┌─────────────────────────────┬─────────────────────────────┐
233 │ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
234 ├─────────────────────────────┼─────────────────────────────┤
235 │Availability │SUNWpool │
236 ├─────────────────────────────┼─────────────────────────────┤
237 │Stability │Evolving │
238 └─────────────────────────────┴─────────────────────────────┘
239
241 libpool(3LIB), attributes(5)
242
247 The system ids associated with resources can change after the system
248 reboots or the resource configuration is altered.
249SunOS 5.11 16 Jun 2009 poolstat(1M)