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