new-frankie-carbone new-generic-pcie-switch
Simics Reference Manual  /  3 Commands  /  3.2 Command List  / 

new-gdb-remote

Synopsis

new-gdb-remote ["name"] [port] [cpu] ["architecture"] [context] [-disallow-remote-commands] [-ipv4]

Description

Starts listening to incoming connection requests from GDB sessions (provided that a configuration has been loaded). Simics will listen to TCP/IP requests on the port specified by port, or 9123 by default. If port is set to zero, an arbitrary free port will be selected.

The gdb-remote object will get a name assigned automatically unless one is specified using name.

A processor to connect to should be specified using the cpu argument, the GDB session will follow the execution on that particular processor. It will see all code that runs on that processor: user processes, operating system, hypervisor, everything. If no cpu argument is given the current cpu object will be used.

The architecture argument can be used to specify a particular architecture for the GDB session. It should be the architecture name used by Simics and not the GDB architecture name. For example, if you are debugging a 32-bit program on a 64-bit x86 processor, you may want to specify x86 as architecture and run set architecture i386 in GDB before connecting. For 64-bit PowerPC platforms set this argument to ppc32 to debug a 32-bit program. If not given, the architecture of the specified processor will be used.

The -disallow-remote-commands argument will prevent the client from using the monitor command, which sends a qRcmd message, to perform any Simics CLI command over the remote connection.

In GDB, use the command target remote host:port to connect to Simics. Upon connection GDB assumes that the simulation is paused. GDB also assumes that it has full 'run control' (continue, step, next, etc.) and will be confused if simulation also is controlled by other means, such as using Simics commands.

Provided By

gdb-remote
new-frankie-carbone new-generic-pcie-switch