RDA: The Remote Debugger Agent for GDB

What is RDA?

RDA, the Remote Debugging Agent, provides an interface between GDB (the GNU Debugger) and a runtime environment which is running a program that you wish to debug.

The runtime environment may be (for instance) a native OS running on the same or a different computer system, an OS emulator such as Cygwin, a hardware emulator or software simulator such as PSIM or SID, an embedded OS (eg. eCos) running on a development board, or even a smallish board support library such as RedBoot running under the ROM monitor on a "bare" CPU board. Whatever the runtime environment, RDA presents a common debugging interface to GDB using the GDB Remote Serial Protocol.

News

2005-03-03

	Add support for crc32.

2002-08-21

	Eliminate dependancies on bfd and libiberty.

2001-04-10

	Extended support for signals.

2001-03-15

	Add qe (quality engineering) subdirectory.

2000-12-20

	Support for multi-thread debugging.

2000-11-21

	Native Cygwin implementation.

2000-11-14

	Demo target elaborated to include simulated registers and memory.

2000-09-06

	Native Unix implementation.

2000-04-06

	The RDA package is created by factoring out
	a gdb remote-stub implementation by Andrew Cagney.

Bugs

tbd.

License

RDA is distributed under the terms of the GNU General Public License:

   Copyright 2000, 2001, 2002, 2003, 2004, 2005 Red Hat, Inc.

   This file is part of RDA, the Red Hat Debug Agent (and library).

   This program is free software; you can redistribute it and/or modify
   it under the terms of the GNU General Public License as published by
   the Free Software Foundation; either version 2 of the License, or
   (at your option) any later version.

   This program is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   GNU General Public License for more details.

   You should have received a copy of the GNU General Public License
   along with this program; if not, write to the Free Software
   Foundation, Inc., 59 Temple Place - Suite 330,
   Boston, MA 02111-1307, USA.
   
   Alternative licenses for RDA may be arranged by contacting Red Hat,
   Inc.  

Contributing

Source Code

The source code for RDA is available via anonymous CVS.

At this point in time, there are no stable releases or tar files available; please just use the current cvs tree.

To check out the RDA sources via anonymous CVS, use the following CVS commands:

cvs -d :pserver:anoncvs@sources.redhat.com:/cvs/src login
{enter "anoncvs" as the password}

cvs -d :pserver:anoncvs@sources.redhat.com:/cvs/src get rda

Documentation

The RDA source tree contains several files that will help get you started: notably HOWTO, README, and REMOTE-HACK-RULES. See also the GNU coding standards, and the GDB web pages on contributing.

Sites and links related to RDA

To learn more about RDA, start with the GDB Home Page. Be sure to have a look at "Sites and links related to GDB", and especially the 'gdbstubs' project and the home page for gdbserver.

Mailing List

RDA has a mailing list, rda@sources.redhat.com, which is archived here. You can use this form to subscribe:

Mailing list:   Your e-mail address:
Digest version   subscribe unsubscribe