1 /* libthread_db assisted debugging support, generic parts.
3 Copyright 1999, 2000, 2001, 2003, 2004 Free Software Foundation, Inc.
5 This file is part of GDB.
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2 of the License, or
10 (at your option) any later version.
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with this program; if not, write to the Free Software
19 Foundation, Inc., 59 Temple Place - Suite 330,
20 Boston, MA 02111-1307, USA. */
24 #include "gdb_assert.h"
26 #include "gdb_proc_service.h"
27 #include "gdb_thread_db.h"
30 #include "gdbthread.h"
36 #include "solib-svr4.h"
38 #ifdef HAVE_GNU_LIBC_VERSION_H
39 #include <gnu/libc-version.h>
42 #ifndef LIBTHREAD_DB_SO
43 #define LIBTHREAD_DB_SO "libthread_db.so.1"
46 /* If we're running on GNU/Linux, we must explicitly attach to any new
49 /* FIXME: There is certainly some room for improvements:
51 - Bypass libthread_db when fetching or storing registers for
52 threads bound to a LWP. */
54 /* This module's target vector. */
55 static struct target_ops thread_db_ops
;
57 /* The target vector that we call for things this module can't handle. */
58 static struct target_ops
*target_beneath
;
60 /* Pointer to the next function on the objfile event chain. */
61 static void (*target_new_objfile_chain
) (struct objfile
* objfile
);
63 /* Non-zero if we're using this module's target vector. */
64 static int using_thread_db
;
66 /* Non-zero if we have to keep this module's target vector active
68 static int keep_thread_db
;
70 /* Non-zero if we have determined the signals used by the threads
72 static int thread_signals
;
73 static sigset_t thread_stop_set
;
74 static sigset_t thread_print_set
;
76 /* Structure that identifies the child process for the
77 <proc_service.h> interface. */
78 static struct ps_prochandle proc_handle
;
80 /* Connection to the libthread_db library. */
81 static td_thragent_t
*thread_agent
;
83 /* Pointers to the libthread_db functions. */
85 static td_err_e (*td_init_p
) (void);
87 static td_err_e (*td_ta_new_p
) (struct ps_prochandle
* ps
,
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
);
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_getfpregs_p
) (const td_thrhandle_t
*th
,
109 gdb_prfpregset_t
*regset
);
110 static td_err_e (*td_thr_getgregs_p
) (const td_thrhandle_t
*th
,
112 static td_err_e (*td_thr_setfpregs_p
) (const td_thrhandle_t
*th
,
113 const gdb_prfpregset_t
*fpregs
);
114 static td_err_e (*td_thr_setgregs_p
) (const td_thrhandle_t
*th
,
116 static td_err_e (*td_thr_event_enable_p
) (const td_thrhandle_t
*th
,
119 static td_err_e (*td_thr_tls_get_addr_p
) (const td_thrhandle_t
*th
,
121 size_t offset
, void **address
);
123 /* Location of the thread creation event breakpoint. The code at this
124 location in the child process will be called by the pthread library
125 whenever a new thread is created. By setting a special breakpoint
126 at this location, GDB can detect when a new thread is created. We
127 obtain this location via the td_ta_event_addr call. */
128 static CORE_ADDR td_create_bp_addr
;
130 /* Location of the thread death event breakpoint. */
131 static CORE_ADDR td_death_bp_addr
;
133 /* Prototypes for local functions. */
134 static void thread_db_find_new_threads (void);
135 static void attach_thread (ptid_t ptid
, const td_thrhandle_t
*th_p
,
136 const td_thrinfo_t
*ti_p
, int verbose
);
137 static void detach_thread (ptid_t ptid
, int verbose
);
140 /* Building process ids. */
142 #define GET_PID(ptid) ptid_get_pid (ptid)
143 #define GET_LWP(ptid) ptid_get_lwp (ptid)
144 #define GET_THREAD(ptid) ptid_get_tid (ptid)
146 #define is_lwp(ptid) (GET_LWP (ptid) != 0)
147 #define is_thread(ptid) (GET_THREAD (ptid) != 0)
149 #define BUILD_LWP(lwp, pid) ptid_build (pid, lwp, 0)
150 #define BUILD_THREAD(tid, pid) ptid_build (pid, 0, tid)
153 /* Use "struct private_thread_info" to cache thread state. This is
154 a substantial optimization. */
156 struct private_thread_info
158 /* Flag set when we see a TD_DEATH event for this thread. */
159 unsigned int dying
:1;
161 /* Cached thread state. */
162 unsigned int th_valid
:1;
163 unsigned int ti_valid
:1;
171 thread_db_err_str (td_err_e err
)
178 return "generic 'call succeeded'";
180 return "generic error";
182 return "no thread to satisfy query";
184 return "no sync handle to satisfy query";
186 return "no LWP to satisfy query";
188 return "invalid process handle";
190 return "invalid thread handle";
192 return "invalid synchronization handle";
194 return "invalid thread agent";
196 return "invalid key";
198 return "no event message for getmsg";
200 return "FPU register set not available";
202 return "application not linked with libthread";
204 return "requested event is not supported";
206 return "capability not available";
208 return "debugger service failed";
210 return "operation not applicable to";
212 return "no thread-specific data for this thread";
214 return "malloc failed";
216 return "only part of register set was written/read";
218 return "X register set not available for this thread";
220 snprintf (buf
, sizeof (buf
), "unknown thread_db error '%d'", err
);
226 thread_db_state_str (td_thr_state_e state
)
233 return "stopped by debugger";
242 case TD_THR_STOPPED_ASLEEP
:
243 return "stopped by debugger AND blocked";
245 snprintf (buf
, sizeof (buf
), "unknown thread_db state %d", state
);
250 /* A callback function for td_ta_thr_iter, which we use to map all
253 THP is a handle to the current thread; if INFOP is not NULL, the
254 struct thread_info associated with this thread is returned in
257 If the thread is a zombie, TD_THR_ZOMBIE is returned. Otherwise,
258 zero is returned to indicate success. */
261 thread_get_info_callback (const td_thrhandle_t
*thp
, void *infop
)
265 struct thread_info
*thread_info
;
268 err
= td_thr_get_info_p (thp
, &ti
);
270 error ("thread_get_info_callback: cannot get thread info: %s",
271 thread_db_err_str (err
));
273 /* Fill the cache. */
274 thread_ptid
= BUILD_THREAD (ti
.ti_tid
, GET_PID (inferior_ptid
));
275 thread_info
= find_thread_pid (thread_ptid
);
277 /* In the case of a zombie thread, don't continue. We don't want to
278 attach to it thinking it is a new thread. */
279 if (ti
.ti_state
== TD_THR_UNKNOWN
|| ti
.ti_state
== TD_THR_ZOMBIE
)
282 *(struct thread_info
**) infop
= thread_info
;
283 if (thread_info
!= NULL
)
285 memcpy (&thread_info
->private->th
, thp
, sizeof (*thp
));
286 thread_info
->private->th_valid
= 1;
287 memcpy (&thread_info
->private->ti
, &ti
, sizeof (ti
));
288 thread_info
->private->ti_valid
= 1;
290 return TD_THR_ZOMBIE
;
293 if (thread_info
== NULL
)
295 /* New thread. Attach to it now (why wait?). */
296 attach_thread (thread_ptid
, thp
, &ti
, 1);
297 thread_info
= find_thread_pid (thread_ptid
);
298 gdb_assert (thread_info
!= NULL
);
301 memcpy (&thread_info
->private->th
, thp
, sizeof (*thp
));
302 thread_info
->private->th_valid
= 1;
303 memcpy (&thread_info
->private->ti
, &ti
, sizeof (ti
));
304 thread_info
->private->ti_valid
= 1;
307 *(struct thread_info
**) infop
= thread_info
;
312 /* Accessor functions for the thread_db information, with caching. */
315 thread_db_map_id2thr (struct thread_info
*thread_info
, int fatal
)
319 if (thread_info
->private->th_valid
)
322 err
= td_ta_map_id2thr_p (thread_agent
, GET_THREAD (thread_info
->ptid
),
323 &thread_info
->private->th
);
327 error ("Cannot find thread %ld: %s",
328 (long) GET_THREAD (thread_info
->ptid
),
329 thread_db_err_str (err
));
332 thread_info
->private->th_valid
= 1;
335 static td_thrinfo_t
*
336 thread_db_get_info (struct thread_info
*thread_info
)
340 if (thread_info
->private->ti_valid
)
341 return &thread_info
->private->ti
;
343 if (!thread_info
->private->th_valid
)
344 thread_db_map_id2thr (thread_info
, 1);
347 td_thr_get_info_p (&thread_info
->private->th
, &thread_info
->private->ti
);
349 error ("thread_db_get_info: cannot get thread info: %s",
350 thread_db_err_str (err
));
352 thread_info
->private->ti_valid
= 1;
353 return &thread_info
->private->ti
;
356 /* Convert between user-level thread ids and LWP ids. */
359 thread_from_lwp (ptid_t ptid
)
363 struct thread_info
*thread_info
;
366 if (GET_LWP (ptid
) == 0)
367 ptid
= BUILD_LWP (GET_PID (ptid
), GET_PID (ptid
));
369 gdb_assert (is_lwp (ptid
));
371 err
= td_ta_map_lwp2thr_p (thread_agent
, GET_LWP (ptid
), &th
);
373 error ("Cannot find user-level thread for LWP %ld: %s",
374 GET_LWP (ptid
), thread_db_err_str (err
));
378 /* Fetch the thread info. If we get back TD_THR_ZOMBIE, then the
379 event thread has already died. If another gdb interface has called
380 thread_alive() previously, the thread won't be found on the thread list
381 anymore. In that case, we don't want to process this ptid anymore
382 to avoid the possibility of later treating it as a newly
383 discovered thread id that we should add to the list. Thus,
384 we return a -1 ptid which is also how the thread list marks a
386 if (thread_get_info_callback (&th
, &thread_info
) == TD_THR_ZOMBIE
387 && thread_info
== NULL
)
388 return pid_to_ptid (-1);
390 gdb_assert (thread_info
&& thread_info
->private->ti_valid
);
392 return BUILD_THREAD (thread_info
->private->ti
.ti_tid
, GET_PID (ptid
));
396 lwp_from_thread (ptid_t ptid
)
398 struct thread_info
*thread_info
;
401 if (!is_thread (ptid
))
404 thread_info
= find_thread_pid (ptid
);
405 thread_db_get_info (thread_info
);
407 return BUILD_LWP (thread_info
->private->ti
.ti_lid
, GET_PID (ptid
));
412 thread_db_init (struct target_ops
*target
)
414 target_beneath
= target
;
418 verbose_dlsym (void *handle
, const char *name
)
420 void *sym
= dlsym (handle
, name
);
422 warning ("Symbol \"%s\" not found in libthread_db: %s", name
, dlerror ());
427 thread_db_load (void)
432 handle
= dlopen (LIBTHREAD_DB_SO
, RTLD_NOW
);
435 fprintf_filtered (gdb_stderr
, "\n\ndlopen failed on '%s' - %s\n",
436 LIBTHREAD_DB_SO
, dlerror ());
437 fprintf_filtered (gdb_stderr
,
438 "GDB will not be able to debug pthreads.\n\n");
442 /* Initialize pointers to the dynamic library functions we will use.
443 Essential functions first. */
445 td_init_p
= verbose_dlsym (handle
, "td_init");
446 if (td_init_p
== NULL
)
449 td_ta_new_p
= verbose_dlsym (handle
, "td_ta_new");
450 if (td_ta_new_p
== NULL
)
453 td_ta_map_id2thr_p
= verbose_dlsym (handle
, "td_ta_map_id2thr");
454 if (td_ta_map_id2thr_p
== NULL
)
457 td_ta_map_lwp2thr_p
= verbose_dlsym (handle
, "td_ta_map_lwp2thr");
458 if (td_ta_map_lwp2thr_p
== NULL
)
461 td_ta_thr_iter_p
= verbose_dlsym (handle
, "td_ta_thr_iter");
462 if (td_ta_thr_iter_p
== NULL
)
465 td_thr_validate_p
= verbose_dlsym (handle
, "td_thr_validate");
466 if (td_thr_validate_p
== NULL
)
469 td_thr_get_info_p
= verbose_dlsym (handle
, "td_thr_get_info");
470 if (td_thr_get_info_p
== NULL
)
473 td_thr_getfpregs_p
= verbose_dlsym (handle
, "td_thr_getfpregs");
474 if (td_thr_getfpregs_p
== NULL
)
477 td_thr_getgregs_p
= verbose_dlsym (handle
, "td_thr_getgregs");
478 if (td_thr_getgregs_p
== NULL
)
481 td_thr_setfpregs_p
= verbose_dlsym (handle
, "td_thr_setfpregs");
482 if (td_thr_setfpregs_p
== NULL
)
485 td_thr_setgregs_p
= verbose_dlsym (handle
, "td_thr_setgregs");
486 if (td_thr_setgregs_p
== NULL
)
489 /* Initialize the library. */
493 warning ("Cannot initialize libthread_db: %s", thread_db_err_str (err
));
497 /* These are not essential. */
498 td_ta_event_addr_p
= dlsym (handle
, "td_ta_event_addr");
499 td_ta_set_event_p
= dlsym (handle
, "td_ta_set_event");
500 td_ta_event_getmsg_p
= dlsym (handle
, "td_ta_event_getmsg");
501 td_thr_event_enable_p
= dlsym (handle
, "td_thr_event_enable");
502 td_thr_tls_get_addr_p
= dlsym (handle
, "td_thr_tls_get_addr");
508 enable_thread_event (td_thragent_t
*thread_agent
, int event
, CORE_ADDR
*bp
)
513 /* Get the breakpoint address for thread EVENT. */
514 err
= td_ta_event_addr_p (thread_agent
, event
, ¬ify
);
518 /* Set up the breakpoint. */
519 (*bp
) = gdbarch_convert_from_func_ptr_addr (current_gdbarch
,
520 (CORE_ADDR
) notify
.u
.bptaddr
,
522 create_thread_event_breakpoint ((*bp
));
528 enable_thread_event_reporting (void)
530 td_thr_events_t events
;
533 #ifdef HAVE_GNU_LIBC_VERSION_H
534 const char *libc_version
;
535 int libc_major
, libc_minor
;
538 /* We cannot use the thread event reporting facility if these
539 functions aren't available. */
540 if (td_ta_event_addr_p
== NULL
|| td_ta_set_event_p
== NULL
541 || td_ta_event_getmsg_p
== NULL
|| td_thr_event_enable_p
== NULL
)
544 /* Set the process wide mask saying which events we're interested in. */
545 td_event_emptyset (&events
);
546 td_event_addset (&events
, TD_CREATE
);
548 #ifdef HAVE_GNU_LIBC_VERSION_H
549 /* FIXME: kettenis/2000-04-23: The event reporting facility is
550 broken for TD_DEATH events in glibc 2.1.3, so don't enable it for
552 libc_version
= gnu_get_libc_version ();
553 if (sscanf (libc_version
, "%d.%d", &libc_major
, &libc_minor
) == 2
554 && (libc_major
> 2 || (libc_major
== 2 && libc_minor
> 1)))
556 td_event_addset (&events
, TD_DEATH
);
558 err
= td_ta_set_event_p (thread_agent
, &events
);
561 warning ("Unable to set global thread event mask: %s",
562 thread_db_err_str (err
));
566 /* Delete previous thread event breakpoints, if any. */
567 remove_thread_event_breakpoints ();
568 td_create_bp_addr
= 0;
569 td_death_bp_addr
= 0;
571 /* Set up the thread creation event. */
572 err
= enable_thread_event (thread_agent
, TD_CREATE
, &td_create_bp_addr
);
575 warning ("Unable to get location for thread creation breakpoint: %s",
576 thread_db_err_str (err
));
580 /* Set up the thread death event. */
581 err
= enable_thread_event (thread_agent
, TD_DEATH
, &td_death_bp_addr
);
584 warning ("Unable to get location for thread death breakpoint: %s",
585 thread_db_err_str (err
));
591 disable_thread_event_reporting (void)
593 td_thr_events_t events
;
595 /* Set the process wide mask saying we aren't interested in any
597 td_event_emptyset (&events
);
598 td_ta_set_event_p (thread_agent
, &events
);
600 /* Delete thread event breakpoints, if any. */
601 remove_thread_event_breakpoints ();
602 td_create_bp_addr
= 0;
603 td_death_bp_addr
= 0;
607 check_thread_signals (void)
609 #ifdef GET_THREAD_SIGNALS
615 GET_THREAD_SIGNALS (&mask
);
616 sigemptyset (&thread_stop_set
);
617 sigemptyset (&thread_print_set
);
619 for (i
= 1; i
< NSIG
; i
++)
621 if (sigismember (&mask
, i
))
623 if (signal_stop_update (target_signal_from_host (i
), 0))
624 sigaddset (&thread_stop_set
, i
);
625 if (signal_print_update (target_signal_from_host (i
), 0))
626 sigaddset (&thread_print_set
, i
);
635 thread_db_new_objfile (struct objfile
*objfile
)
639 /* First time through, report that libthread_db was successfuly
640 loaded. Can't print this in in thread_db_load as, at that stage,
641 the interpreter and it's console haven't started. The real
642 problem here is that libthread_db is loaded too early - it should
643 only be loaded when there is a program to debug. */
649 const char *library
= NULL
;
651 if (dladdr ((*td_ta_new_p
), &info
) != 0)
652 library
= info
.dli_fname
;
655 /* Paranoid - don't let a NULL path slip through. */
656 library
= LIBTHREAD_DB_SO
;
657 printf_unfiltered ("Using host libthread_db library \"%s\".\n",
663 /* Don't attempt to use thread_db on targets which can not run
665 if (objfile
== NULL
|| !target_has_execution
)
667 /* All symbols have been discarded. If the thread_db target is
668 active, deactivate it now. */
671 gdb_assert (proc_handle
.pid
== 0);
672 unpush_target (&thread_db_ops
);
682 /* Nothing to do. The thread library was already detected and the
683 target vector was already activated. */
686 /* Initialize the structure that identifies the child process. Note
687 that at this point there is no guarantee that we actually have a
689 proc_handle
.pid
= GET_PID (inferior_ptid
);
691 /* Now attempt to open a connection to the thread library. */
692 err
= td_ta_new_p (&proc_handle
, &thread_agent
);
696 /* No thread library was detected. */
700 printf_unfiltered ("[Thread debugging using libthread_db enabled]\n");
702 /* The thread library was detected. Activate the thread_db target. */
703 push_target (&thread_db_ops
);
706 /* If the thread library was detected in the main symbol file
707 itself, we assume that the program was statically linked
708 against the thread library and well have to keep this
709 module's target vector activated until forever... Well, at
710 least until all symbols have been discarded anyway (see
712 if (objfile
== symfile_objfile
)
714 gdb_assert (proc_handle
.pid
== 0);
718 /* We can only poke around if there actually is a child process.
719 If there is no child process alive, postpone the steps below
720 until one has been created. */
721 if (proc_handle
.pid
!= 0)
723 enable_thread_event_reporting ();
724 thread_db_find_new_threads ();
729 warning ("Cannot initialize thread debugging library: %s",
730 thread_db_err_str (err
));
735 if (target_new_objfile_chain
)
736 target_new_objfile_chain (objfile
);
739 /* Attach to a new thread. This function is called when we receive a
740 TD_CREATE event or when we iterate over all threads and find one
741 that wasn't already in our list. */
744 attach_thread (ptid_t ptid
, const td_thrhandle_t
*th_p
,
745 const td_thrinfo_t
*ti_p
, int verbose
)
747 struct thread_info
*tp
;
750 /* If we're being called after a TD_CREATE event, we may already
751 know about this thread. There are two ways this can happen. We
752 may have iterated over all threads between the thread creation
753 and the TD_CREATE event, for instance when the user has issued
754 the `info threads' command before the SIGTRAP for hitting the
755 thread creation breakpoint was reported. Alternatively, the
756 thread may have exited and a new one been created with the same
757 thread ID. In the first case we don't need to do anything; in
758 the second case we should discard information about the dead
759 thread and attach to the new one. */
760 if (in_thread_list (ptid
))
762 tp
= find_thread_pid (ptid
);
763 gdb_assert (tp
!= NULL
);
765 if (!tp
->private->dying
)
768 delete_thread (ptid
);
771 check_thread_signals ();
773 /* Add the thread to GDB's thread list. */
774 tp
= add_thread (ptid
);
775 tp
->private = xmalloc (sizeof (struct private_thread_info
));
776 memset (tp
->private, 0, sizeof (struct private_thread_info
));
779 printf_unfiltered ("[New %s]\n", target_pid_to_str (ptid
));
781 if (ti_p
->ti_state
== TD_THR_UNKNOWN
|| ti_p
->ti_state
== TD_THR_ZOMBIE
)
782 return; /* A zombie thread -- do not attach. */
784 /* Under GNU/Linux, we have to attach to each and every thread. */
786 ATTACH_LWP (BUILD_LWP (ti_p
->ti_lid
, GET_PID (ptid
)), 0);
789 /* Enable thread event reporting for this thread. */
790 err
= td_thr_event_enable_p (th_p
, 1);
792 error ("Cannot enable thread event reporting for %s: %s",
793 target_pid_to_str (ptid
), thread_db_err_str (err
));
797 thread_db_attach (char *args
, int from_tty
)
799 target_beneath
->to_attach (args
, from_tty
);
801 /* Destroy thread info; it's no longer valid. */
804 /* The child process is now the actual multi-threaded
805 program. Snatch its process ID... */
806 proc_handle
.pid
= GET_PID (inferior_ptid
);
808 /* ...and perform the remaining initialization steps. */
809 enable_thread_event_reporting ();
810 thread_db_find_new_threads ();
814 detach_thread (ptid_t ptid
, int verbose
)
816 struct thread_info
*thread_info
;
819 printf_unfiltered ("[%s exited]\n", target_pid_to_str (ptid
));
821 /* Don't delete the thread now, because it still reports as active
822 until it has executed a few instructions after the event
823 breakpoint - if we deleted it now, "info threads" would cause us
824 to re-attach to it. Just mark it as having had a TD_DEATH
825 event. This means that we won't delete it from our thread list
826 until we notice that it's dead (via prune_threads), or until
827 something re-uses its thread ID. */
828 thread_info
= find_thread_pid (ptid
);
829 gdb_assert (thread_info
!= NULL
);
830 thread_info
->private->dying
= 1;
834 thread_db_detach (char *args
, int from_tty
)
836 disable_thread_event_reporting ();
838 /* There's no need to save & restore inferior_ptid here, since the
839 inferior is supposed to be survive this function call. */
840 inferior_ptid
= lwp_from_thread (inferior_ptid
);
842 /* Forget about the child's process ID. We shouldn't need it
846 target_beneath
->to_detach (args
, from_tty
);
850 clear_lwpid_callback (struct thread_info
*thread
, void *dummy
)
852 /* If we know that our thread implementation is 1-to-1, we could save
853 a certain amount of information; it's not clear how much, so we
854 are always conservative. */
856 thread
->private->th_valid
= 0;
857 thread
->private->ti_valid
= 0;
863 thread_db_resume (ptid_t ptid
, int step
, enum target_signal signo
)
865 struct cleanup
*old_chain
= save_inferior_ptid ();
867 if (GET_PID (ptid
) == -1)
868 inferior_ptid
= lwp_from_thread (inferior_ptid
);
869 else if (is_thread (ptid
))
870 ptid
= lwp_from_thread (ptid
);
872 /* Clear cached data which may not be valid after the resume. */
873 iterate_over_threads (clear_lwpid_callback
, NULL
);
875 target_beneath
->to_resume (ptid
, step
, signo
);
877 do_cleanups (old_chain
);
880 /* Check if PID is currently stopped at the location of a thread event
881 breakpoint location. If it is, read the event message and act upon
885 check_event (ptid_t ptid
)
893 /* Bail out early if we're not at a thread event breakpoint. */
894 stop_pc
= read_pc_pid (ptid
) - DECR_PC_AFTER_BREAK
;
895 if (stop_pc
!= td_create_bp_addr
&& stop_pc
!= td_death_bp_addr
)
898 /* If we are at a create breakpoint, we do not know what new lwp
899 was created and cannot specifically locate the event message for it.
900 We have to call td_ta_event_getmsg() to get
901 the latest message. Since we have no way of correlating whether
902 the event message we get back corresponds to our breakpoint, we must
903 loop and read all event messages, processing them appropriately.
904 This guarantees we will process the correct message before continuing
907 Currently, death events are not enabled. If they are enabled,
908 the death event can use the td_thr_event_getmsg() interface to
909 get the message specifically for that lwp and avoid looping
916 err
= td_ta_event_getmsg_p (thread_agent
, &msg
);
922 error ("Cannot get thread event message: %s",
923 thread_db_err_str (err
));
926 err
= td_thr_get_info_p (msg
.th_p
, &ti
);
928 error ("Cannot get thread info: %s", thread_db_err_str (err
));
930 ptid
= BUILD_THREAD (ti
.ti_tid
, GET_PID (ptid
));
935 /* Call attach_thread whether or not we already know about a
936 thread with this thread ID. */
937 attach_thread (ptid
, msg
.th_p
, &ti
, 1);
943 if (!in_thread_list (ptid
))
944 error ("Spurious thread death event.");
946 detach_thread (ptid
, 1);
951 error ("Spurious thread event.");
958 thread_db_wait (ptid_t ptid
, struct target_waitstatus
*ourstatus
)
960 extern ptid_t trap_ptid
;
962 if (GET_PID (ptid
) != -1 && is_thread (ptid
))
963 ptid
= lwp_from_thread (ptid
);
965 ptid
= target_beneath
->to_wait (ptid
, ourstatus
);
967 if (proc_handle
.pid
== 0)
968 /* The current child process isn't the actual multi-threaded
969 program yet, so don't try to do any special thread-specific
970 post-processing and bail out early. */
973 if (ourstatus
->kind
== TARGET_WAITKIND_EXITED
)
974 return pid_to_ptid (-1);
976 if (ourstatus
->kind
== TARGET_WAITKIND_STOPPED
977 && ourstatus
->value
.sig
== TARGET_SIGNAL_TRAP
)
978 /* Check for a thread event. */
981 if (!ptid_equal (trap_ptid
, null_ptid
))
982 trap_ptid
= thread_from_lwp (trap_ptid
);
984 /* Change the ptid back into the higher level PID + TID format.
985 If the thread is dead and no longer on the thread list, we will
986 get back a dead ptid. This can occur if the thread death event
987 gets postponed by other simultaneous events. In such a case,
988 we want to just ignore the event and continue on. */
989 ptid
= thread_from_lwp (ptid
);
990 if (GET_PID (ptid
) == -1)
991 ourstatus
->kind
= TARGET_WAITKIND_SPURIOUS
;
997 thread_db_xfer_memory (CORE_ADDR memaddr
, char *myaddr
, int len
, int write
,
998 struct mem_attrib
*attrib
, struct target_ops
*target
)
1000 struct cleanup
*old_chain
= save_inferior_ptid ();
1003 if (is_thread (inferior_ptid
))
1005 /* FIXME: This seems to be necessary to make sure breakpoints
1007 if (!target_thread_alive (inferior_ptid
))
1008 inferior_ptid
= pid_to_ptid (GET_PID (inferior_ptid
));
1010 inferior_ptid
= lwp_from_thread (inferior_ptid
);
1014 target_beneath
->to_xfer_memory (memaddr
, myaddr
, len
, write
, attrib
,
1017 do_cleanups (old_chain
);
1022 thread_db_fetch_registers (int regno
)
1024 struct thread_info
*thread_info
;
1025 prgregset_t gregset
;
1026 gdb_prfpregset_t fpregset
;
1029 if (!is_thread (inferior_ptid
))
1031 /* Pass the request to the target beneath us. */
1032 target_beneath
->to_fetch_registers (regno
);
1036 thread_info
= find_thread_pid (inferior_ptid
);
1037 thread_db_map_id2thr (thread_info
, 1);
1039 err
= td_thr_getgregs_p (&thread_info
->private->th
, gregset
);
1041 error ("Cannot fetch general-purpose registers for thread %ld: %s",
1042 (long) GET_THREAD (inferior_ptid
), thread_db_err_str (err
));
1044 err
= td_thr_getfpregs_p (&thread_info
->private->th
, &fpregset
);
1046 error ("Cannot get floating-point registers for thread %ld: %s",
1047 (long) GET_THREAD (inferior_ptid
), thread_db_err_str (err
));
1049 /* Note that we must call supply_gregset after calling the thread_db
1050 routines because the thread_db routines call ps_lgetgregs and
1051 friends which clobber GDB's register cache. */
1052 supply_gregset ((gdb_gregset_t
*) gregset
);
1053 supply_fpregset (&fpregset
);
1057 thread_db_store_registers (int regno
)
1059 prgregset_t gregset
;
1060 gdb_prfpregset_t fpregset
;
1062 struct thread_info
*thread_info
;
1064 if (!is_thread (inferior_ptid
))
1066 /* Pass the request to the target beneath us. */
1067 target_beneath
->to_store_registers (regno
);
1071 thread_info
= find_thread_pid (inferior_ptid
);
1072 thread_db_map_id2thr (thread_info
, 1);
1076 char raw
[MAX_REGISTER_SIZE
];
1078 deprecated_read_register_gen (regno
, raw
);
1079 thread_db_fetch_registers (-1);
1080 supply_register (regno
, raw
);
1083 fill_gregset ((gdb_gregset_t
*) gregset
, -1);
1084 fill_fpregset (&fpregset
, -1);
1086 err
= td_thr_setgregs_p (&thread_info
->private->th
, gregset
);
1088 error ("Cannot store general-purpose registers for thread %ld: %s",
1089 (long) GET_THREAD (inferior_ptid
), thread_db_err_str (err
));
1090 err
= td_thr_setfpregs_p (&thread_info
->private->th
, &fpregset
);
1092 error ("Cannot store floating-point registers for thread %ld: %s",
1093 (long) GET_THREAD (inferior_ptid
), thread_db_err_str (err
));
1097 thread_db_kill (void)
1099 /* There's no need to save & restore inferior_ptid here, since the
1100 inferior isn't supposed to survive this function call. */
1101 inferior_ptid
= lwp_from_thread (inferior_ptid
);
1102 target_beneath
->to_kill ();
1106 thread_db_create_inferior (char *exec_file
, char *allargs
, char **env
,
1109 if (!keep_thread_db
)
1111 unpush_target (&thread_db_ops
);
1112 using_thread_db
= 0;
1115 target_beneath
->to_create_inferior (exec_file
, allargs
, env
, from_tty
);
1119 thread_db_post_startup_inferior (ptid_t ptid
)
1121 if (proc_handle
.pid
== 0)
1123 /* The child process is now the actual multi-threaded
1124 program. Snatch its process ID... */
1125 proc_handle
.pid
= GET_PID (ptid
);
1127 /* ...and perform the remaining initialization steps. */
1128 enable_thread_event_reporting ();
1129 thread_db_find_new_threads ();
1134 thread_db_mourn_inferior (void)
1136 remove_thread_event_breakpoints ();
1138 /* Forget about the child's process ID. We shouldn't need it
1140 proc_handle
.pid
= 0;
1142 target_beneath
->to_mourn_inferior ();
1144 /* Detach thread_db target ops if not dealing with a statically
1145 linked threaded program. This allows a corefile to be debugged
1146 after finishing debugging of a threaded program. At present,
1147 debugging a statically-linked threaded program is broken, but
1148 the check is added below in the event that it is fixed in the
1150 if (!keep_thread_db
)
1152 unpush_target (&thread_db_ops
);
1153 using_thread_db
= 0;
1158 thread_db_thread_alive (ptid_t ptid
)
1163 if (is_thread (ptid
))
1165 struct thread_info
*thread_info
;
1166 thread_info
= find_thread_pid (ptid
);
1168 thread_db_map_id2thr (thread_info
, 0);
1169 if (!thread_info
->private->th_valid
)
1172 err
= td_thr_validate_p (&thread_info
->private->th
);
1176 if (!thread_info
->private->ti_valid
)
1179 td_thr_get_info_p (&thread_info
->private->th
,
1180 &thread_info
->private->ti
);
1183 thread_info
->private->ti_valid
= 1;
1186 if (thread_info
->private->ti
.ti_state
== TD_THR_UNKNOWN
1187 || thread_info
->private->ti
.ti_state
== TD_THR_ZOMBIE
)
1188 return 0; /* A zombie thread. */
1193 if (target_beneath
->to_thread_alive
)
1194 return target_beneath
->to_thread_alive (ptid
);
1200 find_new_threads_callback (const td_thrhandle_t
*th_p
, void *data
)
1206 err
= td_thr_get_info_p (th_p
, &ti
);
1208 error ("find_new_threads_callback: cannot get thread info: %s",
1209 thread_db_err_str (err
));
1211 if (ti
.ti_state
== TD_THR_UNKNOWN
|| ti
.ti_state
== TD_THR_ZOMBIE
)
1212 return 0; /* A zombie -- ignore. */
1214 ptid
= BUILD_THREAD (ti
.ti_tid
, GET_PID (inferior_ptid
));
1216 if (!in_thread_list (ptid
))
1217 attach_thread (ptid
, th_p
, &ti
, 1);
1223 thread_db_find_new_threads (void)
1227 /* Iterate over all user-space threads to discover new threads. */
1228 err
= td_ta_thr_iter_p (thread_agent
, find_new_threads_callback
, NULL
,
1229 TD_THR_ANY_STATE
, TD_THR_LOWEST_PRIORITY
,
1230 TD_SIGNO_MASK
, TD_THR_ANY_USER_FLAGS
);
1232 error ("Cannot find new threads: %s", thread_db_err_str (err
));
1236 thread_db_pid_to_str (ptid_t ptid
)
1238 if (is_thread (ptid
))
1240 static char buf
[64];
1243 struct thread_info
*thread_info
;
1245 thread_info
= find_thread_pid (ptid
);
1246 thread_db_map_id2thr (thread_info
, 0);
1247 if (!thread_info
->private->th_valid
)
1249 snprintf (buf
, sizeof (buf
), "Thread %ld (Missing)",
1254 ti_p
= thread_db_get_info (thread_info
);
1256 if (ti_p
->ti_state
== TD_THR_ACTIVE
&& ti_p
->ti_lid
!= 0)
1258 snprintf (buf
, sizeof (buf
), "Thread %ld (LWP %d)",
1259 (long) ti_p
->ti_tid
, ti_p
->ti_lid
);
1263 snprintf (buf
, sizeof (buf
), "Thread %ld (%s)",
1264 (long) ti_p
->ti_tid
,
1265 thread_db_state_str (ti_p
->ti_state
));
1271 if (target_beneath
->to_pid_to_str (ptid
))
1272 return target_beneath
->to_pid_to_str (ptid
);
1274 return normal_pid_to_str (ptid
);
1277 /* Get the address of the thread local variable in OBJFILE which is
1278 stored at OFFSET within the thread local storage for thread PTID. */
1281 thread_db_get_thread_local_address (ptid_t ptid
, struct objfile
*objfile
,
1284 if (is_thread (ptid
))
1286 int objfile_is_library
= (objfile
->flags
& OBJF_SHARED
);
1290 struct thread_info
*thread_info
;
1292 /* glibc doesn't provide the needed interface. */
1293 if (!td_thr_tls_get_addr_p
)
1294 error ("Cannot find thread-local variables in this thread library.");
1296 /* Get the address of the link map for this objfile. */
1297 lm
= svr4_fetch_objfile_link_map (objfile
);
1299 /* Whoops, we couldn't find one. Bail out. */
1302 if (objfile_is_library
)
1303 error ("Cannot find shared library `%s' link_map in dynamic"
1304 " linker's module list", objfile
->name
);
1306 error ("Cannot find executable file `%s' link_map in dynamic"
1307 " linker's module list", objfile
->name
);
1310 /* Get info about the thread. */
1311 thread_info
= find_thread_pid (ptid
);
1312 thread_db_map_id2thr (thread_info
, 1);
1314 /* Finally, get the address of the variable. */
1315 err
= td_thr_tls_get_addr_p (&thread_info
->private->th
, (void *) lm
,
1318 #ifdef THREAD_DB_HAS_TD_NOTALLOC
1319 /* The memory hasn't been allocated, yet. */
1320 if (err
== TD_NOTALLOC
)
1322 /* Now, if libthread_db provided the initialization image's
1323 address, we *could* try to build a non-lvalue value from
1324 the initialization image. */
1325 if (objfile_is_library
)
1326 error ("The inferior has not yet allocated storage for"
1327 " thread-local variables in\n"
1328 "the shared library `%s'\n"
1329 "for the thread %ld",
1330 objfile
->name
, (long) GET_THREAD (ptid
));
1332 error ("The inferior has not yet allocated storage for"
1333 " thread-local variables in\n"
1334 "the executable `%s'\n"
1335 "for the thread %ld",
1336 objfile
->name
, (long) GET_THREAD (ptid
));
1340 /* Something else went wrong. */
1343 if (objfile_is_library
)
1344 error ("Cannot find thread-local storage for thread %ld, "
1345 "shared library %s:\n%s",
1346 (long) GET_THREAD (ptid
),
1347 objfile
->name
, thread_db_err_str (err
));
1349 error ("Cannot find thread-local storage for thread %ld, "
1350 "executable file %s:\n%s",
1351 (long) GET_THREAD (ptid
),
1352 objfile
->name
, thread_db_err_str (err
));
1355 /* Cast assuming host == target. Joy. */
1356 return (CORE_ADDR
) address
;
1359 if (target_beneath
->to_get_thread_local_address
)
1360 return target_beneath
->to_get_thread_local_address (ptid
, objfile
,
1363 error ("Cannot find thread-local values on this target.");
1367 init_thread_db_ops (void)
1369 thread_db_ops
.to_shortname
= "multi-thread";
1370 thread_db_ops
.to_longname
= "multi-threaded child process.";
1371 thread_db_ops
.to_doc
= "Threads and pthreads support.";
1372 thread_db_ops
.to_attach
= thread_db_attach
;
1373 thread_db_ops
.to_detach
= thread_db_detach
;
1374 thread_db_ops
.to_resume
= thread_db_resume
;
1375 thread_db_ops
.to_wait
= thread_db_wait
;
1376 thread_db_ops
.to_fetch_registers
= thread_db_fetch_registers
;
1377 thread_db_ops
.to_store_registers
= thread_db_store_registers
;
1378 thread_db_ops
.to_xfer_memory
= thread_db_xfer_memory
;
1379 thread_db_ops
.to_kill
= thread_db_kill
;
1380 thread_db_ops
.to_create_inferior
= thread_db_create_inferior
;
1381 thread_db_ops
.to_post_startup_inferior
= thread_db_post_startup_inferior
;
1382 thread_db_ops
.to_mourn_inferior
= thread_db_mourn_inferior
;
1383 thread_db_ops
.to_thread_alive
= thread_db_thread_alive
;
1384 thread_db_ops
.to_find_new_threads
= thread_db_find_new_threads
;
1385 thread_db_ops
.to_pid_to_str
= thread_db_pid_to_str
;
1386 thread_db_ops
.to_stratum
= thread_stratum
;
1387 thread_db_ops
.to_has_thread_control
= tc_schedlock
;
1388 thread_db_ops
.to_get_thread_local_address
1389 = thread_db_get_thread_local_address
;
1390 thread_db_ops
.to_magic
= OPS_MAGIC
;
1394 _initialize_thread_db (void)
1396 /* Only initialize the module if we can load libthread_db. */
1397 if (thread_db_load ())
1399 init_thread_db_ops ();
1400 add_target (&thread_db_ops
);
1402 /* Add ourselves to objfile event chain. */
1403 target_new_objfile_chain
= deprecated_target_new_objfile_hook
;
1404 deprecated_target_new_objfile_hook
= thread_db_new_objfile
;