Documentation/kdb/kdb_ps.man

   1 .TH PS 1 "September 14, 2004"
   2 .SH NAME
   3 ps \- Display processes
   4 .SH SYNOPSIS
   5 ps [ DRSTCZEUIMA ]
   6 .SH DESCRIPTION
   7 The
   8 .B ps
   9 command displays the status of all processes in the desired state.
  10 This command does not take any locks (all cpus should be frozen while
  11 kdb is running) so it can safely be used to debug lock problems with
  12 the process table.
  13 .P
  14 Without any parameters, \fBps\fP displays all the interesting
  15 processes, excluding idle tasks and sleeping system daemons.
  16 If a parameter is specified, it is a single string consisting of the
  17 letters D, R, S, T, C, Z, E, U, I and M, in any order.
  18 Each letter selects processes in a specific state, when multiple
  19 letters are specified, a process will be displayed if it is in any of
  20 the specified states.
  21 The states are\ :-
  22 .P
  23 .DS
  24 .TS
  25 box, center;
  26 l | l
  27 l | l.
  28 D       Uninterruptible sleep
  29 R       Running
  30 S       Interruptible sleep
  31 T       Stopped
  32 C       Traced
  33 Z       Zombie
  34 E       Dead
  35 U       Unrunnable
  36 I       Idle task
  37 M       Sleeping system daemon
  38 A       All
  39 .TE
  40 .DE
  41 .P
  42 For state R (running), the process may not be on a cpu at the moment,
  43 but it is ready to run.
  44 The header line above the backtrace contains '1' in the fourth field if
  45 the process is actually on a cpu.
  46 .P
  47 The idle task is run on each cpu when there is no work for that cpu to do.
  48 Unless the idle task is servicing an interrupt, there is no point in
  49 printing the idle task.
  50 An idle task that is not servicing a interrupt is marked as state I,
  51 while servicing an interrupt it is in state R.
  52 By default, idle tasks are not printed, use \fBps\ I\fR to print them.
  53 If the idle tasks are not being printed, the start of the \fBps\R
  54 output contains a list of which cpus are idle.
  55 .P
  56 Each cpu has one or more system daemons to handle per cpu work such as
  57 soft irqs.
  58 A system daemon (idenified by a NULL mm pointer) that is sleeping is
  59 marked as state M.
  60 These processes rarely have any useful data and generate a lot of
  61 output on large machines, so sleeping system daemons are not printed by
  62 default.
  63 Use \fBps\ M\fR to print them.
  64 .P
  65 At the start of the \fBps\fR output is a line giving the cpu status,
  66 see the kdb \fBcpu\fR command.
  67 .SH LIMITATIONS
  68 None.
  69 .SH ENVIRONMENT
  70 .TP 8
  71 PS
  72 This environment variable (default=DRSTCZEU) is used when \fBps\fR
  73 is issued with no parameters.
  74
  75 .SH SMP CONSIDERATIONS
  76 None.
  77 .SH EXAMPLES
  78 .TP 8
  79 \fBps\fR
  80 displays the useful tasks, suppressing idle tasks and sleeping
  81 system daemons.
  82
  83 .TP 8
  84 \fBps\ RD\fR
  85 displays only tasks that are running or are in an uninterruptible
  86 sleep.
  87
  88 .TP 8
  89 \fBps\ DRSTCZEUIM\fR
  90 displays all tasks.
  91
  92 .TP 8
  93 \fBps\ A\fR
  94 displays all tasks.
  95 This is easier than remembering DRSTCZEUIM.
  96