Attach to Process

Go Up to Run Menu

Run > Attach to Process

Debugs a process that is currently running on either your local computer, a remote PC, or a multi-device target platform.

Item	Description
Debugger	Select the debugger you want to use to debug the 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 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 iOS devices. Note: Attach to Process is not supported for the Embarcadero iOS32 Device Debugger. Embarcadero iOS64 Device Debugger is specifically designed for debugging applications that target 64-bit iOS devices. Note: Attach to Process is not supported for the Embarcadero iOS64 Device Debugger. Embarcadero Android Debugger is specifically designed for debugging applications that target Android devices. Note: Attach to Process is not supported for the Embarcadero Android Debugger.
Remote machine	Complete this field according to the debugging solution you are using: If you are using the new remote and multi-device debugging solution that uses the Platform Assistant and a connection profile, you must: Click the ellipsis button [...]. On the Select Connection Profile dialog box, select an existing connection profile or create a new one that you want to use for this remote process. The Remote Machine name is then taken from the Host name field in the connection profile. When you mouse-over the field, the Profile and Host names are displayed in a tool tip hint, whereas no tool tip appears for a Remote Machine name that you entered explicitly. When you click OK on the Select Connection Profile dialog box, the debugger immediately tries the connection with the remote machine. You need to ensure a working connection between your development system and the target platform where the process is running. See Working with a Mac and a PC or Connecting Your 32-bit PC to a Win64 PC. If you are using the old-style remote debugging solution: The remote debug server (such as rmtdbg230.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 somehost:8000 or 127.0.0.1:8000. Otherwise, the default port 64447 is used.
Running processes	Lists the processes currently running on the local machine or, if specified, the remote machine (the Remote Debug Server must be running).
Image Name	Lists the name of the process.
PID	Lists the process identifier of the process.
Path	Lists the location of the process.
Show system processes	Includes system processes in the Running Processes list.
Pause after attach	Pauses the process after the debugger attaches to it and displays the CPU View. You will need to run, step, or trace to resume execution.
Refresh	Refreshes and redisplays the list of running processes.
Attach	Attaches the debugger to the selected process and, if Pause after attach is enabled, displays the CPU window. The Attach button is disabled for the IDE itself or for any process that you have already attached to with the debugger.

See Also

• Attaching to a Running Process
• Starting the Debugger
• Detach From Program