1a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// Copyright 2008 the V8 project authors. All rights reserved. 2a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// Redistribution and use in source and binary forms, with or without 3a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// modification, are permitted provided that the following conditions are 4a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// met: 5a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// 6a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// * Redistributions of source code must retain the above copyright 7a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// notice, this list of conditions and the following disclaimer. 8a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// * Redistributions in binary form must reproduce the above 9a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// copyright notice, this list of conditions and the following 10a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// disclaimer in the documentation and/or other materials provided 11a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// with the distribution. 12a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// * Neither the name of Google Inc. nor the names of its 13a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// contributors may be used to endorse or promote products derived 14a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// from this software without specific prior written permission. 15a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// 16a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 17a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 18a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 19a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 20a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 21a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 22a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 23a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 24a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 25a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 26a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 27a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 28a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block#ifndef V8_D8_DEBUG_H_ 29a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block#define V8_D8_DEBUG_H_ 30a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 31a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 32a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block#include "d8.h" 33a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block#include "debug.h" 34a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 35a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 36a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Blocknamespace v8 { 37a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 38a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 39a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Blockvoid HandleDebugEvent(DebugEvent event, 40a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block Handle<Object> exec_state, 41a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block Handle<Object> event_data, 42a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block Handle<Value> data); 43a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 44a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// Start the remove debugger connecting to a V8 debugger agent on the specified 45a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// port. 46a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Blockvoid RunRemoteDebugger(int port); 47a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 48a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// Forward declerations. 49a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Blockclass RemoteDebuggerEvent; 50a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Blockclass ReceiverThread; 51a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 52a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 53a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// Remote debugging class. 54a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Blockclass RemoteDebugger { 55a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block public: 563fb3ca8c7ca439d408449a395897395c0faae8d1Ben Murdoch explicit RemoteDebugger(int port) 57a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block : port_(port), 58a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block event_access_(i::OS::CreateMutex()), 59a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block event_available_(i::OS::CreateSemaphore(0)), 603fb3ca8c7ca439d408449a395897395c0faae8d1Ben Murdoch head_(NULL), tail_(NULL) {} 61a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block void Run(); 62a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 63a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block // Handle events from the subordinate threads. 64589d6979ff2ef66fca2d8fa51404c369ca5e9250Ben Murdoch void MessageReceived(i::SmartArrayPointer<char> message); 65589d6979ff2ef66fca2d8fa51404c369ca5e9250Ben Murdoch void KeyboardCommand(i::SmartArrayPointer<char> command); 66a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block void ConnectionClosed(); 67a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 68a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block private: 69a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block // Add new debugger event to the list. 70a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block void AddEvent(RemoteDebuggerEvent* event); 71a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block // Read next debugger event from the list. 72a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block RemoteDebuggerEvent* GetEvent(); 73a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 74a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block // Handle a message from the debugged V8. 75a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block void HandleMessageReceived(char* message); 76a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block // Handle a keyboard command. 77a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block void HandleKeyboardCommand(char* command); 78a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 79a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block // Get connection to agent in debugged V8. 80a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block i::Socket* conn() { return conn_; } 81a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 82a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block int port_; // Port used to connect to debugger V8. 83a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block i::Socket* conn_; // Connection to debugger agent in debugged V8. 84a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 85a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block // Linked list of events from debugged V8 and from keyboard input. Access to 86a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block // the list is guarded by a mutex and a semaphore signals new items in the 87a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block // list. 88a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block i::Mutex* event_access_; 89a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block i::Semaphore* event_available_; 90a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block RemoteDebuggerEvent* head_; 91a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block RemoteDebuggerEvent* tail_; 92a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 93a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block friend class ReceiverThread; 94a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block}; 95a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 96a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 97a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// Thread reading from debugged V8 instance. 98a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Blockclass ReceiverThread: public i::Thread { 99a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block public: 1003fb3ca8c7ca439d408449a395897395c0faae8d1Ben Murdoch explicit ReceiverThread(RemoteDebugger* remote_debugger) 1013fb3ca8c7ca439d408449a395897395c0faae8d1Ben Murdoch : Thread("d8:ReceiverThrd"), 1029fac840a46e8b7e26894f4792ba26dde14c56b04Steve Block remote_debugger_(remote_debugger) {} 103a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block ~ReceiverThread() {} 104a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 105a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block void Run(); 106a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 107a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block private: 108a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block RemoteDebugger* remote_debugger_; 109a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block}; 110a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 111a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 112a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// Thread reading keyboard input. 113a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Blockclass KeyboardThread: public i::Thread { 114a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block public: 1153fb3ca8c7ca439d408449a395897395c0faae8d1Ben Murdoch explicit KeyboardThread(RemoteDebugger* remote_debugger) 1163fb3ca8c7ca439d408449a395897395c0faae8d1Ben Murdoch : Thread("d8:KeyboardThrd"), 1179fac840a46e8b7e26894f4792ba26dde14c56b04Steve Block remote_debugger_(remote_debugger) {} 118a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block ~KeyboardThread() {} 119a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 120a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block void Run(); 121a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 122a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block private: 123a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block RemoteDebugger* remote_debugger_; 124a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block}; 125a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 126a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 127a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block// Events processed by the main deubgger thread. 128a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Blockclass RemoteDebuggerEvent { 129a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block public: 130589d6979ff2ef66fca2d8fa51404c369ca5e9250Ben Murdoch RemoteDebuggerEvent(int type, i::SmartArrayPointer<char> data) 131a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block : type_(type), data_(data), next_(NULL) { 132a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block ASSERT(type == kMessage || type == kKeyboard || type == kDisconnect); 133a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block } 134a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 135a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block static const int kMessage = 1; 136a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block static const int kKeyboard = 2; 137a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block static const int kDisconnect = 3; 138a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 139a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block int type() { return type_; } 140a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block char* data() { return *data_; } 141a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 142a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block private: 143a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block void set_next(RemoteDebuggerEvent* event) { next_ = event; } 144a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block RemoteDebuggerEvent* next() { return next_; } 145a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 146a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block int type_; 147589d6979ff2ef66fca2d8fa51404c369ca5e9250Ben Murdoch i::SmartArrayPointer<char> data_; 148a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block RemoteDebuggerEvent* next_; 149a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 150a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block friend class RemoteDebugger; 151a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block}; 152a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 153a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 154a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block} // namespace v8 155a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 156a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block 157a7e24c173cf37484693b9abb38e494fa7bd7baebSteve Block#endif // V8_D8_DEBUG_H_ 158