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 "Jun 25, 2009" 8 .SH NAME 9 prstat \- report active process statistics 10 .SH SYNOPSIS 11 .LP 12 .nf 13 \fBprstat\fR [\fB-acHJLmRrtTv\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] [\fB-Z\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-z\fR \fIzoneidlist\fR\fR 372 .ad 373 .sp .6 374 .RS 4n 375 Report only processes or LWPs whose zone ID is in the given list. Each zone ID 376 can be specified as either a zone name or a numerical zone ID. See 377 \fBzones\fR(5). 378 .RE 379 380 .sp 381 .ne 2 382 .na 383 \fB\fB-Z\fR\fR 384 .ad 385 .sp .6 386 .RS 4n 387 Report information about processes and zones. In this mode, \fBprstat\fR 388 displays separate reports about processes and zones at the same time. 389 A trailing asterisk marks a long name that has been truncated 390 to fit the column. 391 .RE 392 393 .SH OUTPUT 394 .sp 395 .LP 396 The following list defines the column headings and the meanings of a 397 \fBprstat\fR report: 398 .sp 399 .ne 2 400 .na 401 \fBPID\fR 402 .ad 403 .sp .6 404 .RS 4n 405 The process \fBID\fR of the process. 406 .RE 407 408 .sp 409 .ne 2 410 .na 411 \fBUSERNAME\fR 412 .ad 413 .sp .6 414 .RS 4n 415 The real user (login) name or real user \fBID\fR. 416 A trailing asterisk marks a long name that has been truncated 417 to fit the column. 418 .RE 419 420 .sp 421 .ne 2 422 .na 423 \fBSWAP\fR 424 .ad 425 .sp .6 426 .RS 4n 427 The total virtual memory size of the process, including all mapped files and 428 devices, in kilobytes (\fBK\fR), megabytes (\fBM\fR), or gigabytes (\fBG\fR). 429 .RE 430 431 .sp 432 .ne 2 433 .na 434 \fBRSS\fR 435 .ad 436 .sp .6 437 .RS 4n 438 The resident set size of the process (\fBRSS\fR), in kilobytes (\fBK\fR), 439 megabytes (\fBM\fR), or gigabytes (\fBG\fR). The RSS value is an estimate 440 provided by \fBproc\fR(4) that might underestimate the actual resident set 441 size. Users who want to get more accurate usage information for capacity 442 planning should use the \fB-x\fR option to \fBpmap\fR(1) instead. 443 .RE 444 445 .sp 446 .ne 2 447 .na 448 \fBSTATE\fR 449 .ad 450 .sp .6 451 .RS 4n 452 The state of the process: 453 .sp 454 .ne 2 455 .na 456 \fBcpu\fIN\fR\fR 457 .ad 458 .sp .6 459 .RS 4n 460 Process is running on \fBCPU\fR \fIN\fR. 461 .RE 462 463 .sp 464 .ne 2 465 .na 466 \fBsleep\fR 467 .ad 468 .sp .6 469 .RS 4n 470 Sleeping: process is waiting for an event to complete. 471 .RE 472 473 .sp 474 .ne 2 475 .na 476 \fBwait\fR 477 .ad 478 .sp .6 479 .RS 4n 480 Waiting: process is waiting for CPU usage to drop to the CPU-caps enforced 481 limits. See the description of \fBCPU-caps\fR in \fBresource_controls\fR(5). 482 .RE 483 484 .sp 485 .ne 2 486 .na 487 \fBrun\fR 488 .ad 489 .sp .6 490 .RS 4n 491 Runnable: process in on run queue. 492 .RE 493 494 .sp 495 .ne 2 496 .na 497 \fBzombie\fR 498 .ad 499 .sp .6 500 .RS 4n 501 Zombie state: process terminated and parent not waiting. 502 .RE 503 504 .sp 505 .ne 2 506 .na 507 \fBstop\fR 508 .ad 509 .sp .6 510 .RS 4n 511 Process is stopped. 512 .RE 513 514 .RE 515 516 .sp 517 .ne 2 518 .na 519 \fBPRI\fR 520 .ad 521 .sp .6 522 .RS 4n 523 The priority of the process. Larger numbers mean higher priority. 524 .RE 525 526 .sp 527 .ne 2 528 .na 529 \fBNICE\fR 530 .ad 531 .sp .6 532 .RS 4n 533 Nice value used in priority computation. Only processes in certain scheduling 534 classes have a nice value. 535 .RE 536 537 .sp 538 .ne 2 539 .na 540 \fBTIME\fR 541 .ad 542 .sp .6 543 .RS 4n 544 The cumulative execution time for the process. 545 .RE 546 547 .sp 548 .ne 2 549 .na 550 \fBCPU\fR 551 .ad 552 .sp .6 553 .RS 4n 554 The percentage of recent \fBCPU\fR time used by the process. If executing in a 555 non-global \fBzone\fR and the pools facility is active, the percentage will be 556 that of the processors in the processor set in use by the pool to which the 557 \fBzone\fR is bound. 558 .RE 559 560 .sp 561 .ne 2 562 .na 563 \fBPROCESS\fR 564 .ad 565 .sp .6 566 .RS 4n 567 The name of the process (name of executed file). 568 .RE 569 570 .sp 571 .ne 2 572 .na 573 \fBLWPID\fR 574 .ad 575 .sp .6 576 .RS 4n 577 The \fBlwp\fR \fBID\fR of the \fBlwp\fR being reported. 578 .RE 579 580 .sp 581 .ne 2 582 .na 583 \fBNLWP\fR 584 .ad 585 .sp .6 586 .RS 4n 587 The number of \fBlwp\fRs in the process. 588 .RE 589 590 .sp 591 .LP 592 With the some options, in addition to a number of the column headings shown 593 above, there are: 594 .sp 595 .ne 2 596 .na 597 \fBNPROC\fR 598 .ad 599 .sp .6 600 .RS 4n 601 Number of processes in a specified collection. 602 .RE 603 604 .sp 605 .ne 2 606 .na 607 \fBMEMORY\fR 608 .ad 609 .sp .6 610 .RS 4n 611 Percentage of memory used by a specified collection of processes. 612 .RE 613 614 .sp 615 .LP 616 The following columns are displayed when the \fB-v\fR or \fB-m\fR option is 617 specified 618 .sp 619 .ne 2 620 .na 621 \fBUSR\fR 622 .ad 623 .sp .6 624 .RS 4n 625 The percentage of time the process has spent in user mode. 626 .RE 627 628 .sp 629 .ne 2 630 .na 631 \fBSYS\fR 632 .ad 633 .sp .6 634 .RS 4n 635 The percentage of time the process has spent in system mode. 636 .RE 637 638 .sp 639 .ne 2 640 .na 641 \fBTRP\fR 642 .ad 643 .sp .6 644 .RS 4n 645 The percentage of time the process has spent in processing system traps. 646 .RE 647 648 .sp 649 .ne 2 650 .na 651 \fBTFL\fR 652 .ad 653 .sp .6 654 .RS 4n 655 The percentage of time the process has spent processing text page faults. 656 .RE 657 658 .sp 659 .ne 2 660 .na 661 \fBDFL\fR 662 .ad 663 .sp .6 664 .RS 4n 665 The percentage of time the process has spent processing data page faults. 666 .RE 667 668 .sp 669 .ne 2 670 .na 671 \fBLCK\fR 672 .ad 673 .sp .6 674 .RS 4n 675 The percentage of time the process has spent waiting for user locks. 676 .RE 677 678 .sp 679 .ne 2 680 .na 681 \fBSLP\fR 682 .ad 683 .sp .6 684 .RS 4n 685 The percentage of time the process has spent sleeping. 686 .RE 687 688 .sp 689 .ne 2 690 .na 691 \fBLAT\fR 692 .ad 693 .sp .6 694 .RS 4n 695 The percentage of time the process has spent waiting for CPU. 696 .RE 697 698 .sp 699 .ne 2 700 .na 701 \fBVCX\fR 702 .ad 703 .sp .6 704 .RS 4n 705 The number of voluntary context switches. 706 .RE 707 708 .sp 709 .ne 2 710 .na 711 \fBICX\fR 712 .ad 713 .sp .6 714 .RS 4n 715 The number of involuntary context switches. 716 .RE 717 718 .sp 719 .ne 2 720 .na 721 \fBSCL\fR 722 .ad 723 .sp .6 724 .RS 4n 725 The number of system calls. 726 .RE 727 728 .sp 729 .ne 2 730 .na 731 \fBSIG\fR 732 .ad 733 .sp .6 734 .RS 4n 735 The number of signals received. 736 .RE 737 738 .sp 739 .LP 740 Under the \fB-L\fR option, one line is printed for each \fBlwp\fR in the 741 process and some reporting fields show the values for the \fBlwp\fR, not the 742 process. 743 .sp 744 .LP 745 The following column is displayed when the \fB-H\fR option is specified: 746 .sp 747 .ne 2 748 .na 749 \fBLGRP\fR 750 .ad 751 .sp .6 752 .RS 4n 753 The home \fIlgroup\fR of the process or lwp. 754 .RE 755 756 .SH OPERANDS 757 .sp 758 .LP 759 The following operands are supported: 760 .sp 761 .ne 2 762 .na 763 \fB\fIcount\fR\fR 764 .ad 765 .sp .6 766 .RS 4n 767 Specifies the number of times that the statistics are repeated. By default, 768 \fBprstat\fR reports statistics until a termination signal is received. 769 .RE 770 771 .sp 772 .ne 2 773 .na 774 \fB\fIinterval\fR\fR 775 .ad 776 .sp .6 777 .RS 4n 778 Specifies the sampling interval in seconds; the default interval is \fB5\fR 779 seconds. 780 .RE 781 782 .SH EXAMPLES 783 .LP 784 \fBExample 1 \fRReporting the Five Most Active Super-User Processes 785 .sp 786 .LP 787 The following command reports the five most active super-user processes running 788 on \fBCPU1\fR and \fBCPU2\fR: 789 790 .sp 791 .in +2 792 .nf 793 example% prstat -u root -n 5 -P 1,2 1 1 794 795 PID USERNAME SWAP RSS STATE PRI NICE TIME CPU PROCESS/LWP 796 306 root 3024K 1448K sleep 58 0 0:00.00 0.3% sendmail/1 797 102 root 1600K 592K sleep 59 0 0:00.00 0.1% in.rdisc/1 798 250 root 1000K 552K sleep 58 0 0:00.00 0.0% utmpd/1 799 288 root 1720K 1032K sleep 58 0 0:00.00 0.0% sac/1 800 1 root 744K 168K sleep 58 0 0:00.00 0.0% init/1 801 TOTAL: 25, load averages: 0.05, 0.08, 0.12 802 .fi 803 .in -2 804 .sp 805 806 .LP 807 \fBExample 2 \fRDisplaying Verbose Process Usage Information 808 .sp 809 .LP 810 The following command displays verbose process usage information about 811 processes with lowest resident set sizes owned by users \fBroot\fR and 812 \fBjohn\fR. 813 814 .sp 815 .in +2 816 .nf 817 example% prstat -S rss -n 5 -vc -u root,john 818 819 PID USERNAME USR SYS TRP TFL DFL LCK SLP LAT VCX ICX SCL SIG PROCESS/LWP 820 1 root 0.0 0.0 - - - - 100 - 0 0 0 0 init/1 821 102 root 0.0 0.0 - - - - 100 - 0 0 3 0 in.rdisc/1 822 250 root 0.0 0.0 - - - - 100 - 0 0 0 0 utmpd/1 823 1185 john 0.0 0.0 - - - - 100 - 0 0 0 0 csh/1 824 240 root 0.0 0.0 - - - - 100 - 0 0 0 0 powerd/4 825 TOTAL: 71, load averages: 0.02, 0.04, 0.08 826 827 .fi 828 .in -2 829 .sp 830 831 .SH EXIT STATUS 832 .sp 833 .LP 834 The following exit values are returned: 835 .sp 836 .ne 2 837 .na 838 \fB\fB0\fR\fR 839 .ad 840 .sp .6 841 .RS 4n 842 Successful completion. 843 .RE 844 845 .sp 846 .ne 2 847 .na 848 \fB\fB1\fR\fR 849 .ad 850 .sp .6 851 .RS 4n 852 An error occurred. 853 .RE 854 855 .SH SEE ALSO 856 .sp 857 .LP 858 \fBdate\fR(1), \fBlgrpinfo\fR(1), \fBplgrp\fR(1), \fBproc\fR(1), \fBps\fR(1), 859 \fBtime\fR(2), \fBpsrinfo\fR(1M), \fBpsrset\fR(1M), \fBsar\fR(1M), 860 \fBpset_getloadavg\fR(3C), \fBproc\fR(4), \fBproject\fR(4), 861 \fBattributes\fR(5), \fBresource_controls\fR(5), \fBzones\fR(5) 862 .SH NOTES 863 .sp 864 .LP 865 The snapshot of system usage displayed by \fBprstat\fR is true only for a 866 split-second, and it may not be accurate by the time it is displayed. When the 867 \fB-m\fR option is specified, \fBprstat\fR tries to turn on microstate 868 accounting for each process; the original state is restored when \fBprstat\fR 869 exits. See \fBproc\fR(4) for additional information about the microstate 870 accounting facility. 871 .sp 872 .LP 873 The total memory size reported in the SWAP and RSS columns for groups of 874 processes can sometimes overestimate the actual amount of memory used by 875 processes with shared memory segments.