Debugger: Connections

The Connections window manages connections to live debuggers and, at a high level, their targets. Each item is a Trace RMI connection (or a step toward one) to a back-end debugger. Usually, the back end is a native debugger with a plugin that communicates with Ghidra via Trace RMI. These connections are typically established using a launcher script, invoked from the Launcher Menu, though there are actions here for establishing connections manually or to remote back ends. There are different kinds of items displayed in the connection list.

Actions

Connect Outbound

Connect to a back end. The back end plays the role of TCP server while Ghidra plays the TCP client. The dialog prompts for the (possibly remote) back end's host and port. Once the connection is established, the back end takes the role of Trace RMI client, despite being the TCP server. Check the command documentation for your back end's plugin to figure out how to have it listen first.

Connect by Accept

Accept a single connection from a back end. Ghidra plays the role of TCP server, and the back end is the TCP client. The dialog prompts for the host/interface and port on which to listen. Check the command documentation for your back end's plugin to figure out how to have it connect to a listening Ghidra. Once the connection is established, the listening port is closed. The back end plays the role of Trace RMI client.

Close

Right-click a connection or acceptor to access this action. For an acceptor, this will cancel it. For an established connection, this will tear it down, rendering its target traces dead. Note that the back end may retain its live targets, despite losing its connection to Ghidra.

Close All

Burn it all to the ground and start over. This closes the server, cancels all acceptors, and tears down all connections. Any live trace in the Debugger will be rendered dead, which often causes the trace manager to close them. Note that the back ends may retain their live targets, despite losting their connections to Ghidra.

Start Server

Start a persistent server, able to accept many back-end connections. Ghidra plays the role of TCP server, and each back end is a TCP client. The dialog prompts for the host/interface and port on which to listen. Check the command documentation for your back end's plugin to figure out how to have it connect to a listening Ghidra. The listening port remains open no matter how many connections it has accepted. It is still possible to connect by other means while the server is active.

Stop Server

Stop the server. This closes the persistent server. This does not affect pending acceptors or established connections.