/* * Copyright (C) 2011 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef ART_LIBARTBASE_BASE_UTILS_H_ #define ART_LIBARTBASE_BASE_UTILS_H_ #include <pthread.h> #include <stdlib.h> #include <random> #include <string> #include <android-base/logging.h> #include "base/casts.h" #include "base/enums.h" #include "base/globals.h" #include "base/macros.h" #include "base/stringpiece.h" namespace art { template <typename T> bool ParseUint(const char *in, T* out) { char* end; unsigned long long int result = strtoull(in, &end, 0); // NOLINT(runtime/int) if (in == end || *end != '\0') { return false; } if (std::numeric_limits<T>::max() < result) { return false; } *out = static_cast<T>(result); return true; } template <typename T> bool ParseInt(const char* in, T* out) { char* end; long long int result = strtoll(in, &end, 0); // NOLINT(runtime/int) if (in == end || *end != '\0') { return false; } if (result < std::numeric_limits<T>::min() || std::numeric_limits<T>::max() < result) { return false; } *out = static_cast<T>(result); return true; } static inline uint32_t PointerToLowMemUInt32(const void* p) { uintptr_t intp = reinterpret_cast<uintptr_t>(p); DCHECK_LE(intp, 0xFFFFFFFFU); return intp & 0xFFFFFFFFU; } // Returns a human-readable size string such as "1MB". std::string PrettySize(int64_t size_in_bytes); // Splits a string using the given separator character into a vector of // strings. Empty strings will be omitted. void Split(const std::string& s, char separator, std::vector<std::string>* result); // Returns the calling thread's tid. (The C libraries don't expose this.) pid_t GetTid(); // Returns the given thread's name. std::string GetThreadName(pid_t tid); // Sets the name of the current thread. The name may be truncated to an // implementation-defined limit. void SetThreadName(const char* thread_name); // Reads data from "/proc/self/task/${tid}/stat". void GetTaskStats(pid_t tid, char* state, int* utime, int* stime, int* task_cpu); class VoidFunctor { public: template <typename A> inline void operator() (A a ATTRIBUTE_UNUSED) const { } template <typename A, typename B> inline void operator() (A a ATTRIBUTE_UNUSED, B b ATTRIBUTE_UNUSED) const { } template <typename A, typename B, typename C> inline void operator() (A a ATTRIBUTE_UNUSED, B b ATTRIBUTE_UNUSED, C c ATTRIBUTE_UNUSED) const { } }; inline bool TestBitmap(size_t idx, const uint8_t* bitmap) { return ((bitmap[idx / kBitsPerByte] >> (idx % kBitsPerByte)) & 0x01) != 0; } static inline constexpr bool ValidPointerSize(size_t pointer_size) { return pointer_size == 4 || pointer_size == 8; } static inline const void* EntryPointToCodePointer(const void* entry_point) { uintptr_t code = reinterpret_cast<uintptr_t>(entry_point); // TODO: Make this Thumb2 specific. It is benign on other architectures as code is always at // least 2 byte aligned. code &= ~0x1; return reinterpret_cast<const void*>(code); } using UsageFn = void (*)(const char*, ...); template <typename T> static void ParseIntOption(const StringPiece& option, const std::string& option_name, T* out, UsageFn usage, bool is_long_option = true) { std::string option_prefix = option_name + (is_long_option ? "=" : ""); DCHECK(option.starts_with(option_prefix)) << option << " " << option_prefix; const char* value_string = option.substr(option_prefix.size()).data(); int64_t parsed_integer_value = 0; if (!ParseInt(value_string, &parsed_integer_value)) { usage("Failed to parse %s '%s' as an integer", option_name.c_str(), value_string); } *out = dchecked_integral_cast<T>(parsed_integer_value); } template <typename T> static void ParseUintOption(const StringPiece& option, const std::string& option_name, T* out, UsageFn usage, bool is_long_option = true) { ParseIntOption(option, option_name, out, usage, is_long_option); if (*out < 0) { usage("%s passed a negative value %d", option_name.c_str(), *out); *out = 0; } } void ParseDouble(const std::string& option, char after_char, double min, double max, double* parsed_value, UsageFn Usage); #if defined(__BIONIC__) struct Arc4RandomGenerator { typedef uint32_t result_type; static constexpr uint32_t min() { return std::numeric_limits<uint32_t>::min(); } static constexpr uint32_t max() { return std::numeric_limits<uint32_t>::max(); } uint32_t operator() () { return arc4random(); } }; using RNG = Arc4RandomGenerator; #else using RNG = std::random_device; #endif template <typename T> static T GetRandomNumber(T min, T max) { CHECK_LT(min, max); std::uniform_int_distribution<T> dist(min, max); RNG rng; return dist(rng); } // Sleep forever and never come back. NO_RETURN void SleepForever(); inline void FlushInstructionCache(char* begin, char* end) { __builtin___clear_cache(begin, end); } inline void FlushDataCache(char* begin, char* end) { // Same as FlushInstructionCache for lack of other builtin. __builtin___clear_cache // flushes both caches. __builtin___clear_cache(begin, end); } template <typename T> constexpr PointerSize ConvertToPointerSize(T any) { if (any == 4 || any == 8) { return static_cast<PointerSize>(any); } else { LOG(FATAL); UNREACHABLE(); } } // Returns a type cast pointer if object pointed to is within the provided bounds. // Otherwise returns nullptr. template <typename T> inline static T BoundsCheckedCast(const void* pointer, const void* lower, const void* upper) { const uint8_t* bound_begin = static_cast<const uint8_t*>(lower); const uint8_t* bound_end = static_cast<const uint8_t*>(upper); DCHECK(bound_begin <= bound_end); T result = reinterpret_cast<T>(pointer); const uint8_t* begin = static_cast<const uint8_t*>(pointer); const uint8_t* end = begin + sizeof(*result); if (begin < bound_begin || end > bound_end || begin > end) { return nullptr; } return result; } template <typename T, size_t size> constexpr size_t ArrayCount(const T (&)[size]) { return size; } // Return -1 if <, 0 if ==, 1 if >. template <typename T> inline static int32_t Compare(T lhs, T rhs) { return (lhs < rhs) ? -1 : ((lhs == rhs) ? 0 : 1); } // Return -1 if < 0, 0 if == 0, 1 if > 0. template <typename T> inline static int32_t Signum(T opnd) { return (opnd < 0) ? -1 : ((opnd == 0) ? 0 : 1); } template <typename Func, typename... Args> static inline void CheckedCall(const Func& function, const char* what, Args... args) { int rc = function(args...); if (UNLIKELY(rc != 0)) { errno = rc; PLOG(FATAL) << "Checked call failed for " << what; } } // Hash bytes using a relatively fast hash. static inline size_t HashBytes(const uint8_t* data, size_t len) { size_t hash = 0x811c9dc5; for (uint32_t i = 0; i < len; ++i) { hash = (hash * 16777619) ^ data[i]; } hash += hash << 13; hash ^= hash >> 7; hash += hash << 3; hash ^= hash >> 17; hash += hash << 5; return hash; } } // namespace art #endif // ART_LIBARTBASE_BASE_UTILS_H_