Process pane

The Process pane lists the processes (and threads, if any) controlled by the given ``window set''. The information for each process or thread is given by the following pane labels:

Program

The program name which is usually the name of the executable file. If a process forks, both parent and child processes (and their respective threads, if any) will belong to the same program.

ID

A unique debugger-generated identifier for each process and thread.

State

The current state of the process or thread. The possible values are:

Running

The process or thread is in motion following a ``Run'' or ``Step'' command.

Stepping

This state appears only when the debugger has to execute a process or thread an instruction at a time, typically because it has to continually evaluate an event condition.

Stopped

The process or thread is halted.

Core

The process or thread is a core image which may be examined but not altered or executed.

Off lwp

A multiplexed thread has been taken off the Light Weight Process (LWP) by the threads library, possibly because it is blocked on I/O or on some synchronization primitive. When it is ready to resume execution, it will be picked up again by an LWP. A thread is in a suspended state waiting for action from another thread or the system. This state occurs when the thread is a target of a thr_suspend call. It will resume execution when continued by another thread.

Core off lwp

A thread in a core image that was in Off lwp state when the core image was produced.

Core suspended

A thread in a core image that was in suspended state when the core image was produced.

Function

If the object is Running or Stepping, this will be blank. Otherwise, this is the name of the function where the object is stopped.

Location

If the object is Running or Stepping, this will be blank. If the object is stopped in a function that was compiled with debugging information (-g), this will give the file name and line number (file@line) where the object is stopped. If the function was not compiled with debugging information, this will show the hex address where the object is stopped.

Command

The Command Line used to start the object.

You may select one or more entries in the Process pane. The selected entries affect the behavior of many of the commands in the menus of the window containing the pane. For example, if you select an entry and then click the SELECT button on the ``Run'' option, the selected object will be set running. If you had not selected an object before selecting ``Run'', the current object would have been set to running. Selecting an entry selects both the process or thread and the program. Most of the options apply to the selected object, but commands that create events ( ``Stop'', ``Signal'', ``Syscall'', ``Stop on Function'', ``Set Breakpoint'', ``Set Watchpoint'', ``Exception'', and ``On Stop'') by default apply to the selected program. Use the ``Granularity'' option to change the default.

The current object is indicated by a pointing hand to the left of the program name. The current object determines what is displayed in the other panes in the window set. The current object may be changed by first clicking the SELECT button on one object in the Process pane and then clicking the SELECT button on the ``Set current'' option. Alternatively, simply double-click on the object.

You may also move an object from one window set to another by selecting the ``Move'' option, or by selecting the object, dragging it, and dropping it on a Process pane of the other window set. It will become the current object in its new window set.

If any of the information is too long to fit in its column, the information is truncated. If you click SELECT on any column, the full contents of that column are displayed in the footer area of the window containing this pane.