blob: 080ba6382c1d4c116d7e4921b9a6650bd0c21344 [file] [log] [blame]
Elliott Hughes2faa5f12012-01-30 14:42:07 -08001/*
2 * Copyright (C) 2011 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 */
Carl Shapiro1fb86202011-06-27 17:43:13 -070016
Brian Carlstromfc0e3212013-07-17 14:40:12 -070017#ifndef ART_RUNTIME_RUNTIME_H_
18#define ART_RUNTIME_RUNTIME_H_
Carl Shapiro1fb86202011-06-27 17:43:13 -070019
Elliott Hughesa0e18062012-04-13 15:59:59 -070020#include <jni.h>
Elliott Hughesc5f7c912011-08-18 14:00:42 -070021#include <stdio.h>
22
Vladimir Markob6e67922021-07-06 15:53:07 +010023#include <forward_list>
Elliott Hughese27955c2011-08-26 15:21:24 -070024#include <iosfwd>
Eric Holka79872b2020-10-01 13:09:53 -070025#include <memory>
Hiroshi Yamauchi799eb3a2014-07-18 15:38:17 -070026#include <set>
Brian Carlstrom6ea095a2011-08-16 15:26:54 -070027#include <string>
Carl Shapirofc322c72011-07-27 00:20:01 -070028#include <utility>
Brian Carlstrom6ea095a2011-08-16 15:26:54 -070029#include <vector>
Brian Carlstrom578bbdc2011-07-21 14:07:47 -070030
Calin Juravlec2753e62021-06-25 15:34:09 -070031#include "app_info.h"
Andreas Gampe44f67602018-11-28 08:27:27 -080032#include "base/locks.h"
Andreas Gampe794ad762015-02-23 08:12:24 -080033#include "base/macros.h"
Vladimir Markoc34bebf2018-08-16 16:12:49 +010034#include "base/mem_map.h"
Eric Holk480d9812021-01-27 23:41:45 +000035#include "base/metrics/metrics.h"
Nicolas Geoffray4cbb51a2020-02-07 11:25:54 +000036#include "base/string_view_cpp20.h"
Andrei Onea037d2822020-11-19 00:20:04 +000037#include "compat_framework.h"
Nicolas Geoffray4e92c3c2017-05-08 09:34:26 +010038#include "deoptimization_kind.h"
David Sehr9e734c72018-01-04 17:56:19 -080039#include "dex/dex_file_types.h"
Alex Lighteb7c1442015-08-31 13:17:42 -070040#include "experimental_flags.h"
Hiroshi Yamauchi94f7b492014-07-22 18:08:23 -070041#include "gc_root.h"
Ian Rogers62d6c772013-02-27 08:32:07 -080042#include "instrumentation.h"
Alex Light40320712017-12-14 11:52:04 -080043#include "jdwp_provider.h"
Alex Light79d6c802019-06-27 15:50:11 +000044#include "jni/jni_id_manager.h"
45#include "jni_id_type.h"
Eric Holk39d529f2021-02-17 12:48:53 -080046#include "metrics/reporter.h"
Mathieu Chartier8778c522016-10-04 19:06:30 -070047#include "obj_ptr.h"
Ian Rogers576ca0c2014-06-06 15:58:22 -070048#include "offsets.h"
Mathieu Chartierf8cb1782016-03-18 18:45:41 -070049#include "process_state.h"
Vladimir Marko7624d252014-05-02 14:40:15 +010050#include "quick/quick_method_frame_info.h"
Alex Lightc18eba32019-09-24 14:36:27 -070051#include "reflective_value_visitor.h"
Elliott Hughes9d5ccec2011-09-19 13:19:50 -070052#include "runtime_stats.h"
Carl Shapirob5573532011-07-12 18:22:59 -070053
Carl Shapiro1fb86202011-06-27 17:43:13 -070054namespace art {
55
Ian Rogers1d54e732013-05-02 21:10:01 -070056namespace gc {
Igor Murashkin2ffb7032017-11-08 13:35:21 -080057class AbstractSystemWeakHolder;
58class Heap;
Ian Rogers576ca0c2014-06-06 15:58:22 -070059} // namespace gc
Mathieu Chartiere5f13e52015-02-24 09:37:21 -080060
Mathew Inwooda5dc52c2018-02-19 15:30:51 +000061namespace hiddenapi {
62enum class EnforcementPolicy;
63} // namespace hiddenapi
64
Mathieu Chartiere5f13e52015-02-24 09:37:21 -080065namespace jit {
Igor Murashkin2ffb7032017-11-08 13:35:21 -080066class Jit;
Orion Hodsonad28f5e2018-10-17 09:08:17 +010067class JitCodeCache;
Igor Murashkin2ffb7032017-11-08 13:35:21 -080068class JitOptions;
Mathieu Chartiere5f13e52015-02-24 09:37:21 -080069} // namespace jit
70
Ian Rogers2dd0e2c2013-01-24 12:42:14 -080071namespace mirror {
Igor Murashkin2ffb7032017-11-08 13:35:21 -080072class Array;
73class ClassLoader;
74class DexCache;
75template<class T> class ObjectArray;
76template<class T> class PrimitiveArray;
77typedef PrimitiveArray<int8_t> ByteArray;
78class String;
79class Throwable;
Ian Rogers2dd0e2c2013-01-24 12:42:14 -080080} // namespace mirror
Alex Light7233c7e2016-07-28 10:07:45 -070081namespace ti {
Igor Murashkin2ffb7032017-11-08 13:35:21 -080082class Agent;
Andreas Gampeaadcbc62017-12-28 14:05:42 -080083class AgentSpec;
Alex Light7233c7e2016-07-28 10:07:45 -070084} // namespace ti
Mathieu Chartierc528dba2013-11-26 12:00:11 -080085namespace verifier {
Igor Murashkin2ffb7032017-11-08 13:35:21 -080086class MethodVerifier;
87enum class VerifyMode : int8_t;
Ian Rogers6a3c1fc2014-10-31 00:33:20 -070088} // namespace verifier
Mathieu Chartiere401d142015-04-22 13:56:20 -070089class ArenaPool;
90class ArtMethod;
Andreas Gampe8228cdf2017-05-30 15:03:54 -070091enum class CalleeSaveType: uint32_t;
Carl Shapiro61e019d2011-07-14 16:53:09 -070092class ClassLinker;
Mathieu Chartiere401d142015-04-22 13:56:20 -070093class CompilerCallbacks;
Vladimir Markoc0e0e5e2020-01-23 17:43:05 +000094class Dex2oatImageTest;
Carl Shapirofc322c72011-07-27 00:20:01 -070095class DexFile;
Andreas Gampe639b2b12019-01-08 10:32:50 -080096enum class InstructionSet;
Elliott Hughescf4c6c42011-09-01 15:16:42 -070097class InternTable;
Andreas Gamped482e732017-04-24 17:59:09 -070098class IsMarkedVisitor;
Ian Rogersb48b9eb2014-02-28 16:20:21 -080099class JavaVMExt;
Mathieu Chartiere401d142015-04-22 13:56:20 -0700100class LinearAlloc;
Elliott Hughesc33a32b2011-10-11 18:18:07 -0700101class MonitorList;
Ian Rogersef7d42f2014-01-06 12:55:46 -0800102class MonitorPool;
Ian Rogers576ca0c2014-06-06 15:58:22 -0700103class NullPointerHandler;
Vladimir Markof3d88a82018-12-21 16:38:47 +0000104class OatFileAssistantTest;
Mathieu Chartierf9c6fc62015-10-07 11:44:05 -0700105class OatFileManager;
Alex Light185d1342016-08-11 10:48:03 -0700106class Plugin;
Vladimir Marko88b2b802015-12-04 14:19:04 +0000107struct RuntimeArgumentMap;
Andreas Gampeac30fa22017-01-18 21:02:36 -0800108class RuntimeCallbacks;
Elliott Hughese27955c2011-08-26 15:21:24 -0700109class SignalCatcher;
Ian Rogers576ca0c2014-06-06 15:58:22 -0700110class StackOverflowHandler;
111class SuspensionHandler;
Carl Shapiro61e019d2011-07-14 16:53:09 -0700112class ThreadList;
Mathieu Chartierc6068c72018-11-13 16:00:58 -0800113class ThreadPool;
jeffhao2692b572011-12-16 15:42:28 -0800114class Trace;
Andreas Gampef6a780a2015-04-02 18:51:05 -0700115struct TraceConfig;
Sebastien Hertzd2fe10a2014-01-15 10:20:56 +0100116class Transaction;
Carl Shapiro61e019d2011-07-14 16:53:09 -0700117
Ian Rogerse63db272014-07-15 15:36:11 -0700118typedef std::vector<std::pair<std::string, const void*>> RuntimeOptions;
119
Carl Shapiro1fb86202011-06-27 17:43:13 -0700120class Runtime {
121 public:
Vladimir Marko88b2b802015-12-04 14:19:04 +0000122 // Parse raw runtime options.
123 static bool ParseOptions(const RuntimeOptions& raw_options,
124 bool ignore_unrecognized,
125 RuntimeArgumentMap* runtime_options);
126
Carl Shapiro61e019d2011-07-14 16:53:09 -0700127 // Creates and initializes a new runtime.
Vladimir Marko88b2b802015-12-04 14:19:04 +0000128 static bool Create(RuntimeArgumentMap&& runtime_options)
129 SHARED_TRYLOCK_FUNCTION(true, Locks::mutator_lock_);
130
131 // Creates and initializes a new runtime.
132 static bool Create(const RuntimeOptions& raw_options, bool ignore_unrecognized)
Ian Rogersb726dcb2012-09-05 08:57:23 -0700133 SHARED_TRYLOCK_FUNCTION(true, Locks::mutator_lock_);
Brian Carlstrom69b15fb2011-09-03 12:25:21 -0700134
Florian Mayer07710c52019-09-16 15:53:38 +0000135 bool EnsurePluginLoaded(const char* plugin_name, std::string* error_msg);
136 bool EnsurePerfettoPlugin(std::string* error_msg);
137
Mathieu Chartiere5f13e52015-02-24 09:37:21 -0800138 // IsAotCompiler for compilers that don't have a running runtime. Only dex2oat currently.
139 bool IsAotCompiler() const {
Calin Juravleffc87072016-04-20 14:22:09 +0100140 return !UseJitCompilation() && IsCompiler();
Mathieu Chartiere5f13e52015-02-24 09:37:21 -0800141 }
142
143 // IsCompiler is any runtime which has a running compiler, either dex2oat or JIT.
Elliott Hughesd9c67be2012-02-02 19:54:06 -0800144 bool IsCompiler() const {
Vladimir Marko2b5eaa22013-12-13 13:59:30 +0000145 return compiler_callbacks_ != nullptr;
146 }
147
Andreas Gampe4585f872015-03-27 23:45:15 -0700148 // If a compiler, are we compiling a boot image?
149 bool IsCompilingBootImage() const;
150
151 bool CanRelocate() const;
Alex Lighta59dd802014-07-02 16:28:08 -0700152
153 bool ShouldRelocate() const {
154 return must_relocate_ && CanRelocate();
155 }
156
157 bool MustRelocateIfPossible() const {
158 return must_relocate_;
159 }
160
Alex Light64ad14d2014-08-19 14:23:13 -0700161 bool IsImageDex2OatEnabled() const {
162 return image_dex2oat_enabled_;
Nicolas Geoffray4fcdc942014-07-22 10:48:00 +0100163 }
164
Vladimir Marko2b5eaa22013-12-13 13:59:30 +0000165 CompilerCallbacks* GetCompilerCallbacks() {
166 return compiler_callbacks_;
Elliott Hughesd9c67be2012-02-02 19:54:06 -0800167 }
168
Mathieu Chartier07ddb6f2015-11-05 11:16:34 -0800169 void SetCompilerCallbacks(CompilerCallbacks* callbacks) {
170 CHECK(callbacks != nullptr);
171 compiler_callbacks_ = callbacks;
172 }
173
Brian Carlstromcaabb1b2011-10-11 18:09:13 -0700174 bool IsZygote() const {
175 return is_zygote_;
176 }
177
Nicolas Geoffray4444f1b2019-06-10 14:09:19 +0100178 bool IsPrimaryZygote() const {
179 return is_primary_zygote_;
180 }
181
Nicolas Geoffray9ac09ee2019-05-08 23:38:27 +0100182 bool IsSystemServer() const {
183 return is_system_server_;
184 }
185
Nicolas Geoffraya67daeb2019-08-12 10:41:25 +0100186 void SetAsSystemServer() {
187 is_system_server_ = true;
188 is_zygote_ = false;
189 is_primary_zygote_ = false;
190 }
191
192 void SetAsZygoteChild(bool is_system_server, bool is_zygote) {
193 // System server should have been set earlier in SetAsSystemServer.
194 CHECK_EQ(is_system_server_, is_system_server);
195 is_zygote_ = is_zygote;
196 is_primary_zygote_ = false;
Nicolas Geoffray9ac09ee2019-05-08 23:38:27 +0100197 }
198
Anwar Ghuloum87183592013-08-14 12:12:19 -0700199 bool IsExplicitGcDisabled() const {
200 return is_explicit_gc_disabled_;
201 }
202
Tsu Chiang Chuang12e6d742014-05-22 10:22:25 -0700203 std::string GetCompilerExecutable() const;
204
Brian Carlstrom6449c622014-02-10 23:48:36 -0800205 const std::vector<std::string>& GetCompilerOptions() const {
206 return compiler_options_;
Dragos Sbirlea7467ee02013-06-21 09:20:34 -0700207 }
208
Vladimir Marko5c657fe2016-11-03 15:12:29 +0000209 void AddCompilerOption(const std::string& option) {
Andreas Gamped2abbc92014-12-19 09:53:27 -0800210 compiler_options_.push_back(option);
211 }
212
Brian Carlstrom6449c622014-02-10 23:48:36 -0800213 const std::vector<std::string>& GetImageCompilerOptions() const {
214 return image_compiler_options_;
Anwar Ghuloum8447d842013-04-30 17:27:40 -0700215 }
216
Victor Hsieh61ffd042021-05-20 15:14:25 -0700217 const std::vector<std::string>& GetImageLocations() const {
218 return image_locations_;
Brian Carlstrom31d8f522014-09-29 11:22:54 -0700219 }
220
Brian Carlstrom69b15fb2011-09-03 12:25:21 -0700221 // Starts a runtime, which may cause threads to be started and code to run.
Brian Carlstrombd86bcc2013-03-10 20:26:16 -0700222 bool Start() UNLOCK_FUNCTION(Locks::mutator_lock_);
Carl Shapiro2ed144c2011-07-26 16:52:08 -0700223
Mathieu Chartier590fee92013-09-13 13:46:47 -0700224 bool IsShuttingDown(Thread* self);
Mathieu Chartier90443472015-07-16 20:32:27 -0700225 bool IsShuttingDownLocked() const REQUIRES(Locks::runtime_shutdown_lock_) {
Ian Rogers9af209c2012-06-03 20:50:30 -0700226 return shutting_down_;
227 }
228
Mathieu Chartier90443472015-07-16 20:32:27 -0700229 size_t NumberOfThreadsBeingBorn() const REQUIRES(Locks::runtime_shutdown_lock_) {
Ian Rogers120f1c72012-09-28 17:17:10 -0700230 return threads_being_born_;
231 }
232
Mathieu Chartier90443472015-07-16 20:32:27 -0700233 void StartThreadBirth() REQUIRES(Locks::runtime_shutdown_lock_) {
Ian Rogers120f1c72012-09-28 17:17:10 -0700234 threads_being_born_++;
235 }
236
Mathieu Chartier90443472015-07-16 20:32:27 -0700237 void EndThreadBirth() REQUIRES(Locks::runtime_shutdown_lock_);
Ian Rogers120f1c72012-09-28 17:17:10 -0700238
Ian Rogers9af209c2012-06-03 20:50:30 -0700239 bool IsStarted() const {
240 return started_;
241 }
Elliott Hughesdcc24742011-09-07 14:02:44 -0700242
Mathieu Chartier7664f5c2012-06-08 18:15:32 -0700243 bool IsFinishedStarting() const {
244 return finished_starting_;
245 }
246
Vladimir Markodcfcce42018-06-27 10:00:28 +0000247 void RunRootClinits(Thread* self) REQUIRES_SHARED(Locks::mutator_lock_);
248
Carl Shapiro2ed144c2011-07-26 16:52:08 -0700249 static Runtime* Current() {
250 return instance_;
251 }
Carl Shapiro1fb86202011-06-27 17:43:13 -0700252
Nicolas Geoffraydb978712014-12-09 13:33:38 +0000253 // Aborts semi-cleanly. Used in the implementation of LOG(FATAL), which most
254 // callers should prefer.
Andreas Gampe90a32b12016-10-03 19:47:08 -0700255 NO_RETURN static void Abort(const char* msg) REQUIRES(!Locks::abort_lock_);
Elliott Hughesffe67362011-07-17 12:09:27 -0700256
Ian Rogers365c1022012-06-22 15:05:28 -0700257 // Returns the "main" ThreadGroup, used when attaching user threads.
Brian Carlstrom034f76b2012-08-01 15:51:58 -0700258 jobject GetMainThreadGroup() const;
Ian Rogers365c1022012-06-22 15:05:28 -0700259
260 // Returns the "system" ThreadGroup, used when attaching our internal threads.
Brian Carlstrom034f76b2012-08-01 15:51:58 -0700261 jobject GetSystemThreadGroup() const;
Ian Rogers365c1022012-06-22 15:05:28 -0700262
Brian Carlstromce888532013-10-10 00:32:58 -0700263 // Returns the system ClassLoader which represents the CLASSPATH.
264 jobject GetSystemClassLoader() const;
265
Elliott Hughes462c9442012-03-23 18:47:50 -0700266 // Attaches the calling native thread to the runtime.
Igor Murashkinb1d8c312015-08-04 11:18:43 -0700267 bool AttachCurrentThread(const char* thread_name, bool as_daemon, jobject thread_group,
Mathieu Chartier664bebf2012-11-12 16:54:11 -0800268 bool create_peer);
Carl Shapiro61e019d2011-07-14 16:53:09 -0700269
Elliott Hughesbf86d042011-08-31 17:53:14 -0700270 void CallExitHook(jint status);
271
Carl Shapiro61e019d2011-07-14 16:53:09 -0700272 // Detaches the current native thread from the runtime.
Mathieu Chartier90443472015-07-16 20:32:27 -0700273 void DetachCurrentThread() REQUIRES(!Locks::mutator_lock_);
Carl Shapiro61e019d2011-07-14 16:53:09 -0700274
Nicolas Geoffray4e92c3c2017-05-08 09:34:26 +0100275 void DumpDeoptimizations(std::ostream& os);
Ian Rogers7b078e82014-09-10 14:44:24 -0700276 void DumpForSigQuit(std::ostream& os);
Elliott Hughes21a5bf22011-12-07 14:35:20 -0800277 void DumpLockHolders(std::ostream& os);
Elliott Hughese27955c2011-08-26 15:21:24 -0700278
Carl Shapiro61e019d2011-07-14 16:53:09 -0700279 ~Runtime();
Carl Shapirob5573532011-07-12 18:22:59 -0700280
Vladimir Markod1908512018-11-22 14:57:28 +0000281 const std::vector<std::string>& GetBootClassPath() const {
282 return boot_class_path_;
283 }
284
285 const std::vector<std::string>& GetBootClassPathLocations() const {
286 DCHECK(boot_class_path_locations_.empty() ||
287 boot_class_path_locations_.size() == boot_class_path_.size());
288 return boot_class_path_locations_.empty() ? boot_class_path_ : boot_class_path_locations_;
Brian Carlstroma004aa92012-02-08 18:05:09 -0800289 }
290
Victor Hsieha09d8b72021-05-24 14:21:55 -0700291 const std::vector<int>& GetBootClassPathFds() const {
292 return boot_class_path_fds_;
293 }
294
Nicolas Geoffraybbdb1ed2021-06-29 14:12:05 +0100295 // Returns the checksums for the boot image, extensions and extra boot class path dex files,
296 // based on the image spaces and boot class path dex files loaded in memory.
297 const std::string& GetBootClassPathChecksums() const {
298 return boot_class_path_checksums_;
299 }
300
Brian Carlstroma004aa92012-02-08 18:05:09 -0800301 const std::string& GetClassPathString() const {
302 return class_path_string_;
Brian Carlstromb765be02011-08-17 23:54:10 -0700303 }
304
305 ClassLinker* GetClassLinker() const {
Carl Shapiro7a909592011-07-24 19:21:59 -0700306 return class_linker_;
307 }
308
Alex Light79d6c802019-06-27 15:50:11 +0000309 jni::JniIdManager* GetJniIdManager() const {
310 return jni_id_manager_.get();
311 }
312
Elliott Hughes7ede61e2011-09-14 18:18:06 -0700313 size_t GetDefaultStackSize() const {
314 return default_stack_size_;
315 }
316
Hans Boehmb2155572019-03-27 14:25:53 -0700317 unsigned int GetFinalizerTimeoutMs() const {
318 return finalizer_timeout_ms_;
319 }
320
Ian Rogers1d54e732013-05-02 21:10:01 -0700321 gc::Heap* GetHeap() const {
Elliott Hughesb3bd5f02012-03-08 21:05:27 -0800322 return heap_;
323 }
324
Elliott Hughescf4c6c42011-09-01 15:16:42 -0700325 InternTable* GetInternTable() const {
Mathieu Chartier2cebb242015-04-21 16:50:40 -0700326 DCHECK(intern_table_ != nullptr);
Elliott Hughescf4c6c42011-09-01 15:16:42 -0700327 return intern_table_;
328 }
329
Elliott Hughes0af55432011-08-17 18:37:28 -0700330 JavaVMExt* GetJavaVM() const {
Richard Uhlerda0a69e2016-10-11 15:06:38 +0100331 return java_vm_.get();
Elliott Hughesf2682d52011-08-15 16:37:04 -0700332 }
333
Hans Boehmb3da36c2016-12-15 13:12:59 -0800334 size_t GetMaxSpinsBeforeThinLockInflation() const {
Ian Rogersd9c4fc92013-10-01 19:45:43 -0700335 return max_spins_before_thin_lock_inflation_;
336 }
337
Elliott Hughesc33a32b2011-10-11 18:18:07 -0700338 MonitorList* GetMonitorList() const {
339 return monitor_list_;
340 }
341
Ian Rogersef7d42f2014-01-06 12:55:46 -0800342 MonitorPool* GetMonitorPool() const {
343 return monitor_pool_;
344 }
345
Ian Rogersc0542af2014-09-03 16:16:56 -0700346 // Is the given object the special object used to mark a cleared JNI weak global?
Mathieu Chartier8778c522016-10-04 19:06:30 -0700347 bool IsClearedJniWeakGlobal(ObjPtr<mirror::Object> obj) REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogersc0542af2014-09-03 16:16:56 -0700348
349 // Get the special object used to mark a cleared JNI weak global.
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700350 mirror::Object* GetClearedJniWeakGlobal() REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogersc0542af2014-09-03 16:16:56 -0700351
Roland Levillain7b0e8442018-04-11 18:27:47 +0100352 mirror::Throwable* GetPreAllocatedOutOfMemoryErrorWhenThrowingException()
353 REQUIRES_SHARED(Locks::mutator_lock_);
354 mirror::Throwable* GetPreAllocatedOutOfMemoryErrorWhenThrowingOOME()
355 REQUIRES_SHARED(Locks::mutator_lock_);
356 mirror::Throwable* GetPreAllocatedOutOfMemoryErrorWhenHandlingStackOverflow()
357 REQUIRES_SHARED(Locks::mutator_lock_);
Elliott Hughes225f5a12012-06-11 11:23:48 -0700358
Igor Murashkinb1d8c312015-08-04 11:18:43 -0700359 mirror::Throwable* GetPreAllocatedNoClassDefFoundError()
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700360 REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers63557452014-06-04 16:57:15 -0700361
Elliott Hughes225f5a12012-06-11 11:23:48 -0700362 const std::vector<std::string>& GetProperties() const {
363 return properties_;
364 }
365
Elliott Hughesd92bec42011-09-02 17:04:36 -0700366 ThreadList* GetThreadList() const {
367 return thread_list_;
368 }
369
Brian Carlstrom491ca9e2014-03-02 18:24:38 -0800370 static const char* GetVersion() {
Andreas Gampe2153f932014-06-26 08:09:17 -0700371 return "2.1.0";
Elliott Hughes7ede61e2011-09-14 18:18:06 -0700372 }
373
Narayan Kamath25352fc2016-08-03 12:46:58 +0100374 bool IsMethodHandlesEnabled() const {
Narayan Kamath93206752017-01-17 13:20:55 +0000375 return true;
Narayan Kamath25352fc2016-08-03 12:46:58 +0100376 }
377
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700378 void DisallowNewSystemWeaks() REQUIRES_SHARED(Locks::mutator_lock_);
379 void AllowNewSystemWeaks() REQUIRES_SHARED(Locks::mutator_lock_);
Hiroshi Yamauchi30493242016-11-03 13:06:52 -0700380 // broadcast_for_checkpoint is true when we broadcast for making blocking threads to respond to
381 // checkpoint requests. It's false when we broadcast to unblock blocking threads after system weak
382 // access is reenabled.
383 void BroadcastForNewSystemWeaks(bool broadcast_for_checkpoint = false);
Mathieu Chartierc11d9b82013-09-19 10:01:59 -0700384
Ian Rogers1d54e732013-05-02 21:10:01 -0700385 // Visit all the roots. If only_dirty is true then non-dirty roots won't be visited. If
386 // clean_dirty is true then dirty roots will be marked as non-dirty after visiting.
Mathieu Chartierbb87e0f2015-04-03 11:21:55 -0700387 void VisitRoots(RootVisitor* visitor, VisitRootFlags flags = kVisitRootFlagAllRoots)
Andreas Gamped98b4ed2016-11-04 20:27:24 -0700388 REQUIRES(!Locks::classlinker_classes_lock_, !Locks::trace_lock_)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700389 REQUIRES_SHARED(Locks::mutator_lock_);
Brian Carlstrom1f870082011-08-23 16:02:11 -0700390
Mathieu Chartier461687d2015-03-31 12:05:24 -0700391 // Visit image roots, only used for hprof since the GC uses the image space mod union table
392 // instead.
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700393 void VisitImageRoots(RootVisitor* visitor) REQUIRES_SHARED(Locks::mutator_lock_);
Mathieu Chartier461687d2015-03-31 12:05:24 -0700394
Roland Levillainef012222017-06-21 16:28:06 +0100395 // Visit all of the roots we can safely visit concurrently.
Igor Murashkinb1d8c312015-08-04 11:18:43 -0700396 void VisitConcurrentRoots(RootVisitor* visitor,
397 VisitRootFlags flags = kVisitRootFlagAllRoots)
Andreas Gamped98b4ed2016-11-04 20:27:24 -0700398 REQUIRES(!Locks::classlinker_classes_lock_, !Locks::trace_lock_)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700399 REQUIRES_SHARED(Locks::mutator_lock_);
Mathieu Chartier9ebae1f2012-10-15 17:38:16 -0700400
Mathieu Chartier858f1c52012-10-17 17:45:55 -0700401 // Visit all of the non thread roots, we can do this with mutators unpaused.
Mathieu Chartierbb87e0f2015-04-03 11:21:55 -0700402 void VisitNonThreadRoots(RootVisitor* visitor)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700403 REQUIRES_SHARED(Locks::mutator_lock_);
Mathieu Chartier858f1c52012-10-17 17:45:55 -0700404
Mathieu Chartierbb87e0f2015-04-03 11:21:55 -0700405 void VisitTransactionRoots(RootVisitor* visitor)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700406 REQUIRES_SHARED(Locks::mutator_lock_);
Hiroshi Yamauchi2cd334a2015-01-09 14:03:35 -0800407
Mathieu Chartier2cebb242015-04-21 16:50:40 -0700408 // Sweep system weaks, the system weak is deleted if the visitor return null. Otherwise, the
Mathieu Chartier6aa3df92013-09-17 15:17:28 -0700409 // system weak is updated to be the visitor's returned value.
Mathieu Chartier97509952015-07-13 14:35:43 -0700410 void SweepSystemWeaks(IsMarkedVisitor* visitor)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700411 REQUIRES_SHARED(Locks::mutator_lock_);
Mathieu Chartier6aa3df92013-09-17 15:17:28 -0700412
Alex Lightc18eba32019-09-24 14:36:27 -0700413 // Walk all reflective objects and visit their targets as well as any method/fields held by the
414 // runtime threads that are marked as being reflective.
415 void VisitReflectiveTargets(ReflectiveValueVisitor* visitor) REQUIRES(Locks::mutator_lock_);
416 // Helper for visiting reflective targets with lambdas for both field and method reflective
417 // targets.
418 template <typename FieldVis, typename MethodVis>
419 void VisitReflectiveTargets(FieldVis&& fv, MethodVis&& mv) REQUIRES(Locks::mutator_lock_) {
420 FunctionReflectiveValueVisitor frvv(fv, mv);
421 VisitReflectiveTargets(&frvv);
422 }
423
Ian Rogers9af209c2012-06-03 20:50:30 -0700424 // Returns a special method that calls into a trampoline for runtime method resolution
Mathieu Chartierfbc31082016-01-24 11:59:56 -0800425 ArtMethod* GetResolutionMethod();
Ian Rogers9af209c2012-06-03 20:50:30 -0700426
427 bool HasResolutionMethod() const {
Mathieu Chartiere401d142015-04-22 13:56:20 -0700428 return resolution_method_ != nullptr;
Ian Rogers9af209c2012-06-03 20:50:30 -0700429 }
430
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700431 void SetResolutionMethod(ArtMethod* method) REQUIRES_SHARED(Locks::mutator_lock_);
Igor Murashkin8275fba2017-05-02 15:58:02 -0700432 void ClearResolutionMethod() {
433 resolution_method_ = nullptr;
434 }
Ian Rogers9af209c2012-06-03 20:50:30 -0700435
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700436 ArtMethod* CreateResolutionMethod() REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers19846512012-02-24 11:42:47 -0800437
Ian Rogerse63db272014-07-15 15:36:11 -0700438 // Returns a special method that calls into a trampoline for runtime imt conflicts.
Mathieu Chartierfbc31082016-01-24 11:59:56 -0800439 ArtMethod* GetImtConflictMethod();
440 ArtMethod* GetImtUnimplementedMethod();
Jeff Hao88474b42013-10-23 16:24:40 -0700441
442 bool HasImtConflictMethod() const {
Mathieu Chartiere401d142015-04-22 13:56:20 -0700443 return imt_conflict_method_ != nullptr;
Jeff Hao88474b42013-10-23 16:24:40 -0700444 }
445
Igor Murashkin8275fba2017-05-02 15:58:02 -0700446 void ClearImtConflictMethod() {
447 imt_conflict_method_ = nullptr;
448 }
449
Nicolas Geoffrayf05f04b2019-10-31 11:50:41 +0000450 void FixupConflictTables() REQUIRES_SHARED(Locks::mutator_lock_);
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700451 void SetImtConflictMethod(ArtMethod* method) REQUIRES_SHARED(Locks::mutator_lock_);
452 void SetImtUnimplementedMethod(ArtMethod* method) REQUIRES_SHARED(Locks::mutator_lock_);
Jeff Hao88474b42013-10-23 16:24:40 -0700453
Nicolas Geoffray796d6302016-03-13 22:22:31 +0000454 ArtMethod* CreateImtConflictMethod(LinearAlloc* linear_alloc)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700455 REQUIRES_SHARED(Locks::mutator_lock_);
Jeff Hao88474b42013-10-23 16:24:40 -0700456
Igor Murashkin8275fba2017-05-02 15:58:02 -0700457 void ClearImtUnimplementedMethod() {
458 imt_unimplemented_method_ = nullptr;
459 }
460
Ian Rogers9af209c2012-06-03 20:50:30 -0700461 bool HasCalleeSaveMethod(CalleeSaveType type) const {
Andreas Gampe8228cdf2017-05-30 15:03:54 -0700462 return callee_save_methods_[static_cast<size_t>(type)] != 0u;
Ian Rogers9af209c2012-06-03 20:50:30 -0700463 }
464
Mathieu Chartiere401d142015-04-22 13:56:20 -0700465 ArtMethod* GetCalleeSaveMethod(CalleeSaveType type)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700466 REQUIRES_SHARED(Locks::mutator_lock_);
Hiroshi Yamauchiab088112014-07-14 13:00:14 -0700467
Mathieu Chartiere401d142015-04-22 13:56:20 -0700468 ArtMethod* GetCalleeSaveMethodUnchecked(CalleeSaveType type)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700469 REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers9af209c2012-06-03 20:50:30 -0700470
Mathieu Chartiere401d142015-04-22 13:56:20 -0700471 QuickMethodFrameInfo GetRuntimeMethodFrameInfo(ArtMethod* method)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700472 REQUIRES_SHARED(Locks::mutator_lock_);
Vladimir Marko7624d252014-05-02 14:40:15 +0100473
David Srbecky56de89a2018-10-01 15:32:20 +0100474 static constexpr size_t GetCalleeSaveMethodOffset(CalleeSaveType type) {
Andreas Gampe8228cdf2017-05-30 15:03:54 -0700475 return OFFSETOF_MEMBER(Runtime, callee_save_methods_[static_cast<size_t>(type)]);
Ian Rogers936b37f2014-02-14 00:52:24 -0800476 }
477
Vladimir Marko7624d252014-05-02 14:40:15 +0100478 InstructionSet GetInstructionSet() const {
479 return instruction_set_;
480 }
481
482 void SetInstructionSet(InstructionSet instruction_set);
Igor Murashkin8275fba2017-05-02 15:58:02 -0700483 void ClearInstructionSet();
Vladimir Marko7624d252014-05-02 14:40:15 +0100484
Mathieu Chartiere401d142015-04-22 13:56:20 -0700485 void SetCalleeSaveMethod(ArtMethod* method, CalleeSaveType type);
Igor Murashkin8275fba2017-05-02 15:58:02 -0700486 void ClearCalleeSaveMethods();
Ian Rogers4f0d07c2011-10-06 23:38:47 -0700487
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700488 ArtMethod* CreateCalleeSaveMethod() REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogersff1ed472011-09-20 13:46:24 -0700489
Andreas Gampe7ee607e2019-07-23 12:22:04 -0700490 uint64_t GetStat(int kind);
Elliott Hughes9d5ccec2011-09-19 13:19:50 -0700491
Ian Rogers9af209c2012-06-03 20:50:30 -0700492 RuntimeStats* GetStats() {
493 return &stats_;
494 }
Elliott Hughes9d5ccec2011-09-19 13:19:50 -0700495
496 bool HasStatsEnabled() const {
497 return stats_enabled_;
498 }
499
500 void ResetStats(int kinds);
501
Mathieu Chartier90443472015-07-16 20:32:27 -0700502 void SetStatsEnabled(bool new_state)
503 REQUIRES(!Locks::instrument_entrypoints_lock_, !Locks::mutator_lock_);
Elliott Hughes9d5ccec2011-09-19 13:19:50 -0700504
Andreas Gampe6be67ee2014-09-02 21:22:18 -0700505 enum class NativeBridgeAction { // private
506 kUnload,
507 kInitialize
508 };
Mathieu Chartiere5f13e52015-02-24 09:37:21 -0800509
Nicolas Geoffray433b79a2017-01-30 20:54:45 +0000510 jit::Jit* GetJit() const {
Mathieu Chartiere5f13e52015-02-24 09:37:21 -0800511 return jit_.get();
512 }
Calin Juravleffc87072016-04-20 14:22:09 +0100513
David Srbecky9ac8e432019-08-13 13:16:13 +0100514 jit::JitCodeCache* GetJitCodeCache() const {
515 return jit_code_cache_.get();
516 }
517
Calin Juravleffc87072016-04-20 14:22:09 +0100518 // Returns true if JIT compilations are enabled. GetJit() will be not null in this case.
519 bool UseJitCompilation() const;
Mathieu Chartiere5f13e52015-02-24 09:37:21 -0800520
Narayan Kamath3de95a72014-04-02 12:54:23 +0100521 void PreZygoteFork();
Nicolas Geoffrayce9ed362018-11-29 03:19:28 +0000522 void PostZygoteFork();
Nicolas Geoffrayd66c8622015-12-11 14:59:16 +0000523 void InitNonZygoteOrPostFork(
Calin Juravle016fcbe22018-05-03 19:47:35 -0700524 JNIEnv* env,
525 bool is_system_server,
Lev Rumyantsev87f36302019-12-13 15:49:37 -0800526 bool is_child_zygote,
Calin Juravle016fcbe22018-05-03 19:47:35 -0700527 NativeBridgeAction action,
528 const char* isa,
529 bool profile_system_server = false);
Brian Carlstromcaabb1b2011-10-11 18:09:13 -0700530
Ian Rogers9bc54402014-04-17 16:40:01 -0700531 const instrumentation::Instrumentation* GetInstrumentation() const {
532 return &instrumentation_;
533 }
534
Ian Rogers62d6c772013-02-27 08:32:07 -0800535 instrumentation::Instrumentation* GetInstrumentation() {
536 return &instrumentation_;
537 }
jeffhao2692b572011-12-16 15:42:28 -0800538
Calin Juravlec2753e62021-06-25 15:34:09 -0700539 void RegisterAppInfo(const std::string& package_name,
540 const std::vector<std::string>& code_paths,
Calin Juravlebeb9f202021-06-02 14:42:03 -0700541 const std::string& profile_output_filename,
Calin Juravlec2753e62021-06-25 15:34:09 -0700542 const std::string& ref_profile_filename,
543 int32_t code_type);
Dave Allison0aded082013-11-07 13:15:11 -0800544
Sebastien Hertzd2fe10a2014-01-15 10:20:56 +0100545 // Transaction support.
Chang Xing605fe242017-07-20 15:57:21 -0700546 bool IsActiveTransaction() const;
Chang Xing5a906fc2017-07-26 15:01:16 -0700547 void EnterTransactionMode(bool strict, mirror::Class* root);
Sebastien Hertzd2fe10a2014-01-15 10:20:56 +0100548 void ExitTransactionMode();
Chang Xing605fe242017-07-20 15:57:21 -0700549 void RollbackAllTransactions() REQUIRES_SHARED(Locks::mutator_lock_);
Chang Xing16d1dd82017-07-20 17:56:26 -0700550 // Transaction rollback and exit transaction are always done together, it's convenience to
551 // do them in one function.
552 void RollbackAndExitTransactionMode() REQUIRES_SHARED(Locks::mutator_lock_);
Sebastien Hertz1c80bec2015-02-03 11:58:06 +0100553 bool IsTransactionAborted() const;
Vladimir Markob6e67922021-07-06 15:53:07 +0100554 const Transaction* GetTransaction() const;
555 Transaction* GetTransaction();
Chang Xing5a906fc2017-07-26 15:01:16 -0700556 bool IsActiveStrictTransactionMode() const;
Sebastien Hertz1c80bec2015-02-03 11:58:06 +0100557
Sebastien Hertz2fd7e692015-04-02 11:11:19 +0200558 void AbortTransactionAndThrowAbortError(Thread* self, const std::string& abort_message)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700559 REQUIRES_SHARED(Locks::mutator_lock_);
Sebastien Hertz2fd7e692015-04-02 11:11:19 +0200560 void ThrowTransactionAbortError(Thread* self)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700561 REQUIRES_SHARED(Locks::mutator_lock_);
Sebastien Hertz1c80bec2015-02-03 11:58:06 +0100562
Vladimir Markob6e67922021-07-06 15:53:07 +0100563 void RecordWriteFieldBoolean(mirror::Object* obj,
564 MemberOffset field_offset,
565 uint8_t value,
566 bool is_volatile);
567 void RecordWriteFieldByte(mirror::Object* obj,
568 MemberOffset field_offset,
569 int8_t value,
570 bool is_volatile);
571 void RecordWriteFieldChar(mirror::Object* obj,
572 MemberOffset field_offset,
573 uint16_t value,
574 bool is_volatile);
575 void RecordWriteFieldShort(mirror::Object* obj,
576 MemberOffset field_offset,
577 int16_t value,
578 bool is_volatile);
579 void RecordWriteField32(mirror::Object* obj,
580 MemberOffset field_offset,
581 uint32_t value,
582 bool is_volatile);
583 void RecordWriteField64(mirror::Object* obj,
584 MemberOffset field_offset,
585 uint64_t value,
586 bool is_volatile);
Mathieu Chartiera058fdf2016-10-06 15:13:58 -0700587 void RecordWriteFieldReference(mirror::Object* obj,
588 MemberOffset field_offset,
589 ObjPtr<mirror::Object> value,
Vladimir Markob6e67922021-07-06 15:53:07 +0100590 bool is_volatile)
Mathieu Chartiera058fdf2016-10-06 15:13:58 -0700591 REQUIRES_SHARED(Locks::mutator_lock_);
Vladimir Markob6e67922021-07-06 15:53:07 +0100592 void RecordWriteArray(mirror::Array* array, size_t index, uint64_t value)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700593 REQUIRES_SHARED(Locks::mutator_lock_);
Vladimir Markob6e67922021-07-06 15:53:07 +0100594 void RecordStrongStringInsertion(ObjPtr<mirror::String> s)
Mathieu Chartier90443472015-07-16 20:32:27 -0700595 REQUIRES(Locks::intern_table_lock_);
Vladimir Markob6e67922021-07-06 15:53:07 +0100596 void RecordWeakStringInsertion(ObjPtr<mirror::String> s)
Mathieu Chartier90443472015-07-16 20:32:27 -0700597 REQUIRES(Locks::intern_table_lock_);
Vladimir Markob6e67922021-07-06 15:53:07 +0100598 void RecordStrongStringRemoval(ObjPtr<mirror::String> s)
Mathieu Chartier90443472015-07-16 20:32:27 -0700599 REQUIRES(Locks::intern_table_lock_);
Vladimir Markob6e67922021-07-06 15:53:07 +0100600 void RecordWeakStringRemoval(ObjPtr<mirror::String> s)
Mathieu Chartier90443472015-07-16 20:32:27 -0700601 REQUIRES(Locks::intern_table_lock_);
Vladimir Markob6e67922021-07-06 15:53:07 +0100602 void RecordResolveString(ObjPtr<mirror::DexCache> dex_cache, dex::StringIndex string_idx)
Mathieu Chartierbb816d62016-09-07 10:17:46 -0700603 REQUIRES_SHARED(Locks::mutator_lock_);
Vladimir Markob6e67922021-07-06 15:53:07 +0100604 void RecordResolveMethodType(ObjPtr<mirror::DexCache> dex_cache, dex::ProtoIndex proto_idx)
Vladimir Markoe9a4a602021-06-22 16:33:34 +0100605 REQUIRES_SHARED(Locks::mutator_lock_);
Sebastien Hertzd2fe10a2014-01-15 10:20:56 +0100606
Andreas Gampe44f67602018-11-28 08:27:27 -0800607 void SetFaultMessage(const std::string& message);
Mathieu Chartier15d34022014-02-26 17:16:38 -0800608
Igor Murashkinb1d8c312015-08-04 11:18:43 -0700609 void AddCurrentRuntimeFeaturesAsDex2OatArguments(std::vector<std::string>* arg_vector) const;
Ian Rogers8afeb852014-04-02 14:55:49 -0700610
Dave Allisonb373e092014-02-20 16:06:36 -0800611 bool ExplicitStackOverflowChecks() const {
Andreas Gampe928f72b2014-09-09 19:53:48 -0700612 return !implicit_so_checks_;
Dave Allisonb373e092014-02-20 16:06:36 -0800613 }
614
Nicolas Geoffray68bf3902017-09-07 14:40:48 +0100615 void DisableVerifier();
Igor Murashkin7617abd2015-07-10 18:27:47 -0700616 bool IsVerificationEnabled() const;
617 bool IsVerificationSoftFail() const;
Jeff Hao4a200f52014-04-01 14:58:49 -0700618
Mathew Inwooda5dc52c2018-02-19 15:30:51 +0000619 void SetHiddenApiEnforcementPolicy(hiddenapi::EnforcementPolicy policy) {
620 hidden_api_policy_ = policy;
David Brazdil3e0fa0a2018-01-15 18:41:44 +0000621 }
622
Mathew Inwooda5dc52c2018-02-19 15:30:51 +0000623 hiddenapi::EnforcementPolicy GetHiddenApiEnforcementPolicy() const {
624 return hidden_api_policy_;
David Brazdil3e0fa0a2018-01-15 18:41:44 +0000625 }
626
David Brazdile7681822018-12-14 16:25:33 +0000627 void SetCorePlatformApiEnforcementPolicy(hiddenapi::EnforcementPolicy policy) {
628 core_platform_api_policy_ = policy;
629 }
630
631 hiddenapi::EnforcementPolicy GetCorePlatformApiEnforcementPolicy() const {
632 return core_platform_api_policy_;
633 }
634
satayev09efc162021-02-22 17:24:57 +0000635 void SetTestApiEnforcementPolicy(hiddenapi::EnforcementPolicy policy) {
636 test_api_policy_ = policy;
637 }
638
639 hiddenapi::EnforcementPolicy GetTestApiEnforcementPolicy() const {
640 return test_api_policy_;
641 }
642
Mathew Inwood3383aa52018-03-16 14:18:33 +0000643 void SetHiddenApiExemptions(const std::vector<std::string>& exemptions) {
644 hidden_api_exemptions_ = exemptions;
645 }
646
647 const std::vector<std::string>& GetHiddenApiExemptions() {
648 return hidden_api_exemptions_;
649 }
650
David Brazdilee7d2fd2018-01-20 17:25:23 +0000651 void SetDedupeHiddenApiWarnings(bool value) {
652 dedupe_hidden_api_warnings_ = value;
653 }
654
655 bool ShouldDedupeHiddenApiWarnings() {
656 return dedupe_hidden_api_warnings_;
657 }
658
Mathew Inwood73ddda42018-04-03 15:32:32 +0100659 void SetHiddenApiEventLogSampleRate(uint32_t rate) {
660 hidden_api_access_event_log_rate_ = rate;
661 }
662
663 uint32_t GetHiddenApiEventLogSampleRate() const {
664 return hidden_api_access_event_log_rate_;
665 }
666
Mathew Inwood5bcef172018-05-01 14:40:12 +0100667 const std::string& GetProcessPackageName() const {
668 return process_package_name_;
669 }
670
671 void SetProcessPackageName(const char* package_name) {
672 if (package_name == nullptr) {
673 process_package_name_.clear();
674 } else {
675 process_package_name_ = package_name;
676 }
677 }
678
David Brazdil35a3f6a2019-03-04 15:59:06 +0000679 const std::string& GetProcessDataDirectory() const {
680 return process_data_directory_;
681 }
682
683 void SetProcessDataDirectory(const char* data_dir) {
684 if (data_dir == nullptr) {
685 process_data_directory_.clear();
686 } else {
687 process_data_directory_ = data_dir;
688 }
689 }
690
Dmitriy Ivanov785049f2014-07-18 10:08:57 -0700691 const std::vector<std::string>& GetCpuAbilist() const {
692 return cpu_abilist_;
693 }
694
Evgenii Stepanov1e133742015-05-20 12:30:59 -0700695 bool IsRunningOnMemoryTool() const {
696 return is_running_on_memory_tool_;
Mathieu Chartierda44d772014-04-01 15:01:46 -0700697 }
698
David Brazdil2bb2fbd2018-11-13 18:24:26 +0000699 void SetTargetSdkVersion(uint32_t version) {
Jeff Haof00571c2014-05-29 17:29:47 -0700700 target_sdk_version_ = version;
701 }
702
David Brazdil2bb2fbd2018-11-13 18:24:26 +0000703 uint32_t GetTargetSdkVersion() const {
Jeff Haof00571c2014-05-29 17:29:47 -0700704 return target_sdk_version_;
705 }
706
Andrei Onea037d2822020-11-19 00:20:04 +0000707 CompatFramework& GetCompatFramework() {
708 return compat_framework_;
atrostfab72082019-12-06 13:37:36 +0000709 }
710
Narayan Kamath5a2be3f2015-02-16 13:51:51 +0000711 uint32_t GetZygoteMaxFailedBoots() const {
712 return zygote_max_failed_boots_;
713 }
714
Alex Lighteb7c1442015-08-31 13:17:42 -0700715 bool AreExperimentalFlagsEnabled(ExperimentalFlags flags) {
716 return (experimental_flags_ & flags) != ExperimentalFlags::kNone;
Igor Murashkin158f35c2015-06-10 15:55:30 -0700717 }
718
Orion Hodsonad28f5e2018-10-17 09:08:17 +0100719 void CreateJitCodeCache(bool rwx_memory_allowed);
720
Mathieu Chartier455f67c2015-03-17 13:48:29 -0700721 // Create the JIT and instrumentation and code cache.
Mathieu Chartiere5f13e52015-02-24 09:37:21 -0800722 void CreateJit();
723
Mathieu Chartier9b34b242015-03-09 11:30:17 -0700724 ArenaPool* GetArenaPool() {
725 return arena_pool_.get();
726 }
727 const ArenaPool* GetArenaPool() const {
728 return arena_pool_.get();
729 }
Vladimir Markob6e67922021-07-06 15:53:07 +0100730 ArenaPool* GetJitArenaPool() {
731 return jit_arena_pool_.get();
732 }
Jean-Philippe Halimica76a1a2016-02-02 19:48:52 +0100733
734 void ReclaimArenaPoolMemory();
735
Mathieu Chartierc7853442015-03-27 14:35:38 -0700736 LinearAlloc* GetLinearAlloc() {
737 return linear_alloc_.get();
738 }
Mathieu Chartier9b34b242015-03-09 11:30:17 -0700739
Mathieu Chartier455f67c2015-03-17 13:48:29 -0700740 jit::JitOptions* GetJITOptions() {
741 return jit_options_.get();
742 }
743
Nicolas Geoffray433b79a2017-01-30 20:54:45 +0000744 bool IsJavaDebuggable() const {
745 return is_java_debuggable_;
Alex Light6b16d892016-11-11 11:21:04 -0800746 }
747
Florian Mayer07710c52019-09-16 15:53:38 +0000748 void SetProfileableFromShell(bool value) {
749 is_profileable_from_shell_ = value;
750 }
751
752 bool IsProfileableFromShell() const {
753 return is_profileable_from_shell_;
754 }
755
Florian Mayer0bc9bef2021-04-28 15:52:33 +0100756 void SetProfileable(bool value) {
757 is_profileable_ = value;
758 }
759
760 bool IsProfileable() const {
761 return is_profileable_;
762 }
763
Nicolas Geoffray433b79a2017-01-30 20:54:45 +0000764 void SetJavaDebuggable(bool value);
765
766 // Deoptimize the boot image, called for Java debuggable apps.
Nicolas Geoffray226805d2018-12-14 10:59:02 +0000767 void DeoptimizeBootImage() REQUIRES(Locks::mutator_lock_);
Alex Light6b16d892016-11-11 11:21:04 -0800768
David Srbeckyf4480162016-03-16 00:06:24 +0000769 bool IsNativeDebuggable() const {
770 return is_native_debuggable_;
771 }
772
773 void SetNativeDebuggable(bool value) {
774 is_native_debuggable_ = value;
775 }
776
randy.jeong5bef0222019-05-27 10:29:09 +0900777 void SetSignalHookDebuggable(bool value);
778
Alex Light0aa7a5a2018-10-10 15:58:14 +0000779 bool AreNonStandardExitsEnabled() const {
780 return non_standard_exits_enabled_;
781 }
782
783 void SetNonStandardExitsEnabled() {
David Srbecky28f6cff2018-10-16 15:07:28 +0100784 DoAndMaybeSwitchInterpreter([=](){ non_standard_exits_enabled_ = true; });
Alex Light0aa7a5a2018-10-10 15:58:14 +0000785 }
786
Alex Light7919db92017-11-29 09:00:55 -0800787 bool AreAsyncExceptionsThrown() const {
788 return async_exceptions_thrown_;
789 }
790
791 void SetAsyncExceptionsThrown() {
David Srbecky28f6cff2018-10-16 15:07:28 +0100792 DoAndMaybeSwitchInterpreter([=](){ async_exceptions_thrown_ = true; });
Alex Light7919db92017-11-29 09:00:55 -0800793 }
794
David Srbecky28f6cff2018-10-16 15:07:28 +0100795 // Change state and re-check which interpreter should be used.
796 //
797 // This must be called whenever there is an event that forces
798 // us to use different interpreter (e.g. debugger is attached).
799 //
800 // Changing the state using the lamda gives us some multihreading safety.
801 // It ensures that two calls do not interfere with each other and
802 // it makes it possible to DCHECK that thread local flag is correct.
803 template<typename Action>
David Srbeckyd3883902019-02-26 17:29:32 +0000804 static void DoAndMaybeSwitchInterpreter(Action lamda);
David Srbecky28f6cff2018-10-16 15:07:28 +0100805
Andreas Gampedd671252015-07-23 14:37:18 -0700806 // Returns the build fingerprint, if set. Otherwise an empty string is returned.
807 std::string GetFingerprint() {
808 return fingerprint_;
809 }
810
Mathieu Chartier673ed3d2015-08-28 14:56:43 -0700811 // Called from class linker.
Vladimir Marko024d69f2019-06-13 10:52:32 +0100812 void SetSentinel(ObjPtr<mirror::Object> sentinel) REQUIRES_SHARED(Locks::mutator_lock_);
Roland Levillain0e155592018-11-05 18:31:49 +0000813 // For testing purpose only.
814 // TODO: Remove this when this is no longer needed (b/116087961).
815 GcRoot<mirror::Object> GetSentinel() REQUIRES_SHARED(Locks::mutator_lock_);
Mathieu Chartier673ed3d2015-08-28 14:56:43 -0700816
Nicolas Geoffraye3f775b2019-12-04 14:41:52 +0000817
818 // Use a sentinel for marking entries in a table that have been cleared.
819 // This helps diagnosing in case code tries to wrongly access such
820 // entries.
821 static mirror::Class* GetWeakClassSentinel() {
822 return reinterpret_cast<mirror::Class*>(0xebadbeef);
823 }
824
825 // Helper for the GC to process a weak class in a table.
826 static void ProcessWeakClass(GcRoot<mirror::Class>* root_ptr,
827 IsMarkedVisitor* visitor,
828 mirror::Class* update)
829 REQUIRES_SHARED(Locks::mutator_lock_);
830
Mathieu Chartier951ec2c2015-09-22 08:50:05 -0700831 // Create a normal LinearAlloc or low 4gb version if we are 64 bit AOT compiler.
832 LinearAlloc* CreateLinearAlloc();
833
Mathieu Chartierf9c6fc62015-10-07 11:44:05 -0700834 OatFileManager& GetOatFileManager() const {
835 DCHECK(oat_file_manager_ != nullptr);
Mathieu Chartiere58991b2015-10-13 07:59:34 -0700836 return *oat_file_manager_;
Mathieu Chartierf9c6fc62015-10-07 11:44:05 -0700837 }
838
Mathieu Chartier32cc9ee2015-10-15 09:19:15 -0700839 double GetHashTableMinLoadFactor() const;
840 double GetHashTableMaxLoadFactor() const;
841
Andreas Gampe83e20492018-11-07 11:12:26 -0800842 bool IsSafeMode() const {
Andreas Gampe83e20492018-11-07 11:12:26 -0800843 return safe_mode_;
844 }
845
Nicolas Geoffray787ae8e2015-11-05 11:32:24 +0000846 void SetSafeMode(bool mode) {
847 safe_mode_ = mode;
848 }
849
Nicolas Geoffraya73280d2016-02-15 13:05:16 +0000850 bool GetDumpNativeStackOnSigQuit() const {
851 return dump_native_stack_on_sig_quit_;
852 }
853
Mathieu Chartierf8cb1782016-03-18 18:45:41 -0700854 void UpdateProcessState(ProcessState process_state);
855
856 // Returns true if we currently care about long mutator pause.
857 bool InJankPerceptibleProcessState() const {
858 return process_state_ == kProcessStateJankPerceptible;
859 }
860
Calin Juravle97cbc922016-04-15 16:16:35 +0100861 void RegisterSensitiveThread() const;
862
Andreas Gampef38a6612016-04-11 08:42:26 -0700863 void SetZygoteNoThreadSection(bool val) {
864 zygote_no_threads_ = val;
865 }
866
867 bool IsZygoteNoThreadSection() const {
868 return zygote_no_threads_;
869 }
870
Nicolas Geoffray433b79a2017-01-30 20:54:45 +0000871 // Returns if the code can be deoptimized asynchronously. Code may be compiled with some
Mingyao Yangf711f2c2016-05-23 12:29:39 -0700872 // optimization that makes it impossible to deoptimize.
Nicolas Geoffray433b79a2017-01-30 20:54:45 +0000873 bool IsAsyncDeoptimizeable(uintptr_t code) const REQUIRES_SHARED(Locks::mutator_lock_);
Mingyao Yangf711f2c2016-05-23 12:29:39 -0700874
David Sehrd106d9f2016-08-16 19:22:57 -0700875 // Returns a saved copy of the environment (getenv/setenv values).
876 // Used by Fork to protect against overwriting LD_LIBRARY_PATH, etc.
877 char** GetEnvSnapshot() const {
878 return env_snapshot_.GetSnapshot();
879 }
880
Andreas Gampefda57142016-09-08 20:29:18 -0700881 void AddSystemWeakHolder(gc::AbstractSystemWeakHolder* holder);
882 void RemoveSystemWeakHolder(gc::AbstractSystemWeakHolder* holder);
883
Alex Lightf889c702018-02-23 15:25:45 -0800884 void AttachAgent(JNIEnv* env, const std::string& agent_arg, jobject class_loader);
Leonard Mosescueb842212016-10-06 17:26:36 -0700885
Andreas Gampeaadcbc62017-12-28 14:05:42 -0800886 const std::list<std::unique_ptr<ti::Agent>>& GetAgents() const {
Alex Light65af20b2017-04-20 09:15:08 -0700887 return agents_;
888 }
889
Andreas Gampeac30fa22017-01-18 21:02:36 -0800890 RuntimeCallbacks* GetRuntimeCallbacks();
Andreas Gampe04bbb5b2017-01-19 17:49:03 +0000891
Alex Light77fee872017-09-05 14:51:49 -0700892 bool HasLoadedPlugins() const {
893 return !plugins_.empty();
894 }
895
Andreas Gampebad529d2017-02-13 18:52:10 -0800896 void InitThreadGroups(Thread* self);
897
Mathieu Chartier1d495012017-04-11 17:50:00 -0700898 void SetDumpGCPerformanceOnShutdown(bool value) {
899 dump_gc_performance_on_shutdown_ = value;
900 }
901
Lokesh Gidra10d0c962019-03-07 22:40:36 +0000902 bool GetDumpGCPerformanceOnShutdown() const {
903 return dump_gc_performance_on_shutdown_;
904 }
905
Nicolas Geoffray4e92c3c2017-05-08 09:34:26 +0100906 void IncrementDeoptimizationCount(DeoptimizationKind kind) {
907 DCHECK_LE(kind, DeoptimizationKind::kLast);
908 deoptimization_counts_[static_cast<size_t>(kind)]++;
909 }
910
Nicolas Geoffrayb9bec2e2017-05-24 15:59:18 +0100911 uint32_t GetNumberOfDeoptimizations() const {
912 uint32_t result = 0;
913 for (size_t i = 0; i <= static_cast<size_t>(DeoptimizationKind::kLast); ++i) {
914 result += deoptimization_counts_[i];
915 }
916 return result;
917 }
918
Orion Hodson971068d2021-06-30 21:17:53 +0100919 bool DenyArtApexDataFiles() const {
920 return deny_art_apex_data_files_;
921 }
922
Mathieu Chartierc42cb0e2017-10-13 11:35:00 -0700923 // Whether or not we use MADV_RANDOM on files that are thought to have random access patterns.
924 // This is beneficial for low RAM devices since it reduces page cache thrashing.
925 bool MAdviseRandomAccess() const {
926 return madvise_random_access_;
927 }
928
Jagadeesh Pakaravoor06541532021-02-22 21:19:09 -0800929 size_t GetMadviseWillNeedSizeVdex() const {
930 return madvise_willneed_vdex_filesize_;
931 }
932
933 size_t GetMadviseWillNeedSizeOdex() const {
934 return madvise_willneed_odex_filesize_;
935 }
936
937 size_t GetMadviseWillNeedSizeArt() const {
938 return madvise_willneed_art_filesize_;
939 }
940
Alex Light40320712017-12-14 11:52:04 -0800941 const std::string& GetJdwpOptions() {
942 return jdwp_options_;
943 }
944
945 JdwpProvider GetJdwpProvider() const {
946 return jdwp_provider_;
947 }
948
Alex Lightf3677472019-06-26 16:31:53 -0700949 JniIdType GetJniIdType() const {
950 return jni_ids_indirection_;
Alex Light79d6c802019-06-27 15:50:11 +0000951 }
952
Alex Lightf3677472019-06-26 16:31:53 -0700953 bool CanSetJniIdType() const {
954 return GetJniIdType() == JniIdType::kSwapablePointer;
955 }
956
957 // Changes the JniIdType to the given type. Only allowed if CanSetJniIdType(). All threads must be
958 // suspended to call this function.
959 void SetJniIdType(JniIdType t);
960
Andreas Gampe0b0ffc12018-08-01 14:41:27 -0700961 uint32_t GetVerifierLoggingThresholdMs() const {
962 return verifier_logging_threshold_ms_;
963 }
964
Mathieu Chartierada33d72018-12-17 13:17:30 -0800965 // Atomically delete the thread pool if the reference count is 0.
966 bool DeleteThreadPool() REQUIRES(!Locks::runtime_thread_pool_lock_);
967
968 // Wait for all the thread workers to be attached.
969 void WaitForThreadPoolWorkersToStart() REQUIRES(!Locks::runtime_thread_pool_lock_);
970
971 // Scoped usage of the runtime thread pool. Prevents the pool from being
972 // deleted. Note that the thread pool is only for startup and gets deleted after.
973 class ScopedThreadPoolUsage {
974 public:
975 ScopedThreadPoolUsage();
976 ~ScopedThreadPoolUsage();
977
978 // Return the thread pool.
979 ThreadPool* GetThreadPool() const {
980 return thread_pool_;
981 }
982
983 private:
984 ThreadPool* const thread_pool_;
985 };
986
Mathieu Chartiera88abfa2019-02-04 11:08:29 -0800987 bool LoadAppImageStartupCache() const {
988 return load_app_image_startup_cache_;
989 }
990
991 void SetLoadAppImageStartupCacheEnabled(bool enabled) {
992 load_app_image_startup_cache_ = enabled;
993 }
994
Mathieu Chartier03625442019-06-24 17:29:23 -0700995 // Reset the startup completed status so that we can call NotifyStartupCompleted again. Should
996 // only be used for testing.
997 void ResetStartupCompleted();
998
Mathieu Chartier175ce3d2019-03-06 16:54:24 -0800999 // Notify the runtime that application startup is considered completed. Only has effect for the
1000 // first call.
1001 void NotifyStartupCompleted();
1002
Calin Juravlec2753e62021-06-25 15:34:09 -07001003 // Notify the runtime that the application finished loading some dex/odex files. This is
1004 // called everytime we load a set of dex files in a class loader.
1005 void NotifyDexFileLoaded();
1006
Mathieu Chartier175ce3d2019-03-06 16:54:24 -08001007 // Return true if startup is already completed.
1008 bool GetStartupCompleted() const;
1009
Andreas Gamped84794d2019-07-18 13:40:03 -07001010 bool IsVerifierMissingKThrowFatal() const {
1011 return verifier_missing_kthrow_fatal_;
1012 }
1013
Hans Boehm1792c6f2021-06-24 17:35:50 -07001014 bool IsJavaZygoteForkLoopRequired() const {
1015 return force_java_zygote_fork_loop_;
1016 }
1017
Florian Mayer0972d082020-05-15 14:07:31 +02001018 bool IsPerfettoHprofEnabled() const {
1019 return perfetto_hprof_enabled_;
1020 }
1021
Wessam Hassaneinb5a10be2020-11-11 16:42:52 -08001022 bool IsPerfettoJavaHeapStackProfEnabled() const {
1023 return perfetto_javaheapprof_enabled_;
1024 }
1025
wangguibo0d290722021-04-24 11:27:06 +08001026 bool IsMonitorTimeoutEnabled() const {
1027 return monitor_timeout_enable_;
1028 }
1029
1030 uint64_t GetMonitorTimeoutNs() const {
1031 return monitor_timeout_ns_;
1032 }
Mathieu Chartierccc75192019-10-28 13:34:03 -07001033 // Return true if we should load oat files as executable or not.
1034 bool GetOatFilesExecutable() const;
1035
Eric Holka79872b2020-10-01 13:09:53 -07001036 metrics::ArtMetrics* GetMetrics() { return &metrics_; }
1037
Calin Juravlec2753e62021-06-25 15:34:09 -07001038 AppInfo* GetAppInfo() { return &app_info_; }
1039
Eric Holk5e435b22021-02-23 17:24:47 -08001040 void RequestMetricsReport(bool synchronous = true);
1041
Jagadeesh Pakaravoor06541532021-02-22 21:19:09 -08001042 static void MadviseFileForRange(size_t madvise_size_limit_bytes,
1043 size_t map_size_bytes,
1044 const uint8_t* map_begin,
1045 const uint8_t* map_end,
1046 const std::string& file_name);
1047
Nicolas Geoffrayd3c45c22021-04-27 13:21:28 +01001048 const std::string& GetApexVersions() const {
1049 return apex_versions_;
1050 }
1051
Calin Juravle09eacd92021-05-19 17:03:55 -07001052 // Trigger a flag reload from system properties or device congfigs.
1053 //
1054 // Should only be called from runtime init and zygote post fork as
1055 // we don't want to change the runtime config midway during execution.
1056 //
1057 // The caller argument should be the name of the function making this call
1058 // and will be used to enforce the appropriate names.
1059 //
1060 // See Flags::ReloadAllFlags as well.
1061 static void ReloadAllFlags(const std::string& caller);
1062
Carl Shapirob5573532011-07-12 18:22:59 -07001063 private:
Elliott Hughes457005c2012-04-16 13:54:25 -07001064 static void InitPlatformSignalHandlers();
Elliott Hughesffe67362011-07-17 12:09:27 -07001065
Elliott Hughesdcc24742011-09-07 14:02:44 -07001066 Runtime();
Carl Shapiro61e019d2011-07-14 16:53:09 -07001067
Elliott Hughesc1674ed2011-08-25 18:09:09 -07001068 void BlockSignals();
1069
Vladimir Marko88b2b802015-12-04 14:19:04 +00001070 bool Init(RuntimeArgumentMap&& runtime_options)
Ian Rogersb726dcb2012-09-05 08:57:23 -07001071 SHARED_TRYLOCK_FUNCTION(true, Locks::mutator_lock_);
Mathieu Chartier90443472015-07-16 20:32:27 -07001072 void InitNativeMethods() REQUIRES(!Locks::mutator_lock_);
Elliott Hughesff17f1f2012-01-24 18:12:29 -08001073 void RegisterRuntimeNativeMethods(JNIEnv* env);
Calin Juravle1ff90562021-06-16 14:37:42 -07001074 void InitMetrics();
Elliott Hughesd1cc8362011-10-24 16:58:50 -07001075
Elliott Hughes85d15452011-09-16 17:33:01 -07001076 void StartDaemonThreads();
Elliott Hughesd1cc8362011-10-24 16:58:50 -07001077 void StartSignalCatcher();
Carl Shapiro61e019d2011-07-14 16:53:09 -07001078
Calin Juravle31f2c152015-10-23 17:56:15 +01001079 void MaybeSaveJitProfilingInfo();
1080
Andreas Gampe585da952016-12-02 14:52:29 -08001081 // Visit all of the thread roots.
1082 void VisitThreadRoots(RootVisitor* visitor, VisitRootFlags flags)
1083 REQUIRES_SHARED(Locks::mutator_lock_);
1084
1085 // Visit all other roots which must be done with mutators suspended.
1086 void VisitNonConcurrentRoots(RootVisitor* visitor, VisitRootFlags flags)
1087 REQUIRES_SHARED(Locks::mutator_lock_);
1088
1089 // Constant roots are the roots which never change after the runtime is initialized, they only
1090 // need to be visited once per GC cycle.
1091 void VisitConstantRoots(RootVisitor* visitor)
1092 REQUIRES_SHARED(Locks::mutator_lock_);
1093
Andreas Gampe44f67602018-11-28 08:27:27 -08001094 // Note: To be lock-free, GetFaultMessage temporarily replaces the lock message with null.
1095 // As such, there is a window where a call will return an empty string. In general,
1096 // only aborting code should retrieve this data (via GetFaultMessageForAbortLogging
1097 // friend).
1098 std::string GetFaultMessage();
1099
Mathieu Chartierada33d72018-12-17 13:17:30 -08001100 ThreadPool* AcquireThreadPool() REQUIRES(!Locks::runtime_thread_pool_lock_);
1101 void ReleaseThreadPool() REQUIRES(!Locks::runtime_thread_pool_lock_);
1102
Nicolas Geoffrayd3c45c22021-04-27 13:21:28 +01001103 // Parses /apex/apex-info-list.xml to initialize a string containing versions
1104 // of boot classpath jars and encoded into .oat files.
1105 void InitializeApexVersions();
1106
Mathieu Chartier2cebb242015-04-21 16:50:40 -07001107 // A pointer to the active runtime or null.
Elliott Hughesb3bd5f02012-03-08 21:05:27 -08001108 static Runtime* instance_;
1109
Ian Rogers8afeb852014-04-02 14:55:49 -07001110 // NOTE: these must match the gc::ProcessState values as they come directly from the framework.
1111 static constexpr int kProfileForground = 0;
Calin Juravle31f2c152015-10-23 17:56:15 +01001112 static constexpr int kProfileBackground = 1;
Ian Rogers8afeb852014-04-02 14:55:49 -07001113
Mingyao Yang0a87a652017-04-12 13:43:15 -07001114 static constexpr uint32_t kCalleeSaveSize = 6u;
Andreas Gampe8228cdf2017-05-30 15:03:54 -07001115
Mathieu Chartiere401d142015-04-22 13:56:20 -07001116 // 64 bit so that we can share the same asm offsets for both 32 and 64 bits.
Andreas Gampe8228cdf2017-05-30 15:03:54 -07001117 uint64_t callee_save_methods_[kCalleeSaveSize];
Roland Levillain7b0e8442018-04-11 18:27:47 +01001118 // Pre-allocated exceptions (see Runtime::Init).
1119 GcRoot<mirror::Throwable> pre_allocated_OutOfMemoryError_when_throwing_exception_;
1120 GcRoot<mirror::Throwable> pre_allocated_OutOfMemoryError_when_throwing_oome_;
1121 GcRoot<mirror::Throwable> pre_allocated_OutOfMemoryError_when_handling_stack_overflow_;
Ian Rogers63557452014-06-04 16:57:15 -07001122 GcRoot<mirror::Throwable> pre_allocated_NoClassDefFoundError_;
Mathieu Chartiere401d142015-04-22 13:56:20 -07001123 ArtMethod* resolution_method_;
1124 ArtMethod* imt_conflict_method_;
Mathieu Chartier2d2621a2014-10-23 16:48:06 -07001125 // Unresolved method has the same behavior as the conflict method, it is used by the class linker
1126 // for differentiating between unfilled imt slots vs conflict slots in superclasses.
Mathieu Chartiere401d142015-04-22 13:56:20 -07001127 ArtMethod* imt_unimplemented_method_;
Ian Rogers6ed19fd2014-03-20 08:10:17 -07001128
Ian Rogersc0542af2014-09-03 16:16:56 -07001129 // Special sentinel object used to invalid conditions in JNI (cleared weak references) and
1130 // JDWP (invalid references).
1131 GcRoot<mirror::Object> sentinel_;
1132
Vladimir Marko7624d252014-05-02 14:40:15 +01001133 InstructionSet instruction_set_;
Vladimir Marko7624d252014-05-02 14:40:15 +01001134
Vladimir Marko2b5eaa22013-12-13 13:59:30 +00001135 CompilerCallbacks* compiler_callbacks_;
Elliott Hughes9ca7a1f2011-10-11 14:29:52 -07001136 bool is_zygote_;
Nicolas Geoffray4444f1b2019-06-10 14:09:19 +01001137 bool is_primary_zygote_;
Nicolas Geoffray9ac09ee2019-05-08 23:38:27 +01001138 bool is_system_server_;
Alex Lighta59dd802014-07-02 16:28:08 -07001139 bool must_relocate_;
Mathieu Chartier069387a2012-06-18 12:01:01 -07001140 bool is_concurrent_gc_enabled_;
Anwar Ghuloum87183592013-08-14 12:12:19 -07001141 bool is_explicit_gc_disabled_;
Alex Light64ad14d2014-08-19 14:23:13 -07001142 bool image_dex2oat_enabled_;
Brian Carlstrom0a5b14d2011-09-27 13:29:15 -07001143
Tsu Chiang Chuang12e6d742014-05-22 10:22:25 -07001144 std::string compiler_executable_;
Brian Carlstrom6449c622014-02-10 23:48:36 -08001145 std::vector<std::string> compiler_options_;
1146 std::vector<std::string> image_compiler_options_;
Victor Hsieh61ffd042021-05-20 15:14:25 -07001147 std::vector<std::string> image_locations_;
Dragos Sbirlea7467ee02013-06-21 09:20:34 -07001148
Vladimir Markod1908512018-11-22 14:57:28 +00001149 std::vector<std::string> boot_class_path_;
1150 std::vector<std::string> boot_class_path_locations_;
Nicolas Geoffraybbdb1ed2021-06-29 14:12:05 +01001151 std::string boot_class_path_checksums_;
Victor Hsieha09d8b72021-05-24 14:21:55 -07001152 std::vector<int> boot_class_path_fds_;
Brian Carlstroma004aa92012-02-08 18:05:09 -08001153 std::string class_path_string_;
Elliott Hughes7ede61e2011-09-14 18:18:06 -07001154 std::vector<std::string> properties_;
1155
Andreas Gampeaadcbc62017-12-28 14:05:42 -08001156 std::list<ti::AgentSpec> agent_specs_;
1157 std::list<std::unique_ptr<ti::Agent>> agents_;
Alex Light185d1342016-08-11 10:48:03 -07001158 std::vector<Plugin> plugins_;
Alex Light7233c7e2016-07-28 10:07:45 -07001159
Brian Carlstromb765be02011-08-17 23:54:10 -07001160 // The default stack size for managed threads created by the runtime.
Elliott Hughesbe759c62011-09-08 19:38:21 -07001161 size_t default_stack_size_;
Brian Carlstromb765be02011-08-17 23:54:10 -07001162
Hans Boehmb2155572019-03-27 14:25:53 -07001163 // Finalizers running for longer than this many milliseconds abort the runtime.
1164 unsigned int finalizer_timeout_ms_;
1165
Ian Rogers1d54e732013-05-02 21:10:01 -07001166 gc::Heap* heap_;
Elliott Hughesb3bd5f02012-03-08 21:05:27 -08001167
Nicolas Geoffray25e04562016-03-01 13:17:58 +00001168 std::unique_ptr<ArenaPool> jit_arena_pool_;
Mathieu Chartier9b34b242015-03-09 11:30:17 -07001169 std::unique_ptr<ArenaPool> arena_pool_;
Mathieu Chartierc7853442015-03-27 14:35:38 -07001170 // Special low 4gb pool for compiler linear alloc. We need ArtFields to be in low 4gb if we are
1171 // compiling using a 32 bit image on a 64 bit compiler in case we resolve things in the image
1172 // since the field arrays are int arrays in this case.
1173 std::unique_ptr<ArenaPool> low_4gb_arena_pool_;
1174
1175 // Shared linear alloc for now.
1176 std::unique_ptr<LinearAlloc> linear_alloc_;
Mathieu Chartier9b34b242015-03-09 11:30:17 -07001177
Ian Rogersd9c4fc92013-10-01 19:45:43 -07001178 // The number of spins that are done before thread suspension is used to forcibly inflate.
1179 size_t max_spins_before_thin_lock_inflation_;
Elliott Hughesc33a32b2011-10-11 18:18:07 -07001180 MonitorList* monitor_list_;
Ian Rogersef7d42f2014-01-06 12:55:46 -08001181 MonitorPool* monitor_pool_;
Elliott Hughesc33a32b2011-10-11 18:18:07 -07001182
Carl Shapirob5573532011-07-12 18:22:59 -07001183 ThreadList* thread_list_;
Carl Shapiro61e019d2011-07-14 16:53:09 -07001184
Elliott Hughescf4c6c42011-09-01 15:16:42 -07001185 InternTable* intern_table_;
1186
Brian Carlstromb0460ea2011-07-29 10:08:05 -07001187 ClassLinker* class_linker_;
1188
Elliott Hughese27955c2011-08-26 15:21:24 -07001189 SignalCatcher* signal_catcher_;
Narayan Kamatheb710332017-05-10 11:48:46 +01001190
Alex Light79d6c802019-06-27 15:50:11 +00001191 std::unique_ptr<jni::JniIdManager> jni_id_manager_;
1192
Richard Uhlerda0a69e2016-10-11 15:06:38 +01001193 std::unique_ptr<JavaVMExt> java_vm_;
Elliott Hughesf2682d52011-08-15 16:37:04 -07001194
Mathieu Chartiere5f13e52015-02-24 09:37:21 -08001195 std::unique_ptr<jit::Jit> jit_;
Orion Hodsonad28f5e2018-10-17 09:08:17 +01001196 std::unique_ptr<jit::JitCodeCache> jit_code_cache_;
Mathieu Chartiere5f13e52015-02-24 09:37:21 -08001197 std::unique_ptr<jit::JitOptions> jit_options_;
1198
Mathieu Chartierada33d72018-12-17 13:17:30 -08001199 // Runtime thread pool. The pool is only for startup and gets deleted after.
1200 std::unique_ptr<ThreadPool> thread_pool_ GUARDED_BY(Locks::runtime_thread_pool_lock_);
1201 size_t thread_pool_ref_count_ GUARDED_BY(Locks::runtime_thread_pool_lock_);
1202
Andreas Gampe44f67602018-11-28 08:27:27 -08001203 // Fault message, printed when we get a SIGSEGV. Stored as a native-heap object and accessed
1204 // lock-free, so needs to be atomic.
1205 std::atomic<std::string*> fault_message_;
Mathieu Chartier15d34022014-02-26 17:16:38 -08001206
Ian Rogers120f1c72012-09-28 17:17:10 -07001207 // A non-zero value indicates that a thread has been created but not yet initialized. Guarded by
1208 // the shutdown lock so that threads aren't born while we're shutting down.
1209 size_t threads_being_born_ GUARDED_BY(Locks::runtime_shutdown_lock_);
1210
1211 // Waited upon until no threads are being born.
Ian Rogers700a4022014-05-19 16:49:03 -07001212 std::unique_ptr<ConditionVariable> shutdown_cond_ GUARDED_BY(Locks::runtime_shutdown_lock_);
Ian Rogers120f1c72012-09-28 17:17:10 -07001213
1214 // Set when runtime shutdown is past the point that new threads may attach.
1215 bool shutting_down_ GUARDED_BY(Locks::runtime_shutdown_lock_);
1216
1217 // The runtime is starting to shutdown but is blocked waiting on shutdown_cond_.
1218 bool shutting_down_started_ GUARDED_BY(Locks::runtime_shutdown_lock_);
1219
Elliott Hughesdcc24742011-09-07 14:02:44 -07001220 bool started_;
1221
Mathieu Chartier7664f5c2012-06-08 18:15:32 -07001222 // New flag added which tells us if the runtime has finished starting. If
1223 // this flag is set then the Daemon threads are created and the class loader
1224 // is created. This flag is needed for knowing if its safe to request CMS.
1225 bool finished_starting_;
1226
Brian Carlstrom6ea095a2011-08-16 15:26:54 -07001227 // Hooks supported by JNI_CreateJavaVM
1228 jint (*vfprintf_)(FILE* stream, const char* format, va_list ap);
1229 void (*exit_)(jint status);
1230 void (*abort_)();
1231
Elliott Hughes9d5ccec2011-09-19 13:19:50 -07001232 bool stats_enabled_;
1233 RuntimeStats stats_;
1234
Evgenii Stepanov1e133742015-05-20 12:30:59 -07001235 const bool is_running_on_memory_tool_;
Mathieu Chartierda44d772014-04-01 15:01:46 -07001236
Andreas Gampef6a780a2015-04-02 18:51:05 -07001237 std::unique_ptr<TraceConfig> trace_config_;
1238
Ian Rogers62d6c772013-02-27 08:32:07 -08001239 instrumentation::Instrumentation instrumentation_;
jeffhao2692b572011-12-16 15:42:28 -08001240
Ian Rogers365c1022012-06-22 15:05:28 -07001241 jobject main_thread_group_;
1242 jobject system_thread_group_;
1243
Brian Carlstromce888532013-10-10 00:32:58 -07001244 // As returned by ClassLoader.getSystemClassLoader().
1245 jobject system_class_loader_;
1246
Hiroshi Yamauchi2e899a92013-11-22 16:50:12 -08001247 // If true, then we dump the GC cumulative timings on shutdown.
1248 bool dump_gc_performance_on_shutdown_;
1249
Chang Xing605fe242017-07-20 15:57:21 -07001250 // Transactions used for pre-initializing classes at compilation time.
1251 // Support nested transactions, maintain a list containing all transactions. Transactions are
1252 // handled under a stack discipline. Because GC needs to go over all transactions, we choose list
1253 // as substantial data structure instead of stack.
Vladimir Markob6e67922021-07-06 15:53:07 +01001254 std::forward_list<Transaction> preinitialization_transactions_;
Sebastien Hertzd2fe10a2014-01-15 10:20:56 +01001255
Igor Murashkin7617abd2015-07-10 18:27:47 -07001256 // If kNone, verification is disabled. kEnable by default.
1257 verifier::VerifyMode verify_;
Jeff Hao4a200f52014-04-01 14:58:49 -07001258
Dmitriy Ivanov785049f2014-07-18 10:08:57 -07001259 // List of supported cpu abis.
1260 std::vector<std::string> cpu_abilist_;
1261
Jeff Haof00571c2014-05-29 17:29:47 -07001262 // Specifies target SDK version to allow workarounds for certain API levels.
David Brazdil2bb2fbd2018-11-13 18:24:26 +00001263 uint32_t target_sdk_version_;
Jeff Haof00571c2014-05-29 17:29:47 -07001264
Andrei Onea037d2822020-11-19 00:20:04 +00001265 // ART counterpart for the compat framework (go/compat-framework).
1266 CompatFramework compat_framework_;
atrostfab72082019-12-06 13:37:36 +00001267
Dave Allison69dfe512014-07-11 17:11:58 +00001268 // Implicit checks flags.
1269 bool implicit_null_checks_; // NullPointer checks are implicit.
1270 bool implicit_so_checks_; // StackOverflow checks are implicit.
1271 bool implicit_suspend_checks_; // Thread suspension checks are implicit.
1272
Calin Juravle01aaf6e2015-06-19 22:05:39 +01001273 // Whether or not the sig chain (and implicitly the fault handler) should be
Vladimir Markoa497a392018-09-26 10:52:50 +01001274 // disabled. Tools like dex2oat don't need them. This enables
Calin Juravle01aaf6e2015-06-19 22:05:39 +01001275 // building a statically link version of dex2oat.
1276 bool no_sig_chain_;
1277
Calin Juravled3e7c6c2016-02-04 19:07:51 +00001278 // Force the use of native bridge even if the app ISA matches the runtime ISA.
1279 bool force_native_bridge_;
1280
Calin Juravle07d83c72014-10-22 21:02:23 +01001281 // Whether or not a native bridge has been loaded.
Calin Juravlec8423522014-08-12 20:55:20 +01001282 //
1283 // The native bridge allows running native code compiled for a foreign ISA. The way it works is,
1284 // if standard dlopen fails to load native library associated with native activity, it calls to
1285 // the native bridge to load it and then gets the trampoline for the entry to native activity.
Calin Juravle07d83c72014-10-22 21:02:23 +01001286 //
1287 // The option 'native_bridge_library_filename' specifies the name of the native bridge.
1288 // When non-empty the native bridge will be loaded from the given file. An empty value means
1289 // that there's no native bridge.
1290 bool is_native_bridge_loaded_;
Calin Juravlec8423522014-08-12 20:55:20 +01001291
David Srbeckyf4480162016-03-16 00:06:24 +00001292 // Whether we are running under native debugger.
1293 bool is_native_debuggable_;
1294
Alex Light7919db92017-11-29 09:00:55 -08001295 // whether or not any async exceptions have ever been thrown. This is used to speed up the
1296 // MterpShouldSwitchInterpreters function.
1297 bool async_exceptions_thrown_;
1298
Alex Light0aa7a5a2018-10-10 15:58:14 +00001299 // Whether anything is going to be using the shadow-frame APIs to force a function to return
1300 // early. Doing this requires that (1) we be debuggable and (2) that mterp is exited.
1301 bool non_standard_exits_enabled_;
1302
Nicolas Geoffray433b79a2017-01-30 20:54:45 +00001303 // Whether Java code needs to be debuggable.
1304 bool is_java_debuggable_;
Alex Light6b16d892016-11-11 11:21:04 -08001305
wangguibo0d290722021-04-24 11:27:06 +08001306 bool monitor_timeout_enable_;
1307 uint64_t monitor_timeout_ns_;
1308
Florian Mayer0bc9bef2021-04-28 15:52:33 +01001309 // Whether or not this application can be profiled by the shell user,
1310 // even when running on a device that is running in user mode.
Florian Mayer07710c52019-09-16 15:53:38 +00001311 bool is_profileable_from_shell_ = false;
1312
Florian Mayer0bc9bef2021-04-28 15:52:33 +01001313 // Whether or not this application can be profiled by system services on a
1314 // device running in user mode, but not necessarily by the shell user.
1315 bool is_profileable_ = false;
1316
Narayan Kamath5a2be3f2015-02-16 13:51:51 +00001317 // The maximum number of failed boots we allow before pruning the dalvik cache
1318 // and trying again. This option is only inspected when we're running as a
1319 // zygote.
1320 uint32_t zygote_max_failed_boots_;
1321
Igor Murashkin158f35c2015-06-10 15:55:30 -07001322 // Enable experimental opcodes that aren't fully specified yet. The intent is to
1323 // eventually publish them as public-usable opcodes, but they aren't ready yet.
1324 //
1325 // Experimental opcodes should not be used by other production code.
Alex Lighteb7c1442015-08-31 13:17:42 -07001326 ExperimentalFlags experimental_flags_;
Igor Murashkin158f35c2015-06-10 15:55:30 -07001327
Andreas Gampedd671252015-07-23 14:37:18 -07001328 // Contains the build fingerprint, if given as a parameter.
1329 std::string fingerprint_;
1330
Mathieu Chartierf9c6fc62015-10-07 11:44:05 -07001331 // Oat file manager, keeps track of what oat files are open.
Mathieu Chartiere58991b2015-10-13 07:59:34 -07001332 OatFileManager* oat_file_manager_;
Mathieu Chartierf9c6fc62015-10-07 11:44:05 -07001333
Mathieu Chartier32cc9ee2015-10-15 09:19:15 -07001334 // Whether or not we are on a low RAM device.
1335 bool is_low_memory_mode_;
1336
Mathieu Chartierc42cb0e2017-10-13 11:35:00 -07001337 // Whether or not we use MADV_RANDOM on files that are thought to have random access patterns.
1338 // This is beneficial for low RAM devices since it reduces page cache thrashing.
1339 bool madvise_random_access_;
1340
Jagadeesh Pakaravoor06541532021-02-22 21:19:09 -08001341 // Limiting size (in bytes) for applying MADV_WILLNEED on vdex files
1342 // A 0 for this will turn off madvising to MADV_WILLNEED
1343 size_t madvise_willneed_vdex_filesize_;
1344
1345 // Limiting size (in bytes) for applying MADV_WILLNEED on odex files
1346 // A 0 for this will turn off madvising to MADV_WILLNEED
1347 size_t madvise_willneed_odex_filesize_;
1348
1349 // Limiting size (in bytes) for applying MADV_WILLNEED on art files
1350 // A 0 for this will turn off madvising to MADV_WILLNEED
1351 size_t madvise_willneed_art_filesize_;
1352
Nicolas Geoffray787ae8e2015-11-05 11:32:24 +00001353 // Whether the application should run in safe mode, that is, interpreter only.
1354 bool safe_mode_;
1355
David Brazdil3e0fa0a2018-01-15 18:41:44 +00001356 // Whether access checks on hidden API should be performed.
Mathew Inwooda5dc52c2018-02-19 15:30:51 +00001357 hiddenapi::EnforcementPolicy hidden_api_policy_;
David Brazdil3e0fa0a2018-01-15 18:41:44 +00001358
David Brazdile7681822018-12-14 16:25:33 +00001359 // Whether access checks on core platform API should be performed.
1360 hiddenapi::EnforcementPolicy core_platform_api_policy_;
1361
satayev09efc162021-02-22 17:24:57 +00001362 // Whether access checks on test API should be performed.
1363 hiddenapi::EnforcementPolicy test_api_policy_;
1364
Mathew Inwoodc8ce5f52018-04-05 13:58:55 +01001365 // List of signature prefixes of methods that have been removed from the blacklist, and treated
1366 // as if whitelisted.
Mathew Inwood3383aa52018-03-16 14:18:33 +00001367 std::vector<std::string> hidden_api_exemptions_;
1368
David Brazdilee7d2fd2018-01-20 17:25:23 +00001369 // Do not warn about the same hidden API access violation twice.
1370 // This is only used for testing.
1371 bool dedupe_hidden_api_warnings_;
1372
Mathew Inwood5bcef172018-05-01 14:40:12 +01001373 // How often to log hidden API access to the event log. An integer between 0
1374 // (never) and 0x10000 (always).
Mathew Inwood73ddda42018-04-03 15:32:32 +01001375 uint32_t hidden_api_access_event_log_rate_;
1376
Mathew Inwood5bcef172018-05-01 14:40:12 +01001377 // The package of the app running in this process.
1378 std::string process_package_name_;
1379
David Brazdil35a3f6a2019-03-04 15:59:06 +00001380 // The data directory of the app running in this process.
1381 std::string process_data_directory_;
1382
Nicolas Geoffraya73280d2016-02-15 13:05:16 +00001383 // Whether threads should dump their native stack on SIGQUIT.
1384 bool dump_native_stack_on_sig_quit_;
1385
Mathieu Chartierf8cb1782016-03-18 18:45:41 -07001386 // Whether or not we currently care about pause times.
1387 ProcessState process_state_;
1388
Andreas Gampef38a6612016-04-11 08:42:26 -07001389 // Whether zygote code is in a section that should not start threads.
1390 bool zygote_no_threads_;
1391
Alex Light40320712017-12-14 11:52:04 -08001392 // The string containing requested jdwp options
1393 std::string jdwp_options_;
1394
1395 // The jdwp provider we were configured with.
1396 JdwpProvider jdwp_provider_;
1397
Alex Light79d6c802019-06-27 15:50:11 +00001398 // True if jmethodID and jfieldID are opaque Indices. When false (the default) these are simply
1399 // pointers. This is set by -Xopaque-jni-ids:{true,false}.
1400 JniIdType jni_ids_indirection_;
1401
Alex Light4ca2f482019-11-25 16:07:22 -08001402 // Set to false in cases where we want to directly control when jni-id
1403 // indirection is changed. This is intended only for testing JNI id swapping.
1404 bool automatically_set_jni_ids_indirection_;
1405
Orion Hodson971068d2021-06-30 21:17:53 +01001406 // True if files in /data/misc/apexdata/com.android.art are considered untrustworthy.
1407 bool deny_art_apex_data_files_;
1408
David Sehrd106d9f2016-08-16 19:22:57 -07001409 // Saved environment.
1410 class EnvSnapshot {
1411 public:
1412 EnvSnapshot() = default;
1413 void TakeSnapshot();
1414 char** GetSnapshot() const;
1415
1416 private:
1417 std::unique_ptr<char*[]> c_env_vector_;
1418 std::vector<std::unique_ptr<std::string>> name_value_pairs_;
1419
1420 DISALLOW_COPY_AND_ASSIGN(EnvSnapshot);
1421 } env_snapshot_;
1422
Andreas Gampefda57142016-09-08 20:29:18 -07001423 // Generic system-weak holders.
1424 std::vector<gc::AbstractSystemWeakHolder*> system_weak_holders_;
1425
Andreas Gampeac30fa22017-01-18 21:02:36 -08001426 std::unique_ptr<RuntimeCallbacks> callbacks_;
Andreas Gampe04bbb5b2017-01-19 17:49:03 +00001427
Nicolas Geoffray81cc43e2017-05-10 12:04:49 +01001428 std::atomic<uint32_t> deoptimization_counts_[
1429 static_cast<uint32_t>(DeoptimizationKind::kLast) + 1];
Nicolas Geoffray4e92c3c2017-05-08 09:34:26 +01001430
Vladimir Markoc34bebf2018-08-16 16:12:49 +01001431 MemMap protected_fault_page_;
Andreas Gampe2ac67d52017-05-11 22:30:38 -07001432
Andreas Gampe0b0ffc12018-08-01 14:41:27 -07001433 uint32_t verifier_logging_threshold_ms_;
1434
Mathieu Chartiera88abfa2019-02-04 11:08:29 -08001435 bool load_app_image_startup_cache_ = false;
1436
Mathieu Chartier175ce3d2019-03-06 16:54:24 -08001437 // If startup has completed, must happen at most once.
1438 std::atomic<bool> startup_completed_ = false;
1439
Andreas Gamped84794d2019-07-18 13:40:03 -07001440 bool verifier_missing_kthrow_fatal_;
Hans Boehm1792c6f2021-06-24 17:35:50 -07001441 bool force_java_zygote_fork_loop_;
Florian Mayer0972d082020-05-15 14:07:31 +02001442 bool perfetto_hprof_enabled_;
Wessam Hassaneinb5a10be2020-11-11 16:42:52 -08001443 bool perfetto_javaheapprof_enabled_;
Andreas Gamped84794d2019-07-18 13:40:03 -07001444
Eric Holka79872b2020-10-01 13:09:53 -07001445 metrics::ArtMetrics metrics_;
Eric Holk59d4b532020-10-21 17:49:39 -07001446 std::unique_ptr<metrics::MetricsReporter> metrics_reporter_;
Eric Holka79872b2020-10-01 13:09:53 -07001447
Nicolas Geoffrayd3c45c22021-04-27 13:21:28 +01001448 // Apex versions of boot classpath jars concatenated in a string. The format
1449 // is of the type:
1450 // '/apex1_version/apex2_version//'
1451 //
1452 // When the apex is the factory version, we don't encode it (for example in
1453 // the third entry in the example above).
1454 std::string apex_versions_;
1455
Calin Juravlec2753e62021-06-25 15:34:09 -07001456 // The info about the application code paths.
1457 AppInfo app_info_;
1458
Andreas Gampe44f67602018-11-28 08:27:27 -08001459 // Note: See comments on GetFaultMessage.
1460 friend std::string GetFaultMessageForAbortLogging();
Vladimir Markoc0e0e5e2020-01-23 17:43:05 +00001461 friend class Dex2oatImageTest;
Mathieu Chartierada33d72018-12-17 13:17:30 -08001462 friend class ScopedThreadPoolUsage;
Vladimir Markof3d88a82018-12-21 16:38:47 +00001463 friend class OatFileAssistantTest;
Mathieu Chartierad390fa2019-10-16 20:03:00 -07001464 class NotifyStartupCompletedTask;
Andreas Gampe44f67602018-11-28 08:27:27 -08001465
Carl Shapiro61e019d2011-07-14 16:53:09 -07001466 DISALLOW_COPY_AND_ASSIGN(Runtime);
Carl Shapiro1fb86202011-06-27 17:43:13 -07001467};
1468
Eric Holka79872b2020-10-01 13:09:53 -07001469inline metrics::ArtMetrics* GetMetrics() { return Runtime::Current()->GetMetrics(); }
1470
Carl Shapiro1fb86202011-06-27 17:43:13 -07001471} // namespace art
1472
Brian Carlstromfc0e3212013-07-17 14:40:12 -07001473#endif // ART_RUNTIME_RUNTIME_H_