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 March 13, 2018
  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 execve()"
 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 ptrace(2) attach or coredumps"
 365 .It Dv "P2_NOTRACE_EXEC" Ta No "0x00000004" Ta "Keep P2_NOPTRACE on exec(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
 457 .Tn I/O ) .
 458 .It Li N
 459 The process has reduced CPU scheduling priority (see
 460 .Xr setpriority 2 ) .
 461 .It Li s
 462 The process is a session leader.
 463 .It Li V
 464 The process' parent is suspended during a
 465 .Xr vfork 2 ,
 466 waiting for the process to exec or exit.
 467 .It Li W
 468 The process is swapped out.
 469 .It Li X
 470 The process is being traced or debugged.
 471 .El
 472 .It Cm tt
 473 An abbreviation for the pathname of the controlling terminal, if any.
 474 The abbreviation consists of the three letters following
 475 .Pa /dev/tty ,
 476 or, for pseudo-terminals, the corresponding entry in
 477 .Pa /dev/pts .
 478 This is followed by a
 479 .Ql -
 480 if the process can no longer reach that
 481 controlling terminal (i.e., it has been revoked).
 482 A
 483 .Ql -
 484 without a preceding two letter abbreviation or pseudo-terminal device number
 485 indicates a process which never had a controlling terminal.
 486 The full pathname of the controlling terminal is available via the
 487 .Cm tty
 488 keyword.
 489 .It Cm wchan
 490 The event (an address in the system) on which a process waits.
 491 When printed numerically, the initial part of the address is
 492 trimmed off and the result is printed in hex, for example, 0x80324000 prints
 493 as 324000.
 494 .El
 495 .Pp
 496 When printing using the command keyword, a process that has exited and
 497 has a parent that has not yet waited for the process (in other words, a zombie)
 498 is listed as
 499 .Dq Li <defunct> ,
 500 and a process which is blocked while trying
 501 to exit is listed as
 502 .Dq Li <exiting> .
 503 If the arguments cannot be located (usually because it has not been set, as is
 504 the case of system processes and/or kernel threads) the command name is printed
 505 within square brackets.
 506 The
 507 .Nm
 508 utility first tries to obtain the arguments cached by the kernel (if they were
 509 shorter than the value of the
 510 .Va kern.ps_arg_cache_limit
 511 sysctl).
 512 The process can change the arguments shown with
 513 .Xr setproctitle 3 .
 514 Otherwise,
 515 .Nm
 516 makes an educated guess as to the file name and arguments given when the
 517 process was created by examining memory or the swap area.
 518 The method is inherently somewhat unreliable and in any event a process
 519 is entitled to destroy this information.
 520 The ucomm (accounting) keyword can, however, be depended on.
 521 If the arguments are unavailable or do not agree with the ucomm keyword,
 522 the value for the ucomm keyword is appended to the arguments in parentheses.
 523 .Sh KEYWORDS
 524 The following is a complete list of the available keywords and their
 525 meanings.
 526 Several of them have aliases (keywords which are synonyms).
 527 .Pp
 528 .Bl -tag -width ".Cm sigignore" -compact
 529 .It Cm %cpu
 530 percentage CPU usage (alias
 531 .Cm pcpu )
 532 .It Cm %mem
 533 percentage memory usage (alias
 534 .Cm pmem )
 535 .It Cm acflag
 536 accounting flag (alias
 537 .Cm acflg )
 538 .It Cm args
 539 command and arguments
 540 .It Cm class
 541 login class
 542 .It Cm comm
 543 command
 544 .It Cm command
 545 command and arguments
 546 .It Cm cow
 547 number of copy-on-write faults
 548 .It Cm cpu
 549 short-term CPU usage factor (for scheduling)
 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 .Op days- Ns
 557 .Op hours: Ns
 558 minutes:seconds.
 559 .It Cm etimes
 560 elapsed running time, in decimal integer seconds
 561 .It Cm fib
 562 default FIB number, see
 563 .Xr setfib 1
 564 .It Cm flags
 565 the process flags, in hexadecimal (alias
 566 .Cm f )
 567 .It Cm flags2
 568 the additional set of process flags, in hexadecimal (alias
 569 .Cm f2 )
 570 .It Cm gid
 571 effective group ID (alias
 572 .Cm egid )
 573 .It Cm group
 574 group name (from egid) (alias
 575 .Cm egroup )
 576 .It Cm inblk
 577 total blocks read (alias
 578 .Cm inblock )
 579 .It Cm jail
 580 jail name
 581 .It Cm jid
 582 jail ID
 583 .It Cm jobc
 584 job control count
 585 .It Cm ktrace
 586 tracing flags
 587 .It Cm label
 588 MAC label
 589 .It Cm lim
 590 memoryuse limit
 591 .It Cm lockname
 592 lock currently blocked on (as a symbolic name)
 593 .It Cm logname
 594 login name of user who started the session
 595 .It Cm lstart
 596 time started
 597 .It Cm lwp
 598 thread (light-weight process) ID (alias
 599 .Cm tid )
 600 .It Cm majflt
 601 total page faults
 602 .It Cm minflt
 603 total page reclaims
 604 .It Cm msgrcv
 605 total messages received (reads from pipes/sockets)
 606 .It Cm msgsnd
 607 total messages sent (writes on pipes/sockets)
 608 .It Cm mwchan
 609 wait channel or lock currently blocked on
 610 .It Cm nice
 611 nice value (alias
 612 .Cm ni )
 613 .It Cm nivcsw
 614 total involuntary context switches
 615 .It Cm nlwp
 616 number of threads (light-weight processes) tied to a process
 617 .It Cm nsigs
 618 total signals taken (alias
 619 .Cm nsignals )
 620 .It Cm nswap
 621 total swaps in/out
 622 .It Cm nvcsw
 623 total voluntary context switches
 624 .It Cm nwchan
 625 wait channel (as an address)
 626 .It Cm oublk
 627 total blocks written (alias
 628 .Cm oublock )
 629 .It Cm paddr
 630 process pointer
 631 .It Cm pagein
 632 pageins (same as majflt)
 633 .It Cm pgid
 634 process group number
 635 .It Cm pid
 636 process ID
 637 .It Cm ppid
 638 parent process ID
 639 .It Cm pri
 640 scheduling priority
 641 .It Cm re
 642 core residency time (in seconds; 127 = infinity)
 643 .It Cm rgid
 644 real group ID
 645 .It Cm rgroup
 646 group name (from rgid)
 647 .It Cm rss
 648 resident set size
 649 .It Cm rtprio
 650 realtime priority (101 = not a realtime process)
 651 .It Cm ruid
 652 real user ID
 653 .It Cm ruser
 654 user name (from ruid)
 655 .It Cm sid
 656 session ID
 657 .It Cm sig
 658 pending signals (alias
 659 .Cm pending )
 660 .It Cm sigcatch
 661 caught signals (alias
 662 .Cm caught )
 663 .It Cm sigignore
 664 ignored signals (alias
 665 .Cm ignored )
 666 .It Cm sigmask
 667 blocked signals (alias
 668 .Cm blocked )
 669 .It Cm sl
 670 sleep time (in seconds; 127 = infinity)
 671 .It Cm ssiz
 672 stack size (in Kbytes)
 673 .It Cm start
 674 time started
 675 .It Cm state
 676 symbolic process state (alias
 677 .Cm stat )
 678 .It Cm svgid
 679 saved gid from a setgid executable
 680 .It Cm svuid
 681 saved UID from a setuid executable
 682 .It Cm systime
 683 accumulated system CPU time
 684 .It Cm tdaddr
 685 thread address
 686 .It Cm tdname
 687 thread name
 688 .It Cm tdev
 689 control terminal device number
 690 .It Cm time
 691 accumulated CPU time, user + system (alias
 692 .Cm cputime )
 693 .It Cm tpgid
 694 control terminal process group ID
 695 .It Cm tracer
 696 tracer process ID
 697 .\".It Cm trss
 698 .\"text resident set size (in Kbytes)
 699 .It Cm tsid
 700 control terminal session ID
 701 .It Cm tsiz
 702 text size (in Kbytes)
 703 .It Cm tt
 704 control terminal name (two letter abbreviation)
 705 .It Cm tty
 706 full name of control terminal
 707 .It Cm ucomm
 708 name to be used for accounting
 709 .It Cm uid
 710 effective user ID (alias
 711 .Cm euid )
 712 .It Cm upr
 713 scheduling priority on return from system call (alias
 714 .Cm usrpri )
 715 .It Cm uprocp
 716 process pointer
 717 .It Cm user
 718 user name (from UID)
 719 .It Cm usertime
 720 accumulated user CPU time
 721 .It Cm vmaddr
 722 vmspace pointer
 723 .It Cm vsz
 724 virtual size in Kbytes (alias
 725 .Cm vsize )
 726 .It Cm wchan
 727 wait channel (as a symbolic name)
 728 .It Cm xstat
 729 exit or stop status (valid only for stopped or zombie process)
 730 .El
 731 .Pp
 732 Note that the
 733 .Cm pending
 734 column displays bitmask of signals pending in the process queue when
 735 .Fl H
 736 option is not specified, otherwise the per-thread queue of pending signals
 737 is shown.
 738 .Sh ENVIRONMENT
 739 The following environment variables affect the execution of
 740 .Nm :
 741 .Bl -tag -width ".Ev COLUMNS"
 742 .It Ev COLUMNS
 743 If set, specifies the user's preferred output width in column positions.
 744 By default,
 745 .Nm
 746 attempts to automatically determine the terminal width.
 747 .El
 748 .Sh FILES
 749 .Bl -tag -width ".Pa /boot/kernel/kernel" -compact
 750 .It Pa /boot/kernel/kernel
 751 default system namelist
 752 .El
 753 .Sh EXAMPLES
 754 Display information on all system processes:
 755 .Pp
 756 .Dl $ ps -auxw
 757 .Sh SEE ALSO
 758 .Xr kill 1 ,
 759 .Xr pgrep 1 ,
 760 .Xr pkill 1 ,
 761 .Xr procstat 1 ,
 762 .Xr w 1 ,
 763 .Xr kvm 3 ,
 764 .Xr libxo 3 ,
 765 .Xr strftime 3 ,
 766 .Xr xo_parse_args 3 ,
 767 .Xr mac 4 ,
 768 .Xr procfs 5 ,
 769 .Xr pstat 8 ,
 770 .Xr sysctl 8 ,
 771 .Xr mutex 9
 772 .Sh STANDARDS
 773 For historical reasons, the
 774 .Nm
 775 utility under
 776 .Fx
 777 supports a different set of options from what is described by
 778 .St -p1003.2 ,
 779 and what is supported on
 780 .No non- Ns Bx
 781 operating systems.
 782 .Sh HISTORY
 783 The
 784 .Nm
 785 command appeared in
 786 .At v3
 787 in section 8 of the manual.
 788 .Sh BUGS
 789 Since
 790 .Nm
 791 cannot run faster than the system and is run as any other scheduled
 792 process, the information it displays can never be exact.
 793 .Pp
 794 The
 795 .Nm
 796 utility does not correctly display argument lists containing multibyte
 797 characters.