1 /* Common things used by the various darwin files
2 Copyright (C) 1995-2019 Free Software Foundation, Inc.
4 This program is free software; you can redistribute it and/or modify
5 it under the terms of the GNU General Public License as published by
6 the Free Software Foundation; either version 3 of the License, or
7 (at your option) any later version.
9 This program is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 GNU General Public License for more details.
14 You should have received a copy of the GNU General Public License
15 along with this program. If not, see <http://www.gnu.org/licenses/>. */
20 #include "inf-child.h"
21 #include <mach/mach.h>
22 #include "gdbthread.h"
24 /* This needs to be overridden by the platform specific nat code. */
26 class darwin_nat_target : public inf_child_target
28 void create_inferior (const char *exec_file,
29 const std::string &allargs,
30 char **env, int from_tty) override;
32 void attach (const char *, int) override;
34 void detach (inferior *, int) override;
36 ptid_t wait (ptid_t, struct target_waitstatus *, int) override;
38 void mourn_inferior () override;
40 void kill () override;
42 void interrupt () override;
44 void resume (ptid_t, int , enum gdb_signal) override;
46 bool thread_alive (ptid_t ptid) override;
48 const char *pid_to_str (ptid_t) override;
50 char *pid_to_exec_file (int pid) override;
52 enum target_xfer_status xfer_partial (enum target_object object,
55 const gdb_byte *writebuf,
56 ULONGEST offset, ULONGEST len,
57 ULONGEST *xfered_len) override;
59 bool supports_multi_process () override;
61 ptid_t get_ada_task_ptid (long lwp, long thread) override;
64 /* Describe the mach exception handling state for a task. This state is saved
65 before being changed and restored when a process is detached.
66 For more information on these fields see task_get_exception_ports manual
68 struct darwin_exception_info
70 /* Exceptions handled by the port. */
71 exception_mask_t masks[EXC_TYPES_COUNT] {};
73 /* Ports receiving exception messages. */
74 mach_port_t ports[EXC_TYPES_COUNT] {};
76 /* Type of messages sent. */
77 exception_behavior_t behaviors[EXC_TYPES_COUNT] {};
79 /* Type of state to be sent. */
80 thread_state_flavor_t flavors[EXC_TYPES_COUNT] {};
82 /* Number of elements set. */
83 mach_msg_type_number_t count = 0;
86 struct darwin_exception_msg
88 mach_msg_header_t header;
90 /* Thread and task taking the exception. */
91 mach_port_t thread_port;
92 mach_port_t task_port;
94 /* Type of the exception. */
95 exception_type_t ex_type;
97 /* Machine dependent details. */
98 mach_msg_type_number_t data_count;
102 enum darwin_msg_state
104 /* The thread is running. */
107 /* The thread is stopped. */
110 /* The thread has sent a message and waits for a reply. */
114 struct darwin_thread_info : public private_thread_info
116 /* The thread port from a GDB point of view. */
117 thread_t gdb_port = 0;
119 /* The thread port from the inferior point of view. Not to be used inside
120 gdb except for get_ada_task_ptid. */
121 thread_t inf_port = 0;
123 /* Current message state.
124 If the kernel has sent a message it expects a reply and the inferior
125 can't be killed before. */
126 enum darwin_msg_state msg_state = DARWIN_RUNNING;
128 /* True if this thread is single-stepped. */
129 bool single_step = false;
131 /* True if a signal was manually sent to the thread. */
132 bool signaled = false;
134 /* The last exception received. */
135 struct darwin_exception_msg event {};
137 typedef struct darwin_thread_info darwin_thread_t;
139 static inline darwin_thread_info *
140 get_darwin_thread_info (class thread_info *thread)
142 return static_cast<darwin_thread_info *> (thread->priv.get ());
145 /* Describe an inferior. */
146 struct darwin_inferior : public private_inferior
148 /* Corresponding task port. */
151 /* Port which will receive the dead-name notification for the task port.
152 This is used to detect the death of the task. */
153 mach_port_t notify_port = 0;
155 /* Initial exception handling. */
156 darwin_exception_info exception_info;
158 /* Number of messages that have been received but not yet replied. */
159 unsigned int pending_messages = 0;
161 /* Set if inferior is not controlled by ptrace(2) but through Mach. */
162 bool no_ptrace = false;
164 /* True if this task is suspended. */
165 bool suspended = false;
167 /* Sorted vector of known threads. */
168 std::vector<darwin_thread_t *> threads;
171 /* Return the darwin_inferior attached to INF. */
173 static inline darwin_inferior *
174 get_darwin_inferior (inferior *inf)
176 return static_cast<darwin_inferior *> (inf->priv.get ());
179 /* Exception port. */
180 extern mach_port_t darwin_ex_port;
183 extern mach_port_t darwin_port_set;
185 /* A copy of mach_host_self (). */
186 extern mach_port_t darwin_host_self;
188 /* FUNCTION_NAME is defined in common-utils.h (or not). */
190 #define MACH_CHECK_ERROR(ret) \
191 mach_check_error (ret, __FILE__, __LINE__, FUNCTION_NAME)
193 #define MACH_CHECK_ERROR(ret) \
194 mach_check_error (ret, __FILE__, __LINE__, "??")
197 extern void mach_check_error (kern_return_t ret, const char *file,
198 unsigned int line, const char *func);
200 void darwin_set_sstep (thread_t thread, int enable);
202 void darwin_check_osabi (darwin_inferior *inf, thread_t thread);
204 #endif /* DARWIN_NAT_H */