Reference Guide New Features Installation, Transformations, Release Notes

The Root Window

Root Window Pages

The Root Window has the following pages:

Attached Page

Contains a list of all the processes and threads you are currently debugging. Diving into an process or thread by double-clicking or using the View > Dive command opens a window for the selected process. If a window already exists for that process, TotalView brings it to the front. Each process is shown with its PID (Process ID) and a short summary of its state.

The Attached Page has four columns of information:

  • A "triangle" icon pointing toward the process name or pointing down.

    When it points down, TotalView® displays all threads for the process below the entry. Clicking on a triangle toggles between showing just the process or the process and its threads.

  • Process and Thread IDs.

    When displaying a thread, TotalView shows it using the thread index it has created for it. Diving into a thread item opens (or brings to the front) a Process Window focused on an arbitrary thread. If there is no open window associated with the process, TotalView opens a window containing the first thread in the process.

  • The last place the PC was seen. This is the place where the thread was last stopped.
     
  • A one-letter state indicator as follows:

    Definition
    blank (Not begun)
    Process only: the process has not begun running.
    Bnn (Breakpoint)
    nn is the ID of the breakpoint if it is a thread.

    Process: one or more threads are stopped at a breakpoint.

    Thread: the thread is stopped at a breakpoint. If only one thread is at a breakpoint, or all threads are at the same breakpoint, TotalView displays the ID of that breakpoint for the process as well as the thread. If the process's threads are at different breakpoints, TotalView displays a "*" for the process's breakpoint ID.
    E (Error)
    The Error state usually indicates that your program received a fatal signal from the operating system. Signals such as SIGSEGV, SIGBUS, and SIGFPE can indicate an error in your program.

    Process: one or more threads are in the Error state.

    Thread: stopped because of an error.
    H (Held)
    Either you or TotalView is holding the process of a thread. Holding means that the process or thread cannot run until it is released. You can explicitly release it, or TotalView can release it if the condition that caused it to be held is satisfied.
    K (Kernel)
    Thread only: the thread is executing inside the kernel (that is, it made a system call); when a thread is in the kernel, the operating system does not allow TotalView to view the thread's full state.
    M (Mixed)
    Process only: either some threads in the process are running or the process is expecting some of its threads to stop.
    R (Running)
    Process: all threads in the process are running or can run.

    Thread: running or can run.
    T
    Stopped
    Process: one or more threads are stopped, but none are in the At Breakpoint state.

    Thread: while the thread is stopped, it is not at a breakpoint and no error occurred.

    W
    Watchpoint 
    Process: one or more threads are stopped at a watchpoint.

    Thread: stopped at a watchpoint.

If you have attached to processes on more than one processor, TotalView groups this information by the processor upon which it is running.

Related topics are:

 
 
 
Select a section:
 
documentation@etnus.com
Copyright © 2003, Etnus, Inc. All rights reserved.
Version Version 6.2