blob: ed08ddcbb6e15f95d2bdb40621765f999dab439e [file] [log] [blame]
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -08001/* system/debuggerd/utility.h
2**
3** Copyright 2008, The Android Open Source Project
4**
Elliott Hughesb40c5032014-07-14 16:10:15 -07005** 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
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -08008**
Elliott Hughesb40c5032014-07-14 16:10:15 -07009** http://www.apache.org/licenses/LICENSE-2.0
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -080010**
Elliott Hughesb40c5032014-07-14 16:10:15 -070011** 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
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -080015** limitations under the License.
16*/
17
Jeff Brown13e715b2011-10-21 12:14:56 -070018#ifndef _DEBUGGERD_UTILITY_H
19#define _DEBUGGERD_UTILITY_H
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -080020
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -080021#include <stdbool.h>
Pavel Chupinc6c194c2013-11-21 23:17:20 +040022#include <sys/types.h>
Jeff Brown053b8652012-06-06 16:25:03 -070023
Christopher Ferrise8bc77e2015-05-22 14:26:13 -070024#include <backtrace/Backtrace.h>
25
Michael Wright80f59692014-06-20 16:19:58 -070026// 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"
Douglas Leung2ea9a322015-03-09 18:41:32 -070031#elif defined(__mips__) && !defined(__LP64__)
Michael Wright80f59692014-06-20 16:19:58 -070032#define ABI_STRING "mips"
Douglas Leung2ea9a322015-03-09 18:41:32 -070033#elif defined(__mips__) && defined(__LP64__)
34#define ABI_STRING "mips64"
Michael Wright80f59692014-06-20 16:19:58 -070035#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
Brigid Smithc75a02f2014-07-17 14:52:33 -070044struct log_t{
Jeff Brown053b8652012-06-06 16:25:03 -070045 /* tombstone file descriptor */
46 int tfd;
Christopher Tateded2e5a2013-03-19 13:12:23 -070047 /* Activity Manager socket file descriptor */
48 int amfd;
Brigid Smith62ba4892014-06-10 11:53:08 -070049 // 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;
Mark Salyzyn45ae4462014-07-25 12:25:48 -070053 // logd daemon crash, can block asking for logcat data, allow suppression.
54 bool should_retrieve_logcat;
Brigid Smithc75a02f2014-07-17 14:52:33 -070055
56 log_t()
Mark Salyzyn45ae4462014-07-25 12:25:48 -070057 : tfd(-1), amfd(-1), crashed_tid(-1), current_tid(-1), should_retrieve_logcat(true) {}
Brigid Smithc75a02f2014-07-17 14:52:33 -070058};
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -080059
Brigid Smith62ba4892014-06-10 11:53:08 -070060// List of types of logs to simplify the logging decision in _LOG
61enum logtype {
Brigid Smith62ba4892014-06-10 11:53:08 -070062 HEADER,
63 THREAD,
64 REGISTERS,
Elliott Hughesb40c5032014-07-14 16:10:15 -070065 FP_REGISTERS,
Brigid Smith62ba4892014-06-10 11:53:08 -070066 BACKTRACE,
67 MAPS,
68 MEMORY,
69 STACK,
70 LOGS
71};
72
Christopher Ferris1072f912014-10-31 21:34:38 -070073// Log information onto the tombstone.
Brigid Smith62ba4892014-06-10 11:53:08 -070074void _LOG(log_t* log, logtype ltype, const char *fmt, ...)
Jeff Brown13e715b2011-10-21 12:14:56 -070075 __attribute__ ((format(printf, 3, 4)));
Andy McFadden136dcc52011-09-22 16:37:06 -070076
Josh Gao7c89f9e2016-01-13 17:57:14 -080077int wait_for_signal(pid_t tid, int* total_sleep_time_usec);
Jeff Brown13e715b2011-10-21 12:14:56 -070078
Christopher Ferrise8bc77e2015-05-22 14:26:13 -070079void dump_memory(log_t* log, Backtrace* backtrace, uintptr_t addr, const char* fmt, ...);
Kévin PETIT4bb47722013-12-18 16:44:24 +000080
Jeff Brown13e715b2011-10-21 12:14:56 -070081#endif // _DEBUGGERD_UTILITY_H