| blob | 695d4b7c2932da7916750f649c66922837010f03 |
1 '\" te
2 .\" Copyright 1989 AT&T
3 .\" Copyright (c) 2009, Sun Microsystems, Inc. All Rights Reserved
4 .\" Copyright (c) 2017, Joyent, Inc.
5 .\" Copyright (c) 2013 Gary Mills
6 .\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved
7 .\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at http://www.opengroup.org/bookstore/.
8 .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text
9 .\" are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical
10 .\" and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html.
11 .\" This notice shall appear on any product containing this material.
12 .\" 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.
13 .\" 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
14 .\" the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
15 .TH PS 1 "Jun 13, 2017"
16 .SH NAME
17 ps \- report process status
18 .SH SYNOPSIS
19 .LP
20 .nf
21 \fBps\fR [\fB-aAcdefjHlLPWyZ\fR] [\fB-g\fR \fIgrplist\fR] [\fB-h\fR \fIlgrplist\fR]
22 [\fB-n\fR \fInamelist\fR] [\fB-o\fR \fIformat\fR]... [\fB-p\fR \fIproclist\fR]
23 [\fB-s\fR \fIsidlist\fR] [\fB-t\fR \fIterm\fR] [\fB-u\fR \fIuidlist\fR] [\fB-U\fR \fIuidlist\fR]
24 [\fB-G\fR \fIgidlist\fR] [\fB-z\fR \fIzonelist\fR]
25 .fi
27 .SH DESCRIPTION
28 .LP
29 The \fBps\fR command prints information about active processes. Without
30 options, \fBps\fR prints information about processes that have the same
31 effective user \fBID\fR and the same controlling terminal as the invoker. The
32 output contains only the process \fBID\fR, terminal identifier, cumulative
33 execution time, and the command name. Otherwise, the information that is
34 displayed is controlled by the options.
35 .sp
36 .LP
37 Some options accept lists as arguments. Items in a list can be either separated
38 by commas or else enclosed in quotes and separated by commas or spaces. Values
39 for \fIproclist\fR and \fIgrplist\fR must be numeric.
40 .SH OPTIONS
41 .LP
42 The following options are supported:
43 .sp
44 .ne 2
45 .na
46 \fB\fB-a\fR\fR
47 .ad
48 .RS 15n
49 Lists information about \fBa\fRll processes most frequently requested: all
50 those except session leaders and processes not associated with a terminal.
51 .sp
52 This option is ignored when the \fB-e\fR option is also specified.
53 .RE
55 .sp
56 .ne 2
57 .na
58 \fB\fB-A\fR\fR
59 .ad
60 .RS 15n
61 Lists information for all processes. Identical to \fB-e\fR, below.
62 .RE
64 .sp
65 .ne 2
66 .na
67 \fB\fB-c\fR\fR
68 .ad
69 .RS 15n
70 Prints information in a format that reflects scheduler properties as described
71 in \fBpriocntl\fR(1). The \fB-c\fR option affects the output of the \fB-f\fR
72 and \fB-l\fR options, as described below.
73 .RE
75 .sp
76 .ne 2
77 .na
78 \fB\fB-d\fR\fR
79 .ad
80 .RS 15n
81 Lists information about all processes except session leaders.
82 .RE
84 .sp
85 .ne 2
86 .na
87 \fB\fB-e\fR\fR
88 .ad
89 .RS 15n
90 Lists information about \fBe\fRvery process now running.
91 .sp
92 When the \fB-e\fR option is specified, options \fB-z\fR, \fB-t\fR, \fB-u\fR,
93 \fB-U\fR, \fB-g\fR, \fB-G\fR, \fB-p\fR, \fB-h\fR, \fB-s\fR and \fB-a\fR
94 have no effect.
95 .RE
97 .sp
98 .ne 2
99 .na
100 \fB\fB-f\fR\fR
101 .ad
102 .RS 15n
103 Generates a \fBf\fRull listing. (See below for significance of columns in a
104 full listing.)
105 .RE
107 .sp
108 .ne 2
109 .na
110 \fB\fB-g\fR \fIgrplist\fR\fR
111 .ad
112 .RS 15n
113 Lists only process data whose group leader's \fBID\fR number(s) appears in
114 \fIgrplist\fR. (A group leader is a process whose process \fBID\fR number is
115 identical to its process group \fBID\fR number.)
116 .sp
117 This option is ignored when the \fB-e\fR option is also specified.
118 .RE
120 .sp
121 .ne 2
122 .na
123 \fB\fB-G\fR \fIgidlist\fR\fR
124 .ad
125 .RS 15n
126 Lists information for processes whose real group ID numbers are given in
127 \fIgidlist\fR. The \fIgidlist\fR must be a single argument in the form of a
128 blank- or comma-separated list.
129 .sp
130 This option is ignored when the \fB-e\fR option is also specified.
131 .RE
133 .sp
134 .ne 2
135 .na
136 \fB\fB-h\fR \fIlgrplist\fR\fR
137 .ad
138 .RS 15n
139 Lists only the processes homed to the specified \fIlgrplist\fR. Nothing is
140 listed for any invalid group specified in \fIlgrplist\fR.
141 .sp
142 This option is ignored when the \fB-e\fR option is also specified.
143 .RE
145 .sp
146 .ne 2
147 .na
148 \fB\fB-H\fR\fR
149 .ad
150 .RS 15n
151 Prints the home lgroup of the process under an additional column header, LGRP.
152 .RE
154 .sp
155 .ne 2
156 .na
157 \fB\fB-j\fR\fR
158 .ad
159 .RS 15n
160 Prints session \fBID\fR and process group \fBID\fR.
161 .RE
163 .sp
164 .ne 2
165 .na
166 \fB\fB-l\fR\fR
167 .ad
168 .RS 15n
169 Generates a \fBl\fRong listing. (See below.)
170 .RE
172 .sp
173 .ne 2
174 .na
175 \fB\fB-L\fR\fR
176 .ad
177 .RS 15n
178 Prints information about each light weight process (\fIlwp\fR) in each selected
179 process. (See below.)
180 .RE
182 .sp
183 .ne 2
184 .na
185 \fB\fB-n\fR \fInamelist\fR\fR
186 .ad
187 .RS 15n
188 Specifies the name of an alternative system \fInamelist\fR file in place of the
189 default. This option is accepted for compatibility, but is ignored.
190 .RE
192 .sp
193 .ne 2
194 .na
195 \fB\fB-o\fR \fIformat\fR\fR
196 .ad
197 .RS 15n
198 Prints information according to the format specification given in \fIformat\fR.
199 This is fully described in \fBDISPLAY FORMATS\fR. Multiple \fB-o\fR options can
200 be specified; the format specification is interpreted as the
201 space-character-separated concatenation of all the \fIformat\fR
202 option-arguments.
203 .RE
205 .sp
206 .ne 2
207 .na
208 \fB\fB-p\fR \fIproclist\fR\fR
209 .ad
210 .RS 15n
211 Lists only process data whose process \fBID\fR numbers are given in
212 \fIproclist\fR.
213 .sp
214 This option is ignored when the \fB-e\fR option is also specified.
215 .RE
217 .sp
218 .ne 2
219 .na
220 \fB\fB-P\fR\fR
221 .ad
222 .RS 15n
223 Prints the number of the processor to which the process or lwp is bound, if
224 any, under an additional column header, \fBPSR\fR.
225 .RE
227 .sp
228 .ne 2
229 .na
230 \fB\fB-s\fR \fIsidlist\fR\fR
231 .ad
232 .RS 15n
233 Lists information on all session leaders whose \fBID\fRs appear in
234 \fIsidlist\fR.
235 .sp
236 This option is ignored when the \fB-e\fR option is also specified.
237 .RE
239 .sp
240 .ne 2
241 .na
242 \fB\fB-t\fR \fIterm\fR\fR
243 .ad
244 .RS 15n
245 Lists only process data associated with \fIterm\fR. Terminal identifiers are
246 specified as a device file name, and an identifier. For example, \fBterm/a\fR,
247 or \fBpts/0\fR.
248 .sp
249 This option is ignored when the \fB-e\fR option is also specified.
250 .RE
252 .sp
253 .ne 2
254 .na
255 \fB\fB-u\fR \fIuidlist\fR\fR
256 .ad
257 .RS 15n
258 Lists only process data whose effective user \fBID\fR number or login name is
259 given in \fIuidlist\fR. In the listing, the numerical user \fBID\fR is printed
260 unless you give the \fB-f\fR option, which prints the login name.
261 .sp
262 This option is ignored when the \fB-e\fR option is also specified.
263 .RE
265 .sp
266 .ne 2
267 .na
268 \fB\fB-U\fR \fIuidlist\fR\fR
269 .ad
270 .RS 15n
271 Lists information for processes whose real user \fBID\fR numbers or login names
272 are given in \fIuidlist\fR. The \fIuidlist\fR must be a single argument in the
273 form of a blank- or comma-separated list.
274 .sp
275 This option is ignored when the \fB-e\fR option is also specified.
276 .RE
278 .sp
279 .ne 2
280 .na
281 \fB\fB-W\fR\fR
282 .ad
283 .RS 15n
284 Truncate long names even when \fBps\fR would normally print them
285 in full.
286 A trailing asterisk marks a long name that has been truncated
287 to fit the column.
288 .RE
290 .sp
291 .ne 2
292 .na
293 \fB\fB-y\fR\fR
294 .ad
295 .RS 15n
296 Under a long listing (\fB-l\fR), omits the obsolete \fBF\fR and \fBADDR\fR
297 columns and includes an \fBRSS\fR column to report the resident set size of the
298 process. Under the \fB-y\fR option, both \fBRSS\fR and \fBSZ\fR (see below) is
299 reported in units of kilobytes instead of pages.
300 .RE
302 .sp
303 .ne 2
304 .na
305 \fB\fB-z\fR \fIzonelist\fR\fR
306 .ad
307 .RS 15n
308 Lists only processes in the specified zones. Zones can be specified either by
309 name or ID. This option is only useful when executed in the global zone.
310 .sp
311 This option is ignored when the \fB-e\fR option is also specified.
312 .RE
314 .sp
315 .ne 2
316 .na
317 \fB\fB-Z\fR\fR
318 .ad
319 .RS 15n
320 Prints the name of the zone with which the process is associated under an
321 additional column header, \fBZONE\fR. The \fBZONE\fR column width is limited to
322 8 characters. Use \fBps\fR \fB-eZ\fR for a quick way to see information about
323 every process now running along with the associated zone name. Use
324 .sp
325 .in +2
326 .nf
327 ps -eo zone,uid,pid,ppid,time,comm,...
328 .fi
329 .in -2
330 .sp
332 to see zone names wider than 8 characters.
333 .RE
335 .sp
336 .LP
337 Many of the options shown are used to select processes to list. If any are
338 specified, the default list is ignored and \fBps\fR selects the processes
339 represented by the inclusive OR of all the selection-criteria options.
340 .SH DISPLAY FORMATS
341 .LP
342 Under the \fB-f\fR option, \fBps\fR tries to determine the command name and
343 arguments given when the process was created by examining the user block.
344 Failing this, the command name is printed, as it would have appeared without
345 the \fB-f\fR option, in square brackets.
346 .sp
347 .LP
348 The column headings and the meaning of the columns in a \fBps\fR listing are
349 given below; the letters \fBf\fR and \fBl\fR indicate the option (f\fBull\fR or
350 \fBl\fRong, respectively) that causes the corresponding heading to appear;
351 \fBall\fR means that the heading always appears. \fBNote:\fR These two options
352 determine only what information is provided for a process; they do not
353 determine which processes are listed.
354 .sp
355 .ne 2
356 .na
357 \fB\fBF\fR(l)\fR
358 .ad
359 .RS 14n
360 Flags (hexadecimal and additive) associated with the process. These flags are
361 available for historical purposes; no meaning should be currently ascribed to
362 them.
363 .RE
365 .sp
366 .ne 2
367 .na
368 \fB\fBS\fR (l)\fR
369 .ad
370 .RS 14n
371 The state of the process:
372 .sp
373 .ne 2
374 .na
375 \fBO\fR
376 .ad
377 .RS 5n
378 Process is running on a processor.
379 .RE
381 .sp
382 .ne 2
383 .na
384 \fBS\fR
385 .ad
386 .RS 5n
387 Sleeping: process is waiting for an event to complete.
388 .RE
390 .sp
391 .ne 2
392 .na
393 \fBR\fR
394 .ad
395 .RS 5n
396 Runnable: process is on run queue.
397 .RE
399 .sp
400 .ne 2
401 .na
402 \fBT\fR
403 .ad
404 .RS 5n
405 Process is stopped, either by a job control signal or because it is being
406 traced.
407 .RE
409 .sp
410 .ne 2
411 .na
412 \fBW\fR
413 .ad
414 .RS 5n
415 Waiting: process is waiting for CPU usage to drop to the CPU-caps enforced
416 limits.
417 .RE
419 .sp
420 .ne 2
421 .na
422 \fBZ\fR
423 .ad
424 .RS 5n
425 Zombie state: process terminated and parent not waiting.
426 .RE
428 .RE
430 .sp
431 .ne 2
432 .na
433 \fB\fBUID\fR (f,l)\fR
434 .ad
435 .RS 14n
436 The effective user \fBID\fR number of the process (the login name is printed
437 under the \fB-f\fR option).
438 A trailing asterisk marks a long name that has been truncated
439 to fit the column.
440 .RE
442 .sp
443 .ne 2
444 .na
445 \fB\fBPID\fR(all)\fR
446 .ad
447 .RS 14n
448 The process \fBID\fR of the process (this datum is necessary in order to kill a
449 process).
450 .RE
452 .sp
453 .ne 2
454 .na
455 \fB\fBPPID\fR(f,l)\fR
456 .ad
457 .RS 14n
458 The process \fBID\fR of the parent process.
459 .RE
461 .sp
462 .ne 2
463 .na
464 \fB\fBC\fR(f,l)\fR
465 .ad
466 .RS 14n
467 Processor utilization for scheduling (obsolete). Not printed when the \fB-c\fR
468 option is used.
469 .RE
471 .sp
472 .ne 2
473 .na
474 \fB\fBCLS\fR(f,l)\fR
475 .ad
476 .RS 14n
477 Scheduling class. Printed only when the \fB-c\fR option is used.
478 .RE
480 .sp
481 .ne 2
482 .na
483 \fB\fBPRI\fR(l)\fR
484 .ad
485 .RS 14n
486 The priority of the process. Without the \fB-c\fR option, higher numbers mean
487 lower priority. With the \fB-c\fR option, higher numbers mean higher priority.
488 .RE
490 .sp
491 .ne 2
492 .na
493 \fB\fBNI\fR(l)\fR
494 .ad
495 .RS 14n
496 Nice value, used in priority computation. Not printed when the \fB-c\fR option
497 is used. Only processes in the certain scheduling classes have a nice value.
498 .RE
500 .sp
501 .ne 2
502 .na
503 \fB\fBADDR\fR(l)\fR
504 .ad
505 .RS 14n
506 The memory address of the process.
507 .RE
509 .sp
510 .ne 2
511 .na
512 \fB\fBSZ\fR(l)\fR
513 .ad
514 .RS 14n
515 The total size of the process in virtual memory, including all mapped files and
516 devices, in pages. See \fBpagesize\fR(1).
517 .RE
519 .sp
520 .ne 2
521 .na
522 \fB\fBWCHAN\fR(l)\fR
523 .ad
524 .RS 14n
525 The address of an event for which the process is sleeping (if blank, the
526 process is running).
527 .RE
529 .sp
530 .ne 2
531 .na
532 \fB\fBSTIME\fR(f)\fR
533 .ad
534 .RS 14n
535 The starting time of the process, given in hours, minutes, and seconds. (A
536 process begun more than twenty-four hours before the \fBps\fR inquiry is
537 executed is given in months and days.)
538 .RE
540 .sp
541 .ne 2
542 .na
543 \fB\fBTTY\fR(all)\fR
544 .ad
545 .RS 14n
546 The controlling terminal for the process (the message, \fB?\fR, is printed when
547 there is no controlling terminal).
548 .RE
550 .sp
551 .ne 2
552 .na
553 \fB\fBTIME\fR(all)\fR
554 .ad
555 .RS 14n
556 The cumulative execution time for the process.
557 .RE
559 .sp
560 .ne 2
561 .na
562 \fB\fBLTIME\fR(all)\fR
563 .ad
564 .RS 14n
565 The execution time for the lwp being reported.
566 .RE
568 .sp
569 .ne 2
570 .na
571 \fB\fBCMD\fR(all)\fR
572 .ad
573 .RS 14n
574 The command name (the full command name and its arguments, up to a limit of 80
575 characters, are printed under the \fB-f\fR option).
576 .RE
578 .sp
579 .LP
580 The following two additional columns are printed when the \fB-j\fR option is
581 specified:
582 .sp
583 .ne 2
584 .na
585 \fB\fBPGID\fR\fR
586 .ad
587 .RS 8n
588 The process ID of the process group leader.
589 .RE
591 .sp
592 .ne 2
593 .na
594 \fB\fBSID\fR\fR
595 .ad
596 .RS 8n
597 The process ID of the session leader.
598 .RE
600 .sp
601 .LP
602 The following two additional columns are printed when the \fB-L\fR option is
603 specified:
604 .sp
605 .ne 2
606 .na
607 \fB\fBLWP\fR\fR
608 .ad
609 .RS 8n
610 The lwp ID of the lwp being reported.
611 .RE
613 .sp
614 .ne 2
615 .na
616 \fB\fBNLWP\fR\fR
617 .ad
618 .RS 8n
619 The number of lwps in the process (if \fB-f\fR is also specified).
620 .RE
622 .sp
623 .LP
624 Under the \fB-L\fR option, one line is printed for each lwp in the process and
625 the time-reporting fields \fBSTIME\fR and \fBLTIME\fR show the values for the
626 lwp, not the process. A traditional single-threaded process contains only one
627 lwp.
628 .sp
629 .LP
630 A process that has exited and has a parent, but has not yet been waited for by
631 the parent, is marked \fB<defunct>\fR\&.
632 .SS "\fB-o\fR format"
633 .LP
634 The \fB-o\fR option allows the output format to be specified under user
635 control.
636 .sp
637 .LP
638 The format specification must be a list of names presented as a single
639 argument, blank- or comma-separated. Each variable has a default header. The
640 default header can be overridden by appending an equals sign and the new text
641 of the header. The rest of the characters in the argument is used as the header
642 text. The fields specified are written in the order specified on the command
643 line, and should be arranged in columns in the output. The field widths are
644 selected by the system to be at least as wide as the header text (default or
645 overridden value). If the header text is null, such as \fB-o\fR \fIuser=,\fR
646 the field width is at least as wide as the default header text.
647 Long names are not truncated in this mode.
648 If all header text fields are null, no header line is written.
649 .sp
650 .LP
651 The following names are recognized in the POSIX locale:
652 .sp
653 .ne 2
654 .na
655 \fB\fBuser\fR\fR
656 .ad
657 .RS 10n
658 The effective user \fBID\fR of the process. This is the textual user \fBID\fR,
659 if it can be obtained and the field width permits, or a decimal representation
660 otherwise.
661 .RE
663 .sp
664 .ne 2
665 .na
666 \fB\fBruser\fR\fR
667 .ad
668 .RS 10n
669 The real user \fBID\fR of the process. This is the textual user \fBID\fR, if it
670 can be obtained and the field width permits, or a decimal representation
671 otherwise.
672 .RE
674 .sp
675 .ne 2
676 .na
677 \fB\fBgroup\fR\fR
678 .ad
679 .RS 10n
680 The effective group \fBID\fR of the process. This is the textual group
681 \fBID,\fR if it can be obtained and the field width permits, or a decimal
682 representation otherwise.
683 .RE
685 .sp
686 .ne 2
687 .na
688 \fB\fBrgroup\fR\fR
689 .ad
690 .RS 10n
691 The real group \fBID\fR of the process. This is the textual group \fBID,\fR if
692 it can be obtained and the field width permits, or a decimal representation
693 otherwise.
694 .RE
696 .sp
697 .ne 2
698 .na
699 \fB\fBpid\fR\fR
700 .ad
701 .RS 10n
702 The decimal value of the process \fBID\fR.
703 .RE
705 .sp
706 .ne 2
707 .na
708 \fB\fBppid\fR\fR
709 .ad
710 .RS 10n
711 The decimal value of the parent process \fBID\fR.
712 .RE
714 .sp
715 .ne 2
716 .na
717 \fB\fBpgid\fR\fR
718 .ad
719 .RS 10n
720 The decimal value of the process group \fBID.\fR
721 .RE
723 .sp
724 .ne 2
725 .na
726 \fB\fBpcpu\fR\fR
727 .ad
728 .RS 10n
729 The ratio of CPU time used recently to CPU time available in the same period,
730 expressed as a percentage. The meaning of ``recently'' in this context is
731 unspecified. The CPU time available is determined in an unspecified manner.
732 .RE
734 .sp
735 .ne 2
736 .na
737 \fB\fBvsz\fR\fR
738 .ad
739 .RS 10n
740 The total size of the process in virtual memory, in kilobytes.
741 .RE
743 .sp
744 .ne 2
745 .na
746 \fB\fBnice\fR\fR
747 .ad
748 .RS 10n
749 The decimal value of the system scheduling priority of the process. See
750 \fBnice\fR(1).
751 .RE
753 .sp
754 .ne 2
755 .na
756 \fB\fBetime\fR\fR
757 .ad
758 .RS 10n
759 In the POSIX locale, the elapsed time since the process was started, in the
760 form:
761 .sp
762 \fB[[\fR\fIdd\fR-\fB]\fR\fIhh\fR:\fB]\fR\fImm\fR:\fIss\fR
763 .sp
764 where
765 .sp
766 .ne 2
767 .na
768 \fB\fIdd\fR\fR
769 .ad
770 .RS 6n
771 is the number of days
772 .RE
774 .sp
775 .ne 2
776 .na
777 \fB\fIhh\fR\fR
778 .ad
779 .RS 6n
780 is the number of hours
781 .RE
783 .sp
784 .ne 2
785 .na
786 \fB\fImm\fR\fR
787 .ad
788 .RS 6n
789 is the number of minutes
790 .RE
792 .sp
793 .ne 2
794 .na
795 \fB\fIss\fR\fR
796 .ad
797 .RS 6n
798 is the number of seconds
799 .RE
801 The \fIdd\fR field is a decimal integer. The \fIhh\fR, \fImm\fR and \fIss\fR
802 fields is two-digit decimal integers padded on the left with zeros.
803 .RE
805 .sp
806 .ne 2
807 .na
808 \fB\fBtime\fR\fR
809 .ad
810 .RS 10n
811 In the POSIX locale, the cumulative CPU time of the process in the form:
812 .sp
813 \fB[\fR\fIdd\fR-\fB]\fR\fIhh\fR:\fImm\fR:\fIss\fR
814 .sp
815 The \fIdd\fR, \fIhh\fR, \fImm\fR, and \fIss\fR fields is as described in the
816 \fBetime\fR specifier.
817 .RE
819 .sp
820 .ne 2
821 .na
822 \fB\fBtty\fR\fR
823 .ad
824 .RS 10n
825 The name of the controlling terminal of the process (if any) in the same format
826 used by the \fBwho\fR(1) command.
827 .RE
829 .sp
830 .ne 2
831 .na
832 \fB\fBcomm\fR\fR
833 .ad
834 .RS 10n
835 The name of the command being executed (\fBargv[0]\fR value) as a string.
836 .RE
838 .sp
839 .ne 2
840 .na
841 \fB\fBargs\fR\fR
842 .ad
843 .RS 10n
844 The command with all its arguments as a string. The implementation might
845 truncate this value to the field width; it is implementation-dependent whether
846 any further truncation occurs. It is unspecified whether the string represented
847 is a version of the argument list as it was passed to the command when it
848 started, or is a version of the arguments as they might have been modified by
849 the application. Applications cannot depend on being able to modify their
850 argument list and having that modification be reflected in the output of
851 \fBps\fR. The Solaris implementation limits the string to 80 bytes; the string
852 is the version of the argument list as it was passed to the command when it
853 started.
854 .RE
856 .sp
857 .LP
858 The following names are recognized in the Solaris implementation:
859 .sp
860 .ne 2
861 .na
862 \fB\fBf\fR\fR
863 .ad
864 .RS 11n
865 Flags (hexadecimal and additive) associated with the process.
866 .RE
868 .sp
869 .ne 2
870 .na
871 \fB\fBs\fR\fR
872 .ad
873 .RS 11n
874 The state of the process.
875 .RE
877 .sp
878 .ne 2
879 .na
880 \fB\fBc\fR\fR
881 .ad
882 .RS 11n
883 Processor utilization for scheduling (obsolete).
884 .RE
886 .sp
887 .ne 2
888 .na
889 \fB\fBuid\fR\fR
890 .ad
891 .RS 11n
892 The effective user \fBID\fR number of the process as a decimal integer.
893 .RE
895 .sp
896 .ne 2
897 .na
898 \fB\fBruid\fR\fR
899 .ad
900 .RS 11n
901 The real user \fBID\fR number of the process as a decimal integer.
902 .RE
904 .sp
905 .ne 2
906 .na
907 \fB\fBgid\fR\fR
908 .ad
909 .RS 11n
910 The effective group \fBID\fR number of the process as a decimal integer.
911 .RE
913 .sp
914 .ne 2
915 .na
916 \fB\fBrgid\fR\fR
917 .ad
918 .RS 11n
919 The real group \fBID\fR number of the process as a decimal integer.
920 .RE
922 .sp
923 .ne 2
924 .na
925 \fB\fBprojid\fR\fR
926 .ad
927 .RS 11n
928 The project \fBID\fR number of the process as a decimal integer.
929 .RE
931 .sp
932 .ne 2
933 .na
934 \fB\fBproject\fR\fR
935 .ad
936 .RS 11n
937 The project \fBID\fR of the process as a textual value if that value can be
938 obtained; otherwise, as a decimal integer.
939 .RE
941 .sp
942 .ne 2
943 .na
944 \fB\fBzoneid\fR\fR
945 .ad
946 .RS 11n
947 The zone \fBID\fR number of the process as a decimal integer.
948 .RE
950 .sp
951 .ne 2
952 .na
953 \fB\fBzone\fR\fR
954 .ad
955 .RS 11n
956 The zone \fBID\fR of the process as a textual value if that value can be
957 obtained; otherwise, as a decimal integer.
958 .RE
960 .sp
961 .ne 2
962 .na
963 \fB\fBsid\fR\fR
964 .ad
965 .RS 11n
966 The process ID of the session leader.
967 .RE
969 .sp
970 .ne 2
971 .na
972 \fB\fBtaskid\fR\fR
973 .ad
974 .RS 11n
975 The task \fBID\fR of the process.
976 .RE
978 .sp
979 .ne 2
980 .na
981 \fB\fBclass\fR\fR
982 .ad
983 .RS 11n
984 The scheduling class of the process.
985 .RE
987 .sp
988 .ne 2
989 .na
990 \fB\fBpri\fR\fR
991 .ad
992 .RS 11n
993 The priority of the process. Higher numbers mean higher priority.
994 .RE
996 .sp
997 .ne 2
998 .na
999 \fB\fBopri\fR\fR
1000 .ad
1001 .RS 11n
1002 The obsolete priority of the process. Lower numbers mean higher priority.
1003 .RE
1005 .sp
1006 .ne 2
1007 .na
1008 \fB\fBlwp\fR\fR
1009 .ad
1010 .RS 11n
1011 The decimal value of the lwp \fBID\fR. Requesting this formatting option causes
1012 one line to be printed for each lwp in the process.
1013 .RE
1015 .sp
1016 .ne 2
1017 .na
1018 \fB\fBnlwp\fR\fR
1019 .ad
1020 .RS 11n
1021 The number of lwps in the process.
1022 .RE
1024 .sp
1025 .ne 2
1026 .na
1027 \fB\fBpsr\fR\fR
1028 .ad
1029 .RS 11n
1030 The number of the processor to which the process or lwp is bound.
1031 .RE
1033 .sp
1034 .ne 2
1035 .na
1036 \fB\fBpset\fR\fR
1037 .ad
1038 .RS 11n
1039 The \fBID\fR of the processor set to which the process or lwp is bound.
1040 .RE
1042 .sp
1043 .ne 2
1044 .na
1045 \fB\fBaddr\fR\fR
1046 .ad
1047 .RS 11n
1048 The memory address of the process.
1049 .RE
1051 .sp
1052 .ne 2
1053 .na
1054 \fB\fBosz\fR\fR
1055 .ad
1056 .RS 11n
1057 The total size of the process in virtual memory, in pages.
1058 .RE
1060 .sp
1061 .ne 2
1062 .na
1063 \fB\fBwchan\fR\fR
1064 .ad
1065 .RS 11n
1066 The address of an event for which the process is sleeping (if \(mi, the process
1067 is running).
1068 .RE
1070 .sp
1071 .ne 2
1072 .na
1073 \fB\fBstime\fR\fR
1074 .ad
1075 .RS 11n
1076 The starting time or date of the process, printed with no blanks.
1077 .RE
1079 .sp
1080 .ne 2
1081 .na
1082 \fB\fBrss\fR\fR
1083 .ad
1084 .RS 11n
1085 The resident set size of the process, in kilobytes. The \fBrss\fR value
1086 reported by \fBps\fR is an estimate provided by \fBproc\fR(4) that might
1087 underestimate the actual resident set size. Users who wish to get more accurate
1088 usage information for capacity planning should use \fBpmap\fR(1) \fB-x\fR
1089 instead.
1090 .RE
1092 .sp
1093 .ne 2
1094 .na
1095 \fB\fBpmem\fR\fR
1096 .ad
1097 .RS 11n
1098 The ratio of the process's resident set size to the physical memory on the
1099 machine, expressed as a percentage.
1100 .RE
1102 .sp
1103 .ne 2
1104 .na
1105 \fB\fBfname\fR\fR
1106 .ad
1107 .RS 11n
1108 The first 8 bytes of the base name of the process's executable file.
1109 .RE
1111 .sp
1112 .ne 2
1113 .na
1114 \fB\fBctid\fR\fR
1115 .ad
1116 .RS 11n
1117 The contract ID of the process contract the process is a member of as a decimal
1118 integer.
1119 .RE
1121 .sp
1122 .ne 2
1123 .na
1124 \fB\fBlgrp\fR\fR
1125 .ad
1126 .RS 11n
1127 The home lgroup of the process.
1128 .RE
1130 .sp
1131 .ne 2
1132 .na
1133 \fB\fBdmodel\fR\fR
1134 .ad
1135 .RS 11n
1136 The data model of the process, printed in the same manner as via
1137 \fBpflags\fR(1). The currently supported data models are _ILP32 and _LP64.
1138 .RE
1140 .sp
1141 .LP
1142 Only \fBcomm\fR and \fBargs\fR are allowed to contain blank characters; all
1143 others, including the Solaris implementation variables, are not.
1144 .sp
1145 .LP
1146 The following table specifies the default header to be used in the POSIX locale
1147 corresponding to each format specifier.
1148 .sp
1150 .sp
1151 .TS
1152 box;
1153 c c c c
1154 c c c c .
1155 Format Default Format Default
1156 Specifier Header Specifier Header
1157 _
1158 args COMMAND ppid PPID
1159 comm COMMAND rgroup RGROUP
1160 etime ELAPSED ruser RUSER
1161 group GROUP time TIME
1162 nice NI tty TT
1163 pcpu %CPU user USER
1164 pgid PGID vsz VSZ
1165 pid PID
1166 .TE
1168 .sp
1169 .LP
1170 The following table lists the Solaris implementation format specifiers and the
1171 default header used with each.
1172 .sp
1174 .sp
1175 .TS
1176 box;
1177 c c c c
1178 c c c c .
1179 Format Default Format Default
1180 Specifier Header Specifier Header
1181 _
1182 addr ADDR projid PROJID
1183 c C project PROJECT
1184 class CLS psr PSR
1185 f F rgid RGID
1186 fname COMMAND rss RSS
1187 gid GID ruid RUID
1188 lgrp LGRP s S
1189 lwp LWP sid SID
1190 nlwp NLWP stime STIME
1191 opri PRI taskid TASKID
1192 osz SZ uid UID
1193 pmem %MEM wchan WCHAN
1194 pri PRI zone ZONE
1195 ctid CTID zoneid ZONEID
1196 .TE
1198 .SH EXAMPLES
1199 .LP
1200 \fBExample 1 \fRUsing \fBps\fR Command
1201 .sp
1202 .LP
1203 The command:
1205 .sp
1206 .in +2
1207 .nf
1208 example% \fBps -o user,pid,ppid=MOM -o args\fR
1209 .fi
1210 .in -2
1211 .sp
1213 .sp
1214 .LP
1215 writes the following in the POSIX locale:
1217 .sp
1218 .in +2
1219 .nf
1220 USER PID MOM COMMAND
1221 helene 34 12 ps -o uid,pid,ppid=MOM -o args
1222 .fi
1223 .in -2
1224 .sp
1226 .sp
1227 .LP
1228 The contents of the \fBCOMMAND\fR field need not be the same due to possible
1229 truncation.
1231 .SH ENVIRONMENT VARIABLES
1232 .LP
1233 See \fBenviron\fR(5) for descriptions of the following environment variables
1234 that affect the execution of \fBps\fR: \fBLANG\fR, \fBLC_ALL\fR,
1235 \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, \fBLC_TIME\fR, and \fBNLSPATH\fR.
1236 .sp
1237 .ne 2
1238 .na
1239 \fB\fBCOLUMNS\fR\fR
1240 .ad
1241 .RS 11n
1242 Override the system-selected horizontal screen size, used to determine the
1243 number of text columns to display.
1244 .RE
1246 .SH EXIT STATUS
1247 .LP
1248 The following exit values are returned:
1249 .sp
1250 .ne 2
1251 .na
1252 \fB\fB0\fR\fR
1253 .ad
1254 .RS 6n
1255 Successful completion.
1256 .RE
1258 .sp
1259 .ne 2
1260 .na
1261 \fB\fB>0\fR\fR
1262 .ad
1263 .RS 6n
1264 An error occurred.
1265 .RE
1267 .SH FILES
1268 .ne 2
1269 .na
1270 \fB\fB/dev/pts/*\fR\fR
1271 .ad
1272 .RS 15n
1274 .RE
1276 .sp
1277 .ne 2
1278 .na
1279 \fB\fB/dev/term/*\fR\fR
1280 .ad
1281 .RS 15n
1282 terminal (``tty'') names searcher files
1283 .RE
1285 .sp
1286 .ne 2
1287 .na
1288 \fB\fB/etc/passwd\fR\fR
1289 .ad
1290 .RS 15n
1291 \fBUID\fR information supplier
1292 .RE
1294 .sp
1295 .ne 2
1296 .na
1297 \fB\fB/proc/*\fR\fR
1298 .ad
1299 .RS 15n
1300 process control files
1301 .RE
1303 .SH ATTRIBUTES
1304 .LP
1305 See \fBattributes\fR(5) for descriptions of the following attributes:
1306 .sp
1308 .sp
1309 .TS
1310 box;
1311 c | c
1312 l | l .
1313 ATTRIBUTE TYPE ATTRIBUTE VALUE
1314 _
1315 CSI Enabled (see USAGE)
1316 _
1317 Interface Stability Committed
1318 _
1319 Standard See \fBstandards\fR(5).
1320 .TE
1322 .SH SEE ALSO
1323 .LP
1324 \fBkill\fR(1), \fBlgrpinfo\fR(1), \fBnice\fR(1), \fBpagesize\fR(1),
1325 \fBpmap\fR(1), \fBpriocntl\fR(1), \fBwho\fR(1), \fBgetty\fR(1M), \fBproc\fR(4),
1326 \fBttysrch\fR(4), \fBattributes\fR(5), \fBenviron\fR(5),
1327 \fBresource_controls\fR(5), \fBstandards\fR(5), \fBzones\fR(5)
1328 .SH NOTES
1329 .LP
1330 Things can change while \fBps\fR is running. The snapshot it gives is true only
1331 for a split-second, and it might not be accurate by the time you see it. Some
1332 data printed for defunct processes is irrelevant.
1333 .sp
1334 .LP
1335 If no options to select processes are specified, \fBps\fR reports all processes
1336 associated with the controlling terminal. If there is no controlling terminal,
1337 there is no report other than the header.
1338 .sp
1339 .LP
1340 \fBps\fR \fB-ef\fR or \fBps\fR \fB-o\fR \fBstime\fR might not report the actual
1341 start of a tty login session, but rather an earlier time, when a getty was last
1342 respawned on the tty line.
1343 .sp
1344 .LP
1345 \fBps\fR is \fBCSI\fR-enabled except for login names (usernames).