| <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> |
| <html> |
| <head> |
| <meta name="copyright" content="Copyright (c) IBM Corporation and others 2000, 2005. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." > |
| <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> |
| <meta http-equiv="Content-Style-Type" content="text/css"> |
| <link rel="stylesheet" href="../book.css" charset="ISO-8859-1" type="text/css"> |
| <title> |
| Debug view |
| </title> |
| </head> |
| <body> |
| <h1> |
| Debug view |
| </h1> |
| <p> |
| This view allows you to manage the debugging or running of a program in the workbench. It displays the stack frame for the suspended threads for each target you are |
| debugging. Each thread in your program appears as a node in the tree. It displays the process for each target you are running. |
| </p> |
| <p> |
| If the thread is suspended, its stack frames are shown as child elements. |
| </p> |
| |
| <table border="1" cellspacing="0" cellpadding="5" width="697"> |
| <caption> Debug View Commands </caption> |
| <thead> |
| <tr> |
| <th rowspan="1" colspan="1" width="78"> |
| <p> Command </p> |
| </th> |
| <th rowspan="1" colspan="1" width="111"> |
| <p> Name </p> |
| </th> |
| <th rowspan="1" colspan="1" width="494"> |
| <p> Description </p> |
| </th> |
| </tr> |
| </thead> <tbody> |
| <tr> |
| <td rowspan="1" colspan="1" valign="top" align="left" width="78"> <img src="../images/org.eclipse.debug.ui/elcl16/resume_co.png" align="baseline" alt="Resume button"> |
| </td> |
| <td rowspan="1" colspan="1" valign="top" align="left" width="111"> |
| <p> Resume </p> |
| </td> |
| <td rowspan="1" colspan="1" valign="top" align="left" width="494"> |
| <p> This command resumes a suspended thread. </p> |
| </td> |
| </tr> |
| <tr> |
| <td rowspan="1" colspan="1" valign="top" align="left" width="78"> <img src="../images/org.eclipse.debug.ui/elcl16/suspend_co.png" align="baseline" alt="Suspend button"> |
| </td> |
| <td rowspan="1" colspan="1" valign="top" align="left" width="111"> |
| <p> Suspend </p> |
| </td> |
| <td rowspan="1" colspan="1" valign="top" align="left" width="494"> |
| <p> This command suspends the selected thread of a target so that you can |
| browse or modify code, inspect data, step, and so on. </p> |
| </td> |
| </tr> |
| <tr> |
| <td rowspan="1" colspan="1" valign="top" align="left" width="78"> <img src="../images/org.eclipse.debug.ui/elcl16/terminate_co.png" align="baseline" alt="Terminate button"> |
| </td> |
| <td rowspan="1" colspan="1" valign="top" align="left" width="111"> |
| <p> Terminate </p> |
| </td> |
| <td rowspan="1" colspan="1" valign="top" align="left" width="494"> |
| <p> This command terminates the selected debug target. </p> |
| </td> |
| </tr> |
| <tr> |
| <td rowspan="1" colspan="1" valign="top" align="left" width="78"> |
| <p> <img src="../images/org.eclipse.debug.ui/elcl16/terminate_rem_co.png" align="baseline" alt="Terminate & Remove command in context menu"><br> |
| Context menu only </p> |
| </td> |
| <td rowspan="1" colspan="1" valign="top" align="left" width="111"> |
| <p> Terminate & Remove </p> |
| </td> |
| <td rowspan="1" colspan="1" valign="top" align="left" width="494"> |
| <p> This command terminates the selected debug target and removes it from |
| the view. </p> |
| </td> |
| </tr> |
| <tr> |
| <td rowspan="1" colspan="1" valign="top" align="left" width="78"> |
| <p> <img src="../images/org.eclipse.debug.ui/elcl16/terminate_all_co.png" align="baseline" alt="Terminate All command in context menu"><br> |
| Context menu only </p> |
| </td> |
| <td rowspan="1" colspan="1" valign="top" align="left" width="111"> |
| <p> Terminate All </p> |
| </td> |
| <td rowspan="1" colspan="1" valign="top" align="left" width="494"> |
| <p> This command terminates all active launches in the view. </p> |
| </td> |
| </tr> |
| <tr> |
| <td rowspan="1" colspan="1" valign="top" align="left" width="78"> <img src="../images/org.eclipse.debug.ui/elcl16/disconnect_co.png" align="baseline" alt="Disconnect button"> |
| </td> |
| <td rowspan="1" colspan="1" valign="top" align="left" width="111"> |
| <p> Disconnect </p> |
| </td> |
| <td rowspan="1" colspan="1" valign="top" align="left" width="494"> |
| <p> This command disconnects the debugger from the selected debug target |
| when debugging remotely. </p> |
| </td> |
| </tr> |
| <tr> |
| <td rowspan="1" colspan="1" valign="top" align="left" width="78"> <img src="../images/org.eclipse.debug.ui/elcl16/rem_all_co.png" align="baseline" alt="Remove All Terminated Launches button"> |
| </td> |
| <td rowspan="1" colspan="1" valign="top" align="left" width="111"> |
| <p> Remove All Terminated Launches </p> |
| </td> |
| <td rowspan="1" colspan="1" valign="top" align="left" width="494"> |
| <p> This command clears all terminated debug targets from the view display. |
| </p> |
| </td> |
| </tr> |
| <tr> |
| <td colspan="1" valign="top" align="left" width="78"><img src="../images/org.eclipse.debug.ui/elcl16/stepbystep_co.png" align="baseline" alt="Step with Filters button"> |
| </td> |
| <td colspan="1" valign="top" align="left" width="111">Use Step Filters</td> |
| <td colspan="1" valign="top" align="left" width="494">This command toggles |
| step filters on/off. When on, all step functions apply step filters.</td> |
| </tr> |
| <tr> |
| <td rowspan="1" colspan="1" valign="top" align="left" width="78"> <img src="../images/org.eclipse.debug.ui/elcl16/stepinto_co.png" align="baseline" alt="Step Into button"> |
| </td> |
| <td rowspan="1" colspan="1" valign="top" align="left" width="111"> |
| <p> Step Into </p> |
| </td> |
| <td rowspan="1" colspan="1" valign="top" align="left" width="494"> |
| <p> This command steps into the highlighted statement. </p> |
| </td> |
| </tr> |
| <tr> |
| <td rowspan="1" colspan="1" valign="top" align="left" width="78"> <img src="../images/org.eclipse.debug.ui/elcl16/stepover_co.png" align="baseline" alt="Step Over button"> |
| </td> |
| <td rowspan="1" colspan="1" valign="top" align="left" width="111"> |
| <p> Step Over </p> |
| </td> |
| <td rowspan="1" colspan="1" valign="top" align="left" width="494"> |
| <p> This command steps over the highlighted statement. Execution will continue |
| at the next line either in the same method or (if you are at the end of |
| a method) it will continue in the method from which the current method |
| was called. </p> |
| <p> The cursor jumps to the declaration of the method and selects this line. |
| </p> |
| </td> |
| </tr> |
| <tr> |
| <td rowspan="1" colspan="1" valign="top" align="left" width="78"> <img src="../images/org.eclipse.debug.ui/elcl16/stepreturn_co.png" align="baseline" alt="Run to Return button"> |
| </td> |
| <td rowspan="1" colspan="1" valign="top" align="left" width="111"> |
| <p> Run to Return </p> |
| </td> |
| <td rowspan="1" colspan="1" valign="top" align="left" width="494"> |
| <p> This command steps out of the current method. This option stops execution |
| after exiting the current method. </p> |
| </td> |
| </tr> |
| <tr> |
| <td rowspan="1" colspan="1" valign="top" align="left" width="78"> <img src="../images/org.eclipse.jdt.debug.ui/obj16/package_obj.png" align="baseline" alt="Show Qualified Names button"> |
| </td> |
| <td rowspan="1" colspan="1" valign="top" align="left" width="111"> |
| <p> Show Qualified Names </p> |
| </td> |
| <td rowspan="1" colspan="1" valign="top" align="left" width="494"> |
| <p> This option can be toggled to display or hide qualified names. </p> |
| </td> |
| </tr> |
| <tr> |
| <td rowspan="1" colspan="1" valign="top" align="left" width="78"> |
| <p> <img src="../images/org.eclipse.debug.ui/elcl16/copy_edit_co.png" align="baseline" alt="Copy Stack command in context menu"><br> |
| Context menu only </p> |
| </td> |
| <td rowspan="1" colspan="1" valign="top" align="left" width="111"> |
| <p> Copy Stack </p> |
| </td> |
| <td rowspan="1" colspan="1" valign="top" align="left" width="494"> |
| <p> This command copies the selected stack of suspended threads as well |
| as the state of the running threads to the clipboard. </p> |
| </td> |
| </tr> |
| <tr> |
| <td rowspan="1" colspan="1" valign="top" align="left" width="78"> |
| <p><img src="../images/org.eclipse.debug.ui/elcl16/drop_to_frame.png" align="baseline" alt="Copy Stack command in context menu"> |
| </p> |
| </td> |
| <td rowspan="1" colspan="1" valign="top" align="left" width="111"> |
| <p> Drop to Frame </p> |
| </td> |
| <td rowspan="1" colspan="1" valign="top" align="left" width="494"> |
| <p> This command lets you drop back and reenter a specified stack frame. |
| This feature is similar to "running backwards" and restarting |
| your program part-way through. </p> |
| <p> To drop back and reenter a specified stack frame, select the stack frame |
| that you want to "drop" to, and select <strong>Drop to Frame</strong>. |
| </p> |
| <p> Some caveats apply to this feature: </p> |
| <ul> |
| <li> You cannot drop past a native method on the stack. </li> |
| <li> Global data are unaffected and will retain their current values. |
| For example, a static vector containing elements will not be cleared. |
| </li> |
| </ul> |
| <em>Note: This command is only enabled if the underlying VM supports this |
| feature.</em> </td> |
| </tr> |
| <tr> |
| <td rowspan="1" colspan="1" valign="top" align="left" width="78"> |
| <p> <img src="../images/org.eclipse.debug.ui/elcl16/runlast_co.png" align="baseline" alt="Relaunch command in context menu"><br> |
| Context menu only </p> |
| </td> |
| <td rowspan="1" colspan="1" valign="top" align="left" width="111"> |
| <p> Relaunch </p> |
| </td> |
| <td rowspan="1" colspan="1" valign="top" align="left" width="494"> |
| <p> This command re-launches the selected debug target. </p> |
| </td> |
| </tr> |
| <tr> |
| <td rowspan="1" colspan="1" valign="top" align="left" width="78"> |
| <p> Context menu only </p> |
| </td> |
| <td rowspan="1" colspan="1" valign="top" align="left" width="111"> |
| <p> Properties </p> |
| </td> |
| <td rowspan="1" colspan="1" valign="top" align="left" width="494"> |
| <p> This command displays the properties of the selected launch. It also |
| allows you to view the full command line for a selected process. </p> |
| </td> |
| </tr> |
| </tbody> |
| </table> |
| <p> |
| |
| </p> |
| <p> |
| <img border="0" src="../images/ngrelc.png" alt="Related concepts" > |
| </p> |
| <p> |
| <a href="../concepts/concepts-10.htm">Debugger</a><br> |
| <a href="../concepts/concepts-6.htm">Java views</a><br> |
| <a href="../concepts/clocdbug.htm">Local debugging</a><br> |
| <a href="../concepts/cremdbug.htm">Remote debugging</a> |
| </p> |
| <p> |
| <img border="0" src="../images/ngrelt.png" alt="Related tasks" > |
| </p> |
| <p> |
| <a href="../tasks/tasks-9.htm">Changing debugger launch options</a><br> |
| <a href="../tasks/tasks-141.htm">Connecting to a remote VM with the Remote Java application launch configuration</a><br> |
| <a href="../tasks/tasks-142.htm">Disconnecting from a VM</a><br> |
| <a href="../tasks/tasks-130.htm">Launching a Java program</a><br> |
| <a href="../tasks/tasks-133.htm">Preparing to debug</a><br> |
| <a href="../tasks/tasks-135.htm">Resuming the execution of suspended threads</a><br> |
| <a href="../tasks/tasks-126.htm">Running and debugging</a><br> |
| <a href="../tasks/tasks-136.htm">Stepping through the execution of a program</a><br> |
| <a href="../tasks/tasks-134.htm">Suspending threads</a> |
| </p> |
| <p> |
| <img border="0" src="../images/ngrelr.png" alt="Related reference" > |
| </p> |
| <p> |
| <a href="preferences/ref-debug.htm">Debug preferences</a><br> |
| <a href="../reference/ref-4.htm">Run and debug actions</a><br> |
| <a href="views/ref-viewsandeditors.htm">Views and editors</a> |
| </p> |
| |
| </body> |
| </html> |
| |