Initial creation of sourceware repositorygdb-4_18-branchpoint

1 files changed, 268 insertions, 0 deletions

diff --git a/gdb/rdi-share/devsw.h b/gdb/rdi-share/devsw.h
new file mode 100644
index 0000000..f561768
--- /dev/null
+++ b/gdb/rdi-share/devsw.h
@@ -0,0 +1,268 @@
+/* 
+ * 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.
+ */
+
+/* -*-C-*-
+ *
+ * $Revision$
+ *     $Date$
+ *
+ */
+#ifndef angsd_devsw_h
+#define angsd_devsw_h
+
+#include "devclnt.h"
+#include "adperr.h"
+#include "drivers.h"
+
+#ifndef __cplusplus
+typedef struct Packet Packet;
+typedef struct DevSWState DevSWState;
+#endif
+
+/*
+ * the basic structure used for passing packets around
+ */
+struct Packet
+{
+    struct Packet *pk_next;             /* XXX first field in struct */
+    unsigned int   pk_length;
+    unsigned char *pk_buffer;
+};
+
+/*
+ * control structure, used for maintaining device switcher state
+ */
+struct DevSWState
+{
+    unsigned int  ds_opendevchans;      /* bitmap of open device channels */
+
+    /*
+     * queue of packets read for the various device channels
+     */
+    Packet       *ds_readqueue[DC_NUM_CHANNELS];
+
+    /*
+     * structures for managing active read and write operations
+     */
+    Packet       *ds_nextreadpacket;
+    DriverCall    ds_activeread;
+    DriverCall    ds_activewrite;
+};
+
+#ifdef __cplusplus
+    extern "C" {
+#endif
+
+/*
+ *  Function: DevSW_AllocatePacket
+ *   Purpose: Claim some memory to hold a struct Packet, and the buffer for
+ *              that packet.
+ *
+ *    Params:
+ *       Input: length  Size of the buffer in struct Packet.
+ *
+ *   Returns:
+ *          OK: Pointer to the newly malloc()ed Packet.
+ *       Error: NULL
+ */
+Packet *DevSW_AllocatePacket(const unsigned int length);
+
+/*
+ *  Function: DevSW_FreePacket
+ *   Purpose: Free the memory associated with a struct Packet.
+ *
+ *  Pre-conditions The structure must have been originally claimed
+ *                      via DevSW_AllocatePacket.
+ *
+ *    Params:
+ *       Input: pk      The packet to be freed.
+ *
+ *   Returns: Nothing
+ */
+void DevSW_FreePacket(Packet *pk);
+
+/*
+ *  Function: DevSW_Open
+ *   Purpose: Open the specified device driver
+ *
+ *    Params:
+ *       Input: name    Identifies which device to open.  This can either be
+ *                      a host specific identifier (e.g. "/dev/ttya",
+ *                      "COM1:"), or a number which is used to refer to
+ *                      `standard' interfaces, so "1" would be the first host
+ *                      interface, "2" the second, and so on.
+ *
+ *              arg     Driver specific arguments.  For example, some serial
+ *                      drivers accept speed and control arguments such as
+ *                      "9600" or "19200/NO_BREAK".  These arguments are
+ *                      completely free-form: it is the individual drivers
+ *                      which do the necessary interpretation.
+ *
+ *              type    The type of packet the caller is interested in.  Only
+ *                      one open is allowed for each type of packet.
+ *
+ *      In/Out: device  The device driver to open
+ *
+ *   Returns:
+ *          OK: adp_ok
+ *       Error: adp_device_open_failed
+ *              adp_device_already_open
+ *              adp_malloc_failure
+ */
+AdpErrs DevSW_Open(DeviceDescr *device, const char *name, const char *arg,
+                   const DevChanID type);
+
+/*
+ *  Function: DevSW_Match
+ *   Purpose: Minimal veneer for DeviceMatch
+ *
+ *    Params:
+ *       Input: device  The device driver to match.
+ *
+ *              name    Identifies which device to open.  This can either be
+ *                      a host specific identifier (e.g. "/dev/ttya",
+ *                      "COM1:"), or a number which is used to refer to
+ *                      `standard' interfaces, so "1" would be the first host
+ *                      interface, "2" the second, and so on.
+ *
+ *              arg     Driver specific arguments.  For example, some serial
+ *                      drivers accept speed and control arguments such as
+ *                      "9600" or "19200/NO_BREAK".  These arguments are
+ *                      completely free-form: it is the individual drivers
+ *                      which do the necessary interpretation.
+ *
+ *   Returns:
+ *          OK: adp_ok
+ *       Error: adp_failed
+ */
+AdpErrs DevSW_Match(const DeviceDescr *device, const char *name,
+                    const char *arg);
+
+/*
+ *  Function: DevSW_Close
+ *   Purpose: Close the specified device driver. All packets of the type
+ *              used by the caller held within the switching layer will
+ *              be discarded.
+ *
+ *  Pre-conditions: Device must have been previously opened.
+ *
+ *    Params:
+ *       Input: device  The device driver to close
+ *
+ *              type    The type of packet the caller was interested in.
+ *
+ *   Returns:
+ *          OK: adp_ok
+ *       Error: adp_device_not_open
+ */
+AdpErrs DevSW_Close(const DeviceDescr *device, const DevChanID type);
+
+/*
+ *  Function: DevSW_Read
+ *   Purpose: Read a packet of appropriate type from the device driver
+ *
+ *    Params:
+ *       Input: device  The device driver to read packet from.
+ *
+ *              type    The type of packet the caller is interested in.
+ *
+ *      Output: packet  Pointer to new packet (if one is available)
+ *              NULL (if no complete packet is available)
+ *
+ *       Input: block   If TRUE, read may safely block for a short period
+ *                      of time (say up to 20ms), to avoid high CPU load
+ *                      whilst waiting for a reply.
+ *                      If FALSE, read MUST NOT block.
+ *
+ *   Returns:
+ *          OK: adp_ok
+ *       Error: adp_bad_packet
+ *
+ * Post-conditions: The calling function is responsible for freeing the
+ *                      resources used by the packet when it is no longer
+ *                      needed.
+ */
+AdpErrs DevSW_Read(const DeviceDescr *device, const DevChanID type,
+                   Packet **packet, bool block);
+
+/*
+ *  Function: DevSW_Write
+ *   Purpose: Try to write a packet to the device driver.  The write will
+ *              be bounced if another write is still in progress.
+ *
+ *    Params:
+ *       Input: device  The device driver to write a packet to.
+ *
+ *              packet  The packet to be written.
+ *
+ *              type    The type to be assigned to the packet.
+ *
+ *   Returns:
+ *          OK: adp_ok
+ *       Error: adp_illegal_args
+ *              adp_write_busy
+ *
+ * Post-conditions: The calling function retains "ownership" of the packet,
+ *                      i.e. it is responsible for freeing the resources used
+ *                      by the packet when it is no longer needed.
+ */
+AdpErrs DevSW_Write(const DeviceDescr *device, Packet *packet, DevChanID type);
+
+/*
+ *  Function: DevSW_FlushPendingWrite
+ *   Purpose: If a write is in progress, give it a chance to finish.
+ *
+ *    Params:
+ *       Input: device  The device driver to flush.
+ *
+ *   Returns:
+ *              adp_ok           no pending write, or write flushed completely
+ *              adp_write_busy   pending write not flushed completely
+ */
+AdpErrs DevSW_FlushPendingWrite(const DeviceDescr *device);
+
+/*
+ *  Function: DevSW_Ioctl
+ *   Purpose: Perform miscellaneous control operations.  This is a minimal
+ *              veneer to DeviceIoctl.
+ *
+ *    Params:
+ *       Input: device  The device driver to control.
+ *
+ *              opcode  Reason code indicating the operation to perform.
+ *
+ *      In/Out: args    Pointer to opcode-sensitive arguments/result space.
+ *
+ *   Returns:
+ *          OK: adp_ok
+ *       Error: adp_failed
+ */
+AdpErrs DevSW_Ioctl(const DeviceDescr *device, const int opcode, void *args);
+
+/*
+ *  Function: DevSW_WriteFinished
+ *   Purpose: Return TRUE if the active device has finished writing
+ *              the last packet to be sent, or FALSE if a packet is still
+ *              being transmitted.
+ *
+ *    Params:
+ *       Input: device  The device driver to check.
+ *
+ *   Returns:
+ *        TRUE: write finished or inactive
+ *       FALSE: write in progress
+ */
+bool DevSW_WriteFinished(const DeviceDescr *device);
+
+#ifdef __cplusplus
+    }
+#endif
+
+#endif /* ndef angsd_devsw_h */
+
+/* EOF devsw.h */