Show: Delphi C++
Display Preferences

Overview of Remote Debugging

From RAD Studio XE3
Jump to: navigation, search

Go Up to Debugging Applications Index

Note: This topic describes the old-style remote debugging solution, which has been superceded by the new cross-platform and remote debugging solution. You can, however, continue to use the old-style procedures and debugger just as they are described here.
To use the new debugging solution to debug a remote process, you must install and run the Platform Assistant on the remote system and create a remote profile that verifies the connection. See Debugging Cross-Platform Applications for information about the new cross-platform and remote debugging solution.

Remote debugging enables you to debug one or more applications on a remote machine when the IDE is running only on your local machine. This allows debugging on a machine where it is impractical to install the entire IDE and rebuild a project. Remote debugging is useful for applications that run differently on your local machine than on an end user's machine.

Contents

The Remote Debugger Executable

The remote debugger executable is named rmtdbg<nnn>.exe. The executable and its supporting files must be present on the remote machine. Use the Platform Assistant to install the remote debugger and the cross-platform debugging files. For instructions, see Installing and Running the Platform Assistant on the Target Platform.

Local and Remote Files

Three types of files are involved in remote debugging:

  • Source files
  • Executable files
  • Symbol files

Diagram

Source files are compiled using the IDE on the local machine. The executable files and symbol files produced after compilation must be copied to the remote machine.

Source Files

When you debug a project on a remote machine, the source files for the project must be open on the local machine. The source files display in the editor window to show a program's current execution point. You do not use source files on the remote machine.

Executable Files

Executable files are the .dll files and .exe files that are mapped into the application's address space. You generate these files on the local machine, then copy them to the remote machine.

Symbol Files

Symbol files are generated on the local machine at compile time. These are used by the debugger to get information such as the mapping of machine instructions to source line numbers or the names and types of variables declared in the source files. The extension for the symbol files depends on the language, as shown in the following table:

Language Debug symbol file extension

Delphi

.rsm

C++

.tds



You must set up specific options to generate symbol files on the local machine, then copy the files to the remote machine.

Local and Remote Machines

To use remote debugging, you must be able to log on to the remote machine and you must have write access to at least one directory.

Note: The remote debugger does not provide a mechanism for interacting with an application on the remote machine. If you need to interact with the application, you must establish a remote desktop connection:

See Also

Personal tools
Previous Versions
In other languages