1 '\" te
2 .\" Copyright 1989 AT&T
3 .\" Copyright (c) 2009, Sun Microsystems, Inc. All Rights Reserved
4 .\" Copyright (c) 2012, Joyent, Inc. All Rights Reserved
5 .\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved
6 .\" 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/.
7 .\" 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
8 .\" 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
9 .\" 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.
10 .\" This notice shall appear on any product containing this material.
11 .\" 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.
12 .\" 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
13 .\" the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
14 .TH PS 1 "Aug 16, 2009"
15 .SH NAME
16 ps \- report process status
17 .SH SYNOPSIS
18 .LP
19 .nf
20 \fBps\fR [\fB-aAcdefjHlLPyZ\fR] [\fB-g\fR \fIgrplist\fR] [\fB-h\fR \fIlgrplist\fR]
21 [\fB-n\fR \fInamelist\fR] [\fB-o\fR \fIformat\fR]... [\fB-p\fR \fIproclist\fR]
22 [\fB-s\fR \fIsidlist\fR] [\fB-t\fR \fIterm\fR] [\fB-u\fR \fIuidlist\fR] [\fB-U\fR \fIuidlist\fR]
23 [\fB-G\fR \fIgidlist\fR] [\fB-z\fR \fIzonelist\fR]
24 .fi
25
26 .SH DESCRIPTION
27 .sp
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
244 .RS 15n
245 Lists only process data whose effective user \fBID\fR number or login name is
246 given in \fIuidlist\fR. In the listing, the numerical user \fBID\fR is printed
247 unless you give the \fB-f\fR option, which prints the login name.
248 .RE
249
250 .sp
251 .ne 2
252 .na
253 \fB\fB-U\fR \fIuidlist\fR\fR
254 .ad
255 .RS 15n
256 Lists information for processes whose real user \fBID\fR numbers or login names
257 are given in \fIuidlist\fR. The \fIuidlist\fR must be a single argument in the
258 form of a blank- or comma-separated list.
259 .RE
260
261 .sp
262 .ne 2
263 .na
264 \fB\fB-y\fR\fR
265 .ad
266 .RS 15n
267 Under a long listing (\fB-l\fR), omits the obsolete \fBF\fR and \fBADDR\fR
268 columns and includes an \fBRSS\fR column to report the resident set size of the
269 process. Under the \fB-y\fR option, both \fBRSS\fR and \fBSZ\fR (see below) is
270 reported in units of kilobytes instead of pages.
271 .RE
272
273 .sp
274 .ne 2
275 .na
276 \fB\fB-z\fR \fIzonelist\fR\fR
277 .ad
278 .RS 15n
279 Lists only processes in the specified zones. Zones can be specified either by
280 name or ID. This option is only useful when executed in the global zone.
281 .RE
282
283 .sp
388
389 .sp
390 .ne 2
391 .na
392 \fBZ\fR
393 .ad
394 .RS 5n
395 Zombie state: process terminated and parent not waiting.
396 .RE
397
398 .RE
399
400 .sp
401 .ne 2
402 .na
403 \fB\fBUID\fR (f,l)\fR
404 .ad
405 .RS 14n
406 The effective user \fBID\fR number of the process (the login name is printed
407 under the \fB-f\fR option).
408 .RE
409
410 .sp
411 .ne 2
412 .na
413 \fB\fBPID\fR(all)\fR
414 .ad
415 .RS 14n
416 The process \fBID\fR of the process (this datum is necessary in order to kill a
417 process).
418 .RE
419
420 .sp
421 .ne 2
422 .na
423 \fB\fBPPID\fR(f,l)\fR
424 .ad
425 .RS 14n
426 The process \fBID\fR of the parent process.
427 .RE
595 lwp.
596 .sp
597 .LP
598 A process that has exited and has a parent, but has not yet been waited for by
599 the parent, is marked \fB<defunct>\fR\&.
600 .SS "\fB-o\fR format"
601 .sp
602 .LP
603 The \fB-o\fR option allows the output format to be specified under user
604 control.
605 .sp
606 .LP
607 The format specification must be a list of names presented as a single
608 argument, blank- or comma-separated. Each variable has a default header. The
609 default header can be overridden by appending an equals sign and the new text
610 of the header. The rest of the characters in the argument is used as the header
611 text. The fields specified are written in the order specified on the command
612 line, and should be arranged in columns in the output. The field widths are
613 selected by the system to be at least as wide as the header text (default or
614 overridden value). If the header text is null, such as \fB-o\fR \fIuser=,\fR
615 the field width is at least as wide as the default header text. If all header
616 text fields are null, no header line is written.
617 .sp
618 .LP
619 The following names are recognized in the POSIX locale:
620 .sp
621 .ne 2
622 .na
623 \fB\fBuser\fR\fR
624 .ad
625 .RS 10n
626 The effective user \fBID\fR of the process. This is the textual user \fBID\fR,
627 if it can be obtained and the field width permits, or a decimal representation
628 otherwise.
629 .RE
630
631 .sp
632 .ne 2
633 .na
634 \fB\fBruser\fR\fR
635 .ad
636 .RS 10n
|
1 '\" te
2 .\" Copyright 1989 AT&T
3 .\" Copyright (c) 2009, Sun Microsystems, Inc. All Rights Reserved
4 .\" Copyright (c) 2012, Joyent, Inc. All Rights Reserved
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 "Apr 16, 2013"
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
26
27 .SH DESCRIPTION
28 .sp
29 .LP
30 The \fBps\fR command prints information about active processes. Without
31 options, \fBps\fR prints information about processes that have the same
32 effective user \fBID\fR and the same controlling terminal as the invoker. The
33 output contains only the process \fBID\fR, terminal identifier, cumulative
34 execution time, and the command name. Otherwise, the information that is
35 displayed is controlled by the options.
36 .sp
37 .LP
38 Some options accept lists as arguments. Items in a list can be either separated
39 by commas or else enclosed in quotes and separated by commas or spaces. Values
40 for \fIproclist\fR and \fIgrplist\fR must be numeric.
41 .SH OPTIONS
245 .RS 15n
246 Lists only process data whose effective user \fBID\fR number or login name is
247 given in \fIuidlist\fR. In the listing, the numerical user \fBID\fR is printed
248 unless you give the \fB-f\fR option, which prints the login name.
249 .RE
250
251 .sp
252 .ne 2
253 .na
254 \fB\fB-U\fR \fIuidlist\fR\fR
255 .ad
256 .RS 15n
257 Lists information for processes whose real user \fBID\fR numbers or login names
258 are given in \fIuidlist\fR. The \fIuidlist\fR must be a single argument in the
259 form of a blank- or comma-separated list.
260 .RE
261
262 .sp
263 .ne 2
264 .na
265 \fB\fB-W\fR\fR
266 .ad
267 .RS 15n
268 Truncate long names even when \fBps\fR would normally print them
269 in full.
270 A trailing asterisk marks a long name that has been truncated
271 to fit the column.
272 .RE
273
274 .sp
275 .ne 2
276 .na
277 \fB\fB-y\fR\fR
278 .ad
279 .RS 15n
280 Under a long listing (\fB-l\fR), omits the obsolete \fBF\fR and \fBADDR\fR
281 columns and includes an \fBRSS\fR column to report the resident set size of the
282 process. Under the \fB-y\fR option, both \fBRSS\fR and \fBSZ\fR (see below) is
283 reported in units of kilobytes instead of pages.
284 .RE
285
286 .sp
287 .ne 2
288 .na
289 \fB\fB-z\fR \fIzonelist\fR\fR
290 .ad
291 .RS 15n
292 Lists only processes in the specified zones. Zones can be specified either by
293 name or ID. This option is only useful when executed in the global zone.
294 .RE
295
296 .sp
401
402 .sp
403 .ne 2
404 .na
405 \fBZ\fR
406 .ad
407 .RS 5n
408 Zombie state: process terminated and parent not waiting.
409 .RE
410
411 .RE
412
413 .sp
414 .ne 2
415 .na
416 \fB\fBUID\fR (f,l)\fR
417 .ad
418 .RS 14n
419 The effective user \fBID\fR number of the process (the login name is printed
420 under the \fB-f\fR option).
421 A trailing asterisk marks a long name that has been truncated
422 to fit the column.
423 .RE
424
425 .sp
426 .ne 2
427 .na
428 \fB\fBPID\fR(all)\fR
429 .ad
430 .RS 14n
431 The process \fBID\fR of the process (this datum is necessary in order to kill a
432 process).
433 .RE
434
435 .sp
436 .ne 2
437 .na
438 \fB\fBPPID\fR(f,l)\fR
439 .ad
440 .RS 14n
441 The process \fBID\fR of the parent process.
442 .RE
610 lwp.
611 .sp
612 .LP
613 A process that has exited and has a parent, but has not yet been waited for by
614 the parent, is marked \fB<defunct>\fR\&.
615 .SS "\fB-o\fR format"
616 .sp
617 .LP
618 The \fB-o\fR option allows the output format to be specified under user
619 control.
620 .sp
621 .LP
622 The format specification must be a list of names presented as a single
623 argument, blank- or comma-separated. Each variable has a default header. The
624 default header can be overridden by appending an equals sign and the new text
625 of the header. The rest of the characters in the argument is used as the header
626 text. The fields specified are written in the order specified on the command
627 line, and should be arranged in columns in the output. The field widths are
628 selected by the system to be at least as wide as the header text (default or
629 overridden value). If the header text is null, such as \fB-o\fR \fIuser=,\fR
630 the field width is at least as wide as the default header text.
631 Long names are not truncated in this mode.
632 If all header text fields are null, no header line is written.
633 .sp
634 .LP
635 The following names are recognized in the POSIX locale:
636 .sp
637 .ne 2
638 .na
639 \fB\fBuser\fR\fR
640 .ad
641 .RS 10n
642 The effective user \fBID\fR of the process. This is the textual user \fBID\fR,
643 if it can be obtained and the field width permits, or a decimal representation
644 otherwise.
645 .RE
646
647 .sp
648 .ne 2
649 .na
650 \fB\fBruser\fR\fR
651 .ad
652 .RS 10n
|