1 /* libthread_db assisted debugging support, generic parts.
3 Copyright (C) 1999-2018 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"
38 #include "observable.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 #include "common/pathstuff.h"
52 /* GNU/Linux libthread_db support.
54 libthread_db is a library, provided along with libpthread.so, which
55 exposes the internals of the thread library to a debugger. It
56 allows GDB to find existing threads, new threads as they are
57 created, thread IDs (usually, the result of pthread_self), and
58 thread-local variables.
60 The libthread_db interface originates on Solaris, where it is both
61 more powerful and more complicated. This implementation only works
62 for NPTL, the glibc threading library. It assumes that each thread
63 is permanently assigned to a single light-weight process (LWP). At
64 some point it also supported the older LinuxThreads library, but it
67 libthread_db-specific information is stored in the "private" field
68 of struct thread_info. When the field is NULL we do not yet have
69 information about the new thread; this could be temporary (created,
70 but the thread library's data structures do not reflect it yet)
71 or permanent (created using clone instead of pthread_create).
73 Process IDs managed by linux-thread-db.c match those used by
74 linux-nat.c: a common PID for all processes, an LWP ID for each
75 thread, and no TID. We save the TID in private. Keeping it out
76 of the ptid_t prevents thread IDs changing when libpthread is
77 loaded or unloaded. */
79 static const target_info thread_db_target_info = {
81 N_("multi-threaded child process."),
82 N_("Threads and pthreads support.")
85 class thread_db_target final : public target_ops
88 const target_info &info () const override
89 { return thread_db_target_info; }
91 strata stratum () const override { return thread_stratum; }
93 void detach (inferior *, int) override;
94 ptid_t wait (ptid_t, struct target_waitstatus *, int) override;
95 void resume (ptid_t, int, enum gdb_signal) override;
96 void mourn_inferior () override;
97 void update_thread_list () override;
98 const char *pid_to_str (ptid_t) override;
99 CORE_ADDR get_thread_local_address (ptid_t ptid,
100 CORE_ADDR load_module_addr,
101 CORE_ADDR offset) override;
102 const char *extra_thread_info (struct thread_info *) override;
103 ptid_t get_ada_task_ptid (long lwp, long thread) override;
105 thread_info *thread_handle_to_thread_info (const gdb_byte *thread_handle,
107 inferior *inf) override;
110 static char *libthread_db_search_path;
112 /* Set to non-zero if thread_db auto-loading is enabled
113 by the "set auto-load libthread-db" command. */
114 static int auto_load_thread_db = 1;
116 /* Set to non-zero if load-time libthread_db tests have been enabled
117 by the "maintenence set check-libthread-db" command. */
118 static int check_thread_db_on_load = 0;
120 /* "show" command for the auto_load_thread_db configuration variable. */
123 show_auto_load_thread_db (struct ui_file *file, int from_tty,
124 struct cmd_list_element *c, const char *value)
126 fprintf_filtered (file, _("Auto-loading of inferior specific libthread_db "
132 set_libthread_db_search_path (const char *ignored, int from_tty,
133 struct cmd_list_element *c)
135 if (*libthread_db_search_path == '\0')
137 xfree (libthread_db_search_path);
138 libthread_db_search_path = xstrdup (LIBTHREAD_DB_SEARCH_PATH);
142 /* If non-zero, print details of libthread_db processing. */
144 static unsigned int libthread_db_debug;
147 show_libthread_db_debug (struct ui_file *file, int from_tty,
148 struct cmd_list_element *c, const char *value)
150 fprintf_filtered (file, _("libthread-db debugging is %s.\n"), value);
153 /* If we're running on GNU/Linux, we must explicitly attach to any new
156 /* This module's target vector. */
157 static thread_db_target the_thread_db_target;
159 /* Non-zero if we have determined the signals used by the threads
161 static int thread_signals;
162 static sigset_t thread_stop_set;
163 static sigset_t thread_print_set;
165 struct thread_db_info
167 struct thread_db_info *next;
169 /* Process id this object refers to. */
172 /* Handle from dlopen for libthread_db.so. */
175 /* Absolute pathname from gdb_realpath to disk file used for dlopen-ing
176 HANDLE. It may be NULL for system library. */
179 /* Structure that identifies the child process for the
180 <proc_service.h> interface. */
181 struct ps_prochandle proc_handle;
183 /* Connection to the libthread_db library. */
184 td_thragent_t *thread_agent;
186 /* True if we need to apply the workaround for glibc/BZ5983. When
187 we catch a PTRACE_O_TRACEFORK, and go query the child's thread
188 list, nptl_db returns the parent's threads in addition to the new
189 (single) child thread. If this flag is set, we do extra work to
190 be able to ignore such stale entries. */
191 int need_stale_parent_threads_check;
193 /* Pointers to the libthread_db functions. */
195 td_init_ftype *td_init_p;
196 td_ta_new_ftype *td_ta_new_p;
197 td_ta_delete_ftype *td_ta_delete_p;
198 td_ta_map_lwp2thr_ftype *td_ta_map_lwp2thr_p;
199 td_ta_thr_iter_ftype *td_ta_thr_iter_p;
200 td_thr_get_info_ftype *td_thr_get_info_p;
201 td_thr_tls_get_addr_ftype *td_thr_tls_get_addr_p;
202 td_thr_tlsbase_ftype *td_thr_tlsbase_p;
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 (thread_info *stopped);
210 static void thread_db_find_new_threads_2 (thread_info *stopped,
213 static void check_thread_signals (void);
215 static struct thread_info *record_thread
216 (struct thread_db_info *info, struct thread_info *tp,
217 ptid_t ptid, const td_thrhandle_t *th_p, const td_thrinfo_t *ti_p);
219 /* Add the current inferior to the list of processes using libpthread.
220 Return a pointer to the newly allocated object that was added to
221 THREAD_DB_LIST. HANDLE is the handle returned by dlopen'ing
224 static struct thread_db_info *
225 add_thread_db_info (void *handle)
227 struct thread_db_info *info = XCNEW (struct thread_db_info);
229 info->pid = inferior_ptid.pid ();
230 info->handle = handle;
232 /* The workaround works by reading from /proc/pid/status, so it is
233 disabled for core files. */
234 if (target_has_execution)
235 info->need_stale_parent_threads_check = 1;
237 info->next = thread_db_list;
238 thread_db_list = info;
243 /* Return the thread_db_info object representing the bookkeeping
244 related to process PID, if any; NULL otherwise. */
246 static struct thread_db_info *
247 get_thread_db_info (int pid)
249 struct thread_db_info *info;
251 for (info = thread_db_list; info; info = info->next)
252 if (pid == info->pid)
258 static const char *thread_db_err_str (td_err_e err);
260 /* When PID has exited or has been detached, we no longer want to keep
261 track of it as using libpthread. Call this function to discard
262 thread_db related info related to PID. Note that this closes
263 LIBTHREAD_DB_SO's dlopen'ed handle. */
266 delete_thread_db_info (int pid)
268 struct thread_db_info *info, *info_prev;
272 for (info = thread_db_list; info; info_prev = info, info = info->next)
273 if (pid == info->pid)
279 if (info->thread_agent != NULL && info->td_ta_delete_p != NULL)
281 td_err_e err = info->td_ta_delete_p (info->thread_agent);
284 warning (_("Cannot deregister process %d from libthread_db: %s"),
285 pid, thread_db_err_str (err));
286 info->thread_agent = NULL;
289 if (info->handle != NULL)
290 dlclose (info->handle);
292 xfree (info->filename);
295 info_prev->next = info->next;
297 thread_db_list = info->next;
302 /* Use "struct private_thread_info" to cache thread state. This is
303 a substantial optimization. */
305 struct thread_db_thread_info : public private_thread_info
307 /* Flag set when we see a TD_DEATH event for this thread. */
310 /* Cached thread state. */
311 td_thrhandle_t th {};
315 static thread_db_thread_info *
316 get_thread_db_thread_info (thread_info *thread)
318 return static_cast<thread_db_thread_info *> (thread->priv.get ());
322 thread_db_err_str (td_err_e err)
329 return "generic 'call succeeded'";
331 return "generic error";
333 return "no thread to satisfy query";
335 return "no sync handle to satisfy query";
337 return "no LWP to satisfy query";
339 return "invalid process handle";
341 return "invalid thread handle";
343 return "invalid synchronization handle";
345 return "invalid thread agent";
347 return "invalid key";
349 return "no event message for getmsg";
351 return "FPU register set not available";
353 return "application not linked with libthread";
355 return "requested event is not supported";
357 return "capability not available";
359 return "debugger service failed";
361 return "operation not applicable to";
363 return "no thread-specific data for this thread";
365 return "malloc failed";
367 return "only part of register set was written/read";
369 return "X register set not available for this thread";
370 #ifdef THREAD_DB_HAS_TD_NOTALLOC
372 return "thread has not yet allocated TLS for given module";
374 #ifdef THREAD_DB_HAS_TD_VERSION
376 return "versions of libpthread and libthread_db do not match";
378 #ifdef THREAD_DB_HAS_TD_NOTLS
380 return "there is no TLS segment in the given module";
383 snprintf (buf, sizeof (buf), "unknown thread_db error '%d'", err);
388 /* Fetch the user-level thread id of PTID. STOPPED is a stopped
389 thread that we can use to access memory. */
391 static struct thread_info *
392 thread_from_lwp (thread_info *stopped, ptid_t ptid)
397 struct thread_db_info *info;
398 struct thread_info *tp;
400 /* Just in case td_ta_map_lwp2thr doesn't initialize it completely. */
403 /* This ptid comes from linux-nat.c, which should always fill in the
405 gdb_assert (ptid.lwp () != 0);
407 info = get_thread_db_info (ptid.pid ());
409 /* Access an lwp we know is stopped. */
410 info->proc_handle.thread = stopped;
411 err = info->td_ta_map_lwp2thr_p (info->thread_agent, ptid.lwp (),
414 error (_("Cannot find user-level thread for LWP %ld: %s"),
415 ptid.lwp (), thread_db_err_str (err));
417 err = info->td_thr_get_info_p (&th, &ti);
419 error (_("thread_get_info_callback: cannot get thread info: %s"),
420 thread_db_err_str (err));
422 /* Fill the cache. */
423 tp = find_thread_ptid (ptid);
424 return record_thread (info, tp, ptid, &th, &ti);
428 /* See linux-nat.h. */
431 thread_db_notice_clone (ptid_t parent, ptid_t child)
433 struct thread_db_info *info;
435 info = get_thread_db_info (child.pid ());
440 thread_info *stopped = find_thread_ptid (parent);
442 thread_from_lwp (stopped, child);
444 /* If we do not know about the main thread's pthread info yet, this
445 would be a good time to find it. */
446 thread_from_lwp (stopped, parent);
451 verbose_dlsym (void *handle, const char *name)
453 void *sym = dlsym (handle, name);
455 warning (_("Symbol \"%s\" not found in libthread_db: %s"),
460 /* Verify inferior's '\0'-terminated symbol VER_SYMBOL starts with "%d.%d" and
461 return 1 if this version is lower (and not equal) to
462 VER_MAJOR_MIN.VER_MINOR_MIN. Return 0 in all other cases. */
465 inferior_has_bug (const char *ver_symbol, int ver_major_min, int ver_minor_min)
467 struct bound_minimal_symbol version_msym;
468 CORE_ADDR version_addr;
469 gdb::unique_xmalloc_ptr<char> version;
470 int err, got, retval = 0;
472 version_msym = lookup_minimal_symbol (ver_symbol, NULL, NULL);
473 if (version_msym.minsym == NULL)
476 version_addr = BMSYMBOL_VALUE_ADDRESS (version_msym);
477 got = target_read_string (version_addr, &version, 32, &err);
478 if (err == 0 && memchr (version.get (), 0, got) == version.get () + got - 1)
482 retval = (sscanf (version.get (), "%d.%d", &major, &minor) == 2
483 && (major < ver_major_min
484 || (major == ver_major_min && minor < ver_minor_min)));
490 /* Similar as thread_db_find_new_threads_1, but try to silently ignore errors
493 Return 1 if the caller should abort libthread_db initialization. Return 0
497 thread_db_find_new_threads_silently (thread_info *stopped)
502 thread_db_find_new_threads_2 (stopped, true);
505 CATCH (except, RETURN_MASK_ERROR)
507 if (libthread_db_debug)
508 exception_fprintf (gdb_stdlog, except,
509 "Warning: thread_db_find_new_threads_silently: ");
511 /* There is a bug fixed between nptl 2.6.1 and 2.7 by
512 commit 7d9d8bd18906fdd17364f372b160d7ab896ce909
513 where calls to td_thr_get_info fail with TD_ERR for statically linked
514 executables if td_thr_get_info is called before glibc has initialized
517 If the nptl bug is NOT present in the inferior and still thread_db
518 reports an error return 1. It means the inferior has corrupted thread
519 list and GDB should fall back only to LWPs.
521 If the nptl bug is present in the inferior return 0 to silently ignore
522 such errors, and let gdb enumerate threads again later. In such case
523 GDB cannot properly display LWPs if the inferior thread list is
524 corrupted. For core files it does not apply, no 'later enumeration'
527 if (!target_has_execution || !inferior_has_bug ("nptl_version", 2, 7))
529 exception_fprintf (gdb_stderr, except,
530 _("Warning: couldn't activate thread debugging "
531 "using libthread_db: "));
540 /* Lookup a library in which given symbol resides.
541 Note: this is looking in GDB process, not in the inferior.
542 Returns library name, or NULL. */
545 dladdr_to_soname (const void *addr)
549 if (dladdr (addr, &info) != 0)
550 return info.dli_fname;
554 /* State for check_thread_db_callback. */
556 struct check_thread_db_info
558 /* The libthread_db under test. */
559 struct thread_db_info *info;
561 /* True if progress should be logged. */
564 /* True if the callback was called. */
567 /* Name of last libthread_db function called. */
568 const char *last_call;
570 /* Value returned by last libthread_db call. */
571 td_err_e last_result;
574 static struct check_thread_db_info *tdb_testinfo;
576 /* Callback for check_thread_db. */
579 check_thread_db_callback (const td_thrhandle_t *th, void *arg)
581 gdb_assert (tdb_testinfo != NULL);
582 tdb_testinfo->threads_seen = true;
584 #define LOG(fmt, args...) \
587 if (tdb_testinfo->log_progress) \
589 debug_printf (fmt, ## args); \
590 gdb_flush (gdb_stdlog); \
595 #define CHECK_1(expr, args...) \
600 LOG (" ... FAIL!\n"); \
606 #define CHECK(expr) \
607 CHECK_1 (expr, "(%s) == false", #expr)
609 #define CALL_UNCHECKED(func, args...) \
612 tdb_testinfo->last_call = #func; \
613 tdb_testinfo->last_result \
614 = tdb_testinfo->info->func ## _p (args); \
618 #define CHECK_CALL() \
619 CHECK_1 (tdb_testinfo->last_result == TD_OK, \
620 _("%s failed: %s"), \
621 tdb_testinfo->last_call, \
622 thread_db_err_str (tdb_testinfo->last_result)) \
624 #define CALL(func, args...) \
627 CALL_UNCHECKED (func, args); \
634 /* Check td_ta_thr_iter passed consistent arguments. */
636 CHECK (arg == (void *) tdb_testinfo);
637 CHECK (th->th_ta_p == tdb_testinfo->info->thread_agent);
639 LOG (" %s", core_addr_to_string_nz ((CORE_ADDR) th->th_unique));
641 /* Check td_thr_get_info. */
643 CALL (td_thr_get_info, th, &ti);
645 LOG (" => %d", ti.ti_lid);
647 CHECK (ti.ti_ta_p == th->th_ta_p);
648 CHECK (ti.ti_tid == (thread_t) th->th_unique);
650 /* Check td_ta_map_lwp2thr. */
652 memset (&th2, 23, sizeof (td_thrhandle_t));
653 CALL_UNCHECKED (td_ta_map_lwp2thr, th->th_ta_p, ti.ti_lid, &th2);
655 if (tdb_testinfo->last_result == TD_ERR && !target_has_execution)
657 /* Some platforms require execution for td_ta_map_lwp2thr. */
658 LOG (_("; can't map_lwp2thr"));
664 LOG (" => %s", core_addr_to_string_nz ((CORE_ADDR) th2.th_unique));
666 CHECK (memcmp (th, &th2, sizeof (td_thrhandle_t)) == 0);
669 /* Attempt TLS access. Assuming errno is TLS, this calls
670 thread_db_get_thread_local_address, which in turn calls
671 td_thr_tls_get_addr for live inferiors or td_thr_tlsbase
672 for core files. This test is skipped if the thread has
673 not been recorded; proceeding in that case would result
674 in the test having the side-effect of noticing threads
677 Note that in glibc's libthread_db td_thr_tls_get_addr is
678 a thin wrapper around td_thr_tlsbase; this check always
679 hits the bulk of the code.
681 Note also that we don't actually check any libthread_db
682 calls are made, we just assume they were; future changes
683 to how GDB accesses TLS could result in this passing
684 without exercising the calls it's supposed to. */
685 ptid_t ptid = ptid_t (tdb_testinfo->info->pid, ti.ti_lid, 0);
686 struct thread_info *thread_info = find_thread_ptid (ptid);
687 if (thread_info != NULL && thread_info->priv != NULL)
691 scoped_restore_current_thread restore_current_thread;
692 switch_to_thread (ptid);
694 expression_up expr = parse_expression ("(int) errno");
695 struct value *val = evaluate_expression (expr.get ());
697 if (tdb_testinfo->log_progress)
699 struct value_print_options opts;
701 get_user_print_options (&opts);
703 value_print (val, gdb_stdlog, &opts);
712 #undef CALL_UNCHECKED
719 /* Run integrity checks on the dlopen()ed libthread_db described by
720 INFO. Returns true on success, displays a warning and returns
721 false on failure. Logs progress messages to gdb_stdlog during
722 the test if LOG_PROGRESS is true. */
725 check_thread_db (struct thread_db_info *info, bool log_progress)
727 bool test_passed = true;
730 debug_printf (_("Running libthread_db integrity checks:\n"));
732 /* GDB avoids using td_ta_thr_iter wherever possible (see comment
733 in try_thread_db_load_1 below) so in order to test it we may
734 have to locate it ourselves. */
735 td_ta_thr_iter_ftype *td_ta_thr_iter_p = info->td_ta_thr_iter_p;
736 if (td_ta_thr_iter_p == NULL)
738 void *thr_iter = verbose_dlsym (info->handle, "td_ta_thr_iter");
739 if (thr_iter == NULL)
742 td_ta_thr_iter_p = (td_ta_thr_iter_ftype *) thr_iter;
745 /* Set up the test state we share with the callback. */
746 gdb_assert (tdb_testinfo == NULL);
747 struct check_thread_db_info tdb_testinfo_buf;
748 tdb_testinfo = &tdb_testinfo_buf;
750 memset (tdb_testinfo, 0, sizeof (struct check_thread_db_info));
751 tdb_testinfo->info = info;
752 tdb_testinfo->log_progress = log_progress;
754 /* td_ta_thr_iter shouldn't be used on running processes. Note that
755 it's possible the inferior will stop midway through modifying one
756 of its thread lists, in which case the check will spuriously
758 linux_stop_and_wait_all_lwps ();
762 td_err_e err = td_ta_thr_iter_p (info->thread_agent,
763 check_thread_db_callback,
766 TD_THR_LOWEST_PRIORITY,
768 TD_THR_ANY_USER_FLAGS);
771 error (_("td_ta_thr_iter failed: %s"), thread_db_err_str (err));
773 if (!tdb_testinfo->threads_seen)
774 error (_("no threads seen"));
776 CATCH (except, RETURN_MASK_ERROR)
778 if (warning_pre_print)
779 fputs_unfiltered (warning_pre_print, gdb_stderr);
781 exception_fprintf (gdb_stderr, except,
782 _("libthread_db integrity checks failed: "));
788 if (test_passed && log_progress)
789 debug_printf (_("libthread_db integrity checks passed.\n"));
793 linux_unstop_all_lwps ();
798 /* Attempt to initialize dlopen()ed libthread_db, described by INFO.
800 Failure could happen if libthread_db does not have symbols we expect,
801 or when it refuses to work with the current inferior (e.g. due to
802 version mismatch between libthread_db and libpthread). */
805 try_thread_db_load_1 (struct thread_db_info *info)
809 /* Initialize pointers to the dynamic library functions we will use.
810 Essential functions first. */
812 #define TDB_VERBOSE_DLSYM(info, func) \
813 info->func ## _p = (func ## _ftype *) verbose_dlsym (info->handle, #func)
815 #define TDB_DLSYM(info, func) \
816 info->func ## _p = (func ## _ftype *) dlsym (info->handle, #func)
825 CHK (TDB_VERBOSE_DLSYM (info, td_init));
827 err = info->td_init_p ();
830 warning (_("Cannot initialize libthread_db: %s"),
831 thread_db_err_str (err));
835 CHK (TDB_VERBOSE_DLSYM (info, td_ta_new));
837 /* Initialize the structure that identifies the child process. */
838 info->proc_handle.thread = inferior_thread ();
840 /* Now attempt to open a connection to the thread library. */
841 err = info->td_ta_new_p (&info->proc_handle, &info->thread_agent);
844 if (libthread_db_debug)
845 fprintf_unfiltered (gdb_stdlog, _("td_ta_new failed: %s\n"),
846 thread_db_err_str (err));
851 #ifdef THREAD_DB_HAS_TD_VERSION
854 /* The errors above are not unexpected and silently ignored:
855 they just mean we haven't found correct version of
859 warning (_("td_ta_new failed: %s"), thread_db_err_str (err));
864 /* These are essential. */
865 CHK (TDB_VERBOSE_DLSYM (info, td_ta_map_lwp2thr));
866 CHK (TDB_VERBOSE_DLSYM (info, td_thr_get_info));
868 /* These are not essential. */
869 TDB_DLSYM (info, td_thr_tls_get_addr);
870 TDB_DLSYM (info, td_thr_tlsbase);
871 TDB_DLSYM (info, td_ta_delete);
873 /* It's best to avoid td_ta_thr_iter if possible. That walks data
874 structures in the inferior's address space that may be corrupted,
875 or, if the target is running, may change while we walk them. If
876 there's execution (and /proc is mounted), then we're already
877 attached to all LWPs. Use thread_from_lwp, which uses
878 td_ta_map_lwp2thr instead, which does not walk the thread list.
880 td_ta_map_lwp2thr uses ps_get_thread_area, but we can't use that
881 currently on core targets, as it uses ptrace directly. */
882 if (target_has_execution
883 && linux_proc_task_list_dir_exists (inferior_ptid.pid ()))
884 info->td_ta_thr_iter_p = NULL;
886 CHK (TDB_VERBOSE_DLSYM (info, td_ta_thr_iter));
888 #undef TDB_VERBOSE_DLSYM
892 /* Run integrity checks if requested. */
893 if (check_thread_db_on_load)
895 if (!check_thread_db (info, libthread_db_debug))
899 if (info->td_ta_thr_iter_p == NULL)
902 int pid = inferior_ptid.pid ();
903 thread_info *curr_thread = inferior_thread ();
905 linux_stop_and_wait_all_lwps ();
908 if (lp->ptid.pid () == pid)
909 thread_from_lwp (curr_thread, lp->ptid);
911 linux_unstop_all_lwps ();
913 else if (thread_db_find_new_threads_silently (inferior_thread ()) != 0)
915 /* Even if libthread_db initializes, if the thread list is
916 corrupted, we'd not manage to list any threads. Better reject this
917 thread_db, and fall back to at least listing LWPs. */
921 printf_unfiltered (_("[Thread debugging using libthread_db enabled]\n"));
923 if (*libthread_db_search_path || libthread_db_debug)
925 struct ui_file *file;
928 library = dladdr_to_soname ((const void *) *info->td_ta_new_p);
930 library = LIBTHREAD_DB_SO;
932 /* If we'd print this to gdb_stdout when debug output is
933 disabled, still print it to gdb_stdout if debug output is
934 enabled. User visible output should not depend on debug
936 file = *libthread_db_search_path != '\0' ? gdb_stdout : gdb_stdlog;
937 fprintf_unfiltered (file, _("Using host libthread_db library \"%s\".\n"),
941 /* The thread library was detected. Activate the thread_db target
942 if this is the first process using it. */
943 if (thread_db_list->next == NULL)
944 push_target (&the_thread_db_target);
949 /* Attempt to use LIBRARY as libthread_db. LIBRARY could be absolute,
950 relative, or just LIBTHREAD_DB. */
953 try_thread_db_load (const char *library, int check_auto_load_safe)
956 struct thread_db_info *info;
958 if (libthread_db_debug)
959 fprintf_unfiltered (gdb_stdlog,
960 _("Trying host libthread_db library: %s.\n"),
963 if (check_auto_load_safe)
965 if (access (library, R_OK) != 0)
967 /* Do not print warnings by file_is_auto_load_safe if the library does
968 not exist at this place. */
969 if (libthread_db_debug)
970 fprintf_unfiltered (gdb_stdlog, _("open failed: %s.\n"),
971 safe_strerror (errno));
975 if (!file_is_auto_load_safe (library, _("auto-load: Loading libthread-db "
976 "library \"%s\" from explicit "
982 handle = dlopen (library, RTLD_NOW);
985 if (libthread_db_debug)
986 fprintf_unfiltered (gdb_stdlog, _("dlopen failed: %s.\n"), dlerror ());
990 if (libthread_db_debug && strchr (library, '/') == NULL)
994 td_init = dlsym (handle, "td_init");
997 const char *const libpath = dladdr_to_soname (td_init);
1000 fprintf_unfiltered (gdb_stdlog, _("Host %s resolved to: %s.\n"),
1005 info = add_thread_db_info (handle);
1007 /* Do not save system library name, that one is always trusted. */
1008 if (strchr (library, '/') != NULL)
1009 info->filename = gdb_realpath (library).release ();
1011 if (try_thread_db_load_1 (info))
1014 /* This library "refused" to work on current inferior. */
1015 delete_thread_db_info (inferior_ptid.pid ());
1019 /* Subroutine of try_thread_db_load_from_pdir to simplify it.
1020 Try loading libthread_db in directory(OBJ)/SUBDIR.
1021 SUBDIR may be NULL. It may also be something like "../lib64".
1022 The result is true for success. */
1025 try_thread_db_load_from_pdir_1 (struct objfile *obj, const char *subdir)
1027 const char *obj_name = objfile_name (obj);
1029 if (obj_name[0] != '/')
1031 warning (_("Expected absolute pathname for libpthread in the"
1032 " inferior, but got %s."), obj_name);
1036 std::string path = obj_name;
1037 size_t cp = path.rfind ('/');
1038 /* This should at minimum hit the first character. */
1039 gdb_assert (cp != std::string::npos);
1040 path.resize (cp + 1);
1042 path = path + subdir + "/";
1043 path += LIBTHREAD_DB_SO;
1045 return try_thread_db_load (path.c_str (), 1);
1048 /* Handle $pdir in libthread-db-search-path.
1049 Look for libthread_db in directory(libpthread)/SUBDIR.
1050 SUBDIR may be NULL. It may also be something like "../lib64".
1051 The result is true for success. */
1054 try_thread_db_load_from_pdir (const char *subdir)
1056 struct objfile *obj;
1058 if (!auto_load_thread_db)
1062 if (libpthread_name_p (objfile_name (obj)))
1064 if (try_thread_db_load_from_pdir_1 (obj, subdir))
1067 /* We may have found the separate-debug-info version of
1068 libpthread, and it may live in a directory without a matching
1070 if (obj->separate_debug_objfile_backlink != NULL)
1071 return try_thread_db_load_from_pdir_1 (obj->separate_debug_objfile_backlink,
1080 /* Handle $sdir in libthread-db-search-path.
1081 Look for libthread_db in the system dirs, or wherever a plain
1082 dlopen(file_without_path) will look.
1083 The result is true for success. */
1086 try_thread_db_load_from_sdir (void)
1088 return try_thread_db_load (LIBTHREAD_DB_SO, 0);
1091 /* Try to load libthread_db from directory DIR of length DIR_LEN.
1092 The result is true for success. */
1095 try_thread_db_load_from_dir (const char *dir, size_t dir_len)
1097 if (!auto_load_thread_db)
1100 std::string path = std::string (dir, dir_len) + "/" + LIBTHREAD_DB_SO;
1102 return try_thread_db_load (path.c_str (), 1);
1105 /* Search libthread_db_search_path for libthread_db which "agrees"
1106 to work on current inferior.
1107 The result is true for success. */
1110 thread_db_load_search (void)
1114 std::vector<gdb::unique_xmalloc_ptr<char>> dir_vec
1115 = dirnames_to_char_ptr_vec (libthread_db_search_path);
1117 for (const gdb::unique_xmalloc_ptr<char> &this_dir_up : dir_vec)
1119 const char *this_dir = this_dir_up.get ();
1120 const int pdir_len = sizeof ("$pdir") - 1;
1121 size_t this_dir_len;
1123 this_dir_len = strlen (this_dir);
1125 if (strncmp (this_dir, "$pdir", pdir_len) == 0
1126 && (this_dir[pdir_len] == '\0'
1127 || this_dir[pdir_len] == '/'))
1129 const char *subdir = NULL;
1131 std::string subdir_holder;
1132 if (this_dir[pdir_len] == '/')
1134 subdir_holder = std::string (this_dir + pdir_len + 1);
1135 subdir = subdir_holder.c_str ();
1137 rc = try_thread_db_load_from_pdir (subdir);
1141 else if (strcmp (this_dir, "$sdir") == 0)
1143 if (try_thread_db_load_from_sdir ())
1151 if (try_thread_db_load_from_dir (this_dir, this_dir_len))
1159 if (libthread_db_debug)
1160 fprintf_unfiltered (gdb_stdlog,
1161 _("thread_db_load_search returning %d\n"), rc);
1165 /* Return non-zero if the inferior has a libpthread. */
1168 has_libpthread (void)
1170 struct objfile *obj;
1173 if (libpthread_name_p (objfile_name (obj)))
1179 /* Attempt to load and initialize libthread_db.
1180 Return 1 on success. */
1183 thread_db_load (void)
1185 struct thread_db_info *info;
1187 info = get_thread_db_info (inferior_ptid.pid ());
1192 /* Don't attempt to use thread_db on executables not running
1194 if (!target_has_registers)
1197 /* Don't attempt to use thread_db for remote targets. */
1198 if (!(target_can_run () || core_bfd))
1201 if (thread_db_load_search ())
1204 /* We couldn't find a libthread_db.
1205 If the inferior has a libpthread warn the user. */
1206 if (has_libpthread ())
1208 warning (_("Unable to find libthread_db matching inferior's thread"
1209 " library, thread debugging will not be available."));
1213 /* Either this executable isn't using libpthread at all, or it is
1214 statically linked. Since we can't easily distinguish these two cases,
1215 no warning is issued. */
1220 check_thread_signals (void)
1222 if (!thread_signals)
1227 lin_thread_get_thread_signals (&mask);
1228 sigemptyset (&thread_stop_set);
1229 sigemptyset (&thread_print_set);
1231 for (i = 1; i < NSIG; i++)
1233 if (sigismember (&mask, i))
1235 if (signal_stop_update (gdb_signal_from_host (i), 0))
1236 sigaddset (&thread_stop_set, i);
1237 if (signal_print_update (gdb_signal_from_host (i), 0))
1238 sigaddset (&thread_print_set, i);
1245 /* Check whether thread_db is usable. This function is called when
1246 an inferior is created (or otherwise acquired, e.g. attached to)
1247 and when new shared libraries are loaded into a running process. */
1250 check_for_thread_db (void)
1252 /* Do nothing if we couldn't load libthread_db.so.1. */
1253 if (!thread_db_load ())
1257 /* This function is called via the new_objfile observer. */
1260 thread_db_new_objfile (struct objfile *objfile)
1262 /* This observer must always be called with inferior_ptid set
1266 /* libpthread with separate debug info has its debug info file already
1267 loaded (and notified without successful thread_db initialization)
1268 the time gdb::observers::new_objfile.notify is called for the library itself.
1269 Static executables have their separate debug info loaded already
1270 before the inferior has started. */
1271 && objfile->separate_debug_objfile_backlink == NULL
1272 /* Only check for thread_db if we loaded libpthread,
1273 or if this is the main symbol file.
1274 We need to check OBJF_MAINLINE to handle the case of debugging
1275 a statically linked executable AND the symbol file is specified AFTER
1276 the exec file is loaded (e.g., gdb -c core ; file foo).
1277 For dynamically linked executables, libpthread can be near the end
1278 of the list of shared libraries to load, and in an app of several
1279 thousand shared libraries, this can otherwise be painful. */
1280 && ((objfile->flags & OBJF_MAINLINE) != 0
1281 || libpthread_name_p (objfile_name (objfile))))
1282 check_for_thread_db ();
1286 check_pid_namespace_match (void)
1288 /* Check is only relevant for local targets targets. */
1289 if (target_can_run ())
1291 /* If the child is in a different PID namespace, its idea of its
1292 PID will differ from our idea of its PID. When we scan the
1293 child's thread list, we'll mistakenly think it has no threads
1294 since the thread PID fields won't match the PID we give to
1296 if (!linux_ns_same (inferior_ptid.pid (), LINUX_NS_PID))
1298 warning (_ ("Target and debugger are in different PID "
1299 "namespaces; thread lists and other data are "
1300 "likely unreliable. "
1301 "Connect to gdbserver inside the container."));
1306 /* This function is called via the inferior_created observer.
1307 This handles the case of debugging statically linked executables. */
1310 thread_db_inferior_created (struct target_ops *target, int from_tty)
1312 check_pid_namespace_match ();
1313 check_for_thread_db ();
1316 /* Update the thread's state (what's displayed in "info threads"),
1317 from libthread_db thread state information. */
1320 update_thread_state (thread_db_thread_info *priv,
1321 const td_thrinfo_t *ti_p)
1323 priv->dying = (ti_p->ti_state == TD_THR_UNKNOWN
1324 || ti_p->ti_state == TD_THR_ZOMBIE);
1327 /* Record a new thread in GDB's thread list. Creates the thread's
1328 private info. If TP is NULL or TP is marked as having exited,
1329 creates a new thread. Otherwise, uses TP. */
1331 static struct thread_info *
1332 record_thread (struct thread_db_info *info,
1333 struct thread_info *tp,
1334 ptid_t ptid, const td_thrhandle_t *th_p,
1335 const td_thrinfo_t *ti_p)
1337 /* A thread ID of zero may mean the thread library has not
1338 initialized yet. Leave private == NULL until the thread library
1340 if (ti_p->ti_tid == 0)
1343 /* Construct the thread's private data. */
1344 thread_db_thread_info *priv = new thread_db_thread_info;
1347 priv->tid = ti_p->ti_tid;
1348 update_thread_state (priv, ti_p);
1350 /* Add the thread to GDB's thread list. If we already know about a
1351 thread with this PTID, but it's marked exited, then the kernel
1352 reused the tid of an old thread. */
1353 if (tp == NULL || tp->state == THREAD_EXITED)
1354 tp = add_thread_with_info (ptid, priv);
1356 tp->priv.reset (priv);
1358 if (target_has_execution)
1359 check_thread_signals ();
1365 thread_db_target::detach (inferior *inf, int from_tty)
1367 delete_thread_db_info (inf->pid);
1369 beneath ()->detach (inf, from_tty);
1371 /* NOTE: From this point on, inferior_ptid is null_ptid. */
1373 /* If there are no more processes using libpthread, detach the
1374 thread_db target ops. */
1375 if (!thread_db_list)
1376 unpush_target (this);
1380 thread_db_target::wait (ptid_t ptid, struct target_waitstatus *ourstatus,
1383 struct thread_db_info *info;
1385 ptid = beneath ()->wait (ptid, ourstatus, options);
1387 switch (ourstatus->kind)
1389 case TARGET_WAITKIND_IGNORE:
1390 case TARGET_WAITKIND_EXITED:
1391 case TARGET_WAITKIND_THREAD_EXITED:
1392 case TARGET_WAITKIND_SIGNALLED:
1396 info = get_thread_db_info (ptid.pid ());
1398 /* If this process isn't using thread_db, we're done. */
1402 if (ourstatus->kind == TARGET_WAITKIND_EXECD)
1404 /* New image, it may or may not end up using thread_db. Assume
1405 not unless we find otherwise. */
1406 delete_thread_db_info (ptid.pid ());
1407 if (!thread_db_list)
1408 unpush_target (&the_thread_db_target);
1413 /* Fill in the thread's user-level thread id and status. */
1414 thread_from_lwp (find_thread_ptid (ptid), ptid);
1420 thread_db_target::mourn_inferior ()
1422 delete_thread_db_info (inferior_ptid.pid ());
1424 beneath ()->mourn_inferior ();
1426 /* Detach thread_db target ops. */
1427 if (!thread_db_list)
1428 unpush_target (&the_thread_db_target);
1431 struct callback_data
1433 struct thread_db_info *info;
1438 find_new_threads_callback (const td_thrhandle_t *th_p, void *data)
1442 struct thread_info *tp;
1443 struct callback_data *cb_data = (struct callback_data *) data;
1444 struct thread_db_info *info = cb_data->info;
1446 err = info->td_thr_get_info_p (th_p, &ti);
1448 error (_("find_new_threads_callback: cannot get thread info: %s"),
1449 thread_db_err_str (err));
1451 if (ti.ti_lid == -1)
1453 /* A thread with kernel thread ID -1 is either a thread that
1454 exited and was joined, or a thread that is being created but
1455 hasn't started yet, and that is reusing the tcb/stack of a
1456 thread that previously exited and was joined. (glibc marks
1457 terminated and joined threads with kernel thread ID -1. See
1459 if (libthread_db_debug)
1460 fprintf_unfiltered (gdb_stdlog,
1461 "thread_db: skipping exited and "
1462 "joined thread (0x%lx)\n",
1463 (unsigned long) ti.ti_tid);
1469 /* A thread ID of zero means that this is the main thread, but
1470 glibc has not yet initialized thread-local storage and the
1471 pthread library. We do not know what the thread's TID will
1474 /* In that case, we're not stopped in a fork syscall and don't
1475 need this glibc bug workaround. */
1476 info->need_stale_parent_threads_check = 0;
1481 /* Ignore stale parent threads, caused by glibc/BZ5983. This is a
1482 bit expensive, as it needs to open /proc/pid/status, so try to
1483 avoid doing the work if we know we don't have to. */
1484 if (info->need_stale_parent_threads_check)
1486 int tgid = linux_proc_get_tgid (ti.ti_lid);
1488 if (tgid != -1 && tgid != info->pid)
1492 ptid_t ptid (info->pid, ti.ti_lid);
1493 tp = find_thread_ptid (ptid);
1494 if (tp == NULL || tp->priv == NULL)
1495 record_thread (info, tp, ptid, th_p, &ti);
1500 /* Helper for thread_db_find_new_threads_2.
1501 Returns number of new threads found. */
1504 find_new_threads_once (struct thread_db_info *info, int iteration,
1507 struct callback_data data;
1508 td_err_e err = TD_ERR;
1511 data.new_threads = 0;
1513 /* See comment in thread_db_update_thread_list. */
1514 gdb_assert (info->td_ta_thr_iter_p != NULL);
1518 /* Iterate over all user-space threads to discover new threads. */
1519 err = info->td_ta_thr_iter_p (info->thread_agent,
1520 find_new_threads_callback,
1523 TD_THR_LOWEST_PRIORITY,
1525 TD_THR_ANY_USER_FLAGS);
1527 CATCH (except, RETURN_MASK_ERROR)
1529 if (libthread_db_debug)
1531 exception_fprintf (gdb_stdlog, except,
1532 "Warning: find_new_threads_once: ");
1537 if (libthread_db_debug)
1539 fprintf_unfiltered (gdb_stdlog,
1540 _("Found %d new threads in iteration %d.\n"),
1541 data.new_threads, iteration);
1547 return data.new_threads;
1550 /* Search for new threads, accessing memory through stopped thread
1551 PTID. If UNTIL_NO_NEW is true, repeat searching until several
1552 searches in a row do not discover any new threads. */
1555 thread_db_find_new_threads_2 (thread_info *stopped, bool until_no_new)
1557 td_err_e err = TD_OK;
1558 struct thread_db_info *info;
1561 info = get_thread_db_info (stopped->ptid.pid ());
1563 /* Access an lwp we know is stopped. */
1564 info->proc_handle.thread = stopped;
1568 /* Require 4 successive iterations which do not find any new threads.
1569 The 4 is a heuristic: there is an inherent race here, and I have
1570 seen that 2 iterations in a row are not always sufficient to
1571 "capture" all threads. */
1572 for (i = 0, loop = 0; loop < 4 && err == TD_OK; ++i, ++loop)
1573 if (find_new_threads_once (info, i, &err) != 0)
1575 /* Found some new threads. Restart the loop from beginning. */
1580 find_new_threads_once (info, 0, &err);
1583 error (_("Cannot find new threads: %s"), thread_db_err_str (err));
1587 thread_db_find_new_threads_1 (thread_info *stopped)
1589 thread_db_find_new_threads_2 (stopped, 0);
1592 /* Implement the to_update_thread_list target method for this
1596 thread_db_target::update_thread_list ()
1598 struct thread_db_info *info;
1602 for (inferior *inf : all_inferiors ())
1604 struct thread_info *thread;
1609 info = get_thread_db_info (inf->pid);
1613 thread = any_live_thread_of_inferior (inf);
1614 if (thread == NULL || thread->executing)
1617 /* It's best to avoid td_ta_thr_iter if possible. That walks
1618 data structures in the inferior's address space that may be
1619 corrupted, or, if the target is running, the list may change
1620 while we walk it. In the latter case, it's possible that a
1621 thread exits just at the exact time that causes GDB to get
1622 stuck in an infinite loop. To avoid pausing all threads
1623 whenever the core wants to refresh the thread list, we
1624 instead use thread_from_lwp immediately when we see an LWP
1625 stop. That uses thread_db entry points that do not walk
1626 libpthread's thread list, so should be safe, as well as more
1628 if (target_has_execution_1 (thread->ptid))
1631 thread_db_find_new_threads_1 (thread);
1634 /* Give the beneath target a chance to do extra processing. */
1635 this->beneath ()->update_thread_list ();
1639 thread_db_target::pid_to_str (ptid_t ptid)
1641 struct thread_info *thread_info = find_thread_ptid (ptid);
1643 if (thread_info != NULL && thread_info->priv != NULL)
1645 static char buf[64];
1646 thread_db_thread_info *priv = get_thread_db_thread_info (thread_info);
1648 snprintf (buf, sizeof (buf), "Thread 0x%lx (LWP %ld)",
1649 (unsigned long) priv->tid, ptid.lwp ());
1654 return beneath ()->pid_to_str (ptid);
1657 /* Return a string describing the state of the thread specified by
1661 thread_db_target::extra_thread_info (thread_info *info)
1663 if (info->priv == NULL)
1666 thread_db_thread_info *priv = get_thread_db_thread_info (info);
1674 /* Return pointer to the thread_info struct which corresponds to
1675 THREAD_HANDLE (having length HANDLE_LEN). */
1678 thread_db_target::thread_handle_to_thread_info (const gdb_byte *thread_handle,
1682 thread_t handle_tid;
1684 /* Thread handle sizes must match in order to proceed. We don't use an
1685 assert here because the resulting internal error will cause GDB to
1686 exit. This isn't necessarily an internal error due to the possibility
1687 of garbage being passed as the thread handle via the python interface. */
1688 if (handle_len != sizeof (handle_tid))
1689 error (_("Thread handle size mismatch: %d vs %zu (from libthread_db)"),
1690 handle_len, sizeof (handle_tid));
1692 handle_tid = * (const thread_t *) thread_handle;
1694 for (thread_info *tp : inf->non_exited_threads ())
1696 thread_db_thread_info *priv = get_thread_db_thread_info (tp);
1698 if (priv != NULL && handle_tid == priv->tid)
1705 /* Get the address of the thread local variable in load module LM which
1706 is stored at OFFSET within the thread local storage for thread PTID. */
1709 thread_db_target::get_thread_local_address (ptid_t ptid,
1713 struct thread_info *thread_info;
1715 /* Find the matching thread. */
1716 thread_info = find_thread_ptid (ptid);
1718 /* We may not have discovered the thread yet. */
1719 if (thread_info != NULL && thread_info->priv == NULL)
1720 thread_info = thread_from_lwp (thread_info, ptid);
1722 if (thread_info != NULL && thread_info->priv != NULL)
1726 thread_db_info *info = get_thread_db_info (ptid.pid ());
1727 thread_db_thread_info *priv = get_thread_db_thread_info (thread_info);
1729 /* Finally, get the address of the variable. */
1732 /* glibc doesn't provide the needed interface. */
1733 if (!info->td_thr_tls_get_addr_p)
1734 throw_error (TLS_NO_LIBRARY_SUPPORT_ERROR,
1735 _("No TLS library support"));
1737 /* Note the cast through uintptr_t: this interface only works if
1738 a target address fits in a psaddr_t, which is a host pointer.
1739 So a 32-bit debugger can not access 64-bit TLS through this. */
1740 err = info->td_thr_tls_get_addr_p (&priv->th,
1741 (psaddr_t)(uintptr_t) lm,
1746 /* If glibc doesn't provide the needed interface throw an error
1747 that LM is zero - normally cases it should not be. */
1748 if (!info->td_thr_tlsbase_p)
1749 throw_error (TLS_LOAD_MODULE_NOT_FOUND_ERROR,
1750 _("TLS load module not found"));
1752 /* This code path handles the case of -static -pthread executables:
1753 https://sourceware.org/ml/libc-help/2014-03/msg00024.html
1754 For older GNU libc r_debug.r_map is NULL. For GNU libc after
1755 PR libc/16831 due to GDB PR threads/16954 LOAD_MODULE is also NULL.
1756 The constant number 1 depends on GNU __libc_setup_tls
1757 initialization of l_tls_modid to 1. */
1758 err = info->td_thr_tlsbase_p (&priv->th, 1, &address);
1759 address = (char *) address + offset;
1762 #ifdef THREAD_DB_HAS_TD_NOTALLOC
1763 /* The memory hasn't been allocated, yet. */
1764 if (err == TD_NOTALLOC)
1765 /* Now, if libthread_db provided the initialization image's
1766 address, we *could* try to build a non-lvalue value from
1767 the initialization image. */
1768 throw_error (TLS_NOT_ALLOCATED_YET_ERROR,
1769 _("TLS not allocated yet"));
1772 /* Something else went wrong. */
1774 throw_error (TLS_GENERIC_ERROR,
1775 (("%s")), thread_db_err_str (err));
1777 /* Cast assuming host == target. Joy. */
1778 /* Do proper sign extension for the target. */
1779 gdb_assert (exec_bfd);
1780 return (bfd_get_sign_extend_vma (exec_bfd) > 0
1781 ? (CORE_ADDR) (intptr_t) address
1782 : (CORE_ADDR) (uintptr_t) address);
1785 return beneath ()->get_thread_local_address (ptid, lm, offset);
1788 /* Implement the to_get_ada_task_ptid target method for this target. */
1791 thread_db_target::get_ada_task_ptid (long lwp, long thread)
1793 /* NPTL uses a 1:1 model, so the LWP id suffices. */
1794 return ptid_t (inferior_ptid.pid (), lwp, 0);
1798 thread_db_target::resume (ptid_t ptid, int step, enum gdb_signal signo)
1800 struct thread_db_info *info;
1802 if (ptid == minus_one_ptid)
1803 info = get_thread_db_info (inferior_ptid.pid ());
1805 info = get_thread_db_info (ptid.pid ());
1807 /* This workaround is only needed for child fork lwps stopped in a
1808 PTRACE_O_TRACEFORK event. When the inferior is resumed, the
1809 workaround can be disabled. */
1811 info->need_stale_parent_threads_check = 0;
1813 beneath ()->resume (ptid, step, signo);
1816 /* std::sort helper function for info_auto_load_libthread_db, sort the
1817 thread_db_info pointers primarily by their FILENAME and secondarily by their
1818 PID, both in ascending order. */
1821 info_auto_load_libthread_db_compare (const struct thread_db_info *a,
1822 const struct thread_db_info *b)
1826 retval = strcmp (a->filename, b->filename);
1830 return a->pid < b->pid;
1833 /* Implement 'info auto-load libthread-db'. */
1836 info_auto_load_libthread_db (const char *args, int from_tty)
1838 struct ui_out *uiout = current_uiout;
1839 const char *cs = args ? args : "";
1840 struct thread_db_info *info;
1841 unsigned unique_filenames;
1842 size_t max_filename_len, pids_len;
1845 cs = skip_spaces (cs);
1847 error (_("'info auto-load libthread-db' does not accept any parameters"));
1849 std::vector<struct thread_db_info *> array;
1850 for (info = thread_db_list; info; info = info->next)
1851 if (info->filename != NULL)
1852 array.push_back (info);
1854 /* Sort ARRAY by filenames and PIDs. */
1855 std::sort (array.begin (), array.end (),
1856 info_auto_load_libthread_db_compare);
1858 /* Calculate the number of unique filenames (rows) and the maximum string
1859 length of PIDs list for the unique filenames (columns). */
1861 unique_filenames = 0;
1862 max_filename_len = 0;
1864 for (i = 0; i < array.size (); i++)
1866 int pid = array[i]->pid;
1867 size_t this_pid_len;
1869 for (this_pid_len = 0; pid != 0; pid /= 10)
1872 if (i == 0 || strcmp (array[i - 1]->filename, array[i]->filename) != 0)
1875 max_filename_len = std::max (max_filename_len,
1876 strlen (array[i]->filename));
1879 pids_len -= strlen (", ");
1882 pids_len += this_pid_len + strlen (", ");
1885 pids_len -= strlen (", ");
1887 /* Table header shifted right by preceding "libthread-db: " would not match
1889 if (array.size () > 0 && args == auto_load_info_scripts_pattern_nl)
1893 ui_out_emit_table table_emitter (uiout, 2, unique_filenames,
1894 "LinuxThreadDbTable");
1896 uiout->table_header (max_filename_len, ui_left, "filename", "Filename");
1897 uiout->table_header (pids_len, ui_left, "PIDs", "Pids");
1898 uiout->table_body ();
1900 /* Note I is incremented inside the cycle, not at its end. */
1901 for (i = 0; i < array.size ();)
1903 ui_out_emit_tuple tuple_emitter (uiout, NULL);
1906 uiout->field_string ("filename", info->filename);
1909 while (i < array.size () && strcmp (info->filename,
1910 array[i]->filename) == 0)
1914 string_appendf (pids, "%u", array[i]->pid);
1918 uiout->field_string ("pids", pids.c_str ());
1925 uiout->message (_("No auto-loaded libthread-db.\n"));
1928 /* Implement 'maintenance check libthread-db'. */
1931 maintenance_check_libthread_db (const char *args, int from_tty)
1933 int inferior_pid = inferior_ptid.pid ();
1934 struct thread_db_info *info;
1936 if (inferior_pid == 0)
1937 error (_("No inferior running"));
1939 info = get_thread_db_info (inferior_pid);
1941 error (_("No libthread_db loaded"));
1943 check_thread_db (info, true);
1947 _initialize_thread_db (void)
1949 /* Defer loading of libthread_db.so until inferior is running.
1950 This allows gdb to load correct libthread_db for a given
1951 executable -- there could be multiple versions of glibc,
1952 and until there is a running inferior, we can't tell which
1953 libthread_db is the correct one to load. */
1955 libthread_db_search_path = xstrdup (LIBTHREAD_DB_SEARCH_PATH);
1957 add_setshow_optional_filename_cmd ("libthread-db-search-path",
1959 &libthread_db_search_path, _("\
1960 Set search path for libthread_db."), _("\
1961 Show the current search path or libthread_db."), _("\
1962 This path is used to search for libthread_db to be loaded into \
1964 Its value is a colon (':') separate list of directories to search.\n\
1965 Setting the search path to an empty list resets it to its default value."),
1966 set_libthread_db_search_path,
1968 &setlist, &showlist);
1970 add_setshow_zuinteger_cmd ("libthread-db", class_maintenance,
1971 &libthread_db_debug, _("\
1972 Set libthread-db debugging."), _("\
1973 Show libthread-db debugging."), _("\
1974 When non-zero, libthread-db debugging is enabled."),
1976 show_libthread_db_debug,
1977 &setdebuglist, &showdebuglist);
1979 add_setshow_boolean_cmd ("libthread-db", class_support,
1980 &auto_load_thread_db, _("\
1981 Enable or disable auto-loading of inferior specific libthread_db."), _("\
1982 Show whether auto-loading inferior specific libthread_db is enabled."), _("\
1983 If enabled, libthread_db will be searched in 'set libthread-db-search-path'\n\
1984 locations to load libthread_db compatible with the inferior.\n\
1985 Standard system libthread_db still gets loaded even with this option off.\n\
1986 This options has security implications for untrusted inferiors."),
1987 NULL, show_auto_load_thread_db,
1988 auto_load_set_cmdlist_get (),
1989 auto_load_show_cmdlist_get ());
1991 add_cmd ("libthread-db", class_info, info_auto_load_libthread_db,
1992 _("Print the list of loaded inferior specific libthread_db.\n\
1993 Usage: info auto-load libthread-db"),
1994 auto_load_info_cmdlist_get ());
1996 add_cmd ("libthread-db", class_maintenance,
1997 maintenance_check_libthread_db, _("\
1998 Run integrity checks on the current inferior's libthread_db."),
1999 &maintenancechecklist);
2001 add_setshow_boolean_cmd ("check-libthread-db",
2003 &check_thread_db_on_load, _("\
2004 Set whether to check libthread_db at load time."), _("\
2005 Show whether to check libthread_db at load time."), _("\
2006 If enabled GDB will run integrity checks on inferior specific libthread_db\n\
2007 as they are loaded."),
2010 &maintenance_set_cmdlist,
2011 &maintenance_show_cmdlist);
2013 /* Add ourselves to objfile event chain. */
2014 gdb::observers::new_objfile.attach (thread_db_new_objfile);
2016 /* Add ourselves to inferior_created event chain.
2017 This is needed to handle debugging statically linked programs where
2018 the new_objfile observer won't get called for libpthread. */
2019 gdb::observers::inferior_created.attach (thread_db_inferior_created);