Chris Lattner | 24943d2 | 2010-06-08 16:52:24 +0000 | [diff] [blame] | 1 | //===-- GDBRemoteCommunication.h --------------------------------*- C++ -*-===// |
| 2 | // |
| 3 | // The LLVM Compiler Infrastructure |
| 4 | // |
| 5 | // This file is distributed under the University of Illinois Open Source |
| 6 | // License. See LICENSE.TXT for details. |
| 7 | // |
| 8 | //===----------------------------------------------------------------------===// |
| 9 | |
| 10 | #ifndef liblldb_GDBRemoteCommunication_h_ |
| 11 | #define liblldb_GDBRemoteCommunication_h_ |
| 12 | |
| 13 | // C Includes |
| 14 | // C++ Includes |
| 15 | #include <list> |
| 16 | #include <string> |
| 17 | |
| 18 | // Other libraries and framework includes |
| 19 | // Project includes |
| 20 | #include "lldb/lldb-private.h" |
Chris Lattner | 24943d2 | 2010-06-08 16:52:24 +0000 | [diff] [blame] | 21 | #include "lldb/Core/Communication.h" |
Chris Lattner | 24943d2 | 2010-06-08 16:52:24 +0000 | [diff] [blame] | 22 | #include "lldb/Core/Listener.h" |
| 23 | #include "lldb/Host/Mutex.h" |
| 24 | #include "lldb/Host/Predicate.h" |
| 25 | |
Greg Clayton | 54e7afa | 2010-07-09 20:39:50 +0000 | [diff] [blame] | 26 | #include "Utility/StringExtractorGDBRemote.h" |
Chris Lattner | 24943d2 | 2010-06-08 16:52:24 +0000 | [diff] [blame] | 27 | |
| 28 | class ProcessGDBRemote; |
| 29 | |
Greg Clayton | 61d043b | 2011-03-22 04:00:09 +0000 | [diff] [blame] | 30 | class GDBRemoteCommunication : public lldb_private::Communication |
Chris Lattner | 24943d2 | 2010-06-08 16:52:24 +0000 | [diff] [blame] | 31 | { |
| 32 | public: |
Greg Clayton | b749a26 | 2010-12-03 06:02:24 +0000 | [diff] [blame] | 33 | enum |
| 34 | { |
| 35 | eBroadcastBitRunPacketSent = kLoUserBroadcastBit |
| 36 | }; |
Chris Lattner | 24943d2 | 2010-06-08 16:52:24 +0000 | [diff] [blame] | 37 | //------------------------------------------------------------------ |
| 38 | // Constructors and Destructors |
| 39 | //------------------------------------------------------------------ |
Greg Clayton | 61d043b | 2011-03-22 04:00:09 +0000 | [diff] [blame] | 40 | GDBRemoteCommunication(const char *comm_name, const char *listener_name); |
Chris Lattner | 24943d2 | 2010-06-08 16:52:24 +0000 | [diff] [blame] | 41 | |
| 42 | virtual |
| 43 | ~GDBRemoteCommunication(); |
| 44 | |
| 45 | size_t |
| 46 | SendPacket (const char *payload); |
| 47 | |
| 48 | size_t |
| 49 | SendPacket (const char *payload, |
| 50 | size_t payload_length); |
| 51 | |
Chris Lattner | 24943d2 | 2010-06-08 16:52:24 +0000 | [diff] [blame] | 52 | // Wait for a packet within 'nsec' seconds |
| 53 | size_t |
| 54 | WaitForPacket (StringExtractorGDBRemote &response, |
Greg Clayton | c97bfdb | 2011-03-10 02:26:48 +0000 | [diff] [blame] | 55 | uint32_t sec); |
Chris Lattner | 24943d2 | 2010-06-08 16:52:24 +0000 | [diff] [blame] | 56 | |
| 57 | // Wait for a packet with an absolute timeout time. If 'timeout' is NULL |
| 58 | // wait indefinitely. |
| 59 | size_t |
| 60 | WaitForPacket (StringExtractorGDBRemote &response, |
Greg Clayton | 72e1c78 | 2011-01-22 23:43:18 +0000 | [diff] [blame] | 61 | const lldb_private::TimeValue* timeout); |
Chris Lattner | 24943d2 | 2010-06-08 16:52:24 +0000 | [diff] [blame] | 62 | |
| 63 | char |
Greg Clayton | c97bfdb | 2011-03-10 02:26:48 +0000 | [diff] [blame] | 64 | GetAck (); |
Chris Lattner | 24943d2 | 2010-06-08 16:52:24 +0000 | [diff] [blame] | 65 | |
| 66 | size_t |
Greg Clayton | a4881d0 | 2011-01-22 07:12:45 +0000 | [diff] [blame] | 67 | SendAck (); |
| 68 | |
| 69 | size_t |
| 70 | SendNack (); |
| 71 | |
Chris Lattner | 24943d2 | 2010-06-08 16:52:24 +0000 | [diff] [blame] | 72 | char |
| 73 | CalculcateChecksum (const char *payload, |
| 74 | size_t payload_length); |
| 75 | |
Chris Lattner | 24943d2 | 2010-06-08 16:52:24 +0000 | [diff] [blame] | 76 | bool |
Chris Lattner | 24943d2 | 2010-06-08 16:52:24 +0000 | [diff] [blame] | 77 | GetSequenceMutex(lldb_private::Mutex::Locker& locker); |
| 78 | |
| 79 | //------------------------------------------------------------------ |
| 80 | // Communication overrides |
| 81 | //------------------------------------------------------------------ |
| 82 | virtual void |
Caroline Tice | c4f55fe | 2010-11-19 20:47:54 +0000 | [diff] [blame] | 83 | AppendBytesToCache (const uint8_t *src, size_t src_len, bool broadcast, lldb::ConnectionStatus status); |
Chris Lattner | 24943d2 | 2010-06-08 16:52:24 +0000 | [diff] [blame] | 84 | |
Chris Lattner | 24943d2 | 2010-06-08 16:52:24 +0000 | [diff] [blame] | 85 | bool |
| 86 | IsRunning() const |
| 87 | { |
Greg Clayton | cecf348 | 2011-01-20 07:53:45 +0000 | [diff] [blame] | 88 | return m_public_is_running.GetValue(); |
Chris Lattner | 24943d2 | 2010-06-08 16:52:24 +0000 | [diff] [blame] | 89 | } |
Greg Clayton | 72e1c78 | 2011-01-22 23:43:18 +0000 | [diff] [blame] | 90 | |
Greg Clayton | 58e26e0 | 2011-03-24 04:28:38 +0000 | [diff] [blame] | 91 | bool |
| 92 | GetSendAcks () |
| 93 | { |
| 94 | return m_send_acks; |
| 95 | } |
| 96 | |
Greg Clayton | 61d043b | 2011-03-22 04:00:09 +0000 | [diff] [blame] | 97 | //------------------------------------------------------------------ |
| 98 | // Client and server must implement these pure virtual functions |
| 99 | //------------------------------------------------------------------ |
| 100 | virtual bool |
| 101 | GetThreadSuffixSupported () = 0; |
Chris Lattner | 24943d2 | 2010-06-08 16:52:24 +0000 | [diff] [blame] | 102 | |
Greg Clayton | 61d043b | 2011-03-22 04:00:09 +0000 | [diff] [blame] | 103 | //------------------------------------------------------------------ |
| 104 | // Set the global packet timeout. |
| 105 | // |
| 106 | // For clients, this is the timeout that gets used when sending |
| 107 | // packets and waiting for responses. For servers, this might not |
| 108 | // get used, and if it doesn't this should be moved to the |
| 109 | // GDBRemoteCommunicationClient. |
| 110 | //------------------------------------------------------------------ |
Greg Clayton | c97bfdb | 2011-03-10 02:26:48 +0000 | [diff] [blame] | 111 | uint32_t |
| 112 | SetPacketTimeout (uint32_t packet_timeout) |
| 113 | { |
| 114 | const uint32_t old_packet_timeout = m_packet_timeout; |
| 115 | m_packet_timeout = packet_timeout; |
| 116 | return old_packet_timeout; |
| 117 | } |
Greg Clayton | c1f4587 | 2011-02-12 06:28:37 +0000 | [diff] [blame] | 118 | |
Chris Lattner | 24943d2 | 2010-06-08 16:52:24 +0000 | [diff] [blame] | 119 | protected: |
| 120 | typedef std::list<std::string> packet_collection; |
| 121 | |
| 122 | size_t |
| 123 | SendPacketNoLock (const char *payload, |
| 124 | size_t payload_length); |
| 125 | |
| 126 | size_t |
| 127 | WaitForPacketNoLock (StringExtractorGDBRemote &response, |
Greg Clayton | 72e1c78 | 2011-01-22 23:43:18 +0000 | [diff] [blame] | 128 | const lldb_private::TimeValue* timeout_ptr); |
| 129 | |
| 130 | bool |
| 131 | WaitForNotRunningPrivate (const lldb_private::TimeValue *timeout_ptr); |
Chris Lattner | 24943d2 | 2010-06-08 16:52:24 +0000 | [diff] [blame] | 132 | |
| 133 | //------------------------------------------------------------------ |
| 134 | // Classes that inherit from GDBRemoteCommunication can see and modify these |
| 135 | //------------------------------------------------------------------ |
Greg Clayton | c97bfdb | 2011-03-10 02:26:48 +0000 | [diff] [blame] | 136 | uint32_t m_packet_timeout; |
Chris Lattner | 24943d2 | 2010-06-08 16:52:24 +0000 | [diff] [blame] | 137 | lldb_private::Listener m_rx_packet_listener; |
| 138 | lldb_private::Mutex m_sequence_mutex; // Restrict access to sending/receiving packets to a single thread at a time |
Greg Clayton | cecf348 | 2011-01-20 07:53:45 +0000 | [diff] [blame] | 139 | lldb_private::Predicate<bool> m_public_is_running; |
| 140 | lldb_private::Predicate<bool> m_private_is_running; |
Greg Clayton | 58e26e0 | 2011-03-24 04:28:38 +0000 | [diff] [blame] | 141 | bool m_send_acks; |
| 142 | |
| 143 | |
| 144 | |
Chris Lattner | 24943d2 | 2010-06-08 16:52:24 +0000 | [diff] [blame] | 145 | |
Chris Lattner | 24943d2 | 2010-06-08 16:52:24 +0000 | [diff] [blame] | 146 | private: |
| 147 | //------------------------------------------------------------------ |
| 148 | // For GDBRemoteCommunication only |
| 149 | //------------------------------------------------------------------ |
| 150 | DISALLOW_COPY_AND_ASSIGN (GDBRemoteCommunication); |
| 151 | }; |
| 152 | |
| 153 | #endif // liblldb_GDBRemoteCommunication_h_ |