thread_db.h revision 7012117d4ae7e9ca9e50812f55757411aa8f93a0 
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
165