| /* Multi-process/thread control for GDB, the GNU debugger. | |
| Copyright (C) 1986, 1987, 1988, 1993, 1994, 1995, 1996, 1997, 1998, 1999, | |
| 2000, 2001, 2002, 2003, 2004, 2007 Free Software Foundation, Inc. | |
| Contributed by Lynx Real-Time Systems, Inc. Los Gatos, CA. | |
| This file is part of GDB. | |
| This program is free software; you can redistribute it and/or modify | |
| it under the terms of the GNU General Public License as published by | |
| the Free Software Foundation; either version 3 of the License, or | |
| (at your option) any later version. | |
| This program is distributed in the hope that it will be useful, | |
| but WITHOUT ANY WARRANTY; without even the implied warranty of | |
| MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
| GNU General Public License for more details. | |
| You should have received a copy of the GNU General Public License | |
| along with this program. If not, see <http://www.gnu.org/licenses/>. */ | |
| #include "defs.h" | |
| #include "symtab.h" | |
| #include "frame.h" | |
| #include "inferior.h" | |
| #include "environ.h" | |
| #include "value.h" | |
| #include "target.h" | |
| #include "gdbthread.h" | |
| #include "exceptions.h" | |
| #include "command.h" | |
| #include "gdbcmd.h" | |
| #include "regcache.h" | |
| #include "gdb.h" | |
| #include "gdb_string.h" | |
| #include <ctype.h> | |
| #include <sys/types.h> | |
| #include <signal.h> | |
| #include "ui-out.h" | |
| /* Definition of struct thread_info exported to gdbthread.h */ | |
| /* Prototypes for exported functions. */ | |
| void _initialize_thread (void); | |
| /* Prototypes for local functions. */ | |
| static struct thread_info *thread_list = NULL; | |
| static int highest_thread_num; | |
| static struct thread_info *find_thread_id (int num); | |
| static void thread_command (char *tidstr, int from_tty); | |
| static void thread_apply_all_command (char *, int); | |
| static int thread_alive (struct thread_info *); | |
| static void info_threads_command (char *, int); | |
| static void thread_apply_command (char *, int); | |
| static void restore_current_thread (ptid_t); | |
| static void switch_to_thread (ptid_t ptid); | |
| static void prune_threads (void); | |
| static struct cleanup *make_cleanup_restore_current_thread (ptid_t, | |
| struct frame_id); | |
| void | |
| delete_step_resume_breakpoint (void *arg) | |
| { | |
| struct breakpoint **breakpointp = (struct breakpoint **) arg; | |
| struct thread_info *tp; | |
| if (*breakpointp != NULL) | |
| { | |
| delete_breakpoint (*breakpointp); | |
| for (tp = thread_list; tp; tp = tp->next) | |
| if (tp->step_resume_breakpoint == *breakpointp) | |
| tp->step_resume_breakpoint = NULL; | |
| *breakpointp = NULL; | |
| } | |
| } | |
| static void | |
| free_thread (struct thread_info *tp) | |
| { | |
| /* NOTE: this will take care of any left-over step_resume breakpoints, | |
| but not any user-specified thread-specific breakpoints. */ | |
| if (tp->step_resume_breakpoint) | |
| delete_breakpoint (tp->step_resume_breakpoint); | |
| /* FIXME: do I ever need to call the back-end to give it a | |
| chance at this private data before deleting the thread? */ | |
| if (tp->private) | |
| xfree (tp->private); | |
| xfree (tp); | |
| } | |
| void | |
| init_thread_list (void) | |
| { | |
| struct thread_info *tp, *tpnext; | |
| highest_thread_num = 0; | |
| if (!thread_list) | |
| return; | |
| for (tp = thread_list; tp; tp = tpnext) | |
| { | |
| tpnext = tp->next; | |
| free_thread (tp); | |
| } | |
| thread_list = NULL; | |
| } | |
| /* add_thread now returns a pointer to the new thread_info, | |
| so that back_ends can initialize their private data. */ | |
| struct thread_info * | |
| add_thread (ptid_t ptid) | |
| { | |
| struct thread_info *tp; | |
| tp = (struct thread_info *) xmalloc (sizeof (*tp)); | |
| memset (tp, 0, sizeof (*tp)); | |
| tp->ptid = ptid; | |
| tp->num = ++highest_thread_num; | |
| tp->next = thread_list; | |
| thread_list = tp; | |
| return tp; | |
| } | |
| void | |
| delete_thread (ptid_t ptid) | |
| { | |
| struct thread_info *tp, *tpprev; | |
| tpprev = NULL; | |
| for (tp = thread_list; tp; tpprev = tp, tp = tp->next) | |
| if (ptid_equal (tp->ptid, ptid)) | |
| break; | |
| if (!tp) | |
| return; | |
| if (tpprev) | |
| tpprev->next = tp->next; | |
| else | |
| thread_list = tp->next; | |
| free_thread (tp); | |
| } | |
| static struct thread_info * | |
| find_thread_id (int num) | |
| { | |
| struct thread_info *tp; | |
| for (tp = thread_list; tp; tp = tp->next) | |
| if (tp->num == num) | |
| return tp; | |
| return NULL; | |
| } | |
| /* Find a thread_info by matching PTID. */ | |
| struct thread_info * | |
| find_thread_pid (ptid_t ptid) | |
| { | |
| struct thread_info *tp; | |
| for (tp = thread_list; tp; tp = tp->next) | |
| if (ptid_equal (tp->ptid, ptid)) | |
| return tp; | |
| return NULL; | |
| } | |
| /* | |
| * Thread iterator function. | |
| * | |
| * Calls a callback function once for each thread, so long as | |
| * the callback function returns false. If the callback function | |
| * returns true, the iteration will end and the current thread | |
| * will be returned. This can be useful for implementing a | |
| * search for a thread with arbitrary attributes, or for applying | |
| * some operation to every thread. | |
| * | |
| * FIXME: some of the existing functionality, such as | |
| * "Thread apply all", might be rewritten using this functionality. | |
| */ | |
| struct thread_info * | |
| iterate_over_threads (int (*callback) (struct thread_info *, void *), | |
| void *data) | |
| { | |
| struct thread_info *tp; | |
| for (tp = thread_list; tp; tp = tp->next) | |
| if ((*callback) (tp, data)) | |
| return tp; | |
| return NULL; | |
| } | |
| int | |
| valid_thread_id (int num) | |
| { | |
| struct thread_info *tp; | |
| for (tp = thread_list; tp; tp = tp->next) | |
| if (tp->num == num) | |
| return 1; | |
| return 0; | |
| } | |
| int | |
| pid_to_thread_id (ptid_t ptid) | |
| { | |
| struct thread_info *tp; | |
| for (tp = thread_list; tp; tp = tp->next) | |
| if (ptid_equal (tp->ptid, ptid)) | |
| return tp->num; | |
| return 0; | |
| } | |
| ptid_t | |
| thread_id_to_pid (int num) | |
| { | |
| struct thread_info *thread = find_thread_id (num); | |
| if (thread) | |
| return thread->ptid; | |
| else | |
| return pid_to_ptid (-1); | |
| } | |
| int | |
| in_thread_list (ptid_t ptid) | |
| { | |
| struct thread_info *tp; | |
| for (tp = thread_list; tp; tp = tp->next) | |
| if (ptid_equal (tp->ptid, ptid)) | |
| return 1; | |
| return 0; /* Never heard of 'im */ | |
| } | |
| /* Print a list of thread ids currently known, and the total number of | |
| threads. To be used from within catch_errors. */ | |
| static int | |
| do_captured_list_thread_ids (struct ui_out *uiout, void *arg) | |
| { | |
| struct thread_info *tp; | |
| int num = 0; | |
| struct cleanup *cleanup_chain; | |
| prune_threads (); | |
| target_find_new_threads (); | |
| cleanup_chain = make_cleanup_ui_out_tuple_begin_end (uiout, "thread-ids"); | |
| for (tp = thread_list; tp; tp = tp->next) | |
| { | |
| num++; | |
| ui_out_field_int (uiout, "thread-id", tp->num); | |
| } | |
| do_cleanups (cleanup_chain); | |
| ui_out_field_int (uiout, "number-of-threads", num); | |
| return GDB_RC_OK; | |
| } | |
| /* Official gdblib interface function to get a list of thread ids and | |
| the total number. */ | |
| enum gdb_rc | |
| gdb_list_thread_ids (struct ui_out *uiout, char **error_message) | |
| { | |
| if (catch_exceptions_with_msg (uiout, do_captured_list_thread_ids, NULL, | |
| error_message, RETURN_MASK_ALL) < 0) | |
| return GDB_RC_FAIL; | |
| return GDB_RC_OK; | |
| } | |
| /* Load infrun state for the thread PID. */ | |
| void | |
| load_infrun_state (ptid_t ptid, | |
| CORE_ADDR *prev_pc, | |
| int *trap_expected, | |
| struct breakpoint **step_resume_breakpoint, | |
| CORE_ADDR *step_range_start, | |
| CORE_ADDR *step_range_end, | |
| struct frame_id *step_frame_id, | |
| int *handling_longjmp, | |
| int *another_trap, | |
| int *stepping_through_solib_after_catch, | |
| bpstat *stepping_through_solib_catchpoints, | |
| int *current_line, | |
| struct symtab **current_symtab) | |
| { | |
| struct thread_info *tp; | |
| /* If we can't find the thread, then we're debugging a single threaded | |
| process. No need to do anything in that case. */ | |
| tp = find_thread_id (pid_to_thread_id (ptid)); | |
| if (tp == NULL) | |
| return; | |
| *prev_pc = tp->prev_pc; | |
| *trap_expected = tp->trap_expected; | |
| *step_resume_breakpoint = tp->step_resume_breakpoint; | |
| *step_range_start = tp->step_range_start; | |
| *step_range_end = tp->step_range_end; | |
| *step_frame_id = tp->step_frame_id; | |
| *handling_longjmp = tp->handling_longjmp; | |
| *another_trap = tp->another_trap; | |
| *stepping_through_solib_after_catch = | |
| tp->stepping_through_solib_after_catch; | |
| *stepping_through_solib_catchpoints = | |
| tp->stepping_through_solib_catchpoints; | |
| *current_line = tp->current_line; | |
| *current_symtab = tp->current_symtab; | |
| } | |
| /* Save infrun state for the thread PID. */ | |
| void | |
| save_infrun_state (ptid_t ptid, | |
| CORE_ADDR prev_pc, | |
| int trap_expected, | |
| struct breakpoint *step_resume_breakpoint, | |
| CORE_ADDR step_range_start, | |
| CORE_ADDR step_range_end, | |
| const struct frame_id *step_frame_id, | |
| int handling_longjmp, | |
| int another_trap, | |
| int stepping_through_solib_after_catch, | |
| bpstat stepping_through_solib_catchpoints, | |
| int current_line, | |
| struct symtab *current_symtab) | |
| { | |
| struct thread_info *tp; | |
| /* If we can't find the thread, then we're debugging a single-threaded | |
| process. Nothing to do in that case. */ | |
| tp = find_thread_id (pid_to_thread_id (ptid)); | |
| if (tp == NULL) | |
| return; | |
| tp->prev_pc = prev_pc; | |
| tp->trap_expected = trap_expected; | |
| tp->step_resume_breakpoint = step_resume_breakpoint; | |
| tp->step_range_start = step_range_start; | |
| tp->step_range_end = step_range_end; | |
| tp->step_frame_id = (*step_frame_id); | |
| tp->handling_longjmp = handling_longjmp; | |
| tp->another_trap = another_trap; | |
| tp->stepping_through_solib_after_catch = stepping_through_solib_after_catch; | |
| tp->stepping_through_solib_catchpoints = stepping_through_solib_catchpoints; | |
| tp->current_line = current_line; | |
| tp->current_symtab = current_symtab; | |
| } | |
| /* Return true if TP is an active thread. */ | |
| static int | |
| thread_alive (struct thread_info *tp) | |
| { | |
| if (PIDGET (tp->ptid) == -1) | |
| return 0; | |
| if (!target_thread_alive (tp->ptid)) | |
| { | |
| tp->ptid = pid_to_ptid (-1); /* Mark it as dead */ | |
| return 0; | |
| } | |
| return 1; | |
| } | |
| static void | |
| prune_threads (void) | |
| { | |
| struct thread_info *tp, *next; | |
| for (tp = thread_list; tp; tp = next) | |
| { | |
| next = tp->next; | |
| if (!thread_alive (tp)) | |
| delete_thread (tp->ptid); | |
| } | |
| } | |
| /* Print information about currently known threads | |
| * Note: this has the drawback that it _really_ switches | |
| * threads, which frees the frame cache. A no-side | |
| * effects info-threads command would be nicer. | |
| */ | |
| static void | |
| info_threads_command (char *arg, int from_tty) | |
| { | |
| struct thread_info *tp; | |
| ptid_t current_ptid; | |
| struct frame_info *cur_frame; | |
| struct cleanup *old_chain; | |
| struct frame_id saved_frame_id; | |
| char *extra_info; | |
| /* Backup current thread and selected frame. */ | |
| saved_frame_id = get_frame_id (get_selected_frame (NULL)); | |
| old_chain = make_cleanup_restore_current_thread (inferior_ptid, saved_frame_id); | |
| prune_threads (); | |
| target_find_new_threads (); | |
| current_ptid = inferior_ptid; | |
| for (tp = thread_list; tp; tp = tp->next) | |
| { | |
| if (ptid_equal (tp->ptid, current_ptid)) | |
| printf_filtered ("* "); | |
| else | |
| printf_filtered (" "); | |
| printf_filtered ("%d %s", tp->num, target_tid_to_str (tp->ptid)); | |
| extra_info = target_extra_thread_info (tp); | |
| if (extra_info) | |
| printf_filtered (" (%s)", extra_info); | |
| puts_filtered (" "); | |
| /* That switch put us at the top of the stack (leaf frame). */ | |
| switch_to_thread (tp->ptid); | |
| print_stack_frame (get_selected_frame (NULL), 0, LOCATION); | |
| } | |
| /* Restores the current thread and the frame selected before | |
| the "info threads" command. */ | |
| do_cleanups (old_chain); | |
| /* If case we were not able to find the original frame, print the | |
| new selected frame. */ | |
| if (frame_find_by_id (saved_frame_id) == NULL) | |
| { | |
| warning (_("Couldn't restore frame in current thread, at frame 0")); | |
| print_stack_frame (get_selected_frame (NULL), 0, LOCATION); | |
| } | |
| } | |
| /* Switch from one thread to another. */ | |
| static void | |
| switch_to_thread (ptid_t ptid) | |
| { | |
| if (ptid_equal (ptid, inferior_ptid)) | |
| return; | |
| inferior_ptid = ptid; | |
| reinit_frame_cache (); | |
| registers_changed (); | |
| stop_pc = read_pc (); | |
| } | |
| static void | |
| restore_current_thread (ptid_t ptid) | |
| { | |
| if (!ptid_equal (ptid, inferior_ptid)) | |
| { | |
| switch_to_thread (ptid); | |
| } | |
| } | |
| static void | |
| restore_selected_frame (struct frame_id a_frame_id) | |
| { | |
| struct frame_info *selected_frame_info = NULL; | |
| if (frame_id_eq (a_frame_id, null_frame_id)) | |
| return; | |
| if ((selected_frame_info = frame_find_by_id (a_frame_id)) != NULL) | |
| { | |
| select_frame (selected_frame_info); | |
| } | |
| } | |
| struct current_thread_cleanup | |
| { | |
| ptid_t inferior_ptid; | |
| struct frame_id selected_frame_id; | |
| }; | |
| static void | |
| do_restore_current_thread_cleanup (void *arg) | |
| { | |
| struct current_thread_cleanup *old = arg; | |
| restore_current_thread (old->inferior_ptid); | |
| restore_selected_frame (old->selected_frame_id); | |
| xfree (old); | |
| } | |
| static struct cleanup * | |
| make_cleanup_restore_current_thread (ptid_t inferior_ptid, | |
| struct frame_id a_frame_id) | |
| { | |
| struct current_thread_cleanup *old | |
| = xmalloc (sizeof (struct current_thread_cleanup)); | |
| old->inferior_ptid = inferior_ptid; | |
| old->selected_frame_id = a_frame_id; | |
| return make_cleanup (do_restore_current_thread_cleanup, old); | |
| } | |
| /* Apply a GDB command to a list of threads. List syntax is a whitespace | |
| seperated list of numbers, or ranges, or the keyword `all'. Ranges consist | |
| of two numbers seperated by a hyphen. Examples: | |
| thread apply 1 2 7 4 backtrace Apply backtrace cmd to threads 1,2,7,4 | |
| thread apply 2-7 9 p foo(1) Apply p foo(1) cmd to threads 2->7 & 9 | |
| thread apply all p x/i $pc Apply x/i $pc cmd to all threads | |
| */ | |
| static void | |
| thread_apply_all_command (char *cmd, int from_tty) | |
| { | |
| struct thread_info *tp; | |
| struct cleanup *old_chain; | |
| struct cleanup *saved_cmd_cleanup_chain; | |
| char *saved_cmd; | |
| struct frame_id saved_frame_id; | |
| ptid_t current_ptid; | |
| int thread_has_changed = 0; | |
| if (cmd == NULL || *cmd == '\000') | |
| error (_("Please specify a command following the thread ID list")); | |
| current_ptid = inferior_ptid; | |
| saved_frame_id = get_frame_id (get_selected_frame (NULL)); | |
| old_chain = make_cleanup_restore_current_thread (inferior_ptid, saved_frame_id); | |
| /* It is safe to update the thread list now, before | |
| traversing it for "thread apply all". MVS */ | |
| target_find_new_threads (); | |
| /* Save a copy of the command in case it is clobbered by | |
| execute_command */ | |
| saved_cmd = xstrdup (cmd); | |
| saved_cmd_cleanup_chain = make_cleanup (xfree, (void *) saved_cmd); | |
| for (tp = thread_list; tp; tp = tp->next) | |
| if (thread_alive (tp)) | |
| { | |
| switch_to_thread (tp->ptid); | |
| printf_filtered (_("\nThread %d (%s):\n"), | |
| tp->num, target_tid_to_str (inferior_ptid)); | |
| execute_command (cmd, from_tty); | |
| strcpy (cmd, saved_cmd); /* Restore exact command used previously */ | |
| } | |
| if (!ptid_equal (current_ptid, inferior_ptid)) | |
| thread_has_changed = 1; | |
| do_cleanups (saved_cmd_cleanup_chain); | |
| do_cleanups (old_chain); | |
| /* Print stack frame only if we changed thread. */ | |
| if (thread_has_changed) | |
| print_stack_frame (get_current_frame (), 1, SRC_LINE); | |
| } | |
| static void | |
| thread_apply_command (char *tidlist, int from_tty) | |
| { | |
| char *cmd; | |
| char *p; | |
| struct cleanup *old_chain; | |
| struct cleanup *saved_cmd_cleanup_chain; | |
| char *saved_cmd; | |
| struct frame_id saved_frame_id; | |
| ptid_t current_ptid; | |
| int thread_has_changed = 0; | |
| if (tidlist == NULL || *tidlist == '\000') | |
| error (_("Please specify a thread ID list")); | |
| for (cmd = tidlist; *cmd != '\000' && !isalpha (*cmd); cmd++); | |
| if (*cmd == '\000') | |
| error (_("Please specify a command following the thread ID list")); | |
| current_ptid = inferior_ptid; | |
| saved_frame_id = get_frame_id (get_selected_frame (NULL)); | |
| old_chain = make_cleanup_restore_current_thread (inferior_ptid, saved_frame_id); | |
| /* Save a copy of the command in case it is clobbered by | |
| execute_command */ | |
| saved_cmd = xstrdup (cmd); | |
| saved_cmd_cleanup_chain = make_cleanup (xfree, (void *) saved_cmd); | |
| while (tidlist < cmd) | |
| { | |
| struct thread_info *tp; | |
| int start, end; | |
| start = strtol (tidlist, &p, 10); | |
| if (p == tidlist) | |
| error (_("Error parsing %s"), tidlist); | |
| tidlist = p; | |
| while (*tidlist == ' ' || *tidlist == '\t') | |
| tidlist++; | |
| if (*tidlist == '-') /* Got a range of IDs? */ | |
| { | |
| tidlist++; /* Skip the - */ | |
| end = strtol (tidlist, &p, 10); | |
| if (p == tidlist) | |
| error (_("Error parsing %s"), tidlist); | |
| tidlist = p; | |
| while (*tidlist == ' ' || *tidlist == '\t') | |
| tidlist++; | |
| } | |
| else | |
| end = start; | |
| for (; start <= end; start++) | |
| { | |
| tp = find_thread_id (start); | |
| if (!tp) | |
| warning (_("Unknown thread %d."), start); | |
| else if (!thread_alive (tp)) | |
| warning (_("Thread %d has terminated."), start); | |
| else | |
| { | |
| switch_to_thread (tp->ptid); | |
| printf_filtered (_("\nThread %d (%s):\n"), tp->num, | |
| target_tid_to_str (inferior_ptid)); | |
| execute_command (cmd, from_tty); | |
| strcpy (cmd, saved_cmd); /* Restore exact command used previously */ | |
| } | |
| } | |
| } | |
| if (!ptid_equal (current_ptid, inferior_ptid)) | |
| thread_has_changed = 1; | |
| do_cleanups (saved_cmd_cleanup_chain); | |
| do_cleanups (old_chain); | |
| /* Print stack frame only if we changed thread. */ | |
| if (thread_has_changed) | |
| print_stack_frame (get_current_frame (), 1, SRC_LINE); | |
| } | |
| /* Switch to the specified thread. Will dispatch off to thread_apply_command | |
| if prefix of arg is `apply'. */ | |
| static void | |
| thread_command (char *tidstr, int from_tty) | |
| { | |
| if (!tidstr) | |
| { | |
| /* Don't generate an error, just say which thread is current. */ | |
| if (target_has_stack) | |
| printf_filtered (_("[Current thread is %d (%s)]\n"), | |
| pid_to_thread_id (inferior_ptid), | |
| target_tid_to_str (inferior_ptid)); | |
| else | |
| error (_("No stack.")); | |
| return; | |
| } | |
| gdb_thread_select (uiout, tidstr, NULL); | |
| } | |
| static int | |
| do_captured_thread_select (struct ui_out *uiout, void *tidstr) | |
| { | |
| int num; | |
| struct thread_info *tp; | |
| num = value_as_long (parse_and_eval (tidstr)); | |
| tp = find_thread_id (num); | |
| if (!tp) | |
| error (_("Thread ID %d not known."), num); | |
| if (!thread_alive (tp)) | |
| error (_("Thread ID %d has terminated."), num); | |
| switch_to_thread (tp->ptid); | |
| ui_out_text (uiout, "[Switching to thread "); | |
| ui_out_field_int (uiout, "new-thread-id", pid_to_thread_id (inferior_ptid)); | |
| ui_out_text (uiout, " ("); | |
| ui_out_text (uiout, target_tid_to_str (inferior_ptid)); | |
| ui_out_text (uiout, ")]"); | |
| print_stack_frame (get_selected_frame (NULL), 1, SRC_AND_LOC); | |
| return GDB_RC_OK; | |
| } | |
| enum gdb_rc | |
| gdb_thread_select (struct ui_out *uiout, char *tidstr, char **error_message) | |
| { | |
| if (catch_exceptions_with_msg (uiout, do_captured_thread_select, tidstr, | |
| error_message, RETURN_MASK_ALL) < 0) | |
| return GDB_RC_FAIL; | |
| return GDB_RC_OK; | |
| } | |
| /* Commands with a prefix of `thread'. */ | |
| struct cmd_list_element *thread_cmd_list = NULL; | |
| void | |
| _initialize_thread (void) | |
| { | |
| static struct cmd_list_element *thread_apply_list = NULL; | |
| add_info ("threads", info_threads_command, | |
| _("IDs of currently known threads.")); | |
| add_prefix_cmd ("thread", class_run, thread_command, _("\ | |
| Use this command to switch between threads.\n\ | |
| The new thread ID must be currently known."), | |
| &thread_cmd_list, "thread ", 1, &cmdlist); | |
| add_prefix_cmd ("apply", class_run, thread_apply_command, | |
| _("Apply a command to a list of threads."), | |
| &thread_apply_list, "thread apply ", 1, &thread_cmd_list); | |
| add_cmd ("all", class_run, thread_apply_all_command, | |
| _("Apply a command to all threads."), &thread_apply_list); | |
| if (!xdb_commands) | |
| add_com_alias ("t", "thread", class_run, 1); | |
| } |