blob: 1acd09b388b81c2077aacde4bbe727fdcb64e8d3 [file] [log] [blame]
Elliott Hughes872d4ec2011-10-21 17:07:15 -07001/*
2 * Copyright (C) 2008 The Android Open Source Project
3 *
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
7 *
8 * http://www.apache.org/licenses/LICENSE-2.0
9 *
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
15 */
16
17/*
18 * Dalvik-specific side of debugger support. (The JDWP code is intended to
19 * be relatively generic.)
20 */
21#ifndef ART_DEBUGGER_H_
22#define ART_DEBUGGER_H_
23
24#include <pthread.h>
25
Elliott Hughes3bb81562011-10-21 18:52:59 -070026#include <string>
27
Elliott Hughes872d4ec2011-10-21 17:07:15 -070028#include "jdwp/jdwp.h"
Elliott Hughes3bb81562011-10-21 18:52:59 -070029#include "object.h"
Elliott Hughes872d4ec2011-10-21 17:07:15 -070030
31namespace art {
32
Elliott Hughes545a0642011-11-08 19:10:03 -080033struct AllocRecord;
Ian Rogers1b09b092012-08-20 15:35:52 -070034class Thread;
Elliott Hughes872d4ec2011-10-21 17:07:15 -070035
36/*
37 * Invoke-during-breakpoint support.
38 */
39struct DebugInvokeReq {
Elliott Hughes7b3cdfc2011-12-08 21:28:17 -080040 DebugInvokeReq()
Ian Rogers00f7d0e2012-07-19 15:28:27 -070041 : ready(false), invoke_needed_(false),
42 receiver_(NULL), thread_(NULL), class_(NULL), method_(NULL),
43 arg_count_(0), arg_values_(NULL), options_(0), error(JDWP::ERR_NONE),
44 result_tag(JDWP::JT_VOID), exception(0),
jeffhao9b5aa6f2012-12-18 11:47:11 -080045 lock_("a DebugInvokeReq lock", kBreakpointInvokeLock),
Ian Rogersc604d732012-10-14 16:09:54 -070046 cond_("a DebugInvokeReq condition variable", lock_) {
Elliott Hughes475fc232011-10-25 15:00:35 -070047 }
48
Elliott Hughes872d4ec2011-10-21 17:07:15 -070049 /* boolean; only set when we're in the tail end of an event handler */
50 bool ready;
51
52 /* boolean; set if the JDWP thread wants this thread to do work */
Elliott Hughesd07986f2011-12-06 18:27:45 -080053 bool invoke_needed_;
Elliott Hughes872d4ec2011-10-21 17:07:15 -070054
55 /* request */
Elliott Hughesd07986f2011-12-06 18:27:45 -080056 Object* receiver_; /* not used for ClassType.InvokeMethod */
57 Object* thread_;
Elliott Hughes872d4ec2011-10-21 17:07:15 -070058 Class* class_;
Mathieu Chartier66f19252012-09-18 08:57:04 -070059 AbstractMethod* method_;
Elliott Hughes45651fd2012-02-21 15:48:20 -080060 uint32_t arg_count_;
61 uint64_t* arg_values_; /* will be NULL if arg_count_ == 0 */
Elliott Hughesd07986f2011-12-06 18:27:45 -080062 uint32_t options_;
Elliott Hughes872d4ec2011-10-21 17:07:15 -070063
64 /* result */
Elliott Hughes475fc232011-10-25 15:00:35 -070065 JDWP::JdwpError error;
Elliott Hughesd07986f2011-12-06 18:27:45 -080066 JDWP::JdwpTag result_tag;
Elliott Hughes475fc232011-10-25 15:00:35 -070067 JValue result_value;
68 JDWP::ObjectId exception;
Elliott Hughes872d4ec2011-10-21 17:07:15 -070069
70 /* condition variable to wait on while the method executes */
Ian Rogersc604d732012-10-14 16:09:54 -070071 Mutex lock_ DEFAULT_MUTEX_ACQUIRED_AFTER;
72 ConditionVariable cond_ GUARDED_BY(lock_);
Elliott Hughes872d4ec2011-10-21 17:07:15 -070073};
74
75class Dbg {
Elliott Hughesff17f1f2012-01-24 18:12:29 -080076 public:
Elliott Hughes3bb81562011-10-21 18:52:59 -070077 static bool ParseJdwpOptions(const std::string& options);
Elliott Hughes4ffd3132011-10-24 12:06:42 -070078 static void SetJdwpAllowed(bool allowed);
79
Elliott Hughesd1cc8362011-10-24 16:58:50 -070080 static void StartJdwp();
81 static void StopJdwp();
82
Elliott Hughes767a1472011-10-26 18:49:02 -070083 // Invoked by the GC in case we need to keep DDMS informed.
Ian Rogersb726dcb2012-09-05 08:57:23 -070084 static void GcDidFinish() LOCKS_EXCLUDED(Locks::mutator_lock_);
Elliott Hughes767a1472011-10-26 18:49:02 -070085
Elliott Hughes872d4ec2011-10-21 17:07:15 -070086 // Return the DebugInvokeReq for the current thread.
87 static DebugInvokeReq* GetInvokeReq();
88
Elliott Hughes475fc232011-10-25 15:00:35 -070089 static Thread* GetDebugThread();
90 static void ClearWaitForEventThread();
91
Elliott Hughes872d4ec2011-10-21 17:07:15 -070092 /*
93 * Enable/disable breakpoints and step modes. Used to provide a heads-up
94 * when the debugger attaches.
95 */
96 static void Connected();
jeffhao09bfc6a2012-12-11 18:11:43 -080097 static void GoActive() LOCKS_EXCLUDED(Locks::breakpoint_lock_);
Elliott Hughes872d4ec2011-10-21 17:07:15 -070098 static void Disconnected();
Elliott Hughes86964332012-02-15 19:37:42 -080099 static void Disposed();
Elliott Hughes872d4ec2011-10-21 17:07:15 -0700100
Elliott Hughesc0f09332012-03-26 13:27:06 -0700101 // Returns true if we're actually debugging with a real debugger, false if it's
102 // just DDMS (or nothing at all).
103 static bool IsDebuggerActive();
Elliott Hughes872d4ec2011-10-21 17:07:15 -0700104
Elliott Hughesc0f09332012-03-26 13:27:06 -0700105 // Returns true if we had -Xrunjdwp or -agentlib:jdwp= on the command line.
106 static bool IsJdwpConfigured();
Elliott Hughes872d4ec2011-10-21 17:07:15 -0700107
Elliott Hughes86964332012-02-15 19:37:42 -0800108 static bool IsDisposed();
109
Elliott Hughes872d4ec2011-10-21 17:07:15 -0700110 /*
111 * Time, in milliseconds, since the last debugger activity. Does not
112 * include DDMS activity. Returns -1 if there has been no activity.
113 * Returns 0 if we're in the middle of handling a debugger request.
114 */
115 static int64_t LastDebuggerActivity();
116
Elliott Hughes872d4ec2011-10-21 17:07:15 -0700117 static void UndoDebuggerSuspensions();
118
Elliott Hughes872d4ec2011-10-21 17:07:15 -0700119 static void Exit(int status);
120
Elliott Hughesbfe487b2011-10-26 15:48:55 -0700121 static void VisitRoots(Heap::RootVisitor* visitor, void* arg);
122
Elliott Hughes872d4ec2011-10-21 17:07:15 -0700123 /*
124 * Class, Object, Array
125 */
Ian Rogers00f7d0e2012-07-19 15:28:27 -0700126 static std::string GetClassName(JDWP::RefTypeId id)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700127 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Elliott Hughes88d63092013-01-09 09:55:54 -0800128 static JDWP::JdwpError GetClassObject(JDWP::RefTypeId id, JDWP::ObjectId& class_object_id)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700129 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Elliott Hughes88d63092013-01-09 09:55:54 -0800130 static JDWP::JdwpError GetSuperclass(JDWP::RefTypeId id, JDWP::RefTypeId& superclass_id)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700131 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Ian Rogers00f7d0e2012-07-19 15:28:27 -0700132 static JDWP::JdwpError GetClassLoader(JDWP::RefTypeId id, JDWP::ExpandBuf* pReply)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700133 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Ian Rogers00f7d0e2012-07-19 15:28:27 -0700134 static JDWP::JdwpError GetModifiers(JDWP::RefTypeId id, JDWP::ExpandBuf* pReply)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700135 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Elliott Hughes88d63092013-01-09 09:55:54 -0800136 static JDWP::JdwpError GetReflectedType(JDWP::RefTypeId class_id, JDWP::ExpandBuf* pReply)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700137 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Ian Rogers00f7d0e2012-07-19 15:28:27 -0700138 static void GetClassList(std::vector<JDWP::RefTypeId>& classes)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700139 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Elliott Hughes88d63092013-01-09 09:55:54 -0800140 static JDWP::JdwpError GetClassInfo(JDWP::RefTypeId class_id, JDWP::JdwpTypeTag* pTypeTag,
Ian Rogers00f7d0e2012-07-19 15:28:27 -0700141 uint32_t* pStatus, std::string* pDescriptor)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700142 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Ian Rogers00f7d0e2012-07-19 15:28:27 -0700143 static void FindLoadedClassBySignature(const char* descriptor, std::vector<JDWP::RefTypeId>& ids)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700144 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Elliott Hughes88d63092013-01-09 09:55:54 -0800145 static JDWP::JdwpError GetReferenceType(JDWP::ObjectId object_id, JDWP::ExpandBuf* pReply);
146 static JDWP::JdwpError GetSignature(JDWP::RefTypeId ref_type_id, std::string& signature)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700147 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Elliott Hughes88d63092013-01-09 09:55:54 -0800148 static JDWP::JdwpError GetSourceFile(JDWP::RefTypeId ref_type_id, std::string& source_file)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700149 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Elliott Hughes88d63092013-01-09 09:55:54 -0800150 static JDWP::JdwpError GetObjectTag(JDWP::ObjectId object_id, uint8_t& tag)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700151 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Elliott Hughesaed4be92011-12-02 16:16:23 -0800152 static size_t GetTagWidth(JDWP::JdwpTag tag);
Elliott Hughes872d4ec2011-10-21 17:07:15 -0700153
Elliott Hughesf327e072013-01-09 16:01:26 -0800154 static JDWP::JdwpError GetMonitorInfo(JDWP::ObjectId object_id, JDWP::ExpandBuf* reply)
155 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Elliott Hughes734b8c62013-01-11 15:32:45 -0800156 static JDWP::JdwpError GetOwnedMonitors(JDWP::ObjectId thread_id,
157 std::vector<JDWP::ObjectId>& monitors,
158 std::vector<uint32_t>& stack_depths)
Elliott Hughes4993bbc2013-01-10 15:41:25 -0800159 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Elliott Hughesf9501702013-01-11 11:22:27 -0800160 static JDWP::JdwpError GetContendedMonitor(JDWP::ObjectId thread_id, JDWP::ObjectId& contended_monitor)
161 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Elliott Hughesf327e072013-01-09 16:01:26 -0800162
Elliott Hughes88d63092013-01-09 09:55:54 -0800163 static JDWP::JdwpError GetArrayLength(JDWP::ObjectId array_id, int& length)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700164 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Elliott Hughes88d63092013-01-09 09:55:54 -0800165 static JDWP::JdwpError OutputArray(JDWP::ObjectId array_id, int offset, int count,
Ian Rogers00f7d0e2012-07-19 15:28:27 -0700166 JDWP::ExpandBuf* pReply)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700167 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Elliott Hughes88d63092013-01-09 09:55:54 -0800168 static JDWP::JdwpError SetArrayElements(JDWP::ObjectId array_id, int offset, int count,
Ian Rogers00f7d0e2012-07-19 15:28:27 -0700169 const uint8_t* buf)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700170 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Elliott Hughes872d4ec2011-10-21 17:07:15 -0700171
Ian Rogers00f7d0e2012-07-19 15:28:27 -0700172 static JDWP::ObjectId CreateString(const std::string& str)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700173 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Elliott Hughes88d63092013-01-09 09:55:54 -0800174 static JDWP::JdwpError CreateObject(JDWP::RefTypeId class_id, JDWP::ObjectId& new_object)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700175 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Elliott Hughes88d63092013-01-09 09:55:54 -0800176 static JDWP::JdwpError CreateArrayObject(JDWP::RefTypeId array_class_id, uint32_t length,
Ian Rogers00f7d0e2012-07-19 15:28:27 -0700177 JDWP::ObjectId& new_array)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700178 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Elliott Hughes872d4ec2011-10-21 17:07:15 -0700179
Elliott Hughes88d63092013-01-09 09:55:54 -0800180 static bool MatchType(JDWP::RefTypeId instance_class_id, JDWP::RefTypeId class_id)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700181 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Elliott Hughes872d4ec2011-10-21 17:07:15 -0700182
183 /*
184 * Method and Field
185 */
Elliott Hughes88d63092013-01-09 09:55:54 -0800186 static std::string GetMethodName(JDWP::RefTypeId ref_type_id, JDWP::MethodId id)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700187 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Elliott Hughes88d63092013-01-09 09:55:54 -0800188 static JDWP::JdwpError OutputDeclaredFields(JDWP::RefTypeId ref_type_id, bool with_generic,
Ian Rogers00f7d0e2012-07-19 15:28:27 -0700189 JDWP::ExpandBuf* pReply)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700190 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Elliott Hughes88d63092013-01-09 09:55:54 -0800191 static JDWP::JdwpError OutputDeclaredMethods(JDWP::RefTypeId ref_type_id, bool with_generic,
Ian Rogers00f7d0e2012-07-19 15:28:27 -0700192 JDWP::ExpandBuf* pReply)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700193 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Elliott Hughes88d63092013-01-09 09:55:54 -0800194 static JDWP::JdwpError OutputDeclaredInterfaces(JDWP::RefTypeId ref_type_id,
Ian Rogers00f7d0e2012-07-19 15:28:27 -0700195 JDWP::ExpandBuf* pReply)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700196 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Elliott Hughes88d63092013-01-09 09:55:54 -0800197 static void OutputLineTable(JDWP::RefTypeId ref_type_id, JDWP::MethodId method_id,
Ian Rogers00f7d0e2012-07-19 15:28:27 -0700198 JDWP::ExpandBuf* pReply)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700199 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Elliott Hughes88d63092013-01-09 09:55:54 -0800200 static void OutputVariableTable(JDWP::RefTypeId ref_type_id, JDWP::MethodId id, bool with_generic,
Ian Rogers00f7d0e2012-07-19 15:28:27 -0700201 JDWP::ExpandBuf* pReply)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700202 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Elliott Hughes872d4ec2011-10-21 17:07:15 -0700203
Elliott Hughes88d63092013-01-09 09:55:54 -0800204 static JDWP::JdwpTag GetFieldBasicTag(JDWP::FieldId field_id)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700205 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Elliott Hughes88d63092013-01-09 09:55:54 -0800206 static JDWP::JdwpTag GetStaticFieldBasicTag(JDWP::FieldId field_id)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700207 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);;
Elliott Hughes88d63092013-01-09 09:55:54 -0800208 static JDWP::JdwpError GetFieldValue(JDWP::ObjectId object_id, JDWP::FieldId field_id,
Ian Rogers00f7d0e2012-07-19 15:28:27 -0700209 JDWP::ExpandBuf* pReply)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700210 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Elliott Hughes88d63092013-01-09 09:55:54 -0800211 static JDWP::JdwpError SetFieldValue(JDWP::ObjectId object_id, JDWP::FieldId field_id,
Ian Rogers00f7d0e2012-07-19 15:28:27 -0700212 uint64_t value, int width)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700213 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Elliott Hughes88d63092013-01-09 09:55:54 -0800214 static JDWP::JdwpError GetStaticFieldValue(JDWP::RefTypeId ref_type_id, JDWP::FieldId field_id,
Ian Rogers00f7d0e2012-07-19 15:28:27 -0700215 JDWP::ExpandBuf* pReply)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700216 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Elliott Hughes88d63092013-01-09 09:55:54 -0800217 static JDWP::JdwpError SetStaticFieldValue(JDWP::FieldId field_id, uint64_t value, int width)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700218 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Elliott Hughes872d4ec2011-10-21 17:07:15 -0700219
Elliott Hughes88d63092013-01-09 09:55:54 -0800220 static std::string StringToUtf8(JDWP::ObjectId string_id)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700221 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Elliott Hughes872d4ec2011-10-21 17:07:15 -0700222
223 /*
224 * Thread, ThreadGroup, Frame
225 */
Elliott Hughes88d63092013-01-09 09:55:54 -0800226 static JDWP::JdwpError GetThreadName(JDWP::ObjectId thread_id, std::string& name)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700227 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_)
228 LOCKS_EXCLUDED(Locks::thread_list_lock_);
Elliott Hughes88d63092013-01-09 09:55:54 -0800229 static JDWP::JdwpError GetThreadGroup(JDWP::ObjectId thread_id, JDWP::ExpandBuf* pReply);
230 static std::string GetThreadGroupName(JDWP::ObjectId thread_group_id);
231 static JDWP::ObjectId GetThreadGroupParent(JDWP::ObjectId thread_group_id)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700232 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Ian Rogers00f7d0e2012-07-19 15:28:27 -0700233 static JDWP::ObjectId GetSystemThreadGroupId()
Ian Rogersb726dcb2012-09-05 08:57:23 -0700234 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Elliott Hughes872d4ec2011-10-21 17:07:15 -0700235 static JDWP::ObjectId GetMainThreadGroupId();
236
Elliott Hughes88d63092013-01-09 09:55:54 -0800237 static JDWP::JdwpError GetThreadStatus(JDWP::ObjectId thread_id, JDWP::JdwpThreadStatus* pThreadStatus, JDWP::JdwpSuspendStatus* pSuspendStatus);
238 static JDWP::JdwpError GetThreadDebugSuspendCount(JDWP::ObjectId thread_id, JDWP::ExpandBuf* pReply);
Elliott Hughes88d63092013-01-09 09:55:54 -0800239 //static void WaitForSuspend(JDWP::ObjectId thread_id);
Elliott Hughescaf76542012-06-28 16:08:22 -0700240
Elliott Hughes026b1462012-06-28 20:43:49 -0700241 // Fills 'thread_ids' with the threads in the given thread group. If thread_group_id == 0,
Elliott Hughescaf76542012-06-28 16:08:22 -0700242 // returns all threads.
Ian Rogers00f7d0e2012-07-19 15:28:27 -0700243 static void GetThreads(JDWP::ObjectId thread_group_id, std::vector<JDWP::ObjectId>& thread_ids)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700244 LOCKS_EXCLUDED(Locks::thread_list_lock_)
245 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Elliott Hughescaf76542012-06-28 16:08:22 -0700246 static void GetChildThreadGroups(JDWP::ObjectId thread_group_id, std::vector<JDWP::ObjectId>& child_thread_group_ids);
247
Elliott Hughes88d63092013-01-09 09:55:54 -0800248 static JDWP::JdwpError GetThreadFrameCount(JDWP::ObjectId thread_id, size_t& result);
Ian Rogers00f7d0e2012-07-19 15:28:27 -0700249 static JDWP::JdwpError GetThreadFrames(JDWP::ObjectId thread_id, size_t start_frame,
250 size_t frame_count, JDWP::ExpandBuf* buf)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700251 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Elliott Hughes872d4ec2011-10-21 17:07:15 -0700252
Ian Rogers00f7d0e2012-07-19 15:28:27 -0700253 static JDWP::ObjectId GetThreadSelfId()
Ian Rogersb726dcb2012-09-05 08:57:23 -0700254 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Ian Rogers00f7d0e2012-07-19 15:28:27 -0700255 static void SuspendVM()
Ian Rogersb726dcb2012-09-05 08:57:23 -0700256 LOCKS_EXCLUDED(Locks::thread_list_lock_,
257 Locks::thread_suspend_count_lock_);
Elliott Hughes872d4ec2011-10-21 17:07:15 -0700258 static void ResumeVM();
Elliott Hughes88d63092013-01-09 09:55:54 -0800259 static JDWP::JdwpError SuspendThread(JDWP::ObjectId thread_id, bool request_suspension = true)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700260 LOCKS_EXCLUDED(Locks::mutator_lock_,
261 Locks::thread_list_lock_,
262 Locks::thread_suspend_count_lock_);
Ian Rogers00f7d0e2012-07-19 15:28:27 -0700263
Elliott Hughes88d63092013-01-09 09:55:54 -0800264 static void ResumeThread(JDWP::ObjectId thread_id)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700265 LOCKS_EXCLUDED(Locks::thread_list_lock_,
266 Locks::thread_suspend_count_lock_)
267 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Elliott Hughes872d4ec2011-10-21 17:07:15 -0700268 static void SuspendSelf();
269
Ian Rogers00f7d0e2012-07-19 15:28:27 -0700270 static JDWP::JdwpError GetThisObject(JDWP::ObjectId thread_id, JDWP::FrameId frame_id,
271 JDWP::ObjectId* result)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700272 LOCKS_EXCLUDED(Locks::thread_list_lock_,
273 Locks::thread_suspend_count_lock_)
274 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Elliott Hughes88d63092013-01-09 09:55:54 -0800275 static void GetLocalValue(JDWP::ObjectId thread_id, JDWP::FrameId frame_id, int slot,
Ian Rogers00f7d0e2012-07-19 15:28:27 -0700276 JDWP::JdwpTag tag, uint8_t* buf, size_t expectedLen)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700277 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Elliott Hughes88d63092013-01-09 09:55:54 -0800278 static void SetLocalValue(JDWP::ObjectId thread_id, JDWP::FrameId frame_id, int slot,
Ian Rogers00f7d0e2012-07-19 15:28:27 -0700279 JDWP::JdwpTag tag, uint64_t value, size_t width)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700280 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Elliott Hughes872d4ec2011-10-21 17:07:15 -0700281
Elliott Hughesf9501702013-01-11 11:22:27 -0800282 static JDWP::JdwpError Interrupt(JDWP::ObjectId thread_id);
283
Elliott Hughes872d4ec2011-10-21 17:07:15 -0700284 /*
285 * Debugger notification
286 */
287 enum {
Elliott Hughes86964332012-02-15 19:37:42 -0800288 kBreakpoint = 0x01,
Elliott Hughes872d4ec2011-10-21 17:07:15 -0700289 kSingleStep = 0x02,
290 kMethodEntry = 0x04,
291 kMethodExit = 0x08,
292 };
Mathieu Chartier66f19252012-09-18 08:57:04 -0700293 static void PostLocationEvent(const AbstractMethod* method, int pcOffset, Object* thisPtr, int eventFlags)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700294 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Mathieu Chartier66f19252012-09-18 08:57:04 -0700295 static void PostException(Thread* thread, JDWP::FrameId throw_frame_id, AbstractMethod* throw_method,
296 uint32_t throw_dex_pc, AbstractMethod* catch_method, uint32_t catch_dex_pc,
Ian Rogers00f7d0e2012-07-19 15:28:27 -0700297 Throwable* exception)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700298 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Ian Rogers00f7d0e2012-07-19 15:28:27 -0700299 static void PostThreadStart(Thread* t)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700300 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Ian Rogers00f7d0e2012-07-19 15:28:27 -0700301 static void PostThreadDeath(Thread* t)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700302 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Ian Rogers00f7d0e2012-07-19 15:28:27 -0700303 static void PostClassPrepare(Class* c)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700304 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Elliott Hughes872d4ec2011-10-21 17:07:15 -0700305
Ian Rogers00f7d0e2012-07-19 15:28:27 -0700306 static void UpdateDebugger(int32_t dex_pc, Thread* self)
jeffhao09bfc6a2012-12-11 18:11:43 -0800307 LOCKS_EXCLUDED(Locks::breakpoint_lock_)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700308 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Elliott Hughes91bf6cd2012-02-14 17:27:48 -0800309
Ian Rogers00f7d0e2012-07-19 15:28:27 -0700310 static void WatchLocation(const JDWP::JdwpLocation* pLoc)
jeffhao09bfc6a2012-12-11 18:11:43 -0800311 LOCKS_EXCLUDED(Locks::breakpoint_lock_)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700312 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Ian Rogers00f7d0e2012-07-19 15:28:27 -0700313 static void UnwatchLocation(const JDWP::JdwpLocation* pLoc)
jeffhao09bfc6a2012-12-11 18:11:43 -0800314 LOCKS_EXCLUDED(Locks::breakpoint_lock_)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700315 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Elliott Hughes88d63092013-01-09 09:55:54 -0800316 static JDWP::JdwpError ConfigureStep(JDWP::ObjectId thread_id, JDWP::JdwpStepSize size,
Ian Rogers00f7d0e2012-07-19 15:28:27 -0700317 JDWP::JdwpStepDepth depth)
jeffhao09bfc6a2012-12-11 18:11:43 -0800318 LOCKS_EXCLUDED(Locks::breakpoint_lock_)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700319 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Elliott Hughes88d63092013-01-09 09:55:54 -0800320 static void UnconfigureStep(JDWP::ObjectId thread_id) LOCKS_EXCLUDED(Locks::breakpoint_lock_);
Elliott Hughes872d4ec2011-10-21 17:07:15 -0700321
Elliott Hughes88d63092013-01-09 09:55:54 -0800322 static JDWP::JdwpError InvokeMethod(JDWP::ObjectId thread_id, JDWP::ObjectId object_id,
323 JDWP::RefTypeId class_id, JDWP::MethodId method_id,
Ian Rogers00f7d0e2012-07-19 15:28:27 -0700324 uint32_t arg_count, uint64_t* arg_values,
325 JDWP::JdwpTag* arg_types, uint32_t options,
326 JDWP::JdwpTag* pResultTag, uint64_t* pResultValue,
327 JDWP::ObjectId* pExceptObj)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700328 LOCKS_EXCLUDED(Locks::thread_list_lock_,
329 Locks::thread_suspend_count_lock_)
330 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Elliott Hughes872d4ec2011-10-21 17:07:15 -0700331 static void ExecuteMethod(DebugInvokeReq* pReq);
332
333 /* perform "late registration" of an object ID */
334 static void RegisterObjectId(JDWP::ObjectId id);
335
336 /*
337 * DDM support.
338 */
Ian Rogers00f7d0e2012-07-19 15:28:27 -0700339 static void DdmSendThreadNotification(Thread* t, uint32_t type)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700340 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Elliott Hughes47fce012011-10-25 18:37:19 -0700341 static void DdmSetThreadNotification(bool enable);
Elliott Hughes872d4ec2011-10-21 17:07:15 -0700342 static bool DdmHandlePacket(const uint8_t* buf, int dataLen, uint8_t** pReplyBuf, int* pReplyLen);
Ian Rogersb726dcb2012-09-05 08:57:23 -0700343 static void DdmConnected() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
344 static void DdmDisconnected() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Ian Rogers00f7d0e2012-07-19 15:28:27 -0700345 static void DdmSendChunk(uint32_t type, const std::vector<uint8_t>& bytes)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700346 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Ian Rogers00f7d0e2012-07-19 15:28:27 -0700347 static void DdmSendChunk(uint32_t type, size_t len, const uint8_t* buf)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700348 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Ian Rogers00f7d0e2012-07-19 15:28:27 -0700349 static void DdmSendChunkV(uint32_t type, const iovec* iov, int iov_count)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700350 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Elliott Hughes767a1472011-10-26 18:49:02 -0700351
Elliott Hughes545a0642011-11-08 19:10:03 -0800352 /*
353 * Recent allocation tracking support.
354 */
Ian Rogers00f7d0e2012-07-19 15:28:27 -0700355 static void RecordAllocation(Class* type, size_t byte_count)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700356 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Elliott Hughes545a0642011-11-08 19:10:03 -0800357 static void SetAllocTrackingEnabled(bool enabled);
358 static inline bool IsAllocTrackingEnabled() { return recent_allocation_records_ != NULL; }
Ian Rogers00f7d0e2012-07-19 15:28:27 -0700359 static jbyteArray GetRecentAllocations()
Ian Rogersb726dcb2012-09-05 08:57:23 -0700360 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Elliott Hughes545a0642011-11-08 19:10:03 -0800361 static void DumpRecentAllocations();
362
Elliott Hughes767a1472011-10-26 18:49:02 -0700363 enum HpifWhen {
364 HPIF_WHEN_NEVER = 0,
365 HPIF_WHEN_NOW = 1,
366 HPIF_WHEN_NEXT_GC = 2,
367 HPIF_WHEN_EVERY_GC = 3
368 };
Ian Rogers00f7d0e2012-07-19 15:28:27 -0700369 static int DdmHandleHpifChunk(HpifWhen when)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700370 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Elliott Hughes767a1472011-10-26 18:49:02 -0700371
372 enum HpsgWhen {
373 HPSG_WHEN_NEVER = 0,
374 HPSG_WHEN_EVERY_GC = 1,
375 };
376 enum HpsgWhat {
377 HPSG_WHAT_MERGED_OBJECTS = 0,
378 HPSG_WHAT_DISTINCT_OBJECTS = 1,
379 };
380 static bool DdmHandleHpsgNhsgChunk(HpsgWhen when, HpsgWhat what, bool native);
381
Ian Rogers00f7d0e2012-07-19 15:28:27 -0700382 static void DdmSendHeapInfo(HpifWhen reason)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700383 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Ian Rogers00f7d0e2012-07-19 15:28:27 -0700384 static void DdmSendHeapSegments(bool native)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700385 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Elliott Hughes545a0642011-11-08 19:10:03 -0800386
387 private:
Ian Rogersb726dcb2012-09-05 08:57:23 -0700388 static void DdmBroadcast(bool) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Ian Rogers00f7d0e2012-07-19 15:28:27 -0700389 static void PostThreadStartOrStop(Thread*, uint32_t)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700390 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Elliott Hughesa2155262011-11-16 16:26:58 -0800391
Elliott Hughes545a0642011-11-08 19:10:03 -0800392 static AllocRecord* recent_allocation_records_;
Elliott Hughes872d4ec2011-10-21 17:07:15 -0700393};
394
395#define CHUNK_TYPE(_name) \
Elliott Hughes82188472011-11-07 18:11:48 -0800396 static_cast<uint32_t>((_name)[0] << 24 | (_name)[1] << 16 | (_name)[2] << 8 | (_name)[3])
Elliott Hughes872d4ec2011-10-21 17:07:15 -0700397
398} // namespace art
399
400#endif // ART_DEBUGGER_H_