Commit | Line | Data |
---|---|---|
c906108c | 1 | /* Multi-process/thread control defs for GDB, the GNU debugger. |
197e01b6 | 2 | Copyright (C) 1987, 1988, 1989, 1990, 1991, 1992, 1993, 1997, 1998, 1999, |
9b254dd1 | 3 | 2000, 2007, 2008 Free Software Foundation, Inc. |
b6ba6518 KB |
4 | Contributed by Lynx Real-Time Systems, Inc. Los Gatos, CA. |
5 | ||
c906108c | 6 | |
c5aa993b | 7 | This file is part of GDB. |
c906108c | 8 | |
c5aa993b JM |
9 | This program is free software; you can redistribute it and/or modify |
10 | it under the terms of the GNU General Public License as published by | |
a9762ec7 | 11 | the Free Software Foundation; either version 3 of the License, or |
c5aa993b | 12 | (at your option) any later version. |
c906108c | 13 | |
c5aa993b JM |
14 | This program is distributed in the hope that it will be useful, |
15 | but WITHOUT ANY WARRANTY; without even the implied warranty of | |
16 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
17 | GNU General Public License for more details. | |
c906108c | 18 | |
c5aa993b | 19 | You should have received a copy of the GNU General Public License |
a9762ec7 | 20 | along with this program. If not, see <http://www.gnu.org/licenses/>. */ |
c906108c SS |
21 | |
22 | #ifndef GDBTHREAD_H | |
23 | #define GDBTHREAD_H | |
24 | ||
da3331ec AC |
25 | struct breakpoint; |
26 | struct frame_id; | |
27 | struct symtab; | |
28 | ||
c906108c SS |
29 | /* For bpstat */ |
30 | #include "breakpoint.h" | |
31 | ||
aa0cd9c1 AC |
32 | /* For struct frame_id. */ |
33 | #include "frame.h" | |
34 | ||
0d06e24b JM |
35 | struct thread_info |
36 | { | |
37 | struct thread_info *next; | |
39f77062 | 38 | ptid_t ptid; /* "Actual process id"; |
0d06e24b JM |
39 | In fact, this may be overloaded with |
40 | kernel thread id, etc. */ | |
41 | int num; /* Convenient handle (GDB thread id) */ | |
42 | /* State from wait_for_inferior */ | |
43 | CORE_ADDR prev_pc; | |
0d06e24b | 44 | struct breakpoint *step_resume_breakpoint; |
0d06e24b JM |
45 | CORE_ADDR step_range_start; |
46 | CORE_ADDR step_range_end; | |
aa0cd9c1 | 47 | struct frame_id step_frame_id; |
6c0d3f6a MS |
48 | int current_line; |
49 | struct symtab *current_symtab; | |
0d06e24b JM |
50 | int trap_expected; |
51 | int handling_longjmp; | |
ca67fcb8 | 52 | int stepping_over_breakpoint; |
0d06e24b JM |
53 | |
54 | /* This is set TRUE when a catchpoint of a shared library event | |
55 | triggers. Since we don't wish to leave the inferior in the | |
56 | solib hook when we report the event, we step the inferior | |
57 | back to user code before stopping and reporting the event. */ | |
58 | int stepping_through_solib_after_catch; | |
59 | ||
60 | /* When stepping_through_solib_after_catch is TRUE, this is a | |
61 | list of the catchpoints that should be reported as triggering | |
62 | when we finally do stop stepping. */ | |
63 | bpstat stepping_through_solib_catchpoints; | |
64 | ||
0d06e24b JM |
65 | /* Private data used by the target vector implementation. */ |
66 | struct private_thread_info *private; | |
67 | }; | |
68 | ||
69 | /* Create an empty thread list, or empty the existing one. */ | |
70 | extern void init_thread_list (void); | |
71 | ||
93815fbf VP |
72 | /* Add a thread to the thread list, print a message |
73 | that a new thread is found, and return the pointer to | |
74 | the new thread. Caller my use this pointer to | |
75 | initialize the private thread data. */ | |
39f77062 | 76 | extern struct thread_info *add_thread (ptid_t ptid); |
0d06e24b | 77 | |
93815fbf VP |
78 | /* Same as add_thread, but does not print a message |
79 | about new thread. */ | |
80 | extern struct thread_info *add_thread_silent (ptid_t ptid); | |
81 | ||
0d06e24b | 82 | /* Delete an existing thread list entry. */ |
39f77062 | 83 | extern void delete_thread (ptid_t); |
0d06e24b | 84 | |
8601f500 MS |
85 | /* Delete a step_resume_breakpoint from the thread database. */ |
86 | extern void delete_step_resume_breakpoint (void *); | |
87 | ||
0d06e24b JM |
88 | /* Translate the integer thread id (GDB's homegrown id, not the system's) |
89 | into a "pid" (which may be overloaded with extra thread information). */ | |
39f77062 | 90 | extern ptid_t thread_id_to_pid (int); |
0d06e24b JM |
91 | |
92 | /* Translate a 'pid' (which may be overloaded with extra thread information) | |
93 | into the integer thread id (GDB's homegrown id, not the system's). */ | |
39f77062 | 94 | extern int pid_to_thread_id (ptid_t ptid); |
0d06e24b JM |
95 | |
96 | /* Boolean test for an already-known pid (which may be overloaded with | |
97 | extra thread information). */ | |
39f77062 | 98 | extern int in_thread_list (ptid_t ptid); |
0d06e24b JM |
99 | |
100 | /* Boolean test for an already-known thread id (GDB's homegrown id, | |
101 | not the system's). */ | |
102 | extern int valid_thread_id (int thread); | |
103 | ||
104 | /* Search function to lookup a thread by 'pid'. */ | |
39f77062 | 105 | extern struct thread_info *find_thread_pid (ptid_t ptid); |
0d06e24b JM |
106 | |
107 | /* Iterator function to call a user-provided callback function | |
108 | once for each known thread. */ | |
109 | typedef int (*thread_callback_func) (struct thread_info *, void *); | |
110 | extern struct thread_info *iterate_over_threads (thread_callback_func, void *); | |
111 | ||
112 | /* infrun context switch: save the debugger state for the given thread. */ | |
39f77062 | 113 | extern void save_infrun_state (ptid_t ptid, |
0d06e24b | 114 | CORE_ADDR prev_pc, |
0d06e24b JM |
115 | int trap_expected, |
116 | struct breakpoint *step_resume_breakpoint, | |
0d06e24b JM |
117 | CORE_ADDR step_range_start, |
118 | CORE_ADDR step_range_end, | |
aa0cd9c1 | 119 | const struct frame_id *step_frame_id, |
0d06e24b JM |
120 | int handling_longjmp, |
121 | int another_trap, | |
122 | int stepping_through_solib_after_catch, | |
123 | bpstat stepping_through_solib_catchpoints, | |
6c0d3f6a | 124 | int current_line, |
f2c9ca08 | 125 | struct symtab *current_symtab); |
0d06e24b JM |
126 | |
127 | /* infrun context switch: load the debugger state previously saved | |
128 | for the given thread. */ | |
39f77062 | 129 | extern void load_infrun_state (ptid_t ptid, |
0d06e24b | 130 | CORE_ADDR *prev_pc, |
0d06e24b JM |
131 | int *trap_expected, |
132 | struct breakpoint **step_resume_breakpoint, | |
0d06e24b JM |
133 | CORE_ADDR *step_range_start, |
134 | CORE_ADDR *step_range_end, | |
aa0cd9c1 | 135 | struct frame_id *step_frame_id, |
0d06e24b JM |
136 | int *handling_longjmp, |
137 | int *another_trap, | |
138 | int *stepping_through_solib_affter_catch, | |
139 | bpstat *stepping_through_solib_catchpoints, | |
6c0d3f6a | 140 | int *current_line, |
f2c9ca08 | 141 | struct symtab **current_symtab); |
c906108c | 142 | |
6a6b96b9 UW |
143 | /* Switch from one thread to another. */ |
144 | extern void switch_to_thread (ptid_t ptid); | |
145 | ||
c906108c SS |
146 | /* Commands with a prefix of `thread'. */ |
147 | extern struct cmd_list_element *thread_cmd_list; | |
148 | ||
93815fbf VP |
149 | /* Print notices on thread events (attach, detach, etc.), set with |
150 | `set print thread-events'. */ | |
151 | extern int print_thread_events; | |
152 | ||
c5aa993b | 153 | #endif /* GDBTHREAD_H */ |