The RemoteGDB API.

These methods relate to the BaseRemoteGDB and BaseGdbRegCache interfaces. More...

Functions
virtual char *	BaseGdbRegCache::data () const =0
	Return the pointer to the raw bytes buffer containing the register values. More...
virtual size_t	BaseGdbRegCache::size () const =0
	Return the size of the raw buffer, in bytes (i.e., half of the number of digits in the g/G packet). More...
virtual void	BaseGdbRegCache::getRegs (ThreadContext *)=0
	Fill the raw buffer from the registers in the ThreadContext. More...
virtual void	BaseGdbRegCache::setRegs (ThreadContext *) const =0
	Set the ThreadContext's registers from the values in the raw buffer. More...
virtual const std::string	BaseGdbRegCache::name () const =0
	Return the name to use in places like DPRINTF. More...
	BaseGdbRegCache::BaseGdbRegCache (BaseRemoteGDB *g)
	BaseRemoteGDB::BaseRemoteGDB (System *system, ThreadContext *context, int _port)
	Interface to other parts of the simulator. More...
virtual	BaseRemoteGDB::~BaseRemoteGDB ()
std::string	BaseRemoteGDB::name ()
void	BaseRemoteGDB::listen ()
void	BaseRemoteGDB::connect ()
int	BaseRemoteGDB::port () const
void	BaseRemoteGDB::attach (int fd)
void	BaseRemoteGDB::detach ()
bool	BaseRemoteGDB::isAttached ()
void	BaseRemoteGDB::replaceThreadContext (ThreadContext *_tc)
bool	BaseRemoteGDB::trap (int type)
bool	BaseRemoteGDB::breakpoint ()

Detailed Description

These methods relate to the BaseRemoteGDB and BaseGdbRegCache interfaces.

Function Documentation

attach()

void BaseRemoteGDB::attach

(

int

fd

)

Definition at line 382 of file remote_gdb.cc.

References BaseRemoteGDB::attached, BaseRemoteGDB::dataEvent, DPRINTFN, ArmISA::f, BaseRemoteGDB::fd, pollQueue, and PollQueue::schedule().

Referenced by BaseRemoteGDB::connect().

BaseGdbRegCache()

BaseGdbRegCache::BaseGdbRegCache ( BaseRemoteGDB *  g )

inline

Definition at line 119 of file remote_gdb.hh.

BaseRemoteGDB()

BaseRemoteGDB::BaseRemoteGDB	(	System *	system,
		ThreadContext *	context,
		int	_port
	)

Interface to other parts of the simulator.

Definition at line 317 of file remote_gdb.cc.

References debuggers.

breakpoint()

bool BaseRemoteGDB::breakpoint ( )

inline

Definition at line 158 of file remote_gdb.hh.

References BaseRemoteGDB::trap().

connect()

void BaseRemoteGDB::connect

(

)

Definition at line 358 of file remote_gdb.cc.

References ListenSocket::accept(), BaseRemoteGDB::attach(), BaseRemoteGDB::isAttached(), ListenSocket::islistening(), BaseRemoteGDB::listener, and panic_if.

Referenced by BaseRemoteGDB::connectWrapper().

data()

virtual char* BaseGdbRegCache::data ( ) const

pure virtual

Return the pointer to the raw bytes buffer containing the register values.

Each byte of this buffer is literally encoded as two hex digits in the g or G RSP packet.

Implemented in X86ISA::RemoteGDB::AMD64GdbRegCache, ArmISA::RemoteGDB::AArch64GdbRegCache, SparcISA::RemoteGDB::SPARC64GdbRegCache, X86ISA::RemoteGDB::X86GdbRegCache, ArmISA::RemoteGDB::AArch32GdbRegCache, MipsISA::RemoteGDB::MipsGdbRegCache, RiscvISA::RemoteGDB::RiscvGdbRegCache, SparcISA::RemoteGDB::SPARCGdbRegCache, and PowerISA::RemoteGDB::PowerGdbRegCache.

Referenced by BaseRemoteGDB::cmd_reg_r(), and BaseRemoteGDB::cmd_reg_w().

detach()

void BaseRemoteGDB::detach

(

)

Definition at line 394 of file remote_gdb.cc.

References BaseRemoteGDB::active, BaseRemoteGDB::attached, BaseRemoteGDB::clearSingleStep(), BaseRemoteGDB::dataEvent, DPRINTFN, BaseRemoteGDB::fd, pollQueue, and PollQueue::remove().

Referenced by BaseRemoteGDB::cmd_detach(), BaseRemoteGDB::incomingData(), and BaseRemoteGDB::trap().

getRegs()

virtual void BaseGdbRegCache::getRegs ( ThreadContext *  )

pure virtual

Fill the raw buffer from the registers in the ThreadContext.

Implemented in X86ISA::RemoteGDB::AMD64GdbRegCache, ArmISA::RemoteGDB::AArch64GdbRegCache, SparcISA::RemoteGDB::SPARC64GdbRegCache, X86ISA::RemoteGDB::X86GdbRegCache, ArmISA::RemoteGDB::AArch32GdbRegCache, MipsISA::RemoteGDB::MipsGdbRegCache, RiscvISA::RemoteGDB::RiscvGdbRegCache, SparcISA::RemoteGDB::SPARCGdbRegCache, and PowerISA::RemoteGDB::PowerGdbRegCache.

Referenced by BaseRemoteGDB::trap().

isAttached()

bool BaseRemoteGDB::isAttached ( )

inline

Definition at line 153 of file remote_gdb.hh.

References BaseRemoteGDB::attached.

Referenced by BaseRemoteGDB::connect().

listen()

void BaseRemoteGDB::listen

