1 /* libthread_db assisted debugging support, generic parts.
3 Copyright (C) 1999-2014 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 3 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, see <http://www.gnu.org/licenses/>. */
22 #include "gdb_assert.h"
24 #include "gdb_proc_service.h"
25 #include "nat/gdb_thread_db.h"
29 #include "exceptions.h"
31 #include "gdbthread.h"
39 #include "solib-svr4.h"
42 #include "linux-nat.h"
43 #include "nat/linux-procfs.h"
44 #include "nat/linux-osdata.h"
45 #include "auto-load.h"
46 #include "cli/cli-utils.h"
51 /* GNU/Linux libthread_db support.
53 libthread_db is a library, provided along with libpthread.so, which
54 exposes the internals of the thread library to a debugger. It
55 allows GDB to find existing threads, new threads as they are
56 created, thread IDs (usually, the result of pthread_self), and
57 thread-local variables.
59 The libthread_db interface originates on Solaris, where it is
60 both more powerful and more complicated. This implementation
61 only works for LinuxThreads and NPTL, the two glibc threading
62 libraries. It assumes that each thread is permanently assigned
63 to a single light-weight process (LWP).
65 libthread_db-specific information is stored in the "private" field
66 of struct thread_info. When the field is NULL we do not yet have
67 information about the new thread; this could be temporary (created,
68 but the thread library's data structures do not reflect it yet)
69 or permanent (created using clone instead of pthread_create).
71 Process IDs managed by linux-thread-db.c match those used by
72 linux-nat.c: a common PID for all processes, an LWP ID for each
73 thread, and no TID. We save the TID in private. Keeping it out
74 of the ptid_t prevents thread IDs changing when libpthread is
75 loaded or unloaded. */
77 static char *libthread_db_search_path;
79 /* Set to non-zero if thread_db auto-loading is enabled
80 by the "set auto-load libthread-db" command. */
81 static int auto_load_thread_db = 1;
83 /* "show" command for the auto_load_thread_db configuration variable. */
86 show_auto_load_thread_db (struct ui_file *file, int from_tty,
87 struct cmd_list_element *c, const char *value)
89 fprintf_filtered (file, _("Auto-loading of inferior specific libthread_db "
95 set_libthread_db_search_path (char *ignored, int from_tty,
96 struct cmd_list_element *c)
98 if (*libthread_db_search_path == '\0')
100 xfree (libthread_db_search_path);
101 libthread_db_search_path = xstrdup (LIBTHREAD_DB_SEARCH_PATH);
105 /* If non-zero, print details of libthread_db processing. */
107 static unsigned int libthread_db_debug;
110 show_libthread_db_debug (struct ui_file *file, int from_tty,
111 struct cmd_list_element *c, const char *value)
113 fprintf_filtered (file, _("libthread-db debugging is %s.\n"), value);
116 /* If we're running on GNU/Linux, we must explicitly attach to any new
119 /* This module's target vector. */
120 static struct target_ops thread_db_ops;
122 /* Non-zero if we have determined the signals used by the threads
124 static int thread_signals;
125 static sigset_t thread_stop_set;
126 static sigset_t thread_print_set;
128 struct thread_db_info
130 struct thread_db_info *next;
132 /* Process id this object refers to. */
135 /* Handle from dlopen for libthread_db.so. */
138 /* Absolute pathname from gdb_realpath to disk file used for dlopen-ing
139 HANDLE. It may be NULL for system library. */
142 /* Structure that identifies the child process for the
143 <proc_service.h> interface. */
144 struct ps_prochandle proc_handle;
146 /* Connection to the libthread_db library. */
147 td_thragent_t *thread_agent;
149 /* True if we need to apply the workaround for glibc/BZ5983. When
150 we catch a PTRACE_O_TRACEFORK, and go query the child's thread
151 list, nptl_db returns the parent's threads in addition to the new
152 (single) child thread. If this flag is set, we do extra work to
153 be able to ignore such stale entries. */
154 int need_stale_parent_threads_check;
156 /* Location of the thread creation event breakpoint. The code at
157 this location in the child process will be called by the pthread
158 library whenever a new thread is created. By setting a special
159 breakpoint at this location, GDB can detect when a new thread is
160 created. We obtain this location via the td_ta_event_addr
162 CORE_ADDR td_create_bp_addr;
164 /* Location of the thread death event breakpoint. */
165 CORE_ADDR td_death_bp_addr;
167 /* Pointers to the libthread_db functions. */
169 td_err_e (*td_init_p) (void);
171 td_err_e (*td_ta_new_p) (struct ps_prochandle * ps,
173 td_err_e (*td_ta_map_id2thr_p) (const td_thragent_t *ta, thread_t pt,
174 td_thrhandle_t *__th);
175 td_err_e (*td_ta_map_lwp2thr_p) (const td_thragent_t *ta,
176 lwpid_t lwpid, td_thrhandle_t *th);
177 td_err_e (*td_ta_thr_iter_p) (const td_thragent_t *ta,
178 td_thr_iter_f *callback, void *cbdata_p,
179 td_thr_state_e state, int ti_pri,
180 sigset_t *ti_sigmask_p,
181 unsigned int ti_user_flags);
182 td_err_e (*td_ta_event_addr_p) (const td_thragent_t *ta,
183 td_event_e event, td_notify_t *ptr);
184 td_err_e (*td_ta_set_event_p) (const td_thragent_t *ta,
185 td_thr_events_t *event);
186 td_err_e (*td_ta_clear_event_p) (const td_thragent_t *ta,
187 td_thr_events_t *event);
188 td_err_e (*td_ta_event_getmsg_p) (const td_thragent_t *ta,
189 td_event_msg_t *msg);
191 td_err_e (*td_thr_validate_p) (const td_thrhandle_t *th);
192 td_err_e (*td_thr_get_info_p) (const td_thrhandle_t *th,
193 td_thrinfo_t *infop);
194 td_err_e (*td_thr_event_enable_p) (const td_thrhandle_t *th,
197 td_err_e (*td_thr_tls_get_addr_p) (const td_thrhandle_t *th,
198 psaddr_t map_address,
199 size_t offset, psaddr_t *address);
200 td_err_e (*td_thr_tlsbase_p) (const td_thrhandle_t *th,
201 unsigned long int modid,
205 /* List of known processes using thread_db, and the required
207 struct thread_db_info *thread_db_list;
209 static void thread_db_find_new_threads_1 (ptid_t ptid);
210 static void thread_db_find_new_threads_2 (ptid_t ptid, int until_no_new);
212 /* Add the current inferior to the list of processes using libpthread.
213 Return a pointer to the newly allocated object that was added to
214 THREAD_DB_LIST. HANDLE is the handle returned by dlopen'ing
217 static struct thread_db_info *
218 add_thread_db_info (void *handle)
220 struct thread_db_info *info;
222 info = xcalloc (1, sizeof (*info));
223 info->pid = ptid_get_pid (inferior_ptid);
224 info->handle = handle;
226 /* The workaround works by reading from /proc/pid/status, so it is
227 disabled for core files. */
228 if (target_has_execution)
229 info->need_stale_parent_threads_check = 1;
231 info->next = thread_db_list;
232 thread_db_list = info;
237 /* Return the thread_db_info object representing the bookkeeping
238 related to process PID, if any; NULL otherwise. */
240 static struct thread_db_info *
241 get_thread_db_info (int pid)
243 struct thread_db_info *info;
245 for (info = thread_db_list; info; info = info->next)
246 if (pid == info->pid)
252 /* When PID has exited or has been detached, we no longer want to keep
253 track of it as using libpthread. Call this function to discard
254 thread_db related info related to PID. Note that this closes
255 LIBTHREAD_DB_SO's dlopen'ed handle. */
258 delete_thread_db_info (int pid)
260 struct thread_db_info *info, *info_prev;
264 for (info = thread_db_list; info; info_prev = info, info = info->next)
265 if (pid == info->pid)
271 if (info->handle != NULL)
272 dlclose (info->handle);
274 xfree (info->filename);
277 info_prev->next = info->next;
279 thread_db_list = info->next;
284 /* Prototypes for local functions. */
285 static int attach_thread (ptid_t ptid, const td_thrhandle_t *th_p,
286 const td_thrinfo_t *ti_p);
287 static void detach_thread (ptid_t ptid);
290 /* Use "struct private_thread_info" to cache thread state. This is
291 a substantial optimization. */
293 struct private_thread_info
295 /* Flag set when we see a TD_DEATH event for this thread. */
296 unsigned int dying:1;
298 /* Cached thread state. */
305 thread_db_err_str (td_err_e err)
312 return "generic 'call succeeded'";
314 return "generic error";
316 return "no thread to satisfy query";
318 return "no sync handle to satisfy query";
320 return "no LWP to satisfy query";
322 return "invalid process handle";
324 return "invalid thread handle";
326 return "invalid synchronization handle";
328 return "invalid thread agent";
330 return "invalid key";
332 return "no event message for getmsg";
334 return "FPU register set not available";
336 return "application not linked with libthread";
338 return "requested event is not supported";
340 return "capability not available";
342 return "debugger service failed";
344 return "operation not applicable to";
346 return "no thread-specific data for this thread";
348 return "malloc failed";
350 return "only part of register set was written/read";
352 return "X register set not available for this thread";
353 #ifdef THREAD_DB_HAS_TD_NOTALLOC
355 return "thread has not yet allocated TLS for given module";
357 #ifdef THREAD_DB_HAS_TD_VERSION
359 return "versions of libpthread and libthread_db do not match";
361 #ifdef THREAD_DB_HAS_TD_NOTLS
363 return "there is no TLS segment in the given module";
366 snprintf (buf, sizeof (buf), "unknown thread_db error '%d'", err);
371 /* Return 1 if any threads have been registered. There may be none if
372 the threading library is not fully initialized yet. */
375 have_threads_callback (struct thread_info *thread, void *args)
377 int pid = * (int *) args;
379 if (ptid_get_pid (thread->ptid) != pid)
382 return thread->private != NULL;
386 have_threads (ptid_t ptid)
388 int pid = ptid_get_pid (ptid);
390 return iterate_over_threads (have_threads_callback, &pid) != NULL;
393 struct thread_get_info_inout
395 struct thread_info *thread_info;
396 struct thread_db_info *thread_db_info;
399 /* A callback function for td_ta_thr_iter, which we use to map all
402 THP is a handle to the current thread; if INFOP is not NULL, the
403 struct thread_info associated with this thread is returned in
406 If the thread is a zombie, TD_THR_ZOMBIE is returned. Otherwise,
407 zero is returned to indicate success. */
410 thread_get_info_callback (const td_thrhandle_t *thp, void *argp)
415 struct thread_get_info_inout *inout;
416 struct thread_db_info *info;
419 info = inout->thread_db_info;
421 err = info->td_thr_get_info_p (thp, &ti);
423 error (_("thread_get_info_callback: cannot get thread info: %s"),
424 thread_db_err_str (err));
426 /* Fill the cache. */
427 thread_ptid = ptid_build (info->pid, ti.ti_lid, 0);
428 inout->thread_info = find_thread_ptid (thread_ptid);
430 if (inout->thread_info == NULL)
432 /* New thread. Attach to it now (why wait?). */
433 if (!have_threads (thread_ptid))
434 thread_db_find_new_threads_1 (thread_ptid);
436 attach_thread (thread_ptid, thp, &ti);
437 inout->thread_info = find_thread_ptid (thread_ptid);
438 gdb_assert (inout->thread_info != NULL);
444 /* Fetch the user-level thread id of PTID. */
447 thread_from_lwp (ptid_t ptid)
451 struct thread_db_info *info;
452 struct thread_get_info_inout io = {0};
454 /* Just in case td_ta_map_lwp2thr doesn't initialize it completely. */
457 /* This ptid comes from linux-nat.c, which should always fill in the
459 gdb_assert (ptid_get_lwp (ptid) != 0);
461 info = get_thread_db_info (ptid_get_pid (ptid));
463 /* Access an lwp we know is stopped. */
464 info->proc_handle.ptid = ptid;
465 err = info->td_ta_map_lwp2thr_p (info->thread_agent, ptid_get_lwp (ptid),
468 error (_("Cannot find user-level thread for LWP %ld: %s"),
469 ptid_get_lwp (ptid), thread_db_err_str (err));
471 /* Long-winded way of fetching the thread info. */
472 io.thread_db_info = info;
473 io.thread_info = NULL;
474 thread_get_info_callback (&th, &io);
478 /* Attach to lwp PTID, doing whatever else is required to have this
479 LWP under the debugger's control --- e.g., enabling event
480 reporting. Returns true on success. */
482 thread_db_attach_lwp (ptid_t ptid)
487 struct thread_db_info *info;
489 info = get_thread_db_info (ptid_get_pid (ptid));
494 /* This ptid comes from linux-nat.c, which should always fill in the
496 gdb_assert (ptid_get_lwp (ptid) != 0);
498 /* Access an lwp we know is stopped. */
499 info->proc_handle.ptid = ptid;
501 /* If we have only looked at the first thread before libpthread was
502 initialized, we may not know its thread ID yet. Make sure we do
503 before we add another thread to the list. */
504 if (!have_threads (ptid))
505 thread_db_find_new_threads_1 (ptid);
507 err = info->td_ta_map_lwp2thr_p (info->thread_agent, ptid_get_lwp (ptid),
510 /* Cannot find user-level thread. */
513 err = info->td_thr_get_info_p (&th, &ti);
516 warning (_("Cannot get thread info: %s"), thread_db_err_str (err));
520 attach_thread (ptid, &th, &ti);
525 verbose_dlsym (void *handle, const char *name)
527 void *sym = dlsym (handle, name);
529 warning (_("Symbol \"%s\" not found in libthread_db: %s"),
535 enable_thread_event (int event, CORE_ADDR *bp)
539 struct thread_db_info *info;
541 info = get_thread_db_info (ptid_get_pid (inferior_ptid));
543 /* Access an lwp we know is stopped. */
544 info->proc_handle.ptid = inferior_ptid;
546 /* Get the breakpoint address for thread EVENT. */
547 err = info->td_ta_event_addr_p (info->thread_agent, event, ¬ify);
551 /* Set up the breakpoint. */
552 gdb_assert (exec_bfd);
553 (*bp) = (gdbarch_convert_from_func_ptr_addr
555 /* Do proper sign extension for the target. */
556 (bfd_get_sign_extend_vma (exec_bfd) > 0
557 ? (CORE_ADDR) (intptr_t) notify.u.bptaddr
558 : (CORE_ADDR) (uintptr_t) notify.u.bptaddr),
560 create_thread_event_breakpoint (target_gdbarch (), *bp);
565 /* Verify inferior's '\0'-terminated symbol VER_SYMBOL starts with "%d.%d" and
566 return 1 if this version is lower (and not equal) to
567 VER_MAJOR_MIN.VER_MINOR_MIN. Return 0 in all other cases. */
570 inferior_has_bug (const char *ver_symbol, int ver_major_min, int ver_minor_min)
572 struct bound_minimal_symbol version_msym;
573 CORE_ADDR version_addr;
575 int err, got, retval = 0;
577 version_msym = lookup_minimal_symbol (ver_symbol, NULL, NULL);
578 if (version_msym.minsym == NULL)
581 version_addr = BMSYMBOL_VALUE_ADDRESS (version_msym);
582 got = target_read_string (version_addr, &version, 32, &err);
583 if (err == 0 && memchr (version, 0, got) == &version[got -1])
587 retval = (sscanf (version, "%d.%d", &major, &minor) == 2
588 && (major < ver_major_min
589 || (major == ver_major_min && minor < ver_minor_min)));
597 enable_thread_event_reporting (void)
599 td_thr_events_t events;
601 struct thread_db_info *info;
603 info = get_thread_db_info (ptid_get_pid (inferior_ptid));
605 /* We cannot use the thread event reporting facility if these
606 functions aren't available. */
607 if (info->td_ta_event_addr_p == NULL
608 || info->td_ta_set_event_p == NULL
609 || info->td_ta_event_getmsg_p == NULL
610 || info->td_thr_event_enable_p == NULL)
613 /* Set the process wide mask saying which events we're interested in. */
614 td_event_emptyset (&events);
615 td_event_addset (&events, TD_CREATE);
617 /* There is a bug fixed between linuxthreads 2.1.3 and 2.2 by
618 commit 2e4581e4fba917f1779cd0a010a45698586c190a
619 * manager.c (pthread_exited): Correctly report event as TD_REAP
620 instead of TD_DEATH. Fix comments.
621 where event reporting facility is broken for TD_DEATH events,
622 so don't enable it if we have glibc but a lower version. */
623 if (!inferior_has_bug ("__linuxthreads_version", 2, 2))
624 td_event_addset (&events, TD_DEATH);
626 err = info->td_ta_set_event_p (info->thread_agent, &events);
629 warning (_("Unable to set global thread event mask: %s"),
630 thread_db_err_str (err));
634 /* Delete previous thread event breakpoints, if any. */
635 remove_thread_event_breakpoints ();
636 info->td_create_bp_addr = 0;
637 info->td_death_bp_addr = 0;
639 /* Set up the thread creation event. */
640 err = enable_thread_event (TD_CREATE, &info->td_create_bp_addr);
643 warning (_("Unable to get location for thread creation breakpoint: %s"),
644 thread_db_err_str (err));
648 /* Set up the thread death event. */
649 err = enable_thread_event (TD_DEATH, &info->td_death_bp_addr);
652 warning (_("Unable to get location for thread death breakpoint: %s"),
653 thread_db_err_str (err));
658 /* Similar as thread_db_find_new_threads_1, but try to silently ignore errors
661 Return 1 if the caller should abort libthread_db initialization. Return 0
665 thread_db_find_new_threads_silently (ptid_t ptid)
667 volatile struct gdb_exception except;
669 TRY_CATCH (except, RETURN_MASK_ERROR)
671 thread_db_find_new_threads_2 (ptid, 1);
674 if (except.reason < 0)
676 if (libthread_db_debug)
677 exception_fprintf (gdb_stderr, except,
678 "Warning: thread_db_find_new_threads_silently: ");
680 /* There is a bug fixed between nptl 2.6.1 and 2.7 by
681 commit 7d9d8bd18906fdd17364f372b160d7ab896ce909
682 where calls to td_thr_get_info fail with TD_ERR for statically linked
683 executables if td_thr_get_info is called before glibc has initialized
686 If the nptl bug is NOT present in the inferior and still thread_db
687 reports an error return 1. It means the inferior has corrupted thread
688 list and GDB should fall back only to LWPs.
690 If the nptl bug is present in the inferior return 0 to silently ignore
691 such errors, and let gdb enumerate threads again later. In such case
692 GDB cannot properly display LWPs if the inferior thread list is
693 corrupted. For core files it does not apply, no 'later enumeration'
696 if (!target_has_execution || !inferior_has_bug ("nptl_version", 2, 7))
698 exception_fprintf (gdb_stderr, except,
699 _("Warning: couldn't activate thread debugging "
700 "using libthread_db: "));
707 /* Lookup a library in which given symbol resides.
708 Note: this is looking in GDB process, not in the inferior.
709 Returns library name, or NULL. */
712 dladdr_to_soname (const void *addr)
716 if (dladdr (addr, &info) != 0)
717 return info.dli_fname;
721 /* Attempt to initialize dlopen()ed libthread_db, described by INFO.
723 Failure could happen if libthread_db does not have symbols we expect,
724 or when it refuses to work with the current inferior (e.g. due to
725 version mismatch between libthread_db and libpthread). */
728 try_thread_db_load_1 (struct thread_db_info *info)
732 /* Initialize pointers to the dynamic library functions we will use.
733 Essential functions first. */
735 info->td_init_p = verbose_dlsym (info->handle, "td_init");
736 if (info->td_init_p == NULL)
739 err = info->td_init_p ();
742 warning (_("Cannot initialize libthread_db: %s"),
743 thread_db_err_str (err));
747 info->td_ta_new_p = verbose_dlsym (info->handle, "td_ta_new");
748 if (info->td_ta_new_p == NULL)
751 /* Initialize the structure that identifies the child process. */
752 info->proc_handle.ptid = inferior_ptid;
754 /* Now attempt to open a connection to the thread library. */
755 err = info->td_ta_new_p (&info->proc_handle, &info->thread_agent);
758 if (libthread_db_debug)
759 printf_unfiltered (_("td_ta_new failed: %s\n"),
760 thread_db_err_str (err));
765 #ifdef THREAD_DB_HAS_TD_VERSION
768 /* The errors above are not unexpected and silently ignored:
769 they just mean we haven't found correct version of
773 warning (_("td_ta_new failed: %s"), thread_db_err_str (err));
778 info->td_ta_map_id2thr_p = verbose_dlsym (info->handle, "td_ta_map_id2thr");
779 if (info->td_ta_map_id2thr_p == NULL)
782 info->td_ta_map_lwp2thr_p = verbose_dlsym (info->handle,
783 "td_ta_map_lwp2thr");
784 if (info->td_ta_map_lwp2thr_p == NULL)
787 info->td_ta_thr_iter_p = verbose_dlsym (info->handle, "td_ta_thr_iter");
788 if (info->td_ta_thr_iter_p == NULL)
791 info->td_thr_validate_p = verbose_dlsym (info->handle, "td_thr_validate");
792 if (info->td_thr_validate_p == NULL)
795 info->td_thr_get_info_p = verbose_dlsym (info->handle, "td_thr_get_info");
796 if (info->td_thr_get_info_p == NULL)
799 /* These are not essential. */
800 info->td_ta_event_addr_p = dlsym (info->handle, "td_ta_event_addr");
801 info->td_ta_set_event_p = dlsym (info->handle, "td_ta_set_event");
802 info->td_ta_clear_event_p = dlsym (info->handle, "td_ta_clear_event");
803 info->td_ta_event_getmsg_p = dlsym (info->handle, "td_ta_event_getmsg");
804 info->td_thr_event_enable_p = dlsym (info->handle, "td_thr_event_enable");
805 info->td_thr_tls_get_addr_p = dlsym (info->handle, "td_thr_tls_get_addr");
806 info->td_thr_tlsbase_p = dlsym (info->handle, "td_thr_tlsbase");
808 if (thread_db_find_new_threads_silently (inferior_ptid) != 0)
810 /* Even if libthread_db initializes, if the thread list is
811 corrupted, we'd not manage to list any threads. Better reject this
812 thread_db, and fall back to at least listing LWPs. */
816 printf_unfiltered (_("[Thread debugging using libthread_db enabled]\n"));
818 if (libthread_db_debug || *libthread_db_search_path)
822 library = dladdr_to_soname (*info->td_ta_new_p);
824 library = LIBTHREAD_DB_SO;
826 printf_unfiltered (_("Using host libthread_db library \"%s\".\n"),
830 /* The thread library was detected. Activate the thread_db target
831 if this is the first process using it. */
832 if (thread_db_list->next == NULL)
833 push_target (&thread_db_ops);
835 /* Enable event reporting, but not when debugging a core file. */
836 if (target_has_execution)
837 enable_thread_event_reporting ();
842 /* Attempt to use LIBRARY as libthread_db. LIBRARY could be absolute,
843 relative, or just LIBTHREAD_DB. */
846 try_thread_db_load (const char *library, int check_auto_load_safe)
849 struct thread_db_info *info;
851 if (libthread_db_debug)
852 printf_unfiltered (_("Trying host libthread_db library: %s.\n"),
855 if (check_auto_load_safe)
857 if (access (library, R_OK) != 0)
859 /* Do not print warnings by file_is_auto_load_safe if the library does
860 not exist at this place. */
861 if (libthread_db_debug)
862 printf_unfiltered (_("open failed: %s.\n"), safe_strerror (errno));
866 if (!file_is_auto_load_safe (library, _("auto-load: Loading libthread-db "
867 "library \"%s\" from explicit "
873 handle = dlopen (library, RTLD_NOW);
876 if (libthread_db_debug)
877 printf_unfiltered (_("dlopen failed: %s.\n"), dlerror ());
881 if (libthread_db_debug && strchr (library, '/') == NULL)
885 td_init = dlsym (handle, "td_init");
888 const char *const libpath = dladdr_to_soname (td_init);
891 printf_unfiltered (_("Host %s resolved to: %s.\n"),
896 info = add_thread_db_info (handle);
898 /* Do not save system library name, that one is always trusted. */
899 if (strchr (library, '/') != NULL)
900 info->filename = gdb_realpath (library);
902 if (try_thread_db_load_1 (info))
905 /* This library "refused" to work on current inferior. */
906 delete_thread_db_info (ptid_get_pid (inferior_ptid));
910 /* Subroutine of try_thread_db_load_from_pdir to simplify it.
911 Try loading libthread_db in directory(OBJ)/SUBDIR.
912 SUBDIR may be NULL. It may also be something like "../lib64".
913 The result is true for success. */
916 try_thread_db_load_from_pdir_1 (struct objfile *obj, const char *subdir)
918 struct cleanup *cleanup;
921 const char *obj_name = objfile_name (obj);
923 if (obj_name[0] != '/')
925 warning (_("Expected absolute pathname for libpthread in the"
926 " inferior, but got %s."), obj_name);
930 path = xmalloc (strlen (obj_name) + (subdir ? strlen (subdir) + 1 : 0)
931 + 1 + strlen (LIBTHREAD_DB_SO) + 1);
932 cleanup = make_cleanup (xfree, path);
934 strcpy (path, obj_name);
935 cp = strrchr (path, '/');
936 /* This should at minimum hit the first character. */
937 gdb_assert (cp != NULL);
944 strcat (cp, LIBTHREAD_DB_SO);
946 result = try_thread_db_load (path, 1);
948 do_cleanups (cleanup);
952 /* Handle $pdir in libthread-db-search-path.
953 Look for libthread_db in directory(libpthread)/SUBDIR.
954 SUBDIR may be NULL. It may also be something like "../lib64".
955 The result is true for success. */
958 try_thread_db_load_from_pdir (const char *subdir)
962 if (!auto_load_thread_db)
966 if (libpthread_name_p (objfile_name (obj)))
968 if (try_thread_db_load_from_pdir_1 (obj, subdir))
971 /* We may have found the separate-debug-info version of
972 libpthread, and it may live in a directory without a matching
974 if (obj->separate_debug_objfile_backlink != NULL)
975 return try_thread_db_load_from_pdir_1 (obj->separate_debug_objfile_backlink,
984 /* Handle $sdir in libthread-db-search-path.
985 Look for libthread_db in the system dirs, or wherever a plain
986 dlopen(file_without_path) will look.
987 The result is true for success. */
990 try_thread_db_load_from_sdir (void)
992 return try_thread_db_load (LIBTHREAD_DB_SO, 0);
995 /* Try to load libthread_db from directory DIR of length DIR_LEN.
996 The result is true for success. */
999 try_thread_db_load_from_dir (const char *dir, size_t dir_len)
1001 struct cleanup *cleanup;
1005 if (!auto_load_thread_db)
1008 path = xmalloc (dir_len + 1 + strlen (LIBTHREAD_DB_SO) + 1);
1009 cleanup = make_cleanup (xfree, path);
1011 memcpy (path, dir, dir_len);
1012 path[dir_len] = '/';
1013 strcpy (path + dir_len + 1, LIBTHREAD_DB_SO);
1015 result = try_thread_db_load (path, 1);
1017 do_cleanups (cleanup);
1021 /* Search libthread_db_search_path for libthread_db which "agrees"
1022 to work on current inferior.
1023 The result is true for success. */
1026 thread_db_load_search (void)
1028 VEC (char_ptr) *dir_vec;
1029 struct cleanup *cleanups;
1033 dir_vec = dirnames_to_char_ptr_vec (libthread_db_search_path);
1034 cleanups = make_cleanup_free_char_ptr_vec (dir_vec);
1036 for (i = 0; VEC_iterate (char_ptr, dir_vec, i, this_dir); ++i)
1038 const int pdir_len = sizeof ("$pdir") - 1;
1039 size_t this_dir_len;
1041 this_dir_len = strlen (this_dir);
1043 if (strncmp (this_dir, "$pdir", pdir_len) == 0
1044 && (this_dir[pdir_len] == '\0'
1045 || this_dir[pdir_len] == '/'))
1047 char *subdir = NULL;
1048 struct cleanup *free_subdir_cleanup
1049 = make_cleanup (null_cleanup, NULL);
1051 if (this_dir[pdir_len] == '/')
1053 subdir = xmalloc (strlen (this_dir));
1054 make_cleanup (xfree, subdir);
1055 strcpy (subdir, this_dir + pdir_len + 1);
1057 rc = try_thread_db_load_from_pdir (subdir);
1058 do_cleanups (free_subdir_cleanup);
1062 else if (strcmp (this_dir, "$sdir") == 0)
1064 if (try_thread_db_load_from_sdir ())
1072 if (try_thread_db_load_from_dir (this_dir, this_dir_len))
1080 do_cleanups (cleanups);
1081 if (libthread_db_debug)
1082 printf_unfiltered (_("thread_db_load_search returning %d\n"), rc);
1086 /* Return non-zero if the inferior has a libpthread. */
1089 has_libpthread (void)
1091 struct objfile *obj;
1094 if (libpthread_name_p (objfile_name (obj)))
1100 /* Attempt to load and initialize libthread_db.
1101 Return 1 on success. */
1104 thread_db_load (void)
1106 struct thread_db_info *info;
1108 info = get_thread_db_info (ptid_get_pid (inferior_ptid));
1113 /* Don't attempt to use thread_db on executables not running
1115 if (!target_has_registers)
1118 /* Don't attempt to use thread_db for remote targets. */
1119 if (!(target_can_run (¤t_target) || core_bfd))
1122 if (thread_db_load_search ())
1125 /* We couldn't find a libthread_db.
1126 If the inferior has a libpthread warn the user. */
1127 if (has_libpthread ())
1129 warning (_("Unable to find libthread_db matching inferior's thread"
1130 " library, thread debugging will not be available."));
1134 /* Either this executable isn't using libpthread at all, or it is
1135 statically linked. Since we can't easily distinguish these two cases,
1136 no warning is issued. */
1141 disable_thread_event_reporting (struct thread_db_info *info)
1143 if (info->td_ta_clear_event_p != NULL)
1145 td_thr_events_t events;
1147 /* Set the process wide mask saying we aren't interested in any
1149 td_event_fillset (&events);
1150 info->td_ta_clear_event_p (info->thread_agent, &events);
1153 info->td_create_bp_addr = 0;
1154 info->td_death_bp_addr = 0;
1158 check_thread_signals (void)
1160 if (!thread_signals)
1165 lin_thread_get_thread_signals (&mask);
1166 sigemptyset (&thread_stop_set);
1167 sigemptyset (&thread_print_set);
1169 for (i = 1; i < NSIG; i++)
1171 if (sigismember (&mask, i))
1173 if (signal_stop_update (gdb_signal_from_host (i), 0))
1174 sigaddset (&thread_stop_set, i);
1175 if (signal_print_update (gdb_signal_from_host (i), 0))
1176 sigaddset (&thread_print_set, i);
1183 /* Check whether thread_db is usable. This function is called when
1184 an inferior is created (or otherwise acquired, e.g. attached to)
1185 and when new shared libraries are loaded into a running process. */
1188 check_for_thread_db (void)
1190 /* Do nothing if we couldn't load libthread_db.so.1. */
1191 if (!thread_db_load ())
1195 /* This function is called via the new_objfile observer. */
1198 thread_db_new_objfile (struct objfile *objfile)
1200 /* This observer must always be called with inferior_ptid set
1204 /* libpthread with separate debug info has its debug info file already
1205 loaded (and notified without successful thread_db initialization)
1206 the time observer_notify_new_objfile is called for the library itself.
1207 Static executables have their separate debug info loaded already
1208 before the inferior has started. */
1209 && objfile->separate_debug_objfile_backlink == NULL
1210 /* Only check for thread_db if we loaded libpthread,
1211 or if this is the main symbol file.
1212 We need to check OBJF_MAINLINE to handle the case of debugging
1213 a statically linked executable AND the symbol file is specified AFTER
1214 the exec file is loaded (e.g., gdb -c core ; file foo).
1215 For dynamically linked executables, libpthread can be near the end
1216 of the list of shared libraries to load, and in an app of several
1217 thousand shared libraries, this can otherwise be painful. */
1218 && ((objfile->flags & OBJF_MAINLINE) != 0
1219 || libpthread_name_p (objfile_name (objfile))))
1220 check_for_thread_db ();
1223 /* This function is called via the inferior_created observer.
1224 This handles the case of debugging statically linked executables. */
1227 thread_db_inferior_created (struct target_ops *target, int from_tty)
1229 check_for_thread_db ();
1232 /* Attach to a new thread. This function is called when we receive a
1233 TD_CREATE event or when we iterate over all threads and find one
1234 that wasn't already in our list. Returns true on success. */
1237 attach_thread (ptid_t ptid, const td_thrhandle_t *th_p,
1238 const td_thrinfo_t *ti_p)
1240 struct private_thread_info *private;
1241 struct thread_info *tp;
1243 struct thread_db_info *info;
1245 /* If we're being called after a TD_CREATE event, we may already
1246 know about this thread. There are two ways this can happen. We
1247 may have iterated over all threads between the thread creation
1248 and the TD_CREATE event, for instance when the user has issued
1249 the `info threads' command before the SIGTRAP for hitting the
1250 thread creation breakpoint was reported. Alternatively, the
1251 thread may have exited and a new one been created with the same
1252 thread ID. In the first case we don't need to do anything; in
1253 the second case we should discard information about the dead
1254 thread and attach to the new one. */
1255 tp = find_thread_ptid (ptid);
1258 /* If tp->private is NULL, then GDB is already attached to this
1259 thread, but we do not know anything about it. We can learn
1260 about it here. This can only happen if we have some other
1261 way besides libthread_db to notice new threads (i.e.
1262 PTRACE_EVENT_CLONE); assume the same mechanism notices thread
1263 exit, so this can not be a stale thread recreated with the
1265 if (tp->private != NULL)
1267 if (!tp->private->dying)
1270 delete_thread (ptid);
1275 if (target_has_execution)
1276 check_thread_signals ();
1278 /* Under GNU/Linux, we have to attach to each and every thread. */
1279 if (target_has_execution
1284 res = lin_lwp_attach_lwp (ptid_build (ptid_get_pid (ptid),
1288 /* Error, stop iterating. */
1293 /* Pretend this thread doesn't exist yet, and keep
1298 /* Otherwise, we sucessfully attached to the thread. */
1301 /* Construct the thread's private data. */
1302 private = xmalloc (sizeof (struct private_thread_info));
1303 memset (private, 0, sizeof (struct private_thread_info));
1305 /* A thread ID of zero may mean the thread library has not initialized
1306 yet. But we shouldn't even get here if that's the case. FIXME:
1307 if we change GDB to always have at least one thread in the thread
1308 list this will have to go somewhere else; maybe private == NULL
1309 until the thread_db target claims it. */
1310 gdb_assert (ti_p->ti_tid != 0);
1311 private->th = *th_p;
1312 private->tid = ti_p->ti_tid;
1313 if (ti_p->ti_state == TD_THR_UNKNOWN || ti_p->ti_state == TD_THR_ZOMBIE)
1316 /* Add the thread to GDB's thread list. */
1318 add_thread_with_info (ptid, private);
1320 tp->private = private;
1322 info = get_thread_db_info (ptid_get_pid (ptid));
1324 /* Enable thread event reporting for this thread, except when
1325 debugging a core file. */
1326 if (target_has_execution)
1328 err = info->td_thr_event_enable_p (th_p, 1);
1330 error (_("Cannot enable thread event reporting for %s: %s"),
1331 target_pid_to_str (ptid), thread_db_err_str (err));
1338 detach_thread (ptid_t ptid)
1340 struct thread_info *thread_info;
1342 /* Don't delete the thread now, because it still reports as active
1343 until it has executed a few instructions after the event
1344 breakpoint - if we deleted it now, "info threads" would cause us
1345 to re-attach to it. Just mark it as having had a TD_DEATH
1346 event. This means that we won't delete it from our thread list
1347 until we notice that it's dead (via prune_threads), or until
1348 something re-uses its thread ID. We'll report the thread exit
1349 when the underlying LWP dies. */
1350 thread_info = find_thread_ptid (ptid);
1351 gdb_assert (thread_info != NULL && thread_info->private != NULL);
1352 thread_info->private->dying = 1;
1356 thread_db_detach (struct target_ops *ops, const char *args, int from_tty)
1358 struct target_ops *target_beneath = find_target_beneath (ops);
1359 struct thread_db_info *info;
1361 info = get_thread_db_info (ptid_get_pid (inferior_ptid));
1365 if (target_has_execution)
1367 disable_thread_event_reporting (info);
1369 /* Delete the old thread event breakpoints. Note that
1370 unlike when mourning, we can remove them here because
1371 there's still a live inferior to poke at. In any case,
1372 GDB will not try to insert anything in the inferior when
1373 removing a breakpoint. */
1374 remove_thread_event_breakpoints ();
1377 delete_thread_db_info (ptid_get_pid (inferior_ptid));
1380 target_beneath->to_detach (target_beneath, args, from_tty);
1382 /* NOTE: From this point on, inferior_ptid is null_ptid. */
1384 /* If there are no more processes using libpthread, detach the
1385 thread_db target ops. */
1386 if (!thread_db_list)
1387 unpush_target (&thread_db_ops);
1390 /* Check if PID is currently stopped at the location of a thread event
1391 breakpoint location. If it is, read the event message and act upon
1395 check_event (ptid_t ptid)
1397 struct regcache *regcache = get_thread_regcache (ptid);
1398 struct gdbarch *gdbarch = get_regcache_arch (regcache);
1404 struct thread_db_info *info;
1406 info = get_thread_db_info (ptid_get_pid (ptid));
1408 /* Bail out early if we're not at a thread event breakpoint. */
1409 stop_pc = regcache_read_pc (regcache)
1410 - target_decr_pc_after_break (gdbarch);
1411 if (stop_pc != info->td_create_bp_addr
1412 && stop_pc != info->td_death_bp_addr)
1415 /* Access an lwp we know is stopped. */
1416 info->proc_handle.ptid = ptid;
1418 /* If we have only looked at the first thread before libpthread was
1419 initialized, we may not know its thread ID yet. Make sure we do
1420 before we add another thread to the list. */
1421 if (!have_threads (ptid))
1422 thread_db_find_new_threads_1 (ptid);
1424 /* If we are at a create breakpoint, we do not know what new lwp
1425 was created and cannot specifically locate the event message for it.
1426 We have to call td_ta_event_getmsg() to get
1427 the latest message. Since we have no way of correlating whether
1428 the event message we get back corresponds to our breakpoint, we must
1429 loop and read all event messages, processing them appropriately.
1430 This guarantees we will process the correct message before continuing
1431 from the breakpoint.
1433 Currently, death events are not enabled. If they are enabled,
1434 the death event can use the td_thr_event_getmsg() interface to
1435 get the message specifically for that lwp and avoid looping
1442 err = info->td_ta_event_getmsg_p (info->thread_agent, &msg);
1445 if (err == TD_NOMSG)
1448 error (_("Cannot get thread event message: %s"),
1449 thread_db_err_str (err));
1452 err = info->td_thr_get_info_p (msg.th_p, &ti);
1454 error (_("Cannot get thread info: %s"), thread_db_err_str (err));
1456 ptid = ptid_build (ptid_get_pid (ptid), ti.ti_lid, 0);
1461 /* Call attach_thread whether or not we already know about a
1462 thread with this thread ID. */
1463 attach_thread (ptid, msg.th_p, &ti);
1469 if (!in_thread_list (ptid))
1470 error (_("Spurious thread death event."));
1472 detach_thread (ptid);
1477 error (_("Spurious thread event."));
1484 thread_db_wait (struct target_ops *ops,
1485 ptid_t ptid, struct target_waitstatus *ourstatus,
1488 struct thread_db_info *info;
1489 struct target_ops *beneath = find_target_beneath (ops);
1491 ptid = beneath->to_wait (beneath, ptid, ourstatus, options);
1493 if (ourstatus->kind == TARGET_WAITKIND_IGNORE)
1496 if (ourstatus->kind == TARGET_WAITKIND_EXITED
1497 || ourstatus->kind == TARGET_WAITKIND_SIGNALLED)
1500 info = get_thread_db_info (ptid_get_pid (ptid));
1502 /* If this process isn't using thread_db, we're done. */
1506 if (ourstatus->kind == TARGET_WAITKIND_EXECD)
1508 /* New image, it may or may not end up using thread_db. Assume
1509 not unless we find otherwise. */
1510 delete_thread_db_info (ptid_get_pid (ptid));
1511 if (!thread_db_list)
1512 unpush_target (&thread_db_ops);
1514 /* Thread event breakpoints are deleted by
1515 update_breakpoints_after_exec. */
1520 /* If we do not know about the main thread yet, this would be a good time to
1522 if (ourstatus->kind == TARGET_WAITKIND_STOPPED && !have_threads (ptid))
1523 thread_db_find_new_threads_1 (ptid);
1525 if (ourstatus->kind == TARGET_WAITKIND_STOPPED
1526 && ourstatus->value.sig == GDB_SIGNAL_TRAP)
1527 /* Check for a thread event. */
1530 if (have_threads (ptid))
1532 /* Fill in the thread's user-level thread id. */
1533 thread_from_lwp (ptid);
1540 thread_db_mourn_inferior (struct target_ops *ops)
1542 struct target_ops *target_beneath = find_target_beneath (ops);
1544 delete_thread_db_info (ptid_get_pid (inferior_ptid));
1546 target_beneath->to_mourn_inferior (target_beneath);
1548 /* Delete the old thread event breakpoints. Do this after mourning
1549 the inferior, so that we don't try to uninsert them. */
1550 remove_thread_event_breakpoints ();
1552 /* Detach thread_db target ops. */
1553 if (!thread_db_list)
1554 unpush_target (ops);
1557 struct callback_data
1559 struct thread_db_info *info;
1564 find_new_threads_callback (const td_thrhandle_t *th_p, void *data)
1569 struct thread_info *tp;
1570 struct callback_data *cb_data = data;
1571 struct thread_db_info *info = cb_data->info;
1573 err = info->td_thr_get_info_p (th_p, &ti);
1575 error (_("find_new_threads_callback: cannot get thread info: %s"),
1576 thread_db_err_str (err));
1580 /* A thread ID of zero means that this is the main thread, but
1581 glibc has not yet initialized thread-local storage and the
1582 pthread library. We do not know what the thread's TID will
1583 be yet. Just enable event reporting and otherwise ignore
1586 /* In that case, we're not stopped in a fork syscall and don't
1587 need this glibc bug workaround. */
1588 info->need_stale_parent_threads_check = 0;
1590 if (target_has_execution)
1592 err = info->td_thr_event_enable_p (th_p, 1);
1594 error (_("Cannot enable thread event reporting for LWP %d: %s"),
1595 (int) ti.ti_lid, thread_db_err_str (err));
1601 /* Ignore stale parent threads, caused by glibc/BZ5983. This is a
1602 bit expensive, as it needs to open /proc/pid/status, so try to
1603 avoid doing the work if we know we don't have to. */
1604 if (info->need_stale_parent_threads_check)
1606 int tgid = linux_proc_get_tgid (ti.ti_lid);
1608 if (tgid != -1 && tgid != info->pid)
1612 ptid = ptid_build (info->pid, ti.ti_lid, 0);
1613 tp = find_thread_ptid (ptid);
1614 if (tp == NULL || tp->private == NULL)
1616 if (attach_thread (ptid, th_p, &ti))
1617 cb_data->new_threads += 1;
1619 /* Problem attaching this thread; perhaps it exited before we
1621 This could mean that the thread list inside glibc itself is in
1622 inconsistent state, and libthread_db could go on looping forever
1623 (observed with glibc-2.3.6). To prevent that, terminate
1624 iteration: thread_db_find_new_threads_2 will retry. */
1631 /* Helper for thread_db_find_new_threads_2.
1632 Returns number of new threads found. */
1635 find_new_threads_once (struct thread_db_info *info, int iteration,
1638 volatile struct gdb_exception except;
1639 struct callback_data data;
1640 td_err_e err = TD_ERR;
1643 data.new_threads = 0;
1645 TRY_CATCH (except, RETURN_MASK_ERROR)
1647 /* Iterate over all user-space threads to discover new threads. */
1648 err = info->td_ta_thr_iter_p (info->thread_agent,
1649 find_new_threads_callback,
1652 TD_THR_LOWEST_PRIORITY,
1654 TD_THR_ANY_USER_FLAGS);
1657 if (libthread_db_debug)
1659 if (except.reason < 0)
1660 exception_fprintf (gdb_stderr, except,
1661 "Warning: find_new_threads_once: ");
1663 printf_filtered (_("Found %d new threads in iteration %d.\n"),
1664 data.new_threads, iteration);
1670 return data.new_threads;
1673 /* Search for new threads, accessing memory through stopped thread
1674 PTID. If UNTIL_NO_NEW is true, repeat searching until several
1675 searches in a row do not discover any new threads. */
1678 thread_db_find_new_threads_2 (ptid_t ptid, int until_no_new)
1680 td_err_e err = TD_OK;
1681 struct thread_db_info *info;
1684 info = get_thread_db_info (ptid_get_pid (ptid));
1686 /* Access an lwp we know is stopped. */
1687 info->proc_handle.ptid = ptid;
1691 /* Require 4 successive iterations which do not find any new threads.
1692 The 4 is a heuristic: there is an inherent race here, and I have
1693 seen that 2 iterations in a row are not always sufficient to
1694 "capture" all threads. */
1695 for (i = 0, loop = 0; loop < 4 && err == TD_OK; ++i, ++loop)
1696 if (find_new_threads_once (info, i, &err) != 0)
1698 /* Found some new threads. Restart the loop from beginning. */
1703 find_new_threads_once (info, 0, &err);
1706 error (_("Cannot find new threads: %s"), thread_db_err_str (err));
1710 thread_db_find_new_threads_1 (ptid_t ptid)
1712 thread_db_find_new_threads_2 (ptid, 0);
1716 update_thread_core (struct lwp_info *info, void *closure)
1718 info->core = linux_common_core_of_thread (info->ptid);
1723 thread_db_find_new_threads (struct target_ops *ops)
1725 struct thread_db_info *info;
1726 struct inferior *inf;
1730 struct thread_info *thread;
1735 info = get_thread_db_info (inf->pid);
1739 thread = any_live_thread_of_process (inf->pid);
1740 if (thread == NULL || thread->executing)
1743 thread_db_find_new_threads_1 (thread->ptid);
1746 if (target_has_execution)
1747 iterate_over_lwps (minus_one_ptid /* iterate over all */,
1748 update_thread_core, NULL);
1752 thread_db_pid_to_str (struct target_ops *ops, ptid_t ptid)
1754 struct thread_info *thread_info = find_thread_ptid (ptid);
1755 struct target_ops *beneath;
1757 if (thread_info != NULL && thread_info->private != NULL)
1759 static char buf[64];
1762 tid = thread_info->private->tid;
1763 snprintf (buf, sizeof (buf), "Thread 0x%lx (LWP %ld)",
1764 tid, ptid_get_lwp (ptid));
1769 beneath = find_target_beneath (ops);
1770 if (beneath->to_pid_to_str (beneath, ptid))
1771 return beneath->to_pid_to_str (beneath, ptid);
1773 return normal_pid_to_str (ptid);
1776 /* Return a string describing the state of the thread specified by
1780 thread_db_extra_thread_info (struct target_ops *self,
1781 struct thread_info *info)
1783 if (info->private == NULL)
1786 if (info->private->dying)
1792 /* Get the address of the thread local variable in load module LM which
1793 is stored at OFFSET within the thread local storage for thread PTID. */
1796 thread_db_get_thread_local_address (struct target_ops *ops,
1801 struct thread_info *thread_info;
1802 struct target_ops *beneath;
1804 /* If we have not discovered any threads yet, check now. */
1805 if (!have_threads (ptid))
1806 thread_db_find_new_threads_1 (ptid);
1808 /* Find the matching thread. */
1809 thread_info = find_thread_ptid (ptid);
1811 if (thread_info != NULL && thread_info->private != NULL)
1815 struct thread_db_info *info;
1817 info = get_thread_db_info (ptid_get_pid (ptid));
1819 /* Finally, get the address of the variable. */
1822 /* glibc doesn't provide the needed interface. */
1823 if (!info->td_thr_tls_get_addr_p)
1824 throw_error (TLS_NO_LIBRARY_SUPPORT_ERROR,
1825 _("No TLS library support"));
1827 /* Note the cast through uintptr_t: this interface only works if
1828 a target address fits in a psaddr_t, which is a host pointer.
1829 So a 32-bit debugger can not access 64-bit TLS through this. */
1830 err = info->td_thr_tls_get_addr_p (&thread_info->private->th,
1831 (psaddr_t)(uintptr_t) lm,
1836 /* If glibc doesn't provide the needed interface throw an error
1837 that LM is zero - normally cases it should not be. */
1838 if (!info->td_thr_tlsbase_p)
1839 throw_error (TLS_LOAD_MODULE_NOT_FOUND_ERROR,
1840 _("TLS load module not found"));
1842 /* This code path handles the case of -static -pthread executables:
1843 https://sourceware.org/ml/libc-help/2014-03/msg00024.html
1844 For older GNU libc r_debug.r_map is NULL. For GNU libc after
1845 PR libc/16831 due to GDB PR threads/16954 LOAD_MODULE is also NULL.
1846 The constant number 1 depends on GNU __libc_setup_tls
1847 initialization of l_tls_modid to 1. */
1848 err = info->td_thr_tlsbase_p (&thread_info->private->th,
1850 address = (char *) address + offset;
1853 #ifdef THREAD_DB_HAS_TD_NOTALLOC
1854 /* The memory hasn't been allocated, yet. */
1855 if (err == TD_NOTALLOC)
1856 /* Now, if libthread_db provided the initialization image's
1857 address, we *could* try to build a non-lvalue value from
1858 the initialization image. */
1859 throw_error (TLS_NOT_ALLOCATED_YET_ERROR,
1860 _("TLS not allocated yet"));
1863 /* Something else went wrong. */
1865 throw_error (TLS_GENERIC_ERROR,
1866 (("%s")), thread_db_err_str (err));
1868 /* Cast assuming host == target. Joy. */
1869 /* Do proper sign extension for the target. */
1870 gdb_assert (exec_bfd);
1871 return (bfd_get_sign_extend_vma (exec_bfd) > 0
1872 ? (CORE_ADDR) (intptr_t) address
1873 : (CORE_ADDR) (uintptr_t) address);
1876 beneath = find_target_beneath (ops);
1877 return beneath->to_get_thread_local_address (beneath, ptid, lm, offset);
1880 /* Callback routine used to find a thread based on the TID part of
1884 thread_db_find_thread_from_tid (struct thread_info *thread, void *data)
1886 long *tid = (long *) data;
1888 if (thread->private->tid == *tid)
1894 /* Implement the to_get_ada_task_ptid target method for this target. */
1897 thread_db_get_ada_task_ptid (struct target_ops *self, long lwp, long thread)
1899 struct thread_info *thread_info;
1901 thread_db_find_new_threads_1 (inferior_ptid);
1902 thread_info = iterate_over_threads (thread_db_find_thread_from_tid, &thread);
1904 gdb_assert (thread_info != NULL);
1906 return (thread_info->ptid);
1910 thread_db_resume (struct target_ops *ops,
1911 ptid_t ptid, int step, enum gdb_signal signo)
1913 struct target_ops *beneath = find_target_beneath (ops);
1914 struct thread_db_info *info;
1916 if (ptid_equal (ptid, minus_one_ptid))
1917 info = get_thread_db_info (ptid_get_pid (inferior_ptid));
1919 info = get_thread_db_info (ptid_get_pid (ptid));
1921 /* This workaround is only needed for child fork lwps stopped in a
1922 PTRACE_O_TRACEFORK event. When the inferior is resumed, the
1923 workaround can be disabled. */
1925 info->need_stale_parent_threads_check = 0;
1927 beneath->to_resume (beneath, ptid, step, signo);
1930 /* qsort helper function for info_auto_load_libthread_db, sort the
1931 thread_db_info pointers primarily by their FILENAME and secondarily by their
1932 PID, both in ascending order. */
1935 info_auto_load_libthread_db_compare (const void *ap, const void *bp)
1937 struct thread_db_info *a = *(struct thread_db_info **) ap;
1938 struct thread_db_info *b = *(struct thread_db_info **) bp;
1941 retval = strcmp (a->filename, b->filename);
1945 return (a->pid > b->pid) - (a->pid - b->pid);
1948 /* Implement 'info auto-load libthread-db'. */
1951 info_auto_load_libthread_db (char *args, int from_tty)
1953 struct ui_out *uiout = current_uiout;
1954 const char *cs = args ? args : "";
1955 struct thread_db_info *info, **array;
1956 unsigned info_count, unique_filenames;
1957 size_t max_filename_len, max_pids_len, pids_len;
1958 struct cleanup *back_to;
1962 cs = skip_spaces_const (cs);
1964 error (_("'info auto-load libthread-db' does not accept any parameters"));
1967 for (info = thread_db_list; info; info = info->next)
1968 if (info->filename != NULL)
1971 array = xmalloc (sizeof (*array) * info_count);
1972 back_to = make_cleanup (xfree, array);
1975 for (info = thread_db_list; info; info = info->next)
1976 if (info->filename != NULL)
1977 array[info_count++] = info;
1979 /* Sort ARRAY by filenames and PIDs. */
1981 qsort (array, info_count, sizeof (*array),
1982 info_auto_load_libthread_db_compare);
1984 /* Calculate the number of unique filenames (rows) and the maximum string
1985 length of PIDs list for the unique filenames (columns). */
1987 unique_filenames = 0;
1988 max_filename_len = 0;
1991 for (i = 0; i < info_count; i++)
1993 int pid = array[i]->pid;
1994 size_t this_pid_len;
1996 for (this_pid_len = 0; pid != 0; pid /= 10)
1999 if (i == 0 || strcmp (array[i - 1]->filename, array[i]->filename) != 0)
2002 max_filename_len = max (max_filename_len,
2003 strlen (array[i]->filename));
2007 pids_len -= strlen (", ");
2008 max_pids_len = max (max_pids_len, pids_len);
2012 pids_len += this_pid_len + strlen (", ");
2016 pids_len -= strlen (", ");
2017 max_pids_len = max (max_pids_len, pids_len);
2020 /* Table header shifted right by preceding "libthread-db: " would not match
2022 if (info_count > 0 && args == auto_load_info_scripts_pattern_nl)
2023 ui_out_text (uiout, "\n");
2025 make_cleanup_ui_out_table_begin_end (uiout, 2, unique_filenames,
2026 "LinuxThreadDbTable");
2028 ui_out_table_header (uiout, max_filename_len, ui_left, "filename",
2030 ui_out_table_header (uiout, pids_len, ui_left, "PIDs", "Pids");
2031 ui_out_table_body (uiout);
2033 pids = xmalloc (max_pids_len + 1);
2034 make_cleanup (xfree, pids);
2036 /* Note I is incremented inside the cycle, not at its end. */
2037 for (i = 0; i < info_count;)
2039 struct cleanup *chain = make_cleanup_ui_out_tuple_begin_end (uiout, NULL);
2043 ui_out_field_string (uiout, "filename", info->filename);
2046 while (i < info_count && strcmp (info->filename, array[i]->filename) == 0)
2048 if (pids_end != pids)
2053 pids_end += xsnprintf (pids_end, &pids[max_pids_len + 1] - pids_end,
2054 "%u", array[i]->pid);
2055 gdb_assert (pids_end < &pids[max_pids_len + 1]);
2061 ui_out_field_string (uiout, "pids", pids);
2063 ui_out_text (uiout, "\n");
2064 do_cleanups (chain);
2067 do_cleanups (back_to);
2069 if (info_count == 0)
2070 ui_out_message (uiout, 0, _("No auto-loaded libthread-db.\n"));
2074 init_thread_db_ops (void)
2076 thread_db_ops.to_shortname = "multi-thread";
2077 thread_db_ops.to_longname = "multi-threaded child process.";
2078 thread_db_ops.to_doc = "Threads and pthreads support.";
2079 thread_db_ops.to_detach = thread_db_detach;
2080 thread_db_ops.to_wait = thread_db_wait;
2081 thread_db_ops.to_resume = thread_db_resume;
2082 thread_db_ops.to_mourn_inferior = thread_db_mourn_inferior;
2083 thread_db_ops.to_find_new_threads = thread_db_find_new_threads;
2084 thread_db_ops.to_pid_to_str = thread_db_pid_to_str;
2085 thread_db_ops.to_stratum = thread_stratum;
2086 thread_db_ops.to_has_thread_control = tc_schedlock;
2087 thread_db_ops.to_get_thread_local_address
2088 = thread_db_get_thread_local_address;
2089 thread_db_ops.to_extra_thread_info = thread_db_extra_thread_info;
2090 thread_db_ops.to_get_ada_task_ptid = thread_db_get_ada_task_ptid;
2091 thread_db_ops.to_magic = OPS_MAGIC;
2093 complete_target_initialization (&thread_db_ops);
2096 /* Provide a prototype to silence -Wmissing-prototypes. */
2097 extern initialize_file_ftype _initialize_thread_db;
2100 _initialize_thread_db (void)
2102 init_thread_db_ops ();
2104 /* Defer loading of libthread_db.so until inferior is running.
2105 This allows gdb to load correct libthread_db for a given
2106 executable -- there could be mutiple versions of glibc,
2107 compiled with LinuxThreads or NPTL, and until there is
2108 a running inferior, we can't tell which libthread_db is
2109 the correct one to load. */
2111 libthread_db_search_path = xstrdup (LIBTHREAD_DB_SEARCH_PATH);
2113 add_setshow_optional_filename_cmd ("libthread-db-search-path",
2115 &libthread_db_search_path, _("\
2116 Set search path for libthread_db."), _("\
2117 Show the current search path or libthread_db."), _("\
2118 This path is used to search for libthread_db to be loaded into \
2120 Its value is a colon (':') separate list of directories to search.\n\
2121 Setting the search path to an empty list resets it to its default value."),
2122 set_libthread_db_search_path,
2124 &setlist, &showlist);
2126 add_setshow_zuinteger_cmd ("libthread-db", class_maintenance,
2127 &libthread_db_debug, _("\
2128 Set libthread-db debugging."), _("\
2129 Show libthread-db debugging."), _("\
2130 When non-zero, libthread-db debugging is enabled."),
2132 show_libthread_db_debug,
2133 &setdebuglist, &showdebuglist);
2135 add_setshow_boolean_cmd ("libthread-db", class_support,
2136 &auto_load_thread_db, _("\
2137 Enable or disable auto-loading of inferior specific libthread_db."), _("\
2138 Show whether auto-loading inferior specific libthread_db is enabled."), _("\
2139 If enabled, libthread_db will be searched in 'set libthread-db-search-path'\n\
2140 locations to load libthread_db compatible with the inferior.\n\
2141 Standard system libthread_db still gets loaded even with this option off.\n\
2142 This options has security implications for untrusted inferiors."),
2143 NULL, show_auto_load_thread_db,
2144 auto_load_set_cmdlist_get (),
2145 auto_load_show_cmdlist_get ());
2147 add_cmd ("libthread-db", class_info, info_auto_load_libthread_db,
2148 _("Print the list of loaded inferior specific libthread_db.\n\
2149 Usage: info auto-load libthread-db"),
2150 auto_load_info_cmdlist_get ());
2152 /* Add ourselves to objfile event chain. */
2153 observer_attach_new_objfile (thread_db_new_objfile);
2155 /* Add ourselves to inferior_created event chain.
2156 This is needed to handle debugging statically linked programs where
2157 the new_objfile observer won't get called for libpthread. */
2158 observer_attach_inferior_created (thread_db_inferior_created);