Go Up to Run Menu
Run > Load Process > Remote
Connects to a remote computer running the remote debug server and starts a remote debugging session.
| Item
|
Description
|
|
Debugger
|
Select the debugger that matches the target platform of the remote process:
- Embarcadero Win32 Debugger is the default embedded debugger for 32-bit Windows applications.
- Embarcadero Win64 Debugger is specifically designed for debugging applications that target 64-bit Windows.
- Embarcadero Mac OS X Debugger is specifically designed for debugging cross-platform applications that target a Mac running OS X or the iOS simulator.
- Embarcadero iOS Device Debugger is specifically designed for debugging cross-platform applications that target iOS devices. However, loading a process is not supported.
|
|
Remote Path
|
Specifies the path to the executable of the process that you want to load.
Complete this field according to the debugging solution you are using:
- If you are using the new remote and cross-platform debugging solution that utilizes the Platform Assistant server and a connection profile, enter the path in either of the following ways:
- As an absolute path to the process you want to load
- As a relative path that starts with
./ (dot-slash), which is preloaded in this field. A ./ (dot-slash) path is relative to the connection profile directory on the machine running the Platform Assistant server (the default location of output files associated with the current connection profile). That is, a Remote Path that starts with ./ (dot-slash) is relative to the username-profilename directory on the target machine. For more information about the directories associated with the Platform Assistant and with connection profiles, see The Scratch Directory.
- If you are using the old-style remote debugging solution, enter the path to the executable file on the remote computer. In this case, the Remote Path is relative to the directory that contains the remote debug server (rmtdbg<nnn>).
|
|
Remote Host
|
Specifies the name or TCP/IP address of the remote computer on which the remote process is running.
Complete this field according to the debugging solution you are using:
- These two steps enable you to use the integrated debugger in the IDE for debugging a remote or cross-platform application.
- If you are using the old-style remote debugging solution:
- The remote debug server (such as rmtdbg<nnn>.exe for 32-bit Windows) must be running on the remote computer. There are different sets of remote debug server files for each supported target platform.
- If a port was specified when starting the remote debug server, enter a colon after the host name, followed by the port. For example, if you specified port 8000, specify the remote host as
hostname:8000 or 127.0.0.1:8000. Otherwise, the default port 64447 is used.
|
|
Parameters
|
Enter the command-line arguments you want to pass to your application (or the host application) when it starts.
|
|
Working Directory
|
Enter the name of the directory to use for the debugging process. By default, this is the same directory as the one containing the executable of your application.
|
|
After load
|
Specifies the code (if any) that is to be executed after loading the process. Choose from the following options:
|
Do not run
|
Equivalent to starting a debug session with Run > Trace Into (F7),
|
Loads the executable but does not run it.
|
|
Run to program entry point
|
Equivalent to starting a debug session with Run > Step Over (F8)
|
For C++ only; runs to the first entry point, such as main().
|
|
Run to first source
|
Equivalent to starting a debug session with Run > Trace to Next Source Line (Shift+F7)
|
Runs to the first source line.
|
|
Run
|
Equivalent to starting a debug session with Run > Run (F9)
|
Runs the process to completion, under the control of the debugger.
|
|
|
Use launcher application
|
Displayed only when a Mac OS X target is selected in the Debugger field. Opens a separate terminal window for debugging on the Mac OS X target platform (to avoid using the terminal window of the running instance of the Platform Assistant).
By default, no launcher application is used, but the path to Xterm appears in the command-line field. To launch Xterm, enable the checkbox. You can also change the path or enter a different command line to start a terminal window of your choice on the Mac.
|
See Also