Elliott Hughes | 2faa5f1 | 2012-01-30 14:42:07 -0800 | [diff] [blame] | 1 | /* |
| 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 Shapiro | a5d5cfd | 2011-06-21 12:46:59 -0700 | [diff] [blame] | 16 | |
Brian Carlstrom | fc0e321 | 2013-07-17 14:40:12 -0700 | [diff] [blame] | 17 | #ifndef ART_RUNTIME_UTILS_H_ |
| 18 | #define ART_RUNTIME_UTILS_H_ |
Carl Shapiro | a5d5cfd | 2011-06-21 12:46:59 -0700 | [diff] [blame] | 19 | |
Elliott Hughes | 92b3b56 | 2011-09-08 16:32:26 -0700 | [diff] [blame] | 20 | #include <pthread.h> |
Elliott Hughes | e222ee0 | 2012-12-13 14:41:43 -0800 | [diff] [blame] | 21 | |
Elliott Hughes | 3402380 | 2011-08-30 12:06:17 -0700 | [diff] [blame] | 22 | #include <string> |
| 23 | #include <vector> |
| 24 | |
Elliott Hughes | e222ee0 | 2012-12-13 14:41:43 -0800 | [diff] [blame] | 25 | #include "base/logging.h" |
Elliott Hughes | e222ee0 | 2012-12-13 14:41:43 -0800 | [diff] [blame] | 26 | #include "base/stringprintf.h" |
| 27 | #include "globals.h" |
| 28 | #include "primitive.h" |
| 29 | |
Carl Shapiro | 6b6b5f0 | 2011-06-21 15:05:09 -0700 | [diff] [blame] | 30 | namespace art { |
Carl Shapiro | a5d5cfd | 2011-06-21 12:46:59 -0700 | [diff] [blame] | 31 | |
Ian Rogers | 0571d35 | 2011-11-03 19:51:38 -0700 | [diff] [blame] | 32 | class DexFile; |
Ian Rogers | 2dd0e2c | 2013-01-24 12:42:14 -0800 | [diff] [blame] | 33 | |
| 34 | namespace mirror { |
Brian Carlstrom | ea46f95 | 2013-07-30 01:26:50 -0700 | [diff] [blame] | 35 | class ArtField; |
| 36 | class ArtMethod; |
Ian Rogers | 2dd0e2c | 2013-01-24 12:42:14 -0800 | [diff] [blame] | 37 | class Class; |
Elliott Hughes | 11e4507 | 2011-08-16 17:40:46 -0700 | [diff] [blame] | 38 | class Object; |
Elliott Hughes | 5174fe6 | 2011-08-23 15:12:35 -0700 | [diff] [blame] | 39 | class String; |
Ian Rogers | 2dd0e2c | 2013-01-24 12:42:14 -0800 | [diff] [blame] | 40 | } // namespace mirror |
Elliott Hughes | 11e4507 | 2011-08-16 17:40:46 -0700 | [diff] [blame] | 41 | |
Mathieu Chartier | 0325e62 | 2012-09-05 14:22:51 -0700 | [diff] [blame] | 42 | enum TimeUnit { |
| 43 | kTimeUnitNanosecond, |
| 44 | kTimeUnitMicrosecond, |
| 45 | kTimeUnitMillisecond, |
| 46 | kTimeUnitSecond, |
| 47 | }; |
| 48 | |
Carl Shapiro | a2e18e1 | 2011-06-21 18:57:55 -0700 | [diff] [blame] | 49 | template<typename T> |
| 50 | static inline bool IsPowerOfTwo(T x) { |
| 51 | return (x & (x - 1)) == 0; |
| 52 | } |
| 53 | |
Elliott Hughes | 06b37d9 | 2011-10-16 11:51:29 -0700 | [diff] [blame] | 54 | template<int n, typename T> |
| 55 | static inline bool IsAligned(T x) { |
| 56 | COMPILE_ASSERT((n & (n - 1)) == 0, n_not_power_of_two); |
Carl Shapiro | a2e18e1 | 2011-06-21 18:57:55 -0700 | [diff] [blame] | 57 | return (x & (n - 1)) == 0; |
| 58 | } |
| 59 | |
Elliott Hughes | 06b37d9 | 2011-10-16 11:51:29 -0700 | [diff] [blame] | 60 | template<int n, typename T> |
| 61 | static inline bool IsAligned(T* x) { |
Brian Carlstrom | 8952189 | 2011-12-07 22:05:07 -0800 | [diff] [blame] | 62 | return IsAligned<n>(reinterpret_cast<const uintptr_t>(x)); |
Carl Shapiro | a2e18e1 | 2011-06-21 18:57:55 -0700 | [diff] [blame] | 63 | } |
| 64 | |
Elliott Hughes | 06b37d9 | 2011-10-16 11:51:29 -0700 | [diff] [blame] | 65 | #define CHECK_ALIGNED(value, alignment) \ |
Brian Carlstrom | 8952189 | 2011-12-07 22:05:07 -0800 | [diff] [blame] | 66 | CHECK(::art::IsAligned<alignment>(value)) << reinterpret_cast<const void*>(value) |
Elliott Hughes | 06b37d9 | 2011-10-16 11:51:29 -0700 | [diff] [blame] | 67 | |
| 68 | #define DCHECK_ALIGNED(value, alignment) \ |
Brian Carlstrom | 8952189 | 2011-12-07 22:05:07 -0800 | [diff] [blame] | 69 | DCHECK(::art::IsAligned<alignment>(value)) << reinterpret_cast<const void*>(value) |
Elliott Hughes | 06b37d9 | 2011-10-16 11:51:29 -0700 | [diff] [blame] | 70 | |
Carl Shapiro | a5d5cfd | 2011-06-21 12:46:59 -0700 | [diff] [blame] | 71 | // Check whether an N-bit two's-complement representation can hold value. |
| 72 | static inline bool IsInt(int N, word value) { |
| 73 | CHECK_LT(0, N); |
| 74 | CHECK_LT(N, kBitsPerWord); |
| 75 | word limit = static_cast<word>(1) << (N - 1); |
| 76 | return (-limit <= value) && (value < limit); |
| 77 | } |
| 78 | |
Carl Shapiro | a5d5cfd | 2011-06-21 12:46:59 -0700 | [diff] [blame] | 79 | static inline bool IsUint(int N, word value) { |
| 80 | CHECK_LT(0, N); |
| 81 | CHECK_LT(N, kBitsPerWord); |
| 82 | word limit = static_cast<word>(1) << N; |
| 83 | return (0 <= value) && (value < limit); |
| 84 | } |
| 85 | |
Carl Shapiro | a2e18e1 | 2011-06-21 18:57:55 -0700 | [diff] [blame] | 86 | static inline bool IsAbsoluteUint(int N, word value) { |
| 87 | CHECK_LT(0, N); |
| 88 | CHECK_LT(N, kBitsPerWord); |
| 89 | if (value < 0) value = -value; |
| 90 | return IsUint(N, value); |
| 91 | } |
| 92 | |
buzbee | 4ef3e45 | 2012-12-14 13:35:28 -0800 | [diff] [blame] | 93 | static inline uint16_t Low16Bits(uint32_t value) { |
| 94 | return static_cast<uint16_t>(value); |
Ian Rogers | b033c75 | 2011-07-20 12:22:35 -0700 | [diff] [blame] | 95 | } |
| 96 | |
buzbee | 4ef3e45 | 2012-12-14 13:35:28 -0800 | [diff] [blame] | 97 | static inline uint16_t High16Bits(uint32_t value) { |
| 98 | return static_cast<uint16_t>(value >> 16); |
Ian Rogers | b033c75 | 2011-07-20 12:22:35 -0700 | [diff] [blame] | 99 | } |
Carl Shapiro | a2e18e1 | 2011-06-21 18:57:55 -0700 | [diff] [blame] | 100 | |
buzbee | 4ef3e45 | 2012-12-14 13:35:28 -0800 | [diff] [blame] | 101 | static inline uint32_t Low32Bits(uint64_t value) { |
| 102 | return static_cast<uint32_t>(value); |
Carl Shapiro | a5d5cfd | 2011-06-21 12:46:59 -0700 | [diff] [blame] | 103 | } |
| 104 | |
buzbee | 4ef3e45 | 2012-12-14 13:35:28 -0800 | [diff] [blame] | 105 | static inline uint32_t High32Bits(uint64_t value) { |
| 106 | return static_cast<uint32_t>(value >> 32); |
Carl Shapiro | a5d5cfd | 2011-06-21 12:46:59 -0700 | [diff] [blame] | 107 | } |
| 108 | |
Mathieu Chartier | 0a9dc05 | 2013-07-25 11:01:28 -0700 | [diff] [blame] | 109 | // A static if which determines whether to return type A or B based on the condition boolean. |
| 110 | template <const bool condition, typename A, typename B> |
| 111 | struct TypeStaticIf { |
| 112 | typedef A value; |
| 113 | }; |
| 114 | |
| 115 | // Specialization to handle the false case. |
| 116 | template <typename A, typename B> |
| 117 | struct TypeStaticIf<false, A, B> { |
| 118 | typedef B value; |
| 119 | }; |
| 120 | |
Hiroshi Yamauchi | 0941b04 | 2013-11-05 11:34:03 -0800 | [diff] [blame] | 121 | // For rounding integers. |
Carl Shapiro | 61e019d | 2011-07-14 16:53:09 -0700 | [diff] [blame] | 122 | template<typename T> |
| 123 | static inline T RoundDown(T x, int n) { |
Mathieu Chartier | 590fee9 | 2013-09-13 13:46:47 -0700 | [diff] [blame] | 124 | DCHECK(IsPowerOfTwo(n)); |
Carl Shapiro | 61e019d | 2011-07-14 16:53:09 -0700 | [diff] [blame] | 125 | return (x & -n); |
| 126 | } |
| 127 | |
| 128 | template<typename T> |
| 129 | static inline T RoundUp(T x, int n) { |
| 130 | return RoundDown(x + n - 1, n); |
| 131 | } |
| 132 | |
Hiroshi Yamauchi | 0941b04 | 2013-11-05 11:34:03 -0800 | [diff] [blame] | 133 | // For aligning pointers. |
| 134 | template<typename T> |
| 135 | static inline T* AlignDown(T* x, int n) { |
| 136 | CHECK(IsPowerOfTwo(n)); |
| 137 | return reinterpret_cast<T*>(reinterpret_cast<uintptr_t>(x) & -static_cast<uintptr_t>(n)); |
| 138 | } |
| 139 | |
| 140 | template<typename T> |
| 141 | static inline T* AlignUp(T* x, int n) { |
| 142 | return AlignDown(reinterpret_cast<T*>(reinterpret_cast<uintptr_t>(x) + static_cast<uintptr_t>(n - 1)), n); |
| 143 | } |
| 144 | |
Carl Shapiro | a2e18e1 | 2011-06-21 18:57:55 -0700 | [diff] [blame] | 145 | // Implementation is from "Hacker's Delight" by Henry S. Warren, Jr., |
Carl Shapiro | 1fb8620 | 2011-06-27 17:43:13 -0700 | [diff] [blame] | 146 | // figure 3-3, page 48, where the function is called clp2. |
| 147 | static inline uint32_t RoundUpToPowerOfTwo(uint32_t x) { |
| 148 | x = x - 1; |
| 149 | x = x | (x >> 1); |
| 150 | x = x | (x >> 2); |
| 151 | x = x | (x >> 4); |
| 152 | x = x | (x >> 8); |
| 153 | x = x | (x >> 16); |
| 154 | return x + 1; |
| 155 | } |
| 156 | |
| 157 | // Implementation is from "Hacker's Delight" by Henry S. Warren, Jr., |
Carl Shapiro | a2e18e1 | 2011-06-21 18:57:55 -0700 | [diff] [blame] | 158 | // figure 5-2, page 66, where the function is called pop. |
| 159 | static inline int CountOneBits(uint32_t x) { |
| 160 | x = x - ((x >> 1) & 0x55555555); |
| 161 | x = (x & 0x33333333) + ((x >> 2) & 0x33333333); |
| 162 | x = (x + (x >> 4)) & 0x0F0F0F0F; |
| 163 | x = x + (x >> 8); |
| 164 | x = x + (x >> 16); |
| 165 | return static_cast<int>(x & 0x0000003F); |
| 166 | } |
| 167 | |
Ian Rogers | ef7d42f | 2014-01-06 12:55:46 -0800 | [diff] [blame] | 168 | template<typename T> |
| 169 | static inline int CLZ(T x) { |
| 170 | if (sizeof(T) == sizeof(uint32_t)) { |
| 171 | return __builtin_clz(x); |
| 172 | } else { |
| 173 | return __builtin_clzll(x); |
| 174 | } |
| 175 | } |
| 176 | |
| 177 | template<typename T> |
| 178 | static inline int CTZ(T x) { |
| 179 | if (sizeof(T) == sizeof(uint32_t)) { |
| 180 | return __builtin_ctz(x); |
| 181 | } else { |
| 182 | return __builtin_ctzll(x); |
| 183 | } |
| 184 | } |
| 185 | |
| 186 | static inline uint32_t PointerToLowMemUInt32(const void* p) { |
| 187 | uintptr_t intp = reinterpret_cast<uintptr_t>(p); |
| 188 | DCHECK_LE(intp, 0xFFFFFFFFU); |
| 189 | return intp & 0xFFFFFFFFU; |
| 190 | } |
Brian Carlstrom | db4d540 | 2011-08-09 12:18:28 -0700 | [diff] [blame] | 191 | |
Elliott Hughes | 46b92ba | 2011-08-12 17:57:34 -0700 | [diff] [blame] | 192 | static inline bool NeedsEscaping(uint16_t ch) { |
| 193 | return (ch < ' ' || ch > '~'); |
| 194 | } |
| 195 | |
Elliott Hughes | c7ac37f | 2011-08-12 12:21:58 -0700 | [diff] [blame] | 196 | static inline std::string PrintableChar(uint16_t ch) { |
| 197 | std::string result; |
Elliott Hughes | 46b92ba | 2011-08-12 17:57:34 -0700 | [diff] [blame] | 198 | result += '\''; |
| 199 | if (NeedsEscaping(ch)) { |
| 200 | StringAppendF(&result, "\\u%04x", ch); |
| 201 | } else { |
Elliott Hughes | c7ac37f | 2011-08-12 12:21:58 -0700 | [diff] [blame] | 202 | result += ch; |
Elliott Hughes | c7ac37f | 2011-08-12 12:21:58 -0700 | [diff] [blame] | 203 | } |
Elliott Hughes | 46b92ba | 2011-08-12 17:57:34 -0700 | [diff] [blame] | 204 | result += '\''; |
Elliott Hughes | c7ac37f | 2011-08-12 12:21:58 -0700 | [diff] [blame] | 205 | return result; |
| 206 | } |
| 207 | |
Elliott Hughes | 82914b6 | 2012-04-09 15:56:29 -0700 | [diff] [blame] | 208 | // Returns an ASCII string corresponding to the given UTF-8 string. |
| 209 | // Java escapes are used for non-ASCII characters. |
| 210 | std::string PrintableString(const std::string& utf8); |
Elliott Hughes | c7ac37f | 2011-08-12 12:21:58 -0700 | [diff] [blame] | 211 | |
Elliott Hughes | f1a5adc | 2012-02-10 18:09:35 -0800 | [diff] [blame] | 212 | // Tests whether 's' starts with 'prefix'. |
| 213 | bool StartsWith(const std::string& s, const char* prefix); |
| 214 | |
Brian Carlstrom | 7a967b3 | 2012-03-28 15:23:10 -0700 | [diff] [blame] | 215 | // Tests whether 's' starts with 'suffix'. |
| 216 | bool EndsWith(const std::string& s, const char* suffix); |
| 217 | |
Elliott Hughes | 54e7df1 | 2011-09-16 11:47:04 -0700 | [diff] [blame] | 218 | // Used to implement PrettyClass, PrettyField, PrettyMethod, and PrettyTypeOf, |
| 219 | // one of which is probably more useful to you. |
Elliott Hughes | a0b8feb | 2011-08-20 09:50:55 -0700 | [diff] [blame] | 220 | // Returns a human-readable equivalent of 'descriptor'. So "I" would be "int", |
| 221 | // "[[I" would be "int[][]", "[Ljava/lang/String;" would be |
| 222 | // "java.lang.String[]", and so forth. |
Ian Rogers | ef7d42f | 2014-01-06 12:55:46 -0800 | [diff] [blame] | 223 | std::string PrettyDescriptor(mirror::String* descriptor) |
| 224 | SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); |
Elliott Hughes | 6c8867d | 2011-10-03 16:34:05 -0700 | [diff] [blame] | 225 | std::string PrettyDescriptor(const std::string& descriptor); |
Brian Carlstrom | 6b4ef02 | 2011-10-23 14:59:04 -0700 | [diff] [blame] | 226 | std::string PrettyDescriptor(Primitive::Type type); |
Ian Rogers | ef7d42f | 2014-01-06 12:55:46 -0800 | [diff] [blame] | 227 | std::string PrettyDescriptor(mirror::Class* klass) |
Ian Rogers | b726dcb | 2012-09-05 08:57:23 -0700 | [diff] [blame] | 228 | SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); |
Elliott Hughes | 11e4507 | 2011-08-16 17:40:46 -0700 | [diff] [blame] | 229 | |
Elliott Hughes | 54e7df1 | 2011-09-16 11:47:04 -0700 | [diff] [blame] | 230 | // Returns a human-readable signature for 'f'. Something like "a.b.C.f" or |
| 231 | // "int a.b.C.f" (depending on the value of 'with_type'). |
Ian Rogers | ef7d42f | 2014-01-06 12:55:46 -0800 | [diff] [blame] | 232 | std::string PrettyField(mirror::ArtField* f, bool with_type = true) |
Ian Rogers | b726dcb | 2012-09-05 08:57:23 -0700 | [diff] [blame] | 233 | SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); |
Brian Carlstrom | 6f29d0e | 2012-05-11 15:50:29 -0700 | [diff] [blame] | 234 | std::string PrettyField(uint32_t field_idx, const DexFile& dex_file, bool with_type = true); |
Elliott Hughes | a250199 | 2011-08-26 19:39:54 -0700 | [diff] [blame] | 235 | |
Elliott Hughes | a0b8feb | 2011-08-20 09:50:55 -0700 | [diff] [blame] | 236 | // Returns a human-readable signature for 'm'. Something like "a.b.C.m" or |
| 237 | // "a.b.C.m(II)V" (depending on the value of 'with_signature'). |
Ian Rogers | ef7d42f | 2014-01-06 12:55:46 -0800 | [diff] [blame] | 238 | std::string PrettyMethod(mirror::ArtMethod* m, bool with_signature = true) |
Ian Rogers | b726dcb | 2012-09-05 08:57:23 -0700 | [diff] [blame] | 239 | SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); |
Ian Rogers | 0571d35 | 2011-11-03 19:51:38 -0700 | [diff] [blame] | 240 | std::string PrettyMethod(uint32_t method_idx, const DexFile& dex_file, bool with_signature = true); |
Elliott Hughes | a0b8feb | 2011-08-20 09:50:55 -0700 | [diff] [blame] | 241 | |
| 242 | // Returns a human-readable form of the name of the *class* of the given object. |
| 243 | // So given an instance of java.lang.String, the output would |
Elliott Hughes | 11e4507 | 2011-08-16 17:40:46 -0700 | [diff] [blame] | 244 | // be "java.lang.String". Given an array of int, the output would be "int[]". |
| 245 | // Given String.class, the output would be "java.lang.Class<java.lang.String>". |
Ian Rogers | ef7d42f | 2014-01-06 12:55:46 -0800 | [diff] [blame] | 246 | std::string PrettyTypeOf(mirror::Object* obj) |
Ian Rogers | b726dcb | 2012-09-05 08:57:23 -0700 | [diff] [blame] | 247 | SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); |
Mathieu Chartier | 4c70d77 | 2012-09-10 14:08:32 -0700 | [diff] [blame] | 248 | |
| 249 | // Returns a human-readable form of the type at an index in the specified dex file. |
| 250 | // Example outputs: char[], java.lang.String. |
Mathieu Chartier | 18c24b6 | 2012-09-10 08:54:25 -0700 | [diff] [blame] | 251 | std::string PrettyType(uint32_t type_idx, const DexFile& dex_file); |
Elliott Hughes | 54e7df1 | 2011-09-16 11:47:04 -0700 | [diff] [blame] | 252 | |
| 253 | // Returns a human-readable form of the name of the given class. |
| 254 | // Given String.class, the output would be "java.lang.Class<java.lang.String>". |
Ian Rogers | ef7d42f | 2014-01-06 12:55:46 -0800 | [diff] [blame] | 255 | std::string PrettyClass(mirror::Class* c) |
Ian Rogers | b726dcb | 2012-09-05 08:57:23 -0700 | [diff] [blame] | 256 | SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); |
Elliott Hughes | 11e4507 | 2011-08-16 17:40:46 -0700 | [diff] [blame] | 257 | |
Ian Rogers | d81871c | 2011-10-03 13:57:23 -0700 | [diff] [blame] | 258 | // Returns a human-readable form of the name of the given class with its class loader. |
Ian Rogers | ef7d42f | 2014-01-06 12:55:46 -0800 | [diff] [blame] | 259 | std::string PrettyClassAndClassLoader(mirror::Class* c) |
Ian Rogers | b726dcb | 2012-09-05 08:57:23 -0700 | [diff] [blame] | 260 | SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); |
Ian Rogers | d81871c | 2011-10-03 13:57:23 -0700 | [diff] [blame] | 261 | |
Elliott Hughes | c967f78 | 2012-04-16 10:23:15 -0700 | [diff] [blame] | 262 | // Returns a human-readable size string such as "1MB". |
Mathieu Chartier | e6da9af | 2013-12-16 11:54:42 -0800 | [diff] [blame] | 263 | std::string PrettySize(int64_t size_in_bytes); |
Ian Rogers | 3bb17a6 | 2012-01-27 23:56:44 -0800 | [diff] [blame] | 264 | |
| 265 | // Returns a human-readable time string which prints every nanosecond while trying to limit the |
| 266 | // number of trailing zeros. Prints using the largest human readable unit up to a second. |
| 267 | // e.g. "1ms", "1.000000001s", "1.001us" |
| 268 | std::string PrettyDuration(uint64_t nano_duration); |
| 269 | |
Mathieu Chartier | 0325e62 | 2012-09-05 14:22:51 -0700 | [diff] [blame] | 270 | // Format a nanosecond time to specified units. |
| 271 | std::string FormatDuration(uint64_t nano_duration, TimeUnit time_unit); |
| 272 | |
| 273 | // Get the appropriate unit for a nanosecond duration. |
| 274 | TimeUnit GetAppropriateTimeUnit(uint64_t nano_duration); |
| 275 | |
Dave Allison | 7020278 | 2013-10-22 17:52:19 -0700 | [diff] [blame] | 276 | // Get the divisor to convert from a nanoseconds to a time unit. |
Mathieu Chartier | 0325e62 | 2012-09-05 14:22:51 -0700 | [diff] [blame] | 277 | uint64_t GetNsToTimeUnitDivisor(TimeUnit time_unit); |
| 278 | |
Elliott Hughes | 79082e3 | 2011-08-25 12:07:32 -0700 | [diff] [blame] | 279 | // Performs JNI name mangling as described in section 11.3 "Linking Native Methods" |
| 280 | // of the JNI spec. |
| 281 | std::string MangleForJni(const std::string& s); |
| 282 | |
Brian Carlstrom | f91c8c3 | 2011-09-21 17:30:34 -0700 | [diff] [blame] | 283 | // Turn "java.lang.String" into "Ljava/lang/String;". |
| 284 | std::string DotToDescriptor(const char* class_name); |
| 285 | |
Brian Carlstrom | aded5f7 | 2011-10-07 17:15:04 -0700 | [diff] [blame] | 286 | // Turn "Ljava/lang/String;" into "java.lang.String". |
Elliott Hughes | f1a5adc | 2012-02-10 18:09:35 -0800 | [diff] [blame] | 287 | std::string DescriptorToDot(const char* descriptor); |
Brian Carlstrom | aded5f7 | 2011-10-07 17:15:04 -0700 | [diff] [blame] | 288 | |
Elliott Hughes | 91bf6cd | 2012-02-14 17:27:48 -0800 | [diff] [blame] | 289 | // Turn "Ljava/lang/String;" into "java/lang/String". |
| 290 | std::string DescriptorToName(const char* descriptor); |
| 291 | |
Elliott Hughes | 906e685 | 2011-10-28 14:52:10 -0700 | [diff] [blame] | 292 | // Tests for whether 's' is a valid class name in the three common forms: |
| 293 | bool IsValidBinaryClassName(const char* s); // "java.lang.String" |
| 294 | bool IsValidJniClassName(const char* s); // "java/lang/String" |
| 295 | bool IsValidDescriptor(const char* s); // "Ljava/lang/String;" |
Elliott Hughes | 64bf5a3 | 2011-09-20 14:43:12 -0700 | [diff] [blame] | 296 | |
jeffhao | 10037c8 | 2012-01-23 15:06:23 -0800 | [diff] [blame] | 297 | // Returns whether the given string is a valid field or method name, |
| 298 | // additionally allowing names that begin with '<' and end with '>'. |
| 299 | bool IsValidMemberName(const char* s); |
| 300 | |
Elliott Hughes | 79082e3 | 2011-08-25 12:07:32 -0700 | [diff] [blame] | 301 | // Returns the JNI native function name for the non-overloaded method 'm'. |
Ian Rogers | ef7d42f | 2014-01-06 12:55:46 -0800 | [diff] [blame] | 302 | std::string JniShortName(mirror::ArtMethod* m) |
Ian Rogers | b726dcb | 2012-09-05 08:57:23 -0700 | [diff] [blame] | 303 | SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); |
Elliott Hughes | 79082e3 | 2011-08-25 12:07:32 -0700 | [diff] [blame] | 304 | // Returns the JNI native function name for the overloaded method 'm'. |
Ian Rogers | ef7d42f | 2014-01-06 12:55:46 -0800 | [diff] [blame] | 305 | std::string JniLongName(mirror::ArtMethod* m) |
Ian Rogers | b726dcb | 2012-09-05 08:57:23 -0700 | [diff] [blame] | 306 | SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); |
Elliott Hughes | 79082e3 | 2011-08-25 12:07:32 -0700 | [diff] [blame] | 307 | |
Elliott Hughes | d92bec4 | 2011-09-02 17:04:36 -0700 | [diff] [blame] | 308 | bool ReadFileToString(const std::string& file_name, std::string* result); |
buzbee | c143c55 | 2011-08-20 17:38:58 -0700 | [diff] [blame] | 309 | |
Elliott Hughes | e27955c | 2011-08-26 15:21:24 -0700 | [diff] [blame] | 310 | // Returns the current date in ISO yyyy-mm-dd hh:mm:ss format. |
| 311 | std::string GetIsoDate(); |
| 312 | |
Elliott Hughes | 0512f02 | 2012-03-15 22:10:52 -0700 | [diff] [blame] | 313 | // Returns the monotonic time since some unspecified starting point in milliseconds. |
Elliott Hughes | 7162ad9 | 2011-10-27 14:08:42 -0700 | [diff] [blame] | 314 | uint64_t MilliTime(); |
| 315 | |
Elliott Hughes | 0512f02 | 2012-03-15 22:10:52 -0700 | [diff] [blame] | 316 | // Returns the monotonic time since some unspecified starting point in microseconds. |
jeffhao | a9ef3fd | 2011-12-13 18:33:43 -0800 | [diff] [blame] | 317 | uint64_t MicroTime(); |
| 318 | |
Elliott Hughes | 0512f02 | 2012-03-15 22:10:52 -0700 | [diff] [blame] | 319 | // Returns the monotonic time since some unspecified starting point in nanoseconds. |
Elliott Hughes | 83df2ac | 2011-10-11 16:37:54 -0700 | [diff] [blame] | 320 | uint64_t NanoTime(); |
| 321 | |
Elliott Hughes | 0512f02 | 2012-03-15 22:10:52 -0700 | [diff] [blame] | 322 | // Returns the thread-specific CPU-time clock in nanoseconds or -1 if unavailable. |
| 323 | uint64_t ThreadCpuNanoTime(); |
| 324 | |
Elliott Hughes | bb551fa | 2012-01-25 16:35:29 -0800 | [diff] [blame] | 325 | // Converts the given number of nanoseconds to milliseconds. |
Mathieu Chartier | 720ef76 | 2013-08-17 14:46:54 -0700 | [diff] [blame] | 326 | static constexpr inline uint64_t NsToMs(uint64_t ns) { |
Ian Rogers | 3bb17a6 | 2012-01-27 23:56:44 -0800 | [diff] [blame] | 327 | return ns / 1000 / 1000; |
| 328 | } |
| 329 | |
| 330 | // Converts the given number of milliseconds to nanoseconds |
Mathieu Chartier | 720ef76 | 2013-08-17 14:46:54 -0700 | [diff] [blame] | 331 | static constexpr inline uint64_t MsToNs(uint64_t ns) { |
Ian Rogers | 3bb17a6 | 2012-01-27 23:56:44 -0800 | [diff] [blame] | 332 | return ns * 1000 * 1000; |
| 333 | } |
| 334 | |
Brian Carlstrom | bcc2926 | 2012-11-02 11:36:03 -0700 | [diff] [blame] | 335 | #if defined(__APPLE__) |
| 336 | // No clocks to specify on OS/X, fake value to pass to routines that require a clock. |
| 337 | #define CLOCK_REALTIME 0xebadf00d |
| 338 | #endif |
| 339 | |
Ian Rogers | 56edc43 | 2013-01-18 16:51:51 -0800 | [diff] [blame] | 340 | // Sleep for the given number of nanoseconds, a bad way to handle contention. |
| 341 | void NanoSleep(uint64_t ns); |
| 342 | |
Brian Carlstrom | bcc2926 | 2012-11-02 11:36:03 -0700 | [diff] [blame] | 343 | // Initialize a timespec to either an absolute or relative time. |
| 344 | void InitTimeSpec(bool absolute, int clock, int64_t ms, int32_t ns, timespec* ts); |
| 345 | |
Elliott Hughes | 48436bb | 2012-02-07 15:23:28 -0800 | [diff] [blame] | 346 | // Splits a string using the given separator character into a vector of |
Elliott Hughes | 3402380 | 2011-08-30 12:06:17 -0700 | [diff] [blame] | 347 | // strings. Empty strings will be omitted. |
Elliott Hughes | 48436bb | 2012-02-07 15:23:28 -0800 | [diff] [blame] | 348 | void Split(const std::string& s, char separator, std::vector<std::string>& result); |
| 349 | |
Dave Allison | 7020278 | 2013-10-22 17:52:19 -0700 | [diff] [blame] | 350 | // Trims whitespace off both ends of the given string. |
| 351 | std::string Trim(std::string s); |
| 352 | |
Elliott Hughes | 48436bb | 2012-02-07 15:23:28 -0800 | [diff] [blame] | 353 | // Joins a vector of strings into a single string, using the given separator. |
| 354 | template <typename StringT> std::string Join(std::vector<StringT>& strings, char separator); |
Elliott Hughes | 3402380 | 2011-08-30 12:06:17 -0700 | [diff] [blame] | 355 | |
Elliott Hughes | 42ee142 | 2011-09-06 12:33:32 -0700 | [diff] [blame] | 356 | // Returns the calling thread's tid. (The C libraries don't expose this.) |
| 357 | pid_t GetTid(); |
| 358 | |
Elliott Hughes | 289be85 | 2012-06-12 13:57:20 -0700 | [diff] [blame] | 359 | // Returns the given thread's name. |
| 360 | std::string GetThreadName(pid_t tid); |
| 361 | |
Ian Rogers | 120f1c7 | 2012-09-28 17:17:10 -0700 | [diff] [blame] | 362 | // Returns details of the given thread's stack. |
Brian Carlstrom | 2921201 | 2013-09-12 22:18:30 -0700 | [diff] [blame] | 363 | void GetThreadStack(pthread_t thread, void** stack_base, size_t* stack_size); |
Elliott Hughes | e188419 | 2012-04-23 12:38:15 -0700 | [diff] [blame] | 364 | |
Elliott Hughes | bfe487b | 2011-10-26 15:48:55 -0700 | [diff] [blame] | 365 | // Reads data from "/proc/self/task/${tid}/stat". |
Brian Carlstrom | 2921201 | 2013-09-12 22:18:30 -0700 | [diff] [blame] | 366 | void GetTaskStats(pid_t tid, char* state, int* utime, int* stime, int* task_cpu); |
Elliott Hughes | bfe487b | 2011-10-26 15:48:55 -0700 | [diff] [blame] | 367 | |
Elliott Hughes | 1bac54f | 2012-03-16 12:48:31 -0700 | [diff] [blame] | 368 | // Returns the name of the scheduler group for the given thread the current process, or the empty string. |
| 369 | std::string GetSchedulerGroupName(pid_t tid); |
| 370 | |
Elliott Hughes | dcc2474 | 2011-09-07 14:02:44 -0700 | [diff] [blame] | 371 | // Sets the name of the current thread. The name may be truncated to an |
| 372 | // implementation-defined limit. |
Elliott Hughes | 22869a9 | 2012-03-27 14:08:24 -0700 | [diff] [blame] | 373 | void SetThreadName(const char* thread_name); |
Elliott Hughes | dcc2474 | 2011-09-07 14:02:44 -0700 | [diff] [blame] | 374 | |
Elliott Hughes | 46e251b | 2012-05-22 15:10:45 -0700 | [diff] [blame] | 375 | // Dumps the native stack for thread 'tid' to 'os'. |
| 376 | void DumpNativeStack(std::ostream& os, pid_t tid, const char* prefix = "", bool include_count = true); |
| 377 | |
| 378 | // Dumps the kernel stack for thread 'tid' to 'os'. Note that this is only available on linux-x86. |
| 379 | void DumpKernelStack(std::ostream& os, pid_t tid, const char* prefix = "", bool include_count = true); |
| 380 | |
Dave Allison | 7020278 | 2013-10-22 17:52:19 -0700 | [diff] [blame] | 381 | // Find $ANDROID_ROOT, /system, or abort. |
Brian Carlstrom | a56fcd6 | 2012-02-04 21:23:01 -0800 | [diff] [blame] | 382 | const char* GetAndroidRoot(); |
| 383 | |
Dave Allison | 7020278 | 2013-10-22 17:52:19 -0700 | [diff] [blame] | 384 | // Find $ANDROID_DATA, /data, or abort. |
Brian Carlstrom | a56fcd6 | 2012-02-04 21:23:01 -0800 | [diff] [blame] | 385 | const char* GetAndroidData(); |
| 386 | |
Brian Carlstrom | 7675e16 | 2013-06-10 16:18:04 -0700 | [diff] [blame] | 387 | // Returns the dalvik-cache location, or dies trying. |
| 388 | std::string GetDalvikCacheOrDie(const char* android_data); |
Brian Carlstrom | a9f1978 | 2011-10-13 00:14:47 -0700 | [diff] [blame] | 389 | |
Brian Carlstrom | 7675e16 | 2013-06-10 16:18:04 -0700 | [diff] [blame] | 390 | // Returns the dalvik-cache location for a DexFile or OatFile, or dies trying. |
Ian Rogers | 8d31bbd | 2013-10-13 10:44:14 -0700 | [diff] [blame] | 391 | std::string GetDalvikCacheFilenameOrDie(const char* location); |
jeffhao | 262bf46 | 2011-10-20 18:36:32 -0700 | [diff] [blame] | 392 | |
Brian Carlstrom | 7c3d13a | 2013-09-04 17:15:11 -0700 | [diff] [blame] | 393 | // Check whether the given magic matches a known file type. |
| 394 | bool IsZipMagic(uint32_t magic); |
| 395 | bool IsDexMagic(uint32_t magic); |
| 396 | bool IsOatMagic(uint32_t magic); |
Brian Carlstrom | b7bbba4 | 2011-10-13 14:58:47 -0700 | [diff] [blame] | 397 | |
Brian Carlstrom | 6449c62 | 2014-02-10 23:48:36 -0800 | [diff] [blame] | 398 | // Wrapper on fork/execv to run a command in a subprocess. |
| 399 | bool Exec(std::vector<std::string>& arg_vector, std::string* error_msg); |
| 400 | |
Mathieu Chartier | d22d548 | 2012-11-06 17:14:12 -0800 | [diff] [blame] | 401 | class VoidFunctor { |
Mathieu Chartier | 357e9be | 2012-08-01 11:00:14 -0700 | [diff] [blame] | 402 | public: |
Mathieu Chartier | d22d548 | 2012-11-06 17:14:12 -0800 | [diff] [blame] | 403 | template <typename A> |
Brian Carlstrom | df62950 | 2013-07-17 22:39:56 -0700 | [diff] [blame] | 404 | inline void operator() (A a) const { |
Mathieu Chartier | d22d548 | 2012-11-06 17:14:12 -0800 | [diff] [blame] | 405 | UNUSED(a); |
| 406 | } |
| 407 | |
| 408 | template <typename A, typename B> |
Brian Carlstrom | df62950 | 2013-07-17 22:39:56 -0700 | [diff] [blame] | 409 | inline void operator() (A a, B b) const { |
Mathieu Chartier | d22d548 | 2012-11-06 17:14:12 -0800 | [diff] [blame] | 410 | UNUSED(a); |
| 411 | UNUSED(b); |
| 412 | } |
| 413 | |
| 414 | template <typename A, typename B, typename C> |
Brian Carlstrom | df62950 | 2013-07-17 22:39:56 -0700 | [diff] [blame] | 415 | inline void operator() (A a, B b, C c) const { |
Mathieu Chartier | d22d548 | 2012-11-06 17:14:12 -0800 | [diff] [blame] | 416 | UNUSED(a); |
| 417 | UNUSED(b); |
| 418 | UNUSED(c); |
| 419 | } |
Mathieu Chartier | 357e9be | 2012-08-01 11:00:14 -0700 | [diff] [blame] | 420 | }; |
| 421 | |
Carl Shapiro | 6b6b5f0 | 2011-06-21 15:05:09 -0700 | [diff] [blame] | 422 | } // namespace art |
Carl Shapiro | a5d5cfd | 2011-06-21 12:46:59 -0700 | [diff] [blame] | 423 | |
Brian Carlstrom | fc0e321 | 2013-07-17 14:40:12 -0700 | [diff] [blame] | 424 | #endif // ART_RUNTIME_UTILS_H_ |