1 /* libthread_db assisted debugging support, generic parts.
3 Copyright (C) 1999-2015 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_proc_service.h"
23 #include "nat/gdb_thread_db.h"
28 #include "gdbthread.h"
36 #include "solib-svr4.h"
39 #include "linux-nat.h"
40 #include "nat/linux-procfs.h"
41 #include "nat/linux-ptrace.h"
42 #include "nat/linux-osdata.h"
43 #include "auto-load.h"
44 #include "cli/cli-utils.h"
47 #include "nat/linux-namespaces.h"
49 /* GNU/Linux libthread_db support.
51 libthread_db is a library, provided along with libpthread.so, which
52 exposes the internals of the thread library to a debugger. It
53 allows GDB to find existing threads, new threads as they are
54 created, thread IDs (usually, the result of pthread_self), and
55 thread-local variables.
57 The libthread_db interface originates on Solaris, where it is
58 both more powerful and more complicated. This implementation
59 only works for LinuxThreads and NPTL, the two glibc threading
60 libraries. It assumes that each thread is permanently assigned
61 to a single light-weight process (LWP).
63 libthread_db-specific information is stored in the "private" field
64 of struct thread_info. When the field is NULL we do not yet have
65 information about the new thread; this could be temporary (created,
66 but the thread library's data structures do not reflect it yet)
67 or permanent (created using clone instead of pthread_create).
69 Process IDs managed by linux-thread-db.c match those used by
70 linux-nat.c: a common PID for all processes, an LWP ID for each
71 thread, and no TID. We save the TID in private. Keeping it out
72 of the ptid_t prevents thread IDs changing when libpthread is
73 loaded or unloaded. */
75 static char *libthread_db_search_path
;
77 /* Set to non-zero if thread_db auto-loading is enabled
78 by the "set auto-load libthread-db" command. */
79 static int auto_load_thread_db
= 1;
81 /* Returns true if we need to use thread_db thread create/death event
82 breakpoints to learn about threads. */
85 thread_db_use_events (void)
87 /* Not necessary if the kernel supports clone events. */
88 return !linux_supports_traceclone ();
91 /* "show" command for the auto_load_thread_db configuration variable. */
94 show_auto_load_thread_db (struct ui_file
*file
, int from_tty
,
95 struct cmd_list_element
*c
, const char *value
)
97 fprintf_filtered (file
, _("Auto-loading of inferior specific libthread_db "
103 set_libthread_db_search_path (char *ignored
, int from_tty
,
104 struct cmd_list_element
*c
)
106 if (*libthread_db_search_path
== '\0')
108 xfree (libthread_db_search_path
);
109 libthread_db_search_path
= xstrdup (LIBTHREAD_DB_SEARCH_PATH
);
113 /* If non-zero, print details of libthread_db processing. */
115 static unsigned int libthread_db_debug
;
118 show_libthread_db_debug (struct ui_file
*file
, int from_tty
,
119 struct cmd_list_element
*c
, const char *value
)
121 fprintf_filtered (file
, _("libthread-db debugging is %s.\n"), value
);
124 /* If we're running on GNU/Linux, we must explicitly attach to any new
127 /* This module's target vector. */
128 static struct target_ops thread_db_ops
;
130 /* Non-zero if we have determined the signals used by the threads
132 static int thread_signals
;
133 static sigset_t thread_stop_set
;
134 static sigset_t thread_print_set
;
136 struct thread_db_info
138 struct thread_db_info
*next
;
140 /* Process id this object refers to. */
143 /* Handle from dlopen for libthread_db.so. */
146 /* Absolute pathname from gdb_realpath to disk file used for dlopen-ing
147 HANDLE. It may be NULL for system library. */
150 /* Structure that identifies the child process for the
151 <proc_service.h> interface. */
152 struct ps_prochandle proc_handle
;
154 /* Connection to the libthread_db library. */
155 td_thragent_t
*thread_agent
;
157 /* True if we need to apply the workaround for glibc/BZ5983. When
158 we catch a PTRACE_O_TRACEFORK, and go query the child's thread
159 list, nptl_db returns the parent's threads in addition to the new
160 (single) child thread. If this flag is set, we do extra work to
161 be able to ignore such stale entries. */
162 int need_stale_parent_threads_check
;
164 /* Location of the thread creation event breakpoint. The code at
165 this location in the child process will be called by the pthread
166 library whenever a new thread is created. By setting a special
167 breakpoint at this location, GDB can detect when a new thread is
168 created. We obtain this location via the td_ta_event_addr
170 CORE_ADDR td_create_bp_addr
;
172 /* Location of the thread death event breakpoint. */
173 CORE_ADDR td_death_bp_addr
;
175 /* Pointers to the libthread_db functions. */
177 td_init_ftype
*td_init_p
;
178 td_ta_new_ftype
*td_ta_new_p
;
179 td_ta_map_lwp2thr_ftype
*td_ta_map_lwp2thr_p
;
180 td_ta_thr_iter_ftype
*td_ta_thr_iter_p
;
181 td_ta_event_addr_ftype
*td_ta_event_addr_p
;
182 td_ta_set_event_ftype
*td_ta_set_event_p
;
183 td_ta_clear_event_ftype
*td_ta_clear_event_p
;
184 td_ta_event_getmsg_ftype
* td_ta_event_getmsg_p
;
185 td_thr_validate_ftype
*td_thr_validate_p
;
186 td_thr_get_info_ftype
*td_thr_get_info_p
;
187 td_thr_event_enable_ftype
*td_thr_event_enable_p
;
188 td_thr_tls_get_addr_ftype
*td_thr_tls_get_addr_p
;
189 td_thr_tlsbase_ftype
*td_thr_tlsbase_p
;
192 /* List of known processes using thread_db, and the required
194 struct thread_db_info
*thread_db_list
;
196 static void thread_db_find_new_threads_1 (ptid_t ptid
);
197 static void thread_db_find_new_threads_2 (ptid_t ptid
, int until_no_new
);
199 static void check_thread_signals (void);
201 static struct thread_info
*record_thread
202 (struct thread_db_info
*info
, struct thread_info
*tp
,
203 ptid_t ptid
, const td_thrhandle_t
*th_p
, const td_thrinfo_t
*ti_p
);
205 /* Add the current inferior to the list of processes using libpthread.
206 Return a pointer to the newly allocated object that was added to
207 THREAD_DB_LIST. HANDLE is the handle returned by dlopen'ing
210 static struct thread_db_info
*
211 add_thread_db_info (void *handle
)
213 struct thread_db_info
*info
= XCNEW (struct thread_db_info
);
215 info
->pid
= ptid_get_pid (inferior_ptid
);
216 info
->handle
= handle
;
218 /* The workaround works by reading from /proc/pid/status, so it is
219 disabled for core files. */
220 if (target_has_execution
)
221 info
->need_stale_parent_threads_check
= 1;
223 info
->next
= thread_db_list
;
224 thread_db_list
= info
;
229 /* Return the thread_db_info object representing the bookkeeping
230 related to process PID, if any; NULL otherwise. */
232 static struct thread_db_info
*
233 get_thread_db_info (int pid
)
235 struct thread_db_info
*info
;
237 for (info
= thread_db_list
; info
; info
= info
->next
)
238 if (pid
== info
->pid
)
244 /* When PID has exited or has been detached, we no longer want to keep
245 track of it as using libpthread. Call this function to discard
246 thread_db related info related to PID. Note that this closes
247 LIBTHREAD_DB_SO's dlopen'ed handle. */
250 delete_thread_db_info (int pid
)
252 struct thread_db_info
*info
, *info_prev
;
256 for (info
= thread_db_list
; info
; info_prev
= info
, info
= info
->next
)
257 if (pid
== info
->pid
)
263 if (info
->handle
!= NULL
)
264 dlclose (info
->handle
);
266 xfree (info
->filename
);
269 info_prev
->next
= info
->next
;
271 thread_db_list
= info
->next
;
276 /* Prototypes for local functions. */
277 static int attach_thread (ptid_t ptid
, const td_thrhandle_t
*th_p
,
278 const td_thrinfo_t
*ti_p
);
279 static void detach_thread (ptid_t ptid
);
282 /* Use "struct private_thread_info" to cache thread state. This is
283 a substantial optimization. */
285 struct private_thread_info
287 /* Flag set when we see a TD_DEATH event for this thread. */
288 unsigned int dying
:1;
290 /* Cached thread state. */
297 thread_db_err_str (td_err_e err
)
304 return "generic 'call succeeded'";
306 return "generic error";
308 return "no thread to satisfy query";
310 return "no sync handle to satisfy query";
312 return "no LWP to satisfy query";
314 return "invalid process handle";
316 return "invalid thread handle";
318 return "invalid synchronization handle";
320 return "invalid thread agent";
322 return "invalid key";
324 return "no event message for getmsg";
326 return "FPU register set not available";
328 return "application not linked with libthread";
330 return "requested event is not supported";
332 return "capability not available";
334 return "debugger service failed";
336 return "operation not applicable to";
338 return "no thread-specific data for this thread";
340 return "malloc failed";
342 return "only part of register set was written/read";
344 return "X register set not available for this thread";
345 #ifdef THREAD_DB_HAS_TD_NOTALLOC
347 return "thread has not yet allocated TLS for given module";
349 #ifdef THREAD_DB_HAS_TD_VERSION
351 return "versions of libpthread and libthread_db do not match";
353 #ifdef THREAD_DB_HAS_TD_NOTLS
355 return "there is no TLS segment in the given module";
358 snprintf (buf
, sizeof (buf
), "unknown thread_db error '%d'", err
);
363 /* Return 1 if any threads have been registered. There may be none if
364 the threading library is not fully initialized yet. */
367 have_threads_callback (struct thread_info
*thread
, void *args
)
369 int pid
= * (int *) args
;
371 if (ptid_get_pid (thread
->ptid
) != pid
)
374 return thread
->priv
!= NULL
;
378 have_threads (ptid_t ptid
)
380 int pid
= ptid_get_pid (ptid
);
382 return iterate_over_threads (have_threads_callback
, &pid
) != NULL
;
386 /* Fetch the user-level thread id of PTID. */
388 static struct thread_info
*
389 thread_from_lwp (ptid_t ptid
)
394 struct thread_db_info
*info
;
395 struct thread_info
*tp
;
397 /* Just in case td_ta_map_lwp2thr doesn't initialize it completely. */
400 /* This ptid comes from linux-nat.c, which should always fill in the
402 gdb_assert (ptid_get_lwp (ptid
) != 0);
404 info
= get_thread_db_info (ptid_get_pid (ptid
));
406 /* Access an lwp we know is stopped. */
407 info
->proc_handle
.ptid
= ptid
;
408 err
= info
->td_ta_map_lwp2thr_p (info
->thread_agent
, ptid_get_lwp (ptid
),
411 error (_("Cannot find user-level thread for LWP %ld: %s"),
412 ptid_get_lwp (ptid
), thread_db_err_str (err
));
414 err
= info
->td_thr_get_info_p (&th
, &ti
);
416 error (_("thread_get_info_callback: cannot get thread info: %s"),
417 thread_db_err_str (err
));
419 /* Fill the cache. */
420 tp
= find_thread_ptid (ptid
);
421 return record_thread (info
, tp
, ptid
, &th
, &ti
);
425 /* See linux-nat.h. */
428 thread_db_notice_clone (ptid_t parent
, ptid_t child
)
433 struct thread_db_info
*info
;
435 info
= get_thread_db_info (ptid_get_pid (child
));
440 thread_from_lwp (child
);
442 /* If we do not know about the main thread yet, this would be a good
444 thread_from_lwp (parent
);
449 verbose_dlsym (void *handle
, const char *name
)
451 void *sym
= dlsym (handle
, name
);
453 warning (_("Symbol \"%s\" not found in libthread_db: %s"),
459 enable_thread_event (td_event_e event
, CORE_ADDR
*bp
)
463 struct thread_db_info
*info
;
465 info
= get_thread_db_info (ptid_get_pid (inferior_ptid
));
467 /* Access an lwp we know is stopped. */
468 info
->proc_handle
.ptid
= inferior_ptid
;
470 /* Get the breakpoint address for thread EVENT. */
471 err
= info
->td_ta_event_addr_p (info
->thread_agent
, event
, ¬ify
);
475 /* Set up the breakpoint. */
476 gdb_assert (exec_bfd
);
477 (*bp
) = (gdbarch_convert_from_func_ptr_addr
479 /* Do proper sign extension for the target. */
480 (bfd_get_sign_extend_vma (exec_bfd
) > 0
481 ? (CORE_ADDR
) (intptr_t) notify
.u
.bptaddr
482 : (CORE_ADDR
) (uintptr_t) notify
.u
.bptaddr
),
484 create_thread_event_breakpoint (target_gdbarch (), *bp
);
489 /* Verify inferior's '\0'-terminated symbol VER_SYMBOL starts with "%d.%d" and
490 return 1 if this version is lower (and not equal) to
491 VER_MAJOR_MIN.VER_MINOR_MIN. Return 0 in all other cases. */
494 inferior_has_bug (const char *ver_symbol
, int ver_major_min
, int ver_minor_min
)
496 struct bound_minimal_symbol version_msym
;
497 CORE_ADDR version_addr
;
499 int err
, got
, retval
= 0;
501 version_msym
= lookup_minimal_symbol (ver_symbol
, NULL
, NULL
);
502 if (version_msym
.minsym
== NULL
)
505 version_addr
= BMSYMBOL_VALUE_ADDRESS (version_msym
);
506 got
= target_read_string (version_addr
, &version
, 32, &err
);
507 if (err
== 0 && memchr (version
, 0, got
) == &version
[got
-1])
511 retval
= (sscanf (version
, "%d.%d", &major
, &minor
) == 2
512 && (major
< ver_major_min
513 || (major
== ver_major_min
&& minor
< ver_minor_min
)));
521 enable_thread_event_reporting (void)
523 td_thr_events_t events
;
525 struct thread_db_info
*info
;
527 info
= get_thread_db_info (ptid_get_pid (inferior_ptid
));
529 /* We cannot use the thread event reporting facility if these
530 functions aren't available. */
531 if (info
->td_ta_event_addr_p
== NULL
532 || info
->td_ta_set_event_p
== NULL
533 || info
->td_ta_event_getmsg_p
== NULL
534 || info
->td_thr_event_enable_p
== NULL
)
537 /* Set the process wide mask saying which events we're interested in. */
538 td_event_emptyset (&events
);
539 td_event_addset (&events
, TD_CREATE
);
541 /* There is a bug fixed between linuxthreads 2.1.3 and 2.2 by
542 commit 2e4581e4fba917f1779cd0a010a45698586c190a
543 * manager.c (pthread_exited): Correctly report event as TD_REAP
544 instead of TD_DEATH. Fix comments.
545 where event reporting facility is broken for TD_DEATH events,
546 so don't enable it if we have glibc but a lower version. */
547 if (!inferior_has_bug ("__linuxthreads_version", 2, 2))
548 td_event_addset (&events
, TD_DEATH
);
550 err
= info
->td_ta_set_event_p (info
->thread_agent
, &events
);
553 warning (_("Unable to set global thread event mask: %s"),
554 thread_db_err_str (err
));
558 /* Delete previous thread event breakpoints, if any. */
559 remove_thread_event_breakpoints ();
560 info
->td_create_bp_addr
= 0;
561 info
->td_death_bp_addr
= 0;
563 /* Set up the thread creation event. */
564 err
= enable_thread_event (TD_CREATE
, &info
->td_create_bp_addr
);
567 warning (_("Unable to get location for thread creation breakpoint: %s"),
568 thread_db_err_str (err
));
572 /* Set up the thread death event. */
573 err
= enable_thread_event (TD_DEATH
, &info
->td_death_bp_addr
);
576 warning (_("Unable to get location for thread death breakpoint: %s"),
577 thread_db_err_str (err
));
582 /* Similar as thread_db_find_new_threads_1, but try to silently ignore errors
585 Return 1 if the caller should abort libthread_db initialization. Return 0
589 thread_db_find_new_threads_silently (ptid_t ptid
)
594 thread_db_find_new_threads_2 (ptid
, 1);
597 CATCH (except
, RETURN_MASK_ERROR
)
599 if (libthread_db_debug
)
600 exception_fprintf (gdb_stdlog
, except
,
601 "Warning: thread_db_find_new_threads_silently: ");
603 /* There is a bug fixed between nptl 2.6.1 and 2.7 by
604 commit 7d9d8bd18906fdd17364f372b160d7ab896ce909
605 where calls to td_thr_get_info fail with TD_ERR for statically linked
606 executables if td_thr_get_info is called before glibc has initialized
609 If the nptl bug is NOT present in the inferior and still thread_db
610 reports an error return 1. It means the inferior has corrupted thread
611 list and GDB should fall back only to LWPs.
613 If the nptl bug is present in the inferior return 0 to silently ignore
614 such errors, and let gdb enumerate threads again later. In such case
615 GDB cannot properly display LWPs if the inferior thread list is
616 corrupted. For core files it does not apply, no 'later enumeration'
619 if (!target_has_execution
|| !inferior_has_bug ("nptl_version", 2, 7))
621 exception_fprintf (gdb_stderr
, except
,
622 _("Warning: couldn't activate thread debugging "
623 "using libthread_db: "));
632 /* Lookup a library in which given symbol resides.
633 Note: this is looking in GDB process, not in the inferior.
634 Returns library name, or NULL. */
637 dladdr_to_soname (const void *addr
)
641 if (dladdr (addr
, &info
) != 0)
642 return info
.dli_fname
;
646 /* Attempt to initialize dlopen()ed libthread_db, described by INFO.
648 Failure could happen if libthread_db does not have symbols we expect,
649 or when it refuses to work with the current inferior (e.g. due to
650 version mismatch between libthread_db and libpthread). */
653 try_thread_db_load_1 (struct thread_db_info
*info
)
657 /* Initialize pointers to the dynamic library functions we will use.
658 Essential functions first. */
660 #define TDB_VERBOSE_DLSYM(info, func) \
661 info->func ## _p = (func ## _ftype *) verbose_dlsym (info->handle, #func)
663 #define TDB_DLSYM(info, func) \
664 info->func ## _p = (func ## _ftype *) dlsym (info->handle, #func)
673 CHK (TDB_VERBOSE_DLSYM (info
, td_init
));
675 err
= info
->td_init_p ();
678 warning (_("Cannot initialize libthread_db: %s"),
679 thread_db_err_str (err
));
683 CHK (TDB_VERBOSE_DLSYM (info
, td_ta_new
));
685 /* Initialize the structure that identifies the child process. */
686 info
->proc_handle
.ptid
= inferior_ptid
;
688 /* Now attempt to open a connection to the thread library. */
689 err
= info
->td_ta_new_p (&info
->proc_handle
, &info
->thread_agent
);
692 if (libthread_db_debug
)
693 fprintf_unfiltered (gdb_stdlog
, _("td_ta_new failed: %s\n"),
694 thread_db_err_str (err
));
699 #ifdef THREAD_DB_HAS_TD_VERSION
702 /* The errors above are not unexpected and silently ignored:
703 they just mean we haven't found correct version of
707 warning (_("td_ta_new failed: %s"), thread_db_err_str (err
));
712 /* These are essential. */
713 CHK (TDB_VERBOSE_DLSYM (info
, td_ta_map_lwp2thr
));
714 CHK (TDB_VERBOSE_DLSYM (info
, td_ta_thr_iter
));
715 CHK (TDB_VERBOSE_DLSYM (info
, td_thr_validate
));
716 CHK (TDB_VERBOSE_DLSYM (info
, td_thr_get_info
));
718 /* These are not essential. */
719 TDB_DLSYM (info
, td_ta_event_addr
);
720 TDB_DLSYM (info
, td_ta_set_event
);
721 TDB_DLSYM (info
, td_ta_clear_event
);
722 TDB_DLSYM (info
, td_ta_event_getmsg
);
723 TDB_DLSYM (info
, td_thr_event_enable
);
724 TDB_DLSYM (info
, td_thr_tls_get_addr
);
725 TDB_DLSYM (info
, td_thr_tlsbase
);
727 #undef TDB_VERBOSE_DLSYM
731 /* It's best to avoid td_ta_thr_iter if possible. That walks data
732 structures in the inferior's address space that may be corrupted,
733 or, if the target is running, may change while we walk them. If
734 there's execution (and /proc is mounted), then we're already
735 attached to all LWPs. Use thread_from_lwp, which uses
736 td_ta_map_lwp2thr instead, which does not walk the thread list.
738 td_ta_map_lwp2thr uses ps_get_thread_area, but we can't use that
739 currently on core targets, as it uses ptrace directly. */
740 if (target_has_execution
741 && linux_proc_task_list_dir_exists (ptid_get_pid (inferior_ptid
)))
744 int pid
= ptid_get_pid (inferior_ptid
);
746 linux_stop_and_wait_all_lwps ();
749 if (ptid_get_pid (lp
->ptid
) == pid
)
750 thread_from_lwp (lp
->ptid
);
752 linux_unstop_all_lwps ();
754 else if (thread_db_find_new_threads_silently (inferior_ptid
) != 0)
756 /* Even if libthread_db initializes, if the thread list is
757 corrupted, we'd not manage to list any threads. Better reject this
758 thread_db, and fall back to at least listing LWPs. */
762 printf_unfiltered (_("[Thread debugging using libthread_db enabled]\n"));
764 if (*libthread_db_search_path
|| libthread_db_debug
)
766 struct ui_file
*file
;
769 library
= dladdr_to_soname ((const void *) *info
->td_ta_new_p
);
771 library
= LIBTHREAD_DB_SO
;
773 /* If we'd print this to gdb_stdout when debug output is
774 disabled, still print it to gdb_stdout if debug output is
775 enabled. User visible output should not depend on debug
777 file
= *libthread_db_search_path
!= '\0' ? gdb_stdout
: gdb_stdlog
;
778 fprintf_unfiltered (file
, _("Using host libthread_db library \"%s\".\n"),
782 /* The thread library was detected. Activate the thread_db target
783 if this is the first process using it. */
784 if (thread_db_list
->next
== NULL
)
785 push_target (&thread_db_ops
);
787 /* Enable event reporting, but not when debugging a core file. */
788 if (target_has_execution
&& thread_db_use_events ())
789 enable_thread_event_reporting ();
794 /* Attempt to use LIBRARY as libthread_db. LIBRARY could be absolute,
795 relative, or just LIBTHREAD_DB. */
798 try_thread_db_load (const char *library
, int check_auto_load_safe
)
801 struct thread_db_info
*info
;
803 if (libthread_db_debug
)
804 fprintf_unfiltered (gdb_stdlog
,
805 _("Trying host libthread_db library: %s.\n"),
808 if (check_auto_load_safe
)
810 if (access (library
, R_OK
) != 0)
812 /* Do not print warnings by file_is_auto_load_safe if the library does
813 not exist at this place. */
814 if (libthread_db_debug
)
815 fprintf_unfiltered (gdb_stdlog
, _("open failed: %s.\n"),
816 safe_strerror (errno
));
820 if (!file_is_auto_load_safe (library
, _("auto-load: Loading libthread-db "
821 "library \"%s\" from explicit "
827 handle
= dlopen (library
, RTLD_NOW
);
830 if (libthread_db_debug
)
831 fprintf_unfiltered (gdb_stdlog
, _("dlopen failed: %s.\n"), dlerror ());
835 if (libthread_db_debug
&& strchr (library
, '/') == NULL
)
839 td_init
= dlsym (handle
, "td_init");
842 const char *const libpath
= dladdr_to_soname (td_init
);
845 fprintf_unfiltered (gdb_stdlog
, _("Host %s resolved to: %s.\n"),
850 info
= add_thread_db_info (handle
);
852 /* Do not save system library name, that one is always trusted. */
853 if (strchr (library
, '/') != NULL
)
854 info
->filename
= gdb_realpath (library
);
856 if (try_thread_db_load_1 (info
))
859 /* This library "refused" to work on current inferior. */
860 delete_thread_db_info (ptid_get_pid (inferior_ptid
));
864 /* Subroutine of try_thread_db_load_from_pdir to simplify it.
865 Try loading libthread_db in directory(OBJ)/SUBDIR.
866 SUBDIR may be NULL. It may also be something like "../lib64".
867 The result is true for success. */
870 try_thread_db_load_from_pdir_1 (struct objfile
*obj
, const char *subdir
)
872 struct cleanup
*cleanup
;
875 const char *obj_name
= objfile_name (obj
);
878 if (obj_name
[0] != '/')
880 warning (_("Expected absolute pathname for libpthread in the"
881 " inferior, but got %s."), obj_name
);
885 alloc_len
= (strlen (obj_name
)
886 + (subdir
? strlen (subdir
) + 1 : 0)
887 + 1 + strlen (LIBTHREAD_DB_SO
) + 1);
888 path
= (char *) xmalloc (alloc_len
);
889 cleanup
= make_cleanup (xfree
, path
);
891 strcpy (path
, obj_name
);
892 cp
= strrchr (path
, '/');
893 /* This should at minimum hit the first character. */
894 gdb_assert (cp
!= NULL
);
901 strcat (cp
, LIBTHREAD_DB_SO
);
903 result
= try_thread_db_load (path
, 1);
905 do_cleanups (cleanup
);
909 /* Handle $pdir in libthread-db-search-path.
910 Look for libthread_db in directory(libpthread)/SUBDIR.
911 SUBDIR may be NULL. It may also be something like "../lib64".
912 The result is true for success. */
915 try_thread_db_load_from_pdir (const char *subdir
)
919 if (!auto_load_thread_db
)
923 if (libpthread_name_p (objfile_name (obj
)))
925 if (try_thread_db_load_from_pdir_1 (obj
, subdir
))
928 /* We may have found the separate-debug-info version of
929 libpthread, and it may live in a directory without a matching
931 if (obj
->separate_debug_objfile_backlink
!= NULL
)
932 return try_thread_db_load_from_pdir_1 (obj
->separate_debug_objfile_backlink
,
941 /* Handle $sdir in libthread-db-search-path.
942 Look for libthread_db in the system dirs, or wherever a plain
943 dlopen(file_without_path) will look.
944 The result is true for success. */
947 try_thread_db_load_from_sdir (void)
949 return try_thread_db_load (LIBTHREAD_DB_SO
, 0);
952 /* Try to load libthread_db from directory DIR of length DIR_LEN.
953 The result is true for success. */
956 try_thread_db_load_from_dir (const char *dir
, size_t dir_len
)
958 struct cleanup
*cleanup
;
962 if (!auto_load_thread_db
)
965 path
= (char *) xmalloc (dir_len
+ 1 + strlen (LIBTHREAD_DB_SO
) + 1);
966 cleanup
= make_cleanup (xfree
, path
);
968 memcpy (path
, dir
, dir_len
);
970 strcpy (path
+ dir_len
+ 1, LIBTHREAD_DB_SO
);
972 result
= try_thread_db_load (path
, 1);
974 do_cleanups (cleanup
);
978 /* Search libthread_db_search_path for libthread_db which "agrees"
979 to work on current inferior.
980 The result is true for success. */
983 thread_db_load_search (void)
985 VEC (char_ptr
) *dir_vec
;
986 struct cleanup
*cleanups
;
990 dir_vec
= dirnames_to_char_ptr_vec (libthread_db_search_path
);
991 cleanups
= make_cleanup_free_char_ptr_vec (dir_vec
);
993 for (i
= 0; VEC_iterate (char_ptr
, dir_vec
, i
, this_dir
); ++i
)
995 const int pdir_len
= sizeof ("$pdir") - 1;
998 this_dir_len
= strlen (this_dir
);
1000 if (strncmp (this_dir
, "$pdir", pdir_len
) == 0
1001 && (this_dir
[pdir_len
] == '\0'
1002 || this_dir
[pdir_len
] == '/'))
1004 char *subdir
= NULL
;
1005 struct cleanup
*free_subdir_cleanup
1006 = make_cleanup (null_cleanup
, NULL
);
1008 if (this_dir
[pdir_len
] == '/')
1010 subdir
= (char *) xmalloc (strlen (this_dir
));
1011 make_cleanup (xfree
, subdir
);
1012 strcpy (subdir
, this_dir
+ pdir_len
+ 1);
1014 rc
= try_thread_db_load_from_pdir (subdir
);
1015 do_cleanups (free_subdir_cleanup
);
1019 else if (strcmp (this_dir
, "$sdir") == 0)
1021 if (try_thread_db_load_from_sdir ())
1029 if (try_thread_db_load_from_dir (this_dir
, this_dir_len
))
1037 do_cleanups (cleanups
);
1038 if (libthread_db_debug
)
1039 fprintf_unfiltered (gdb_stdlog
,
1040 _("thread_db_load_search returning %d\n"), rc
);
1044 /* Return non-zero if the inferior has a libpthread. */
1047 has_libpthread (void)
1049 struct objfile
*obj
;
1052 if (libpthread_name_p (objfile_name (obj
)))
1058 /* Attempt to load and initialize libthread_db.
1059 Return 1 on success. */
1062 thread_db_load (void)
1064 struct thread_db_info
*info
;
1066 info
= get_thread_db_info (ptid_get_pid (inferior_ptid
));
1071 /* Don't attempt to use thread_db on executables not running
1073 if (!target_has_registers
)
1076 /* Don't attempt to use thread_db for remote targets. */
1077 if (!(target_can_run (¤t_target
) || core_bfd
))
1080 if (thread_db_load_search ())
1083 /* We couldn't find a libthread_db.
1084 If the inferior has a libpthread warn the user. */
1085 if (has_libpthread ())
1087 warning (_("Unable to find libthread_db matching inferior's thread"
1088 " library, thread debugging will not be available."));
1092 /* Either this executable isn't using libpthread at all, or it is
1093 statically linked. Since we can't easily distinguish these two cases,
1094 no warning is issued. */
1099 disable_thread_event_reporting (struct thread_db_info
*info
)
1101 if (info
->td_ta_clear_event_p
!= NULL
)
1103 td_thr_events_t events
;
1105 /* Set the process wide mask saying we aren't interested in any
1107 td_event_fillset (&events
);
1108 info
->td_ta_clear_event_p (info
->thread_agent
, &events
);
1111 info
->td_create_bp_addr
= 0;
1112 info
->td_death_bp_addr
= 0;
1116 check_thread_signals (void)
1118 if (!thread_signals
)
1123 lin_thread_get_thread_signals (&mask
);
1124 sigemptyset (&thread_stop_set
);
1125 sigemptyset (&thread_print_set
);
1127 for (i
= 1; i
< NSIG
; i
++)
1129 if (sigismember (&mask
, i
))
1131 if (signal_stop_update (gdb_signal_from_host (i
), 0))
1132 sigaddset (&thread_stop_set
, i
);
1133 if (signal_print_update (gdb_signal_from_host (i
), 0))
1134 sigaddset (&thread_print_set
, i
);
1141 /* Check whether thread_db is usable. This function is called when
1142 an inferior is created (or otherwise acquired, e.g. attached to)
1143 and when new shared libraries are loaded into a running process. */
1146 check_for_thread_db (void)
1148 /* Do nothing if we couldn't load libthread_db.so.1. */
1149 if (!thread_db_load ())
1153 /* This function is called via the new_objfile observer. */
1156 thread_db_new_objfile (struct objfile
*objfile
)
1158 /* This observer must always be called with inferior_ptid set
1162 /* libpthread with separate debug info has its debug info file already
1163 loaded (and notified without successful thread_db initialization)
1164 the time observer_notify_new_objfile is called for the library itself.
1165 Static executables have their separate debug info loaded already
1166 before the inferior has started. */
1167 && objfile
->separate_debug_objfile_backlink
== NULL
1168 /* Only check for thread_db if we loaded libpthread,
1169 or if this is the main symbol file.
1170 We need to check OBJF_MAINLINE to handle the case of debugging
1171 a statically linked executable AND the symbol file is specified AFTER
1172 the exec file is loaded (e.g., gdb -c core ; file foo).
1173 For dynamically linked executables, libpthread can be near the end
1174 of the list of shared libraries to load, and in an app of several
1175 thousand shared libraries, this can otherwise be painful. */
1176 && ((objfile
->flags
& OBJF_MAINLINE
) != 0
1177 || libpthread_name_p (objfile_name (objfile
))))
1178 check_for_thread_db ();
1182 check_pid_namespace_match (void)
1184 /* Check is only relevant for local targets targets. */
1185 if (target_can_run (¤t_target
))
1187 /* If the child is in a different PID namespace, its idea of its
1188 PID will differ from our idea of its PID. When we scan the
1189 child's thread list, we'll mistakenly think it has no threads
1190 since the thread PID fields won't match the PID we give to
1192 if (!linux_ns_same (ptid_get_pid (inferior_ptid
), LINUX_NS_PID
))
1194 warning (_ ("Target and debugger are in different PID "
1195 "namespaces; thread lists and other data are "
1196 "likely unreliable"));
1201 /* This function is called via the inferior_created observer.
1202 This handles the case of debugging statically linked executables. */
1205 thread_db_inferior_created (struct target_ops
*target
, int from_tty
)
1207 check_pid_namespace_match ();
1208 check_for_thread_db ();
1211 /* Update the thread's state (what's displayed in "info threads"),
1212 from libthread_db thread state information. */
1215 update_thread_state (struct private_thread_info
*priv
,
1216 const td_thrinfo_t
*ti_p
)
1218 priv
->dying
= (ti_p
->ti_state
== TD_THR_UNKNOWN
1219 || ti_p
->ti_state
== TD_THR_ZOMBIE
);
1222 /* Attach to a new thread. This function is called when we receive a
1223 TD_CREATE event or when we iterate over all threads and find one
1224 that wasn't already in our list. Returns true on success. */
1227 attach_thread (ptid_t ptid
, const td_thrhandle_t
*th_p
,
1228 const td_thrinfo_t
*ti_p
)
1230 struct thread_info
*tp
;
1231 struct thread_db_info
*info
;
1233 /* If we're being called after a TD_CREATE event, we may already
1234 know about this thread. There are two ways this can happen. We
1235 may have iterated over all threads between the thread creation
1236 and the TD_CREATE event, for instance when the user has issued
1237 the `info threads' command before the SIGTRAP for hitting the
1238 thread creation breakpoint was reported. Alternatively, the
1239 thread may have exited and a new one been created with the same
1240 thread ID. In the first case we don't need to do anything; in
1241 the second case we should discard information about the dead
1242 thread and attach to the new one. */
1243 tp
= find_thread_ptid (ptid
);
1246 /* If tp->priv is NULL, then GDB is already attached to this
1247 thread, but we do not know anything about it. We can learn
1248 about it here. This can only happen if we have some other
1249 way besides libthread_db to notice new threads (i.e.
1250 PTRACE_EVENT_CLONE); assume the same mechanism notices thread
1251 exit, so this can not be a stale thread recreated with the
1253 if (tp
->priv
!= NULL
)
1255 if (!tp
->priv
->dying
)
1258 delete_thread (ptid
);
1263 /* Under GNU/Linux, we have to attach to each and every thread. */
1264 if (target_has_execution
1269 res
= lin_lwp_attach_lwp (ptid_build (ptid_get_pid (ptid
),
1273 /* Error, stop iterating. */
1278 /* Pretend this thread doesn't exist yet, and keep
1283 /* Otherwise, we sucessfully attached to the thread. */
1286 info
= get_thread_db_info (ptid_get_pid (ptid
));
1287 record_thread (info
, tp
, ptid
, th_p
, ti_p
);
1291 /* Record a new thread in GDB's thread list. Creates the thread's
1292 private info. If TP is NULL or TP is marked as having exited,
1293 creates a new thread. Otherwise, uses TP. */
1295 static struct thread_info
*
1296 record_thread (struct thread_db_info
*info
,
1297 struct thread_info
*tp
,
1298 ptid_t ptid
, const td_thrhandle_t
*th_p
,
1299 const td_thrinfo_t
*ti_p
)
1302 struct private_thread_info
*priv
;
1303 int new_thread
= (tp
== NULL
);
1305 /* A thread ID of zero may mean the thread library has not
1306 initialized yet. Leave private == NULL until the thread library
1308 if (ti_p
->ti_tid
== 0)
1311 /* Construct the thread's private data. */
1312 priv
= XCNEW (struct private_thread_info
);
1315 priv
->tid
= ti_p
->ti_tid
;
1316 update_thread_state (priv
, ti_p
);
1318 /* Add the thread to GDB's thread list. If we already know about a
1319 thread with this PTID, but it's marked exited, then the kernel
1320 reused the tid of an old thread. */
1321 if (tp
== NULL
|| tp
->state
== THREAD_EXITED
)
1322 tp
= add_thread_with_info (ptid
, priv
);
1326 /* Enable thread event reporting for this thread, except when
1327 debugging a core file. */
1328 if (target_has_execution
&& thread_db_use_events () && new_thread
)
1330 err
= info
->td_thr_event_enable_p (th_p
, 1);
1332 error (_("Cannot enable thread event reporting for %s: %s"),
1333 target_pid_to_str (ptid
), thread_db_err_str (err
));
1336 if (target_has_execution
)
1337 check_thread_signals ();
1343 detach_thread (ptid_t ptid
)
1345 struct thread_info
*thread_info
;
1347 /* Don't delete the thread now, because it still reports as active
1348 until it has executed a few instructions after the event
1349 breakpoint - if we deleted it now, "info threads" would cause us
1350 to re-attach to it. Just mark it as having had a TD_DEATH
1351 event. This means that we won't delete it from our thread list
1352 until we notice that it's dead (via prune_threads), or until
1353 something re-uses its thread ID. We'll report the thread exit
1354 when the underlying LWP dies. */
1355 thread_info
= find_thread_ptid (ptid
);
1356 gdb_assert (thread_info
!= NULL
&& thread_info
->priv
!= NULL
);
1357 thread_info
->priv
->dying
= 1;
1361 thread_db_detach (struct target_ops
*ops
, const char *args
, int from_tty
)
1363 struct target_ops
*target_beneath
= find_target_beneath (ops
);
1364 struct thread_db_info
*info
;
1366 info
= get_thread_db_info (ptid_get_pid (inferior_ptid
));
1370 if (target_has_execution
&& thread_db_use_events ())
1372 disable_thread_event_reporting (info
);
1374 /* Delete the old thread event breakpoints. Note that
1375 unlike when mourning, we can remove them here because
1376 there's still a live inferior to poke at. In any case,
1377 GDB will not try to insert anything in the inferior when
1378 removing a breakpoint. */
1379 remove_thread_event_breakpoints ();
1382 delete_thread_db_info (ptid_get_pid (inferior_ptid
));
1385 target_beneath
->to_detach (target_beneath
, args
, from_tty
);
1387 /* NOTE: From this point on, inferior_ptid is null_ptid. */
1389 /* If there are no more processes using libpthread, detach the
1390 thread_db target ops. */
1391 if (!thread_db_list
)
1392 unpush_target (&thread_db_ops
);
1395 /* Check if PID is currently stopped at the location of a thread event
1396 breakpoint location. If it is, read the event message and act upon
1400 check_event (ptid_t ptid
)
1402 struct regcache
*regcache
= get_thread_regcache (ptid
);
1403 struct gdbarch
*gdbarch
= get_regcache_arch (regcache
);
1409 struct thread_db_info
*info
;
1411 info
= get_thread_db_info (ptid_get_pid (ptid
));
1413 /* Bail out early if we're not at a thread event breakpoint. */
1414 stop_pc
= regcache_read_pc (regcache
);
1415 if (!target_supports_stopped_by_sw_breakpoint ())
1416 stop_pc
-= gdbarch_decr_pc_after_break (gdbarch
);
1418 if (stop_pc
!= info
->td_create_bp_addr
1419 && stop_pc
!= info
->td_death_bp_addr
)
1422 /* Access an lwp we know is stopped. */
1423 info
->proc_handle
.ptid
= ptid
;
1425 /* If we have only looked at the first thread before libpthread was
1426 initialized, we may not know its thread ID yet. Make sure we do
1427 before we add another thread to the list. */
1428 if (!have_threads (ptid
))
1429 thread_db_find_new_threads_1 (ptid
);
1431 /* If we are at a create breakpoint, we do not know what new lwp
1432 was created and cannot specifically locate the event message for it.
1433 We have to call td_ta_event_getmsg() to get
1434 the latest message. Since we have no way of correlating whether
1435 the event message we get back corresponds to our breakpoint, we must
1436 loop and read all event messages, processing them appropriately.
1437 This guarantees we will process the correct message before continuing
1438 from the breakpoint.
1440 Currently, death events are not enabled. If they are enabled,
1441 the death event can use the td_thr_event_getmsg() interface to
1442 get the message specifically for that lwp and avoid looping
1449 err
= info
->td_ta_event_getmsg_p (info
->thread_agent
, &msg
);
1452 if (err
== TD_NOMSG
)
1455 error (_("Cannot get thread event message: %s"),
1456 thread_db_err_str (err
));
1459 err
= info
->td_thr_get_info_p (msg
.th_p
, &ti
);
1461 error (_("Cannot get thread info: %s"), thread_db_err_str (err
));
1463 ptid
= ptid_build (ptid_get_pid (ptid
), ti
.ti_lid
, 0);
1468 /* Call attach_thread whether or not we already know about a
1469 thread with this thread ID. */
1470 attach_thread (ptid
, msg
.th_p
, &ti
);
1476 if (!in_thread_list (ptid
))
1477 error (_("Spurious thread death event."));
1479 detach_thread (ptid
);
1484 error (_("Spurious thread event."));
1491 thread_db_wait (struct target_ops
*ops
,
1492 ptid_t ptid
, struct target_waitstatus
*ourstatus
,
1495 struct thread_db_info
*info
;
1496 struct target_ops
*beneath
= find_target_beneath (ops
);
1498 ptid
= beneath
->to_wait (beneath
, ptid
, ourstatus
, options
);
1500 if (ourstatus
->kind
== TARGET_WAITKIND_IGNORE
)
1503 if (ourstatus
->kind
== TARGET_WAITKIND_EXITED
1504 || ourstatus
->kind
== TARGET_WAITKIND_SIGNALLED
)
1507 info
= get_thread_db_info (ptid_get_pid (ptid
));
1509 /* If this process isn't using thread_db, we're done. */
1513 if (ourstatus
->kind
== TARGET_WAITKIND_EXECD
)
1515 /* New image, it may or may not end up using thread_db. Assume
1516 not unless we find otherwise. */
1517 delete_thread_db_info (ptid_get_pid (ptid
));
1518 if (!thread_db_list
)
1519 unpush_target (&thread_db_ops
);
1521 /* Thread event breakpoints are deleted by
1522 update_breakpoints_after_exec. */
1527 if (ourstatus
->kind
== TARGET_WAITKIND_STOPPED
1528 && ourstatus
->value
.sig
== GDB_SIGNAL_TRAP
)
1529 /* Check for a thread event. */
1532 /* Fill in the thread's user-level thread id and status. */
1533 thread_from_lwp (ptid
);
1539 thread_db_mourn_inferior (struct target_ops
*ops
)
1541 struct target_ops
*target_beneath
= find_target_beneath (ops
);
1543 delete_thread_db_info (ptid_get_pid (inferior_ptid
));
1545 target_beneath
->to_mourn_inferior (target_beneath
);
1547 /* Delete the old thread event breakpoints. Do this after mourning
1548 the inferior, so that we don't try to uninsert them. */
1549 remove_thread_event_breakpoints ();
1551 /* Detach thread_db target ops. */
1552 if (!thread_db_list
)
1553 unpush_target (ops
);
1556 struct callback_data
1558 struct thread_db_info
*info
;
1563 find_new_threads_callback (const td_thrhandle_t
*th_p
, void *data
)
1568 struct thread_info
*tp
;
1569 struct callback_data
*cb_data
= (struct callback_data
*) data
;
1570 struct thread_db_info
*info
= cb_data
->info
;
1572 err
= info
->td_thr_get_info_p (th_p
, &ti
);
1574 error (_("find_new_threads_callback: cannot get thread info: %s"),
1575 thread_db_err_str (err
));
1577 if (ti
.ti_lid
== -1)
1579 /* A thread with kernel thread ID -1 is either a thread that
1580 exited and was joined, or a thread that is being created but
1581 hasn't started yet, and that is reusing the tcb/stack of a
1582 thread that previously exited and was joined. (glibc marks
1583 terminated and joined threads with kernel thread ID -1. See
1585 if (libthread_db_debug
)
1586 fprintf_unfiltered (gdb_stdlog
,
1587 "thread_db: skipping exited and "
1588 "joined thread (0x%lx)\n",
1589 (unsigned long) ti
.ti_tid
);
1595 /* A thread ID of zero means that this is the main thread, but
1596 glibc has not yet initialized thread-local storage and the
1597 pthread library. We do not know what the thread's TID will
1598 be yet. Just enable event reporting and otherwise ignore
1601 /* In that case, we're not stopped in a fork syscall and don't
1602 need this glibc bug workaround. */
1603 info
->need_stale_parent_threads_check
= 0;
1605 if (target_has_execution
&& thread_db_use_events ())
1607 err
= info
->td_thr_event_enable_p (th_p
, 1);
1609 error (_("Cannot enable thread event reporting for LWP %d: %s"),
1610 (int) ti
.ti_lid
, thread_db_err_str (err
));
1616 /* Ignore stale parent threads, caused by glibc/BZ5983. This is a
1617 bit expensive, as it needs to open /proc/pid/status, so try to
1618 avoid doing the work if we know we don't have to. */
1619 if (info
->need_stale_parent_threads_check
)
1621 int tgid
= linux_proc_get_tgid (ti
.ti_lid
);
1623 if (tgid
!= -1 && tgid
!= info
->pid
)
1627 ptid
= ptid_build (info
->pid
, ti
.ti_lid
, 0);
1628 tp
= find_thread_ptid (ptid
);
1629 if (tp
== NULL
|| tp
->priv
== NULL
)
1631 if (attach_thread (ptid
, th_p
, &ti
))
1632 cb_data
->new_threads
+= 1;
1634 /* Problem attaching this thread; perhaps it exited before we
1636 This could mean that the thread list inside glibc itself is in
1637 inconsistent state, and libthread_db could go on looping forever
1638 (observed with glibc-2.3.6). To prevent that, terminate
1639 iteration: thread_db_find_new_threads_2 will retry. */
1642 else if (target_has_execution
&& !thread_db_use_events ())
1644 /* Need to update this if not using the libthread_db events
1645 (particularly, the TD_DEATH event). */
1646 update_thread_state (tp
->priv
, &ti
);
1652 /* Helper for thread_db_find_new_threads_2.
1653 Returns number of new threads found. */
1656 find_new_threads_once (struct thread_db_info
*info
, int iteration
,
1659 struct callback_data data
;
1660 td_err_e err
= TD_ERR
;
1663 data
.new_threads
= 0;
1665 /* See comment in thread_db_update_thread_list. */
1666 gdb_assert (!target_has_execution
|| thread_db_use_events ());
1670 /* Iterate over all user-space threads to discover new threads. */
1671 err
= info
->td_ta_thr_iter_p (info
->thread_agent
,
1672 find_new_threads_callback
,
1675 TD_THR_LOWEST_PRIORITY
,
1677 TD_THR_ANY_USER_FLAGS
);
1679 CATCH (except
, RETURN_MASK_ERROR
)
1681 if (libthread_db_debug
)
1683 exception_fprintf (gdb_stdlog
, except
,
1684 "Warning: find_new_threads_once: ");
1689 if (libthread_db_debug
)
1691 fprintf_unfiltered (gdb_stdlog
,
1692 _("Found %d new threads in iteration %d.\n"),
1693 data
.new_threads
, iteration
);
1699 return data
.new_threads
;
1702 /* Search for new threads, accessing memory through stopped thread
1703 PTID. If UNTIL_NO_NEW is true, repeat searching until several
1704 searches in a row do not discover any new threads. */
1707 thread_db_find_new_threads_2 (ptid_t ptid
, int until_no_new
)
1709 td_err_e err
= TD_OK
;
1710 struct thread_db_info
*info
;
1713 info
= get_thread_db_info (ptid_get_pid (ptid
));
1715 /* Access an lwp we know is stopped. */
1716 info
->proc_handle
.ptid
= ptid
;
1720 /* Require 4 successive iterations which do not find any new threads.
1721 The 4 is a heuristic: there is an inherent race here, and I have
1722 seen that 2 iterations in a row are not always sufficient to
1723 "capture" all threads. */
1724 for (i
= 0, loop
= 0; loop
< 4 && err
== TD_OK
; ++i
, ++loop
)
1725 if (find_new_threads_once (info
, i
, &err
) != 0)
1727 /* Found some new threads. Restart the loop from beginning. */
1732 find_new_threads_once (info
, 0, &err
);
1735 error (_("Cannot find new threads: %s"), thread_db_err_str (err
));
1739 thread_db_find_new_threads_1 (ptid_t ptid
)
1741 thread_db_find_new_threads_2 (ptid
, 0);
1745 update_thread_core (struct lwp_info
*info
, void *closure
)
1747 info
->core
= linux_common_core_of_thread (info
->ptid
);
1751 /* Update the thread list using td_ta_thr_iter. */
1754 thread_db_update_thread_list_td_ta_thr_iter (struct target_ops
*ops
)
1756 struct thread_db_info
*info
;
1757 struct inferior
*inf
;
1763 struct thread_info
*thread
;
1768 info
= get_thread_db_info (inf
->pid
);
1772 thread
= any_live_thread_of_process (inf
->pid
);
1773 if (thread
== NULL
|| thread
->executing
)
1776 thread_db_find_new_threads_1 (thread
->ptid
);
1780 /* Implement the to_update_thread_list target method for this
1784 thread_db_update_thread_list (struct target_ops
*ops
)
1786 /* It's best to avoid td_ta_thr_iter if possible. That walks data
1787 structures in the inferior's address space that may be corrupted,
1788 or, if the target is running, the list may change while we walk
1789 it. In the latter case, it's possible that a thread exits just
1790 at the exact time that causes GDB to get stuck in an infinite
1791 loop. To avoid pausing all threads whenever the core wants to
1792 refresh the thread list, if the kernel supports clone events
1793 (meaning we're always already attached to all LWPs), we use
1794 thread_from_lwp immediately when we see an LWP stop. That uses
1795 thread_db entry points that do not walk libpthread's thread list,
1796 so should be safe, as well as more efficient. */
1797 if (target_has_execution
&& !thread_db_use_events ())
1798 ops
->beneath
->to_update_thread_list (ops
->beneath
);
1800 thread_db_update_thread_list_td_ta_thr_iter (ops
);
1802 if (target_has_execution
)
1803 iterate_over_lwps (minus_one_ptid
/* iterate over all */,
1804 update_thread_core
, NULL
);
1808 thread_db_pid_to_str (struct target_ops
*ops
, ptid_t ptid
)
1810 struct thread_info
*thread_info
= find_thread_ptid (ptid
);
1811 struct target_ops
*beneath
;
1813 if (thread_info
!= NULL
&& thread_info
->priv
!= NULL
)
1815 static char buf
[64];
1818 tid
= thread_info
->priv
->tid
;
1819 snprintf (buf
, sizeof (buf
), "Thread 0x%lx (LWP %ld)",
1820 (unsigned long) tid
, ptid_get_lwp (ptid
));
1825 beneath
= find_target_beneath (ops
);
1826 return beneath
->to_pid_to_str (beneath
, ptid
);
1829 /* Return a string describing the state of the thread specified by
1833 thread_db_extra_thread_info (struct target_ops
*self
,
1834 struct thread_info
*info
)
1836 if (info
->priv
== NULL
)
1839 if (info
->priv
->dying
)
1845 /* Get the address of the thread local variable in load module LM which
1846 is stored at OFFSET within the thread local storage for thread PTID. */
1849 thread_db_get_thread_local_address (struct target_ops
*ops
,
1854 struct thread_info
*thread_info
;
1855 struct target_ops
*beneath
;
1857 /* Find the matching thread. */
1858 thread_info
= find_thread_ptid (ptid
);
1860 /* We may not have discovered the thread yet. */
1861 if (thread_info
!= NULL
&& thread_info
->priv
== NULL
)
1862 thread_info
= thread_from_lwp (ptid
);
1864 if (thread_info
!= NULL
&& thread_info
->priv
!= NULL
)
1868 struct thread_db_info
*info
;
1870 info
= get_thread_db_info (ptid_get_pid (ptid
));
1872 /* Finally, get the address of the variable. */
1875 /* glibc doesn't provide the needed interface. */
1876 if (!info
->td_thr_tls_get_addr_p
)
1877 throw_error (TLS_NO_LIBRARY_SUPPORT_ERROR
,
1878 _("No TLS library support"));
1880 /* Note the cast through uintptr_t: this interface only works if
1881 a target address fits in a psaddr_t, which is a host pointer.
1882 So a 32-bit debugger can not access 64-bit TLS through this. */
1883 err
= info
->td_thr_tls_get_addr_p (&thread_info
->priv
->th
,
1884 (psaddr_t
)(uintptr_t) lm
,
1889 /* If glibc doesn't provide the needed interface throw an error
1890 that LM is zero - normally cases it should not be. */
1891 if (!info
->td_thr_tlsbase_p
)
1892 throw_error (TLS_LOAD_MODULE_NOT_FOUND_ERROR
,
1893 _("TLS load module not found"));
1895 /* This code path handles the case of -static -pthread executables:
1896 https://sourceware.org/ml/libc-help/2014-03/msg00024.html
1897 For older GNU libc r_debug.r_map is NULL. For GNU libc after
1898 PR libc/16831 due to GDB PR threads/16954 LOAD_MODULE is also NULL.
1899 The constant number 1 depends on GNU __libc_setup_tls
1900 initialization of l_tls_modid to 1. */
1901 err
= info
->td_thr_tlsbase_p (&thread_info
->priv
->th
,
1903 address
= (char *) address
+ offset
;
1906 #ifdef THREAD_DB_HAS_TD_NOTALLOC
1907 /* The memory hasn't been allocated, yet. */
1908 if (err
== TD_NOTALLOC
)
1909 /* Now, if libthread_db provided the initialization image's
1910 address, we *could* try to build a non-lvalue value from
1911 the initialization image. */
1912 throw_error (TLS_NOT_ALLOCATED_YET_ERROR
,
1913 _("TLS not allocated yet"));
1916 /* Something else went wrong. */
1918 throw_error (TLS_GENERIC_ERROR
,
1919 (("%s")), thread_db_err_str (err
));
1921 /* Cast assuming host == target. Joy. */
1922 /* Do proper sign extension for the target. */
1923 gdb_assert (exec_bfd
);
1924 return (bfd_get_sign_extend_vma (exec_bfd
) > 0
1925 ? (CORE_ADDR
) (intptr_t) address
1926 : (CORE_ADDR
) (uintptr_t) address
);
1929 beneath
= find_target_beneath (ops
);
1930 return beneath
->to_get_thread_local_address (beneath
, ptid
, lm
, offset
);
1933 /* Implement the to_get_ada_task_ptid target method for this target. */
1936 thread_db_get_ada_task_ptid (struct target_ops
*self
, long lwp
, long thread
)
1938 /* NPTL uses a 1:1 model, so the LWP id suffices. */
1939 return ptid_build (ptid_get_pid (inferior_ptid
), lwp
, 0);
1943 thread_db_resume (struct target_ops
*ops
,
1944 ptid_t ptid
, int step
, enum gdb_signal signo
)
1946 struct target_ops
*beneath
= find_target_beneath (ops
);
1947 struct thread_db_info
*info
;
1949 if (ptid_equal (ptid
, minus_one_ptid
))
1950 info
= get_thread_db_info (ptid_get_pid (inferior_ptid
));
1952 info
= get_thread_db_info (ptid_get_pid (ptid
));
1954 /* This workaround is only needed for child fork lwps stopped in a
1955 PTRACE_O_TRACEFORK event. When the inferior is resumed, the
1956 workaround can be disabled. */
1958 info
->need_stale_parent_threads_check
= 0;
1960 beneath
->to_resume (beneath
, ptid
, step
, signo
);
1963 /* qsort helper function for info_auto_load_libthread_db, sort the
1964 thread_db_info pointers primarily by their FILENAME and secondarily by their
1965 PID, both in ascending order. */
1968 info_auto_load_libthread_db_compare (const void *ap
, const void *bp
)
1970 struct thread_db_info
*a
= *(struct thread_db_info
**) ap
;
1971 struct thread_db_info
*b
= *(struct thread_db_info
**) bp
;
1974 retval
= strcmp (a
->filename
, b
->filename
);
1978 return (a
->pid
> b
->pid
) - (a
->pid
- b
->pid
);
1981 /* Implement 'info auto-load libthread-db'. */
1984 info_auto_load_libthread_db (char *args
, int from_tty
)
1986 struct ui_out
*uiout
= current_uiout
;
1987 const char *cs
= args
? args
: "";
1988 struct thread_db_info
*info
, **array
;
1989 unsigned info_count
, unique_filenames
;
1990 size_t max_filename_len
, max_pids_len
, pids_len
;
1991 struct cleanup
*back_to
;
1995 cs
= skip_spaces_const (cs
);
1997 error (_("'info auto-load libthread-db' does not accept any parameters"));
2000 for (info
= thread_db_list
; info
; info
= info
->next
)
2001 if (info
->filename
!= NULL
)
2004 array
= XNEWVEC (struct thread_db_info
*, info_count
);
2005 back_to
= make_cleanup (xfree
, array
);
2008 for (info
= thread_db_list
; info
; info
= info
->next
)
2009 if (info
->filename
!= NULL
)
2010 array
[info_count
++] = info
;
2012 /* Sort ARRAY by filenames and PIDs. */
2014 qsort (array
, info_count
, sizeof (*array
),
2015 info_auto_load_libthread_db_compare
);
2017 /* Calculate the number of unique filenames (rows) and the maximum string
2018 length of PIDs list for the unique filenames (columns). */
2020 unique_filenames
= 0;
2021 max_filename_len
= 0;
2024 for (i
= 0; i
< info_count
; i
++)
2026 int pid
= array
[i
]->pid
;
2027 size_t this_pid_len
;
2029 for (this_pid_len
= 0; pid
!= 0; pid
/= 10)
2032 if (i
== 0 || strcmp (array
[i
- 1]->filename
, array
[i
]->filename
) != 0)
2035 max_filename_len
= max (max_filename_len
,
2036 strlen (array
[i
]->filename
));
2040 pids_len
-= strlen (", ");
2041 max_pids_len
= max (max_pids_len
, pids_len
);
2045 pids_len
+= this_pid_len
+ strlen (", ");
2049 pids_len
-= strlen (", ");
2050 max_pids_len
= max (max_pids_len
, pids_len
);
2053 /* Table header shifted right by preceding "libthread-db: " would not match
2055 if (info_count
> 0 && args
== auto_load_info_scripts_pattern_nl
)
2056 ui_out_text (uiout
, "\n");
2058 make_cleanup_ui_out_table_begin_end (uiout
, 2, unique_filenames
,
2059 "LinuxThreadDbTable");
2061 ui_out_table_header (uiout
, max_filename_len
, ui_left
, "filename",
2063 ui_out_table_header (uiout
, pids_len
, ui_left
, "PIDs", "Pids");
2064 ui_out_table_body (uiout
);
2066 pids
= (char *) xmalloc (max_pids_len
+ 1);
2067 make_cleanup (xfree
, pids
);
2069 /* Note I is incremented inside the cycle, not at its end. */
2070 for (i
= 0; i
< info_count
;)
2072 struct cleanup
*chain
= make_cleanup_ui_out_tuple_begin_end (uiout
, NULL
);
2076 ui_out_field_string (uiout
, "filename", info
->filename
);
2079 while (i
< info_count
&& strcmp (info
->filename
, array
[i
]->filename
) == 0)
2081 if (pids_end
!= pids
)
2086 pids_end
+= xsnprintf (pids_end
, &pids
[max_pids_len
+ 1] - pids_end
,
2087 "%u", array
[i
]->pid
);
2088 gdb_assert (pids_end
< &pids
[max_pids_len
+ 1]);
2094 ui_out_field_string (uiout
, "pids", pids
);
2096 ui_out_text (uiout
, "\n");
2097 do_cleanups (chain
);
2100 do_cleanups (back_to
);
2102 if (info_count
== 0)
2103 ui_out_message (uiout
, 0, _("No auto-loaded libthread-db.\n"));
2107 init_thread_db_ops (void)
2109 thread_db_ops
.to_shortname
= "multi-thread";
2110 thread_db_ops
.to_longname
= "multi-threaded child process.";
2111 thread_db_ops
.to_doc
= "Threads and pthreads support.";
2112 thread_db_ops
.to_detach
= thread_db_detach
;
2113 thread_db_ops
.to_wait
= thread_db_wait
;
2114 thread_db_ops
.to_resume
= thread_db_resume
;
2115 thread_db_ops
.to_mourn_inferior
= thread_db_mourn_inferior
;
2116 thread_db_ops
.to_update_thread_list
= thread_db_update_thread_list
;
2117 thread_db_ops
.to_pid_to_str
= thread_db_pid_to_str
;
2118 thread_db_ops
.to_stratum
= thread_stratum
;
2119 thread_db_ops
.to_has_thread_control
= tc_schedlock
;
2120 thread_db_ops
.to_get_thread_local_address
2121 = thread_db_get_thread_local_address
;
2122 thread_db_ops
.to_extra_thread_info
= thread_db_extra_thread_info
;
2123 thread_db_ops
.to_get_ada_task_ptid
= thread_db_get_ada_task_ptid
;
2124 thread_db_ops
.to_magic
= OPS_MAGIC
;
2126 complete_target_initialization (&thread_db_ops
);
2129 /* Provide a prototype to silence -Wmissing-prototypes. */
2130 extern initialize_file_ftype _initialize_thread_db
;
2133 _initialize_thread_db (void)
2135 init_thread_db_ops ();
2137 /* Defer loading of libthread_db.so until inferior is running.
2138 This allows gdb to load correct libthread_db for a given
2139 executable -- there could be mutiple versions of glibc,
2140 compiled with LinuxThreads or NPTL, and until there is
2141 a running inferior, we can't tell which libthread_db is
2142 the correct one to load. */
2144 libthread_db_search_path
= xstrdup (LIBTHREAD_DB_SEARCH_PATH
);
2146 add_setshow_optional_filename_cmd ("libthread-db-search-path",
2148 &libthread_db_search_path
, _("\
2149 Set search path for libthread_db."), _("\
2150 Show the current search path or libthread_db."), _("\
2151 This path is used to search for libthread_db to be loaded into \
2153 Its value is a colon (':') separate list of directories to search.\n\
2154 Setting the search path to an empty list resets it to its default value."),
2155 set_libthread_db_search_path
,
2157 &setlist
, &showlist
);
2159 add_setshow_zuinteger_cmd ("libthread-db", class_maintenance
,
2160 &libthread_db_debug
, _("\
2161 Set libthread-db debugging."), _("\
2162 Show libthread-db debugging."), _("\
2163 When non-zero, libthread-db debugging is enabled."),
2165 show_libthread_db_debug
,
2166 &setdebuglist
, &showdebuglist
);
2168 add_setshow_boolean_cmd ("libthread-db", class_support
,
2169 &auto_load_thread_db
, _("\
2170 Enable or disable auto-loading of inferior specific libthread_db."), _("\
2171 Show whether auto-loading inferior specific libthread_db is enabled."), _("\
2172 If enabled, libthread_db will be searched in 'set libthread-db-search-path'\n\
2173 locations to load libthread_db compatible with the inferior.\n\
2174 Standard system libthread_db still gets loaded even with this option off.\n\
2175 This options has security implications for untrusted inferiors."),
2176 NULL
, show_auto_load_thread_db
,
2177 auto_load_set_cmdlist_get (),
2178 auto_load_show_cmdlist_get ());
2180 add_cmd ("libthread-db", class_info
, info_auto_load_libthread_db
,
2181 _("Print the list of loaded inferior specific libthread_db.\n\
2182 Usage: info auto-load libthread-db"),
2183 auto_load_info_cmdlist_get ());
2185 /* Add ourselves to objfile event chain. */
2186 observer_attach_new_objfile (thread_db_new_objfile
);
2188 /* Add ourselves to inferior_created event chain.
2189 This is needed to handle debugging statically linked programs where
2190 the new_objfile observer won't get called for libpthread. */
2191 observer_attach_inferior_created (thread_db_inferior_created
);