| 1 | #ifdef HAVE_THREAD_DB_H |
| 2 | #include <thread_db.h> |
| 3 | #else |
| 4 | |
| 5 | #ifdef HAVE_STDINT_H |
| 6 | #include <stdint.h> |
| 7 | typedef uint32_t gdb_uint32_t; |
| 8 | #define GDB_UINT32_C(c) UINT32_C(c) |
| 9 | #else |
| 10 | typedef unsigned int gdb_uint32_t; |
| 11 | #define GDB_UINT32_C(c) c ## U |
| 12 | #endif |
| 13 | |
| 14 | /* Copyright (C) 1999 Free Software Foundation, Inc. |
| 15 | This file is part of the GNU C Library. |
| 16 | |
| 17 | The GNU C Library is free software; you can redistribute it and/or |
| 18 | modify it under the terms of the GNU Library General Public License as |
| 19 | published by the Free Software Foundation; either version 2 of the |
| 20 | License, or (at your option) any later version. |
| 21 | |
| 22 | The GNU C Library is distributed in the hope that it will be useful, |
| 23 | but WITHOUT ANY WARRANTY; without even the implied warranty of |
| 24 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
| 25 | Library General Public License for more details. |
| 26 | |
| 27 | You should have received a copy of the GNU Library General Public |
| 28 | License along with the GNU C Library; see the file COPYING.LIB. If not, |
| 29 | write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, |
| 30 | Boston, MA 02111-1307, USA. */ |
| 31 | |
| 32 | #ifndef _THREAD_DB_H |
| 33 | #define _THREAD_DB_H 1 |
| 34 | |
| 35 | /* This is the debugger interface for the LinuxThreads library. It is |
| 36 | modelled closely after the interface with same names in Solaris with |
| 37 | the goal to share the same code in the debugger. */ |
| 38 | #include <pthread.h> |
| 39 | #include <sys/types.h> |
| 40 | #include <sys/procfs.h> |
| 41 | |
| 42 | |
| 43 | /* Error codes of the library. */ |
| 44 | typedef enum |
| 45 | { |
| 46 | TD_OK, /* No error. */ |
| 47 | TD_ERR, /* No further specified error. */ |
| 48 | TD_NOTHR, /* No matching thread found. */ |
| 49 | TD_NOSV, /* No matching synchronization handle found. */ |
| 50 | TD_NOLWP, /* No matching light-weighted process found. */ |
| 51 | TD_BADPH, /* Invalid process handle. */ |
| 52 | TD_BADTH, /* Invalid thread handle. */ |
| 53 | TD_BADSH, /* Invalid synchronization handle. */ |
| 54 | TD_BADTA, /* Invalid thread agent. */ |
| 55 | TD_BADKEY, /* Invalid key. */ |
| 56 | TD_NOMSG, /* No event available. */ |
| 57 | TD_NOFPREGS, /* No floating-point register content available. */ |
| 58 | TD_NOLIBTHREAD, /* Application not linked with thread library. */ |
| 59 | TD_NOEVENT, /* Requested event is not supported. */ |
| 60 | TD_NOCAPAB, /* Capability not available. */ |
| 61 | TD_DBERR, /* Internal debug library error. */ |
| 62 | TD_NOAPLIC, /* Operation is not applicable. */ |
| 63 | TD_NOTSD, /* No thread-specific data available. */ |
| 64 | TD_MALLOC, /* Out of memory. */ |
| 65 | TD_PARTIALREG, /* Not entire register set was read or written. */ |
| 66 | TD_NOXREGS /* X register set not available for given thread. */ |
| 67 | } td_err_e; |
| 68 | |
| 69 | |
| 70 | /* Possible thread states. TD_THR_ANY_STATE is a pseudo-state used to |
| 71 | select threads regardless of state in td_ta_thr_iter(). */ |
| 72 | typedef enum |
| 73 | { |
| 74 | TD_THR_ANY_STATE, |
| 75 | TD_THR_UNKNOWN, |
| 76 | TD_THR_STOPPED, |
| 77 | TD_THR_RUN, |
| 78 | TD_THR_ACTIVE, |
| 79 | TD_THR_ZOMBIE, |
| 80 | TD_THR_SLEEP, |
| 81 | TD_THR_STOPPED_ASLEEP |
| 82 | } td_thr_state_e; |
| 83 | |
| 84 | /* Thread type: user or system. TD_THR_ANY_TYPE is a pseudo-type used |
| 85 | to select threads regardless of type in td_ta_thr_iter(). */ |
| 86 | typedef enum |
| 87 | { |
| 88 | TD_THR_ANY_TYPE, |
| 89 | TD_THR_USER, |
| 90 | TD_THR_SYSTEM |
| 91 | } td_thr_type_e; |
| 92 | |
| 93 | |
| 94 | /* Types of the debugging library. */ |
| 95 | |
| 96 | /* Handle for a process. This type is opaque. */ |
| 97 | typedef struct td_thragent td_thragent_t; |
| 98 | |
| 99 | /* The actual thread handle type. This is also opaque. */ |
| 100 | typedef struct td_thrhandle |
| 101 | { |
| 102 | td_thragent_t *th_ta_p; |
| 103 | psaddr_t th_unique; |
| 104 | } td_thrhandle_t; |
| 105 | |
| 106 | |
| 107 | /* Flags for `td_ta_thr_iter'. */ |
| 108 | #define TD_THR_ANY_USER_FLAGS 0xffffffff |
| 109 | #define TD_THR_LOWEST_PRIORITY -20 |
| 110 | #define TD_SIGNO_MASK NULL |
| 111 | |
| 112 | |
| 113 | #define TD_EVENTSIZE 2 |
| 114 | #define BT_UISHIFT 5 /* log base 2 of BT_NBIPUI, to extract word index */ |
| 115 | #define BT_NBIPUI (1 << BT_UISHIFT) /* n bits per uint */ |
| 116 | #define BT_UIMASK (BT_NBIPUI - 1) /* to extract bit index */ |
| 117 | |
| 118 | /* Bitmask of enabled events. */ |
| 119 | typedef struct td_thr_events |
| 120 | { |
| 121 | gdb_uint32_t event_bits[TD_EVENTSIZE]; |
| 122 | } td_thr_events_t; |
| 123 | |
| 124 | /* Event set manipulation macros. */ |
| 125 | #define __td_eventmask(n) \ |
| 126 | (GDB_UINT32_C (1) << (((n) - 1) & BT_UIMASK)) |
| 127 | #define __td_eventword(n) \ |
| 128 | ((GDB_UINT32_C ((n) - 1)) >> BT_UISHIFT) |
| 129 | |
| 130 | #define td_event_emptyset(setp) \ |
| 131 | do { \ |
| 132 | int __i; \ |
| 133 | for (__i = TD_EVENTSIZE; __i > 0; --__i) \ |
| 134 | (setp)->event_bits[__i - 1] = 0; \ |
| 135 | } while (0) |
| 136 | |
| 137 | #define td_event_fillset(setp) \ |
| 138 | do { \ |
| 139 | int __i; \ |
| 140 | for (__i = TD_EVENTSIZE; __i > 0; --__i) \ |
| 141 | (setp)->event_bits[__i - 1] = GDB_UINT32_C (0xffffffff); \ |
| 142 | } while (0) |
| 143 | |
| 144 | #define td_event_addset(setp, n) \ |
| 145 | (((setp)->event_bits[__td_eventword (n)]) |= __td_eventmask (n)) |
| 146 | #define td_event_delset(setp, n) \ |
| 147 | (((setp)->event_bits[__td_eventword (n)]) &= ~__td_eventmask (n)) |
| 148 | #define td_eventismember(setp, n) \ |
| 149 | (__td_eventmask (n) & ((setp)->event_bits[__td_eventword (n)])) |
| 150 | #if TD_EVENTSIZE == 2 |
| 151 | # define td_eventisempty(setp) \ |
| 152 | (!((setp)->event_bits[0]) && !((setp)->event_bits[1])) |
| 153 | #else |
| 154 | # error "td_eventisempty must be changed to match TD_EVENTSIZE" |
| 155 | #endif |
| 156 | |
| 157 | /* Events reportable by the thread implementation. */ |
| 158 | typedef enum |
| 159 | { |
| 160 | TD_ALL_EVENTS, /* Pseudo-event number. */ |
| 161 | TD_EVENT_NONE = TD_ALL_EVENTS, /* Depends on context. */ |
| 162 | TD_READY, /* Is executable now. */ |
| 163 | TD_SLEEP, /* Blocked in a synchronization obj. */ |
| 164 | TD_SWITCHTO, /* Now assigned to a process. */ |
| 165 | TD_SWITCHFROM, /* Not anymore assigned to a process. */ |
| 166 | TD_LOCK_TRY, /* Trying to get an unavailable lock. */ |
| 167 | TD_CATCHSIG, /* Signal posted to the thread. */ |
| 168 | TD_IDLE, /* Process getting idle. */ |
| 169 | TD_CREATE, /* New thread created. */ |
| 170 | TD_DEATH, /* Thread terminated. */ |
| 171 | TD_PREEMPT, /* Preempted. */ |
| 172 | TD_PRI_INHERIT, /* Inherited elevated priority. */ |
| 173 | TD_REAP, /* Reaped. */ |
| 174 | TD_CONCURRENCY, /* Number of processes changing. */ |
| 175 | TD_TIMEOUT, /* Conditional variable wait timed out. */ |
| 176 | TD_MIN_EVENT_NUM = TD_READY, |
| 177 | TD_MAX_EVENT_NUM = TD_TIMEOUT, |
| 178 | TD_EVENTS_ENABLE = 31 /* Event reporting enabled. */ |
| 179 | } td_event_e; |
| 180 | |
| 181 | /* Values representing the different ways events are reported. */ |
| 182 | typedef enum |
| 183 | { |
| 184 | NOTIFY_BPT, /* User must insert breakpoint at u.bptaddr. */ |
| 185 | NOTIFY_AUTOBPT, /* Breakpoint at u.bptaddr is automatically |
| 186 | inserted. */ |
| 187 | NOTIFY_SYSCALL /* System call u.syscallno will be invoked. */ |
| 188 | } td_notify_e; |
| 189 | |
| 190 | /* Description how event type is reported. */ |
| 191 | typedef struct td_notify |
| 192 | { |
| 193 | td_notify_e type; /* Way the event is reported. */ |
| 194 | union |
| 195 | { |
| 196 | psaddr_t bptaddr; /* Address of breakpoint. */ |
| 197 | int syscallno; /* Number of system call used. */ |
| 198 | } u; |
| 199 | } td_notify_t; |
| 200 | |
| 201 | /* Structure used to report event. */ |
| 202 | typedef struct td_event_msg |
| 203 | { |
| 204 | td_event_e event; /* Event type being reported. */ |
| 205 | const td_thrhandle_t *th_p; /* Thread reporting the event. */ |
| 206 | union |
| 207 | { |
| 208 | #if 0 |
| 209 | td_synchandle_t *sh; /* Handle of synchronization object. */ |
| 210 | #endif |
| 211 | uintptr_t data; /* Event specific data. */ |
| 212 | } msg; |
| 213 | } td_event_msg_t; |
| 214 | |
| 215 | /* Structure containing event data available in each thread structure. */ |
| 216 | typedef struct |
| 217 | { |
| 218 | td_thr_events_t eventmask; /* Mask of enabled events. */ |
| 219 | td_event_e eventnum; /* Number of last event. */ |
| 220 | void *eventdata; /* Data associated with event. */ |
| 221 | } td_eventbuf_t; |
| 222 | |
| 223 | |
| 224 | /* Gathered statistics about the process. */ |
| 225 | typedef struct td_ta_stats |
| 226 | { |
| 227 | int nthreads; /* Total number of threads in use. */ |
| 228 | int r_concurrency; /* Concurrency level requested by user. */ |
| 229 | int nrunnable_num; /* Average runnable threads, numerator. */ |
| 230 | int nrunnable_den; /* Average runnable threads, denominator. */ |
| 231 | int a_concurrency_num; /* Achieved concurrency level, numerator. */ |
| 232 | int a_concurrency_den; /* Achieved concurrency level, denominator. */ |
| 233 | int nlwps_num; /* Average number of processes in use, |
| 234 | numerator. */ |
| 235 | int nlwps_den; /* Average number of processes in use, |
| 236 | denominator. */ |
| 237 | int nidle_num; /* Average number of idling processes, |
| 238 | numerator. */ |
| 239 | int nidle_den; /* Average number of idling processes, |
| 240 | denominator. */ |
| 241 | } td_ta_stats_t; |
| 242 | |
| 243 | |
| 244 | /* Since Sun's library is based on Solaris threads we have to define a few |
| 245 | types to map them to POSIX threads. */ |
| 246 | typedef pthread_t thread_t; |
| 247 | typedef pthread_key_t thread_key_t; |
| 248 | |
| 249 | |
| 250 | /* Callback for iteration over threads. */ |
| 251 | typedef int td_thr_iter_f (const td_thrhandle_t *, void *); |
| 252 | |
| 253 | /* Callback for iteration over thread local data. */ |
| 254 | typedef int td_key_iter_f (thread_key_t, void (*) (void *), void *); |
| 255 | |
| 256 | |
| 257 | |
| 258 | /* Forward declaration. This has to be defined by the user. */ |
| 259 | struct ps_prochandle; |
| 260 | |
| 261 | |
| 262 | /* Information about the thread. */ |
| 263 | typedef struct td_thrinfo |
| 264 | { |
| 265 | td_thragent_t *ti_ta_p; /* Process handle. */ |
| 266 | unsigned int ti_user_flags; /* Unused. */ |
| 267 | thread_t ti_tid; /* Thread ID returned by |
| 268 | pthread_create(). */ |
| 269 | char *ti_tls; /* Pointer to thread-local data. */ |
| 270 | psaddr_t ti_startfunc; /* Start function passed to |
| 271 | pthread_create(). */ |
| 272 | psaddr_t ti_stkbase; /* Base of thread's stack. */ |
| 273 | long int ti_stksize; /* Size of thread's stack. */ |
| 274 | psaddr_t ti_ro_area; /* Unused. */ |
| 275 | int ti_ro_size; /* Unused. */ |
| 276 | td_thr_state_e ti_state; /* Thread state. */ |
| 277 | unsigned char ti_db_suspended; /* Nonzero if suspended by debugger. */ |
| 278 | td_thr_type_e ti_type; /* Type of the thread (system vs |
| 279 | user thread). */ |
| 280 | intptr_t ti_pc; /* Unused. */ |
| 281 | intptr_t ti_sp; /* Unused. */ |
| 282 | short int ti_flags; /* Unused. */ |
| 283 | int ti_pri; /* Thread priority. */ |
| 284 | lwpid_t ti_lid; /* Unused. */ |
| 285 | sigset_t ti_sigmask; /* Signal mask. */ |
| 286 | unsigned char ti_traceme; /* Nonzero if event reporting |
| 287 | enabled. */ |
| 288 | unsigned char ti_preemptflag; /* Unused. */ |
| 289 | unsigned char ti_pirecflag; /* Unused. */ |
| 290 | sigset_t ti_pending; /* Set of pending signals. */ |
| 291 | td_thr_events_t ti_events; /* Set of enabled events. */ |
| 292 | } td_thrinfo_t; |
| 293 | |
| 294 | |
| 295 | |
| 296 | /* Prototypes for exported library functions. */ |
| 297 | |
| 298 | /* Initialize the thread debug support library. */ |
| 299 | extern td_err_e td_init (void); |
| 300 | |
| 301 | /* Historical relict. Should not be used anymore. */ |
| 302 | extern td_err_e td_log (void); |
| 303 | |
| 304 | /* Generate new thread debug library handle for process PS. */ |
| 305 | extern td_err_e td_ta_new (struct ps_prochandle *__ps, td_thragent_t **__ta); |
| 306 | |
| 307 | /* Free resources allocated for TA. */ |
| 308 | extern td_err_e td_ta_delete (td_thragent_t *__ta); |
| 309 | |
| 310 | /* Get number of currently running threads in process associated with TA. */ |
| 311 | extern td_err_e td_ta_get_nthreads (const td_thragent_t *__ta, int *__np); |
| 312 | |
| 313 | /* Return process handle passed in `td_ta_new' for process associated with |
| 314 | TA. */ |
| 315 | extern td_err_e td_ta_get_ph (const td_thragent_t *__ta, |
| 316 | struct ps_prochandle **__ph); |
| 317 | |
| 318 | /* Map thread library handle PT to thread debug library handle for process |
| 319 | associated with TA and store result in *TH. */ |
| 320 | extern td_err_e td_ta_map_id2thr (const td_thragent_t *__ta, pthread_t __pt, |
| 321 | td_thrhandle_t *__th); |
| 322 | |
| 323 | /* Map process ID LWPID to thread debug library handle for process |
| 324 | associated with TA and store result in *TH. */ |
| 325 | extern td_err_e td_ta_map_lwp2thr (const td_thragent_t *__ta, lwpid_t __lwpid, |
| 326 | td_thrhandle_t *__th); |
| 327 | |
| 328 | |
| 329 | /* Call for each thread in a process associated with TA the callback function |
| 330 | CALLBACK. */ |
| 331 | extern td_err_e td_ta_thr_iter (const td_thragent_t *__ta, |
| 332 | td_thr_iter_f *__callback, void *__cbdata_p, |
| 333 | td_thr_state_e __state, int __ti_pri, |
| 334 | sigset_t *__ti_sigmask_p, |
| 335 | unsigned int __ti_user_flags); |
| 336 | |
| 337 | /* Call for each defined thread local data entry the callback function KI. */ |
| 338 | extern td_err_e td_ta_tsd_iter (const td_thragent_t *__ta, td_key_iter_f *__ki, |
| 339 | void *__p); |
| 340 | |
| 341 | |
| 342 | /* Get event address for EVENT. */ |
| 343 | extern td_err_e td_ta_event_addr (const td_thragent_t *__ta, |
| 344 | td_event_e __event, td_notify_t *__ptr); |
| 345 | |
| 346 | /* Enable EVENT in global mask. */ |
| 347 | extern td_err_e td_ta_set_event (const td_thragent_t *__ta, |
| 348 | td_thr_events_t *__event); |
| 349 | |
| 350 | /* Disable EVENT in global mask. */ |
| 351 | extern td_err_e td_ta_clear_event (const td_thragent_t *__ta, |
| 352 | td_thr_events_t *__event); |
| 353 | |
| 354 | /* Return information about last event. */ |
| 355 | extern td_err_e td_ta_event_getmsg (const td_thragent_t *__ta, |
| 356 | td_event_msg_t *msg); |
| 357 | |
| 358 | |
| 359 | /* Set suggested concurrency level for process associated with TA. */ |
| 360 | extern td_err_e td_ta_setconcurrency (const td_thragent_t *__ta, int __level); |
| 361 | |
| 362 | |
| 363 | /* Enable collecting statistics for process associated with TA. */ |
| 364 | extern td_err_e td_ta_enable_stats (const td_thragent_t *__ta, int __enable); |
| 365 | |
| 366 | /* Reset statistics. */ |
| 367 | extern td_err_e td_ta_reset_stats (const td_thragent_t *__ta); |
| 368 | |
| 369 | /* Retrieve statistics from process associated with TA. */ |
| 370 | extern td_err_e td_ta_get_stats (const td_thragent_t *__ta, |
| 371 | td_ta_stats_t *__statsp); |
| 372 | |
| 373 | |
| 374 | /* Validate that TH is a thread handle. */ |
| 375 | extern td_err_e td_thr_validate (const td_thrhandle_t *__th); |
| 376 | |
| 377 | /* Return information about thread TH. */ |
| 378 | extern td_err_e td_thr_get_info (const td_thrhandle_t *__th, |
| 379 | td_thrinfo_t *__infop); |
| 380 | |
| 381 | /* Retrieve floating-point register contents of process running thread TH. */ |
| 382 | extern td_err_e td_thr_getfpregs (const td_thrhandle_t *__th, |
| 383 | prfpregset_t *__regset); |
| 384 | |
| 385 | /* Retrieve general register contents of process running thread TH. */ |
| 386 | extern td_err_e td_thr_getgregs (const td_thrhandle_t *__th, |
| 387 | prgregset_t __gregs); |
| 388 | |
| 389 | /* Retrieve extended register contents of process running thread TH. */ |
| 390 | extern td_err_e td_thr_getxregs (const td_thrhandle_t *__th, void *__xregs); |
| 391 | |
| 392 | /* Get size of extended register set of process running thread TH. */ |
| 393 | extern td_err_e td_thr_getxregsize (const td_thrhandle_t *__th, int *__sizep); |
| 394 | |
| 395 | /* Set floating-point register contents of process running thread TH. */ |
| 396 | extern td_err_e td_thr_setfpregs (const td_thrhandle_t *__th, |
| 397 | const prfpregset_t *__fpregs); |
| 398 | |
| 399 | /* Set general register contents of process running thread TH. */ |
| 400 | extern td_err_e td_thr_setgregs (const td_thrhandle_t *__th, |
| 401 | prgregset_t __gregs); |
| 402 | |
| 403 | /* Set extended register contents of process running thread TH. */ |
| 404 | extern td_err_e td_thr_setxregs (const td_thrhandle_t *__th, |
| 405 | const void *__addr); |
| 406 | |
| 407 | |
| 408 | /* Enable reporting for EVENT for thread TH. */ |
| 409 | extern td_err_e td_thr_event_enable (const td_thrhandle_t *__th, int __event); |
| 410 | |
| 411 | /* Enable EVENT for thread TH. */ |
| 412 | extern td_err_e td_thr_set_event (const td_thrhandle_t *__th, |
| 413 | td_thr_events_t *__event); |
| 414 | |
| 415 | /* Disable EVENT for thread TH. */ |
| 416 | extern td_err_e td_thr_clear_event (const td_thrhandle_t *__th, |
| 417 | td_thr_events_t *__event); |
| 418 | |
| 419 | /* Get event message for thread TH. */ |
| 420 | extern td_err_e td_thr_event_getmsg (const td_thrhandle_t *__th, |
| 421 | td_event_msg_t *__msg); |
| 422 | |
| 423 | |
| 424 | /* Set priority of thread TH. */ |
| 425 | extern td_err_e td_thr_setprio (const td_thrhandle_t *__th, int __prio); |
| 426 | |
| 427 | |
| 428 | /* Set pending signals for thread TH. */ |
| 429 | extern td_err_e td_thr_setsigpending (const td_thrhandle_t *__th, |
| 430 | unsigned char __n, const sigset_t *__ss); |
| 431 | |
| 432 | /* Set signal mask for thread TH. */ |
| 433 | extern td_err_e td_thr_sigsetmask (const td_thrhandle_t *__th, |
| 434 | const sigset_t *__ss); |
| 435 | |
| 436 | |
| 437 | /* Return thread local data associated with key TK in thread TH. */ |
| 438 | extern td_err_e td_thr_tsd (const td_thrhandle_t *__th, |
| 439 | const thread_key_t __tk, void **__data); |
| 440 | |
| 441 | |
| 442 | /* Suspend execution of thread TH. */ |
| 443 | extern td_err_e td_thr_dbsuspend (const td_thrhandle_t *__th); |
| 444 | |
| 445 | /* Resume execution of thread TH. */ |
| 446 | extern td_err_e td_thr_dbresume (const td_thrhandle_t *__th); |
| 447 | |
| 448 | #endif /* thread_db.h */ |
| 449 | |
| 450 | #endif /* HAVE_THREAD_DB_H */ |