* linux-thread-db.c (check_for_thread_db): Don't attempt to use
[external/binutils.git] / gdb / linux-thread-db.c
1 /* libthread_db assisted debugging support, generic parts.
2
3    Copyright (C) 1999, 2000, 2001, 2003, 2004, 2005, 2006
4    Free Software Foundation, Inc.
5
6    This file is part of GDB.
7
8    This program is free software; you can redistribute it and/or modify
9    it under the terms of the GNU General Public License as published by
10    the Free Software Foundation; either version 2 of the License, or
11    (at your option) any later version.
12
13    This program is distributed in the hope that it will be useful,
14    but WITHOUT ANY WARRANTY; without even the implied warranty of
15    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16    GNU General Public License for more details.
17
18    You should have received a copy of the GNU General Public License
19    along with this program; if not, write to the Free Software
20    Foundation, Inc., 51 Franklin Street, Fifth Floor,
21    Boston, MA 02110-1301, USA.  */
22
23 #include "defs.h"
24
25 #include "gdb_assert.h"
26 #include <dlfcn.h>
27 #include "gdb_proc_service.h"
28 #include "gdb_thread_db.h"
29
30 #include "bfd.h"
31 #include "exceptions.h"
32 #include "gdbthread.h"
33 #include "inferior.h"
34 #include "symfile.h"
35 #include "objfiles.h"
36 #include "target.h"
37 #include "regcache.h"
38 #include "solib-svr4.h"
39 #include "gdbcore.h"
40 #include "linux-nat.h"
41
42 #ifdef HAVE_GNU_LIBC_VERSION_H
43 #include <gnu/libc-version.h>
44 #endif
45
46 #ifndef LIBTHREAD_DB_SO
47 #define LIBTHREAD_DB_SO "libthread_db.so.1"
48 #endif
49
50 /* If we're running on GNU/Linux, we must explicitly attach to any new
51    threads.  */
52
53 /* FIXME: There is certainly some room for improvements:
54    - Cache LWP ids.
55    - Bypass libthread_db when fetching or storing registers for
56    threads bound to a LWP.  */
57
58 /* This module's target vector.  */
59 static struct target_ops thread_db_ops;
60
61 /* The target vector that we call for things this module can't handle.  */
62 static struct target_ops *target_beneath;
63
64 /* Pointer to the next function on the objfile event chain.  */
65 static void (*target_new_objfile_chain) (struct objfile * objfile);
66
67 /* Non-zero if we're using this module's target vector.  */
68 static int using_thread_db;
69
70 /* Non-zero if we have determined the signals used by the threads
71    library.  */
72 static int thread_signals;
73 static sigset_t thread_stop_set;
74 static sigset_t thread_print_set;
75
76 /* Structure that identifies the child process for the
77    <proc_service.h> interface.  */
78 static struct ps_prochandle proc_handle;
79
80 /* Connection to the libthread_db library.  */
81 static td_thragent_t *thread_agent;
82
83 /* Pointers to the libthread_db functions.  */
84
85 static td_err_e (*td_init_p) (void);
86
87 static td_err_e (*td_ta_new_p) (struct ps_prochandle * ps,
88                                 td_thragent_t **ta);
89 static td_err_e (*td_ta_map_id2thr_p) (const td_thragent_t *ta, thread_t pt,
90                                        td_thrhandle_t *__th);
91 static td_err_e (*td_ta_map_lwp2thr_p) (const td_thragent_t *ta,
92                                         lwpid_t lwpid, td_thrhandle_t *th);
93 static td_err_e (*td_ta_thr_iter_p) (const td_thragent_t *ta,
94                                      td_thr_iter_f *callback, void *cbdata_p,
95                                      td_thr_state_e state, int ti_pri,
96                                      sigset_t *ti_sigmask_p,
97                                      unsigned int ti_user_flags);
98 static td_err_e (*td_ta_event_addr_p) (const td_thragent_t *ta,
99                                        td_event_e event, td_notify_t *ptr);
100 static td_err_e (*td_ta_set_event_p) (const td_thragent_t *ta,
101                                       td_thr_events_t *event);
102 static td_err_e (*td_ta_event_getmsg_p) (const td_thragent_t *ta,
103                                          td_event_msg_t *msg);
104
105 static td_err_e (*td_thr_validate_p) (const td_thrhandle_t *th);
106 static td_err_e (*td_thr_get_info_p) (const td_thrhandle_t *th,
107                                       td_thrinfo_t *infop);
108 static td_err_e (*td_thr_event_enable_p) (const td_thrhandle_t *th,
109                                           int event);
110
111 static td_err_e (*td_thr_tls_get_addr_p) (const td_thrhandle_t *th,
112                                           void *map_address,
113                                           size_t offset, void **address);
114
115 /* Location of the thread creation event breakpoint.  The code at this
116    location in the child process will be called by the pthread library
117    whenever a new thread is created.  By setting a special breakpoint
118    at this location, GDB can detect when a new thread is created.  We
119    obtain this location via the td_ta_event_addr call.  */
120 static CORE_ADDR td_create_bp_addr;
121
122 /* Location of the thread death event breakpoint.  */
123 static CORE_ADDR td_death_bp_addr;
124
125 /* Prototypes for local functions.  */
126 static void thread_db_find_new_threads (void);
127 static void attach_thread (ptid_t ptid, const td_thrhandle_t *th_p,
128                            const td_thrinfo_t *ti_p, int verbose);
129 static void detach_thread (ptid_t ptid, int verbose);
130 \f
131
132 /* Building process ids.  */
133
134 #define GET_PID(ptid)           ptid_get_pid (ptid)
135 #define GET_LWP(ptid)           ptid_get_lwp (ptid)
136 #define GET_THREAD(ptid)        ptid_get_tid (ptid)
137
138 #define is_lwp(ptid)            (GET_LWP (ptid) != 0)
139 #define is_thread(ptid)         (GET_THREAD (ptid) != 0)
140
141 #define BUILD_LWP(lwp, pid)     ptid_build (pid, lwp, 0)
142 \f
143
144 /* Use "struct private_thread_info" to cache thread state.  This is
145    a substantial optimization.  */
146
147 struct private_thread_info
148 {
149   /* Flag set when we see a TD_DEATH event for this thread.  */
150   unsigned int dying:1;
151
152   /* Cached thread state.  */
153   unsigned int th_valid:1;
154   unsigned int ti_valid:1;
155
156   td_thrhandle_t th;
157   td_thrinfo_t ti;
158 };
159 \f
160
161 static char *
162 thread_db_err_str (td_err_e err)
163 {
164   static char buf[64];
165
166   switch (err)
167     {
168     case TD_OK:
169       return "generic 'call succeeded'";
170     case TD_ERR:
171       return "generic error";
172     case TD_NOTHR:
173       return "no thread to satisfy query";
174     case TD_NOSV:
175       return "no sync handle to satisfy query";
176     case TD_NOLWP:
177       return "no LWP to satisfy query";
178     case TD_BADPH:
179       return "invalid process handle";
180     case TD_BADTH:
181       return "invalid thread handle";
182     case TD_BADSH:
183       return "invalid synchronization handle";
184     case TD_BADTA:
185       return "invalid thread agent";
186     case TD_BADKEY:
187       return "invalid key";
188     case TD_NOMSG:
189       return "no event message for getmsg";
190     case TD_NOFPREGS:
191       return "FPU register set not available";
192     case TD_NOLIBTHREAD:
193       return "application not linked with libthread";
194     case TD_NOEVENT:
195       return "requested event is not supported";
196     case TD_NOCAPAB:
197       return "capability not available";
198     case TD_DBERR:
199       return "debugger service failed";
200     case TD_NOAPLIC:
201       return "operation not applicable to";
202     case TD_NOTSD:
203       return "no thread-specific data for this thread";
204     case TD_MALLOC:
205       return "malloc failed";
206     case TD_PARTIALREG:
207       return "only part of register set was written/read";
208     case TD_NOXREGS:
209       return "X register set not available for this thread";
210     default:
211       snprintf (buf, sizeof (buf), "unknown thread_db error '%d'", err);
212       return buf;
213     }
214 }
215 \f
216 /* A callback function for td_ta_thr_iter, which we use to map all
217    threads to LWPs.
218
219    THP is a handle to the current thread; if INFOP is not NULL, the
220    struct thread_info associated with this thread is returned in
221    *INFOP.
222
223    If the thread is a zombie, TD_THR_ZOMBIE is returned.  Otherwise,
224    zero is returned to indicate success.  */
225
226 static int
227 thread_get_info_callback (const td_thrhandle_t *thp, void *infop)
228 {
229   td_thrinfo_t ti;
230   td_err_e err;
231   struct thread_info *thread_info;
232   ptid_t thread_ptid;
233
234   err = td_thr_get_info_p (thp, &ti);
235   if (err != TD_OK)
236     error (_("thread_get_info_callback: cannot get thread info: %s"),
237            thread_db_err_str (err));
238
239   /* Fill the cache.  */
240   thread_ptid = ptid_build (GET_PID (inferior_ptid), ti.ti_lid, ti.ti_tid);
241   thread_info = find_thread_pid (thread_ptid);
242
243   /* In the case of a zombie thread, don't continue.  We don't want to
244      attach to it thinking it is a new thread.  */
245   if (ti.ti_state == TD_THR_UNKNOWN || ti.ti_state == TD_THR_ZOMBIE)
246     {
247       if (infop != NULL)
248         *(struct thread_info **) infop = thread_info;
249       if (thread_info != NULL)
250         {
251           memcpy (&thread_info->private->th, thp, sizeof (*thp));
252           thread_info->private->th_valid = 1;
253           memcpy (&thread_info->private->ti, &ti, sizeof (ti));
254           thread_info->private->ti_valid = 1;
255         }
256       return TD_THR_ZOMBIE;
257     }
258
259   if (thread_info == NULL)
260     {
261       /* New thread.  Attach to it now (why wait?).  */
262       attach_thread (thread_ptid, thp, &ti, 1);
263       thread_info = find_thread_pid (thread_ptid);
264       gdb_assert (thread_info != NULL);
265     }
266
267   memcpy (&thread_info->private->th, thp, sizeof (*thp));
268   thread_info->private->th_valid = 1;
269   memcpy (&thread_info->private->ti, &ti, sizeof (ti));
270   thread_info->private->ti_valid = 1;
271
272   if (infop != NULL)
273     *(struct thread_info **) infop = thread_info;
274
275   return 0;
276 }
277
278 /* Accessor functions for the thread_db information, with caching.  */
279
280 static void
281 thread_db_map_id2thr (struct thread_info *thread_info, int fatal)
282 {
283   td_err_e err;
284
285   if (thread_info->private->th_valid)
286     return;
287
288   err = td_ta_map_id2thr_p (thread_agent, GET_THREAD (thread_info->ptid),
289                             &thread_info->private->th);
290   if (err != TD_OK)
291     {
292       if (fatal)
293         error (_("Cannot find thread %ld: %s"),
294                (long) GET_THREAD (thread_info->ptid),
295                thread_db_err_str (err));
296     }
297   else
298     thread_info->private->th_valid = 1;
299 }
300 \f
301 /* Convert between user-level thread ids and LWP ids.  */
302
303 static ptid_t
304 thread_from_lwp (ptid_t ptid)
305 {
306   td_thrhandle_t th;
307   td_err_e err;
308   struct thread_info *thread_info;
309   ptid_t thread_ptid;
310
311   if (GET_LWP (ptid) == 0)
312     ptid = BUILD_LWP (GET_PID (ptid), GET_PID (ptid));
313
314   gdb_assert (is_lwp (ptid));
315
316   err = td_ta_map_lwp2thr_p (thread_agent, GET_LWP (ptid), &th);
317   if (err != TD_OK)
318     error (_("Cannot find user-level thread for LWP %ld: %s"),
319            GET_LWP (ptid), thread_db_err_str (err));
320
321   thread_info = NULL;
322
323   /* Fetch the thread info.  If we get back TD_THR_ZOMBIE, then the
324      event thread has already died.  If another gdb interface has called
325      thread_alive() previously, the thread won't be found on the thread list
326      anymore.  In that case, we don't want to process this ptid anymore
327      to avoid the possibility of later treating it as a newly
328      discovered thread id that we should add to the list.  Thus,
329      we return a -1 ptid which is also how the thread list marks a
330      dead thread.  */
331   if (thread_get_info_callback (&th, &thread_info) == TD_THR_ZOMBIE
332       && thread_info == NULL)
333     return pid_to_ptid (-1);
334
335   gdb_assert (thread_info && thread_info->private->ti_valid);
336
337   return ptid_build (GET_PID (ptid), GET_LWP (ptid),
338                      thread_info->private->ti.ti_tid);
339 }
340
341 static ptid_t
342 lwp_from_thread (ptid_t ptid)
343 {
344   return BUILD_LWP (GET_LWP (ptid), GET_PID (ptid));
345 }
346 \f
347
348 void
349 thread_db_init (struct target_ops *target)
350 {
351   target_beneath = target;
352 }
353
354 static void *
355 verbose_dlsym (void *handle, const char *name)
356 {
357   void *sym = dlsym (handle, name);
358   if (sym == NULL)
359     warning (_("Symbol \"%s\" not found in libthread_db: %s"), name, dlerror ());
360   return sym;
361 }
362
363 static int
364 thread_db_load (void)
365 {
366   void *handle;
367   td_err_e err;
368
369   handle = dlopen (LIBTHREAD_DB_SO, RTLD_NOW);
370   if (handle == NULL)
371     {
372       fprintf_filtered (gdb_stderr, "\n\ndlopen failed on '%s' - %s\n",
373                         LIBTHREAD_DB_SO, dlerror ());
374       fprintf_filtered (gdb_stderr,
375                         "GDB will not be able to debug pthreads.\n\n");
376       return 0;
377     }
378
379   /* Initialize pointers to the dynamic library functions we will use.
380      Essential functions first.  */
381
382   td_init_p = verbose_dlsym (handle, "td_init");
383   if (td_init_p == NULL)
384     return 0;
385
386   td_ta_new_p = verbose_dlsym (handle, "td_ta_new");
387   if (td_ta_new_p == NULL)
388     return 0;
389
390   td_ta_map_id2thr_p = verbose_dlsym (handle, "td_ta_map_id2thr");
391   if (td_ta_map_id2thr_p == NULL)
392     return 0;
393
394   td_ta_map_lwp2thr_p = verbose_dlsym (handle, "td_ta_map_lwp2thr");
395   if (td_ta_map_lwp2thr_p == NULL)
396     return 0;
397
398   td_ta_thr_iter_p = verbose_dlsym (handle, "td_ta_thr_iter");
399   if (td_ta_thr_iter_p == NULL)
400     return 0;
401
402   td_thr_validate_p = verbose_dlsym (handle, "td_thr_validate");
403   if (td_thr_validate_p == NULL)
404     return 0;
405
406   td_thr_get_info_p = verbose_dlsym (handle, "td_thr_get_info");
407   if (td_thr_get_info_p == NULL)
408     return 0;
409
410   /* Initialize the library.  */
411   err = td_init_p ();
412   if (err != TD_OK)
413     {
414       warning (_("Cannot initialize libthread_db: %s"), thread_db_err_str (err));
415       return 0;
416     }
417
418   /* These are not essential.  */
419   td_ta_event_addr_p = dlsym (handle, "td_ta_event_addr");
420   td_ta_set_event_p = dlsym (handle, "td_ta_set_event");
421   td_ta_event_getmsg_p = dlsym (handle, "td_ta_event_getmsg");
422   td_thr_event_enable_p = dlsym (handle, "td_thr_event_enable");
423   td_thr_tls_get_addr_p = dlsym (handle, "td_thr_tls_get_addr");
424
425   return 1;
426 }
427
428 static td_err_e
429 enable_thread_event (td_thragent_t *thread_agent, int event, CORE_ADDR *bp)
430 {
431   td_notify_t notify;
432   td_err_e err;
433
434   /* Get the breakpoint address for thread EVENT.  */
435   err = td_ta_event_addr_p (thread_agent, event, &notify);
436   if (err != TD_OK)
437     return err;
438
439   /* Set up the breakpoint.  */
440   gdb_assert (exec_bfd);
441   (*bp) = (gdbarch_convert_from_func_ptr_addr
442            (current_gdbarch,
443             /* Do proper sign extension for the target.  */
444             (bfd_get_sign_extend_vma (exec_bfd) > 0
445              ? (CORE_ADDR) (intptr_t) notify.u.bptaddr
446              : (CORE_ADDR) (uintptr_t) notify.u.bptaddr),
447             &current_target));
448   create_thread_event_breakpoint ((*bp));
449
450   return TD_OK;
451 }
452
453 static void
454 enable_thread_event_reporting (void)
455 {
456   td_thr_events_t events;
457   td_notify_t notify;
458   td_err_e err;
459 #ifdef HAVE_GNU_LIBC_VERSION_H
460   const char *libc_version;
461   int libc_major, libc_minor;
462 #endif
463
464   /* We cannot use the thread event reporting facility if these
465      functions aren't available.  */
466   if (td_ta_event_addr_p == NULL || td_ta_set_event_p == NULL
467       || td_ta_event_getmsg_p == NULL || td_thr_event_enable_p == NULL)
468     return;
469
470   /* Set the process wide mask saying which events we're interested in.  */
471   td_event_emptyset (&events);
472   td_event_addset (&events, TD_CREATE);
473
474 #ifdef HAVE_GNU_LIBC_VERSION_H
475   /* FIXME: kettenis/2000-04-23: The event reporting facility is
476      broken for TD_DEATH events in glibc 2.1.3, so don't enable it for
477      now.  */
478   libc_version = gnu_get_libc_version ();
479   if (sscanf (libc_version, "%d.%d", &libc_major, &libc_minor) == 2
480       && (libc_major > 2 || (libc_major == 2 && libc_minor > 1)))
481 #endif
482     td_event_addset (&events, TD_DEATH);
483
484   err = td_ta_set_event_p (thread_agent, &events);
485   if (err != TD_OK)
486     {
487       warning (_("Unable to set global thread event mask: %s"),
488                thread_db_err_str (err));
489       return;
490     }
491
492   /* Delete previous thread event breakpoints, if any.  */
493   remove_thread_event_breakpoints ();
494   td_create_bp_addr = 0;
495   td_death_bp_addr = 0;
496
497   /* Set up the thread creation event.  */
498   err = enable_thread_event (thread_agent, TD_CREATE, &td_create_bp_addr);
499   if (err != TD_OK)
500     {
501       warning (_("Unable to get location for thread creation breakpoint: %s"),
502                thread_db_err_str (err));
503       return;
504     }
505
506   /* Set up the thread death event.  */
507   err = enable_thread_event (thread_agent, TD_DEATH, &td_death_bp_addr);
508   if (err != TD_OK)
509     {
510       warning (_("Unable to get location for thread death breakpoint: %s"),
511                thread_db_err_str (err));
512       return;
513     }
514 }
515
516 static void
517 disable_thread_event_reporting (void)
518 {
519   td_thr_events_t events;
520
521   /* Set the process wide mask saying we aren't interested in any
522      events anymore.  */
523   td_event_emptyset (&events);
524   td_ta_set_event_p (thread_agent, &events);
525
526   /* Delete thread event breakpoints, if any.  */
527   remove_thread_event_breakpoints ();
528   td_create_bp_addr = 0;
529   td_death_bp_addr = 0;
530 }
531
532 static void
533 check_thread_signals (void)
534 {
535 #ifdef GET_THREAD_SIGNALS
536   if (!thread_signals)
537     {
538       sigset_t mask;
539       int i;
540
541       GET_THREAD_SIGNALS (&mask);
542       sigemptyset (&thread_stop_set);
543       sigemptyset (&thread_print_set);
544
545       for (i = 1; i < NSIG; i++)
546         {
547           if (sigismember (&mask, i))
548             {
549               if (signal_stop_update (target_signal_from_host (i), 0))
550                 sigaddset (&thread_stop_set, i);
551               if (signal_print_update (target_signal_from_host (i), 0))
552                 sigaddset (&thread_print_set, i);
553               thread_signals = 1;
554             }
555         }
556     }
557 #endif
558 }
559
560 /* Check whether thread_db is usable.  This function is called when
561    an inferior is created (or otherwise acquired, e.g. attached to)
562    and when new shared libraries are loaded into a running process.  */
563
564 void
565 check_for_thread_db (void)
566 {
567   td_err_e err;
568   static int already_loaded;
569
570   /* First time through, report that libthread_db was successfuly
571      loaded.  Can't print this in in thread_db_load as, at that stage,
572      the interpreter and it's console haven't started.  */
573
574   if (!already_loaded)
575     {
576       Dl_info info;
577       const char *library = NULL;
578       if (dladdr ((*td_ta_new_p), &info) != 0)
579         library = info.dli_fname;
580
581       /* Try dlinfo?  */
582
583       if (library == NULL)
584         /* Paranoid - don't let a NULL path slip through.  */
585         library = LIBTHREAD_DB_SO;
586
587       printf_unfiltered (_("Using host libthread_db library \"%s\".\n"),
588                          library);
589       already_loaded = 1;
590     }
591
592   if (using_thread_db)
593     /* Nothing to do.  The thread library was already detected and the
594        target vector was already activated.  */
595     return;
596
597   /* Don't attempt to use thread_db on targets which can not run
598      (executables not running yet, core files) for now.  */
599   if (!target_has_execution)
600     return;
601
602   /* Don't attempt to use thread_db for remote targets.  */
603   if (!target_can_run (&current_target))
604     return;
605
606   /* Initialize the structure that identifies the child process.  */
607   proc_handle.pid = GET_PID (inferior_ptid);
608
609   /* Now attempt to open a connection to the thread library.  */
610   err = td_ta_new_p (&proc_handle, &thread_agent);
611   switch (err)
612     {
613     case TD_NOLIBTHREAD:
614       /* No thread library was detected.  */
615       break;
616
617     case TD_OK:
618       printf_unfiltered (_("[Thread debugging using libthread_db enabled]\n"));
619
620       /* The thread library was detected.  Activate the thread_db target.  */
621       push_target (&thread_db_ops);
622       using_thread_db = 1;
623
624       enable_thread_event_reporting ();
625       thread_db_find_new_threads ();
626       break;
627
628     default:
629       warning (_("Cannot initialize thread debugging library: %s"),
630                thread_db_err_str (err));
631       break;
632     }
633 }
634
635 static void
636 thread_db_new_objfile (struct objfile *objfile)
637 {
638   if (objfile != NULL)
639     check_for_thread_db ();
640
641   if (target_new_objfile_chain)
642     target_new_objfile_chain (objfile);
643 }
644
645 /* Attach to a new thread.  This function is called when we receive a
646    TD_CREATE event or when we iterate over all threads and find one
647    that wasn't already in our list.  */
648
649 static void
650 attach_thread (ptid_t ptid, const td_thrhandle_t *th_p,
651                const td_thrinfo_t *ti_p, int verbose)
652 {
653   struct thread_info *tp;
654   td_err_e err;
655
656   /* If we're being called after a TD_CREATE event, we may already
657      know about this thread.  There are two ways this can happen.  We
658      may have iterated over all threads between the thread creation
659      and the TD_CREATE event, for instance when the user has issued
660      the `info threads' command before the SIGTRAP for hitting the
661      thread creation breakpoint was reported.  Alternatively, the
662      thread may have exited and a new one been created with the same
663      thread ID.  In the first case we don't need to do anything; in
664      the second case we should discard information about the dead
665      thread and attach to the new one.  */
666   if (in_thread_list (ptid))
667     {
668       tp = find_thread_pid (ptid);
669       gdb_assert (tp != NULL);
670
671       if (!tp->private->dying)
672         return;
673
674       delete_thread (ptid);
675     }
676
677   check_thread_signals ();
678
679   /* Add the thread to GDB's thread list.  */
680   tp = add_thread (ptid);
681   tp->private = xmalloc (sizeof (struct private_thread_info));
682   memset (tp->private, 0, sizeof (struct private_thread_info));
683
684   if (verbose)
685     printf_unfiltered (_("[New %s]\n"), target_pid_to_str (ptid));
686
687   if (ti_p->ti_state == TD_THR_UNKNOWN || ti_p->ti_state == TD_THR_ZOMBIE)
688     return;                     /* A zombie thread -- do not attach.  */
689
690   /* Under GNU/Linux, we have to attach to each and every thread.  */
691 #ifdef ATTACH_LWP
692   ATTACH_LWP (BUILD_LWP (ti_p->ti_lid, GET_PID (ptid)), 0);
693 #endif
694
695   /* Enable thread event reporting for this thread.  */
696   err = td_thr_event_enable_p (th_p, 1);
697   if (err != TD_OK)
698     error (_("Cannot enable thread event reporting for %s: %s"),
699            target_pid_to_str (ptid), thread_db_err_str (err));
700 }
701
702 static void
703 thread_db_attach (char *args, int from_tty)
704 {
705   target_beneath->to_attach (args, from_tty);
706
707   /* Destroy thread info; it's no longer valid.  */
708   init_thread_list ();
709
710   /* The child process is now the actual multi-threaded
711      program.  Snatch its process ID...  */
712   proc_handle.pid = GET_PID (inferior_ptid);
713
714   /* ...and perform the remaining initialization steps.  */
715   enable_thread_event_reporting ();
716   thread_db_find_new_threads ();
717 }
718
719 static void
720 detach_thread (ptid_t ptid, int verbose)
721 {
722   struct thread_info *thread_info;
723
724   if (verbose)
725     printf_unfiltered (_("[%s exited]\n"), target_pid_to_str (ptid));
726
727   /* Don't delete the thread now, because it still reports as active
728      until it has executed a few instructions after the event
729      breakpoint - if we deleted it now, "info threads" would cause us
730      to re-attach to it.  Just mark it as having had a TD_DEATH
731      event.  This means that we won't delete it from our thread list
732      until we notice that it's dead (via prune_threads), or until
733      something re-uses its thread ID.  */
734   thread_info = find_thread_pid (ptid);
735   gdb_assert (thread_info != NULL);
736   thread_info->private->dying = 1;
737 }
738
739 static void
740 thread_db_detach (char *args, int from_tty)
741 {
742   disable_thread_event_reporting ();
743
744   /* There's no need to save & restore inferior_ptid here, since the
745      inferior is supposed to be survive this function call.  */
746   inferior_ptid = lwp_from_thread (inferior_ptid);
747
748   /* Forget about the child's process ID.  We shouldn't need it
749      anymore.  */
750   proc_handle.pid = 0;
751
752   target_beneath->to_detach (args, from_tty);
753 }
754
755 static int
756 clear_lwpid_callback (struct thread_info *thread, void *dummy)
757 {
758   /* If we know that our thread implementation is 1-to-1, we could save
759      a certain amount of information; it's not clear how much, so we
760      are always conservative.  */
761
762   thread->private->th_valid = 0;
763   thread->private->ti_valid = 0;
764
765   return 0;
766 }
767
768 static void
769 thread_db_resume (ptid_t ptid, int step, enum target_signal signo)
770 {
771   struct cleanup *old_chain = save_inferior_ptid ();
772
773   if (GET_PID (ptid) == -1)
774     inferior_ptid = lwp_from_thread (inferior_ptid);
775   else if (is_thread (ptid))
776     ptid = lwp_from_thread (ptid);
777
778   /* Clear cached data which may not be valid after the resume.  */
779   iterate_over_threads (clear_lwpid_callback, NULL);
780
781   target_beneath->to_resume (ptid, step, signo);
782
783   do_cleanups (old_chain);
784 }
785
786 /* Check if PID is currently stopped at the location of a thread event
787    breakpoint location.  If it is, read the event message and act upon
788    the event.  */
789
790 static void
791 check_event (ptid_t ptid)
792 {
793   td_event_msg_t msg;
794   td_thrinfo_t ti;
795   td_err_e err;
796   CORE_ADDR stop_pc;
797   int loop = 0;
798
799   /* Bail out early if we're not at a thread event breakpoint.  */
800   stop_pc = read_pc_pid (ptid) - DECR_PC_AFTER_BREAK;
801   if (stop_pc != td_create_bp_addr && stop_pc != td_death_bp_addr)
802     return;
803
804   /* If we are at a create breakpoint, we do not know what new lwp
805      was created and cannot specifically locate the event message for it.
806      We have to call td_ta_event_getmsg() to get
807      the latest message.  Since we have no way of correlating whether
808      the event message we get back corresponds to our breakpoint, we must
809      loop and read all event messages, processing them appropriately.
810      This guarantees we will process the correct message before continuing
811      from the breakpoint.
812
813      Currently, death events are not enabled.  If they are enabled,
814      the death event can use the td_thr_event_getmsg() interface to
815      get the message specifically for that lwp and avoid looping
816      below.  */
817
818   loop = 1;
819
820   do
821     {
822       err = td_ta_event_getmsg_p (thread_agent, &msg);
823       if (err != TD_OK)
824         {
825           if (err == TD_NOMSG)
826             return;
827
828           error (_("Cannot get thread event message: %s"),
829                  thread_db_err_str (err));
830         }
831
832       err = td_thr_get_info_p (msg.th_p, &ti);
833       if (err != TD_OK)
834         error (_("Cannot get thread info: %s"), thread_db_err_str (err));
835
836       ptid = ptid_build (GET_PID (ptid), ti.ti_lid, ti.ti_tid);
837
838       switch (msg.event)
839         {
840         case TD_CREATE:
841           /* Call attach_thread whether or not we already know about a
842              thread with this thread ID.  */
843           attach_thread (ptid, msg.th_p, &ti, 1);
844
845           break;
846
847         case TD_DEATH:
848
849           if (!in_thread_list (ptid))
850             error (_("Spurious thread death event."));
851
852           detach_thread (ptid, 1);
853
854           break;
855
856         default:
857           error (_("Spurious thread event."));
858         }
859     }
860   while (loop);
861 }
862
863 static ptid_t
864 thread_db_wait (ptid_t ptid, struct target_waitstatus *ourstatus)
865 {
866   extern ptid_t trap_ptid;
867
868   if (GET_PID (ptid) != -1 && is_thread (ptid))
869     ptid = lwp_from_thread (ptid);
870
871   ptid = target_beneath->to_wait (ptid, ourstatus);
872
873   if (proc_handle.pid == 0)
874     /* The current child process isn't the actual multi-threaded
875        program yet, so don't try to do any special thread-specific
876        post-processing and bail out early.  */
877     return ptid;
878
879   if (ourstatus->kind == TARGET_WAITKIND_EXITED
880     || ourstatus->kind == TARGET_WAITKIND_SIGNALLED)
881     return pid_to_ptid (-1);
882
883   if (ourstatus->kind == TARGET_WAITKIND_EXECD)
884     {
885       remove_thread_event_breakpoints ();
886       unpush_target (&thread_db_ops);
887       using_thread_db = 0;
888
889       return pid_to_ptid (GET_PID (ptid));
890     }
891
892   if (ourstatus->kind == TARGET_WAITKIND_STOPPED
893       && ourstatus->value.sig == TARGET_SIGNAL_TRAP)
894     /* Check for a thread event.  */
895     check_event (ptid);
896
897   if (!ptid_equal (trap_ptid, null_ptid))
898     trap_ptid = thread_from_lwp (trap_ptid);
899
900   /* Change the ptid back into the higher level PID + TID format.
901      If the thread is dead and no longer on the thread list, we will 
902      get back a dead ptid.  This can occur if the thread death event
903      gets postponed by other simultaneous events.  In such a case, 
904      we want to just ignore the event and continue on.  */
905   ptid = thread_from_lwp (ptid);
906   if (GET_PID (ptid) == -1)
907     ourstatus->kind = TARGET_WAITKIND_SPURIOUS;
908   
909   return ptid;
910 }
911
912 static LONGEST
913 thread_db_xfer_partial (struct target_ops *ops, enum target_object object,
914                         const char *annex, gdb_byte *readbuf,
915                         const gdb_byte *writebuf, ULONGEST offset, LONGEST len)
916 {
917   struct cleanup *old_chain = save_inferior_ptid ();
918   LONGEST xfer;
919
920   if (is_thread (inferior_ptid))
921     {
922       /* FIXME: This seems to be necessary to make sure breakpoints
923          are removed.  */
924       if (!target_thread_alive (inferior_ptid))
925         inferior_ptid = pid_to_ptid (GET_PID (inferior_ptid));
926       else
927         inferior_ptid = lwp_from_thread (inferior_ptid);
928     }
929
930   xfer = target_beneath->to_xfer_partial (ops, object, annex,
931                                           readbuf, writebuf, offset, len);
932
933   do_cleanups (old_chain);
934   return xfer;
935 }
936
937 static void
938 thread_db_kill (void)
939 {
940   /* There's no need to save & restore inferior_ptid here, since the
941      inferior isn't supposed to survive this function call.  */
942   inferior_ptid = lwp_from_thread (inferior_ptid);
943   target_beneath->to_kill ();
944 }
945
946 static void
947 thread_db_create_inferior (char *exec_file, char *allargs, char **env,
948                            int from_tty)
949 {
950   unpush_target (&thread_db_ops);
951   using_thread_db = 0;
952   target_beneath->to_create_inferior (exec_file, allargs, env, from_tty);
953 }
954
955 static void
956 thread_db_post_startup_inferior (ptid_t ptid)
957 {
958   if (proc_handle.pid == 0)
959     {
960       /* The child process is now the actual multi-threaded
961          program.  Snatch its process ID...  */
962       proc_handle.pid = GET_PID (ptid);
963
964       /* ...and perform the remaining initialization steps.  */
965       enable_thread_event_reporting ();
966       thread_db_find_new_threads ();
967     }
968 }
969
970 static void
971 thread_db_mourn_inferior (void)
972 {
973   /* Forget about the child's process ID.  We shouldn't need it
974      anymore.  */
975   proc_handle.pid = 0;
976
977   target_beneath->to_mourn_inferior ();
978
979   /* Delete the old thread event breakpoints.  Do this after mourning
980      the inferior, so that we don't try to uninsert them.  */
981   remove_thread_event_breakpoints ();
982
983   /* Detach thread_db target ops.  */
984   unpush_target (&thread_db_ops);
985   using_thread_db = 0;
986 }
987
988 static int
989 find_new_threads_callback (const td_thrhandle_t *th_p, void *data)
990 {
991   td_thrinfo_t ti;
992   td_err_e err;
993   ptid_t ptid;
994
995   err = td_thr_get_info_p (th_p, &ti);
996   if (err != TD_OK)
997     error (_("find_new_threads_callback: cannot get thread info: %s"),
998            thread_db_err_str (err));
999
1000   if (ti.ti_state == TD_THR_UNKNOWN || ti.ti_state == TD_THR_ZOMBIE)
1001     return 0;                   /* A zombie -- ignore.  */
1002
1003   ptid = ptid_build (GET_PID (inferior_ptid), ti.ti_lid, ti.ti_tid);
1004
1005   if (!in_thread_list (ptid))
1006     attach_thread (ptid, th_p, &ti, 1);
1007
1008   return 0;
1009 }
1010
1011 static void
1012 thread_db_find_new_threads (void)
1013 {
1014   td_err_e err;
1015
1016   /* Iterate over all user-space threads to discover new threads.  */
1017   err = td_ta_thr_iter_p (thread_agent, find_new_threads_callback, NULL,
1018                           TD_THR_ANY_STATE, TD_THR_LOWEST_PRIORITY,
1019                           TD_SIGNO_MASK, TD_THR_ANY_USER_FLAGS);
1020   if (err != TD_OK)
1021     error (_("Cannot find new threads: %s"), thread_db_err_str (err));
1022 }
1023
1024 static char *
1025 thread_db_pid_to_str (ptid_t ptid)
1026 {
1027   if (is_thread (ptid))
1028     {
1029       static char buf[64];
1030       struct thread_info *thread_info;
1031
1032       thread_info = find_thread_pid (ptid);
1033       if (thread_info == NULL)
1034         snprintf (buf, sizeof (buf), "Thread %ld (LWP %ld) (Missing)",
1035                   GET_THREAD (ptid), GET_LWP (ptid));
1036       else
1037         snprintf (buf, sizeof (buf), "Thread %ld (LWP %ld)",
1038                   GET_THREAD (ptid), GET_LWP (ptid));
1039
1040       return buf;
1041     }
1042
1043   if (target_beneath->to_pid_to_str (ptid))
1044     return target_beneath->to_pid_to_str (ptid);
1045
1046   return normal_pid_to_str (ptid);
1047 }
1048
1049 /* Return a string describing the state of the thread specified by
1050    INFO.  */
1051
1052 static char *
1053 thread_db_extra_thread_info (struct thread_info *info)
1054 {
1055   if (info->private->dying)
1056     return "Exiting";
1057
1058   return NULL;
1059 }
1060
1061 /* Get the address of the thread local variable in load module LM which
1062    is stored at OFFSET within the thread local storage for thread PTID.  */
1063
1064 static CORE_ADDR
1065 thread_db_get_thread_local_address (ptid_t ptid,
1066                                     CORE_ADDR lm,
1067                                     CORE_ADDR offset)
1068 {
1069   if (is_thread (ptid))
1070     {
1071       td_err_e err;
1072       void *address;
1073       struct thread_info *thread_info;
1074
1075       /* glibc doesn't provide the needed interface.  */
1076       if (!td_thr_tls_get_addr_p)
1077         throw_error (TLS_NO_LIBRARY_SUPPORT_ERROR,
1078                      _("No TLS library support"));
1079
1080       /* Caller should have verified that lm != 0.  */
1081       gdb_assert (lm != 0);
1082
1083       /* Get info about the thread.  */
1084       thread_info = find_thread_pid (ptid);
1085       thread_db_map_id2thr (thread_info, 1);
1086
1087       /* Finally, get the address of the variable.  */
1088       err = td_thr_tls_get_addr_p (&thread_info->private->th,
1089                                    (void *)(size_t) lm,
1090                                    offset, &address);
1091
1092 #ifdef THREAD_DB_HAS_TD_NOTALLOC
1093       /* The memory hasn't been allocated, yet.  */
1094       if (err == TD_NOTALLOC)
1095           /* Now, if libthread_db provided the initialization image's
1096              address, we *could* try to build a non-lvalue value from
1097              the initialization image.  */
1098         throw_error (TLS_NOT_ALLOCATED_YET_ERROR,
1099                      _("TLS not allocated yet"));
1100 #endif
1101
1102       /* Something else went wrong.  */
1103       if (err != TD_OK)
1104         throw_error (TLS_GENERIC_ERROR,
1105                      (("%s")), thread_db_err_str (err));
1106
1107       /* Cast assuming host == target.  Joy.  */
1108       /* Do proper sign extension for the target.  */
1109       gdb_assert (exec_bfd);
1110       return (bfd_get_sign_extend_vma (exec_bfd) > 0
1111               ? (CORE_ADDR) (intptr_t) address
1112               : (CORE_ADDR) (uintptr_t) address);
1113     }
1114
1115   if (target_beneath->to_get_thread_local_address)
1116     return target_beneath->to_get_thread_local_address (ptid, lm, offset);
1117   else
1118     throw_error (TLS_GENERIC_ERROR,
1119                  _("TLS not supported on this target"));
1120 }
1121
1122 static void
1123 init_thread_db_ops (void)
1124 {
1125   thread_db_ops.to_shortname = "multi-thread";
1126   thread_db_ops.to_longname = "multi-threaded child process.";
1127   thread_db_ops.to_doc = "Threads and pthreads support.";
1128   thread_db_ops.to_attach = thread_db_attach;
1129   thread_db_ops.to_detach = thread_db_detach;
1130   thread_db_ops.to_resume = thread_db_resume;
1131   thread_db_ops.to_wait = thread_db_wait;
1132   thread_db_ops.to_xfer_partial = thread_db_xfer_partial;
1133   thread_db_ops.to_kill = thread_db_kill;
1134   thread_db_ops.to_create_inferior = thread_db_create_inferior;
1135   thread_db_ops.to_post_startup_inferior = thread_db_post_startup_inferior;
1136   thread_db_ops.to_mourn_inferior = thread_db_mourn_inferior;
1137   thread_db_ops.to_find_new_threads = thread_db_find_new_threads;
1138   thread_db_ops.to_pid_to_str = thread_db_pid_to_str;
1139   thread_db_ops.to_stratum = thread_stratum;
1140   thread_db_ops.to_has_thread_control = tc_schedlock;
1141   thread_db_ops.to_get_thread_local_address
1142     = thread_db_get_thread_local_address;
1143   thread_db_ops.to_extra_thread_info = thread_db_extra_thread_info;
1144   thread_db_ops.to_magic = OPS_MAGIC;
1145 }
1146
1147 void
1148 _initialize_thread_db (void)
1149 {
1150   /* Only initialize the module if we can load libthread_db.  */
1151   if (thread_db_load ())
1152     {
1153       init_thread_db_ops ();
1154       add_target (&thread_db_ops);
1155
1156       /* Add ourselves to objfile event chain.  */
1157       target_new_objfile_chain = deprecated_target_new_objfile_hook;
1158       deprecated_target_new_objfile_hook = thread_db_new_objfile;
1159     }
1160 }