1/* system/debuggerd/utility.h 2** 3** Copyright 2008, The Android Open Source Project 4** 5** Licensed under the Apache License, Version 2.0 (the "License"); 6** you may not use this file except in compliance with the License. 7** You may obtain a copy of the License at 8** 9** http://www.apache.org/licenses/LICENSE-2.0 10** 11** Unless required by applicable law or agreed to in writing, software 12** distributed under the License is distributed on an "AS IS" BASIS, 13** WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 14** See the License for the specific language governing permissions and 15** limitations under the License. 16*/ 17 18#ifndef _DEBUGGERD_UTILITY_H 19#define _DEBUGGERD_UTILITY_H 20 21#include <signal.h> 22#include <stdbool.h> 23#include <sys/types.h> 24 25#include <string> 26 27#include <backtrace/Backtrace.h> 28 29// Figure out the abi based on defined macros. 30#if defined(__arm__) 31#define ABI_STRING "arm" 32#elif defined(__aarch64__) 33#define ABI_STRING "arm64" 34#elif defined(__mips__) && !defined(__LP64__) 35#define ABI_STRING "mips" 36#elif defined(__mips__) && defined(__LP64__) 37#define ABI_STRING "mips64" 38#elif defined(__i386__) 39#define ABI_STRING "x86" 40#elif defined(__x86_64__) 41#define ABI_STRING "x86_64" 42#else 43#error "Unsupported ABI" 44#endif 45 46 47struct log_t{ 48 // Tombstone file descriptor. 49 int tfd; 50 // Data to be sent to the Activity Manager. 51 std::string* amfd_data; 52 // The tid of the thread that crashed. 53 pid_t crashed_tid; 54 // The tid of the thread we are currently working with. 55 pid_t current_tid; 56 // logd daemon crash, can block asking for logcat data, allow suppression. 57 bool should_retrieve_logcat; 58 59 log_t() 60 : tfd(-1), amfd_data(nullptr), crashed_tid(-1), current_tid(-1), 61 should_retrieve_logcat(true) {} 62}; 63 64// List of types of logs to simplify the logging decision in _LOG 65enum logtype { 66 HEADER, 67 THREAD, 68 REGISTERS, 69 FP_REGISTERS, 70 BACKTRACE, 71 MAPS, 72 MEMORY, 73 STACK, 74 LOGS, 75 OPEN_FILES 76}; 77 78// Log information onto the tombstone. 79void _LOG(log_t* log, logtype ltype, const char *fmt, ...) 80 __attribute__ ((format(printf, 3, 4))); 81 82bool wait_for_signal(pid_t tid, siginfo_t* siginfo); 83 84void dump_memory(log_t* log, Backtrace* backtrace, uintptr_t addr, const char* fmt, ...); 85 86void read_with_default(const char* path, char* buf, size_t len, const char* default_value); 87 88#endif // _DEBUGGERD_UTILITY_H 89