usr/src/man/man1b/ps.1b

   1 '\" te
   2 .\" Copyright (c) 2002, Sun Microsystems, Inc. - All Rights Reserved.
   3 .\" Copyright (c), 1980 Regents of the University of California.  All rights reserved.  The Berkeley software License Agreement  specifies the terms and conditions for redistribution.
   4 .TH PS 1B "May 26, 2006"
   5 .SH NAME
   6 ps \- display the status of current processes
   7 .SH SYNOPSIS
   8 .LP
   9 .nf
  10 \fB/usr/ucb/ps\fR [\fB-aceglnrSuUvwx\fR] [\fB-t\fR \fIterm\fR] [\fInum\fR]
  11 .fi
  12
  13 .SH DESCRIPTION
  14 .sp
  15 .LP
  16 The \fBps\fR command displays information about processes. Normally, only those
  17 processes that are running with your effective user \fBID\fR and are attached
  18 to a controlling terminal (see  \fBtermio\fR(7I)) are shown. Additional
  19 categories of processes can be added to the display using various options. In
  20 particular, the \fB-a\fR option allows you to include processes that are not
  21 owned by you (that do not have your user \fBID\fR), and the \fB-x\fR option
  22 allows you to include processes without controlling terminals. When you specify
  23 both \fB-a\fR and \fB-x\fR, you get processes owned by anyone, with or without
  24 a controlling terminal. The \fB-r\fR option restricts the list of processes
  25 printed to running and runnable processes.
  26 .sp
  27 .LP
  28 \fBps\fR displays in tabular form the process ID, under \fBPID\fR; the
  29 controlling terminal (if any), under \fBTT\fR; the cpu time used by the process
  30 so far, including both user and system time, under \fBTIME\fR; the state of the
  31 process, under S; and finally, an indication of the \fBCOMMAND\fR that is
  32 running.
  33 .sp
  34 .LP
  35 The state is given by a single letter from the following:
  36 .sp
  37 .ne 2
  38 .na
  39 \fB\fBO\fR\fR
  40 .ad
  41 .RS 5n
  42 Process is running on a processor.
  43 .RE
  44
  45 .sp
  46 .ne 2
  47 .na
  48 \fB\fBS\fR\fR
  49 .ad
  50 .RS 5n
  51 Sleeping. Process is waiting for an event to complete.
  52 .RE
  53
  54 .sp
  55 .ne 2
  56 .na
  57 \fB\fBR\fR\fR
  58 .ad
  59 .RS 5n
  60 Runnable. Process is on run queue.
  61 .RE
  62
  63 .sp
  64 .ne 2
  65 .na
  66 \fB\fBZ\fR\fR
  67 .ad
  68 .RS 5n
  69 Zombie state. Process terminated and parent not waiting.
  70 .RE
  71
  72 .sp
  73 .ne 2
  74 .na
  75 \fB\fBT\fR\fR
  76 .ad
  77 .RS 5n
  78 Traced. Process stopped by a signal because parent is tracing it.
  79 .RE
  80
  81 .SH OPTIONS
  82 .sp
  83 .LP
  84 The following options must all be combined to form the first argument:
  85 .sp
  86 .ne 2
  87 .na
  88 \fB\fB-a\fR\fR
  89 .ad
  90 .RS 11n
  91 Includes information about processes owned by others.
  92 .RE
  93
  94 .sp
  95 .ne 2
  96 .na
  97 \fB\fB-c\fR\fR
  98 .ad
  99 .RS 11n
 100 Displays the command name rather than the command arguments.
 101 .RE
 102
 103 .sp
 104 .ne 2
 105 .na
 106 \fB\fB-e\fR\fR
 107 .ad
 108 .RS 11n
 109 Displays the environment as well as the arguments to the command.
 110 .RE
 111
 112 .sp
 113 .ne 2
 114 .na
 115 \fB\fB-g\fR\fR
 116 .ad
 117 .RS 11n
 118 Displays all processes. Without this option, \fBps\fR only prints interesting
 119 processes. Processes are deemed to be uninteresting if they are process group
 120 leaders. This normally eliminates top-level command interpreters and processes
 121 waiting for users to login on free terminals.
 122 .RE
 123
 124 .sp
 125 .ne 2
 126 .na
 127 \fB\fB-l\fR\fR
 128 .ad
 129 .RS 11n
 130 Displays a long listing, with fields \fBF\fR, \fBPPID\fR, \fBCP\fR, \fBPRI\fR,
 131 \fBNI\fR, \fBSZ\fR, \fBRSS\fR, and \fBWCHAN\fR as described below.
 132 .RE
 133
 134 .sp
 135 .ne 2
 136 .na
 137 \fB\fB-n\fR\fR
 138 .ad
 139 .RS 11n
 140 Produces numerical output for some fields. In a user listing, the \fBUSER\fR
 141 field is replaced by a \fBUID\fR field.
 142 .RE
 143
 144 .sp
 145 .ne 2
 146 .na
 147 \fB\fB-r\fR\fR
 148 .ad
 149 .RS 11n
 150 Restricts output to running and runnable processes.
 151 .RE
 152
 153 .sp
 154 .ne 2
 155 .na
 156 \fB\fB-S\fR\fR
 157 .ad
 158 .RS 11n
 159 Displays accumulated \fBCPU\fR time used by this process and all of its reaped
 160 children.
 161 .RE
 162
 163 .sp
 164 .ne 2
 165 .na
 166 \fB\fB-t\fR \fIterm\fR\fR
 167 .ad
 168 .RS 11n
 169 Lists only process data associated with the terminal, \fIterm\fR. Terminal
 170 identifiers may be specified in one of two forms:  the device's file name (for
 171 example,  \fBtty04\fR or \fBterm/14\fR ) or, if the device's file name starts
 172 with  \fBtty\fR, just the digit identifier (for example, \fB04\fR).
 173 .RE
 174
 175 .sp
 176 .ne 2
 177 .na
 178 \fB\fB-u\fR\fR
 179 .ad
 180 .RS 11n
 181 Displays user-oriented output. This includes fields \fBUSER\fR, \fB%CPU\fR,
 182 \fB%MEM\fR, \fBSZ\fR, \fBRSS\fR, and \fBSTART\fR as described below.
 183 .RE
 184
 185 .sp
 186 .ne 2
 187 .na
 188 \fB\fB-U\fR\fR
 189 .ad
 190 .RS 11n
 191 Obsolete. This option no longer has any effect. It causes \fBps\fR to exit
 192 without printing the process listing.
 193 .RE
 194
 195 .sp
 196 .ne 2
 197 .na
 198 \fB\fB-v\fR\fR
 199 .ad
 200 .RS 11n
 201 Displays a version of the output containing virtual memory. This includes
 202 fields \fBSIZE\fR, \fB%CPU\fR, \fB%MEM\fR, and \fBRSS\fR, described below.
 203 .RE
 204
 205 .sp
 206 .ne 2
 207 .na
 208 \fB\fB-w\fR\fR
 209 .ad
 210 .RS 11n
 211 Uses a wide output format, that is, 132 columns rather than 80. If the option
 212 letter is repeated, that is, \fB-ww\fR, this option uses arbitrarily wide
 213 output. This information is used to decide how much of long commands to print.
 214 \fBNote:\fR The wide output option can be viewed only by a superuser or the
 215 user who owns the process.
 216 .RE
 217
 218 .sp
 219 .ne 2
 220 .na
 221 \fB\fB-x\fR\fR
 222 .ad
 223 .RS 11n
 224 Includes processes with no controlling terminal.
 225 .RE
 226
 227 .sp
 228 .ne 2
 229 .na
 230 \fB\fInum\fR\fR
 231 .ad
 232 .RS 11n
 233 A process number may be given, in which case the output is restricted to that
 234 process. This option must be supplied last.
 235 .RE
 236
 237 .SH DISPLAY FORMATS
 238 .sp
 239 .LP
 240 Fields that are not common to all output formats:
 241 .sp
 242 .ne 2
 243 .na
 244 \fB\fBUSER\fR\fR
 245 .ad
 246 .RS 9n
 247 Name of the owner of the process.
 248 .RE
 249
 250 .sp
 251 .ne 2
 252 .na
 253 \fB\fB%CPU\fR\fR
 254 .ad
 255 .RS 9n
 256 \fBCPU\fR use of the process. This is a decaying average over up to a minute of
 257 previous (real) time.
 258 .RE
 259
 260 .sp
 261 .ne 2
 262 .na
 263 \fB\fBNI\fR\fR
 264 .ad
 265 .RS 9n
 266 Process scheduling increment (see \fBgetpriority\fR(3C) and \fBnice\fR(3UCB)).
 267 .RE
 268
 269 .sp
 270 .ne 2
 271 .na
 272 \fB\fBSIZE\fR\fR
 273 .ad
 274 .RS 9n
 275 The total size of the process in virtual memory, including all mapped files and
 276 devices, in kilobyte units.
 277 .RE
 278
 279 .sp
 280 .ne 2
 281 .na
 282 \fB\fBSZ\fR\fR
 283 .ad
 284 .RS 9n
 285 Same as \fBSIZE\fR.
 286 .RE
 287
 288 .sp
 289 .ne 2
 290 .na
 291 \fB\fBRSS\fR\fR
 292 .ad
 293 .RS 9n
 294 Real memory (resident set) size of the process, in kilobyte units.
 295 .RE
 296
 297 .sp
 298 .ne 2
 299 .na
 300 \fB\fBUID\fR\fR
 301 .ad
 302 .RS 9n
 303 Numerical user-ID of process owner.
 304 .RE
 305
 306 .sp
 307 .ne 2
 308 .na
 309 \fB\fBPPID\fR\fR
 310 .ad
 311 .RS 9n
 312 Numerical \fBID\fR of parent of process.
 313 .RE
 314
 315 .sp
 316 .ne 2
 317 .na
 318 \fB\fBCP\fR\fR
 319 .ad
 320 .RS 9n
 321 Short-term \fBCPU\fR utilization factor (used in scheduling).
 322 .RE
 323
 324 .sp
 325 .ne 2
 326 .na
 327 \fB\fBPRI\fR\fR
 328 .ad
 329 .RS 9n
 330 The priority of the process (higher numbers mean lower priority).
 331 .RE
 332
 333 .sp
 334 .ne 2
 335 .na
 336 \fB\fBSTART\fR\fR
 337 .ad
 338 .RS 9n
 339 The starting time of the process, given in hours, minutes, and seconds. A
 340 process begun more than 24 hours before the \fBps\fR inquiry is executed is
 341 given in months and days.
 342 .RE
 343
 344 .sp
 345 .ne 2
 346 .na
 347 \fB\fBWCHAN\fR\fR
 348 .ad
 349 .RS 9n
 350 The address of an event for which the process is sleeping (if blank, the
 351 process is running).
 352 .RE
 353
 354 .sp
 355 .ne 2
 356 .na
 357 \fB\fB%MEM\fR\fR
 358 .ad
 359 .RS 9n
 360 The ratio of the process's resident set size to the physical memory on the
 361 machine, expressed as a percentage.
 362 .RE
 363
 364 .sp
 365 .ne 2
 366 .na
 367 \fB\fBF\fR\fR
 368 .ad
 369 .RS 9n
 370 Flags (hexadecimal and additive) associated with the process. These flags are
 371 available for historical purposes; no meaning should be currently ascribed to
 372 them.
 373 .RE
 374
 375 .sp
 376 .LP
 377 A process that has exited and has a parent, but has not yet been waited for by
 378 the parent, is marked <\fBdefunct\fR>\|; otherwise, \fBps\fR tries to determine
 379 the command name and arguments given when the process was created by examining
 380 the user block.
 381 .SH FILES
 382 .sp
 383 .LP
 384 \fB/dev/tty*\fR
 385 .sp
 386 .ne 2
 387 .na
 388 \fB\fB/etc/passwd\fR\fR
 389 .ad
 390 .RS 15n
 391 \fBUID\fR information supplier
 392 .RE
 393
 394 .SH SEE ALSO
 395 .sp
 396 .LP
 397 \fBkill\fR(1), \fBps\fR(1), \fBwhodo\fR(1M), \fBgetpriority\fR(3C),
 398 \fBnice\fR(3UCB), \fBproc\fR(4), \fBattributes\fR(5), \fBtermio\fR(7I)
 399 .SH NOTES
 400 .sp
 401 .LP
 402 Things can change while \fBps\fR is running. The picture \fBps\fR gives is only
 403 a close approximation to the current state. Some data printed for defunct
 404 processes is irrelevant.