2005-01-10 08:39:26 +00:00
|
|
|
.\"-
|
1994-05-26 06:18:55 +00:00
|
|
|
.\" Copyright (c) 1980, 1990, 1991, 1993, 1994
|
|
|
|
.\" The Regents of the University of California. All rights reserved.
|
|
|
|
.\"
|
|
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
|
|
.\" modification, are permitted provided that the following conditions
|
|
|
|
.\" are met:
|
|
|
|
.\" 1. Redistributions of source code must retain the above copyright
|
|
|
|
.\" notice, this list of conditions and the following disclaimer.
|
|
|
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
|
|
|
.\" notice, this list of conditions and the following disclaimer in the
|
|
|
|
.\" documentation and/or other materials provided with the distribution.
|
|
|
|
.\" 4. Neither the name of the University nor the names of its contributors
|
|
|
|
.\" may be used to endorse or promote products derived from this software
|
|
|
|
.\" without specific prior written permission.
|
|
|
|
.\"
|
|
|
|
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
|
|
|
|
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
|
|
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
|
|
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
|
|
|
|
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
|
|
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
|
|
|
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
|
|
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
|
|
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
|
|
|
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
|
|
|
.\" SUCH DAMAGE.
|
|
|
|
.\"
|
|
|
|
.\" @(#)ps.1 8.3 (Berkeley) 4/18/94
|
1999-08-27 23:15:48 +00:00
|
|
|
.\" $FreeBSD$
|
1994-05-26 06:18:55 +00:00
|
|
|
.\"
|
2004-03-27 18:26:40 +00:00
|
|
|
.Dd March 27, 2004
|
1994-05-26 06:18:55 +00:00
|
|
|
.Dt PS 1
|
2001-07-10 10:04:09 +00:00
|
|
|
.Os
|
1994-05-26 06:18:55 +00:00
|
|
|
.Sh NAME
|
1998-05-15 06:30:58 +00:00
|
|
|
.Nm ps
|
1994-05-26 06:18:55 +00:00
|
|
|
.Nd process status
|
|
|
|
.Sh SYNOPSIS
|
2000-11-20 11:39:41 +00:00
|
|
|
.Nm
|
Support more POSIX/SUSv3 options:
- Change `-p' to allow a list of process IDs, and `-t' to allow a list
of terminal names, instead of only a single value for each.
- Add the `-A' option of SUSv3, which is exactly the same as `-ax'.
- Add the `-G gidlist' (group id).
- Allow any of these "selector options" to be specified multiple times,
and have `ps' keep adding to a given list -- instead of replacing the
previously-specified values.
- Fix interactions between selector-options, so that: "If any are
specified, ... ps shall select the processes represented by the
inclusive OR of all the selection-criteria options." (from SUSv3)
- Add a `-X' option, which is the reverse of the `-x' option.
- various minor improvements in parsing and error handling.
This does not get us to match POSIX/SUSv3, but it gets us closer. The
`-g pgidlist', `-R ruserlist' and `-s sidlist' options mentioned in
freebsd-standards are still under debate, so they skipped for now.
It should be true that this introduces no user-visible incompatible
changes, except to support "new stuff" that was not supported before.
2004-03-27 18:22:17 +00:00
|
|
|
.Op Fl aCcefHhjlmrSTuvwXxZ
|
2004-05-16 21:35:05 +00:00
|
|
|
.Op Fl G Ar gid Ns Op , Ns Ar gid Ns Ar ...
|
1994-05-26 06:18:55 +00:00
|
|
|
.Op Fl M Ar core
|
|
|
|
.Op Fl N Ar system
|
|
|
|
.Op Fl O Ar fmt
|
|
|
|
.Op Fl o Ar fmt
|
2004-05-16 21:35:05 +00:00
|
|
|
.Op Fl p Ar pid Ns Op , Ns Ar pid Ns Ar ...
|
|
|
|
.Op Fl t Ar tty Ns Op , Ns Ar tty Ns Ar ...
|
|
|
|
.Op Fl U Ar username Ns Op , Ns Ar username Ns Ar ...
|
2000-11-20 11:39:41 +00:00
|
|
|
.Nm
|
1994-05-26 06:18:55 +00:00
|
|
|
.Op Fl L
|
|
|
|
.Sh DESCRIPTION
|
2002-04-16 20:08:06 +00:00
|
|
|
The
|
|
|
|
.Nm
|
|
|
|
utility
|
2004-03-31 23:51:12 +00:00
|
|
|
displays a header line, followed by lines containing information about
|
|
|
|
all of your
|
1994-05-26 06:18:55 +00:00
|
|
|
processes that have controlling terminals.
|
|
|
|
.Pp
|
Support more POSIX/SUSv3 options:
- Change `-p' to allow a list of process IDs, and `-t' to allow a list
of terminal names, instead of only a single value for each.
- Add the `-A' option of SUSv3, which is exactly the same as `-ax'.
- Add the `-G gidlist' (group id).
- Allow any of these "selector options" to be specified multiple times,
and have `ps' keep adding to a given list -- instead of replacing the
previously-specified values.
- Fix interactions between selector-options, so that: "If any are
specified, ... ps shall select the processes represented by the
inclusive OR of all the selection-criteria options." (from SUSv3)
- Add a `-X' option, which is the reverse of the `-x' option.
- various minor improvements in parsing and error handling.
This does not get us to match POSIX/SUSv3, but it gets us closer. The
`-g pgidlist', `-R ruserlist' and `-s sidlist' options mentioned in
freebsd-standards are still under debate, so they skipped for now.
It should be true that this introduces no user-visible incompatible
changes, except to support "new stuff" that was not supported before.
2004-03-27 18:22:17 +00:00
|
|
|
A different set of processes can be selected for display by using any
|
|
|
|
combination of the
|
2004-05-16 21:35:05 +00:00
|
|
|
.Fl a , G , p , T , t ,
|
Support more POSIX/SUSv3 options:
- Change `-p' to allow a list of process IDs, and `-t' to allow a list
of terminal names, instead of only a single value for each.
- Add the `-A' option of SUSv3, which is exactly the same as `-ax'.
- Add the `-G gidlist' (group id).
- Allow any of these "selector options" to be specified multiple times,
and have `ps' keep adding to a given list -- instead of replacing the
previously-specified values.
- Fix interactions between selector-options, so that: "If any are
specified, ... ps shall select the processes represented by the
inclusive OR of all the selection-criteria options." (from SUSv3)
- Add a `-X' option, which is the reverse of the `-x' option.
- various minor improvements in parsing and error handling.
This does not get us to match POSIX/SUSv3, but it gets us closer. The
`-g pgidlist', `-R ruserlist' and `-s sidlist' options mentioned in
freebsd-standards are still under debate, so they skipped for now.
It should be true that this introduces no user-visible incompatible
changes, except to support "new stuff" that was not supported before.
2004-03-27 18:22:17 +00:00
|
|
|
and
|
|
|
|
.Fl U
|
|
|
|
options.
|
|
|
|
If more than one of these options are given, then
|
|
|
|
.Nm
|
|
|
|
will select all processes which are matched by at least one of the
|
|
|
|
given options.
|
|
|
|
.Pp
|
2004-03-31 23:51:12 +00:00
|
|
|
For the processes which have been selected for display,
|
|
|
|
.Nm
|
|
|
|
will usually display one line per process.
|
|
|
|
The
|
|
|
|
.Fl H
|
|
|
|
option may result in multiple output lines (one line per thread) for
|
|
|
|
some processes.
|
|
|
|
By default all of these output lines are sorted first by controlling
|
2004-05-16 21:35:05 +00:00
|
|
|
terminal, then by process ID.
|
2004-03-31 23:51:12 +00:00
|
|
|
The
|
2004-04-01 13:28:36 +00:00
|
|
|
.Fl m , r , u ,
|
2004-03-31 23:51:12 +00:00
|
|
|
and
|
|
|
|
.Fl v
|
|
|
|
options will change the sort order.
|
|
|
|
If more than one sorting option was given, then the selected processes
|
|
|
|
will be sorted by the last sorting option which was specified.
|
|
|
|
.Pp
|
Support more POSIX/SUSv3 options:
- Change `-p' to allow a list of process IDs, and `-t' to allow a list
of terminal names, instead of only a single value for each.
- Add the `-A' option of SUSv3, which is exactly the same as `-ax'.
- Add the `-G gidlist' (group id).
- Allow any of these "selector options" to be specified multiple times,
and have `ps' keep adding to a given list -- instead of replacing the
previously-specified values.
- Fix interactions between selector-options, so that: "If any are
specified, ... ps shall select the processes represented by the
inclusive OR of all the selection-criteria options." (from SUSv3)
- Add a `-X' option, which is the reverse of the `-x' option.
- various minor improvements in parsing and error handling.
This does not get us to match POSIX/SUSv3, but it gets us closer. The
`-g pgidlist', `-R ruserlist' and `-s sidlist' options mentioned in
freebsd-standards are still under debate, so they skipped for now.
It should be true that this introduces no user-visible incompatible
changes, except to support "new stuff" that was not supported before.
2004-03-27 18:22:17 +00:00
|
|
|
For the processes which have been selected for display, the information
|
|
|
|
to display is selected based on a set of keywords (see the
|
2004-05-16 21:35:05 +00:00
|
|
|
.Fl L , O ,
|
1994-05-26 06:18:55 +00:00
|
|
|
and
|
|
|
|
.Fl o
|
|
|
|
options).
|
2004-05-16 21:35:05 +00:00
|
|
|
The default output format includes, for each process, the process' ID,
|
|
|
|
controlling terminal, CPU time (including both user and system time),
|
1994-05-26 06:18:55 +00:00
|
|
|
state, and associated command.
|
|
|
|
.Pp
|
2002-08-21 17:32:44 +00:00
|
|
|
The process file system (see
|
1999-05-08 10:22:15 +00:00
|
|
|
.Xr procfs 5 )
|
|
|
|
should be mounted when
|
1995-12-30 13:52:02 +00:00
|
|
|
.Nm
|
|
|
|
is executed, otherwise not all information will be available.
|
|
|
|
.Pp
|
1994-05-26 06:18:55 +00:00
|
|
|
The options are as follows:
|
|
|
|
.Bl -tag -width indent
|
|
|
|
.It Fl a
|
|
|
|
Display information about other users' processes as well as your own.
|
Support more POSIX/SUSv3 options:
- Change `-p' to allow a list of process IDs, and `-t' to allow a list
of terminal names, instead of only a single value for each.
- Add the `-A' option of SUSv3, which is exactly the same as `-ax'.
- Add the `-G gidlist' (group id).
- Allow any of these "selector options" to be specified multiple times,
and have `ps' keep adding to a given list -- instead of replacing the
previously-specified values.
- Fix interactions between selector-options, so that: "If any are
specified, ... ps shall select the processes represented by the
inclusive OR of all the selection-criteria options." (from SUSv3)
- Add a `-X' option, which is the reverse of the `-x' option.
- various minor improvements in parsing and error handling.
This does not get us to match POSIX/SUSv3, but it gets us closer. The
`-g pgidlist', `-R ruserlist' and `-s sidlist' options mentioned in
freebsd-standards are still under debate, so they skipped for now.
It should be true that this introduces no user-visible incompatible
changes, except to support "new stuff" that was not supported before.
2004-03-27 18:22:17 +00:00
|
|
|
This will skip any processes which do not have a controlling teminal,
|
|
|
|
unless the
|
|
|
|
.Fl x
|
|
|
|
option is also specified.
|
2001-06-08 04:41:21 +00:00
|
|
|
This can be disabled by setting the
|
2002-05-16 11:51:05 +00:00
|
|
|
.Va security.bsd.see_other_uids
|
2001-06-02 04:02:36 +00:00
|
|
|
sysctl to zero.
|
1996-10-21 07:30:26 +00:00
|
|
|
.It Fl c
|
2004-05-16 21:35:05 +00:00
|
|
|
Change the
|
|
|
|
.Dq command
|
|
|
|
column output to just contain the executable name,
|
1996-10-21 07:30:26 +00:00
|
|
|
rather than the full command line.
|
1994-05-26 06:18:55 +00:00
|
|
|
.It Fl C
|
2004-05-16 21:35:05 +00:00
|
|
|
Change the way the CPU percentage is calculated by using a
|
|
|
|
.Dq raw
|
|
|
|
CPU calculation that ignores
|
|
|
|
.Dq resident
|
|
|
|
time (this normally has
|
1994-05-26 06:18:55 +00:00
|
|
|
no effect).
|
|
|
|
.It Fl e
|
|
|
|
Display the environment as well.
|
1997-12-05 07:35:31 +00:00
|
|
|
.It Fl f
|
1998-06-04 06:46:13 +00:00
|
|
|
Show commandline and environment information about swapped out processes.
|
2004-05-16 21:35:05 +00:00
|
|
|
This option is honored only if the UID of the user is 0.
|
Support more POSIX/SUSv3 options:
- Change `-p' to allow a list of process IDs, and `-t' to allow a list
of terminal names, instead of only a single value for each.
- Add the `-A' option of SUSv3, which is exactly the same as `-ax'.
- Add the `-G gidlist' (group id).
- Allow any of these "selector options" to be specified multiple times,
and have `ps' keep adding to a given list -- instead of replacing the
previously-specified values.
- Fix interactions between selector-options, so that: "If any are
specified, ... ps shall select the processes represented by the
inclusive OR of all the selection-criteria options." (from SUSv3)
- Add a `-X' option, which is the reverse of the `-x' option.
- various minor improvements in parsing and error handling.
This does not get us to match POSIX/SUSv3, but it gets us closer. The
`-g pgidlist', `-R ruserlist' and `-s sidlist' options mentioned in
freebsd-standards are still under debate, so they skipped for now.
It should be true that this introduces no user-visible incompatible
changes, except to support "new stuff" that was not supported before.
2004-03-27 18:22:17 +00:00
|
|
|
.It Fl G
|
|
|
|
Display information about processes which are running with the specified
|
2004-05-16 21:35:05 +00:00
|
|
|
real group IDs.
|
2003-06-12 16:53:55 +00:00
|
|
|
.It Fl H
|
|
|
|
Show all of the
|
|
|
|
.Em kernel visible
|
2004-05-16 21:35:05 +00:00
|
|
|
threads associated with each process.
|
|
|
|
Depending on the threading package that
|
2003-06-12 16:53:55 +00:00
|
|
|
is in use, this may show only the process, only the kernel scheduled entities,
|
|
|
|
or all of the process threads.
|
1994-05-26 06:18:55 +00:00
|
|
|
.It Fl h
|
|
|
|
Repeat the information header as often as necessary to guarantee one
|
|
|
|
header per page of information.
|
|
|
|
.It Fl j
|
|
|
|
Print information associated with the following keywords:
|
2004-05-23 21:35:35 +00:00
|
|
|
.Cm user , pid , ppid , pgid , sid , jobc , state , tt , time ,
|
2004-05-16 21:35:05 +00:00
|
|
|
and
|
|
|
|
.Cm command .
|
1994-05-26 06:18:55 +00:00
|
|
|
.It Fl L
|
2004-03-31 23:51:12 +00:00
|
|
|
List the set of keywords available for the
|
|
|
|
.Fl O
|
|
|
|
and
|
|
|
|
.Fl o
|
|
|
|
options.
|
1994-05-26 06:18:55 +00:00
|
|
|
.It Fl l
|
|
|
|
Display information associated with the following keywords:
|
2004-05-16 21:35:05 +00:00
|
|
|
.Cm uid , pid , ppid , cpu , pri , nice , vsz , rss , mwchan , state ,
|
|
|
|
.Cm tt , time ,
|
|
|
|
and
|
|
|
|
.Cm command .
|
1994-05-26 06:18:55 +00:00
|
|
|
.It Fl M
|
|
|
|
Extract values associated with the name list from the specified core
|
2004-03-26 08:29:38 +00:00
|
|
|
instead of the currently running system.
|
1994-05-26 06:18:55 +00:00
|
|
|
.It Fl m
|
2004-03-31 23:51:12 +00:00
|
|
|
Sort by memory usage, instead of the combination of controlling
|
2004-05-16 21:35:05 +00:00
|
|
|
terminal and process ID.
|
1994-05-26 06:18:55 +00:00
|
|
|
.It Fl N
|
2004-03-26 08:54:27 +00:00
|
|
|
Extract the name list from the specified system instead of the default,
|
|
|
|
which is the kernel image the system has booted from.
|
1994-05-26 06:18:55 +00:00
|
|
|
.It Fl O
|
|
|
|
Add the information associated with the space or comma separated list
|
2004-05-16 21:35:05 +00:00
|
|
|
of keywords specified, after the process ID,
|
1994-05-26 06:18:55 +00:00
|
|
|
in the default information
|
|
|
|
display.
|
2004-05-16 21:35:05 +00:00
|
|
|
Keywords may be appended with an equals
|
|
|
|
.Pq Ql =
|
|
|
|
sign and a string.
|
1994-05-26 06:18:55 +00:00
|
|
|
This causes the printed header to use the specified string instead of
|
|
|
|
the standard header.
|
|
|
|
.It Fl o
|
2002-06-08 18:11:52 +00:00
|
|
|
Display information associated with the space or comma separated
|
|
|
|
list of keywords specified.
|
2002-06-08 05:47:46 +00:00
|
|
|
Multiple keywords may also be given in the form of more than one
|
|
|
|
.Fl o
|
|
|
|
option.
|
2004-05-16 21:35:05 +00:00
|
|
|
Keywords may be appended with an equals
|
|
|
|
.Pq Ql =
|
|
|
|
sign and a string.
|
1994-05-26 06:18:55 +00:00
|
|
|
This causes the printed header to use the specified string instead of
|
|
|
|
the standard header.
|
|
|
|
.It Fl p
|
2004-05-16 21:35:05 +00:00
|
|
|
Display information about processes which match the specified process IDs.
|
1994-05-26 06:18:55 +00:00
|
|
|
.It Fl r
|
2004-05-16 21:35:05 +00:00
|
|
|
Sort by current CPU usage, instead of the combination of controlling
|
|
|
|
terminal and process ID.
|
1994-05-26 06:18:55 +00:00
|
|
|
.It Fl S
|
|
|
|
Change the way the process time is calculated by summing all exited
|
|
|
|
children to their parent process.
|
|
|
|
.It Fl T
|
|
|
|
Display information about processes attached to the device associated
|
|
|
|
with the standard input.
|
|
|
|
.It Fl t
|
|
|
|
Display information about processes attached to the specified terminal
|
2004-05-16 21:35:05 +00:00
|
|
|
devices.
|
1995-12-26 03:38:55 +00:00
|
|
|
.It Fl U
|
2004-05-16 21:35:05 +00:00
|
|
|
Display the processes belonging to the specified usernames.
|
1994-05-26 06:18:55 +00:00
|
|
|
.It Fl u
|
|
|
|
Display information associated with the following keywords:
|
2004-05-16 21:35:05 +00:00
|
|
|
.Cm user , pid , %cpu , %mem , vsz , rss , tt , state , start , time ,
|
|
|
|
and
|
|
|
|
.Cm command .
|
1994-05-26 06:18:55 +00:00
|
|
|
The
|
|
|
|
.Fl u
|
|
|
|
option implies the
|
|
|
|
.Fl r
|
|
|
|
option.
|
|
|
|
.It Fl v
|
|
|
|
Display information associated with the following keywords:
|
2004-05-16 21:35:05 +00:00
|
|
|
.Cm pid , state , time , sl , re , pagein , vsz , rss , lim , tsiz ,
|
|
|
|
.Cm %cpu , %mem ,
|
|
|
|
and
|
|
|
|
.Cm command .
|
1994-05-26 06:18:55 +00:00
|
|
|
The
|
|
|
|
.Fl v
|
|
|
|
option implies the
|
|
|
|
.Fl m
|
|
|
|
option.
|
|
|
|
.It Fl w
|
|
|
|
Use 132 columns to display information, instead of the default which
|
|
|
|
is your window size.
|
|
|
|
If the
|
|
|
|
.Fl w
|
|
|
|
option is specified more than once,
|
1998-05-15 06:30:58 +00:00
|
|
|
.Nm
|
1994-05-26 06:18:55 +00:00
|
|
|
will use as many columns as necessary without regard for your window size.
|
Support more POSIX/SUSv3 options:
- Change `-p' to allow a list of process IDs, and `-t' to allow a list
of terminal names, instead of only a single value for each.
- Add the `-A' option of SUSv3, which is exactly the same as `-ax'.
- Add the `-G gidlist' (group id).
- Allow any of these "selector options" to be specified multiple times,
and have `ps' keep adding to a given list -- instead of replacing the
previously-specified values.
- Fix interactions between selector-options, so that: "If any are
specified, ... ps shall select the processes represented by the
inclusive OR of all the selection-criteria options." (from SUSv3)
- Add a `-X' option, which is the reverse of the `-x' option.
- various minor improvements in parsing and error handling.
This does not get us to match POSIX/SUSv3, but it gets us closer. The
`-g pgidlist', `-R ruserlist' and `-s sidlist' options mentioned in
freebsd-standards are still under debate, so they skipped for now.
It should be true that this introduces no user-visible incompatible
changes, except to support "new stuff" that was not supported before.
2004-03-27 18:22:17 +00:00
|
|
|
.It Fl X
|
|
|
|
When displaying processes matched by other options, skip any processes
|
|
|
|
which do not have a controlling terminal.
|
1994-05-26 06:18:55 +00:00
|
|
|
.It Fl x
|
Support more POSIX/SUSv3 options:
- Change `-p' to allow a list of process IDs, and `-t' to allow a list
of terminal names, instead of only a single value for each.
- Add the `-A' option of SUSv3, which is exactly the same as `-ax'.
- Add the `-G gidlist' (group id).
- Allow any of these "selector options" to be specified multiple times,
and have `ps' keep adding to a given list -- instead of replacing the
previously-specified values.
- Fix interactions between selector-options, so that: "If any are
specified, ... ps shall select the processes represented by the
inclusive OR of all the selection-criteria options." (from SUSv3)
- Add a `-X' option, which is the reverse of the `-x' option.
- various minor improvements in parsing and error handling.
This does not get us to match POSIX/SUSv3, but it gets us closer. The
`-g pgidlist', `-R ruserlist' and `-s sidlist' options mentioned in
freebsd-standards are still under debate, so they skipped for now.
It should be true that this introduces no user-visible incompatible
changes, except to support "new stuff" that was not supported before.
2004-03-27 18:22:17 +00:00
|
|
|
When displaying processes matched by other options, include processes
|
|
|
|
which do not have a controlling terminal.
|
|
|
|
This is the opposite of the
|
|
|
|
.Fl X
|
|
|
|
option.
|
|
|
|
If both
|
|
|
|
.Fl X
|
|
|
|
and
|
|
|
|
.Fl x
|
|
|
|
are specified in the same command, then
|
|
|
|
.Nm
|
|
|
|
will use the one which was specified last.
|
2001-11-26 22:21:15 +00:00
|
|
|
.It Fl Z
|
2004-11-29 12:00:24 +00:00
|
|
|
Add
|
|
|
|
.Xr mac 4
|
|
|
|
label to the list of keywords for which
|
2001-11-26 22:21:15 +00:00
|
|
|
.Nm
|
|
|
|
will display information.
|
1994-05-26 06:18:55 +00:00
|
|
|
.El
|
|
|
|
.Pp
|
|
|
|
A complete list of the available keywords are listed below.
|
|
|
|
Some of these keywords are further specified as follows:
|
2002-10-02 20:33:52 +00:00
|
|
|
.Bl -tag -width lockname
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Cm %cpu
|
|
|
|
The CPU utilization of the process; this is a decaying average over up to
|
1994-05-26 06:18:55 +00:00
|
|
|
a minute of previous (real) time.
|
|
|
|
Since the time base over which this is computed varies (since processes may
|
|
|
|
be very young) it is possible for the sum of all
|
2004-05-16 21:35:05 +00:00
|
|
|
.Cm %cpu
|
1994-05-26 06:18:55 +00:00
|
|
|
fields to exceed 100%.
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Cm %mem
|
1994-05-26 06:18:55 +00:00
|
|
|
The percentage of real memory used by this process.
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Cm flags
|
1996-04-19 22:23:27 +00:00
|
|
|
The flags associated with the process as in
|
1994-05-26 06:18:55 +00:00
|
|
|
the include file
|
2003-09-08 19:57:22 +00:00
|
|
|
.In sys/proc.h :
|
2004-01-21 16:25:36 +00:00
|
|
|
.Bl -column P_STOPPED_SINGLE 0x4000000
|
1996-04-19 22:23:27 +00:00
|
|
|
.It Dv "P_ADVLOCK" Ta No "0x00001 Process may hold a POSIX advisory lock"
|
|
|
|
.It Dv "P_CONTROLT" Ta No "0x00002 Has a controlling terminal"
|
2004-01-21 16:25:36 +00:00
|
|
|
.It Dv "P_KTHREAD" Ta No "0x00004 Kernel thread"
|
|
|
|
.It Dv "P_NOLOAD" Ta No "0x00008 Ignore during load avg calculations"
|
1996-04-19 22:23:27 +00:00
|
|
|
.It Dv "P_PPWAIT" Ta No "0x00010 Parent is waiting for child to exec/exit"
|
|
|
|
.It Dv "P_PROFIL" Ta No "0x00020 Has started profiling"
|
2004-01-21 16:25:36 +00:00
|
|
|
.It Dv "P_STOPPROF" Ta No "0x00040 Has thread in requesting to stop prof"
|
1996-04-19 22:23:27 +00:00
|
|
|
.It Dv "P_SUGID" Ta No "0x00100 Had set id privileges since last exec"
|
|
|
|
.It Dv "P_SYSTEM" Ta No "0x00200 System proc: no sigs, stats or swapping"
|
2004-01-21 16:25:36 +00:00
|
|
|
.It Dv "P_SINGLE_EXIT" Ta No "0x00400 Threads suspending should exit, not wait"
|
1996-04-19 22:23:27 +00:00
|
|
|
.It Dv "P_TRACED" Ta No "0x00800 Debugged process being traced"
|
2004-01-21 16:25:36 +00:00
|
|
|
.It Dv "P_WAITED" Ta No "0x01000 Someone is waiting for us"
|
1996-04-19 22:23:27 +00:00
|
|
|
.It Dv "P_WEXIT" Ta No "0x02000 Working on exiting"
|
|
|
|
.It Dv "P_EXEC" Ta No "0x04000 Process called exec"
|
2004-01-21 16:25:36 +00:00
|
|
|
.It Dv "P_SA" Ta No "0x08000 Using scheduler activations"
|
|
|
|
.It Dv "P_CONTINUED" Ta No "0x10000 Proc has continued from a stopped state"
|
|
|
|
.It Dv "P_STOPPED_SIG" Ta No "0x20000 Stopped due to SIGSTOP/SIGTSTP"
|
|
|
|
.It Dv "P_STOPPED_TRACE" Ta No "0x40000 Stopped because of tracing"
|
|
|
|
.It Dv "P_STOPPED_SINGLE" Ta No "0x80000 Only one thread can continue"
|
|
|
|
.It Dv "P_PROTECTED" Ta No "0x100000 Do not kill on memory overcommit"
|
|
|
|
.It Dv "P_SIGEVENT" Ta No "0x200000 Process pending signals changed"
|
|
|
|
.It Dv "P_JAILED" Ta No "0x1000000 Process is in jail"
|
|
|
|
.It Dv "P_INEXEC" Ta No "0x4000000 Process is in execve()"
|
1994-05-26 06:18:55 +00:00
|
|
|
.El
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Cm label
|
2002-10-24 00:00:57 +00:00
|
|
|
The MAC label of the process.
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Cm lim
|
1994-05-26 06:18:55 +00:00
|
|
|
The soft limit on memory used, specified via a call to
|
|
|
|
.Xr setrlimit 2 .
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Cm lstart
|
|
|
|
The exact time the command started, using the
|
|
|
|
.Ql %c
|
|
|
|
format described in
|
1994-05-26 06:18:55 +00:00
|
|
|
.Xr strftime 3 .
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Cm lockname
|
2002-10-02 20:33:52 +00:00
|
|
|
The name of the lock that the process is currently blocked on.
|
2000-11-30 19:17:56 +00:00
|
|
|
If the name is invalid or unknown, then
|
2000-12-15 17:37:31 +00:00
|
|
|
.Dq ???\&
|
2000-11-30 19:17:56 +00:00
|
|
|
is displayed.
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Cm mwchan
|
2002-10-02 20:33:52 +00:00
|
|
|
The event name if the process is blocked normally, or the lock name if
|
|
|
|
the process is blocked on a lock.
|
|
|
|
See the wchan and lockname keywords
|
2002-02-21 18:27:16 +00:00
|
|
|
for details.
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Cm nice
|
1994-05-26 06:18:55 +00:00
|
|
|
The process scheduling increment (see
|
|
|
|
.Xr setpriority 2 ) .
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Cm rss
|
1994-05-26 06:18:55 +00:00
|
|
|
the real memory (resident set) size of the process (in 1024 byte units).
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Cm start
|
1994-05-26 06:18:55 +00:00
|
|
|
The time the command started.
|
|
|
|
If the command started less than 24 hours ago, the start time is
|
2004-05-16 21:35:05 +00:00
|
|
|
displayed using the
|
|
|
|
.Dq Li %l:ps.1p
|
|
|
|
format described in
|
1994-05-26 06:18:55 +00:00
|
|
|
.Xr strftime 3 .
|
|
|
|
If the command started less than 7 days ago, the start time is
|
2004-05-16 21:35:05 +00:00
|
|
|
displayed using the
|
|
|
|
.Dq Li %a6.15p
|
|
|
|
format.
|
|
|
|
Otherwise, the start time is displayed using the
|
|
|
|
.Dq Li %e%b%y
|
|
|
|
format.
|
|
|
|
.It Cm state
|
2003-08-05 10:31:28 +00:00
|
|
|
The state is given by a sequence of characters, for example,
|
2004-05-16 21:35:05 +00:00
|
|
|
.Dq Li RWNA .
|
2003-08-05 10:31:28 +00:00
|
|
|
The first character indicates the run state of the process:
|
1994-05-26 06:18:55 +00:00
|
|
|
.Pp
|
|
|
|
.Bl -tag -width indent -compact
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Li D
|
1994-05-26 06:18:55 +00:00
|
|
|
Marks a process in disk (or other short term, uninterruptible) wait.
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Li I
|
1994-05-26 06:18:55 +00:00
|
|
|
Marks a process that is idle (sleeping for longer than about 20 seconds).
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Li L
|
2002-10-02 20:33:52 +00:00
|
|
|
Marks a process that is waiting to acquire a lock.
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Li R
|
1994-05-26 06:18:55 +00:00
|
|
|
Marks a runnable process.
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Li S
|
1994-05-26 06:18:55 +00:00
|
|
|
Marks a process that is sleeping for less than about 20 seconds.
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Li T
|
1994-05-26 06:18:55 +00:00
|
|
|
Marks a stopped process.
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Li W
|
2004-01-21 16:25:36 +00:00
|
|
|
Marks an idle interrupt thread.
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Li Z
|
|
|
|
Marks a dead process (a
|
|
|
|
.Dq zombie ) .
|
1994-05-26 06:18:55 +00:00
|
|
|
.El
|
|
|
|
.Pp
|
|
|
|
Additional characters after these, if any, indicate additional state
|
|
|
|
information:
|
|
|
|
.Pp
|
|
|
|
.Bl -tag -width indent -compact
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Li +
|
1994-05-26 06:18:55 +00:00
|
|
|
The process is in the foreground process group of its control terminal.
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Li <
|
|
|
|
The process has raised CPU scheduling priority.
|
|
|
|
.It Li E
|
1994-05-26 06:18:55 +00:00
|
|
|
The process is trying to exit.
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Li J
|
2004-01-21 16:25:36 +00:00
|
|
|
Marks a process which is in
|
|
|
|
.Xr jail 2 .
|
|
|
|
The hostname of the prison can be found in
|
2004-05-16 21:35:05 +00:00
|
|
|
.Pa /proc/ Ns Ao Ar pid Ac Ns Pa /status .
|
|
|
|
.It Li L
|
1994-05-26 06:18:55 +00:00
|
|
|
The process has pages locked in core (for example, for raw
|
|
|
|
.Tn I/O ) .
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Li N
|
|
|
|
The process has reduced CPU scheduling priority (see
|
1994-05-26 06:18:55 +00:00
|
|
|
.Xr setpriority 2 ) .
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Li s
|
1994-05-26 06:18:55 +00:00
|
|
|
The process is a session leader.
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Li V
|
1994-05-26 06:18:55 +00:00
|
|
|
The process is suspended during a
|
2003-06-08 09:48:39 +00:00
|
|
|
.Xr vfork 2 .
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Li W
|
1994-05-26 06:18:55 +00:00
|
|
|
The process is swapped out.
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Li X
|
1994-05-26 06:18:55 +00:00
|
|
|
The process is being traced or debugged.
|
|
|
|
.El
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Cm tt
|
1994-05-26 06:18:55 +00:00
|
|
|
An abbreviation for the pathname of the controlling terminal, if any.
|
1998-06-04 06:46:13 +00:00
|
|
|
The abbreviation consists of the three letters following
|
1998-05-15 06:30:58 +00:00
|
|
|
.Pa /dev/tty ,
|
2004-05-16 21:35:05 +00:00
|
|
|
or, for the console,
|
|
|
|
.Dq Li con .
|
|
|
|
This is followed by a
|
|
|
|
.Ql -
|
|
|
|
if the process can no longer reach that
|
1994-05-26 06:18:55 +00:00
|
|
|
controlling terminal (i.e., it has been revoked).
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Cm wchan
|
1994-05-26 06:18:55 +00:00
|
|
|
The event (an address in the system) on which a process waits.
|
|
|
|
When printed numerically, the initial part of the address is
|
|
|
|
trimmed off and the result is printed in hex, for example, 0x80324000 prints
|
|
|
|
as 324000.
|
|
|
|
.El
|
|
|
|
.Pp
|
|
|
|
When printing using the command keyword, a process that has exited and
|
|
|
|
has a parent that has not yet waited for the process (in other words, a zombie)
|
2004-05-16 21:35:05 +00:00
|
|
|
is listed as
|
|
|
|
.Dq Li <defunct> ,
|
|
|
|
and a process which is blocked while trying
|
|
|
|
to exit is listed as
|
|
|
|
.Dq Li <exiting> .
|
2004-06-22 01:59:54 +00:00
|
|
|
If the command vector cannot be located (usually because it has not
|
|
|
|
been set, as is the case of system processes and/or kernel threads)
|
|
|
|
the command name is printed within square brackets.
|
2002-04-16 20:08:06 +00:00
|
|
|
The
|
|
|
|
.Nm
|
|
|
|
utility
|
1994-05-26 06:18:55 +00:00
|
|
|
makes an educated guess as to the file name and arguments given when the
|
|
|
|
process was created by examining memory or the swap area.
|
|
|
|
The method is inherently somewhat unreliable and in any event a process
|
|
|
|
is entitled to destroy this information, so the names cannot be depended
|
|
|
|
on too much.
|
|
|
|
The ucomm (accounting) keyword can, however, be depended on.
|
|
|
|
.Sh KEYWORDS
|
|
|
|
The following is a complete list of the available keywords and their
|
|
|
|
meanings.
|
|
|
|
Several of them have aliases (keywords which are synonyms).
|
|
|
|
.Pp
|
2004-05-16 21:35:05 +00:00
|
|
|
.Bl -tag -width ".Cm sigignore" -compact
|
|
|
|
.It Cm %cpu
|
|
|
|
percentage CPU usage (alias
|
|
|
|
.Cm pcpu )
|
|
|
|
.It Cm %mem
|
|
|
|
percentage memory usage (alias
|
|
|
|
.Cm pmem )
|
|
|
|
.It Cm acflag
|
|
|
|
accounting flag (alias
|
|
|
|
.Cm acflg )
|
|
|
|
.It Cm args
|
2002-06-06 20:21:47 +00:00
|
|
|
command and arguments
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Cm comm
|
2002-08-09 10:49:50 +00:00
|
|
|
command
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Cm command
|
2002-06-06 20:21:47 +00:00
|
|
|
command and arguments
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Cm cpu
|
|
|
|
short-term CPU usage factor (for scheduling)
|
|
|
|
.It Cm etime
|
2002-06-06 21:18:37 +00:00
|
|
|
elapsed running time
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Cm flags
|
|
|
|
the process flags, in hexadecimal (alias
|
|
|
|
.Cm f )
|
|
|
|
.It Cm inblk
|
|
|
|
total blocks read (alias
|
|
|
|
.Cm inblock )
|
|
|
|
.It Cm jobc
|
1994-05-26 06:18:55 +00:00
|
|
|
job control count
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Cm ktrace
|
1994-05-26 06:18:55 +00:00
|
|
|
tracing flags
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Cm label
|
2002-10-24 00:00:57 +00:00
|
|
|
MAC label
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Cm lim
|
1994-05-26 06:18:55 +00:00
|
|
|
memoryuse limit
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Cm logname
|
1994-05-26 06:18:55 +00:00
|
|
|
login name of user who started the process
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Cm lstart
|
1994-05-26 06:18:55 +00:00
|
|
|
time started
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Cm majflt
|
1994-05-26 06:18:55 +00:00
|
|
|
total page faults
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Cm minflt
|
1994-05-26 06:18:55 +00:00
|
|
|
total page reclaims
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Cm msgrcv
|
1994-05-26 06:18:55 +00:00
|
|
|
total messages received (reads from pipes/sockets)
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Cm msgsnd
|
1994-05-26 06:18:55 +00:00
|
|
|
total messages sent (writes on pipes/sockets)
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Cm lockname
|
2002-10-02 20:33:52 +00:00
|
|
|
lock currently blocked on (as a symbolic name)
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Cm mwchan
|
2002-10-02 20:33:52 +00:00
|
|
|
wait channel or lock currently blocked on
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Cm nice
|
|
|
|
nice value (alias
|
|
|
|
.Cm ni )
|
|
|
|
.It Cm nivcsw
|
1994-05-26 06:18:55 +00:00
|
|
|
total involuntary context switches
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Cm nsigs
|
|
|
|
total signals taken (alias
|
|
|
|
.Cm nsignals )
|
|
|
|
.It Cm nswap
|
1994-05-26 06:18:55 +00:00
|
|
|
total swaps in/out
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Cm nvcsw
|
1994-05-26 06:18:55 +00:00
|
|
|
total voluntary context switches
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Cm nwchan
|
1994-05-26 06:18:55 +00:00
|
|
|
wait channel (as an address)
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Cm oublk
|
|
|
|
total blocks written (alias
|
|
|
|
.Cm oublock )
|
|
|
|
.It Cm paddr
|
1994-05-26 06:18:55 +00:00
|
|
|
swap address
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Cm pagein
|
1994-05-26 06:18:55 +00:00
|
|
|
pageins (same as majflt)
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Cm pgid
|
1994-05-26 06:18:55 +00:00
|
|
|
process group number
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Cm pid
|
|
|
|
process ID
|
|
|
|
.It Cm poip
|
1994-05-26 06:18:55 +00:00
|
|
|
pageouts in progress
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Cm ppid
|
|
|
|
parent process ID
|
|
|
|
.It Cm pri
|
1994-05-26 06:18:55 +00:00
|
|
|
scheduling priority
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Cm re
|
1994-05-26 06:18:55 +00:00
|
|
|
core residency time (in seconds; 127 = infinity)
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Cm rgid
|
|
|
|
real group ID
|
|
|
|
.It Cm rgroup
|
2002-06-06 20:42:16 +00:00
|
|
|
group name (from rgid)
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Cm rlink
|
1994-05-26 06:18:55 +00:00
|
|
|
reverse link on run queue, or 0
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Cm rss
|
1994-05-26 06:18:55 +00:00
|
|
|
resident set size
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Cm rtprio
|
1994-09-01 11:28:45 +00:00
|
|
|
realtime priority (101 = not a realtime process)
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Cm ruid
|
|
|
|
real user ID
|
|
|
|
.It Cm ruser
|
1994-05-26 06:18:55 +00:00
|
|
|
user name (from ruid)
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Cm sid
|
|
|
|
session ID
|
|
|
|
.It Cm sig
|
|
|
|
pending signals (alias
|
|
|
|
.Cm pending )
|
|
|
|
.It Cm sigcatch
|
|
|
|
caught signals (alias
|
|
|
|
.Cm caught )
|
|
|
|
.It Cm sigignore
|
|
|
|
ignored signals (alias
|
|
|
|
.Cm ignored )
|
|
|
|
.It Cm sigmask
|
|
|
|
blocked signals (alias
|
|
|
|
.Cm blocked )
|
|
|
|
.It Cm sl
|
1994-05-26 06:18:55 +00:00
|
|
|
sleep time (in seconds; 127 = infinity)
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Cm start
|
1994-05-26 06:18:55 +00:00
|
|
|
time started
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Cm state
|
|
|
|
symbolic process state (alias
|
|
|
|
.Cm stat )
|
|
|
|
.It Cm svgid
|
1994-05-26 06:18:55 +00:00
|
|
|
saved gid from a setgid executable
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Cm svuid
|
|
|
|
saved UID from a setuid executable
|
|
|
|
.It Cm tdev
|
1994-05-26 06:18:55 +00:00
|
|
|
control terminal device number
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Cm time
|
|
|
|
accumulated CPU time, user + system (alias
|
|
|
|
.Cm cputime )
|
|
|
|
.It Cm tpgid
|
|
|
|
control terminal process group ID
|
|
|
|
.\".It Cm trss
|
1994-05-26 06:18:55 +00:00
|
|
|
.\"text resident set size (in Kbytes)
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Cm tsid
|
|
|
|
control terminal session ID
|
|
|
|
.It Cm tsiz
|
1994-05-26 06:18:55 +00:00
|
|
|
text size (in Kbytes)
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Cm tt
|
1994-05-26 06:18:55 +00:00
|
|
|
control terminal name (two letter abbreviation)
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Cm tty
|
1994-05-26 06:18:55 +00:00
|
|
|
full name of control terminal
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Cm uprocp
|
1994-05-26 06:18:55 +00:00
|
|
|
process pointer
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Cm ucomm
|
1994-05-26 06:18:55 +00:00
|
|
|
name to be used for accounting
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Cm uid
|
|
|
|
effective user ID
|
|
|
|
.It Cm upr
|
|
|
|
scheduling priority on return from system call (alias
|
|
|
|
.Cm usrpri )
|
|
|
|
.It Cm user
|
|
|
|
user name (from UID)
|
|
|
|
.It Cm vsz
|
|
|
|
virtual size in Kbytes (alias
|
|
|
|
.Cm vsize )
|
|
|
|
.It Cm wchan
|
1994-05-26 06:18:55 +00:00
|
|
|
wait channel (as a symbolic name)
|
2004-05-16 21:35:05 +00:00
|
|
|
.It Cm xstat
|
1994-05-26 06:18:55 +00:00
|
|
|
exit or stop status (valid only for stopped or zombie process)
|
|
|
|
.El
|
2002-06-04 10:20:10 +00:00
|
|
|
.Sh ENVIRONMENT
|
|
|
|
The following environment variables affect the execution of
|
|
|
|
.Nm :
|
|
|
|
.Bl -tag -width ".Ev COLUMNS"
|
|
|
|
.It Ev COLUMNS
|
|
|
|
If set, specifies the user's preferred output width in column positions.
|
|
|
|
By default,
|
|
|
|
.Nm
|
|
|
|
attempts to automatically determine the terminal width.
|
|
|
|
.El
|
1994-05-26 06:18:55 +00:00
|
|
|
.Sh FILES
|
2004-03-26 08:29:38 +00:00
|
|
|
.Bl -tag -width ".Pa /boot/kernel/kernel" -compact
|
2002-05-09 11:47:42 +00:00
|
|
|
.It Pa /boot/kernel/kernel
|
1994-05-26 06:18:55 +00:00
|
|
|
default system namelist
|
1995-12-30 13:52:02 +00:00
|
|
|
.It Pa /proc
|
|
|
|
the mount point of
|
|
|
|
.Xr procfs 5
|
1994-05-26 06:18:55 +00:00
|
|
|
.El
|
|
|
|
.Sh SEE ALSO
|
|
|
|
.Xr kill 1 ,
|
2004-05-25 14:05:25 +00:00
|
|
|
.Xr pgrep 1 ,
|
|
|
|
.Xr pkill 1 ,
|
1994-05-26 06:18:55 +00:00
|
|
|
.Xr w 1 ,
|
|
|
|
.Xr kvm 3 ,
|
|
|
|
.Xr strftime 3 ,
|
2004-11-29 12:00:24 +00:00
|
|
|
.Xr mac 4 ,
|
2001-12-04 14:17:52 +00:00
|
|
|
.Xr procfs 5 ,
|
2000-11-30 19:17:56 +00:00
|
|
|
.Xr pstat 8 ,
|
2001-06-02 04:02:36 +00:00
|
|
|
.Xr sysctl 8 ,
|
2000-11-30 19:17:56 +00:00
|
|
|
.Xr mutex 9
|
Support more POSIX/SUSv3 options:
- Change `-p' to allow a list of process IDs, and `-t' to allow a list
of terminal names, instead of only a single value for each.
- Add the `-A' option of SUSv3, which is exactly the same as `-ax'.
- Add the `-G gidlist' (group id).
- Allow any of these "selector options" to be specified multiple times,
and have `ps' keep adding to a given list -- instead of replacing the
previously-specified values.
- Fix interactions between selector-options, so that: "If any are
specified, ... ps shall select the processes represented by the
inclusive OR of all the selection-criteria options." (from SUSv3)
- Add a `-X' option, which is the reverse of the `-x' option.
- various minor improvements in parsing and error handling.
This does not get us to match POSIX/SUSv3, but it gets us closer. The
`-g pgidlist', `-R ruserlist' and `-s sidlist' options mentioned in
freebsd-standards are still under debate, so they skipped for now.
It should be true that this introduces no user-visible incompatible
changes, except to support "new stuff" that was not supported before.
2004-03-27 18:22:17 +00:00
|
|
|
.Sh STANDARDS
|
|
|
|
For historical reasons,
|
|
|
|
.Nm
|
|
|
|
utility under
|
|
|
|
.Fx
|
|
|
|
supports a different set of options from what is described by
|
|
|
|
.St -p1003.2 ,
|
2004-05-16 21:35:05 +00:00
|
|
|
and what is supported on
|
|
|
|
.No non- Ns Bx
|
|
|
|
operating systems.
|
2002-06-10 05:03:20 +00:00
|
|
|
.Sh HISTORY
|
|
|
|
The
|
|
|
|
.Nm
|
|
|
|
command appeared in
|
2002-06-10 22:48:51 +00:00
|
|
|
.At v4 .
|
1994-05-26 06:18:55 +00:00
|
|
|
.Sh BUGS
|
|
|
|
Since
|
1998-05-15 06:30:58 +00:00
|
|
|
.Nm
|
1994-05-26 06:18:55 +00:00
|
|
|
cannot run faster than the system and is run as any other scheduled
|
|
|
|
process, the information it displays can never be exact.
|
2004-03-21 11:24:06 +00:00
|
|
|
.Pp
|
|
|
|
The
|
|
|
|
.Nm
|
|
|
|
utility does not correctly display argument lists containing multibyte
|
|
|
|
characters.
|