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 <stdbool.h>
22 #include <sys/types.h>
23 
24 #include <backtrace/Backtrace.h>
25 
26 // Figure out the abi based on defined macros.
27 #if defined(__arm__)
28 #define ABI_STRING "arm"
29 #elif defined(__aarch64__)
30 #define ABI_STRING "arm64"
31 #elif defined(__mips__) && !defined(__LP64__)
32 #define ABI_STRING "mips"
33 #elif defined(__mips__) && defined(__LP64__)
34 #define ABI_STRING "mips64"
35 #elif defined(__i386__)
36 #define ABI_STRING "x86"
37 #elif defined(__x86_64__)
38 #define ABI_STRING "x86_64"
39 #else
40 #error "Unsupported ABI"
41 #endif
42 
43 
44 struct log_t{
45     /* tombstone file descriptor */
46     int tfd;
47     /* Activity Manager socket file descriptor */
48     int amfd;
49     // The tid of the thread that crashed.
50     pid_t crashed_tid;
51     // The tid of the thread we are currently working with.
52     pid_t current_tid;
53     // logd daemon crash, can block asking for logcat data, allow suppression.
54     bool should_retrieve_logcat;
55 
log_tlog_t56     log_t()
57         : tfd(-1), amfd(-1), crashed_tid(-1), current_tid(-1), should_retrieve_logcat(true) {}
58 };
59 
60 // List of types of logs to simplify the logging decision in _LOG
61 enum logtype {
62   ERROR,
63   HEADER,
64   THREAD,
65   REGISTERS,
66   FP_REGISTERS,
67   BACKTRACE,
68   MAPS,
69   MEMORY,
70   STACK,
71   LOGS
72 };
73 
74 // Log information onto the tombstone.
75 void _LOG(log_t* log, logtype ltype, const char *fmt, ...)
76         __attribute__ ((format(printf, 3, 4)));
77 
78 int wait_for_sigstop(pid_t, int*, bool*);
79 
80 void dump_memory(log_t* log, Backtrace* backtrace, uintptr_t addr, const char* fmt, ...);
81 
82 #endif // _DEBUGGERD_UTILITY_H
83