Print this page
2989 Eliminate use of LOGNAME_MAX in ON
1166 useradd have warning with name more 8 chars
Split |
Close |
Expand all |
Collapse all |
--- old/usr/src/man/man1m/prstat.1m
+++ new/usr/src/man/man1m/prstat.1m
1 1 '\" te
2 +.\" Copyright (c) 2013 Gary Mills
2 3 .\" Copyright (c) 2006, 2009 Sun Microsystems, Inc. All Rights Reserved.
3 4 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.
4 5 .\" See the License for the specific language governing permissions and limitations under the License. When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with
5 6 .\" the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
6 -.TH PRSTAT 1M "Jun 25, 2009"
7 +.TH PRSTAT 1M "Apr 15, 2013"
7 8 .SH NAME
8 9 prstat \- report active process statistics
9 10 .SH SYNOPSIS
10 11 .LP
11 12 .nf
12 -\fBprstat\fR [\fB-acHJLmRrtTv\fR] [\fB-d\fR u | d] [\fB-C\fR \fIpsrsetlist\fR] [\fB-h\fR \fIlgrplist\fR]
13 +\fBprstat\fR [\fB-acHJLmRrtTvWZ\fR] [\fB-d\fR u | d] [\fB-C\fR \fIpsrsetlist\fR] [\fB-h\fR \fIlgrplist\fR]
13 14 [\fB-j\fR \fIprojlist\fR] [\fB-k\fR \fItasklist\fR] [\fB-n\fR \fIntop\fR[,\fInbottom\fR]]
14 15 [\fB-p\fR \fIpidlist\fR] [\fB-P\fR \fIcpulist\fR] [\fB-s\fR \fIkey\fR | \fB-S\fR \fIkey\fR ]
15 - [\fB-u\fR \fIeuidlist\fR] [\fB-U\fR \fIuidlist\fR] [\fB-z\fR \fIzoneidlist\fR] [\fB-Z\fR]
16 + [\fB-u\fR \fIeuidlist\fR] [\fB-U\fR \fIuidlist\fR] [\fB-z\fR \fIzoneidlist\fR]
16 17 [\fIinterval\fR [\fIcount\fR]]
17 18 .fi
18 19
19 20 .SH DESCRIPTION
20 21 .sp
21 22 .LP
22 23 The \fBprstat\fR utility iteratively examines all active processes on the
23 24 system and reports statistics based on the selected output mode and sort order.
24 25 \fBprstat\fR provides options to examine only processes matching specified
25 26 \fBPID\fRs, \fBUID\fRs, zone \fBID\fRs, \fBCPU\fR \fBID\fRs, and processor set
26 27 \fBID\fRs.
27 28 .sp
28 29 .LP
29 30 The \fB-j\fR, \fB-k\fR, \fB-C\fR, \fB-p\fR, \fB-P\fR, \fB-u\fR, \fB-U\fR, and
30 31 \fB-z\fR options accept lists as arguments. Items in a list can be either
31 32 separated by commas or enclosed in quotes and separated by commas or spaces.
32 33 .sp
33 34 .LP
34 35 If you do not specify an option, \fBprstat\fR examines all processes and
35 36 reports statistics sorted by \fBCPU\fR usage.
36 37 .SH OPTIONS
37 38 .sp
38 39 .LP
39 40 The following options are supported:
40 41 .sp
41 42 .ne 2
42 43 .na
43 44 \fB\fB-a\fR\fR
44 45 .ad
45 46 .sp .6
46 47 .RS 4n
47 48 Report information about processes and users. In this mode \fBprstat\fR
48 49 displays separate reports about processes and users at the same time.
↓ open down ↓ |
23 lines elided |
↑ open up ↑ |
49 50 .RE
50 51
51 52 .sp
52 53 .ne 2
53 54 .na
54 55 \fB\fB-c\fR\fR
55 56 .ad
56 57 .sp .6
57 58 .RS 4n
58 59 Print new reports below previous reports instead of overprinting them.
60 +Long names are not truncated in this mode.
59 61 .RE
60 62
61 63 .sp
62 64 .ne 2
63 65 .na
64 66 \fB\fB-C\fR \fIpsrsetlist\fR\fR
65 67 .ad
66 68 .sp .6
67 69 .RS 4n
68 70 Report only processes or lwps that are bound to processor sets in the given
69 71 list. Each processor set is identified by an integer as reported by
70 72 \fBpsrset\fR(1M). The load averages displayed are the sum of the load averages
71 73 of the specified processor sets (see \fBpset_getloadavg\fR(3C)). Processes with
72 74 one or more LWPs bound to processor sets in the given list are reported even
73 75 when the \fB-L\fR option is not used.
74 76 .RE
75 77
76 78 .sp
77 79 .ne 2
78 80 .na
79 81 \fB\fB-d\fR \fBu | d\fR\fR
80 82 .ad
81 83 .sp .6
82 84 .RS 4n
83 85 Specify \fBu\fR for a printed representation of the internal representation of
84 86 time. See \fBtime\fR(2). Specify \fBd\fR for standard date format. See
85 87 \fBdate\fR(1).
86 88 .RE
87 89
88 90 .sp
89 91 .ne 2
90 92 .na
91 93 \fB\fB-h\fR \fIlgrplist\fR\fR
92 94 .ad
93 95 .sp .6
94 96 .RS 4n
95 97 Report only processes or lwps whose home \fIlgroup\fR is in the given list of
96 98 \fIlgroups\fR. No processes or lwps will be listed for invalid \fIlgroups\fR.
97 99 .RE
98 100
99 101 .sp
100 102 .ne 2
101 103 .na
102 104 \fB\fB-H\fR\fR
103 105 .ad
104 106 .sp .6
105 107 .RS 4n
106 108 Report information about home \fIlgroup\fR. In this mode, \fBprstat\fR adds an
107 109 extra column showing process or lwps home \fIlgroup\fR with the header LGRP.
108 110 .RE
109 111
110 112 .sp
111 113 .ne 2
112 114 .na
113 115 \fB\fB-j\fR \fIprojlist\fR\fR
114 116 .ad
115 117 .sp .6
116 118 .RS 4n
117 119 Report only processes or lwps whose project \fBID\fR is in the given list. Each
118 120 project \fBID\fR can be specified as either a project name or a numerical
119 121 project \fBID\fR. See \fBproject\fR(4).
120 122 .RE
↓ open down ↓ |
52 lines elided |
↑ open up ↑ |
121 123
122 124 .sp
123 125 .ne 2
124 126 .na
125 127 \fB\fB-J\fR\fR
126 128 .ad
127 129 .sp .6
128 130 .RS 4n
129 131 Report information about processes and projects. In this mode \fBprstat\fR
130 132 displays separate reports about processes and projects at the same time.
133 +A trailing asterisk marks a long name that has been truncated
134 +to fit the column.
131 135 .RE
132 136
133 137 .sp
134 138 .ne 2
135 139 .na
136 140 \fB\fB-k\fR \fItasklist\fR\fR
137 141 .ad
138 142 .sp .6
139 143 .RS 4n
140 144 Report only processes or lwps whose task \fBID\fR is in \fItasklist\fR.
141 145 .RE
142 146
143 147 .sp
144 148 .ne 2
145 149 .na
146 150 \fB\fB-L\fR\fR
147 151 .ad
148 152 .sp .6
149 153 .RS 4n
150 154 Report statistics for each light-weight process (\fBLWP\fR). By default,
151 155 \fBprstat\fR reports only the number of \fBLWP\fRs for each process.
152 156 .RE
153 157
154 158 .sp
155 159 .ne 2
156 160 .na
157 161 \fB\fB-m\fR\fR
158 162 .ad
159 163 .sp .6
160 164 .RS 4n
161 165 Report microstate process accounting information. In addition to all fields
162 166 listed in \fB-v\fR mode, this mode also includes the percentage of time the
163 167 process has spent processing system traps, text page faults, data page faults,
164 168 waiting for user locks and waiting for \fBCPU\fR (latency time).
165 169 .RE
166 170
167 171 .sp
168 172 .ne 2
169 173 .na
170 174 \fB\fB-n\fR \fIntop\fR[\fI,nbottom\fR]\fR
171 175 .ad
172 176 .sp .6
173 177 .RS 4n
174 178 Restrict number of output lines. The \fIntop\fR argument determines how many
175 179 lines of process or \fBlwp\fR statistics are reported, and the \fInbottom\fR
176 180 argument determines how many lines of user, task, or projects statistics are
177 181 reported if the \fB-a\fR, \fB-t\fR, \fB-T\fR, or \fB-J\fR options are
178 182 specified. By default, \fBprstat\fR displays as many lines of output that fit
179 183 in a window or terminal. When you specify the \fB-c\fR option or direct the
180 184 output to a file, the default values for \fBntop\fR and \fBnbottom\fR are
181 185 \fB15\fR and \fB5\fR.
182 186 .RE
183 187
184 188 .sp
185 189 .ne 2
186 190 .na
187 191 \fB\fB-p\fR \fIpidlist\fR\fR
188 192 .ad
189 193 .sp .6
190 194 .RS 4n
191 195 Report only processes whose process \fBID\fR is in the given list.
192 196 .RE
193 197
194 198 .sp
195 199 .ne 2
196 200 .na
197 201 \fB\fB-P\fR \fIcpulist\fR\fR
198 202 .ad
199 203 .sp .6
200 204 .RS 4n
201 205 Report only processes or \fBlwp\fRs which have most recently executed on a
202 206 \fBCPU\fR in the given list. Each \fBCPU\fR is identified by an integer as
203 207 reported by \fBpsrinfo\fR(1M).
204 208 .RE
205 209
206 210 .sp
207 211 .ne 2
208 212 .na
209 213 \fB\fB-R\fR\fR
210 214 .ad
211 215 .sp .6
212 216 .RS 4n
213 217 Put \fBprstat\fR in the real time scheduling class. When this option is used,
214 218 \fBprstat\fR is given priority over time-sharing and interactive processes.
215 219 This option is available only for superuser.
216 220 .RE
217 221
218 222 .sp
219 223 .ne 2
220 224 .na
221 225 \fB\fB-r\fR\fR
222 226 .ad
223 227 .sp .6
224 228 .RS 4n
225 229 Disable lookups for user names and project names. (Note that this does not
226 230 apply to lookups for the \fB-j\fR, \fB-u\fR, or \fB-U\fR options.)
227 231 .RE
228 232
229 233 .sp
230 234 .ne 2
231 235 .na
232 236 \fB\fB-s\fR \fIkey\fR\fR
233 237 .ad
234 238 .sp .6
235 239 .RS 4n
236 240 Sort output lines (that is, processes, \fBlwp\fRs, or users) by \fIkey\fR in
237 241 descending order. Only one \fIkey\fR can be used as an argument.
238 242 .sp
239 243 There are five possible key values:
240 244 .sp
241 245 .ne 2
242 246 .na
243 247 \fBcpu\fR
244 248 .ad
245 249 .sp .6
246 250 .RS 4n
247 251 Sort by process \fBCPU\fR usage. This is the default.
248 252 .RE
249 253
250 254 .sp
251 255 .ne 2
252 256 .na
253 257 \fBpri\fR
254 258 .ad
255 259 .sp .6
256 260 .RS 4n
257 261 Sort by process priority.
258 262 .RE
259 263
260 264 .sp
261 265 .ne 2
262 266 .na
263 267 \fBrss\fR
264 268 .ad
265 269 .sp .6
266 270 .RS 4n
267 271 Sort by resident set size.
268 272 .RE
269 273
270 274 .sp
271 275 .ne 2
272 276 .na
273 277 \fBsize\fR
274 278 .ad
275 279 .sp .6
276 280 .RS 4n
277 281 Sort by size of process image.
278 282 .RE
279 283
280 284 .sp
281 285 .ne 2
282 286 .na
283 287 \fBtime\fR
284 288 .ad
285 289 .sp .6
286 290 .RS 4n
287 291 Sort by process execution time.
288 292 .RE
289 293
290 294 .RE
291 295
292 296 .sp
293 297 .ne 2
294 298 .na
295 299 \fB\fB-S\fR \fIkey\fR\fR
296 300 .ad
297 301 .sp .6
298 302 .RS 4n
299 303 Sort output lines by \fIkey\fR in ascending order. Possible \fIkey\fR values
300 304 are the same as for the \fB-s\fR option. See \fB-s\fR.
301 305 .RE
302 306
303 307 .sp
304 308 .ne 2
305 309 .na
306 310 \fB\fB-t\fR\fR
307 311 .ad
308 312 .sp .6
309 313 .RS 4n
310 314 Report total usage summary for each user. The summary includes the total number
311 315 of processes or \fBLWP\fRs owned by the user, total size of process images,
312 316 total resident set size, total cpu time, and percentages of recent cpu time and
313 317 system memory.
314 318 .RE
315 319
316 320 .sp
317 321 .ne 2
318 322 .na
319 323 \fB\fB-T\fR\fR
320 324 .ad
321 325 .sp .6
322 326 .RS 4n
323 327 Report information about processes and tasks. In this mode \fBprstat\fR
324 328 displays separate reports about processes and tasks at the same time.
325 329 .RE
326 330
327 331 .sp
328 332 .ne 2
329 333 .na
330 334 \fB\fB-u\fR \fIeuidlist\fR\fR
331 335 .ad
332 336 .sp .6
333 337 .RS 4n
334 338 Report only processes whose effective user \fBID\fR is in the given list. Each
335 339 user \fBID\fR may be specified as either a login name or a numerical user
336 340 \fBID\fR.
337 341 .RE
338 342
339 343 .sp
340 344 .ne 2
341 345 .na
342 346 \fB\fB-U\fR \fIuidlis\fRt\fR
343 347 .ad
344 348 .sp .6
345 349 .RS 4n
346 350 Report only processes whose real user \fBID\fR is in the given list. Each user
347 351 \fBID\fR may be specified as either a login name or a numerical user \fBID\fR.
348 352 .RE
349 353
350 354 .sp
351 355 .ne 2
352 356 .na
353 357 \fB\fB-v\fR\fR
354 358 .ad
355 359 .sp .6
356 360 .RS 4n
↓ open down ↓ |
216 lines elided |
↑ open up ↑ |
357 361 Report verbose process usage. This output format includes the percentage of
358 362 time the process has spent in user mode, in system mode, and sleeping. It also
359 363 includes the number of voluntary and involuntary context switches, system calls
360 364 and the number of signals received. Statistics that are not reported are marked
361 365 with the \fB-\fR sign.
362 366 .RE
363 367
364 368 .sp
365 369 .ne 2
366 370 .na
371 +\fB\fB-W\fR\fR
372 +.ad
373 +.sp .6
374 +.RS 4n
375 +Truncate long names even when \fBprstat\fR would normally print them
376 +in full.
377 +A trailing asterisk marks a long name that has been truncated
378 +to fit the column.
379 +.RE
380 +
381 +.sp
382 +.ne 2
383 +.na
367 384 \fB\fB-z\fR \fIzoneidlist\fR\fR
368 385 .ad
369 386 .sp .6
370 387 .RS 4n
371 388 Report only processes or LWPs whose zone ID is in the given list. Each zone ID
372 389 can be specified as either a zone name or a numerical zone ID. See
373 390 \fBzones\fR(5).
374 391 .RE
375 392
376 393 .sp
377 394 .ne 2
378 395 .na
379 396 \fB\fB-Z\fR\fR
380 397 .ad
381 398 .sp .6
382 399 .RS 4n
383 400 Report information about processes and zones. In this mode, \fBprstat\fR
384 401 displays separate reports about processes and zones at the same time.
402 +A trailing asterisk marks a long name that has been truncated
403 +to fit the column.
385 404 .RE
386 405
387 406 .SH OUTPUT
388 407 .sp
389 408 .LP
390 409 The following list defines the column headings and the meanings of a
391 410 \fBprstat\fR report:
392 411 .sp
393 412 .ne 2
394 413 .na
395 414 \fBPID\fR
396 415 .ad
397 416 .sp .6
398 417 .RS 4n
399 418 The process \fBID\fR of the process.
↓ open down ↓ |
5 lines elided |
↑ open up ↑ |
400 419 .RE
401 420
402 421 .sp
403 422 .ne 2
404 423 .na
405 424 \fBUSERNAME\fR
406 425 .ad
407 426 .sp .6
408 427 .RS 4n
409 428 The real user (login) name or real user \fBID\fR.
429 +A trailing asterisk marks a long name that has been truncated
430 +to fit the column.
410 431 .RE
411 432
412 433 .sp
413 434 .ne 2
414 435 .na
415 436 \fBSWAP\fR
416 437 .ad
417 438 .sp .6
418 439 .RS 4n
419 440 The total virtual memory size of the process, including all mapped files and
420 441 devices, in kilobytes (\fBK\fR), megabytes (\fBM\fR), or gigabytes (\fBG\fR).
421 442 .RE
422 443
423 444 .sp
424 445 .ne 2
425 446 .na
426 447 \fBRSS\fR
427 448 .ad
428 449 .sp .6
429 450 .RS 4n
430 451 The resident set size of the process (\fBRSS\fR), in kilobytes (\fBK\fR),
431 452 megabytes (\fBM\fR), or gigabytes (\fBG\fR). The RSS value is an estimate
432 453 provided by \fBproc\fR(4) that might underestimate the actual resident set
433 454 size. Users who want to get more accurate usage information for capacity
434 455 planning should use the \fB-x\fR option to \fBpmap\fR(1) instead.
435 456 .RE
436 457
437 458 .sp
438 459 .ne 2
439 460 .na
440 461 \fBSTATE\fR
441 462 .ad
442 463 .sp .6
443 464 .RS 4n
444 465 The state of the process:
445 466 .sp
446 467 .ne 2
447 468 .na
448 469 \fBcpu\fIN\fR\fR
449 470 .ad
450 471 .sp .6
451 472 .RS 4n
452 473 Process is running on \fBCPU\fR \fIN\fR.
453 474 .RE
454 475
455 476 .sp
456 477 .ne 2
457 478 .na
458 479 \fBsleep\fR
459 480 .ad
460 481 .sp .6
461 482 .RS 4n
462 483 Sleeping: process is waiting for an event to complete.
463 484 .RE
464 485
465 486 .sp
466 487 .ne 2
467 488 .na
468 489 \fBwait\fR
469 490 .ad
470 491 .sp .6
471 492 .RS 4n
472 493 Waiting: process is waiting for CPU usage to drop to the CPU-caps enforced
473 494 limits. See the description of \fBCPU-caps\fR in \fBresource_controls\fR(5).
474 495 .RE
475 496
476 497 .sp
477 498 .ne 2
478 499 .na
479 500 \fBrun\fR
480 501 .ad
481 502 .sp .6
482 503 .RS 4n
483 504 Runnable: process in on run queue.
484 505 .RE
485 506
486 507 .sp
487 508 .ne 2
488 509 .na
489 510 \fBzombie\fR
490 511 .ad
491 512 .sp .6
492 513 .RS 4n
493 514 Zombie state: process terminated and parent not waiting.
494 515 .RE
495 516
496 517 .sp
497 518 .ne 2
498 519 .na
499 520 \fBstop\fR
500 521 .ad
501 522 .sp .6
502 523 .RS 4n
503 524 Process is stopped.
504 525 .RE
505 526
506 527 .RE
507 528
508 529 .sp
509 530 .ne 2
510 531 .na
511 532 \fBPRI\fR
512 533 .ad
513 534 .sp .6
514 535 .RS 4n
515 536 The priority of the process. Larger numbers mean higher priority.
516 537 .RE
517 538
518 539 .sp
519 540 .ne 2
520 541 .na
521 542 \fBNICE\fR
522 543 .ad
523 544 .sp .6
524 545 .RS 4n
525 546 Nice value used in priority computation. Only processes in certain scheduling
526 547 classes have a nice value.
527 548 .RE
528 549
529 550 .sp
530 551 .ne 2
531 552 .na
532 553 \fBTIME\fR
533 554 .ad
534 555 .sp .6
535 556 .RS 4n
536 557 The cumulative execution time for the process.
537 558 .RE
538 559
539 560 .sp
540 561 .ne 2
541 562 .na
542 563 \fBCPU\fR
543 564 .ad
544 565 .sp .6
545 566 .RS 4n
546 567 The percentage of recent \fBCPU\fR time used by the process. If executing in a
547 568 non-global \fBzone\fR and the pools facility is active, the percentage will be
548 569 that of the processors in the processor set in use by the pool to which the
549 570 \fBzone\fR is bound.
550 571 .RE
551 572
552 573 .sp
553 574 .ne 2
554 575 .na
555 576 \fBPROCESS\fR
556 577 .ad
557 578 .sp .6
558 579 .RS 4n
559 580 The name of the process (name of executed file).
560 581 .RE
561 582
562 583 .sp
563 584 .ne 2
564 585 .na
565 586 \fBLWPID\fR
566 587 .ad
567 588 .sp .6
568 589 .RS 4n
569 590 The \fBlwp\fR \fBID\fR of the \fBlwp\fR being reported.
570 591 .RE
571 592
572 593 .sp
573 594 .ne 2
574 595 .na
575 596 \fBNLWP\fR
576 597 .ad
577 598 .sp .6
578 599 .RS 4n
579 600 The number of \fBlwp\fRs in the process.
580 601 .RE
581 602
582 603 .sp
583 604 .LP
584 605 With the some options, in addition to a number of the column headings shown
585 606 above, there are:
586 607 .sp
587 608 .ne 2
588 609 .na
589 610 \fBNPROC\fR
590 611 .ad
591 612 .sp .6
592 613 .RS 4n
593 614 Number of processes in a specified collection.
594 615 .RE
595 616
596 617 .sp
597 618 .ne 2
598 619 .na
599 620 \fBMEMORY\fR
600 621 .ad
601 622 .sp .6
602 623 .RS 4n
603 624 Percentage of memory used by a specified collection of processes.
604 625 .RE
605 626
606 627 .sp
607 628 .LP
608 629 The following columns are displayed when the \fB-v\fR or \fB-m\fR option is
609 630 specified
610 631 .sp
611 632 .ne 2
612 633 .na
613 634 \fBUSR\fR
614 635 .ad
615 636 .sp .6
616 637 .RS 4n
617 638 The percentage of time the process has spent in user mode.
618 639 .RE
619 640
620 641 .sp
621 642 .ne 2
622 643 .na
623 644 \fBSYS\fR
624 645 .ad
625 646 .sp .6
626 647 .RS 4n
627 648 The percentage of time the process has spent in system mode.
628 649 .RE
629 650
630 651 .sp
631 652 .ne 2
632 653 .na
633 654 \fBTRP\fR
634 655 .ad
635 656 .sp .6
636 657 .RS 4n
637 658 The percentage of time the process has spent in processing system traps.
638 659 .RE
639 660
640 661 .sp
641 662 .ne 2
642 663 .na
643 664 \fBTFL\fR
644 665 .ad
645 666 .sp .6
646 667 .RS 4n
647 668 The percentage of time the process has spent processing text page faults.
648 669 .RE
649 670
650 671 .sp
651 672 .ne 2
652 673 .na
653 674 \fBDFL\fR
654 675 .ad
655 676 .sp .6
656 677 .RS 4n
657 678 The percentage of time the process has spent processing data page faults.
658 679 .RE
659 680
660 681 .sp
661 682 .ne 2
662 683 .na
663 684 \fBLCK\fR
664 685 .ad
665 686 .sp .6
666 687 .RS 4n
667 688 The percentage of time the process has spent waiting for user locks.
668 689 .RE
669 690
670 691 .sp
671 692 .ne 2
672 693 .na
673 694 \fBSLP\fR
674 695 .ad
675 696 .sp .6
676 697 .RS 4n
677 698 The percentage of time the process has spent sleeping.
678 699 .RE
679 700
680 701 .sp
681 702 .ne 2
682 703 .na
683 704 \fBLAT\fR
684 705 .ad
685 706 .sp .6
686 707 .RS 4n
687 708 The percentage of time the process has spent waiting for CPU.
688 709 .RE
689 710
690 711 .sp
691 712 .ne 2
692 713 .na
693 714 \fBVCX\fR
694 715 .ad
695 716 .sp .6
696 717 .RS 4n
697 718 The number of voluntary context switches.
698 719 .RE
699 720
700 721 .sp
701 722 .ne 2
702 723 .na
703 724 \fBICX\fR
704 725 .ad
705 726 .sp .6
706 727 .RS 4n
707 728 The number of involuntary context switches.
708 729 .RE
709 730
710 731 .sp
711 732 .ne 2
712 733 .na
713 734 \fBSCL\fR
714 735 .ad
715 736 .sp .6
716 737 .RS 4n
717 738 The number of system calls.
718 739 .RE
719 740
720 741 .sp
721 742 .ne 2
722 743 .na
723 744 \fBSIG\fR
724 745 .ad
725 746 .sp .6
726 747 .RS 4n
727 748 The number of signals received.
728 749 .RE
729 750
730 751 .sp
731 752 .LP
732 753 Under the \fB-L\fR option, one line is printed for each \fBlwp\fR in the
733 754 process and some reporting fields show the values for the \fBlwp\fR, not the
734 755 process.
735 756 .sp
736 757 .LP
737 758 The following column is displayed when the \fB-H\fR option is specified:
738 759 .sp
739 760 .ne 2
740 761 .na
741 762 \fBLGRP\fR
742 763 .ad
743 764 .sp .6
744 765 .RS 4n
745 766 The home \fIlgroup\fR of the process or lwp.
746 767 .RE
747 768
748 769 .SH OPERANDS
749 770 .sp
750 771 .LP
751 772 The following operands are supported:
752 773 .sp
753 774 .ne 2
754 775 .na
755 776 \fB\fIcount\fR\fR
756 777 .ad
757 778 .sp .6
758 779 .RS 4n
759 780 Specifies the number of times that the statistics are repeated. By default,
760 781 \fBprstat\fR reports statistics until a termination signal is received.
761 782 .RE
762 783
763 784 .sp
764 785 .ne 2
765 786 .na
766 787 \fB\fIinterval\fR\fR
767 788 .ad
768 789 .sp .6
769 790 .RS 4n
770 791 Specifies the sampling interval in seconds; the default interval is \fB5\fR
771 792 seconds.
772 793 .RE
773 794
774 795 .SH EXAMPLES
775 796 .LP
776 797 \fBExample 1 \fRReporting the Five Most Active Super-User Processes
777 798 .sp
778 799 .LP
779 800 The following command reports the five most active super-user processes running
780 801 on \fBCPU1\fR and \fBCPU2\fR:
781 802
782 803 .sp
783 804 .in +2
784 805 .nf
785 806 example% prstat -u root -n 5 -P 1,2 1 1
786 807
787 808 PID USERNAME SWAP RSS STATE PRI NICE TIME CPU PROCESS/LWP
788 809 306 root 3024K 1448K sleep 58 0 0:00.00 0.3% sendmail/1
789 810 102 root 1600K 592K sleep 59 0 0:00.00 0.1% in.rdisc/1
790 811 250 root 1000K 552K sleep 58 0 0:00.00 0.0% utmpd/1
791 812 288 root 1720K 1032K sleep 58 0 0:00.00 0.0% sac/1
792 813 1 root 744K 168K sleep 58 0 0:00.00 0.0% init/1
793 814 TOTAL: 25, load averages: 0.05, 0.08, 0.12
794 815 .fi
795 816 .in -2
796 817 .sp
797 818
798 819 .LP
799 820 \fBExample 2 \fRDisplaying Verbose Process Usage Information
800 821 .sp
801 822 .LP
802 823 The following command displays verbose process usage information about
803 824 processes with lowest resident set sizes owned by users \fBroot\fR and
804 825 \fBjohn\fR.
805 826
806 827 .sp
807 828 .in +2
808 829 .nf
809 830 example% prstat -S rss -n 5 -vc -u root,john
810 831
811 832 PID USERNAME USR SYS TRP TFL DFL LCK SLP LAT VCX ICX SCL SIG PROCESS/LWP
812 833 1 root 0.0 0.0 - - - - 100 - 0 0 0 0 init/1
813 834 102 root 0.0 0.0 - - - - 100 - 0 0 3 0 in.rdisc/1
814 835 250 root 0.0 0.0 - - - - 100 - 0 0 0 0 utmpd/1
815 836 1185 john 0.0 0.0 - - - - 100 - 0 0 0 0 csh/1
816 837 240 root 0.0 0.0 - - - - 100 - 0 0 0 0 powerd/4
817 838 TOTAL: 71, load averages: 0.02, 0.04, 0.08
818 839
819 840 .fi
820 841 .in -2
821 842 .sp
822 843
823 844 .SH EXIT STATUS
824 845 .sp
825 846 .LP
826 847 The following exit values are returned:
827 848 .sp
828 849 .ne 2
829 850 .na
830 851 \fB\fB0\fR\fR
831 852 .ad
832 853 .sp .6
833 854 .RS 4n
834 855 Successful completion.
835 856 .RE
836 857
837 858 .sp
838 859 .ne 2
839 860 .na
840 861 \fB\fB1\fR\fR
841 862 .ad
842 863 .sp .6
843 864 .RS 4n
844 865 An error occurred.
845 866 .RE
846 867
847 868 .SH SEE ALSO
848 869 .sp
849 870 .LP
850 871 \fBdate\fR(1), \fBlgrpinfo\fR(1), \fBplgrp\fR(1), \fBproc\fR(1), \fBps\fR(1),
851 872 \fBtime\fR(2), \fBpsrinfo\fR(1M), \fBpsrset\fR(1M), \fBsar\fR(1M),
852 873 \fBpset_getloadavg\fR(3C), \fBproc\fR(4), \fBproject\fR(4),
853 874 \fBattributes\fR(5), \fBresource_controls\fR(5), \fBzones\fR(5)
854 875 .SH NOTES
855 876 .sp
856 877 .LP
857 878 The snapshot of system usage displayed by \fBprstat\fR is true only for a
858 879 split-second, and it may not be accurate by the time it is displayed. When the
859 880 \fB-m\fR option is specified, \fBprstat\fR tries to turn on microstate
860 881 accounting for each process; the original state is restored when \fBprstat\fR
861 882 exits. See \fBproc\fR(4) for additional information about the microstate
862 883 accounting facility.
863 884 .sp
864 885 .LP
865 886 The total memory size reported in the SWAP and RSS columns for groups of
866 887 processes can sometimes overestimate the actual amount of memory used by
867 888 processes with shared memory segments.
↓ open down ↓ |
448 lines elided |
↑ open up ↑ |
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX