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