1 /* Low level interface for debugging Solaris threads for GDB, the GNU debugger.
2 Copyright 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003
3 Free Software Foundation, Inc.
5 This file is part of GDB.
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2 of the License, or
10 (at your option) any later version.
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with this program; if not, write to the Free Software
19 Foundation, Inc., 59 Temple Place - Suite 330,
20 Boston, MA 02111-1307, USA. */
22 /* This module implements a sort of half target that sits between the
23 machine-independent parts of GDB and the /proc interface (procfs.c) to
24 provide access to the Solaris user-mode thread implementation.
26 Solaris threads are true user-mode threads, which are invoked via the thr_*
27 and pthread_* (native and Posix respectivly) interfaces. These are mostly
28 implemented in user-space, with all thread context kept in various
29 structures that live in the user's heap. These should not be confused with
30 lightweight processes (LWPs), which are implemented by the kernel, and
31 scheduled without explicit intervention by the process.
33 Just to confuse things a little, Solaris threads (both native and Posix) are
34 actually implemented using LWPs. In general, there are going to be more
35 threads than LWPs. There is no fixed correspondence between a thread and an
36 LWP. When a thread wants to run, it gets scheduled onto the first available
37 LWP and can 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 called
41 libthread_db.so.1 (not to be confused with libthread_db.so.0, which doesn't
42 have a published interface). This interface has an upper part, which it
43 provides, and a lower part which I provide. The upper part consists of the
44 td_* routines, which allow me to find all the threads, query their state,
45 etc... The lower part consists of all of the ps_*, which are used by the
46 td_* routines to read/write memory, manipulate LWPs, lookup symbols, etc...
47 The ps_* routines actually do most of their work by calling functions in
52 #include <proc_service.h>
53 #include <thread_db.h>
54 #include "gdbthread.h"
65 extern struct target_ops sol_thread_ops; /* Forward declaration */
66 extern struct target_ops sol_core_ops; /* Forward declaration */
68 /* place to store core_ops before we overwrite it */
69 static struct target_ops orig_core_ops;
71 struct target_ops sol_thread_ops;
72 struct target_ops sol_core_ops;
74 extern int procfs_suppress_run;
75 extern struct target_ops procfs_ops; /* target vector for procfs.c */
76 extern struct target_ops core_ops; /* target vector for corelow.c */
77 extern char *procfs_pid_to_str (ptid_t ptid);
79 /* Prototypes for supply_gregset etc. */
82 /* This struct is defined by us, but mainly used for the proc_service interface.
83 We don't have much use for it, except as a handy place to get a real pid
84 for memory accesses. */
97 static struct ps_prochandle main_ph;
98 static td_thragent_t *main_ta;
99 static int sol_thread_active = 0;
101 static char *td_err_string (td_err_e errcode);
102 static char *td_state_string (td_thr_state_e statecode);
103 static ptid_t thread_to_lwp (ptid_t thread_id, int default_lwp);
104 static void sol_thread_resume (ptid_t ptid, int step, enum target_signal signo);
105 static ptid_t lwp_to_thread (ptid_t lwp);
106 static int sol_thread_alive (ptid_t ptid);
107 static void sol_core_close (int quitting);
109 static void init_sol_thread_ops (void);
110 static void init_sol_core_ops (void);
112 /* Default definitions: These must be defined in tm.h
113 if they are to be shared with a process module such as procfs. */
115 #define GET_PID(ptid) ptid_get_pid (ptid)
116 #define GET_LWP(ptid) ptid_get_lwp (ptid)
117 #define GET_THREAD(ptid) ptid_get_tid (ptid)
119 #define is_lwp(ptid) (GET_LWP (ptid) != 0)
120 #define is_thread(ptid) (GET_THREAD (ptid) != 0)
122 #define BUILD_LWP(lwp, pid) ptid_build (pid, lwp, 0)
123 #define BUILD_THREAD(tid, pid) ptid_build (pid, 0, tid)
125 /* Pointers to routines from lithread_db resolved by dlopen() */
127 static void (*p_td_log) (const int on_off);
128 static td_err_e (*p_td_ta_new) (const struct ps_prochandle * ph_p,
129 td_thragent_t ** ta_pp);
130 static td_err_e (*p_td_ta_delete) (td_thragent_t * ta_p);
131 static td_err_e (*p_td_init) (void);
132 static td_err_e (*p_td_ta_get_ph) (const td_thragent_t * ta_p,
133 struct ps_prochandle ** ph_pp);
134 static td_err_e (*p_td_ta_get_nthreads) (const td_thragent_t * ta_p,
136 static td_err_e (*p_td_ta_tsd_iter) (const td_thragent_t * ta_p,
139 static td_err_e (*p_td_ta_thr_iter) (const td_thragent_t * ta_p,
142 td_thr_state_e state,
144 sigset_t * ti_sigmask_p,
145 unsigned ti_user_flags);
146 static td_err_e (*p_td_thr_validate) (const td_thrhandle_t * th_p);
147 static td_err_e (*p_td_thr_tsd) (const td_thrhandle_t * th_p,
148 const thread_key_t key,
150 static td_err_e (*p_td_thr_get_info) (const td_thrhandle_t * th_p,
151 td_thrinfo_t * ti_p);
152 static td_err_e (*p_td_thr_getfpregs) (const td_thrhandle_t * th_p,
153 prfpregset_t * fpregset);
154 static td_err_e (*p_td_thr_getxregsize) (const td_thrhandle_t * th_p,
156 static td_err_e (*p_td_thr_getxregs) (const td_thrhandle_t * th_p,
157 const caddr_t xregset);
158 static td_err_e (*p_td_thr_sigsetmask) (const td_thrhandle_t * th_p,
159 const sigset_t ti_sigmask);
160 static td_err_e (*p_td_thr_setprio) (const td_thrhandle_t * th_p,
162 static td_err_e (*p_td_thr_setsigpending) (const td_thrhandle_t * th_p,
163 const uchar_t ti_pending_flag,
164 const sigset_t ti_pending);
165 static td_err_e (*p_td_thr_setfpregs) (const td_thrhandle_t * th_p,
166 const prfpregset_t * fpregset);
167 static td_err_e (*p_td_thr_setxregs) (const td_thrhandle_t * th_p,
168 const caddr_t xregset);
169 static td_err_e (*p_td_ta_map_id2thr) (const td_thragent_t * ta_p,
171 td_thrhandle_t * th_p);
172 static td_err_e (*p_td_ta_map_lwp2thr) (const td_thragent_t * ta_p,
174 td_thrhandle_t * th_p);
175 static td_err_e (*p_td_thr_getgregs) (const td_thrhandle_t * th_p,
177 static td_err_e (*p_td_thr_setgregs) (const td_thrhandle_t * th_p,
178 const prgregset_t regset);
184 td_err_string - Convert a thread_db error code to a string
188 char * td_err_string (errcode)
192 Return the thread_db error string associated with errcode. If errcode
193 is unknown, then return a message.
198 td_err_string (td_err_e errcode)
200 static struct string_map
203 {TD_OK, "generic \"call succeeded\""},
204 {TD_ERR, "generic error."},
205 {TD_NOTHR, "no thread can be found to satisfy query"},
206 {TD_NOSV, "no synch. variable can be found to satisfy query"},
207 {TD_NOLWP, "no lwp can be found to satisfy query"},
208 {TD_BADPH, "invalid process handle"},
209 {TD_BADTH, "invalid thread handle"},
210 {TD_BADSH, "invalid synchronization handle"},
211 {TD_BADTA, "invalid thread agent"},
212 {TD_BADKEY, "invalid key"},
213 {TD_NOMSG, "td_thr_event_getmsg() called when there was no message"},
214 {TD_NOFPREGS, "FPU register set not available for given thread"},
215 {TD_NOLIBTHREAD, "application not linked with libthread"},
216 {TD_NOEVENT, "requested event is not supported"},
217 {TD_NOCAPAB, "capability not available"},
218 {TD_DBERR, "Debugger service failed"},
219 {TD_NOAPLIC, "Operation not applicable to"},
220 {TD_NOTSD, "No thread specific data for this thread"},
221 {TD_MALLOC, "Malloc failed"},
222 {TD_PARTIALREG, "Only part of register set was written/read"},
223 {TD_NOXREGS, "X register set not available for given thread"}
225 const int td_err_size = sizeof td_err_table / sizeof (struct string_map);
229 for (i = 0; i < td_err_size; i++)
230 if (td_err_table[i].num == errcode)
231 return td_err_table[i].str;
233 sprintf (buf, "Unknown thread_db error code: %d", errcode);
242 td_state_string - Convert a thread_db state code to a string
246 char * td_state_string (statecode)
250 Return the thread_db state string associated with statecode. If
251 statecode is unknown, then return a message.
256 td_state_string (td_thr_state_e statecode)
258 static struct string_map
259 td_thr_state_table[] =
261 {TD_THR_ANY_STATE, "any state"},
262 {TD_THR_UNKNOWN, "unknown"},
263 {TD_THR_STOPPED, "stopped"},
265 {TD_THR_ACTIVE, "active"},
266 {TD_THR_ZOMBIE, "zombie"},
267 {TD_THR_SLEEP, "sleep"},
268 {TD_THR_STOPPED_ASLEEP, "stopped asleep"}
270 const int td_thr_state_table_size = sizeof td_thr_state_table / sizeof (struct string_map);
274 for (i = 0; i < td_thr_state_table_size; i++)
275 if (td_thr_state_table[i].num == statecode)
276 return td_thr_state_table[i].str;
278 sprintf (buf, "Unknown thread_db state code: %d", statecode);
287 thread_to_lwp - Convert a Posix or Solaris thread id to a LWP id.
291 tpid_t thread_to_lwp (thread_id, default_lwp)
295 This function converts a Posix or Solaris thread id to a lightweight
296 process id. If thread_id is non-existent, that's an error. If it's
297 an inactive thread, then we return default_lwp.
301 This function probably shouldn't call error()...
306 thread_to_lwp (ptid_t thread_id, int default_lwp)
312 if (is_lwp (thread_id))
313 return thread_id; /* It's already an LWP id */
315 /* It's a thread. Convert to lwp */
317 val = p_td_ta_map_id2thr (main_ta, GET_THREAD (thread_id), &th);
319 return pid_to_ptid (-1); /* thread must have terminated */
320 else if (val != TD_OK)
321 error ("thread_to_lwp: td_ta_map_id2thr %s", td_err_string (val));
323 val = p_td_thr_get_info (&th, &ti);
325 return pid_to_ptid (-1); /* thread must have terminated */
326 else if (val != TD_OK)
327 error ("thread_to_lwp: td_thr_get_info: %s", td_err_string (val));
329 if (ti.ti_state != TD_THR_ACTIVE)
331 if (default_lwp != -1)
332 return pid_to_ptid (default_lwp);
333 error ("thread_to_lwp: thread state not active: %s",
334 td_state_string (ti.ti_state));
337 return BUILD_LWP (ti.ti_lid, PIDGET (thread_id));
344 lwp_to_thread - Convert a LWP id to a Posix or Solaris thread id.
348 int lwp_to_thread (lwp_id)
352 This function converts a lightweight process id to a Posix or Solaris
353 thread id. If thread_id is non-existent, that's an error.
357 This function probably shouldn't call error()...
362 lwp_to_thread (ptid_t lwp)
369 return lwp; /* It's already a thread id */
371 /* It's an lwp. Convert it to a thread id. */
373 if (!sol_thread_alive (lwp))
374 return pid_to_ptid (-1); /* defunct lwp */
376 val = p_td_ta_map_lwp2thr (main_ta, GET_LWP (lwp), &th);
378 return pid_to_ptid (-1); /* thread must have terminated */
379 else if (val != TD_OK)
380 error ("lwp_to_thread: td_ta_map_lwp2thr: %s.", td_err_string (val));
382 val = p_td_thr_validate (&th);
384 return lwp; /* libthread doesn't know about it;
386 else if (val != TD_OK)
387 error ("lwp_to_thread: td_thr_validate: %s.", td_err_string (val));
389 val = p_td_thr_get_info (&th, &ti);
391 return pid_to_ptid (-1); /* thread must have terminated */
392 else if (val != TD_OK)
393 error ("lwp_to_thread: td_thr_get_info: %s.", td_err_string (val));
395 return BUILD_THREAD (ti.ti_tid, PIDGET (lwp));
399 /* Most target vector functions from here on actually just pass through to
400 procfs.c, as they don't need to do anything specific for threads. */
405 sol_thread_open (char *arg, int from_tty)
407 procfs_ops.to_open (arg, from_tty);
410 /* Attach to process PID, then initialize for debugging it
411 and wait for the trace-trap that results from attaching. */
414 sol_thread_attach (char *args, int from_tty)
416 procfs_ops.to_attach (args, from_tty);
418 /* Must get symbols from solibs before libthread_db can run! */
419 SOLIB_ADD ((char *) 0, from_tty, (struct target_ops *) 0, auto_solib_add);
421 if (sol_thread_active)
423 printf_filtered ("sol-thread active.\n");
424 main_ph.ptid = inferior_ptid; /* Save for xfer_memory */
425 push_target (&sol_thread_ops);
426 inferior_ptid = lwp_to_thread (inferior_ptid);
427 if (PIDGET (inferior_ptid) == -1)
428 inferior_ptid = main_ph.ptid;
430 add_thread (inferior_ptid);
432 /* XXX - might want to iterate over all the threads and register them. */
435 /* Take a program previously attached to and detaches it.
436 The program resumes execution and will no longer stop
437 on signals, etc. We'd better not have left any breakpoints
438 in the program or it'll die when it hits one. For this
439 to work, it may be necessary for the process to have been
440 previously attached. It *might* work if the program was
441 started via the normal ptrace (PTRACE_TRACEME). */
444 sol_thread_detach (char *args, int from_tty)
446 inferior_ptid = pid_to_ptid (PIDGET (main_ph.ptid));
447 unpush_target (&sol_thread_ops);
448 procfs_ops.to_detach (args, from_tty);
451 /* Resume execution of process PID. If STEP is nozero, then
452 just single step it. If SIGNAL is nonzero, restart it with that
453 signal activated. We may have to convert pid from a thread-id to an LWP id
457 sol_thread_resume (ptid_t ptid, int step, enum target_signal signo)
459 struct cleanup *old_chain;
461 old_chain = save_inferior_ptid ();
463 inferior_ptid = thread_to_lwp (inferior_ptid, PIDGET (main_ph.ptid));
464 if (PIDGET (inferior_ptid) == -1)
465 inferior_ptid = procfs_first_available ();
467 if (PIDGET (ptid) != -1)
469 ptid_t save_ptid = ptid;
471 ptid = thread_to_lwp (ptid, -2);
472 if (PIDGET (ptid) == -2) /* Inactive thread */
473 error ("This version of Solaris can't start inactive threads.");
474 if (info_verbose && PIDGET (ptid) == -1)
475 warning ("Specified thread %ld seems to have terminated",
476 GET_THREAD (save_ptid));
479 procfs_ops.to_resume (ptid, step, signo);
481 do_cleanups (old_chain);
484 /* Wait for any threads to stop. We may have to convert PID from a thread id
485 to a LWP id, and vice versa on the way out. */
488 sol_thread_wait (ptid_t ptid, struct target_waitstatus *ourstatus)
492 struct cleanup *old_chain;
494 save_ptid = inferior_ptid;
495 old_chain = save_inferior_ptid ();
497 inferior_ptid = thread_to_lwp (inferior_ptid, PIDGET (main_ph.ptid));
498 if (PIDGET (inferior_ptid) == -1)
499 inferior_ptid = procfs_first_available ();
501 if (PIDGET (ptid) != -1)
503 ptid_t save_ptid = ptid;
505 ptid = thread_to_lwp (ptid, -2);
506 if (PIDGET (ptid) == -2) /* Inactive thread */
507 error ("This version of Solaris can't start inactive threads.");
508 if (info_verbose && PIDGET (ptid) == -1)
509 warning ("Specified thread %ld seems to have terminated",
510 GET_THREAD (save_ptid));
513 rtnval = procfs_ops.to_wait (ptid, ourstatus);
515 if (ourstatus->kind != TARGET_WAITKIND_EXITED)
517 /* Map the LWP of interest back to the appropriate thread ID */
518 rtnval = lwp_to_thread (rtnval);
519 if (PIDGET (rtnval) == -1)
522 /* See if we have a new thread */
523 if (is_thread (rtnval)
524 && !ptid_equal (rtnval, save_ptid)
525 && !in_thread_list (rtnval))
527 printf_filtered ("[New %s]\n", target_pid_to_str (rtnval));
532 /* During process initialization, we may get here without the thread package
533 being initialized, since that can only happen after we've found the shared
536 do_cleanups (old_chain);
542 sol_thread_fetch_registers (int regno)
545 td_thrhandle_t thandle;
548 prfpregset_t fpregset;
554 if (!is_thread (inferior_ptid))
555 { /* LWP: pass the request on to procfs.c */
556 if (target_has_execution)
557 procfs_ops.to_fetch_registers (regno);
559 orig_core_ops.to_fetch_registers (regno);
563 /* Solaris thread: convert inferior_ptid into a td_thrhandle_t */
565 thread = GET_THREAD (inferior_ptid);
568 error ("sol_thread_fetch_registers: thread == 0");
570 val = p_td_ta_map_id2thr (main_ta, thread, &thandle);
572 error ("sol_thread_fetch_registers: td_ta_map_id2thr: %s",
573 td_err_string (val));
575 /* Get the integer regs */
577 val = p_td_thr_getgregs (&thandle, gregset);
579 && val != TD_PARTIALREG)
580 error ("sol_thread_fetch_registers: td_thr_getgregs %s",
581 td_err_string (val));
583 /* For the sparc, TD_PARTIALREG means that only i0->i7, l0->l7, pc and sp
584 are saved (by a thread context switch). */
586 /* And, now the fp regs */
588 val = p_td_thr_getfpregs (&thandle, &fpregset);
590 && val != TD_NOFPREGS)
591 error ("sol_thread_fetch_registers: td_thr_getfpregs %s",
592 td_err_string (val));
594 /* Note that we must call supply_{g fp}regset *after* calling the td routines
595 because the td routines call ps_lget* which affect the values stored in the
598 supply_gregset ((gdb_gregset_t *) &gregset);
599 supply_fpregset ((gdb_fpregset_t *) &fpregset);
602 /* thread_db doesn't seem to handle this right */
603 val = td_thr_getxregsize (&thandle, &xregsize);
604 if (val != TD_OK && val != TD_NOXREGS)
605 error ("sol_thread_fetch_registers: td_thr_getxregsize %s",
606 td_err_string (val));
610 xregset = alloca (xregsize);
611 val = td_thr_getxregs (&thandle, xregset);
613 error ("sol_thread_fetch_registers: td_thr_getxregs %s",
614 td_err_string (val));
620 sol_thread_store_registers (int regno)
623 td_thrhandle_t thandle;
626 prfpregset_t fpregset;
632 if (!is_thread (inferior_ptid))
633 { /* LWP: pass the request on to procfs.c */
634 procfs_ops.to_store_registers (regno);
638 /* Solaris thread: convert inferior_ptid into a td_thrhandle_t */
640 thread = GET_THREAD (inferior_ptid);
642 val = p_td_ta_map_id2thr (main_ta, thread, &thandle);
644 error ("sol_thread_store_registers: td_ta_map_id2thr %s",
645 td_err_string (val));
648 { /* Not writing all the regs */
649 char old_value[MAX_REGISTER_SIZE];
651 /* Save new register value. */
652 regcache_collect (regno, old_value);
654 val = p_td_thr_getgregs (&thandle, gregset);
656 error ("sol_thread_store_registers: td_thr_getgregs %s",
657 td_err_string (val));
658 val = p_td_thr_getfpregs (&thandle, &fpregset);
660 error ("sol_thread_store_registers: td_thr_getfpregs %s",
661 td_err_string (val));
663 /* Restore new register value. */
664 supply_register (regno, old_value);
667 /* thread_db doesn't seem to handle this right */
668 val = td_thr_getxregsize (&thandle, &xregsize);
669 if (val != TD_OK && val != TD_NOXREGS)
670 error ("sol_thread_store_registers: td_thr_getxregsize %s",
671 td_err_string (val));
675 xregset = alloca (xregsize);
676 val = td_thr_getxregs (&thandle, xregset);
678 error ("sol_thread_store_registers: td_thr_getxregs %s",
679 td_err_string (val));
684 fill_gregset ((gdb_gregset_t *) &gregset, regno);
685 fill_fpregset ((gdb_fpregset_t *) &fpregset, regno);
687 val = p_td_thr_setgregs (&thandle, gregset);
689 error ("sol_thread_store_registers: td_thr_setgregs %s",
690 td_err_string (val));
691 val = p_td_thr_setfpregs (&thandle, &fpregset);
693 error ("sol_thread_store_registers: td_thr_setfpregs %s",
694 td_err_string (val));
697 /* thread_db doesn't seem to handle this right */
698 val = td_thr_getxregsize (&thandle, &xregsize);
699 if (val != TD_OK && val != TD_NOXREGS)
700 error ("sol_thread_store_registers: td_thr_getxregsize %s",
701 td_err_string (val));
703 /* Should probably do something about writing the xregs here, but what are
708 /* Get ready to modify the registers array. On machines which store
709 individual registers, this doesn't need to do anything. On machines
710 which store all the registers in one fell swoop, this makes sure
711 that registers contains all the registers from the program being
715 sol_thread_prepare_to_store (void)
717 procfs_ops.to_prepare_to_store ();
720 /* Transfer LEN bytes between GDB address MYADDR and target address
721 MEMADDR. If DOWRITE is non-zero, transfer them to the target,
722 otherwise transfer them from the target. TARGET is unused.
724 Returns the number of bytes transferred. */
727 sol_thread_xfer_memory (CORE_ADDR memaddr, char *myaddr, int len, int dowrite,
728 struct mem_attrib *attrib,
729 struct target_ops *target)
732 struct cleanup *old_chain;
734 old_chain = save_inferior_ptid ();
736 if (is_thread (inferior_ptid) || /* A thread */
737 !target_thread_alive (inferior_ptid)) /* An lwp, but not alive */
738 inferior_ptid = procfs_first_available (); /* Find any live lwp. */
739 /* Note: don't need to call switch_to_thread; we're just reading memory. */
741 if (target_has_execution)
742 retval = procfs_ops.to_xfer_memory (memaddr, myaddr, len,
743 dowrite, attrib, target);
745 retval = orig_core_ops.to_xfer_memory (memaddr, myaddr, len,
746 dowrite, attrib, target);
748 do_cleanups (old_chain);
753 /* Print status information about what we're accessing. */
756 sol_thread_files_info (struct target_ops *ignore)
758 procfs_ops.to_files_info (ignore);
762 sol_thread_kill_inferior (void)
764 procfs_ops.to_kill ();
768 sol_thread_notice_signals (ptid_t ptid)
770 procfs_ops.to_notice_signals (pid_to_ptid (PIDGET (ptid)));
773 /* Fork an inferior process, and start debugging it with /proc. */
776 sol_thread_create_inferior (char *exec_file, char *allargs, char **env)
778 procfs_ops.to_create_inferior (exec_file, allargs, env);
780 if (sol_thread_active && !ptid_equal (inferior_ptid, null_ptid))
782 main_ph.ptid = inferior_ptid; /* Save for xfer_memory */
784 push_target (&sol_thread_ops);
786 inferior_ptid = lwp_to_thread (inferior_ptid);
787 if (PIDGET (inferior_ptid) == -1)
788 inferior_ptid = main_ph.ptid;
790 if (!in_thread_list (inferior_ptid))
791 add_thread (inferior_ptid);
795 /* This routine is called whenever a new symbol table is read in, or when all
796 symbol tables are removed. libthread_db can only be initialized when it
797 finds the right variables in libthread.so. Since it's a shared library,
798 those variables don't show up until the library gets mapped and the symbol
801 /* This new_objfile event is now managed by a chained function pointer.
802 * It is the callee's responsability to call the next client on the chain.
805 /* Saved pointer to previous owner of the new_objfile event. */
806 static void (*target_new_objfile_chain) (struct objfile *);
809 sol_thread_new_objfile (struct objfile *objfile)
815 sol_thread_active = 0;
819 /* don't do anything if init failed to resolve the libthread_db library */
820 if (!procfs_suppress_run)
823 /* Now, initialize the thread debugging library. This needs to be done after
824 the shared libraries are located because it needs information from the
825 user's thread library. */
830 warning ("sol_thread_new_objfile: td_init: %s", td_err_string (val));
834 val = p_td_ta_new (&main_ph, &main_ta);
835 if (val == TD_NOLIBTHREAD)
837 else if (val != TD_OK)
839 warning ("sol_thread_new_objfile: td_ta_new: %s", td_err_string (val));
843 sol_thread_active = 1;
845 /* Call predecessor on chain, if any. */
846 if (target_new_objfile_chain)
847 target_new_objfile_chain (objfile);
850 /* Clean up after the inferior dies. */
853 sol_thread_mourn_inferior (void)
855 unpush_target (&sol_thread_ops);
856 procfs_ops.to_mourn_inferior ();
859 /* Mark our target-struct as eligible for stray "run" and "attach" commands. */
862 sol_thread_can_run (void)
864 return procfs_suppress_run;
871 sol_thread_alive - test thread for "aliveness"
875 static bool sol_thread_alive (ptid_t ptid);
879 returns true if thread still active in inferior.
884 sol_thread_alive (ptid_t ptid)
886 if (is_thread (ptid)) /* non-kernel thread */
892 pid = GET_THREAD (ptid);
893 if ((val = p_td_ta_map_id2thr (main_ta, pid, &th)) != TD_OK)
894 return 0; /* thread not found */
895 if ((val = p_td_thr_validate (&th)) != TD_OK)
896 return 0; /* thread not valid */
897 return 1; /* known thread: return true */
900 /* kernel thread (LWP): let procfs test it */
902 if (target_has_execution)
903 return procfs_ops.to_thread_alive (ptid);
905 return orig_core_ops.to_thread_alive (ptid);
910 sol_thread_stop (void)
912 procfs_ops.to_stop ();
915 /* These routines implement the lower half of the thread_db interface. Ie: the
918 /* Various versions of <proc_service.h> have slightly
919 different function prototypes. In particular, we have
922 struct ps_prochandle * const struct ps_prochandle *
927 Which one you have depends on solaris version and what
928 patches you've applied. On the theory that there are
929 only two major variants, we have configure check the
930 prototype of ps_pdwrite (), and use that info to make
931 appropriate typedefs here. */
933 #ifdef PROC_SERVICE_IS_OLD
934 typedef const struct ps_prochandle *gdb_ps_prochandle_t;
935 typedef char *gdb_ps_read_buf_t;
936 typedef char *gdb_ps_write_buf_t;
937 typedef int gdb_ps_size_t;
938 typedef paddr_t gdb_ps_addr_t;
940 typedef struct ps_prochandle *gdb_ps_prochandle_t;
941 typedef void *gdb_ps_read_buf_t;
942 typedef const void *gdb_ps_write_buf_t;
943 typedef size_t gdb_ps_size_t;
944 typedef psaddr_t gdb_ps_addr_t;
948 /* The next four routines are called by thread_db to tell us to stop and stop
949 a particular process or lwp. Since GDB ensures that these are all stopped
950 by the time we call anything in thread_db, these routines need to do
956 ps_pstop (gdb_ps_prochandle_t ph)
961 /* Process continue */
964 ps_pcontinue (gdb_ps_prochandle_t ph)
972 ps_lstop (gdb_ps_prochandle_t ph, lwpid_t lwpid)
980 ps_lcontinue (gdb_ps_prochandle_t ph, lwpid_t lwpid)
985 /* Looks up the symbol LD_SYMBOL_NAME in the debugger's symbol table. */
988 ps_pglobal_lookup (gdb_ps_prochandle_t ph, const char *ld_object_name,
989 const char *ld_symbol_name, gdb_ps_addr_t * ld_symbol_addr)
991 struct minimal_symbol *ms;
993 ms = lookup_minimal_symbol (ld_symbol_name, NULL, NULL);
998 *ld_symbol_addr = SYMBOL_VALUE_ADDRESS (ms);
1003 /* Common routine for reading and writing memory. */
1006 rw_common (int dowrite, const struct ps_prochandle *ph, gdb_ps_addr_t addr,
1007 char *buf, int size)
1009 struct cleanup *old_chain;
1011 old_chain = save_inferior_ptid ();
1013 if (is_thread (inferior_ptid) || /* A thread */
1014 !target_thread_alive (inferior_ptid)) /* An lwp, but not alive */
1015 inferior_ptid = procfs_first_available (); /* Find any live lwp. */
1016 /* Note: don't need to call switch_to_thread; we're just reading memory. */
1018 #if defined (__sparcv9)
1019 /* For Sparc64 cross Sparc32, make sure the address has not been
1020 accidentally sign-extended (or whatever) to beyond 32 bits. */
1021 if (bfd_get_arch_size (exec_bfd) == 32)
1029 /* FIXME: passing 0 as attrib argument. */
1030 if (target_has_execution)
1031 cc = procfs_ops.to_xfer_memory (addr, buf, size,
1032 dowrite, 0, &procfs_ops);
1034 cc = orig_core_ops.to_xfer_memory (addr, buf, size,
1035 dowrite, 0, &core_ops);
1040 print_sys_errmsg ("rw_common (): read", errno);
1042 print_sys_errmsg ("rw_common (): write", errno);
1044 do_cleanups (old_chain);
1051 warning ("rw_common (): unable to read at addr 0x%lx",
1054 warning ("rw_common (): unable to write at addr 0x%lx",
1057 do_cleanups (old_chain);
1066 do_cleanups (old_chain);
1071 /* Copies SIZE bytes from target process .data segment to debugger memory. */
1074 ps_pdread (gdb_ps_prochandle_t ph, gdb_ps_addr_t addr,
1075 gdb_ps_read_buf_t buf, gdb_ps_size_t size)
1077 return rw_common (0, ph, addr, buf, size);
1080 /* Copies SIZE bytes from debugger memory .data segment to target process. */
1083 ps_pdwrite (gdb_ps_prochandle_t ph, gdb_ps_addr_t addr,
1084 gdb_ps_write_buf_t buf, gdb_ps_size_t size)
1086 return rw_common (1, ph, addr, (char *) buf, size);
1089 /* Copies SIZE bytes from target process .text segment to debugger memory. */
1092 ps_ptread (gdb_ps_prochandle_t ph, gdb_ps_addr_t addr,
1093 gdb_ps_read_buf_t buf, gdb_ps_size_t size)
1095 return rw_common (0, ph, addr, buf, size);
1098 /* Copies SIZE bytes from debugger memory .text segment to target process. */
1101 ps_ptwrite (gdb_ps_prochandle_t ph, gdb_ps_addr_t addr,
1102 gdb_ps_write_buf_t buf, gdb_ps_size_t size)
1104 return rw_common (1, ph, addr, (char *) buf, size);
1107 /* Get integer regs for LWP */
1110 ps_lgetregs (gdb_ps_prochandle_t ph, lwpid_t lwpid,
1111 prgregset_t gregset)
1113 struct cleanup *old_chain;
1115 old_chain = save_inferior_ptid ();
1117 inferior_ptid = BUILD_LWP (lwpid, PIDGET (inferior_ptid));
1119 if (target_has_execution)
1120 procfs_ops.to_fetch_registers (-1);
1122 orig_core_ops.to_fetch_registers (-1);
1123 fill_gregset ((gdb_gregset_t *) gregset, -1);
1125 do_cleanups (old_chain);
1130 /* Set integer regs for LWP */
1133 ps_lsetregs (gdb_ps_prochandle_t ph, lwpid_t lwpid,
1134 const prgregset_t gregset)
1136 struct cleanup *old_chain;
1138 old_chain = save_inferior_ptid ();
1140 inferior_ptid = BUILD_LWP (lwpid, PIDGET (inferior_ptid));
1142 supply_gregset ((gdb_gregset_t *) gregset);
1143 if (target_has_execution)
1144 procfs_ops.to_store_registers (-1);
1146 orig_core_ops.to_store_registers (-1);
1148 do_cleanups (old_chain);
1153 /* Log a message (sends to gdb_stderr). */
1156 ps_plog (const char *fmt,...)
1160 va_start (args, fmt);
1162 vfprintf_filtered (gdb_stderr, fmt, args);
1165 /* Get size of extra register set. Currently a noop. */
1168 ps_lgetxregsize (gdb_ps_prochandle_t ph, lwpid_t lwpid, int *xregsize)
1175 val = get_lwp_fd (ph, lwpid, &lwp_fd);
1179 if (ioctl (lwp_fd, PIOCGXREGSIZE, ®size))
1181 if (errno == EINVAL)
1182 return PS_NOFREGS; /* XXX Wrong code, but this is the closest
1183 thing in proc_service.h */
1185 print_sys_errmsg ("ps_lgetxregsize (): PIOCGXREGSIZE", errno);
1193 /* Get extra register set. Currently a noop. */
1196 ps_lgetxregs (gdb_ps_prochandle_t ph, lwpid_t lwpid, caddr_t xregset)
1202 val = get_lwp_fd (ph, lwpid, &lwp_fd);
1206 if (ioctl (lwp_fd, PIOCGXREG, xregset))
1208 print_sys_errmsg ("ps_lgetxregs (): PIOCGXREG", errno);
1216 /* Set extra register set. Currently a noop. */
1219 ps_lsetxregs (gdb_ps_prochandle_t ph, lwpid_t lwpid, caddr_t xregset)
1225 val = get_lwp_fd (ph, lwpid, &lwp_fd);
1229 if (ioctl (lwp_fd, PIOCSXREG, xregset))
1231 print_sys_errmsg ("ps_lsetxregs (): PIOCSXREG", errno);
1239 /* Get floating-point regs for LWP */
1242 ps_lgetfpregs (gdb_ps_prochandle_t ph, lwpid_t lwpid,
1243 prfpregset_t * fpregset)
1245 struct cleanup *old_chain;
1247 old_chain = save_inferior_ptid ();
1249 inferior_ptid = BUILD_LWP (lwpid, PIDGET (inferior_ptid));
1251 if (target_has_execution)
1252 procfs_ops.to_fetch_registers (-1);
1254 orig_core_ops.to_fetch_registers (-1);
1255 fill_fpregset ((gdb_fpregset_t *) fpregset, -1);
1257 do_cleanups (old_chain);
1262 /* Set floating-point regs for LWP */
1265 ps_lsetfpregs (gdb_ps_prochandle_t ph, lwpid_t lwpid,
1266 const prfpregset_t * fpregset)
1268 struct cleanup *old_chain;
1270 old_chain = save_inferior_ptid ();
1272 inferior_ptid = BUILD_LWP (lwpid, PIDGET (inferior_ptid));
1274 supply_fpregset ((gdb_fpregset_t *) fpregset);
1275 if (target_has_execution)
1276 procfs_ops.to_store_registers (-1);
1278 orig_core_ops.to_store_registers (-1);
1280 do_cleanups (old_chain);
1285 #ifdef PR_MODEL_LP64
1286 /* Identify process as 32-bit or 64-bit.
1287 At the moment I'm using bfd to do this.
1288 There might be a more solaris-specific (eg. procfs) method,
1289 but this ought to work. */
1292 ps_pdmodel (gdb_ps_prochandle_t ph, int *data_model)
1295 *data_model = PR_MODEL_UNKNOWN;
1296 else if (bfd_get_arch_size (exec_bfd) == 32)
1297 *data_model = PR_MODEL_ILP32;
1299 *data_model = PR_MODEL_LP64;
1303 #endif /* PR_MODEL_LP64 */
1305 #ifdef TM_I386SOL2_H
1307 /* Reads the local descriptor table of a LWP. */
1310 ps_lgetLDT (gdb_ps_prochandle_t ph, lwpid_t lwpid,
1313 /* NOTE: only used on Solaris, therefore OK to refer to procfs.c */
1314 extern struct ssd *procfs_find_LDT_entry (ptid_t);
1317 /* FIXME: can't I get the process ID from the prochandle or something?
1320 if (PIDGET (inferior_ptid) <= 0 || lwpid <= 0)
1323 ret = procfs_find_LDT_entry (BUILD_LWP (lwpid, PIDGET (inferior_ptid)));
1326 memcpy (pldt, ret, sizeof (struct ssd));
1329 else /* LDT not found. */
1332 #endif /* TM_I386SOL2_H */
1334 /* Convert a pid to printable form. */
1337 solaris_pid_to_str (ptid_t ptid)
1339 static char buf[100];
1341 /* in case init failed to resolve the libthread_db library */
1342 if (!procfs_suppress_run)
1343 return procfs_pid_to_str (ptid);
1345 if (is_thread (ptid))
1349 lwp = thread_to_lwp (ptid, -2);
1351 if (PIDGET (lwp) == -1)
1352 sprintf (buf, "Thread %ld (defunct)", GET_THREAD (ptid));
1353 else if (PIDGET (lwp) != -2)
1354 sprintf (buf, "Thread %ld (LWP %ld)", GET_THREAD (ptid), GET_LWP (lwp));
1356 sprintf (buf, "Thread %ld ", GET_THREAD (ptid));
1358 else if (GET_LWP (ptid) != 0)
1359 sprintf (buf, "LWP %ld ", GET_LWP (ptid));
1361 sprintf (buf, "process %d ", PIDGET (ptid));
1367 /* Worker bee for find_new_threads
1368 Callback function that gets called once per USER thread (i.e., not
1372 sol_find_new_threads_callback (const td_thrhandle_t *th, void *ignored)
1378 if ((retval = p_td_thr_get_info (th, &ti)) != TD_OK)
1382 ptid = BUILD_THREAD (ti.ti_tid, PIDGET (inferior_ptid));
1383 if (!in_thread_list (ptid))
1390 sol_find_new_threads (void)
1392 /* don't do anything if init failed to resolve the libthread_db library */
1393 if (!procfs_suppress_run)
1396 if (PIDGET (inferior_ptid) == -1)
1398 printf_filtered ("No process.\n");
1401 procfs_ops.to_find_new_threads (); /* first find new kernel threads */
1402 p_td_ta_thr_iter (main_ta, sol_find_new_threads_callback, (void *) 0,
1403 TD_THR_ANY_STATE, TD_THR_LOWEST_PRIORITY,
1404 TD_SIGNO_MASK, TD_THR_ANY_USER_FLAGS);
1408 sol_core_open (char *filename, int from_tty)
1410 orig_core_ops.to_open (filename, from_tty);
1414 sol_core_close (int quitting)
1416 orig_core_ops.to_close (quitting);
1420 sol_core_detach (char *args, int from_tty)
1422 unpush_target (&core_ops);
1423 orig_core_ops.to_detach (args, from_tty);
1427 sol_core_files_info (struct target_ops *t)
1429 orig_core_ops.to_files_info (t);
1432 /* Worker bee for info sol-thread command. This is a callback function that
1433 gets called once for each Solaris thread (ie. not kernel thread) in the
1434 inferior. Print anything interesting that we can think of. */
1437 info_cb (const td_thrhandle_t *th, void *s)
1442 if ((ret = p_td_thr_get_info (th, &ti)) == TD_OK)
1444 printf_filtered ("%s thread #%d, lwp %d, ",
1445 ti.ti_type == TD_THR_SYSTEM ? "system" : "user ",
1446 ti.ti_tid, ti.ti_lid);
1447 switch (ti.ti_state)
1450 case TD_THR_UNKNOWN:
1451 printf_filtered ("<unknown state>");
1453 case TD_THR_STOPPED:
1454 printf_filtered ("(stopped)");
1457 printf_filtered ("(run) ");
1460 printf_filtered ("(active) ");
1463 printf_filtered ("(zombie) ");
1466 printf_filtered ("(asleep) ");
1468 case TD_THR_STOPPED_ASLEEP:
1469 printf_filtered ("(stopped asleep)");
1472 /* Print thr_create start function: */
1473 if (ti.ti_startfunc != 0)
1475 struct minimal_symbol *msym;
1476 msym = lookup_minimal_symbol_by_pc (ti.ti_startfunc);
1478 printf_filtered (" startfunc: %s\n", DEPRECATED_SYMBOL_NAME (msym));
1480 printf_filtered (" startfunc: 0x%s\n", paddr (ti.ti_startfunc));
1483 /* If thread is asleep, print function that went to sleep: */
1484 if (ti.ti_state == TD_THR_SLEEP)
1486 struct minimal_symbol *msym;
1487 msym = lookup_minimal_symbol_by_pc (ti.ti_pc);
1489 printf_filtered (" - Sleep func: %s\n", DEPRECATED_SYMBOL_NAME (msym));
1491 printf_filtered (" - Sleep func: 0x%s\n", paddr (ti.ti_startfunc));
1494 /* Wrap up line, if necessary */
1495 if (ti.ti_state != TD_THR_SLEEP && ti.ti_startfunc == 0)
1496 printf_filtered ("\n"); /* don't you hate counting newlines? */
1499 warning ("info sol-thread: failed to get info for thread.");
1504 /* List some state about each Solaris user thread in the inferior. */
1507 info_solthreads (char *args, int from_tty)
1509 p_td_ta_thr_iter (main_ta, info_cb, args,
1510 TD_THR_ANY_STATE, TD_THR_LOWEST_PRIORITY,
1511 TD_SIGNO_MASK, TD_THR_ANY_USER_FLAGS);
1515 sol_find_memory_regions (int (*func) (CORE_ADDR,
1521 return procfs_ops.to_find_memory_regions (func, data);
1525 sol_make_note_section (bfd *obfd, int *note_size)
1527 return procfs_ops.to_make_corefile_notes (obfd, note_size);
1531 ignore (CORE_ADDR addr, char *contents)
1538 init_sol_thread_ops (void)
1540 sol_thread_ops.to_shortname = "solaris-threads";
1541 sol_thread_ops.to_longname = "Solaris threads and pthread.";
1542 sol_thread_ops.to_doc = "Solaris threads and pthread support.";
1543 sol_thread_ops.to_open = sol_thread_open;
1544 sol_thread_ops.to_attach = sol_thread_attach;
1545 sol_thread_ops.to_detach = sol_thread_detach;
1546 sol_thread_ops.to_resume = sol_thread_resume;
1547 sol_thread_ops.to_wait = sol_thread_wait;
1548 sol_thread_ops.to_fetch_registers = sol_thread_fetch_registers;
1549 sol_thread_ops.to_store_registers = sol_thread_store_registers;
1550 sol_thread_ops.to_prepare_to_store = sol_thread_prepare_to_store;
1551 sol_thread_ops.to_xfer_memory = sol_thread_xfer_memory;
1552 sol_thread_ops.to_files_info = sol_thread_files_info;
1553 sol_thread_ops.to_insert_breakpoint = memory_insert_breakpoint;
1554 sol_thread_ops.to_remove_breakpoint = memory_remove_breakpoint;
1555 sol_thread_ops.to_terminal_init = terminal_init_inferior;
1556 sol_thread_ops.to_terminal_inferior = terminal_inferior;
1557 sol_thread_ops.to_terminal_ours_for_output = terminal_ours_for_output;
1558 sol_thread_ops.to_terminal_ours = terminal_ours;
1559 sol_thread_ops.to_terminal_save_ours = terminal_save_ours;
1560 sol_thread_ops.to_terminal_info = child_terminal_info;
1561 sol_thread_ops.to_kill = sol_thread_kill_inferior;
1562 sol_thread_ops.to_create_inferior = sol_thread_create_inferior;
1563 sol_thread_ops.to_mourn_inferior = sol_thread_mourn_inferior;
1564 sol_thread_ops.to_can_run = sol_thread_can_run;
1565 sol_thread_ops.to_notice_signals = sol_thread_notice_signals;
1566 sol_thread_ops.to_thread_alive = sol_thread_alive;
1567 sol_thread_ops.to_pid_to_str = solaris_pid_to_str;
1568 sol_thread_ops.to_find_new_threads = sol_find_new_threads;
1569 sol_thread_ops.to_stop = sol_thread_stop;
1570 sol_thread_ops.to_stratum = process_stratum;
1571 sol_thread_ops.to_has_all_memory = 1;
1572 sol_thread_ops.to_has_memory = 1;
1573 sol_thread_ops.to_has_stack = 1;
1574 sol_thread_ops.to_has_registers = 1;
1575 sol_thread_ops.to_has_execution = 1;
1576 sol_thread_ops.to_has_thread_control = tc_none;
1577 sol_thread_ops.to_find_memory_regions = sol_find_memory_regions;
1578 sol_thread_ops.to_make_corefile_notes = sol_make_note_section;
1579 sol_thread_ops.to_magic = OPS_MAGIC;
1584 init_sol_core_ops (void)
1586 sol_core_ops.to_shortname = "solaris-core";
1587 sol_core_ops.to_longname = "Solaris core threads and pthread.";
1588 sol_core_ops.to_doc = "Solaris threads and pthread support for core files.";
1589 sol_core_ops.to_open = sol_core_open;
1590 sol_core_ops.to_close = sol_core_close;
1591 sol_core_ops.to_attach = sol_thread_attach;
1592 sol_core_ops.to_detach = sol_core_detach;
1593 sol_core_ops.to_fetch_registers = sol_thread_fetch_registers;
1594 sol_core_ops.to_xfer_memory = sol_thread_xfer_memory;
1595 sol_core_ops.to_files_info = sol_core_files_info;
1596 sol_core_ops.to_insert_breakpoint = ignore;
1597 sol_core_ops.to_remove_breakpoint = ignore;
1598 sol_core_ops.to_create_inferior = sol_thread_create_inferior;
1599 sol_core_ops.to_stratum = core_stratum;
1600 sol_core_ops.to_has_memory = 1;
1601 sol_core_ops.to_has_stack = 1;
1602 sol_core_ops.to_has_registers = 1;
1603 sol_core_ops.to_has_thread_control = tc_none;
1604 sol_core_ops.to_thread_alive = sol_thread_alive;
1605 sol_core_ops.to_pid_to_str = solaris_pid_to_str;
1606 /* On Solaris/x86, when debugging a threaded core file from process <n>,
1607 the following causes "info threads" to produce "procfs: couldn't find pid
1608 <n> in procinfo list" where <n> is the pid of the process that produced
1609 the core file. Disable it for now. */
1610 /* sol_core_ops.to_find_new_threads = sol_find_new_threads; */
1611 sol_core_ops.to_magic = OPS_MAGIC;
1614 /* we suppress the call to add_target of core_ops in corelow because
1615 if there are two targets in the stratum core_stratum, find_core_target
1616 won't know which one to return. see corelow.c for an additonal
1617 comment on coreops_suppress_target. */
1618 int coreops_suppress_target = 1;
1621 _initialize_sol_thread (void)
1625 init_sol_thread_ops ();
1626 init_sol_core_ops ();
1628 dlhandle = dlopen ("libthread_db.so.1", RTLD_NOW);
1632 #define resolve(X) \
1633 if (!(p_##X = dlsym (dlhandle, #X))) \
1637 resolve (td_ta_new);
1638 resolve (td_ta_delete);
1640 resolve (td_ta_get_ph);
1641 resolve (td_ta_get_nthreads);
1642 resolve (td_ta_tsd_iter);
1643 resolve (td_ta_thr_iter);
1644 resolve (td_thr_validate);
1645 resolve (td_thr_tsd);
1646 resolve (td_thr_get_info);
1647 resolve (td_thr_getfpregs);
1648 resolve (td_thr_getxregsize);
1649 resolve (td_thr_getxregs);
1650 resolve (td_thr_sigsetmask);
1651 resolve (td_thr_setprio);
1652 resolve (td_thr_setsigpending);
1653 resolve (td_thr_setfpregs);
1654 resolve (td_thr_setxregs);
1655 resolve (td_ta_map_id2thr);
1656 resolve (td_ta_map_lwp2thr);
1657 resolve (td_thr_getgregs);
1658 resolve (td_thr_setgregs);
1660 add_target (&sol_thread_ops);
1662 procfs_suppress_run = 1;
1664 add_cmd ("sol-threads", class_maintenance, info_solthreads,
1665 "Show info on Solaris user threads.\n", &maintenanceinfolist);
1667 memcpy (&orig_core_ops, &core_ops, sizeof (struct target_ops));
1668 memcpy (&core_ops, &sol_core_ops, sizeof (struct target_ops));
1669 add_target (&core_ops);
1671 /* Hook into new_objfile notification. */
1672 target_new_objfile_chain = target_new_objfile_hook;
1673 target_new_objfile_hook = sol_thread_new_objfile;
1678 fprintf_unfiltered (gdb_stderr, "[GDB will not be able to debug user-mode threads: %s]\n", dlerror ());
1683 /* allow the user to debug non-threaded core files */
1684 add_target (&core_ops);