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 <android-base/macros.h> 28 #include <backtrace/Backtrace.h> 29 30 struct log_t { 31 // Tombstone file descriptor. 32 int tfd; 33 // Data to be sent to the Activity Manager. 34 std::string* amfd_data; 35 // The tid of the thread that crashed. 36 pid_t crashed_tid; 37 // The tid of the thread we are currently working with. 38 pid_t current_tid; 39 // logd daemon crash, can block asking for logcat data, allow suppression. 40 bool should_retrieve_logcat; 41 log_tlog_t42 log_t() 43 : tfd(-1), 44 amfd_data(nullptr), 45 crashed_tid(-1), 46 current_tid(-1), 47 should_retrieve_logcat(true) {} 48 }; 49 50 // List of types of logs to simplify the logging decision in _LOG 51 enum logtype { 52 HEADER, 53 THREAD, 54 REGISTERS, 55 FP_REGISTERS, 56 BACKTRACE, 57 MAPS, 58 MEMORY, 59 STACK, 60 LOGS, 61 OPEN_FILES 62 }; 63 64 // Log information onto the tombstone. 65 void _LOG(log_t* log, logtype ltype, const char* fmt, ...) __attribute__((format(printf, 3, 4))); 66 67 namespace unwindstack { 68 class Memory; 69 } 70 71 void dump_memory(log_t* log, unwindstack::Memory* backtrace, uint64_t addr, const std::string&); 72 73 void read_with_default(const char* path, char* buf, size_t len, const char* default_value); 74 75 void drop_capabilities(); 76 77 bool signal_has_si_addr(int si_signo, int si_code); 78 const char* get_signame(int sig); 79 const char* get_sigcode(int signo, int code); 80 81 #endif // _DEBUGGERD_UTILITY_H 82