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