Applied patches from Tony.Thompson@arm.com to implement the Angel remote

debugging interface and resurrected associated RDI files.

1 files changed, 511 insertions, 0 deletions

diff --git a/gdb/rdi-share/dbg_rdi.h b/gdb/rdi-share/dbg_rdi.h
new file mode 100644
index 0000000..efda7bd
--- /dev/null
+++ b/gdb/rdi-share/dbg_rdi.h
@@ -0,0 +1,511 @@
+/* 
+ * Copyright (C) 1995 Advanced RISC Machines Limited. All rights reserved.
+ * 
+ * This software may be freely used, copied, modified, and distributed
+ * provided that the above copyright notice is preserved in all copies of the
+ * software.
+ */
+
+/*
+ * ARM debugger toolbox : dbg_rdi.h
+ */
+
+/*
+ * RCS $Revision$
+ * Checkin $Date$
+ */
+
+#ifndef dbg_rdi__h
+#define dbg_rdi__h
+
+/***************************************************************************\
+*                            Other RDI values                               *
+\***************************************************************************/
+
+#define RDISex_Little           0 /* the byte sex of the debuggee       */
+#define RDISex_Big              1
+#define RDISex_DontCare         2
+
+#define RDIPoint_EQ             0 /* the different types of break/watchpoints */
+#define RDIPoint_GT             1
+#define RDIPoint_GE             2
+#define RDIPoint_LT             3
+#define RDIPoint_LE             4
+#define RDIPoint_IN             5
+#define RDIPoint_OUT            6
+#define RDIPoint_MASK           7
+
+#define RDIPoint_16Bit          16  /* 16-bit breakpoint                */
+#define RDIPoint_Conditional    32
+
+/* ORRed with point type in extended RDP break and watch messages       */
+#define RDIPoint_Inquiry        64
+#define RDIPoint_Handle         128 /* messages                         */
+
+#define RDIWatch_ByteRead       1 /* types of data accesses to watch for*/
+#define RDIWatch_HalfRead       2
+#define RDIWatch_WordRead       4
+#define RDIWatch_ByteWrite      8
+#define RDIWatch_HalfWrite      16
+#define RDIWatch_WordWrite      32
+
+#define RDIReg_R15              (1L << 15) /* mask values for CPU       */
+#define RDIReg_PC               (1L << 16)
+#define RDIReg_CPSR             (1L << 17)
+#define RDIReg_SPSR             (1L << 18)
+#define RDINumCPURegs           19
+
+#define RDINumCPRegs            10 /* current maximum                   */
+
+#define RDIMode_Curr            255
+
+/* RDI_Info subcodes */
+/* rdp in parameters are all preceded by                                */
+/*   in byte = RDP_Info, word = info subcode                            */
+/*     out parameters are all preceded by                               */
+/*   out byte = RDP_Return                                              */
+
+#define RDIInfo_Target          0
+/* rdi: out ARMword *targetflags, out ARMword *processor id             */
+/* rdp: in none, out word targetflags, word processorid, byte status    */
+/* the following bits are defined in targetflags                        */
+#  define RDITarget_LogSpeed                  0x0f
+#  define RDITarget_HW                        0x10    /* else emulator  */
+#  define RDITarget_AgentMaxLevel             0xe0
+#  define RDITarget_AgentLevelShift       5
+#  define RDITarget_DebuggerMinLevel         0x700
+#  define RDITarget_DebuggerLevelShift    8
+#  define RDITarget_CanReloadAgent           0x800
+#  define RDITarget_CanInquireLoadSize      0x1000
+#  define RDITarget_UnderstandsRDPInterrupt 0x2000
+#  define RDITarget_CanProfile              0x4000
+#  define RDITarget_Code16                  0x8000
+#  define RDITarget_HasCommsChannel        0x10000
+
+#define RDIInfo_Points          1
+/* rdi: out ARMword *pointcapabilities                                  */
+/* rdp: in none, out word pointcapabilities, byte status                */
+/* the following bits are defined in pointcapabilities                  */
+#  define RDIPointCapability_Comparison   1
+#  define RDIPointCapability_Range        2
+/* 4 to 128 are RDIWatch_xx{Read,Write} left-shifted by two */
+#  define RDIPointCapability_Mask         0x100
+#  define RDIPointCapability_ThreadBreak  0x200
+#  define RDIPointCapability_ThreadWatch  0x400
+#  define RDIPointCapability_CondBreak    0x800
+#  define RDIPointCapability_Status       0x1000 /* status enquiries available */
+
+#define RDIInfo_Step            2
+/* rdi: out ARMword *stepcapabilities                                   */
+/* rdp: in none, out word stepcapabilities, byte status                 */
+/* the following bits are defined in stepcapabilities                   */
+#  define RDIStep_Multiple      1
+#  define RDIStep_PCChange      2
+#  define RDIStep_Single        4
+
+#define RDIInfo_MMU             3
+/* rdi: out ARMword *mmuidentity                                        */
+/* rdp: in none, out word mmuidentity, byte status                      */
+
+#define RDIInfo_DownLoad        4
+/* Inquires whether configuration download and selection is available.  */
+/* rdp: in none, out byte status                                        */
+/* No argument, no return value. status == ok if available              */
+
+#define RDIInfo_SemiHosting     5
+/* Inquires whether RDISemiHosting_* RDI_Info calls are available.      */
+/* rdp: in none, out byte status                                        */
+/* No argument, no return value. status == ok if available              */
+
+#define RDIInfo_CoPro           6
+/* Inquires whether CoPro RDI_Info calls are available.                 */
+/* rdp: in none, out byte status                                        */
+/* No argument, no return value. status == ok if available              */
+
+#define RDIInfo_Icebreaker      7
+/* Inquires whether debuggee controlled by IceBreaker.                  */
+/* rdp: in none, out byte status                                        */
+/* No argument, no return value. status == ok if available              */
+
+#define RDIMemory_Access        8
+/* rdi: out RDI_MemAccessStats *p, in ARMword *handle                   */
+/* rdp: in word handle                                                  */
+/*      out word nreads, word nwrites, word sreads, word swrites,       */
+/*          word ns, word s, byte status                                */
+
+/* Get memory access information for memory block with specified handle */
+
+#define RDIMemory_Map           9
+/* rdi: in  RDI_MemDescr md[n], in ARMword *n                           */
+/* rdp: in word n, n * {                                                */
+/*           word handle, word start, word limit,                       */
+/*           byte width, byte access                                    */
+/*           word Nread_ns, word Nwrite_ns,                             */
+/*           word Sread_ns, word Swrite_ns}                             */
+/*      out byte status                                                 */
+/* Sets memory characteristics.                                         */
+
+#define RDISet_CPUSpeed         10
+/* rdi: in  ARMword *speed                                              */
+/* rdp: in word speed, out byte status                                  */
+/* Sets CPU speed (in ns)                                               */
+
+#define RDIRead_Clock           12
+/* rdi: out ARMword *ns, out ARMword *s                                 */
+/* rdp: in none, out word ns, word s, byte status                       */
+/* Reads simulated time                                                 */
+
+#define RDIInfo_Memory_Stats    13
+/* Inquires whether RDI_Info codes 8-10 are available                   */
+/* rdp: in none, out byte status                                        */
+/* No argument, no return value. status == ok if available              */
+
+/* The next two are only to be used if RDIInfo_DownLoad returned no     */
+/* error                                                                */
+#define RDIConfig_Count         14
+/* rdi: out ARMword *count                                              */
+/* rdp: out byte status, word count (if status == OK)                   */
+
+/* In addition, the next one is only to be used if RDIConfig_Count      */
+/* returned no error                                                    */
+typedef struct { unsigned32 version; char name[32]; } RDI_ConfigDesc;
+#define RDIConfig_Nth           15
+/* rdi: in ARMword *n, out RDI_ConfigDesc *                             */
+/* rdp: in word n                                                       */
+/*      out word version, byte namelen, bytes * bytelen name,           */
+/*          byte status                                                 */
+
+/* Set a front-end polling function to be used from within driver poll  */
+/* loops                                                                */
+typedef void RDI_PollProc(void *);
+typedef struct { RDI_PollProc *p; void *arg; } RDI_PollDesc;
+#define RDISet_PollProc         16
+/* rdi: in RDI_PollDesc const *from, RDI_PollDesc *to                   */
+/*      if from non-NULL, sets the polling function from it             */
+/*      if to non-NULL, returns the previous polling function to it     */
+/* No corresponding RDP operation                                       */
+
+/* Called on debugger startup to see if the target is ready to execute  */
+#define RDIInfo_CanTargetExecute 20
+/* rdi: in  void
+ *      out byte status (RDIError_NoError => Yes, Otherwise No)
+ */
+
+/* Called to set the top of target memory in an ICEman2 system
+ * This is then used by ICEman to tell the C Library via the INFOHEAP
+ * SWI where the stack should start.
+ * Note that only ICEman2 supports this call.  Other systems eg.
+ * Demon, Angel, will simply return an error, which means that setting
+ * the top of memory in this fashion is not supported.
+ */
+#define RDIInfo_SetTopMem        21
+/* rdi: in  word mem_top
+ *      out byte status (RDIError_NoError => Done, Other => Not supported
+ */
+
+/* Called before performing a loadagent to determine the endianess of
+ * the debug agent, so that images of the wrong bytesex can be
+ * complained about
+ */
+#define RDIInfo_AgentEndianess   22
+/* rdi: in void
+ *      out byte status
+ *      status should be RDIError_LittleEndian or RDIError_BigEndian
+ *      any other value indicates the target does not support this
+ *      request, so the debugger will have to make a best guess, which
+ *      probably means only allow little endian loadagenting.
+ */
+
+/* The next two are only to be used if the value returned by            */
+/* RDIInfo_Points has RDIPointCapability_Status set.                    */
+#define RDIPointStatus_Watch    0x80
+#define RDIPointStatus_Break    0x81
+/* rdi: inout ARMword * (in handle, out hwresource), out ARMword *type  */
+/* rdp: in word handle, out word hwresource, word type, byte status     */
+
+#define RDISignal_Stop          0x100
+/* Requests that the debuggee stop                                      */
+/* No arguments, no return value                                        */
+/* rdp: no reply (when the debuggee stops, there will be a reply to the */
+/*      step or execute request which started it)                       */
+
+#define RDIVector_Catch         0x180
+/* rdi: in ARMword *bitmap                                              */
+/* rdp: int word bitmap, out byte status                                */
+/* bit i in bitmap set to cause vector i to cause entry to debugger     */
+
+/* The next four are only to be used if RDIInfo_Semihosting returned    */
+/* no error                                                             */
+#define RDISemiHosting_SetState 0x181
+/* rdi: in ARMword *semihostingstate                                    */
+/* rdp: in word semihostingstate, out byte status                       */
+#define RDISemiHosting_GetState 0x182
+/* rdi: out ARMword *semihostingstate                                   */
+/* rdp: in none, out word semihostingstate, byte status                 */
+#define RDISemiHosting_SetVector 0x183
+/* rdi: in ARMword *semihostingvector                                   */
+/* rdp: in word semihostingvector, out byte status                      */
+#define RDISemiHosting_GetVector 0x184
+/* rdi: out ARMword *semihostingvector                                  */
+/* rdp: in none, out word semihostingvector, byte status                */
+
+/* The next two are only to be used if RDIInfo_Icebreaker returned      */
+/* no error                                                             */
+#define RDIIcebreaker_GetLocks  0x185
+/* rdi: out ARMword *lockedstate                                        */
+/* rdp: in none, out word lockedstate, byte status                      */
+
+#define RDIIcebreaker_SetLocks  0x186
+/* rdi: in ARMword *lockedstate                                         */
+/* rdp: in word lockedstate, out byte status                            */
+
+/* lockedstate is a bitmap of the icebreaker registers locked against   */
+/* use by IceMan (because explicitly written by the user)               */
+
+#define RDIInfo_GetLoadSize     0x187
+/* rdi: out ARMword *maxloadsize                                        */
+/* rdp: in none, out word maxloadsize, byte status                      */
+/* Inquires the maximum length of data transfer the agent is prepared   */
+/* to receive                                                           */
+/* Only usable if RDIInfo_Target returned RDITarget_CanInquireLoadSize  */
+/* rdi: out ARMword *size                                               */
+
+/* Only to be used if the value returned by RDIInfo_Target had          */
+/* RDITarget_HasCommsChannel set                                        */
+typedef void RDICCProc_ToHost(void *arg, ARMword data);
+typedef void RDICCProc_FromHost(void *arg, ARMword *data, int *valid);
+
+#define RDICommsChannel_ToHost  0x188
+/* rdi: in RDICCProc_ToHost *, in void *arg                             */
+/* rdp: in byte connect, out byte status                                */
+#define RDICommsChannel_FromHost 0x189
+/* rdi: in RDICCProc_FromHost *, in void *arg                           */
+/* rdp: in byte connect, out byte status                                */
+
+/* These 4 are only to be used if RDIInfo_Semihosting returns no error  */
+#define RDISemiHosting_SetARMSWI 0x190
+/* rdi: in ARMword ARM_SWI_number                                       */
+/* rdp: in ARMword ARM_SWI_number, out byte status                      */
+
+#define RDISemiHosting_GetARMSWI 0x191
+/* rdi: out ARMword ARM_SWI_number                                      */
+/* rdp: out ARMword ARM_SWI_number, byte status                         */
+
+#define RDISemiHosting_SetThumbSWI 0x192
+/* rdi: in ARMword Thumb_SWI_number                                     */
+/* rdp: in ARMword Thumb_SWI_number, out byte status                    */
+
+#define RDISemiHosting_GetThumbSWI 0x193
+/* rdi: out ARMword ARM_Thumb_number                                    */
+/* rdp: out ARMword ARM_Thumb_number, byte status                       */
+
+
+#define RDICycles               0x200
+/* rdi: out ARMword cycles[12]                                          */
+/* rdp: in none, out 6 words cycles, byte status                        */
+/* the rdi result represents 6 big-endian doublewords; the rdp results  */
+/* return values for the ls halves of these                             */
+#  define RDICycles_Size        48
+
+#define RDIErrorP               0x201
+/* rdi: out ARMaddress *errorp                                          */
+/* rdp: in none, out word errorp, byte status                           */
+/* Returns the error pointer associated with the last return from step  */
+/* or execute with status RDIError_Error.                               */
+
+#define RDISet_Cmdline          0x300
+/* rdi: in char *commandline (a null-terminated string)                 */
+/* No corresponding RDP operation (cmdline is sent to the agent in      */
+/* response to SWI_GetEnv)                                              */
+
+#define RDISet_RDILevel         0x301
+/* rdi: in ARMword *level                                               */
+/* rdp: in word level, out byte status                                  */
+/* Sets the RDI/RDP protocol level to be used (must lie between the     */
+/* limits returned by RDIInfo_Target).                                  */
+
+#define RDISet_Thread           0x302
+/* rdi: in ARMword *threadhandle                                        */
+/* rdp: in word threadhandle, out byte status                           */
+/* Sets the thread context for subsequent thread-sensitive operations   */
+/* (null value sets no thread)                                          */
+
+/* The next two are only to be used if RDI_read or RDI_write returned   */
+/* RDIError_LittleEndian or RDIError_BigEndian, to signify that the     */
+/* debugger has noticed.                                                */
+#define RDIInfo_AckByteSex  0x303
+/* rdi: in ARMword *sex (RDISex_Little or RDISex_Big)                   */
+
+/* The next two are only to be used if RDIInfo_CoPro returned no error  */
+#define RDIInfo_DescribeCoPro   0x400
+/* rdi: in int *cpno, Dbg_CoProDesc *cpd                                */
+/* rdp: in byte cpno,                                                   */
+/*         cpd->entries * {                                             */
+/*           byte rmin, byte rmax, byte nbytes, byte access,            */
+/*           byte cprt_r_b0, cprt_r_b1, cprt_w_b0, cprt_w_b1}           */
+/*         byte = 255                                                   */
+/*      out byte status                                                 */
+
+#define RDIInfo_RequestCoProDesc 0x401
+/* rdi: in int *cpno, out Dbg_CoProDesc *cpd                            */
+/* rpd: in byte cpno                                                    */
+/*      out nentries * {                                                */
+/*            byte rmin, byte rmax, byte nbytes, byte access,           */
+/*          }                                                           */
+/*          byte = 255, byte status                                     */
+
+#define RDIInfo_Log             0x800
+/* rdi: out ARMword *logsetting                                         */
+/* No corresponding RDP operation                                       */
+#define RDIInfo_SetLog          0x801
+/* rdi: in ARMword *logsetting                                          */
+/* No corresponding RDP operation                                       */
+
+#define RDIProfile_Stop         0x500
+/* No arguments, no return value                                        */
+/* rdp: in none, out byte status                                        */
+/* Requests that pc sampling stop                                       */
+
+#define RDIProfile_Start        0x501
+/* rdi: in ARMword *interval                                            */
+/* rdp: in word interval, out byte status                               */
+/* Requests that pc sampling start, with period <interval> usec         */
+
+#define RDIProfile_WriteMap     0x502
+/* rdi: in ARMword map[]                                                */
+/* map[0] is the length of the array, subsequent elements are sorted    */
+/* and are the base of ranges for pc sampling (so if the sampled pc     */
+/* lies between map[i] and map[i+1], count[i] is incremented).          */
+/* rdp: a number of messages, each of form:                             */
+/*        in word len, word size, word offset, <size> words map data    */
+/*        out status                                                    */
+/* len, size and offset are all word counts.                            */
+
+#define RDIProfile_ReadMap      0x503
+/* rdi: in ARMword *len, out ARMword counts[len]                        */
+/* Requests that the counts array be set to the accumulated pc sample   */
+/* counts                                                               */
+/* rdp: a number of messages, each of form:                             */
+/*        in word offset, word size                                     */
+/*        out <size> words, status                                      */
+/* len, size and offset are all word counts.                            */
+
+#define RDIProfile_ClearCounts  0x504
+/* No arguments, no return value                                        */
+/* rdp: in none, out byte status                                        */
+/* Requests that pc sample counts be set to zero                        */
+
+#define RDIInfo_RequestReset    0x900
+/* Request reset of the target environment                              */
+/* No arguments, no return value                                        */
+/* No RDP equivalent, sends an RDP reset                                */
+
+#define RDIInfo_CapabilityRequest 0x8000
+/* Request whether the interface supports the named capability. The     */
+/* capability is specified by or'ing the RDIInfo number with this, and  */
+/* sending that request                                                 */
+/* rdi: in none                                                         */
+/* rdp: in none, out byte status                                        */
+
+typedef struct {
+  ARMword len;
+  ARMword map[1];
+} RDI_ProfileMap;
+
+typedef unsigned32 PointHandle;
+typedef unsigned32 ThreadHandle;
+#define RDINoPointHandle        ((PointHandle)-1L)
+#define RDINoHandle             ((ThreadHandle)-1L)
+
+struct Dbg_ConfigBlock;
+struct Dbg_HostosInterface;
+struct Dbg_MCState;
+typedef int rdi_open_proc(unsigned type, struct Dbg_ConfigBlock const *config,
+                          struct Dbg_HostosInterface const *i,
+                          struct Dbg_MCState *dbg_state);
+typedef int rdi_close_proc(void);
+typedef int rdi_read_proc(ARMword source, void *dest, unsigned *nbytes);
+typedef int rdi_write_proc(const void *source, ARMword dest, unsigned *nbytes);
+typedef int rdi_CPUread_proc(unsigned mode, unsigned32 mask, ARMword *state);
+typedef int rdi_CPUwrite_proc(unsigned mode, unsigned32 mask, ARMword const *state);
+typedef int rdi_CPread_proc(unsigned CPnum, unsigned32 mask, ARMword *state);
+typedef int rdi_CPwrite_proc(unsigned CPnum, unsigned32 mask, ARMword const *state);
+typedef int rdi_setbreak_proc(ARMword address, unsigned type, ARMword bound,
+                              PointHandle *handle);
+typedef int rdi_clearbreak_proc(PointHandle handle);
+typedef int rdi_setwatch_proc(ARMword address, unsigned type, unsigned datatype,
+                              ARMword bound, PointHandle *handle);
+typedef int rdi_clearwatch_proc(PointHandle handle);
+typedef int rdi_execute_proc(PointHandle *handle);
+typedef int rdi_step_proc(unsigned ninstr, PointHandle *handle);
+typedef int rdi_info_proc(unsigned type, ARMword *arg1, ARMword *arg2);
+typedef int rdi_pointinq_proc(ARMword *address, unsigned type,
+                              unsigned datatype, ARMword *bound);
+
+typedef enum {
+    RDI_ConfigCPU,
+    RDI_ConfigSystem
+} RDI_ConfigAspect;
+
+typedef enum {
+    RDI_MatchAny,
+    RDI_MatchExactly,
+    RDI_MatchNoEarlier
+} RDI_ConfigMatchType;
+
+typedef int rdi_addconfig_proc(unsigned32 nbytes);
+typedef int rdi_loadconfigdata_proc(unsigned32 nbytes, char const *data);
+typedef int rdi_selectconfig_proc(RDI_ConfigAspect aspect, char const *name,
+                                  RDI_ConfigMatchType matchtype, unsigned versionreq,
+                                  unsigned *versionp);
+
+typedef char *getbufferproc(void *getbarg, unsigned32 *sizep);
+typedef int rdi_loadagentproc(ARMword dest, unsigned32 size, getbufferproc *getb, void *getbarg);
+typedef int rdi_targetisdead(void);
+
+typedef struct {
+    int itemmax;
+    char const * const *names;
+} RDI_NameList;
+
+typedef RDI_NameList const *rdi_namelistproc(void);
+
+typedef int rdi_errmessproc(char *buf, int buflen, int errnum);
+
+struct RDIProcVec {
+    char rditypename[12];
+
+    rdi_open_proc       *open;
+    rdi_close_proc      *close;
+    rdi_read_proc       *read;
+    rdi_write_proc      *write;
+    rdi_CPUread_proc    *CPUread;
+    rdi_CPUwrite_proc   *CPUwrite;
+    rdi_CPread_proc     *CPread;
+    rdi_CPwrite_proc    *CPwrite;
+    rdi_setbreak_proc   *setbreak;
+    rdi_clearbreak_proc *clearbreak;
+    rdi_setwatch_proc   *setwatch;
+    rdi_clearwatch_proc *clearwatch;
+    rdi_execute_proc    *execute;
+    rdi_step_proc       *step;
+    rdi_info_proc       *info;
+    /* V2 RDI */
+    rdi_pointinq_proc   *pointinquiry;
+
+    /* These three useable only if RDIInfo_DownLoad returns no error */
+    rdi_addconfig_proc  *addconfig;
+    rdi_loadconfigdata_proc *loadconfigdata;
+    rdi_selectconfig_proc *selectconfig;
+
+    rdi_namelistproc    *drivernames;
+    rdi_namelistproc    *cpunames;
+
+    rdi_errmessproc     *errmess;
+
+    /* Only if RDIInfo_Target returns a value with RDITarget_LoadAgent set */
+    rdi_loadagentproc   *loadagent;
+    rdi_targetisdead    *targetisdead;
+};
+
+#endif