| 1 | /* Common things used by the various *gnu-nat.c files |
| 2 | Copyright (C) 1995-2019 Free Software Foundation, Inc. |
| 3 | |
| 4 | Written by Miles Bader <miles@gnu.ai.mit.edu> |
| 5 | |
| 6 | This program is free software; you can redistribute it and/or modify |
| 7 | it under the terms of the GNU General Public License as published by |
| 8 | the Free Software Foundation; either version 3 of the License, or |
| 9 | (at your option) any later version. |
| 10 | |
| 11 | This program is distributed in the hope that it will be useful, |
| 12 | but WITHOUT ANY WARRANTY; without even the implied warranty of |
| 13 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| 14 | GNU General Public License for more details. |
| 15 | |
| 16 | You should have received a copy of the GNU General Public License |
| 17 | along with this program. If not, see <http://www.gnu.org/licenses/>. */ |
| 18 | |
| 19 | #ifndef GNU_NAT_H |
| 20 | #define GNU_NAT_H |
| 21 | |
| 22 | #include "defs.h" |
| 23 | |
| 24 | /* Work around conflict between Mach's 'thread_info' function, and GDB's |
| 25 | 'thread_info' class. Make the former available as 'mach_thread_info'. */ |
| 26 | #define thread_info mach_thread_info |
| 27 | /* Mach headers are not yet ready for C++ compilation. */ |
| 28 | extern "C" |
| 29 | { |
| 30 | #include <mach.h> |
| 31 | } |
| 32 | #undef thread_info |
| 33 | /* Divert 'mach_thread_info' to the original Mach 'thread_info' function. */ |
| 34 | extern __typeof__ (mach_thread_info) mach_thread_info asm ("thread_info"); |
| 35 | |
| 36 | #include <unistd.h> |
| 37 | |
| 38 | #include "inf-child.h" |
| 39 | |
| 40 | struct inf; |
| 41 | |
| 42 | extern struct inf *gnu_current_inf; |
| 43 | |
| 44 | /* Converts a GDB pid to a struct proc. */ |
| 45 | struct proc *inf_tid_to_thread (struct inf *inf, int tid); |
| 46 | |
| 47 | typedef void (inf_threads_ftype) (struct proc *thread, void *arg); |
| 48 | |
| 49 | /* Call F for every thread in inferior INF, passing ARG as second parameter. */ |
| 50 | void inf_threads (struct inf *inf, inf_threads_ftype *f, void *arg); |
| 51 | |
| 52 | /* Makes sure that INF's thread list is synced with the actual process. */ |
| 53 | int inf_update_procs (struct inf *inf); |
| 54 | |
| 55 | /* A proc is either a thread, or the task (there can only be one task proc |
| 56 | because it always has the same TID, PROC_TID_TASK). */ |
| 57 | struct proc |
| 58 | { |
| 59 | thread_t port; /* The task or thread port. */ |
| 60 | int tid; /* The GDB pid (actually a thread id). */ |
| 61 | int num; /* An id number for threads, to print. */ |
| 62 | |
| 63 | mach_port_t saved_exc_port; /* The task/thread's real exception port. */ |
| 64 | mach_port_t exc_port; /* Our replacement, which for. */ |
| 65 | |
| 66 | int sc; /* Desired suspend count. */ |
| 67 | int cur_sc; /* Implemented suspend count. */ |
| 68 | int run_sc; /* Default sc when the program is running. */ |
| 69 | int pause_sc; /* Default sc when gdb has control. */ |
| 70 | int resume_sc; /* Sc resulting from the last resume. */ |
| 71 | int detach_sc; /* SC to leave around when detaching |
| 72 | from program. */ |
| 73 | |
| 74 | thread_state_data_t state; /* Registers, &c. */ |
| 75 | int state_valid:1; /* True if STATE is up to date. */ |
| 76 | int state_changed:1; |
| 77 | |
| 78 | int aborted:1; /* True if thread_abort has been called. */ |
| 79 | int dead:1; /* We happen to know it's actually dead. */ |
| 80 | |
| 81 | /* Bit mask of registers fetched by gdb. This is used when we re-fetch |
| 82 | STATE after aborting the thread, to detect that gdb may have out-of-date |
| 83 | information. */ |
| 84 | unsigned long fetched_regs; |
| 85 | |
| 86 | struct inf *inf; /* Where we come from. */ |
| 87 | |
| 88 | struct proc *next; |
| 89 | }; |
| 90 | |
| 91 | /* The task has a thread entry with this TID. */ |
| 92 | #define PROC_TID_TASK (-1) |
| 93 | |
| 94 | #define proc_is_task(proc) ((proc)->tid == PROC_TID_TASK) |
| 95 | #define proc_is_thread(proc) ((proc)->tid != PROC_TID_TASK) |
| 96 | |
| 97 | extern int __proc_pid (struct proc *proc); |
| 98 | |
| 99 | /* Make sure that the state field in PROC is up to date, and return a |
| 100 | pointer to it, or 0 if something is wrong. If WILL_MODIFY is true, |
| 101 | makes sure that the thread is stopped and aborted first, and sets |
| 102 | the state_changed field in PROC to true. */ |
| 103 | extern thread_state_t proc_get_state (struct proc *proc, int will_modify); |
| 104 | |
| 105 | /* Return printable description of proc. */ |
| 106 | extern char *proc_string (struct proc *proc); |
| 107 | |
| 108 | #define proc_debug(_proc, msg, args...) \ |
| 109 | do { struct proc *__proc = (_proc); \ |
| 110 | debug ("{proc %d/%d %s}: " msg, \ |
| 111 | __proc_pid (__proc), __proc->tid, \ |
| 112 | host_address_to_string (__proc) , ##args); } while (0) |
| 113 | |
| 114 | extern int gnu_debug_flag; |
| 115 | |
| 116 | #define debug(msg, args...) \ |
| 117 | do { if (gnu_debug_flag) \ |
| 118 | fprintf_unfiltered (gdb_stdlog, "%s:%d: " msg "\r\n", \ |
| 119 | __FILE__ , __LINE__ , ##args); } while (0) |
| 120 | |
| 121 | /* A prototype generic GNU/Hurd target. The client can override it |
| 122 | with local methods. */ |
| 123 | |
| 124 | struct gnu_nat_target : public inf_child_target |
| 125 | { |
| 126 | void attach (const char *, int) override; |
| 127 | bool attach_no_wait () override |
| 128 | { return true; } |
| 129 | |
| 130 | void detach (inferior *, int) override; |
| 131 | void resume (ptid_t, int, enum gdb_signal) override; |
| 132 | |
| 133 | ptid_t wait (ptid_t, struct target_waitstatus *, int) override; |
| 134 | enum target_xfer_status xfer_partial (enum target_object object, |
| 135 | const char *annex, |
| 136 | gdb_byte *readbuf, |
| 137 | const gdb_byte *writebuf, |
| 138 | ULONGEST offset, ULONGEST len, |
| 139 | ULONGEST *xfered_len) override; |
| 140 | |
| 141 | int find_memory_regions (find_memory_region_ftype func, void *data) |
| 142 | override; |
| 143 | void kill () override; |
| 144 | |
| 145 | void create_inferior (const char *, const std::string &, |
| 146 | char **, int) override; |
| 147 | void mourn_inferior () override; |
| 148 | bool thread_alive (ptid_t ptid) override; |
| 149 | std::string pid_to_str (ptid_t) override; |
| 150 | void stop (ptid_t) override; |
| 151 | }; |
| 152 | |
| 153 | #endif /* GNU_NAT_H */ |