Load Process Remote

From RAD Studio
Jump to: navigation, search

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 OS X Debugger is specifically designed for debugging applications that target either a Mac running OS X or the iOS Simulator.
  • Embarcadero iOS32 Device Debugger is specifically designed for debugging applications that target 32-bit and 64-bit iOS devices.
  • Embarcadero iOS64 Device Debugger is specifically designed for debugging applications that target 64-bit iOS devices.
  • Embarcadero Android Debugger is specifically designed for debugging applications that target the Android Device.
    Note: Load Process Remote is not supported for the Embarcadero Android Debugger.

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 multi-device debugging solution, 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 (rmtdbg240).

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 multi-device application.
  • If you are using the old-style remote debugging solution:
    • The remote debug server (such as rmtdbg240.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

Currently not used.


See Also