Gitiles
Code Review Sign In
android-review.linaro.org / toolchain / prebuilts / ndk / r13 / refs/heads/master / . / platforms / android-19 / arch-arm / usr / include / thread_db.h
blob: 1b36cb2b421839d41bf313abd4ec7bc423a15cf3 [file] [log] [blame]
Dan Albert287553d2017-02-16 10:47:51 -0800[diff] [blame]1/*
2 * Copyright 2006 The Android Open Source Project
3 */
4
5#ifndef _LIBTHREAD_DB__THREAD_DB_H
6#define _LIBTHREAD_DB__THREAD_DB_H
7
8#include <pthread.h>
9#include <signal.h>
10#include <stdint.h>
11#include <sys/types.h>
12
13typedef void *psaddr_t;
14typedef pid_t lwpid_t;
15
16#define TD_THR_ANY_USER_FLAGS 0xffffffff
17#define TD_THR_LOWEST_PRIORITY -20
18#define TD_SIGNO_MASK NULL
19
20/* td_err_e values */
21enum {
22 TD_OK,
23 TD_ERR,
24 TD_NOTHR,
25 TD_NOSV,
26 TD_NOLWP,
27 TD_BADPH,
28 TD_BADTH,
29 TD_BADSH,
30 TD_BADTA,
31 TD_BADKEY,
32 TD_NOMSG,
33 TD_NOFPREGS,
34 TD_NOLIBTHREAD,
35 TD_NOEVENT,
36 TD_NOCAPAB,
37 TD_DBERR,
38 TD_NOAPLIC,
39 TD_NOTSD,
40 TD_MALLOC,
41 TD_PARTIALREG,
42 TD_NOXREGS,
43 TD_VERSION
44};
45
46/*
47 * td_event_e values
48 * NOTE: There is a max of 32 events
49 */
50enum {
51 TD_CREATE,
52 TD_DEATH
53};
54
55/* td_thr_state_e values */
56enum {
57 TD_THR_ANY_STATE,
58 TD_THR_UNKNOWN,
59 TD_THR_SLEEP,
60 TD_THR_ZOMBIE
61};
62
63typedef int32_t td_err_e;
64typedef uint32_t td_event_e;
65typedef uint32_t td_notify_e;
66typedef uint32_t td_thr_state_e;
67typedef pthread_t thread_t;
68
69typedef struct
70{
71 pid_t pid;
72 struct ps_prochandle *ph;
73} td_thragent_t;
74
75typedef struct
76{
77 pid_t pid;
78 pid_t tid;
79} td_thrhandle_t;
80
81typedef struct
82{
83 td_event_e event;
84 td_thrhandle_t const * th_p;
85 union {
86 void * data;
87 } msg;
88} td_event_msg_t;
89
90typedef struct
91{
92 uint32_t events;
93} td_thr_events_t;
94
95typedef struct
96{
97 union {
98 void * bptaddr;
99 } u;
100} td_notify_t;
101
102typedef struct
103{
104 td_thr_state_e ti_state;
105 thread_t ti_tid; // pthread's id for the thread
106 int32_t ti_lid; // the kernel's id for the thread
107} td_thrinfo_t;
108
109
110#define td_event_emptyset(set) \
111 (set)->events = 0
112
113#define td_event_fillset(set) \
114 (set)->events = 0xffffffff
115
116#define td_event_addset(set, n) \
117 (set)->events |= (1 << n)
118
119
120typedef int td_thr_iter_f(td_thrhandle_t const *, void *);
121
122
123struct ps_prochandle;
124
125#ifdef __cplusplus
126extern "C"{
127#endif
128
129extern td_err_e td_ta_new(struct ps_prochandle * proc_handle, td_thragent_t ** thread_agent);
130
131extern td_err_e td_ta_delete(td_thragent_t * ta);
132
133extern td_err_e td_ta_set_event(td_thragent_t const * agent, td_thr_events_t * event);
134
135extern td_err_e td_ta_event_addr(td_thragent_t const * agent, td_event_e event, td_notify_t * notify);
136
137extern td_err_e td_ta_clear_event(const td_thragent_t * ta_arg,
138 td_thr_events_t * event);
139
140extern td_err_e td_ta_event_getmsg(td_thragent_t const * agent, td_event_msg_t * event);
141
142extern td_err_e td_ta_map_lwp2thr(td_thragent_t const * agent, lwpid_t lwpid,
143 td_thrhandle_t *th);
144
145extern td_err_e td_thr_get_info(td_thrhandle_t const * handle,
146 td_thrinfo_t * info);
147
148extern td_err_e td_thr_event_enable(td_thrhandle_t const * handle,
149 td_event_e event);
150
151extern td_err_e td_ta_thr_iter(td_thragent_t const * agent, td_thr_iter_f * func, void * cookie,
152 td_thr_state_e state, int32_t prio, sigset_t * sigmask, uint32_t user_flags);
153
154extern char const ** td_symbol_list(void);
155
156extern td_err_e td_thr_tls_get_addr(const td_thrhandle_t * th,
157 psaddr_t map_address, size_t offset,
158 psaddr_t * address);
159
160#ifdef __cplusplus
161}
162#endif
163
164#endif