diff --git a/doc/org.eclipse.cdt.doc.user/images/cdt_debug_exes01.png b/doc/org.eclipse.cdt.doc.user/images/cdt_debug_exes01.png new file mode 100644 index 00000000000..a834735ca8b Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/images/cdt_debug_exes01.png differ diff --git a/doc/org.eclipse.cdt.doc.user/images/cdt_debug_exes02.png b/doc/org.eclipse.cdt.doc.user/images/cdt_debug_exes02.png new file mode 100644 index 00000000000..80d4b3f1e80 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/images/cdt_debug_exes02.png differ diff --git a/doc/org.eclipse.cdt.doc.user/images/cdt_debug_exes03.png b/doc/org.eclipse.cdt.doc.user/images/cdt_debug_exes03.png new file mode 100644 index 00000000000..4a30d50dde6 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/images/cdt_debug_exes03.png differ diff --git a/doc/org.eclipse.cdt.doc.user/images/cdt_debug_exes04.png b/doc/org.eclipse.cdt.doc.user/images/cdt_debug_exes04.png new file mode 100644 index 00000000000..6c3051a6ef4 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/images/cdt_debug_exes04.png differ diff --git a/doc/org.eclipse.cdt.doc.user/images/cdt_debug_exes05.png b/doc/org.eclipse.cdt.doc.user/images/cdt_debug_exes05.png new file mode 100644 index 00000000000..b6c958213ff Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/images/cdt_debug_exes05.png differ diff --git a/doc/org.eclipse.cdt.doc.user/tasks/cdt_o_debug.htm b/doc/org.eclipse.cdt.doc.user/tasks/cdt_o_debug.htm index 5bdd6fadbe8..6e0c14ec21b 100644 --- a/doc/org.eclipse.cdt.doc.user/tasks/cdt_o_debug.htm +++ b/doc/org.eclipse.cdt.doc.user/tasks/cdt_o_debug.htm @@ -15,6 +15,7 @@

This section explains how to debug your project.

Debugging a program
+ Debugging an existing executable
Working with breakpoints and watchpoints
Adding breakpoints
Adding watchpoints
diff --git a/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_debug_exes.htm b/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_debug_exes.htm new file mode 100644 index 00000000000..46c166599cd --- /dev/null +++ b/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_debug_exes.htm @@ -0,0 +1,51 @@ + + + + + + +Debugging Existing Executables + + + + + +

Debugging an Existing Executable

+

Use the import feature to import and debug an executable you have already built. This feature will automatically create a project and debug configuration for you. This is helpful if you have an executable built with debug symbols but may not have the project used to build the executable.

+ +

Importing Executables for Debugging

+
    +
  1. Select the File > Import... menu item + to open the Import wizard dialog: +

    +
  2. +
  3. Select C/C++ Executable, then click Next to open the Import Executable wizard.
  4. +
  5. Enter the executable path in the Select Executable field or click Browse to locate the executable.
  6. +

    Use Select Executable to choose a single executable or Search Directory to select one or more executables to import from the specified directory.

    +

    +

    NOTE You can import any executable, but only those built with debug symbols will be let you step through source code and see variable values.

    +
  7. Click Next to see the Choose Project page
  8. +

    Use the Choose Project page to create a new project (you can use the default name assigned) and debug configuration. You can import executables into a new project or an existing one. The new project is configured to hold the executable, but not to build anything.

    +

    +

    Select from the menu of launch configuration types to select one for debugging. This launch configuration will be created for you with default settings for debugging your executable.

    +
  9. Click Finish
  10. +

    The executable is added to the C/C++ Projects view and the Launch configuration window appears..

    +

    +
  11. Click Debug
  12. +

    The debugger launches and you can begin debugging the executable.

    +
  13. Setting breakpoints
  14. +

    Expand the executable in the C++ Projects view to see the list of source files. Only executables built with debug symbols will show a list of source files. The source files can be opened in the editor so you can set breakpoints. Use these files only for debugging, you can not change them and rebuild the executable with this project.

    +

    C++ Projects View

    +
+ +

Related concepts
+ Debug overview
+ Debug information

+

Related tasks
+ Debugging

+

Related reference
+ Run and Debug dialog box

+
 
+ + + diff --git a/doc/org.eclipse.cdt.doc.user/topics_Tasks.xml b/doc/org.eclipse.cdt.doc.user/topics_Tasks.xml index 60f699027bf..3586463c540 100644 --- a/doc/org.eclipse.cdt.doc.user/topics_Tasks.xml +++ b/doc/org.eclipse.cdt.doc.user/topics_Tasks.xml @@ -62,6 +62,7 @@ +