v8  3.14.5(node0.10.28)
V8 is Google's open source JavaScript engine
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Pages
debug-agent.h
Go to the documentation of this file.
1 // Copyright 2006-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
4 // met:
5 //
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.
15 //
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.
27 
28 #ifndef V8_DEBUG_AGENT_H_
29 #define V8_DEBUG_AGENT_H_
30 
31 #ifdef ENABLE_DEBUGGER_SUPPORT
32 #include "../include/v8-debug.h"
33 #include "platform.h"
34 
35 namespace v8 {
36 namespace internal {
37 
38 // Forward decelrations.
39 class DebuggerAgentSession;
40 
41 
42 // Debugger agent which starts a socket listener on the debugger port and
43 // handles connection from a remote debugger.
44 class DebuggerAgent: public Thread {
45  public:
46  DebuggerAgent(const char* name, int port)
47  : Thread(name),
48  isolate_(Isolate::Current()),
49  name_(StrDup(name)), port_(port),
50  server_(OS::CreateSocket()), terminate_(false),
51  session_access_(OS::CreateMutex()), session_(NULL),
52  terminate_now_(OS::CreateSemaphore(0)),
53  listening_(OS::CreateSemaphore(0)) {
54  ASSERT(isolate_->debugger_agent_instance() == NULL);
55  isolate_->set_debugger_agent_instance(this);
56  }
57  ~DebuggerAgent() {
58  isolate_->set_debugger_agent_instance(NULL);
59  delete server_;
60  }
61 
62  void Shutdown();
63  void WaitUntilListening();
64 
65  Isolate* isolate() { return isolate_; }
66 
67  private:
68  void Run();
69  void CreateSession(Socket* socket);
70  void DebuggerMessage(const v8::Debug::Message& message);
71  void CloseSession();
72  void OnSessionClosed(DebuggerAgentSession* session);
73 
74  Isolate* isolate_;
75  SmartArrayPointer<const char> name_; // Name of the embedding application.
76  int port_; // Port to use for the agent.
77  Socket* server_; // Server socket for listen/accept.
78  bool terminate_; // Termination flag.
79  Mutex* session_access_; // Mutex guarging access to session_.
80  DebuggerAgentSession* session_; // Current active session if any.
81  Semaphore* terminate_now_; // Semaphore to signal termination.
82  Semaphore* listening_;
83 
84  friend class DebuggerAgentSession;
85  friend void DebuggerAgentMessageHandler(const v8::Debug::Message& message);
86 
87  DISALLOW_COPY_AND_ASSIGN(DebuggerAgent);
88 };
89 
90 
91 // Debugger agent session. The session receives requests from the remote
92 // debugger and sends debugger events/responses to the remote debugger.
93 class DebuggerAgentSession: public Thread {
94  public:
95  DebuggerAgentSession(DebuggerAgent* agent, Socket* client)
96  : Thread("v8:DbgAgntSessn"),
97  agent_(agent), client_(client) {}
98 
99  void DebuggerMessage(Vector<uint16_t> message);
100  void Shutdown();
101 
102  private:
103  void Run();
104 
105  void DebuggerMessage(Vector<char> message);
106 
107  DebuggerAgent* agent_;
108  Socket* client_;
109 
110  DISALLOW_COPY_AND_ASSIGN(DebuggerAgentSession);
111 };
112 
113 
114 // Utility methods factored out to be used by the D8 shell as well.
115 class DebuggerAgentUtil {
116  public:
117  static const char* const kContentLength;
118 
119  static SmartArrayPointer<char> ReceiveMessage(const Socket* conn);
120  static bool SendConnectMessage(const Socket* conn,
121  const char* embedding_host);
122  static bool SendMessage(const Socket* conn, const Vector<uint16_t> message);
123  static bool SendMessage(const Socket* conn,
125  static int ReceiveAll(const Socket* conn, char* data, int len);
126 };
127 
128 } } // namespace v8::internal
129 
130 #endif // ENABLE_DEBUGGER_SUPPORT
131 
132 #endif // V8_DEBUG_AGENT_H_
#define ASSERT(condition)
Definition: checks.h:270
#define DISALLOW_COPY_AND_ASSIGN(TypeName)
Definition: globals.h:307
Definition: v8.h:105
activate correct semantics for inheriting readonliness false
Definition: flags.cc:141
activate correct semantics for inheriting readonliness enable harmony semantics for typeof enable harmony enable harmony proxies enable all harmony harmony_scoping harmony_proxies harmony_scoping tracks arrays with only smi values automatically unbox arrays of doubles use crankshaft use hydrogen range analysis use hydrogen global value numbering use function inlining maximum number of AST nodes considered for a single inlining loop invariant code motion print statistics for hydrogen trace generated IR for specified phases trace register allocator trace range analysis trace representation types environment for every instruction put a break point before deoptimizing polymorphic inlining perform array bounds checks elimination use dead code elimination trace on stack replacement optimize closures cache optimized code for closures functions with arguments object loop weight for representation inference allow uint32 values on optimize frames if they are used only in safe operations track parallel recompilation enable all profiler experiments number of stack frames inspected by the profiler call recompile stub directly when self optimizing trigger profiler ticks based on counting instead of timing weight back edges by jump distance for interrupt triggering percentage of ICs that must have type info to allow optimization watch_ic_patching retry_self_opt interrupt_at_exit extra verbose compilation tracing generate extra emit comments in code disassembly enable use of SSE3 instructions if available enable use of CMOV instruction if available enable use of SAHF instruction if enable use of VFP3 instructions if available this implies enabling ARMv7 and VFP2 enable use of VFP2 instructions if available enable use of SDIV and UDIV instructions if enable loading bit constant by means of movw movt instruction enable unaligned accesses for enable use of MIPS FPU instructions if expose natives in global object expose gc extension number of stack frames to capture disable builtin natives files print a stack trace if an assertion failure occurs use random jit cookie to mask large constants trace lazy optimization use adaptive optimizations prepare for turning on always opt minimum length for automatic enable preparsing maximum number of optimization attempts before giving up cache prototype transitions automatically set the debug break flag when debugger commands are in the queue always cause a debug break before aborting maximum length of function source code printed in a stack trace max size of the new max size of the old max size of executable always perform global GCs print one trace line following each garbage collection do not print trace line after scavenger collection print more details following each garbage collection print amount of external allocated memory after each time it is adjusted flush code that we expect not to use again before full gc do incremental marking steps track object counts and memory usage use caching Perform compaction on every full GC Never perform compaction on full GC testing only Compact code space on full incremental collections Default seed for initializing random allows verbose printing trace parsing and preparsing Check icache flushes in ARM and MIPS simulator Stack alingment in bytes in print stack trace when throwing exceptions randomize hashes to avoid predictable hash Fixed seed to use to hash property activate a timer that switches between V8 threads testing_bool_flag float flag Seed used for threading test randomness A filename with extra code to be included in the Print usage message
Definition: flags.cc:495
activate correct semantics for inheriting readonliness enable harmony semantics for typeof enable harmony enable harmony proxies enable all harmony harmony_scoping harmony_proxies harmony_scoping tracks arrays with only smi values automatically unbox arrays of doubles use crankshaft use hydrogen range analysis use hydrogen global value numbering use function inlining maximum number of AST nodes considered for a single inlining loop invariant code motion print statistics for hydrogen trace generated IR for specified phases trace register allocator trace range analysis trace representation types environment for every instruction put a break point before deoptimizing polymorphic inlining perform array bounds checks elimination use dead code elimination trace on stack replacement optimize closures cache optimized code for closures functions with arguments object loop weight for representation inference allow uint32 values on optimize frames if they are used only in safe operations track parallel recompilation enable all profiler experiments number of stack frames inspected by the profiler call recompile stub directly when self optimizing trigger profiler ticks based on counting instead of timing weight back edges by jump distance for interrupt triggering percentage of ICs that must have type info to allow optimization watch_ic_patching retry_self_opt interrupt_at_exit extra verbose compilation tracing generate extra emit comments in code disassembly enable use of SSE3 instructions if available enable use of CMOV instruction if available enable use of SAHF instruction if enable use of VFP3 instructions if available this implies enabling ARMv7 and VFP2 enable use of VFP2 instructions if available enable use of SDIV and UDIV instructions if enable loading bit constant by means of movw movt instruction enable unaligned accesses for enable use of MIPS FPU instructions if NULL
Definition: flags.cc:301
char * StrDup(const char *str)
Definition: allocation.cc:85