(

)

Definition at line 338 of file remote_gdb.cc.

References BaseRemoteGDB::_port, ListenSocket::allDisabled(), ccprintf(), BaseRemoteGDB::connectEvent, curTick(), DPRINTF, ListenSocket::getfd(), ListenSocket::listen(), BaseRemoteGDB::listener, BaseRemoteGDB::name(), pollQueue, PollQueue::schedule(), and warn_once.

name() [1/2]

string BaseRemoteGDB::name

(

)

Definition at line 332 of file remote_gdb.cc.

References SimObject::name(), and BaseRemoteGDB::sys.

Referenced by BaseRemoteGDB::listen(), PowerISA::RemoteGDB::PowerGdbRegCache::name(), SparcISA::RemoteGDB::SPARCGdbRegCache::name(), MipsISA::RemoteGDB::MipsGdbRegCache::name(), RiscvISA::RemoteGDB::RiscvGdbRegCache::name(), ArmISA::RemoteGDB::AArch32GdbRegCache::name(), X86ISA::RemoteGDB::X86GdbRegCache::name(), SparcISA::RemoteGDB::SPARC64GdbRegCache::name(), ArmISA::RemoteGDB::AArch64GdbRegCache::name(), X86ISA::RemoteGDB::AMD64GdbRegCache::name(), and HardBreakpoint::name().

name() [2/2]

virtual const std::string BaseGdbRegCache::name ( ) const

pure virtual

Return the name to use in places like DPRINTF.

Having each concrete superclass redefine this member is useful in situations where the class of the regCache can change on the fly.

Implemented in X86ISA::RemoteGDB::AMD64GdbRegCache, ArmISA::RemoteGDB::AArch64GdbRegCache, SparcISA::RemoteGDB::SPARC64GdbRegCache, X86ISA::RemoteGDB::X86GdbRegCache, ArmISA::RemoteGDB::AArch32GdbRegCache, MipsISA::RemoteGDB::MipsGdbRegCache, RiscvISA::RemoteGDB::RiscvGdbRegCache, SparcISA::RemoteGDB::SPARCGdbRegCache, and PowerISA::RemoteGDB::PowerGdbRegCache.

port()

int BaseRemoteGDB::port

(

)

const

Definition at line 374 of file remote_gdb.cc.

References BaseRemoteGDB::_port, ListenSocket::islistening(), BaseRemoteGDB::listener, and panic_if.

replaceThreadContext()

void BaseRemoteGDB::replaceThreadContext ( ThreadContext *  _tc )

inline

Definition at line 155 of file remote_gdb.hh.

References BaseRemoteGDB::tc.

setRegs()

virtual void BaseGdbRegCache::setRegs ( ThreadContext *  ) const

pure virtual

Set the ThreadContext's registers from the values in the raw buffer.

Implemented in X86ISA::RemoteGDB::AMD64GdbRegCache, ArmISA::RemoteGDB::AArch64GdbRegCache, SparcISA::RemoteGDB::SPARC64GdbRegCache, X86ISA::RemoteGDB::X86GdbRegCache, ArmISA::RemoteGDB::AArch32GdbRegCache, MipsISA::RemoteGDB::MipsGdbRegCache, RiscvISA::RemoteGDB::RiscvGdbRegCache, SparcISA::RemoteGDB::SPARCGdbRegCache, and PowerISA::RemoteGDB::PowerGdbRegCache.

Referenced by BaseRemoteGDB::cmd_reg_w().

size()

virtual size_t BaseGdbRegCache::size ( ) const

pure virtual

Return the size of the raw buffer, in bytes (i.e., half of the number of digits in the g/G packet).

Implemented in X86ISA::RemoteGDB::AMD64GdbRegCache, ArmISA::RemoteGDB::AArch64GdbRegCache, SparcISA::RemoteGDB::SPARC64GdbRegCache, X86ISA::RemoteGDB::X86GdbRegCache, ArmISA::RemoteGDB::AArch32GdbRegCache, MipsISA::RemoteGDB::MipsGdbRegCache, RiscvISA::RemoteGDB::RiscvGdbRegCache, SparcISA::RemoteGDB::SPARCGdbRegCache, and PowerISA::RemoteGDB::PowerGdbRegCache.

Referenced by BaseRemoteGDB::cmd_reg_r(), and BaseRemoteGDB::cmd_reg_w().

trap()

bool BaseRemoteGDB::trap

(

int

type

)

Definition at line 412 of file remote_gdb.cc.

References BaseRemoteGDB::active, BaseRemoteGDB::attached, BaseRemoteGDB::clearSingleStep(), BaseRemoteGDB::GdbCommand::Context::cmd, BaseRemoteGDB::GdbCommand::Context::cmd_byte, BaseRemoteGDB::command_map, csprintf(), data, BaseRemoteGDB::GdbCommand::Context::data, BaseRemoteGDB::detach(), DPRINTF, ArmISA::e, BaseRemoteGDB::GdbCommand::func, BaseRemoteGDB::gdbRegs(), BaseGdbRegCache::getRegs(), BaseRemoteGDB::GdbCommand::Context::len, panic, ThreadContext::pcState(), BaseRemoteGDB::recv(), BaseRemoteGDB::regCachePtr, BaseRemoteGDB::send(), BaseRemoteGDB::tc, BaseRemoteGDB::GdbCommand::Context::type, type, and warn.

Referenced by BaseRemoteGDB::breakpoint(), HardBreakpoint::process(), BaseRemoteGDB::TrapEvent::process(), and BaseRemoteGDB::singleStep().

~BaseRemoteGDB()

virtual BaseRemoteGDB::~BaseRemoteGDB ( )

virtual