Initial creation of sourceware repositorygdb-4_18-branchpoint

1 files changed, 319 insertions, 0 deletions

diff --git a/gdb/rdi-share/sys.h b/gdb/rdi-share/sys.h
new file mode 100644
index 0000000..b68ac78
--- /dev/null
+++ b/gdb/rdi-share/sys.h
@@ -0,0 +1,319 @@
+/* 
+ * 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.
+ */
+
+/* sys.h 
+ ***********************************************************************
+ * Angel C Libary support channel protocol definitions
+ *
+ * $Revision$
+ *     $Date$
+ *
+ *
+ *
+ *
+ * MESSAGE FORMAT
+ * --------------
+ * Format of the "data" section of C Lib Support Channel Messages.
+ * You will notice that the format is much the same as the format
+ * of ADP messages - this is so that multi-threaded C Libraries can
+ * be supported.
+ *
+ *  unsigned32 reason     - Main C Library reason code.
+ *  unsigned32 debugID    - Info. describing host debug world;
+ *                          private to host and used in any target
+ *                          initiated messages.
+ *  unsigned32 OSinfo1    \ Target OS information to identify process/thread
+ *  unsigned32 OSinfo2    / world, etc. These two fields are target defined.
+ *  byte       args[n]    - Data for message "reason" code.
+ *
+ * The "debugID" is defined by the host-end of the protocol, and is used
+ * by the host to ensure that messages are routed to the correct handler
+ * program/veneer (eg. imagine several threads having opened stdout and
+ * each writing to a different window in a windowed debugger).
+ *
+ * NOTE: The reason that there is no "size" information, is that the
+ * message IDs themselves encode the format of any arguments.
+ *
+ * For further discussion of the format see adp.h
+ *
+ * N.B. All streams are little endian.
+ *
+ * CLIB REASON CODE
+ * ----------------
+ * The message reason codes contain some information that ties them to
+ * the channel and direction that the message will be used with. This
+ * will ensure that even if the message "#define name" is not
+ * completely descriptive, the message reason code is.
+ *
+ *      b31    = direction. 0=Host-to-Target; 1=Target-to-Host;
+ *      b30-16 = reserved. should be zero
+ *      b15-0  = message reason code.
+ *
+ * Note that typically a request will be initiated by the target side, and
+ * that the host will then respond with either an acknowledgement or some
+ * data.  In either case the same reason code will be used, but the direction
+ * bit will be reveresed.
+ */
+
+#ifndef __sys_h
+#define __sys_h
+
+#ifndef HtoT
+#define HtoT    ((unsigned)0 << 31)     /* Host-to-Target message */
+#define TtoH    ((unsigned)1 << 31)     /* Target-to-Host message */
+#endif
+
+/*
+ * The following are error codes used in the status field returned on
+ * sending a message. 0 represents no error having occurred, non-zero
+ * represents a general error.  More codes should be added as required.
+ */
+ 
+#ifndef ErrCode
+#define NoError  0x0
+#endif
+
+/*************************************************************************/
+/* The following are direct conversions of the DeMon SWI's               */
+/* NB: nbytes is the number of bytes INCLUDING THE NULL character where  */
+/*     applicable.                                                       */
+
+/* This message is used as a  response to a packet whose message
+ * was not understood.  The return parameter, code is the reason
+ * code which was not understood. Although intended for use as a
+ * default case on a received message switch it can also be used
+ * as a  proper message*/
+#define CL_Unrecognised          0x00
+    /* Unrecognised()
+     * return(word code)
+     */
+
+/* Write a character to the terminal.
+ */
+#define CL_WriteC       0x01
+   /* WriteC(byte data)
+    * return(word status)
+    */
+
+/* Write a NULL terminated string of characters to the terminal.  The length
+ * of the string excluding the NULL terminating character is passed in 
+ * 'nbytes'.
+ */
+#define CL_Write0       0x02
+   /* Write0(word nbytes, bytes data)
+    * return(word status)
+    */
+
+/* Read a character from the terminal - probably the keyboard.
+ */
+#define CL_ReadC        0x04
+   /* ReadC(void)
+    * return(word status, byte data)
+    */
+
+/* Perform system call, pass NULL terminated string to host's command
+ * line interpreter(NOT AVAILABLE IN PC/DOS RELEASE).  The data byte
+ * returned holds the return code from the system call.
+ */ 
+#define CL_System       0x05
+   /* CLI(word nbytes, bytes data)
+    * return(word status, word data)
+    */
+
+/* It returns the address of the null terminated command line string used to
+ * invoke the program. status will be set to NoError if the command line
+ * can be returned. Other status values will be treated as error conditions.
+ */
+#define CL_GetCmdLine   0x10
+   /* GetCmdLine(void)
+    * return(word status, word nbytes, bytes argline)
+    */
+
+/* Return the number of centi-seconds since the support code began 
+ * execution.  Only the difference between successive calls can be
+ * meaningful.
+ */
+#define CL_Clock        0x61
+   /* Clock(void)
+    * return(word status, word clks)
+    */
+
+/* Return the number of seconds since the beginning of 1970.
+ */
+#define CL_Time         0x63
+   /* Time(void)
+    * return(word status, word time)
+    */
+
+/* Delete(remove, un-link, wipe, destroy) the file named by the
+ * NULL-terminated string 'name'.
+ */
+#define CL_Remove       0x64
+   /* Remove(word nbytes, bytes name)
+    * return(word status)
+    */
+
+/* Rename the file specified by the NULL-terminated string 'oname'
+ * to 'nname'.
+ */   
+#define CL_Rename       0x65
+   /* Rename(word nbytes, bytes oname, word nbytes, bytes nname)
+    * return(word status)
+    */
+
+/* 'name' specifies a NULL-terminated string containing a file name or a
+ * device name.  Opens the file/device and returns a non-zero handle on
+ * success that can be quoted to CL_Close, CL_Read, CL_Write, CL_Seek,
+ * CL_Flen or CL_IsTTY.  The mode is an integer in the range 0-11:-
+ *
+ * Mode:              0   1   2   3   4   5   6   7   8   9   10   11
+ * ANSI C fopen mode: r   rb  r+  r+b w   wb  w+  w+b a   ab  a+   a+b
+ *
+ * Values 12-15 are illegal.  If 'name' is ":tt" the stdin/stdout is
+ * opened depending on whether 'mode' is read or write.
+ */ 
+#define CL_Open         0x66
+   /* Open(word nbytes, bytes name, word mode)
+    * return(word handle)
+    */
+
+/* 'handle' is a file handle previously returned by CL_Open.  CL_Close
+ * closes the file.
+ */ 
+#define CL_Close        0x68
+   /* Close(word handle)
+    * return(word status)
+    */
+
+/* Writes data of length nbytes to the file/device specified by
+ * handle.  nbtotal represents the total number of bytes to be
+ * written, whereas nbytes is the number of bytes in this packet
+ *
+ * If nbtotal is <= DATASIZE - CL_Write message header size in the
+ * packet then nbytes = nbtotal and the number of bytes not written
+ * is returned.  If nbtotal is > the packet size then the CL_Write
+ * must be followed by a number of CL_WriteX's to complete the write,
+ * the nbytes returned by CL_Write can be ignored
+ * If the status word returned is non zero, an error has occurred and
+ * the write request has been aborted.
+ * 
+ */
+#define CL_Write        0x69
+   /* Write(word handle, word nbtotal, word nbytes, bytes data)
+    * return(word status, word nbytes)
+    */
+
+/* Write Extension is a reads a continuation of data from a CL_Write 
+ * which was too big to fit in a single packet.
+ * nbytes is the number of bytes of data in this packet, the 
+ * returned value of nbytes can be ignored except if it is the 
+ * last packet, in which case it is the number of bytes that were NOT
+ * written 
+ */
+#define CL_WriteX       0x6A
+   /* WriteX(word nbytes, bytes data)
+    * return(word status, word nbytes)
+    */
+
+/* Reads 'nbytes' from the file/device specified by 'handle'.
+ *
+ * If nbytes <= DATASIZE then the read will occur in a single packet
+ * and the returned value of nbytes will be the number of bytes actually
+ * read and nbmore will be 0. If nbytes> DATASIZE then multiple packets
+ * will have to be used ie CL_Read followed by 1 or more CL_ReadX
+ * packets. In this case CL_Read will return nbytes read in the current
+ * packet and nbmore representing how many more bytes are expected to be
+ * read
+ * If the status word is non zero then the request has completed with an
+ * error. If the status word is 0xFFFFFFFF (-1) then an EOF condition
+ * has been reached.
+ */
+#define CL_Read         0x6B
+   /* Read(word handle, word nbytes)
+    * return(word status, word nbytes, word nbmore, bytes data)
+    */
+
+/* Read eXtension returns a continuation of the data that was opened for
+ * read in the earlier CL_Read. The return value nbytes is the number of
+ * data bytes in the packet, nbmore is the number of bytes more that are
+ * expected to be read in subsequent packets.
+ */
+#define CL_ReadX        0x6C
+  /* ReadX()
+   * return(word status, word nbytes, word nbmore, bytes data)
+   */
+
+/* Seeks to byte position 'posn' in the file/device specified by 'handle'.
+ */
+#define CL_Seek         0x6D
+   /* Seek(word handle, word posn)
+    * return(word status)
+    */
+
+/* Returns the current length of the file specified by 'handle' in 'len'.
+ * If an error occurs 'len' is set to -1. 
+ */ 
+#define CL_Flen         0x6E
+   /* Flen(word handle)
+    * return(word len)
+    */
+
+/* Returns NoError if 'handle' specifies an interactive device, otherwise
+ * returns GenError
+ */ 
+#define CL_IsTTY        0x6F
+   /* IsTTY(word handle)
+    * return(word status)
+    */
+
+/* Returns a temporary host file name. The maximum length of a file name
+ * is passed to the host. The TargetID is some identifier from the target
+ * for this particular temporary filename. This value is could be used
+ * directly in the generation of the filename. 
+ *
+ * If the host cannot create a suitable name or the generated name is too
+ * long then status is non zero. status will be NoError if the host can create
+ * a name. 
+ */
+#define CL_TmpNam       0x70
+   /* TmpNam(word maxlength, word TargetID)
+    * return(word status, word nbytes, bytes fname)
+    */
+
+/* Note there is no message for Exit, EnterOS, InstallHandler or
+ * GenerateError as these will be supported entirely at the host end,
+ * or by the underlying Operating system.
+ */
+
+#define CL_UnknownReason (-1)
+
+extern unsigned int GetRaiseHandler( void );
+extern unsigned int SysLibraryHandler(unsigned int sysCode, unsigned int *args);
+extern void angel_SysLibraryInit(void);
+
+/*
+ * Function: Angel_IsSysHandlerRunning
+ *  Purpose: return whether or not SysLibraryHandler is running
+ *
+ *   No paramaters
+ *             
+ *   Returns 1 if SysLibraryHandler is running
+ *           0 otherwise
+ */
+extern int Angel_IsSysHandlerRunning(void);
+
+#ifdef ICEMAN2
+/* This function exists in an ICEman2 system only, and can be called by
+ * debug support code when the debugger tells it how much memory the
+ * target has.  This will then be used to deal with the HEAPINFO SWI
+ */
+extern void angel_SetTopMem(unsigned addr);
+#endif
+
+#endif
+