1 // Copyright 2008 the V8 project authors. All rights reserved.
2 // Redistribution and use in source and binary forms, with or without
3 // modification, are permitted provided that the following conditions are
6 // * Redistributions of source code must retain the above copyright
7 // notice, this list of conditions and the following disclaimer.
8 // * Redistributions in binary form must reproduce the above
9 // copyright notice, this list of conditions and the following
10 // disclaimer in the documentation and/or other materials provided
11 // with the distribution.
12 // * Neither the name of Google Inc. nor the names of its
13 // contributors may be used to endorse or promote products derived
14 // from this software without specific prior written permission.
16 // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
17 // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
18 // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
19 // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
20 // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
21 // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
22 // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
23 // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
24 // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25 // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
26 // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
28 #ifndef V8_D8_DEBUG_H_
29 #define V8_D8_DEBUG_H_
39 void HandleDebugEvent(DebugEvent event,
40 Handle<Object> exec_state,
41 Handle<Object> event_data,
44 // Start the remove debugger connecting to a V8 debugger agent on the specified
46 void RunRemoteDebugger(int port);
48 // Forward declerations.
49 class RemoteDebuggerEvent;
53 // Remote debugging class.
54 class RemoteDebugger {
56 explicit RemoteDebugger(int port)
58 event_access_(i::OS::CreateMutex()),
59 event_available_(i::OS::CreateSemaphore(0)),
60 head_(NULL), tail_(NULL) {}
63 // Handle events from the subordinate threads.
64 void MessageReceived(i::SmartArrayPointer<char> message);
65 void KeyboardCommand(i::SmartArrayPointer<char> command);
66 void ConnectionClosed();
69 // Add new debugger event to the list.
70 void AddEvent(RemoteDebuggerEvent* event);
71 // Read next debugger event from the list.
72 RemoteDebuggerEvent* GetEvent();
74 // Handle a message from the debugged V8.
75 void HandleMessageReceived(char* message);
76 // Handle a keyboard command.
77 void HandleKeyboardCommand(char* command);
79 // Get connection to agent in debugged V8.
80 i::Socket* conn() { return conn_; }
82 int port_; // Port used to connect to debugger V8.
83 i::Socket* conn_; // Connection to debugger agent in debugged V8.
85 // Linked list of events from debugged V8 and from keyboard input. Access to
86 // the list is guarded by a mutex and a semaphore signals new items in the
88 i::Mutex* event_access_;
89 i::Semaphore* event_available_;
90 RemoteDebuggerEvent* head_;
91 RemoteDebuggerEvent* tail_;
93 friend class ReceiverThread;
97 // Thread reading from debugged V8 instance.
98 class ReceiverThread: public i::Thread {
100 explicit ReceiverThread(RemoteDebugger* remote_debugger)
101 : Thread("d8:ReceiverThrd"),
102 remote_debugger_(remote_debugger) {}
108 RemoteDebugger* remote_debugger_;
112 // Thread reading keyboard input.
113 class KeyboardThread: public i::Thread {
115 explicit KeyboardThread(RemoteDebugger* remote_debugger)
116 : Thread("d8:KeyboardThrd"),
117 remote_debugger_(remote_debugger) {}
123 RemoteDebugger* remote_debugger_;
127 // Events processed by the main deubgger thread.
128 class RemoteDebuggerEvent {
130 RemoteDebuggerEvent(int type, i::SmartArrayPointer<char> data)
131 : type_(type), data_(data), next_(NULL) {
132 ASSERT(type == kMessage || type == kKeyboard || type == kDisconnect);
135 static const int kMessage = 1;
136 static const int kKeyboard = 2;
137 static const int kDisconnect = 3;
139 int type() { return type_; }
140 char* data() { return *data_; }
143 void set_next(RemoteDebuggerEvent* event) { next_ = event; }
144 RemoteDebuggerEvent* next() { return next_; }
147 i::SmartArrayPointer<char> data_;
148 RemoteDebuggerEvent* next_;
150 friend class RemoteDebugger;
157 #endif // V8_D8_DEBUG_H_