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