]> git.ipfire.org Git - thirdparty/binutils-gdb.git/blame - gdb/darwin-nat.h
gdb/copyright.py: Remove testsuite/gdb.base/step-line.{c,inp} special handling
[thirdparty/binutils-gdb.git] / gdb / darwin-nat.h
CommitLineData
a80b95ba 1/* Common things used by the various darwin files
61baf725 2 Copyright (C) 1995-2017 Free Software Foundation, Inc.
a80b95ba
TG
3
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.
8
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.
13
14 You should have received a copy of the GNU General Public License
47d48711 15 along with this program. If not, see <http://www.gnu.org/licenses/>. */
a80b95ba
TG
16
17#ifndef __DARWIN_NAT_H__
18#define __DARWIN_NAT_H__
19
20#include <mach/mach.h>
7aabaf9d 21#include "gdbthread.h"
a80b95ba 22
a80b95ba
TG
23/* Describe the mach exception handling state for a task. This state is saved
24 before being changed and restored when a process is detached.
25 For more information on these fields see task_get_exception_ports manual
26 page. */
27struct darwin_exception_info
28{
29 /* Exceptions handled by the port. */
089354bb 30 exception_mask_t masks[EXC_TYPES_COUNT] {};
a80b95ba
TG
31
32 /* Ports receiving exception messages. */
089354bb 33 mach_port_t ports[EXC_TYPES_COUNT] {};
a80b95ba
TG
34
35 /* Type of messages sent. */
089354bb 36 exception_behavior_t behaviors[EXC_TYPES_COUNT] {};
a80b95ba
TG
37
38 /* Type of state to be sent. */
089354bb 39 thread_state_flavor_t flavors[EXC_TYPES_COUNT] {};
a80b95ba
TG
40
41 /* Number of elements set. */
089354bb 42 mach_msg_type_number_t count = 0;
a80b95ba 43};
a80b95ba 44
bb00b29d 45struct darwin_exception_msg
a80b95ba 46{
bb00b29d
TG
47 mach_msg_header_t header;
48
49 /* Thread and task taking the exception. */
50 mach_port_t thread_port;
51 mach_port_t task_port;
52
53 /* Type of the exception. */
54 exception_type_t ex_type;
55
56 /* Machine dependent details. */
57 mach_msg_type_number_t data_count;
58 integer_t ex_data[2];
59};
60
637fd620
TG
61enum darwin_msg_state
62{
63 /* The thread is running. */
64 DARWIN_RUNNING,
65
66 /* The thread is stopped. */
67 DARWIN_STOPPED,
68
69 /* The thread has sent a message and waits for a reply. */
70 DARWIN_MESSAGE
71};
bb00b29d 72
7aabaf9d 73struct darwin_thread_info : public private_thread_info
bb00b29d
TG
74{
75 /* The thread port from a GDB point of view. */
76 thread_t gdb_port;
77
78 /* The thread port from the inferior point of view. Not to be used inside
79 gdb except for get_ada_task_ptid. */
80 thread_t inf_port;
81
82 /* Current message state.
83 If the kernel has sent a message it expects a reply and the inferior
84 can't be killed before. */
85 enum darwin_msg_state msg_state;
86
87 /* True if this thread is single-stepped. */
88 unsigned char single_step;
a80b95ba 89
bb00b29d
TG
90 /* True if a signal was manually sent to the thread. */
91 unsigned char signaled;
92
93 /* The last exception received. */
94 struct darwin_exception_msg event;
95};
7aabaf9d
SM
96typedef struct darwin_thread_info darwin_thread_t;
97
98static inline darwin_thread_info *
99get_darwin_thread_info (class thread_info *thread)
100{
101 return static_cast<darwin_thread_info *> (thread->priv.get ());
102}
bb00b29d 103
bb00b29d 104/* Describe an inferior. */
089354bb 105struct darwin_inferior : public private_inferior
bb00b29d 106{
a80b95ba 107 /* Corresponding task port. */
089354bb 108 task_t task = 0;
a80b95ba 109
bb00b29d
TG
110 /* Port which will receive the dead-name notification for the task port.
111 This is used to detect the death of the task. */
089354bb 112 mach_port_t notify_port = 0;
a80b95ba
TG
113
114 /* Initial exception handling. */
115 darwin_exception_info exception_info;
116
bb00b29d 117 /* Number of messages that have been received but not yet replied. */
089354bb 118 unsigned int pending_messages = 0;
bb00b29d
TG
119
120 /* Set if inferior is not controlled by ptrace(2) but through Mach. */
089354bb 121 bool no_ptrace = false;
bb00b29d
TG
122
123 /* True if this task is suspended. */
089354bb 124 bool suspended = false;
bb00b29d 125
a80b95ba 126 /* Sorted vector of known threads. */
089354bb 127 std::vector<darwin_thread_t *> threads;
a80b95ba 128};
089354bb
SM
129
130/* Return the darwin_inferior attached to INF. */
131
132static inline darwin_inferior *
133get_darwin_inferior (inferior *inf)
134{
135 return static_cast<darwin_inferior *> (inf->priv.get ());
136}
a80b95ba
TG
137
138/* Exception port. */
139extern mach_port_t darwin_ex_port;
140
a80b95ba
TG
141/* Port set. */
142extern mach_port_t darwin_port_set;
143
144/* A copy of mach_host_self (). */
145extern mach_port_t darwin_host_self;
146
df049a58
DE
147/* FUNCTION_NAME is defined in common-utils.h (or not). */
148#ifdef FUNCTION_NAME
a80b95ba 149#define MACH_CHECK_ERROR(ret) \
df049a58 150 mach_check_error (ret, __FILE__, __LINE__, FUNCTION_NAME)
a80b95ba
TG
151#else
152#define MACH_CHECK_ERROR(ret) \
153 mach_check_error (ret, __FILE__, __LINE__, "??")
154#endif
155
156extern void mach_check_error (kern_return_t ret, const char *file,
157 unsigned int line, const char *func);
158
159void darwin_set_sstep (thread_t thread, int enable);
160
161/* This one is called in darwin-nat.c, but needs to be provided by the
162 platform specific nat code. It allows each platform to add platform specific
163 stuff to the darwin_ops. */
164extern void darwin_complete_target (struct target_ops *target);
165
166void darwin_check_osabi (darwin_inferior *inf, thread_t thread);
167
168#endif /* __DARWIN_NAT_H__ */