Preparing Files for Remote Debugging

Go Up to Remote Debugging - Old-Style Procedures

Note: This topic describes how to prepare files for debugging using the old-style remote debugger.
Note: The new remote and cross-platform debugging solution uses the Platform Assistant and a remote profile. Although the old-style remote debugging solution is still supported, we recommend that you use the new-style solution (using the Platform Assistant and a remote profile), a combination that enables you to:

• Use the integrated debugger to debug both remote and cross-platform applications.
• Use the Deployment Manager to configure and deploy your applications.

Executable files and symbol files must be copied to the remote machine after they are compiled. You must set the correct options on your local machine in order to generate these files.

To prepare files for debugging on a remote machine:

1. Open the project on your local machine.
2. For Delphi, choose Project > Options > Linking and ensure that the Include remote debug symbols option is checked. This directs the compiler to generate a symbol file. The following extensions are used in symbol files (for Delphi projects):

Language	Debug symbol file extension
Delphi	.rsm
C++	.tds

Delphi Note: It is also important to remember when setting your project's compiler and linker options, that Optimization should be turned off, and Stack Frames turned on (on the Compiling page), just as when you are debugging locally. To verify that compiler and linker options are set correctly for debugging, open the Project Manager, double-click the Debug build configuration to select the Debug build, and then right-click Edit .

3. Compile the project on your local machine.
4. Copy the executable files and symbol files for the project to the remote machine.
5. Choose Run > Load Process .
6. Specify the directory into which you copied the symbol files in the Debug symbols search path field.
7. Click OK.

See Also

• Overview of Remote Debugging
• Installing a Debugger on a Remote Machine
• Establishing a Connection for Remote Debugging
• Installing, Starting, and Stopping the Remote Debug Server
• Setting the Search Order for Debug Symbol Tables
• Debugger Options
• Debugger Symbol Tables
• Debugging Cross-Platform Applications (New Remote Debugging Solution)