bin/ps/ps.1

   1 .\"-
   2 .\" Copyright (c) 1980, 1990, 1991, 1993, 1994
   3 .\"     The Regents of the University of California.  All rights reserved.
   4 .\"
   5 .\" Redistribution and use in source and binary forms, with or without
   6 .\" modification, are permitted provided that the following conditions
   7 .\" are met:
   8 .\" 1. Redistributions of source code must retain the above copyright
   9 .\"    notice, this list of conditions and the following disclaimer.
  10 .\" 2. Redistributions in binary form must reproduce the above copyright
  11 .\"    notice, this list of conditions and the following disclaimer in the
  12 .\"    documentation and/or other materials provided with the distribution.
  13 .\" 3. Neither the name of the University nor the names of its contributors
  14 .\"    may be used to endorse or promote products derived from this software
  15 .\"    without specific prior written permission.
  16 .\"
  17 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  18 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  19 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  20 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  21 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  22 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  23 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  24 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  25 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  26 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  27 .\" SUCH DAMAGE.
  28 .\"
  29 .\"     @(#)ps.1        8.3 (Berkeley) 4/18/94
  30 .\" $FreeBSD$
  31 .\"
  32 .Dd June 27, 2020
  33 .Dt PS 1
  34 .Os
  35 .Sh NAME
  36 .Nm ps
  37 .Nd process status
  38 .Sh SYNOPSIS
  39 .Nm
  40 .Op Fl -libxo
  41 .Op Fl aCcdefHhjlmrSTuvwXxZ
  42 .Op Fl O Ar fmt | Fl o Ar fmt
  43 .Op Fl G Ar gid Ns Op , Ns Ar gid Ns Ar ...
  44 .Op Fl J Ar jid Ns Op , Ns Ar jid Ns Ar ...
  45 .Op Fl M Ar core
  46 .Op Fl N Ar system
  47 .Op Fl p Ar pid Ns Op , Ns Ar pid Ns Ar ...
  48 .Op Fl t Ar tty Ns Op , Ns Ar tty Ns Ar ...
  49 .Op Fl U Ar user Ns Op , Ns Ar user Ns Ar ...
  50 .Nm
  51 .Op Fl -libxo
  52 .Op Fl L
  53 .Sh DESCRIPTION
  54 The
  55 .Nm
  56 utility
  57 displays a header line, followed by lines containing information about
  58 all of your
  59 processes that have controlling terminals.
  60 If the
  61 .Fl x
  62 options is specified,
  63 .Nm
  64 will also display processes that do not have controlling terminals.
  65 .Pp
  66 A different set of processes can be selected for display by using any
  67 combination of the
  68 .Fl a , G , J , p , T , t ,
  69 and
  70 .Fl U
  71 options.
  72 If more than one of these options are given, then
  73 .Nm
  74 will select all processes which are matched by at least one of the
  75 given options.
  76 .Pp
  77 For the processes which have been selected for display,
  78 .Nm
  79 will usually display one line per process.
  80 The
  81 .Fl H
  82 option may result in multiple output lines (one line per thread) for
  83 some processes.
  84 By default all of these output lines are sorted first by controlling
  85 terminal, then by process ID.
  86 The
  87 .Fl m , r , u ,
  88 and
  89 .Fl v
  90 options will change the sort order.
  91 If more than one sorting option was given, then the selected processes
  92 will be sorted by the last sorting option which was specified.
  93 .Pp
  94 For the processes which have been selected for display, the information
  95 to display is selected based on a set of keywords (see the
  96 .Fl L , O ,
  97 and
  98 .Fl o
  99 options).
 100 The default output format includes, for each process, the process' ID,
 101 controlling terminal, state, CPU time (including both user and system time)
 102 and associated command.
 103 .Pp
 104 If the
 105 .Nm
 106 process is associated with a terminal, the default output width is that of the
 107 terminal; otherwise the output width is unlimited.
 108 See also the
 109 .Fl w
 110 option.
 111 .Pp
 112 The options are as follows:
 113 .Bl -tag -width indent
 114 .It Fl -libxo
 115 Generate output via
 116 .Xr libxo 3
 117 in a selection of different human and machine readable formats.
 118 See
 119 .Xr xo_parse_args 3
 120 for details on command line arguments.
 121 .It Fl a
 122 Display information about other users' processes as well as your own.
 123 If the
 124 .Va security.bsd.see_other_uids
 125 sysctl is set to zero, this option is honored only if the UID of the user is 0.
 126 .It Fl c
 127 Change the
 128 .Dq command
 129 column output to just contain the executable name,
 130 rather than the full command line.
 131 .It Fl C
 132 Change the way the CPU percentage is calculated by using a
 133 .Dq raw
 134 CPU calculation that ignores
 135 .Dq resident
 136 time (this normally has
 137 no effect).
 138 .It Fl d
 139 Arrange processes into descendancy order and prefix each command with
 140 indentation text showing sibling and parent/child relationships as a tree.
 141 If either of the
 142 .Fl m
 143 and
 144 .Fl r
 145 options are also used, they control how sibling processes are sorted
 146 relative to each other.
 147 Note that this option has no effect if the
 148 .Dq command
 149 column is not the last column displayed.
 150 .It Fl e
 151 Display the environment as well.
 152 .It Fl f
 153 Show command-line and environment information about swapped out processes.
 154 This option is honored only if the UID of the user is 0.
 155 .It Fl G
 156 Display information about processes which are running with the specified
 157 real group IDs.
 158 .It Fl H
 159 Show all of the threads associated with each process.
 160 .It Fl h
 161 Repeat the information header as often as necessary to guarantee one
 162 header per page of information.
 163 .It Fl j
 164 Print information associated with the following keywords:
 165 .Cm user , pid , ppid , pgid , sid , jobc , state , tt , time ,
 166 and
 167 .Cm command .
 168 .It Fl J
 169 Display information about processes which match the specified jail IDs.
 170 This may be either the
 171 .Cm jid
 172 or
 173 .Cm name
 174 of the jail.
 175 Use
 176 .Fl J
 177 .Sy 0
 178 to display only host processes.
 179 This flag implies
 180 .Fl x
 181 by default.
 182 .It Fl L
 183 List the set of keywords available for the
 184 .Fl O
 185 and
 186 .Fl o
 187 options.
 188 .It Fl l
 189 Display information associated with the following keywords:
 190 .Cm uid , pid , ppid , cpu , pri , nice , vsz , rss , mwchan , state ,
 191 .Cm tt , time ,
 192 and
 193 .Cm command .
 194 .It Fl M
 195 Extract values associated with the name list from the specified core
 196 instead of the currently running system.
 197 .It Fl m
 198 Sort by memory usage, instead of the combination of controlling
 199 terminal and process ID.
 200 .It Fl N
 201 Extract the name list from the specified system instead of the default,
 202 which is the kernel image the system has booted from.
 203 .It Fl O
 204 Add the information associated with the space or comma separated list
 205 of keywords specified, after the process ID,
 206 in the default information
 207 display.
 208 Keywords may be appended with an equals
 209 .Pq Ql =
 210 sign and a string.
 211 This causes the printed header to use the specified string instead of
 212 the standard header.
 213 .It Fl o
 214 Display information associated with the space or comma separated
 215 list of keywords specified.
 216 The last keyword in the list may be appended with an equals
 217 .Pq Ql =
 218 sign and a string that spans the rest of the argument, and can contain
 219 space and comma characters.
 220 This causes the printed header to use the specified string instead of
 221 the standard header.
 222 Multiple keywords may also be given in the form of more than one
 223 .Fl o
 224 option.
 225 So the header texts for multiple keywords can be changed.
 226 If all keywords have empty header texts, no header line is written.
 227 .It Fl p
 228 Display information about processes which match the specified process IDs.
 229 .It Fl r
 230 Sort by current CPU usage, instead of the combination of controlling
 231 terminal and process ID.
 232 .It Fl S
 233 Change the way the process times, namely cputime, systime, and usertime,
 234 are calculated by summing all exited children to their parent process.
 235 .It Fl T
 236 Display information about processes attached to the device associated
 237 with the standard input.
 238 .It Fl t
 239 Display information about processes attached to the specified terminal
 240 devices.
 241 Full pathnames, as well as abbreviations (see explanation of the
 242 .Cm tt
 243 keyword) can be specified.
 244 .It Fl U
 245 Display the processes belonging to the specified usernames.
 246 .It Fl u
 247 Display information associated with the following keywords:
 248 .Cm user , pid , %cpu , %mem , vsz , rss , tt , state , start , time ,
 249 and
 250 .Cm command .
 251 The
 252 .Fl u
 253 option implies the
 254 .Fl r
 255 option.
 256 .It Fl v
 257 Display information associated with the following keywords:
 258 .Cm pid , state , time , sl , re , pagein , vsz , rss , lim , tsiz ,
 259 .Cm %cpu , %mem ,
 260 and
 261 .Cm command .
 262 The
 263 .Fl v
 264 option implies the
 265 .Fl m
 266 option.
 267 .It Fl w
 268 Use at least 132 columns to display information, instead of the default which
 269 is the window size if
 270 .Nm
 271 is associated with a terminal.
 272 If the
 273 .Fl w
 274 option is specified more than once,
 275 .Nm
 276 will use as many columns as necessary without regard for the window size.
 277 Note that this option has no effect if the
 278 .Dq command
 279 column is not the last column displayed.
 280 .It Fl X
 281 When displaying processes matched by other options, skip any processes
 282 which do not have a controlling terminal.
 283 This is the default behaviour.
 284 .It Fl x
 285 When displaying processes matched by other options, include processes
 286 which do not have a controlling terminal.
 287 This is the opposite of the
 288 .Fl X
 289 option.
 290 If both
 291 .Fl X
 292 and
 293 .Fl x
 294 are specified in the same command, then
 295 .Nm
 296 will use the one which was specified last.
 297 .It Fl Z
 298 Add
 299 .Xr mac 4
 300 label to the list of keywords for which
 301 .Nm
 302 will display information.
 303 .El
 304 .Pp
 305 A complete list of the available keywords are listed below.
 306 Some of these keywords are further specified as follows:
 307 .Bl -tag -width lockname
 308 .It Cm %cpu
 309 The CPU utilization of the process; this is a decaying average over up to
 310 a minute of previous (real) time.
 311 Since the time base over which this is computed varies (since processes may
 312 be very young) it is possible for the sum of all
 313 .Cm %cpu
 314 fields to exceed 100%.
 315 .It Cm %mem
 316 The percentage of real memory used by this process.
 317 .It Cm class
 318 Login class associated with the process.
 319 .It Cm flags
 320 The flags associated with the process as in
 321 the include file
 322 .In sys/proc.h :
 323 .Bl -column P_SINGLE_BOUNDARY 0x40000000
 324 .It Dv "P_ADVLOCK" Ta No "0x00001" Ta "Process may hold a POSIX advisory lock"
 325 .It Dv "P_CONTROLT" Ta No "0x00002" Ta "Has a controlling terminal"
 326 .It Dv "P_KPROC" Ta No "0x00004" Ta "Kernel process"
 327 .It Dv "P_PPWAIT" Ta No "0x00010" Ta "Parent is waiting for child to exec/exit"
 328 .It Dv "P_PROFIL" Ta No "0x00020" Ta "Has started profiling"
 329 .It Dv "P_STOPPROF" Ta No "0x00040" Ta "Has thread in requesting to stop prof"
 330 .It Dv "P_HADTHREADS" Ta No "0x00080" Ta "Has had threads (no cleanup shortcuts)"
 331 .It Dv "P_SUGID" Ta No "0x00100" Ta "Had set id privileges since last exec"
 332 .It Dv "P_SYSTEM" Ta No "0x00200" Ta "System proc: no sigs, stats or swapping"
 333 .It Dv "P_SINGLE_EXIT" Ta No "0x00400" Ta "Threads suspending should exit, not wait"
 334 .It Dv "P_TRACED" Ta No "0x00800" Ta "Debugged process being traced"
 335 .It Dv "P_WAITED" Ta No "0x01000" Ta "Someone is waiting for us"
 336 .It Dv "P_WEXIT" Ta No "0x02000" Ta "Working on exiting"
 337 .It Dv "P_EXEC" Ta No "0x04000" Ta "Process called exec"
 338 .It Dv "P_WKILLED" Ta No "0x08000" Ta "Killed, shall go to kernel/user boundary ASAP"
 339 .It Dv "P_CONTINUED" Ta No "0x10000" Ta "Proc has continued from a stopped state"
 340 .It Dv "P_STOPPED_SIG" Ta No "0x20000" Ta "Stopped due to SIGSTOP/SIGTSTP"
 341 .It Dv "P_STOPPED_TRACE" Ta No "0x40000" Ta "Stopped because of tracing"
 342 .It Dv "P_STOPPED_SINGLE" Ta No "0x80000" Ta "Only one thread can continue"
 343 .It Dv "P_PROTECTED" Ta No "0x100000" Ta "Do not kill on memory overcommit"
 344 .It Dv "P_SIGEVENT" Ta No "0x200000" Ta "Process pending signals changed"
 345 .It Dv "P_SINGLE_BOUNDARY" Ta No "0x400000" Ta "Threads should suspend at user boundary"
 346 .It Dv "P_HWPMC" Ta No "0x800000" Ta "Process is using HWPMCs"
 347 .It Dv "P_JAILED" Ta No "0x1000000" Ta "Process is in jail"
 348 .It Dv "P_TOTAL_STOP" Ta No "0x2000000" Ta "Stopped for system suspend"
 349 .It Dv "P_INEXEC" Ta No "0x4000000" Ta Process is in Xr execve 2
 350 .It Dv "P_STATCHILD" Ta No "0x8000000" Ta "Child process stopped or exited"
 351 .It Dv "P_INMEM" Ta No "0x10000000" Ta "Loaded into memory"
 352 .It Dv "P_SWAPPINGOUT" Ta No "0x20000000" Ta "Process is being swapped out"
 353 .It Dv "P_SWAPPINGIN" Ta No "0x40000000" Ta "Process is being swapped in"
 354 .It Dv "P_PPTRACE" Ta No "0x80000000" Ta "Vforked child issued ptrace(PT_TRACEME)"
 355 .El
 356 .It Cm flags2
 357 The flags kept in
 358 .Va p_flag2
 359 associated with the process as in
 360 the include file
 361 .In sys/proc.h :
 362 .Bl -column P2_INHERIT_PROTECTED 0x00000001
 363 .It Dv "P2_INHERIT_PROTECTED" Ta No "0x00000001" Ta "New children get P_PROTECTED"
 364 .It Dv "P2_NOTRACE" Ta No "0x00000002" Ta "No" Xr ptrace 2 attach or coredumps
 365 .It Dv "P2_NOTRACE_EXEC" Ta No "0x00000004" Ta Keep P2_NOPTRACE on Xr execve 2
 366 .It Dv "P2_AST_SU" Ta No "0x00000008" Ta "Handles SU ast for kthreads"
 367 .It Dv "P2_PTRACE_FSTP" Ta No "0x00000010" Ta "SIGSTOP from PT_ATTACH not yet handled"
 368 .El
 369 .It Cm label
 370 The MAC label of the process.
 371 .It Cm lim
 372 The soft limit on memory used, specified via a call to
 373 .Xr setrlimit 2 .
 374 .It Cm lstart
 375 The exact time the command started, using the
 376 .Ql %c
 377 format described in
 378 .Xr strftime 3 .
 379 .It Cm lockname
 380 The name of the lock that the process is currently blocked on.
 381 If the name is invalid or unknown, then
 382 .Dq ???\&
 383 is displayed.
 384 .It Cm logname
 385 The login name associated with the session the process is in (see
 386 .Xr getlogin 2 ) .
 387 .It Cm mwchan
 388 The event name if the process is blocked normally, or the lock name if
 389 the process is blocked on a lock.
 390 See the wchan and lockname keywords
 391 for details.
 392 .It Cm nice
 393 The process scheduling increment (see
 394 .Xr setpriority 2 ) .
 395 .It Cm rss
 396 the real memory (resident set) size of the process (in 1024 byte units).
 397 .It Cm start
 398 The time the command started.
 399 If the command started less than 24 hours ago, the start time is
 400 displayed using the
 401 .Dq Li %H:%M
 402 format described in
 403 .Xr strftime 3 .
 404 If the command started less than 7 days ago, the start time is
 405 displayed using the
 406 .Dq Li %a%H
 407 format.
 408 Otherwise, the start time is displayed using the
 409 .Dq Li %e%b%y
 410 format.
 411 .It Cm state
 412 The state is given by a sequence of characters, for example,
 413 .Dq Li RWNA .
 414 The first character indicates the run state of the process:
 415 .Pp
 416 .Bl -tag -width indent -compact
 417 .It Li D
 418 Marks a process in disk (or other short term, uninterruptible) wait.
 419 .It Li I
 420 Marks a process that is idle (sleeping for longer than about 20 seconds).
 421 .It Li L
 422 Marks a process that is waiting to acquire a lock.
 423 .It Li R
 424 Marks a runnable process.
 425 .It Li S
 426 Marks a process that is sleeping for less than about 20 seconds.
 427 .It Li T
 428 Marks a stopped process.
 429 .It Li W
 430 Marks an idle interrupt thread.
 431 .It Li Z
 432 Marks a dead process (a
 433 .Dq zombie ) .
 434 .El
 435 .Pp
 436 Additional characters after these, if any, indicate additional state
 437 information:
 438 .Pp
 439 .Bl -tag -width indent -compact
 440 .It Li +
 441 The process is in the foreground process group of its control terminal.
 442 .It Li <
 443 The process has raised CPU scheduling priority.
 444 .It Li C
 445 The process is in
 446 .Xr capsicum 4
 447 capability mode.
 448 .It Li E
 449 The process is trying to exit.
 450 .It Li J
 451 Marks a process which is in
 452 .Xr jail 2 .
 453 The hostname of the prison can be found in
 454 .Pa /proc/ Ns Ao Ar pid Ac Ns Pa /status .
 455 .It Li L
 456 The process has pages locked in core (for example, for raw I/O).
 457 .It Li N
 458 The process has reduced CPU scheduling priority (see
 459 .Xr setpriority 2 ) .
 460 .It Li s
 461 The process is a session leader.
 462 .It Li V
 463 The process' parent is suspended during a
 464 .Xr vfork 2 ,
 465 waiting for the process to exec or exit.
 466 .It Li W
 467 The process is swapped out.
 468 .It Li X
 469 The process is being traced or debugged.
 470 .El
 471 .It Cm tt
 472 An abbreviation for the pathname of the controlling terminal, if any.
 473 The abbreviation consists of the three letters following
 474 .Pa /dev/tty ,
 475 or, for pseudo-terminals, the corresponding entry in
 476 .Pa /dev/pts .
 477 This is followed by a
 478 .Ql -
 479 if the process can no longer reach that
 480 controlling terminal (i.e., it has been revoked).
 481 A
 482 .Ql -
 483 without a preceding two letter abbreviation or pseudo-terminal device number
 484 indicates a process which never had a controlling terminal.
 485 The full pathname of the controlling terminal is available via the
 486 .Cm tty
 487 keyword.
 488 .It Cm wchan
 489 The event (an address in the system) on which a process waits.
 490 When printed numerically, the initial part of the address is
 491 trimmed off and the result is printed in hex, for example, 0x80324000 prints
 492 as 324000.
 493 .El
 494 .Pp
 495 When printing using the command keyword, a process that has exited and
 496 has a parent that has not yet waited for the process (in other words, a zombie)
 497 is listed as
 498 .Dq Li <defunct> ,
 499 and a process which is blocked while trying
 500 to exit is listed as
 501 .Dq Li <exiting> .
 502 If the arguments cannot be located (usually because it has not been set, as is
 503 the case of system processes and/or kernel threads) the command name is printed
 504 within square brackets.
 505 The
 506 .Nm
 507 utility first tries to obtain the arguments cached by the kernel (if they were
 508 shorter than the value of the
 509 .Va kern.ps_arg_cache_limit
 510 sysctl).
 511 The process can change the arguments shown with
 512 .Xr setproctitle 3 .
 513 Otherwise,
 514 .Nm
 515 makes an educated guess as to the file name and arguments given when the
 516 process was created by examining memory or the swap area.
 517 The method is inherently somewhat unreliable and in any event a process
 518 is entitled to destroy this information.
 519 The ucomm (accounting) keyword can, however, be depended on.
 520 If the arguments are unavailable or do not agree with the ucomm keyword,
 521 the value for the ucomm keyword is appended to the arguments in parentheses.
 522 .Sh KEYWORDS
 523 The following is a complete list of the available keywords and their
 524 meanings.
 525 Several of them have aliases (keywords which are synonyms).
 526 .Pp
 527 .Bl -tag -width ".Cm sigignore" -compact
 528 .It Cm %cpu
 529 percentage CPU usage (alias
 530 .Cm pcpu )
 531 .It Cm %mem
 532 percentage memory usage (alias
 533 .Cm pmem )
 534 .It Cm acflag
 535 accounting flag (alias
 536 .Cm acflg )
 537 .It Cm args
 538 command and arguments
 539 .It Cm class
 540 login class
 541 .It Cm comm
 542 command
 543 .It Cm command
 544 command and arguments
 545 .It Cm cow
 546 number of copy-on-write faults
 547 .It Cm cpu
 548 The processor number on which the process is executing (visible only on SMP
 549 systems).
 550 .It Cm dsiz
 551 data size (in Kbytes)
 552 .It Cm emul
 553 system-call emulation environment (ABI)
 554 .It Cm etime
 555 elapsed running time, format
 556 .Do
 557 .Op days- Ns
 558 .Op hours\&: Ns
 559 minutes:seconds
 560 .Dc
 561 .It Cm etimes
 562 elapsed running time, in decimal integer seconds
 563 .It Cm fib
 564 default FIB number, see
 565 .Xr setfib 1
 566 .It Cm flags
 567 the process flags, in hexadecimal (alias
 568 .Cm f )
 569 .It Cm flags2
 570 the additional set of process flags, in hexadecimal (alias
 571 .Cm f2 )
 572 .It Cm gid
 573 effective group ID (alias
 574 .Cm egid )
 575 .It Cm group
 576 group name (from egid) (alias
 577 .Cm egroup )
 578 .It Cm inblk
 579 total blocks read (alias
 580 .Cm inblock )
 581 .It Cm jail
 582 jail name
 583 .It Cm jid
 584 jail ID
 585 .It Cm jobc
 586 job control count
 587 .It Cm ktrace
 588 tracing flags
 589 .It Cm label
 590 MAC label
 591 .It Cm lim
 592 memoryuse limit
 593 .It Cm lockname
 594 lock currently blocked on (as a symbolic name)
 595 .It Cm logname
 596 login name of user who started the session
 597 .It Cm lstart
 598 time started
 599 .It Cm lwp
 600 thread (light-weight process) ID (alias
 601 .Cm tid )
 602 .It Cm majflt
 603 total page faults
 604 .It Cm minflt
 605 total page reclaims
 606 .It Cm msgrcv
 607 total messages received (reads from pipes/sockets)
 608 .It Cm msgsnd
 609 total messages sent (writes on pipes/sockets)
 610 .It Cm mwchan
 611 wait channel or lock currently blocked on
 612 .It Cm nice
 613 nice value (alias
 614 .Cm ni )
 615 .It Cm nivcsw
 616 total involuntary context switches
 617 .It Cm nlwp
 618 number of threads (light-weight processes) tied to a process
 619 .It Cm nsigs
 620 total signals taken (alias
 621 .Cm nsignals )
 622 .It Cm nswap
 623 total swaps in/out
 624 .It Cm nvcsw
 625 total voluntary context switches
 626 .It Cm nwchan
 627 wait channel (as an address)
 628 .It Cm oublk
 629 total blocks written (alias
 630 .Cm oublock )
 631 .It Cm paddr
 632 process pointer
 633 .It Cm pagein
 634 pageins (same as majflt)
 635 .It Cm pgid
 636 process group number
 637 .It Cm pid
 638 process ID
 639 .It Cm ppid
 640 parent process ID
 641 .It Cm pri
 642 scheduling priority
 643 .It Cm re
 644 core residency time (in seconds; 127 = infinity)
 645 .It Cm rgid
 646 real group ID
 647 .It Cm rgroup
 648 group name (from rgid)
 649 .It Cm rss
 650 resident set size
 651 .It Cm rtprio
 652 realtime priority (see
 653 .Xr rtprio 1)
 654 .It Cm ruid
 655 real user ID
 656 .It Cm ruser
 657 user name (from ruid)
 658 .It Cm sid
 659 session ID
 660 .It Cm sig
 661 pending signals (alias
 662 .Cm pending )
 663 .It Cm sigcatch
 664 caught signals (alias
 665 .Cm caught )
 666 .It Cm sigignore
 667 ignored signals (alias
 668 .Cm ignored )
 669 .It Cm sigmask
 670 blocked signals (alias
 671 .Cm blocked )
 672 .It Cm sl
 673 sleep time (in seconds; 127 = infinity)
 674 .It Cm ssiz
 675 stack size (in Kbytes)
 676 .It Cm start
 677 time started
 678 .It Cm state
 679 symbolic process state (alias
 680 .Cm stat )
 681 .It Cm svgid
 682 saved gid from a setgid executable
 683 .It Cm svuid
 684 saved UID from a setuid executable
 685 .It Cm systime
 686 accumulated system CPU time
 687 .It Cm tdaddr
 688 thread address
 689 .It Cm tdname
 690 thread name
 691 .It Cm tdev
 692 control terminal device number
 693 .It Cm time
 694 accumulated CPU time, user + system (alias
 695 .Cm cputime )
 696 .It Cm tpgid
 697 control terminal process group ID
 698 .It Cm tracer
 699 tracer process ID
 700 .\".It Cm trss
 701 .\"text resident set size (in Kbytes)
 702 .It Cm tsid
 703 control terminal session ID
 704 .It Cm tsiz
 705 text size (in Kbytes)
 706 .It Cm tt
 707 control terminal name (two letter abbreviation)
 708 .It Cm tty
 709 full name of control terminal
 710 .It Cm ucomm
 711 name to be used for accounting
 712 .It Cm uid
 713 effective user ID (alias
 714 .Cm euid )
 715 .It Cm upr
 716 scheduling priority on return from system call (alias
 717 .Cm usrpri )
 718 .It Cm uprocp
 719 process pointer
 720 .It Cm user
 721 user name (from UID)
 722 .It Cm usertime
 723 accumulated user CPU time
 724 .It Cm vmaddr
 725 vmspace pointer
 726 .It Cm vsz
 727 virtual size in Kbytes (alias
 728 .Cm vsize )
 729 .It Cm wchan
 730 wait channel (as a symbolic name)
 731 .It Cm xstat
 732 exit or stop status (valid only for stopped or zombie process)
 733 .El
 734 .Pp
 735 Note that the
 736 .Cm pending
 737 column displays bitmask of signals pending in the process queue when
 738 .Fl H
 739 option is not specified, otherwise the per-thread queue of pending signals
 740 is shown.
 741 .Sh ENVIRONMENT
 742 The following environment variables affect the execution of
 743 .Nm :
 744 .Bl -tag -width ".Ev COLUMNS"
 745 .It Ev COLUMNS
 746 If set, specifies the user's preferred output width in column positions.
 747 By default,
 748 .Nm
 749 attempts to automatically determine the terminal width.
 750 .El
 751 .Sh FILES
 752 .Bl -tag -width ".Pa /boot/kernel/kernel" -compact
 753 .It Pa /boot/kernel/kernel
 754 default system namelist
 755 .El
 756 .Sh EXIT STATUS
 757 .Ex -std
 758 .Sh EXAMPLES
 759 Display information on all system processes:
 760 .Pp
 761 .Dl $ ps -auxw
 762 .Sh SEE ALSO
 763 .Xr kill 1 ,
 764 .Xr pgrep 1 ,
 765 .Xr pkill 1 ,
 766 .Xr procstat 1 ,
 767 .Xr w 1 ,
 768 .Xr kvm 3 ,
 769 .Xr libxo 3 ,
 770 .Xr strftime 3 ,
 771 .Xr xo_parse_args 3 ,
 772 .Xr mac 4 ,
 773 .Xr procfs 5 ,
 774 .Xr pstat 8 ,
 775 .Xr sysctl 8 ,
 776 .Xr mutex 9
 777 .Sh STANDARDS
 778 For historical reasons, the
 779 .Nm
 780 utility under
 781 .Fx
 782 supports a different set of options from what is described by
 783 .St -p1003.2 ,
 784 and what is supported on
 785 .No non- Ns Bx
 786 operating systems.
 787 .Sh HISTORY
 788 The
 789 .Nm
 790 command appeared in
 791 .At v3
 792 in section 8 of the manual.
 793 .Sh BUGS
 794 Since
 795 .Nm
 796 cannot run faster than the system and is run as any other scheduled
 797 process, the information it displays can never be exact.
 798 .Pp
 799 The
 800 .Nm
 801 utility does not correctly display argument lists containing multibyte
 802 characters.