Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
swdev:howto:remote_debug_delphi_application [2009/06/26 11:52]
smayr
swdev:howto:remote_debug_delphi_application [2009/06/26 12:17] (current)
smayr
Line 1: Line 1:
 == Remote Debug a Delphi Application == == Remote Debug a Delphi Application ==
 +Source: Borland Developer Studio 2006 Help.
  
 === Installing a Debbuger on Remote Machine === === Installing a Debbuger on Remote Machine ===
-Source: Borland Developer Studio 2006 Help. 
- 
  
 To install the remote debugger if the installation disk is not available To install the remote debugger if the installation disk is not available
Line 23: Line 22:
  
 === Establishing a Connection for Remote Debugging === === Establishing a Connection for Remote Debugging ===
-Source: Borland Developer Studio 2006 Help 
  
 You must establish a TCP/IP connection between the local and remote machines in preparation for remote debugging. This connection uses multiple ports that are chosen dynamically by Windows. The remote debug server listens on one port, and a separate port is opened for each application that is being debugged. A firewall that only allows connections to the listening port will prevent the remote debugger from working. You must establish a TCP/IP connection between the local and remote machines in preparation for remote debugging. This connection uses multiple ports that are chosen dynamically by Windows. The remote debug server listens on one port, and a separate port is opened for each application that is being debugged. A firewall that only allows connections to the listening port will prevent the remote debugger from working.
Line 31: Line 29:
 **Warning:** The connection between Developer Studio 2006 and the remote debug server is a simple TCP/IP socket, with neither encryption nor authentication support. Therefore, the remote debug server should not be run on a computer that can be accessed over the network by untrusted clients. **Warning:** The connection between Developer Studio 2006 and the remote debug server is a simple TCP/IP socket, with neither encryption nor authentication support. Therefore, the remote debug server should not be run on a computer that can be accessed over the network by untrusted clients.
    
- 
 To connect the local machine and the remote machine To connect the local machine and the remote machine
    
Line 47: Line 44:
 **Note:** You cannot interact directly with the remote application through the remote debugger. For interactive debugging, you can establish a remote desktop connection. **Note:** You cannot interact directly with the remote application through the remote debugger. For interactive debugging, you can establish a remote desktop connection.
    
 +=== Preparing Files for Remote Debugging ===
 + 
 +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
 + 
 + * Open the project on your local machine. 
 + * Choose Project > Options > Linker and verify 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 for Win32 | .rsm |
 +| Delphi for .NET  | .rsm and .pdb |
 +| C++              | .tds |
 +| C#               | .pdb |
  
 + * Compile the project on your local machine. 
 + * Copy the executable files and symbol files for the project to the remote machine. 
 + * Choose Run > Load Process 
 + * Specify the directory into which you copied the symbol files in the Debug symbols search path field. 
 + * Click OK.