Add generated source files and fix thinko in aarch64-asm.c
[binutils-gdb.git] / gdb / sol-thread.c
blobd2092f4eed1edb171eab4fad25d312bcc9a98751
1 /* Solaris threads debugging interface.
3 Copyright (C) 1996-2024 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/>. */
20 /* This module implements a sort of half target that sits between the
21 machine-independent parts of GDB and the /proc interface (procfs.c)
22 to provide access to the Solaris user-mode thread implementation.
24 Solaris threads are true user-mode threads, which are invoked via
25 the thr_* and pthread_* (native and POSIX respectively) interfaces.
26 These are mostly implemented in user-space, with all thread context
27 kept in various structures that live in the user's heap. These
28 should not be confused with lightweight processes (LWPs), which are
29 implemented by the kernel, and scheduled without explicit
30 intervention by the process.
32 Just to confuse things a little, Solaris threads (both native and
33 POSIX) are actually implemented using LWPs. In general, there are
34 going to be more threads than LWPs. There is no fixed
35 correspondence between a thread and an LWP. When a thread wants to
36 run, it gets scheduled onto the first available LWP and can
37 therefore migrate from one LWP to another as time goes on. A
38 sleeping thread may not be associated with an LWP at all!
40 To make it possible to mess with threads, Sun provides a library
41 called libthread_db.so.1 (not to be confused with
42 libthread_db.so.0, which doesn't have a published interface). This
43 interface has an upper part, which it provides, and a lower part
44 which we provide. The upper part consists of the td_* routines,
45 which allow us to find all the threads, query their state, etc...
46 The lower part consists of all of the ps_*, which are used by the
47 td_* routines to read/write memory, manipulate LWPs, lookup
48 symbols, etc... The ps_* routines actually do most of their work
49 by calling functions in procfs.c. */
51 #include "defs.h"
52 #include <thread.h>
53 #include <proc_service.h>
54 #include <thread_db.h>
55 #include "gdbthread.h"
56 #include "target.h"
57 #include "inferior.h"
58 #include <fcntl.h>
59 #include <sys/stat.h>
60 #include <dlfcn.h>
61 #include "gdbcmd.h"
62 #include "gdbcore.h"
63 #include "regcache.h"
64 #include "solib.h"
65 #include "symfile.h"
66 #include "observable.h"
67 #include "procfs.h"
68 #include "symtab.h"
69 #include "minsyms.h"
70 #include "objfiles.h"
72 static const target_info thread_db_target_info = {
73 "solaris-threads",
74 N_("Solaris threads and pthread."),
75 N_("Solaris threads and pthread support.")
78 class sol_thread_target final : public target_ops
80 public:
81 const target_info &info () const override
82 { return thread_db_target_info; }
84 strata stratum () const override { return thread_stratum; }
86 void detach (inferior *, int) override;
87 ptid_t wait (ptid_t, struct target_waitstatus *, target_wait_flags) override;
88 void resume (ptid_t, int, enum gdb_signal) override;
89 void mourn_inferior () override;
90 std::string pid_to_str (ptid_t) override;
91 ptid_t get_ada_task_ptid (long lwp, ULONGEST thread) override;
93 void fetch_registers (struct regcache *, int) override;
94 void store_registers (struct regcache *, int) override;
96 enum target_xfer_status xfer_partial (enum target_object object,
97 const char *annex,
98 gdb_byte *readbuf,
99 const gdb_byte *writebuf,
100 ULONGEST offset, ULONGEST len,
101 ULONGEST *xfered_len) override;
103 bool thread_alive (ptid_t ptid) override;
104 void update_thread_list () override;
107 static sol_thread_target sol_thread_ops;
109 /* Prototypes for supply_gregset etc. */
110 #include "gregset.h"
112 /* This struct is defined by us, but mainly used for the proc_service
113 interface. We don't have much use for it, except as a handy place
114 to get a real PID for memory accesses. */
116 struct ps_prochandle
118 ptid_t ptid;
121 struct string_map
123 int num;
124 const char *str;
127 static struct ps_prochandle main_ph;
128 static td_thragent_t *main_ta;
129 static int sol_thread_active = 0;
131 /* Default definitions: These must be defined in tm.h if they are to
132 be shared with a process module such as procfs. */
134 /* Types of the libthread_db functions. */
136 typedef void (td_log_ftype)(const int on_off);
137 typedef td_err_e (td_ta_new_ftype)(const struct ps_prochandle *ph_p,
138 td_thragent_t **ta_pp);
139 typedef td_err_e (td_ta_delete_ftype)(td_thragent_t *ta_p);
140 typedef td_err_e (td_init_ftype)(void);
141 typedef td_err_e (td_ta_get_ph_ftype)(const td_thragent_t *ta_p,
142 struct ps_prochandle **ph_pp);
143 typedef td_err_e (td_ta_get_nthreads_ftype)(const td_thragent_t *ta_p,
144 int *nthread_p);
145 typedef td_err_e (td_ta_tsd_iter_ftype)(const td_thragent_t *ta_p,
146 td_key_iter_f *cb, void *cbdata_p);
147 typedef td_err_e (td_ta_thr_iter_ftype)(const td_thragent_t *ta_p,
148 td_thr_iter_f *cb, void *cbdata_p,
149 td_thr_state_e state, int ti_pri,
150 sigset_t *ti_sigmask_p,
151 unsigned ti_user_flags);
152 typedef td_err_e (td_thr_validate_ftype)(const td_thrhandle_t *th_p);
153 typedef td_err_e (td_thr_tsd_ftype)(const td_thrhandle_t * th_p,
154 const thread_key_t key, void **data_pp);
155 typedef td_err_e (td_thr_get_info_ftype)(const td_thrhandle_t *th_p,
156 td_thrinfo_t *ti_p);
157 typedef td_err_e (td_thr_getfpregs_ftype)(const td_thrhandle_t *th_p,
158 prfpregset_t *fpregset);
159 typedef td_err_e (td_thr_getxregsize_ftype)(const td_thrhandle_t *th_p,
160 int *xregsize);
161 typedef td_err_e (td_thr_getxregs_ftype)(const td_thrhandle_t *th_p,
162 const caddr_t xregset);
163 typedef td_err_e (td_thr_sigsetmask_ftype)(const td_thrhandle_t *th_p,
164 const sigset_t ti_sigmask);
165 typedef td_err_e (td_thr_setprio_ftype)(const td_thrhandle_t *th_p,
166 const int ti_pri);
167 typedef td_err_e (td_thr_setsigpending_ftype)(const td_thrhandle_t *th_p,
168 const uchar_t ti_pending_flag,
169 const sigset_t ti_pending);
170 typedef td_err_e (td_thr_setfpregs_ftype)(const td_thrhandle_t *th_p,
171 const prfpregset_t *fpregset);
172 typedef td_err_e (td_thr_setxregs_ftype)(const td_thrhandle_t *th_p,
173 const caddr_t xregset);
174 typedef td_err_e (td_ta_map_id2thr_ftype)(const td_thragent_t *ta_p,
175 thread_t tid,
176 td_thrhandle_t *th_p);
177 typedef td_err_e (td_ta_map_lwp2thr_ftype)(const td_thragent_t *ta_p,
178 lwpid_t lwpid,
179 td_thrhandle_t *th_p);
180 typedef td_err_e (td_thr_getgregs_ftype)(const td_thrhandle_t *th_p,
181 prgregset_t regset);
182 typedef td_err_e (td_thr_setgregs_ftype)(const td_thrhandle_t *th_p,
183 const prgregset_t regset);
185 /* Pointers to routines from libthread_db resolved by dlopen(). */
187 static td_log_ftype *p_td_log;
188 static td_ta_new_ftype *p_td_ta_new;
189 static td_ta_delete_ftype *p_td_ta_delete;
190 static td_init_ftype *p_td_init;
191 static td_ta_get_ph_ftype *p_td_ta_get_ph;
192 static td_ta_get_nthreads_ftype *p_td_ta_get_nthreads;
193 static td_ta_tsd_iter_ftype *p_td_ta_tsd_iter;
194 static td_ta_thr_iter_ftype *p_td_ta_thr_iter;
195 static td_thr_validate_ftype *p_td_thr_validate;
196 static td_thr_tsd_ftype *p_td_thr_tsd;
197 static td_thr_get_info_ftype *p_td_thr_get_info;
198 static td_thr_getfpregs_ftype *p_td_thr_getfpregs;
199 static td_thr_getxregsize_ftype *p_td_thr_getxregsize;
200 static td_thr_getxregs_ftype *p_td_thr_getxregs;
201 static td_thr_sigsetmask_ftype *p_td_thr_sigsetmask;
202 static td_thr_setprio_ftype *p_td_thr_setprio;
203 static td_thr_setsigpending_ftype *p_td_thr_setsigpending;
204 static td_thr_setfpregs_ftype *p_td_thr_setfpregs;
205 static td_thr_setxregs_ftype *p_td_thr_setxregs;
206 static td_ta_map_id2thr_ftype *p_td_ta_map_id2thr;
207 static td_ta_map_lwp2thr_ftype *p_td_ta_map_lwp2thr;
208 static td_thr_getgregs_ftype *p_td_thr_getgregs;
209 static td_thr_setgregs_ftype *p_td_thr_setgregs;
212 /* Return the libthread_db error string associated with ERRCODE. If
213 ERRCODE is unknown, return an appropriate message. */
215 static const char *
216 td_err_string (td_err_e errcode)
218 static struct string_map td_err_table[] =
220 { TD_OK, "generic \"call succeeded\"" },
221 { TD_ERR, "generic error." },
222 { TD_NOTHR, "no thread can be found to satisfy query" },
223 { TD_NOSV, "no synch. variable can be found to satisfy query" },
224 { TD_NOLWP, "no lwp can be found to satisfy query" },
225 { TD_BADPH, "invalid process handle" },
226 { TD_BADTH, "invalid thread handle" },
227 { TD_BADSH, "invalid synchronization handle" },
228 { TD_BADTA, "invalid thread agent" },
229 { TD_BADKEY, "invalid key" },
230 { TD_NOMSG, "td_thr_event_getmsg() called when there was no message" },
231 { TD_NOFPREGS, "FPU register set not available for given thread" },
232 { TD_NOLIBTHREAD, "application not linked with libthread" },
233 { TD_NOEVENT, "requested event is not supported" },
234 { TD_NOCAPAB, "capability not available" },
235 { TD_DBERR, "Debugger service failed" },
236 { TD_NOAPLIC, "Operation not applicable to" },
237 { TD_NOTSD, "No thread specific data for this thread" },
238 { TD_MALLOC, "Malloc failed" },
239 { TD_PARTIALREG, "Only part of register set was written/read" },
240 { TD_NOXREGS, "X register set not available for given thread" }
242 const int td_err_size = sizeof td_err_table / sizeof (struct string_map);
243 int i;
244 static char buf[50];
246 for (i = 0; i < td_err_size; i++)
247 if (td_err_table[i].num == errcode)
248 return td_err_table[i].str;
250 xsnprintf (buf, sizeof (buf), "Unknown libthread_db error code: %d",
251 errcode);
253 return buf;
256 /* Return the libthread_db state string associated with STATECODE.
257 If STATECODE is unknown, return an appropriate message. */
259 static const char *
260 td_state_string (td_thr_state_e statecode)
262 static struct string_map td_thr_state_table[] =
264 { TD_THR_ANY_STATE, "any state" },
265 { TD_THR_UNKNOWN, "unknown" },
266 { TD_THR_STOPPED, "stopped" },
267 { TD_THR_RUN, "run" },
268 { TD_THR_ACTIVE, "active" },
269 { TD_THR_ZOMBIE, "zombie" },
270 { TD_THR_SLEEP, "sleep" },
271 { TD_THR_STOPPED_ASLEEP, "stopped asleep" }
273 const int td_thr_state_table_size =
274 sizeof td_thr_state_table / sizeof (struct string_map);
275 int i;
276 static char buf[50];
278 for (i = 0; i < td_thr_state_table_size; i++)
279 if (td_thr_state_table[i].num == statecode)
280 return td_thr_state_table[i].str;
282 xsnprintf (buf, sizeof (buf), "Unknown libthread_db state code: %d",
283 statecode);
285 return buf;
289 /* Convert a POSIX or Solaris thread ID into a LWP ID. If THREAD_ID
290 doesn't exist, that's an error. If it's an inactive thread, return
291 DEFAULT_LWP.
293 NOTE: This function probably shouldn't call error(). */
295 static ptid_t
296 thread_to_lwp (ptid_t thread_id, int default_lwp)
298 td_thrinfo_t ti;
299 td_thrhandle_t th;
300 td_err_e val;
302 if (thread_id.lwp_p ())
303 return thread_id; /* It's already an LWP ID. */
305 /* It's a thread. Convert to LWP. */
307 val = p_td_ta_map_id2thr (main_ta, thread_id.tid (), &th);
308 if (val == TD_NOTHR)
309 return ptid_t (-1); /* Thread must have terminated. */
310 else if (val != TD_OK)
311 error (_("thread_to_lwp: td_ta_map_id2thr %s"), td_err_string (val));
313 val = p_td_thr_get_info (&th, &ti);
314 if (val == TD_NOTHR)
315 return ptid_t (-1); /* Thread must have terminated. */
316 else if (val != TD_OK)
317 error (_("thread_to_lwp: td_thr_get_info: %s"), td_err_string (val));
319 if (ti.ti_state != TD_THR_ACTIVE)
321 if (default_lwp != -1)
322 return ptid_t (default_lwp);
323 error (_("thread_to_lwp: thread state not active: %s"),
324 td_state_string (ti.ti_state));
327 return ptid_t (thread_id.pid (), ti.ti_lid, 0);
330 /* Convert an LWP ID into a POSIX or Solaris thread ID. If LWP_ID
331 doesn't exists, that's an error.
333 NOTE: This function probably shouldn't call error(). */
335 static ptid_t
336 lwp_to_thread (ptid_t lwp)
338 td_thrinfo_t ti;
339 td_thrhandle_t th;
340 td_err_e val;
342 if (lwp.tid_p ())
343 return lwp; /* It's already a thread ID. */
345 /* It's an LWP. Convert it to a thread ID. */
347 if (!target_thread_alive (lwp))
348 return ptid_t (-1); /* Must be a defunct LPW. */
350 val = p_td_ta_map_lwp2thr (main_ta, lwp.lwp (), &th);
351 if (val == TD_NOTHR)
352 return ptid_t (-1); /* Thread must have terminated. */
353 else if (val != TD_OK)
354 error (_("lwp_to_thread: td_ta_map_lwp2thr: %s."), td_err_string (val));
356 val = p_td_thr_validate (&th);
357 if (val == TD_NOTHR)
358 return lwp; /* Unknown to libthread; just return LPW, */
359 else if (val != TD_OK)
360 error (_("lwp_to_thread: td_thr_validate: %s."), td_err_string (val));
362 val = p_td_thr_get_info (&th, &ti);
363 if (val == TD_NOTHR)
364 return ptid_t (-1); /* Thread must have terminated. */
365 else if (val != TD_OK)
366 error (_("lwp_to_thread: td_thr_get_info: %s."), td_err_string (val));
368 return ptid_t (lwp.pid (), 0 , ti.ti_tid);
372 /* Most target vector functions from here on actually just pass
373 through to the layer beneath, as they don't need to do anything
374 specific for threads. */
376 /* Take a program previously attached to and detaches it. The program
377 resumes execution and will no longer stop on signals, etc. We'd
378 better not have left any breakpoints in the program or it'll die
379 when it hits one. For this to work, it may be necessary for the
380 process to have been previously attached. It *might* work if the
381 program was started via the normal ptrace (PTRACE_TRACEME). */
383 void
384 sol_thread_target::detach (inferior *inf, int from_tty)
386 target_ops *beneath = this->beneath ();
388 sol_thread_active = 0;
389 inferior_ptid = ptid_t (main_ph.ptid.pid ());
390 inf->unpush_target (this);
391 beneath->detach (inf, from_tty);
394 /* Resume execution of process PTID. If STEP is nonzero, then just
395 single step it. If SIGNAL is nonzero, restart it with that signal
396 activated. We may have to convert PTID from a thread ID to an LWP
397 ID for procfs. */
399 void
400 sol_thread_target::resume (ptid_t ptid, int step, enum gdb_signal signo)
402 scoped_restore save_inferior_ptid = make_scoped_restore (&inferior_ptid);
404 inferior_ptid = thread_to_lwp (inferior_ptid, main_ph.ptid.pid ());
405 if (inferior_ptid.pid () == -1)
406 inferior_ptid = procfs_first_available ();
408 if (ptid.pid () != -1)
410 ptid_t save_ptid = ptid;
412 ptid = thread_to_lwp (ptid, -2);
413 if (ptid.pid () == -2) /* Inactive thread. */
414 error (_("This version of Solaris can't start inactive threads."));
415 if (info_verbose && ptid.pid () == -1)
416 warning (_("Specified thread %s seems to have terminated"),
417 pulongest (save_ptid.tid ()));
420 beneath ()->resume (ptid, step, signo);
423 /* Wait for any threads to stop. We may have to convert PTID from a
424 thread ID to an LWP ID, and vice versa on the way out. */
426 ptid_t
427 sol_thread_target::wait (ptid_t ptid, struct target_waitstatus *ourstatus,
428 target_wait_flags options)
430 if (ptid.pid () != -1)
432 ptid_t ptid_for_warning = ptid;
434 ptid = thread_to_lwp (ptid, -2);
435 if (ptid.pid () == -2) /* Inactive thread. */
436 error (_("This version of Solaris can't start inactive threads."));
437 if (info_verbose && ptid.pid () == -1)
438 warning (_("Specified thread %s seems to have terminated"),
439 pulongest (ptid_for_warning.tid ()));
442 ptid_t rtnval = beneath ()->wait (ptid, ourstatus, options);
444 if (ourstatus->kind () != TARGET_WAITKIND_EXITED)
446 /* Map the LWP of interest back to the appropriate thread ID. */
447 ptid_t thr_ptid = lwp_to_thread (rtnval);
448 if (thr_ptid.pid () != -1)
449 rtnval = thr_ptid;
451 /* See if we have a new thread. */
452 if (rtnval.tid_p ())
454 thread_info *thr = current_inferior ()->find_thread (rtnval);
455 if (thr == NULL || thr->state == THREAD_EXITED)
457 process_stratum_target *proc_target
458 = current_inferior ()->process_target ();
459 add_thread (proc_target, rtnval);
464 /* During process initialization, we may get here without the thread
465 package being initialized, since that can only happen after we've
466 found the shared libs. */
468 return rtnval;
471 void
472 sol_thread_target::fetch_registers (struct regcache *regcache, int regnum)
474 thread_t thread;
475 td_thrhandle_t thandle;
476 td_err_e val;
477 prgregset_t gregset;
478 prfpregset_t fpregset;
479 gdb_gregset_t *gregset_p = &gregset;
480 gdb_fpregset_t *fpregset_p = &fpregset;
481 ptid_t ptid = regcache->ptid ();
483 if (!ptid.tid_p ())
485 /* It's an LWP; pass the request on to the layer beneath. */
486 beneath ()->fetch_registers (regcache, regnum);
487 return;
490 /* Solaris thread: convert PTID into a td_thrhandle_t. */
491 thread = ptid.tid ();
492 if (thread == 0)
493 error (_("sol_thread_fetch_registers: thread == 0"));
495 val = p_td_ta_map_id2thr (main_ta, thread, &thandle);
496 if (val != TD_OK)
497 error (_("sol_thread_fetch_registers: td_ta_map_id2thr: %s"),
498 td_err_string (val));
500 /* Get the general-purpose registers. */
502 val = p_td_thr_getgregs (&thandle, gregset);
503 if (val != TD_OK && val != TD_PARTIALREG)
504 error (_("sol_thread_fetch_registers: td_thr_getgregs %s"),
505 td_err_string (val));
507 /* For SPARC, TD_PARTIALREG means that only %i0...%i7, %l0..%l7, %pc
508 and %sp are saved (by a thread context switch). */
510 /* And, now the floating-point registers. */
512 val = p_td_thr_getfpregs (&thandle, &fpregset);
513 if (val != TD_OK && val != TD_NOFPREGS)
514 error (_("sol_thread_fetch_registers: td_thr_getfpregs %s"),
515 td_err_string (val));
517 /* Note that we must call supply_gregset and supply_fpregset *after*
518 calling the td routines because the td routines call ps_lget*
519 which affect the values stored in the registers array. */
521 supply_gregset (regcache, (const gdb_gregset_t *) gregset_p);
522 supply_fpregset (regcache, (const gdb_fpregset_t *) fpregset_p);
525 void
526 sol_thread_target::store_registers (struct regcache *regcache, int regnum)
528 thread_t thread;
529 td_thrhandle_t thandle;
530 td_err_e val;
531 prgregset_t gregset;
532 prfpregset_t fpregset;
533 ptid_t ptid = regcache->ptid ();
535 if (!ptid.tid_p ())
537 /* It's an LWP; pass the request on to the layer beneath. */
538 beneath ()->store_registers (regcache, regnum);
539 return;
542 /* Solaris thread: convert PTID into a td_thrhandle_t. */
543 thread = ptid.tid ();
545 val = p_td_ta_map_id2thr (main_ta, thread, &thandle);
546 if (val != TD_OK)
547 error (_("sol_thread_store_registers: td_ta_map_id2thr %s"),
548 td_err_string (val));
550 if (regnum != -1)
552 val = p_td_thr_getgregs (&thandle, gregset);
553 if (val != TD_OK)
554 error (_("sol_thread_store_registers: td_thr_getgregs %s"),
555 td_err_string (val));
556 val = p_td_thr_getfpregs (&thandle, &fpregset);
557 if (val != TD_OK)
558 error (_("sol_thread_store_registers: td_thr_getfpregs %s"),
559 td_err_string (val));
562 fill_gregset (regcache, (gdb_gregset_t *) &gregset, regnum);
563 fill_fpregset (regcache, (gdb_fpregset_t *) &fpregset, regnum);
565 val = p_td_thr_setgregs (&thandle, gregset);
566 if (val != TD_OK)
567 error (_("sol_thread_store_registers: td_thr_setgregs %s"),
568 td_err_string (val));
569 val = p_td_thr_setfpregs (&thandle, &fpregset);
570 if (val != TD_OK)
571 error (_("sol_thread_store_registers: td_thr_setfpregs %s"),
572 td_err_string (val));
575 /* Perform partial transfers on OBJECT. See target_read_partial and
576 target_write_partial for details of each variant. One, and only
577 one, of readbuf or writebuf must be non-NULL. */
579 enum target_xfer_status
580 sol_thread_target::xfer_partial (enum target_object object,
581 const char *annex, gdb_byte *readbuf,
582 const gdb_byte *writebuf,
583 ULONGEST offset, ULONGEST len,
584 ULONGEST *xfered_len)
586 scoped_restore save_inferior_ptid = make_scoped_restore (&inferior_ptid);
588 if (inferior_ptid.tid_p () || !target_thread_alive (inferior_ptid))
590 /* It's either a thread or an LWP that isn't alive. Any live
591 LWP will do so use the first available.
593 NOTE: We don't need to call switch_to_thread; we're just
594 reading memory. */
595 inferior_ptid = procfs_first_available ();
598 return beneath ()->xfer_partial (object, annex, readbuf,
599 writebuf, offset, len, xfered_len);
602 static void
603 check_for_thread_db (void)
605 td_err_e err;
606 ptid_t ptid;
608 /* Don't attempt to use thread_db for remote targets. */
609 if (!(target_can_run () || core_bfd))
610 return;
612 /* Do nothing if we couldn't load libthread_db.so.1. */
613 if (p_td_ta_new == NULL)
614 return;
616 if (sol_thread_active)
617 /* Nothing to do. The thread library was already detected and the
618 target vector was already activated. */
619 return;
621 /* Now, initialize libthread_db. This needs to be done after the
622 shared libraries are located because it needs information from
623 the user's thread library. */
625 err = p_td_init ();
626 if (err != TD_OK)
628 warning (_("sol_thread_new_objfile: td_init: %s"), td_err_string (err));
629 return;
632 /* Now attempt to open a connection to the thread library. */
633 err = p_td_ta_new (&main_ph, &main_ta);
634 switch (err)
636 case TD_NOLIBTHREAD:
637 /* No thread library was detected. */
638 break;
640 case TD_OK:
641 gdb_printf (_("[Thread debugging using libthread_db enabled]\n"));
643 /* The thread library was detected. Activate the sol_thread target. */
644 current_inferior ()->push_target (&sol_thread_ops);
645 sol_thread_active = 1;
647 main_ph.ptid = inferior_ptid; /* Save for xfer_memory. */
648 ptid = lwp_to_thread (inferior_ptid);
649 if (ptid.pid () != -1)
650 inferior_ptid = ptid;
652 target_update_thread_list ();
653 break;
655 default:
656 warning (_("Cannot initialize thread debugging library: %s"),
657 td_err_string (err));
658 break;
662 /* This routine is called whenever a new symbol table is read in, or
663 when all symbol tables are removed. libthread_db can only be
664 initialized when it finds the right variables in libthread.so.
665 Since it's a shared library, those variables don't show up until
666 the library gets mapped and the symbol table is read in. */
668 static void
669 sol_thread_new_objfile (struct objfile *objfile)
671 check_for_thread_db ();
674 /* Clean up after the inferior dies. */
676 void
677 sol_thread_target::mourn_inferior ()
679 target_ops *beneath = this->beneath ();
681 sol_thread_active = 0;
683 current_inferior ()->unpush_target (this);
685 beneath->mourn_inferior ();
688 /* Return true if PTID is still active in the inferior. */
690 bool
691 sol_thread_target::thread_alive (ptid_t ptid)
693 if (ptid.tid_p ())
695 /* It's a (user-level) thread. */
696 td_err_e val;
697 td_thrhandle_t th;
698 int pid;
700 pid = ptid.tid ();
701 val = p_td_ta_map_id2thr (main_ta, pid, &th);
702 if (val != TD_OK)
703 return false; /* Thread not found. */
704 val = p_td_thr_validate (&th);
705 if (val != TD_OK)
706 return false; /* Thread not valid. */
707 return true; /* Known thread. */
709 else
711 /* It's an LPW; pass the request on to the layer below. */
712 return beneath ()->thread_alive (ptid);
717 /* These routines implement the lower half of the thread_db interface,
718 i.e. the ps_* routines. */
720 /* The next four routines are called by libthread_db to tell us to
721 stop and stop a particular process or lwp. Since GDB ensures that
722 these are all stopped by the time we call anything in thread_db,
723 these routines need to do nothing. */
725 /* Process stop. */
727 ps_err_e
728 ps_pstop (struct ps_prochandle *ph)
730 return PS_OK;
733 /* Process continue. */
735 ps_err_e
736 ps_pcontinue (struct ps_prochandle *ph)
738 return PS_OK;
741 /* LWP stop. */
743 ps_err_e
744 ps_lstop (struct ps_prochandle *ph, lwpid_t lwpid)
746 return PS_OK;
749 /* LWP continue. */
751 ps_err_e
752 ps_lcontinue (struct ps_prochandle *ph, lwpid_t lwpid)
754 return PS_OK;
757 /* Looks up the symbol LD_SYMBOL_NAME in the debugger's symbol table. */
759 ps_err_e
760 ps_pglobal_lookup (struct ps_prochandle *ph, const char *ld_object_name,
761 const char *ld_symbol_name, psaddr_t *ld_symbol_addr)
763 struct bound_minimal_symbol ms;
765 ms = lookup_minimal_symbol (ld_symbol_name, NULL, NULL);
766 if (!ms.minsym)
767 return PS_NOSYM;
769 *ld_symbol_addr = ms.value_address ();
770 return PS_OK;
773 /* Common routine for reading and writing memory. */
775 static ps_err_e
776 rw_common (int dowrite, const struct ps_prochandle *ph, psaddr_t addr,
777 gdb_byte *buf, int size)
779 int ret;
781 scoped_restore save_inferior_ptid = make_scoped_restore (&inferior_ptid);
783 if (inferior_ptid.tid_p () || !target_thread_alive (inferior_ptid))
785 /* It's either a thread or an LWP that isn't alive. Any live
786 LWP will do so use the first available.
788 NOTE: We don't need to call switch_to_thread; we're just
789 reading memory. */
790 inferior_ptid = procfs_first_available ();
793 #if defined (__sparcv9)
794 /* For Sparc64 cross Sparc32, make sure the address has not been
795 accidentally sign-extended (or whatever) to beyond 32 bits. */
796 if (bfd_get_arch_size (current_program_space->exec_bfd ()) == 32)
797 addr &= 0xffffffff;
798 #endif
800 if (dowrite)
801 ret = target_write_memory (addr, (gdb_byte *) buf, size);
802 else
803 ret = target_read_memory (addr, (gdb_byte *) buf, size);
805 return (ret == 0 ? PS_OK : PS_ERR);
808 /* Copies SIZE bytes from target process .data segment to debugger memory. */
810 ps_err_e
811 ps_pdread (struct ps_prochandle *ph, psaddr_t addr, void *buf, size_t size)
813 return rw_common (0, ph, addr, (gdb_byte *) buf, size);
816 /* Copies SIZE bytes from debugger memory .data segment to target process. */
818 ps_err_e
819 ps_pdwrite (struct ps_prochandle *ph, psaddr_t addr,
820 const void *buf, size_t size)
822 return rw_common (1, ph, addr, (gdb_byte *) buf, size);
825 /* Copies SIZE bytes from target process .text segment to debugger memory. */
827 ps_err_e
828 ps_ptread (struct ps_prochandle *ph, psaddr_t addr, void *buf, size_t size)
830 return rw_common (0, ph, addr, (gdb_byte *) buf, size);
833 /* Copies SIZE bytes from debugger memory .text segment to target process. */
835 ps_err_e
836 ps_ptwrite (struct ps_prochandle *ph, psaddr_t addr,
837 const void *buf, size_t size)
839 return rw_common (1, ph, addr, (gdb_byte *) buf, size);
842 /* Get general-purpose registers for LWP. */
844 ps_err_e
845 ps_lgetregs (struct ps_prochandle *ph, lwpid_t lwpid, prgregset_t gregset)
847 ptid_t ptid = ptid_t (current_inferior ()->pid, lwpid, 0);
848 regcache *regcache = get_thread_arch_regcache (current_inferior (), ptid,
849 current_inferior ()->arch ());
851 target_fetch_registers (regcache, -1);
852 fill_gregset (regcache, (gdb_gregset_t *) gregset, -1);
854 return PS_OK;
857 /* Set general-purpose registers for LWP. */
859 ps_err_e
860 ps_lsetregs (struct ps_prochandle *ph, lwpid_t lwpid,
861 const prgregset_t gregset)
863 ptid_t ptid = ptid_t (current_inferior ()->pid, lwpid, 0);
864 regcache *regcache = get_thread_arch_regcache (current_inferior (), ptid,
865 current_inferior ()->arch ());
867 supply_gregset (regcache, (const gdb_gregset_t *) gregset);
868 target_store_registers (regcache, -1);
870 return PS_OK;
873 /* Log a message (sends to gdb_stderr). */
875 void
876 ps_plog (const char *fmt, ...)
878 va_list args;
880 va_start (args, fmt);
882 gdb_vprintf (gdb_stderr, fmt, args);
885 /* Get size of extra register set. Currently a noop. */
887 ps_err_e
888 ps_lgetxregsize (struct ps_prochandle *ph, lwpid_t lwpid, int *xregsize)
890 return PS_OK;
893 /* Get extra register set. Currently a noop. */
895 ps_err_e
896 ps_lgetxregs (struct ps_prochandle *ph, lwpid_t lwpid, caddr_t xregset)
898 return PS_OK;
901 /* Set extra register set. Currently a noop. */
903 ps_err_e
904 ps_lsetxregs (struct ps_prochandle *ph, lwpid_t lwpid, caddr_t xregset)
906 return PS_OK;
909 /* Get floating-point registers for LWP. */
911 ps_err_e
912 ps_lgetfpregs (struct ps_prochandle *ph, lwpid_t lwpid,
913 prfpregset_t *fpregset)
915 ptid_t ptid = ptid_t (current_inferior ()->pid, lwpid, 0);
916 regcache *regcache = get_thread_arch_regcache (current_inferior (), ptid,
917 current_inferior ()->arch ());
919 target_fetch_registers (regcache, -1);
920 fill_fpregset (regcache, (gdb_fpregset_t *) fpregset, -1);
922 return PS_OK;
925 /* Set floating-point regs for LWP. */
927 ps_err_e
928 ps_lsetfpregs (struct ps_prochandle *ph, lwpid_t lwpid,
929 const prfpregset_t * fpregset)
931 ptid_t ptid = ptid_t (current_inferior ()->pid, lwpid, 0);
932 regcache *regcache = get_thread_arch_regcache (current_inferior (), ptid,
933 current_inferior ()->arch ());
935 supply_fpregset (regcache, (const gdb_fpregset_t *) fpregset);
936 target_store_registers (regcache, -1);
938 return PS_OK;
941 /* Identify process as 32-bit or 64-bit. At the moment we're using
942 BFD to do this. There might be a more Solaris-specific
943 (e.g. procfs) method, but this ought to work. */
945 ps_err_e
946 ps_pdmodel (struct ps_prochandle *ph, int *data_model)
948 if (current_program_space->exec_bfd () == 0)
949 *data_model = PR_MODEL_UNKNOWN;
950 else if (bfd_get_arch_size (current_program_space->exec_bfd ()) == 32)
951 *data_model = PR_MODEL_ILP32;
952 else
953 *data_model = PR_MODEL_LP64;
955 return PS_OK;
959 /* Convert PTID to printable form. */
961 std::string
962 sol_thread_target::pid_to_str (ptid_t ptid)
964 if (ptid.tid_p ())
966 ptid_t lwp;
968 lwp = thread_to_lwp (ptid, -2);
970 if (lwp.pid () == -1)
971 return string_printf ("Thread %s (defunct)",
972 pulongest (ptid.tid ()));
973 else if (lwp.pid () != -2)
974 return string_printf ("Thread %s (LWP %ld)",
975 pulongest (ptid.tid ()), lwp.lwp ());
976 else
977 return string_printf ("Thread %s ",
978 pulongest (ptid.tid ()));
980 else if (ptid.lwp () != 0)
981 return string_printf ("LWP %ld ", ptid.lwp ());
982 else
983 return string_printf ("process %d ", ptid.pid ());
987 /* Worker bee for update_thread_list. Callback function that gets
988 called once per user-level thread (i.e. not for LWP's). */
990 static int
991 sol_update_thread_list_callback (const td_thrhandle_t *th, void *ignored)
993 td_err_e retval;
994 td_thrinfo_t ti;
996 retval = p_td_thr_get_info (th, &ti);
997 if (retval != TD_OK)
998 return -1;
1000 ptid_t ptid = ptid_t (current_inferior ()->pid, 0, ti.ti_tid);
1001 thread_info *thr = current_inferior ()->find_thread (ptid);
1002 if (thr == NULL || thr->state == THREAD_EXITED)
1004 process_stratum_target *proc_target
1005 = current_inferior ()->process_target ();
1006 add_thread (proc_target, ptid);
1009 return 0;
1012 void
1013 sol_thread_target::update_thread_list ()
1015 /* Delete dead threads. */
1016 prune_threads ();
1018 /* Find any new LWP's. */
1019 beneath ()->update_thread_list ();
1021 /* Then find any new user-level threads. */
1022 p_td_ta_thr_iter (main_ta, sol_update_thread_list_callback, (void *) 0,
1023 TD_THR_ANY_STATE, TD_THR_LOWEST_PRIORITY,
1024 TD_SIGNO_MASK, TD_THR_ANY_USER_FLAGS);
1027 /* Worker bee for the "info sol-thread" command. This is a callback
1028 function that gets called once for each Solaris user-level thread
1029 (i.e. not for LWPs) in the inferior. Print anything interesting
1030 that we can think of. */
1032 static int
1033 info_cb (const td_thrhandle_t *th, void *s)
1035 td_err_e ret;
1036 td_thrinfo_t ti;
1038 ret = p_td_thr_get_info (th, &ti);
1039 if (ret == TD_OK)
1041 gdb_printf ("%s thread #%d, lwp %d, ",
1042 ti.ti_type == TD_THR_SYSTEM ? "system" : "user ",
1043 ti.ti_tid, ti.ti_lid);
1044 switch (ti.ti_state)
1046 default:
1047 case TD_THR_UNKNOWN:
1048 gdb_printf ("<unknown state>");
1049 break;
1050 case TD_THR_STOPPED:
1051 gdb_printf ("(stopped)");
1052 break;
1053 case TD_THR_RUN:
1054 gdb_printf ("(run) ");
1055 break;
1056 case TD_THR_ACTIVE:
1057 gdb_printf ("(active) ");
1058 break;
1059 case TD_THR_ZOMBIE:
1060 gdb_printf ("(zombie) ");
1061 break;
1062 case TD_THR_SLEEP:
1063 gdb_printf ("(asleep) ");
1064 break;
1065 case TD_THR_STOPPED_ASLEEP:
1066 gdb_printf ("(stopped asleep)");
1067 break;
1069 /* Print thr_create start function. */
1070 if (ti.ti_startfunc != 0)
1072 const struct bound_minimal_symbol msym
1073 = lookup_minimal_symbol_by_pc (ti.ti_startfunc);
1075 gdb_printf (" startfunc=%s",
1076 msym.minsym
1077 ? msym.minsym->print_name ()
1078 : paddress (current_inferior ()->arch (),
1079 ti.ti_startfunc));
1082 /* If thread is asleep, print function that went to sleep. */
1083 if (ti.ti_state == TD_THR_SLEEP)
1085 const struct bound_minimal_symbol msym
1086 = lookup_minimal_symbol_by_pc (ti.ti_pc);
1088 gdb_printf (" sleepfunc=%s",
1089 msym.minsym
1090 ? msym.minsym->print_name ()
1091 : paddress (current_inferior ()->arch (), ti.ti_pc));
1094 gdb_printf ("\n");
1096 else
1097 warning (_("info sol-thread: failed to get info for thread."));
1099 return 0;
1102 /* List some state about each Solaris user-level thread in the
1103 inferior. */
1105 static void
1106 info_solthreads (const char *args, int from_tty)
1108 p_td_ta_thr_iter (main_ta, info_cb, (void *) args,
1109 TD_THR_ANY_STATE, TD_THR_LOWEST_PRIORITY,
1110 TD_SIGNO_MASK, TD_THR_ANY_USER_FLAGS);
1113 /* Callback routine used to find a thread based on the TID part of
1114 its PTID. */
1116 static int
1117 thread_db_find_thread_from_tid (struct thread_info *thread, void *data)
1119 ULONGEST *tid = (ULONGEST *) data;
1121 if (thread->ptid.tid () == *tid)
1122 return 1;
1124 return 0;
1127 ptid_t
1128 sol_thread_target::get_ada_task_ptid (long lwp, ULONGEST thread)
1130 struct thread_info *thread_info =
1131 iterate_over_threads (thread_db_find_thread_from_tid, &thread);
1133 if (thread_info == NULL)
1135 /* The list of threads is probably not up to date. Find any
1136 thread that is missing from the list, and try again. */
1137 update_thread_list ();
1138 thread_info = iterate_over_threads (thread_db_find_thread_from_tid,
1139 &thread);
1142 gdb_assert (thread_info != NULL);
1144 return (thread_info->ptid);
1147 void _initialize_sol_thread ();
1148 void
1149 _initialize_sol_thread ()
1151 void *dlhandle;
1153 dlhandle = dlopen ("libthread_db.so.1", RTLD_NOW);
1154 if (!dlhandle)
1155 goto die;
1157 #define resolve(X) \
1158 if (!(p_##X = (X ## _ftype *) dlsym (dlhandle, #X))) \
1159 goto die;
1161 resolve (td_log);
1162 resolve (td_ta_new);
1163 resolve (td_ta_delete);
1164 resolve (td_init);
1165 resolve (td_ta_get_ph);
1166 resolve (td_ta_get_nthreads);
1167 resolve (td_ta_tsd_iter);
1168 resolve (td_ta_thr_iter);
1169 resolve (td_thr_validate);
1170 resolve (td_thr_tsd);
1171 resolve (td_thr_get_info);
1172 resolve (td_thr_getfpregs);
1173 resolve (td_thr_getxregsize);
1174 resolve (td_thr_getxregs);
1175 resolve (td_thr_sigsetmask);
1176 resolve (td_thr_setprio);
1177 resolve (td_thr_setsigpending);
1178 resolve (td_thr_setfpregs);
1179 resolve (td_thr_setxregs);
1180 resolve (td_ta_map_id2thr);
1181 resolve (td_ta_map_lwp2thr);
1182 resolve (td_thr_getgregs);
1183 resolve (td_thr_setgregs);
1185 add_cmd ("sol-threads", class_maintenance, info_solthreads,
1186 _("Show info on Solaris user threads."), &maintenanceinfolist);
1188 /* Hook into new_objfile notification. */
1189 gdb::observers::new_objfile.attach (sol_thread_new_objfile, "sol-thread");
1190 return;
1192 die:
1193 gdb_printf (gdb_stderr, "\
1194 [GDB will not be able to debug user-mode threads: %s]\n", dlerror ());
1196 if (dlhandle)
1197 dlclose (dlhandle);
1199 return;