1 /* Darwin support for GDB, the GNU debugger.
2 Copyright (C) 2008-2019 Free Software Foundation, Inc.
4 Contributed by AdaCore.
6 This file is part of GDB.
8 This program is free software; you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation; either version 3 of the License, or
11 (at your option) any later version.
13 This program is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with this program. If not, see <http://www.gnu.org/licenses/>. */
30 #include "gdbthread.h"
32 #include "event-top.h"
35 #include "inf-child.h"
37 #include "arch-utils.h"
39 #include "bfd/mach-o.h"
42 #include <sys/ptrace.h>
43 #include <sys/signal.h>
45 #include <sys/types.h>
49 #include <sys/sysctl.h>
52 #include <sys/syscall.h>
55 #include <mach/mach_error.h>
56 #include <mach/mach_vm.h>
57 #include <mach/mach_init.h>
58 #include <mach/vm_map.h>
59 #include <mach/task.h>
60 #include <mach/mach_port.h>
61 #include <mach/thread_act.h>
62 #include <mach/port.h>
64 #include "darwin-nat.h"
65 #include "filenames.h"
66 #include "common/filestuff.h"
67 #include "common/gdb_unlinker.h"
68 #include "common/pathstuff.h"
69 #include "common/scoped_fd.h"
70 #include "nat/fork-inferior.h"
73 Darwin kernel is Mach + BSD derived kernel. Note that they share the
74 same memory space and are linked together (ie there is no micro-kernel).
76 Although ptrace(2) is available on Darwin, it is not complete. We have
77 to use Mach calls to read and write memory and to modify registers. We
78 also use Mach to get inferior faults. As we cannot use select(2) or
79 signals with Mach port (the Mach communication channel), signals are
80 reported to gdb as an exception. Furthermore we detect death of the
81 inferior through a Mach notification message. This way we only wait
84 Some Mach documentation is available for Apple xnu source package or
88 #define PTRACE(CMD, PID, ADDR, SIG) \
89 darwin_ptrace(#CMD, CMD, (PID), (ADDR), (SIG))
91 static ptid_t darwin_wait (ptid_t ptid, struct target_waitstatus *status);
93 static void darwin_ptrace_me (void);
95 static void darwin_ptrace_him (int pid);
97 static void darwin_encode_reply (mig_reply_error_t *reply,
98 mach_msg_header_t *hdr, integer_t code);
100 static void darwin_setup_request_notification (struct inferior *inf);
101 static void darwin_deallocate_exception_ports (darwin_inferior *inf);
102 static void darwin_setup_exceptions (struct inferior *inf);
103 static void darwin_deallocate_threads (struct inferior *inf);
105 /* Task identifier of gdb. */
106 static task_t gdb_task;
108 /* A copy of mach_host_self (). */
109 mach_port_t darwin_host_self;
111 /* Exception port. */
112 mach_port_t darwin_ex_port;
114 /* Port set, to wait for answer on all ports. */
115 mach_port_t darwin_port_set;
118 static vm_size_t mach_page_size;
120 /* If Set, catch all mach exceptions (before they are converted to signals
122 static int enable_mach_exceptions;
124 /* Inferior that should report a fake stop event. */
125 static struct inferior *darwin_inf_fake_stop;
127 /* If non-NULL, the shell we actually invoke. See maybe_cache_shell
129 static const char *copied_shell;
131 #define PAGE_TRUNC(x) ((x) & ~(mach_page_size - 1))
132 #define PAGE_ROUND(x) PAGE_TRUNC((x) + mach_page_size - 1)
134 /* This controls output of inferior debugging. */
135 static unsigned int darwin_debug_flag = 0;
137 /* Create a __TEXT __info_plist section in the executable so that gdb could
138 be signed. This is required to get an authorization for task_for_pid.
140 Once gdb is built, you must codesign it with any system-trusted signing
141 authority. See taskgated(8) for details. */
142 static const unsigned char info_plist[]
143 __attribute__ ((section ("__TEXT,__info_plist"),used)) =
144 "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n"
145 "<!DOCTYPE plist PUBLIC \"-//Apple Computer//DTD PLIST 1.0//EN\""
146 " \"http://www.apple.com/DTDs/PropertyList-1.0.dtd\">\n"
147 "<plist version=\"1.0\">\n"
149 " <key>CFBundleIdentifier</key>\n"
150 " <string>org.gnu.gdb</string>\n"
151 " <key>CFBundleName</key>\n"
152 " <string>gdb</string>\n"
153 " <key>CFBundleVersion</key>\n"
154 " <string>1.0</string>\n"
155 " <key>SecTaskAccess</key>\n"
157 " <string>allowed</string>\n"
158 " <string>debug</string>\n"
163 static void inferior_debug (int level, const char *fmt, ...)
164 ATTRIBUTE_PRINTF (2, 3);
167 inferior_debug (int level, const char *fmt, ...)
171 if (darwin_debug_flag < level)
175 printf_unfiltered (_("[%d inferior]: "), getpid ());
176 vprintf_unfiltered (fmt, ap);
181 mach_check_error (kern_return_t ret, const char *file,
182 unsigned int line, const char *func)
184 if (ret == KERN_SUCCESS)
187 func = _("[UNKNOWN]");
189 warning (_("Mach error at \"%s:%u\" in function \"%s\": %s (0x%lx)"),
190 file, line, func, mach_error_string (ret), (unsigned long) ret);
194 unparse_exception_type (unsigned int i)
196 static char unknown_exception_buf[32];
201 return "EXC_BAD_ACCESS";
202 case EXC_BAD_INSTRUCTION:
203 return "EXC_BAD_INSTRUCTION";
205 return "EXC_ARITHMETIC";
207 return "EXC_EMULATION";
209 return "EXC_SOFTWARE";
211 return "EXC_BREAKPOINT";
213 return "EXC_SYSCALL";
214 case EXC_MACH_SYSCALL:
215 return "EXC_MACH_SYSCALL";
217 return "EXC_RPC_ALERT";
221 snprintf (unknown_exception_buf, 32, _("unknown (%d)"), i);
222 return unknown_exception_buf;
226 /* Set errno to zero, and then call ptrace with the given arguments.
227 If inferior debugging traces are on, then also print a debug
230 The returned value is the same as the value returned by ptrace,
231 except in the case where that value is -1 but errno is zero.
232 This case is documented to be a non-error situation, so we
233 return zero in that case. */
236 darwin_ptrace (const char *name,
237 int request, int pid, caddr_t arg3, int arg4)
242 ret = ptrace (request, pid, arg3, arg4);
243 if (ret == -1 && errno == 0)
246 inferior_debug (4, _("ptrace (%s, %d, 0x%lx, %d): %d (%s)\n"),
247 name, pid, (unsigned long) arg3, arg4, ret,
248 (ret != 0) ? safe_strerror (errno) : _("no error"));
253 cmp_thread_t (const void *l, const void *r)
255 thread_t tl = *(const thread_t *)l;
256 thread_t tr = *(const thread_t *)r;
257 return (int)(tl - tr);
261 darwin_check_new_threads (struct inferior *inf)
264 thread_array_t thread_list;
265 unsigned int new_nbr;
266 unsigned int old_nbr;
267 unsigned int new_ix, old_ix;
268 darwin_inferior *darwin_inf = get_darwin_inferior (inf);
269 std::vector<darwin_thread_t *> new_thread_vec;
271 if (darwin_inf == nullptr)
274 /* Get list of threads. */
275 kret = task_threads (darwin_inf->task, &thread_list, &new_nbr);
276 MACH_CHECK_ERROR (kret);
277 if (kret != KERN_SUCCESS)
282 qsort (thread_list, new_nbr, sizeof (thread_t), cmp_thread_t);
284 old_nbr = darwin_inf->threads.size ();
286 /* Quick check for no changes. */
287 if (old_nbr == new_nbr)
291 for (i = 0; i < new_nbr; i++)
292 if (thread_list[i] != darwin_inf->threads[i]->gdb_port)
296 /* Deallocate ports. */
297 for (i = 0; i < new_nbr; i++)
299 kret = mach_port_deallocate (mach_task_self (), thread_list[i]);
300 MACH_CHECK_ERROR (kret);
303 /* Deallocate the buffer. */
304 kret = vm_deallocate (gdb_task, (vm_address_t) thread_list,
305 new_nbr * sizeof (int));
306 MACH_CHECK_ERROR (kret);
312 /* Full handling: detect new threads, remove dead threads. */
314 new_thread_vec.reserve (new_nbr);
316 for (new_ix = 0, old_ix = 0; new_ix < new_nbr || old_ix < old_nbr;)
318 thread_t new_id = (new_ix < new_nbr) ? thread_list[new_ix] : THREAD_NULL;
320 = (old_ix < old_nbr) ? darwin_inf->threads[old_ix] : NULL;
321 thread_t old_id = old != NULL ? old->gdb_port : THREAD_NULL;
324 (12, _(" new_ix:%d/%d, old_ix:%d/%d, new_id:0x%x old_id:0x%x\n"),
325 new_ix, new_nbr, old_ix, old_nbr, new_id, old_id);
327 if (old_id == new_id)
329 /* Thread still exist. */
330 new_thread_vec.push_back (old);
334 /* Deallocate the port. */
335 kret = mach_port_deallocate (gdb_task, new_id);
336 MACH_CHECK_ERROR (kret);
340 if (new_ix < new_nbr && new_id == MACH_PORT_DEAD)
342 /* Ignore dead ports.
343 In some weird cases, we might get dead ports. They should
344 correspond to dead thread so they could safely be ignored. */
348 if (new_ix < new_nbr && (old_ix == old_nbr || new_id < old_id))
350 /* A thread was created. */
351 darwin_thread_info *pti = new darwin_thread_info;
353 pti->gdb_port = new_id;
354 pti->msg_state = DARWIN_RUNNING;
356 /* Add the new thread. */
357 add_thread_with_info (ptid_t (inf->pid, 0, new_id), pti);
358 new_thread_vec.push_back (pti);
362 if (old_ix < old_nbr && (new_ix == new_nbr || new_id > old_id))
364 /* A thread was removed. */
365 struct thread_info *thr
366 = find_thread_ptid (ptid_t (inf->pid, 0, old_id));
368 kret = mach_port_deallocate (gdb_task, old_id);
369 MACH_CHECK_ERROR (kret);
373 gdb_assert_not_reached ("unexpected thread case");
376 darwin_inf->threads = std::move (new_thread_vec);
378 /* Deallocate the buffer. */
379 kret = vm_deallocate (gdb_task, (vm_address_t) thread_list,
380 new_nbr * sizeof (int));
381 MACH_CHECK_ERROR (kret);
385 find_inferior_task_it (struct inferior *inf, void *port_ptr)
387 darwin_inferior *priv = get_darwin_inferior (inf);
389 return priv != nullptr && priv->task == *(task_t *)port_ptr;
393 find_inferior_pid_it (struct inferior *inf, void *pid_ptr)
395 return inf->pid == *(int *)pid_ptr;
398 /* Return an inferior by task port. */
399 static struct inferior *
400 darwin_find_inferior_by_task (task_t port)
402 return iterate_over_inferiors (&find_inferior_task_it, &port);
405 /* Return an inferior by pid port. */
406 static struct inferior *
407 darwin_find_inferior_by_pid (int pid)
409 return iterate_over_inferiors (&find_inferior_pid_it, &pid);
412 /* Return a thread by port. */
413 static darwin_thread_t *
414 darwin_find_thread (struct inferior *inf, thread_t thread)
416 darwin_inferior *priv = get_darwin_inferior (inf);
419 for (darwin_thread_t *t : priv->threads)
421 if (t->gdb_port == thread)
428 /* Suspend (ie stop) an inferior at Mach level. */
431 darwin_suspend_inferior (struct inferior *inf)
433 darwin_inferior *priv = get_darwin_inferior (inf);
435 if (priv != nullptr && !priv->suspended)
439 kret = task_suspend (priv->task);
440 MACH_CHECK_ERROR (kret);
446 /* Resume an inferior at Mach level. */
449 darwin_resume_inferior (struct inferior *inf)
451 darwin_inferior *priv = get_darwin_inferior (inf);
453 if (priv != nullptr && priv->suspended)
457 kret = task_resume (priv->task);
458 MACH_CHECK_ERROR (kret);
464 /* Iterator functions. */
467 darwin_suspend_inferior_it (struct inferior *inf, void *arg)
469 darwin_suspend_inferior (inf);
470 darwin_check_new_threads (inf);
475 darwin_resume_inferior_it (struct inferior *inf, void *arg)
477 darwin_resume_inferior (inf);
482 darwin_dump_message (mach_msg_header_t *hdr, int disp_body)
484 printf_unfiltered (_("message header:\n"));
485 printf_unfiltered (_(" bits: 0x%x\n"), hdr->msgh_bits);
486 printf_unfiltered (_(" size: 0x%x\n"), hdr->msgh_size);
487 printf_unfiltered (_(" remote-port: 0x%x\n"), hdr->msgh_remote_port);
488 printf_unfiltered (_(" local-port: 0x%x\n"), hdr->msgh_local_port);
489 printf_unfiltered (_(" reserved: 0x%x\n"), hdr->msgh_reserved);
490 printf_unfiltered (_(" id: 0x%x\n"), hdr->msgh_id);
494 const unsigned char *data;
495 const unsigned int *ldata;
499 data = (unsigned char *)(hdr + 1);
500 size = hdr->msgh_size - sizeof (mach_msg_header_t);
502 if (hdr->msgh_bits & MACH_MSGH_BITS_COMPLEX)
504 mach_msg_body_t *bod = (mach_msg_body_t*)data;
505 mach_msg_port_descriptor_t *desc =
506 (mach_msg_port_descriptor_t *)(bod + 1);
509 printf_unfiltered (_("body: descriptor_count=%u\n"),
510 bod->msgh_descriptor_count);
511 data += sizeof (mach_msg_body_t);
512 size -= sizeof (mach_msg_body_t);
513 for (k = 0; k < bod->msgh_descriptor_count; k++)
514 switch (desc[k].type)
516 case MACH_MSG_PORT_DESCRIPTOR:
518 (_(" descr %d: type=%u (port) name=0x%x, dispo=%d\n"),
519 k, desc[k].type, desc[k].name, desc[k].disposition);
522 printf_unfiltered (_(" descr %d: type=%u\n"),
526 data += bod->msgh_descriptor_count
527 * sizeof (mach_msg_port_descriptor_t);
528 size -= bod->msgh_descriptor_count
529 * sizeof (mach_msg_port_descriptor_t);
530 ndr = (NDR_record_t *)(desc + bod->msgh_descriptor_count);
532 (_("NDR: mig=%02x if=%02x encod=%02x "
533 "int=%02x char=%02x float=%02x\n"),
534 ndr->mig_vers, ndr->if_vers, ndr->mig_encoding,
535 ndr->int_rep, ndr->char_rep, ndr->float_rep);
536 data += sizeof (NDR_record_t);
537 size -= sizeof (NDR_record_t);
540 printf_unfiltered (_(" data:"));
541 ldata = (const unsigned int *)data;
542 for (i = 0; i < size / sizeof (unsigned int); i++)
543 printf_unfiltered (" %08x", ldata[i]);
544 printf_unfiltered (_("\n"));
548 /* Adjust inferior data when a new task was created. */
550 static struct inferior *
551 darwin_find_new_inferior (task_t task_port, thread_t thread_port)
554 struct inferior *inf;
558 /* Find the corresponding pid. */
559 kret = pid_for_task (task_port, &task_pid);
560 if (kret != KERN_SUCCESS)
562 MACH_CHECK_ERROR (kret);
566 /* Find the inferior for this pid. */
567 inf = darwin_find_inferior_by_pid (task_pid);
571 darwin_inferior *priv = get_darwin_inferior (inf);
573 /* Deallocate saved exception ports. */
574 darwin_deallocate_exception_ports (priv);
576 /* No need to remove dead_name notification, but still... */
577 kret = mach_port_request_notification (gdb_task, priv->task,
578 MACH_NOTIFY_DEAD_NAME, 0,
580 MACH_MSG_TYPE_MAKE_SEND_ONCE,
582 if (kret != KERN_INVALID_ARGUMENT)
583 MACH_CHECK_ERROR (kret);
585 /* Replace old task port. */
586 kret = mach_port_deallocate (gdb_task, priv->task);
587 MACH_CHECK_ERROR (kret);
588 priv->task = task_port;
590 darwin_setup_request_notification (inf);
591 darwin_setup_exceptions (inf);
596 /* Check data representation. */
599 darwin_check_message_ndr (NDR_record_t *ndr)
601 if (ndr->mig_vers != NDR_PROTOCOL_2_0
602 || ndr->if_vers != NDR_PROTOCOL_2_0
603 || ndr->mig_encoding != NDR_record.mig_encoding
604 || ndr->int_rep != NDR_record.int_rep
605 || ndr->char_rep != NDR_record.char_rep
606 || ndr->float_rep != NDR_record.float_rep)
611 /* Decode an exception message. */
614 darwin_decode_exception_message (mach_msg_header_t *hdr,
615 struct inferior **pinf,
616 darwin_thread_t **pthread)
618 mach_msg_body_t *bod = (mach_msg_body_t*)(hdr + 1);
619 mach_msg_port_descriptor_t *desc = (mach_msg_port_descriptor_t *)(bod + 1);
622 struct inferior *inf;
623 darwin_thread_t *thread;
625 thread_t thread_port;
629 /* Check message destination. */
630 if (hdr->msgh_local_port != darwin_ex_port)
633 /* Check message header. */
634 if (!(hdr->msgh_bits & MACH_MSGH_BITS_COMPLEX))
637 /* Check descriptors. */
638 if (hdr->msgh_size < (sizeof (*hdr) + sizeof (*bod) + 2 * sizeof (*desc)
639 + sizeof (*ndr) + 2 * sizeof (integer_t))
640 || bod->msgh_descriptor_count != 2
641 || desc[0].type != MACH_MSG_PORT_DESCRIPTOR
642 || desc[0].disposition != MACH_MSG_TYPE_MOVE_SEND
643 || desc[1].type != MACH_MSG_PORT_DESCRIPTOR
644 || desc[1].disposition != MACH_MSG_TYPE_MOVE_SEND)
647 /* Check data representation. */
648 ndr = (NDR_record_t *)(desc + 2);
649 if (darwin_check_message_ndr (ndr) != 0)
652 /* Ok, the hard work. */
653 data = (integer_t *)(ndr + 1);
655 task_port = desc[1].name;
656 thread_port = desc[0].name;
658 /* Find process by port. */
659 inf = darwin_find_inferior_by_task (task_port);
662 if (inf == NULL && data[0] == EXC_SOFTWARE && data[1] == 2
663 && data[2] == EXC_SOFT_SIGNAL && data[3] == SIGTRAP)
665 /* Not a known inferior, but a sigtrap. This happens on darwin 16.1.0,
666 as a new Mach task is created when a process exec. */
667 inf = darwin_find_new_inferior (task_port, thread_port);
672 /* Deallocate task_port, unless it was saved. */
673 kret = mach_port_deallocate (mach_task_self (), task_port);
674 MACH_CHECK_ERROR (kret);
679 /* We got new rights to the task, get rid of it. Do not get rid of
680 thread right, as we will need it to find the thread. */
681 kret = mach_port_deallocate (mach_task_self (), task_port);
682 MACH_CHECK_ERROR (kret);
687 /* Not a known inferior. This could happen if the child fork, as
688 the created process will inherit its exception port.
689 FIXME: should the exception port be restored ? */
691 mig_reply_error_t reply;
694 (4, _("darwin_decode_exception_message: unknown task 0x%x\n"),
697 /* Free thread port (we don't know it). */
698 kret = mach_port_deallocate (mach_task_self (), thread_port);
699 MACH_CHECK_ERROR (kret);
701 darwin_encode_reply (&reply, hdr, KERN_SUCCESS);
703 kret = mach_msg (&reply.Head, MACH_SEND_MSG | MACH_SEND_INTERRUPT,
704 reply.Head.msgh_size, 0,
705 MACH_PORT_NULL, MACH_MSG_TIMEOUT_NONE,
707 MACH_CHECK_ERROR (kret);
712 /* Find thread by port. */
713 /* Check for new threads. Do it early so that the port in the exception
714 message can be deallocated. */
715 darwin_check_new_threads (inf);
717 /* Free the thread port (as gdb knows the thread, it has already has a right
718 for it, so this just decrement a reference counter). */
719 kret = mach_port_deallocate (mach_task_self (), thread_port);
720 MACH_CHECK_ERROR (kret);
722 thread = darwin_find_thread (inf, thread_port);
727 /* The thread should be running. However we have observed cases where a
728 thread got a SIGTTIN message after being stopped. */
729 gdb_assert (thread->msg_state != DARWIN_MESSAGE);
731 /* Finish decoding. */
732 thread->event.header = *hdr;
733 thread->event.thread_port = thread_port;
734 thread->event.task_port = task_port;
735 thread->event.ex_type = data[0];
736 thread->event.data_count = data[1];
738 if (hdr->msgh_size < (sizeof (*hdr) + sizeof (*bod) + 2 * sizeof (*desc)
739 + sizeof (*ndr) + 2 * sizeof (integer_t)
740 + data[1] * sizeof (integer_t)))
742 for (i = 0; i < data[1]; i++)
743 thread->event.ex_data[i] = data[2 + i];
745 thread->msg_state = DARWIN_MESSAGE;
750 /* Decode dead_name notify message. */
753 darwin_decode_notify_message (mach_msg_header_t *hdr, struct inferior **pinf)
755 NDR_record_t *ndr = (NDR_record_t *)(hdr + 1);
756 integer_t *data = (integer_t *)(ndr + 1);
757 struct inferior *inf;
760 /* Check message header. */
761 if (hdr->msgh_bits & MACH_MSGH_BITS_COMPLEX)
764 /* Check descriptors. */
765 if (hdr->msgh_size < (sizeof (*hdr) + sizeof (*ndr) + sizeof (integer_t)))
768 /* Check data representation. */
769 if (darwin_check_message_ndr (ndr) != 0)
774 /* Find process by port. */
775 inf = darwin_find_inferior_by_task (task_port);
778 /* Check message destination. */
781 darwin_inferior *priv = get_darwin_inferior (inf);
782 if (hdr->msgh_local_port != priv->notify_port)
790 darwin_encode_reply (mig_reply_error_t *reply, mach_msg_header_t *hdr,
793 mach_msg_header_t *rh = &reply->Head;
795 rh->msgh_bits = MACH_MSGH_BITS (MACH_MSGH_BITS_REMOTE (hdr->msgh_bits), 0);
796 rh->msgh_remote_port = hdr->msgh_remote_port;
797 rh->msgh_size = (mach_msg_size_t) sizeof (mig_reply_error_t);
798 rh->msgh_local_port = MACH_PORT_NULL;
799 rh->msgh_id = hdr->msgh_id + 100;
801 reply->NDR = NDR_record;
802 reply->RetCode = code;
806 darwin_send_reply (struct inferior *inf, darwin_thread_t *thread)
809 mig_reply_error_t reply;
810 darwin_inferior *priv = get_darwin_inferior (inf);
812 darwin_encode_reply (&reply, &thread->event.header, KERN_SUCCESS);
814 kret = mach_msg (&reply.Head, MACH_SEND_MSG | MACH_SEND_INTERRUPT,
815 reply.Head.msgh_size, 0,
816 MACH_PORT_NULL, MACH_MSG_TIMEOUT_NONE,
818 MACH_CHECK_ERROR (kret);
820 priv->pending_messages--;
823 /* Wrapper around the __pthread_kill syscall. We use this instead of the
824 pthread_kill function to be able to send a signal to any kind of thread,
825 including GCD threads. */
828 darwin_pthread_kill (darwin_thread_t *thread, int nsignal)
831 DIAGNOSTIC_IGNORE_DEPRECATED_DECLARATIONS;
832 int res = syscall (SYS___pthread_kill, thread->gdb_port, nsignal);
838 darwin_resume_thread (struct inferior *inf, darwin_thread_t *thread,
839 int step, int nsignal)
842 (3, _("darwin_resume_thread: state=%d, thread=0x%x, step=%d nsignal=%d\n"),
843 thread->msg_state, thread->gdb_port, step, nsignal);
845 switch (thread->msg_state)
848 if (thread->event.ex_type == EXC_SOFTWARE
849 && thread->event.ex_data[0] == EXC_SOFT_SIGNAL)
851 /* Either deliver a new signal or cancel the signal received. */
852 int res = PTRACE (PT_THUPDATE, inf->pid,
853 (caddr_t) (uintptr_t) thread->gdb_port, nsignal);
855 inferior_debug (1, _("ptrace THUP: res=%d\n"), res);
859 /* Note: ptrace is allowed only if the process is stopped.
860 Directly send the signal to the thread. */
861 int res = darwin_pthread_kill (thread, nsignal);
862 inferior_debug (4, _("darwin_resume_thread: kill 0x%x %d: %d\n"),
863 thread->gdb_port, nsignal, res);
864 thread->signaled = 1;
867 /* Set or reset single step. */
868 inferior_debug (4, _("darwin_set_sstep (thread=0x%x, enable=%d)\n"),
869 thread->gdb_port, step);
870 darwin_set_sstep (thread->gdb_port, step);
871 thread->single_step = step;
873 darwin_send_reply (inf, thread);
874 thread->msg_state = DARWIN_RUNNING;
881 kern_return_t kret = thread_resume (thread->gdb_port);
882 MACH_CHECK_ERROR (kret);
884 thread->msg_state = DARWIN_RUNNING;
889 /* Resume all threads of the inferior. */
892 darwin_resume_inferior_threads (struct inferior *inf, int step, int nsignal)
894 darwin_inferior *priv = get_darwin_inferior (inf);
897 for (darwin_thread_t *thread : priv->threads)
898 darwin_resume_thread (inf, thread, step, nsignal);
901 struct resume_inferior_threads_param
908 darwin_resume_inferior_threads_it (struct inferior *inf, void *param)
910 int step = ((struct resume_inferior_threads_param *)param)->step;
911 int nsignal = ((struct resume_inferior_threads_param *)param)->nsignal;
913 darwin_resume_inferior_threads (inf, step, nsignal);
918 /* Suspend all threads of INF. */
921 darwin_suspend_inferior_threads (struct inferior *inf)
923 darwin_inferior *priv = get_darwin_inferior (inf);
925 for (darwin_thread_t *thread : priv->threads)
927 switch (thread->msg_state)
934 kern_return_t kret = thread_suspend (thread->gdb_port);
935 MACH_CHECK_ERROR (kret);
936 thread->msg_state = DARWIN_STOPPED;
944 darwin_nat_target::resume (ptid_t ptid, int step, enum gdb_signal signal)
946 struct target_waitstatus status;
951 (2, _("darwin_resume: pid=%d, tid=0x%lx, step=%d, signal=%d\n"),
952 ptid.pid (), ptid.tid (), step, signal);
954 if (signal == GDB_SIGNAL_0)
957 nsignal = gdb_signal_to_host (signal);
959 /* Don't try to single step all threads. */
961 ptid = inferior_ptid;
963 /* minus_one_ptid is RESUME_ALL. */
964 if (ptid == minus_one_ptid)
966 struct resume_inferior_threads_param param;
968 param.nsignal = nsignal;
971 /* Resume threads. */
972 iterate_over_inferiors (darwin_resume_inferior_threads_it, ¶m);
974 iterate_over_inferiors (darwin_resume_inferior_it, NULL);
978 struct inferior *inf = find_inferior_ptid (ptid);
979 long tid = ptid.tid ();
981 /* Stop the inferior (should be useless). */
982 darwin_suspend_inferior (inf);
985 darwin_resume_inferior_threads (inf, step, nsignal);
988 darwin_thread_t *thread;
990 /* Suspend threads of the task. */
991 darwin_suspend_inferior_threads (inf);
993 /* Resume the selected thread. */
994 thread = darwin_find_thread (inf, tid);
996 darwin_resume_thread (inf, thread, step, nsignal);
999 /* Resume the task. */
1000 darwin_resume_inferior (inf);
1005 darwin_decode_message (mach_msg_header_t *hdr,
1006 darwin_thread_t **pthread,
1007 struct inferior **pinf,
1008 struct target_waitstatus *status)
1010 darwin_thread_t *thread;
1011 struct inferior *inf;
1013 /* Exception message. 2401 == 0x961 is exc. */
1014 if (hdr->msgh_id == 2401)
1018 /* Decode message. */
1019 res = darwin_decode_exception_message (hdr, &inf, &thread);
1023 /* Should not happen... */
1025 (_("darwin_wait: ill-formatted message (id=0x%x)\n"), hdr->msgh_id);
1026 /* FIXME: send a failure reply? */
1027 status->kind = TARGET_WAITKIND_IGNORE;
1028 return minus_one_ptid;
1032 status->kind = TARGET_WAITKIND_IGNORE;
1033 return minus_one_ptid;
1038 darwin_inferior *priv = get_darwin_inferior (inf);
1040 priv->pending_messages++;
1042 status->kind = TARGET_WAITKIND_STOPPED;
1043 thread->msg_state = DARWIN_MESSAGE;
1045 inferior_debug (4, _("darwin_wait: thread=0x%x, got %s\n"),
1047 unparse_exception_type (thread->event.ex_type));
1049 switch (thread->event.ex_type)
1051 case EXC_BAD_ACCESS:
1052 status->value.sig = GDB_EXC_BAD_ACCESS;
1054 case EXC_BAD_INSTRUCTION:
1055 status->value.sig = GDB_EXC_BAD_INSTRUCTION;
1057 case EXC_ARITHMETIC:
1058 status->value.sig = GDB_EXC_ARITHMETIC;
1061 status->value.sig = GDB_EXC_EMULATION;
1064 if (thread->event.ex_data[0] == EXC_SOFT_SIGNAL)
1067 gdb_signal_from_host (thread->event.ex_data[1]);
1068 inferior_debug (5, _(" (signal %d: %s)\n"),
1069 thread->event.ex_data[1],
1070 gdb_signal_to_name (status->value.sig));
1072 /* If the thread is stopped because it has received a signal
1073 that gdb has just sent, continue. */
1074 if (thread->signaled)
1076 thread->signaled = 0;
1077 darwin_send_reply (inf, thread);
1078 thread->msg_state = DARWIN_RUNNING;
1079 status->kind = TARGET_WAITKIND_IGNORE;
1083 status->value.sig = GDB_EXC_SOFTWARE;
1085 case EXC_BREAKPOINT:
1086 /* Many internal GDB routines expect breakpoints to be reported
1087 as GDB_SIGNAL_TRAP, and will report GDB_EXC_BREAKPOINT
1088 as a spurious signal. */
1089 status->value.sig = GDB_SIGNAL_TRAP;
1092 status->value.sig = GDB_SIGNAL_UNKNOWN;
1096 return ptid_t (inf->pid, 0, thread->gdb_port);
1098 else if (hdr->msgh_id == 0x48)
1100 /* MACH_NOTIFY_DEAD_NAME: notification for exit. */
1103 res = darwin_decode_notify_message (hdr, &inf);
1107 /* Should not happen... */
1109 (_("darwin_wait: ill-formatted message (id=0x%x, res=%d)\n"),
1116 if (res < 0 || inf == NULL)
1118 status->kind = TARGET_WAITKIND_IGNORE;
1119 return minus_one_ptid;
1124 darwin_inferior *priv = get_darwin_inferior (inf);
1126 if (!priv->no_ptrace)
1131 res = wait4 (inf->pid, &wstatus, 0, NULL);
1132 if (res < 0 || res != inf->pid)
1134 printf_unfiltered (_("wait4: res=%d: %s\n"),
1135 res, safe_strerror (errno));
1136 status->kind = TARGET_WAITKIND_IGNORE;
1137 return minus_one_ptid;
1139 if (WIFEXITED (wstatus))
1141 status->kind = TARGET_WAITKIND_EXITED;
1142 status->value.integer = WEXITSTATUS (wstatus);
1146 status->kind = TARGET_WAITKIND_SIGNALLED;
1147 status->value.sig = gdb_signal_from_host (WTERMSIG (wstatus));
1150 inferior_debug (4, _("darwin_wait: pid=%d exit, status=0x%x\n"),
1153 /* Looks necessary on Leopard and harmless... */
1154 wait4 (inf->pid, &wstatus, 0, NULL);
1156 inferior_ptid = ptid_t (inf->pid, 0, 0);
1157 return inferior_ptid;
1161 inferior_debug (4, _("darwin_wait: pid=%d\n"), inf->pid);
1162 status->kind = TARGET_WAITKIND_EXITED;
1163 status->value.integer = 0; /* Don't know. */
1164 return ptid_t (inf->pid, 0, 0);
1169 /* Unknown message. */
1170 warning (_("darwin: got unknown message, id: 0x%x"), hdr->msgh_id);
1171 status->kind = TARGET_WAITKIND_IGNORE;
1172 return minus_one_ptid;
1176 cancel_breakpoint (ptid_t ptid)
1178 /* Arrange for a breakpoint to be hit again later. We will handle
1179 the current event, eventually we will resume this thread, and this
1180 breakpoint will trap again.
1182 If we do not do this, then we run the risk that the user will
1183 delete or disable the breakpoint, but the thread will have already
1186 struct regcache *regcache = get_thread_regcache (ptid);
1187 struct gdbarch *gdbarch = regcache->arch ();
1190 pc = regcache_read_pc (regcache) - gdbarch_decr_pc_after_break (gdbarch);
1191 if (breakpoint_inserted_here_p (regcache->aspace (), pc))
1193 inferior_debug (4, "cancel_breakpoint for thread 0x%lx\n",
1194 (unsigned long) ptid.tid ());
1196 /* Back up the PC if necessary. */
1197 if (gdbarch_decr_pc_after_break (gdbarch))
1198 regcache_write_pc (regcache, pc);
1206 darwin_wait (ptid_t ptid, struct target_waitstatus *status)
1211 mach_msg_header_t hdr;
1214 mach_msg_header_t *hdr = &msgin.hdr;
1216 darwin_thread_t *thread;
1217 struct inferior *inf;
1220 (2, _("darwin_wait: waiting for a message pid=%d thread=%lx\n"),
1221 ptid.pid (), ptid.tid ());
1223 /* Handle fake stop events at first. */
1224 if (darwin_inf_fake_stop != NULL)
1226 inf = darwin_inf_fake_stop;
1227 darwin_inf_fake_stop = NULL;
1229 darwin_inferior *priv = get_darwin_inferior (inf);
1231 status->kind = TARGET_WAITKIND_STOPPED;
1232 status->value.sig = GDB_SIGNAL_TRAP;
1233 thread = priv->threads[0];
1234 thread->msg_state = DARWIN_STOPPED;
1235 return ptid_t (inf->pid, 0, thread->gdb_port);
1240 /* set_sigint_trap (); */
1242 /* Wait for a message. */
1243 kret = mach_msg (&msgin.hdr, MACH_RCV_MSG | MACH_RCV_INTERRUPT, 0,
1244 sizeof (msgin.data), darwin_port_set, 0, MACH_PORT_NULL);
1246 /* clear_sigint_trap (); */
1248 if (kret == MACH_RCV_INTERRUPTED)
1250 status->kind = TARGET_WAITKIND_IGNORE;
1251 return minus_one_ptid;
1254 if (kret != MACH_MSG_SUCCESS)
1256 inferior_debug (5, _("mach_msg: ret=0x%x\n"), kret);
1257 status->kind = TARGET_WAITKIND_SPURIOUS;
1258 return minus_one_ptid;
1261 /* Debug: display message. */
1262 if (darwin_debug_flag > 10)
1263 darwin_dump_message (hdr, darwin_debug_flag > 11);
1265 res = darwin_decode_message (hdr, &thread, &inf, status);
1266 if (res == minus_one_ptid)
1269 /* Early return in case an inferior has exited. */
1273 while (status->kind == TARGET_WAITKIND_IGNORE);
1275 /* Stop all tasks. */
1276 iterate_over_inferiors (darwin_suspend_inferior_it, NULL);
1278 /* Read pending messages. */
1281 struct target_waitstatus status2;
1284 kret = mach_msg (&msgin.hdr,
1285 MACH_RCV_MSG | MACH_RCV_TIMEOUT, 0,
1286 sizeof (msgin.data), darwin_port_set, 1, MACH_PORT_NULL);
1288 if (kret == MACH_RCV_TIMED_OUT)
1290 if (kret != MACH_MSG_SUCCESS)
1293 (5, _("darwin_wait: mach_msg(pending) ret=0x%x\n"), kret);
1297 /* Debug: display message. */
1298 if (darwin_debug_flag > 10)
1299 darwin_dump_message (hdr, darwin_debug_flag > 11);
1301 ptid2 = darwin_decode_message (hdr, &thread, &inf, &status2);
1303 if (inf != NULL && thread != NULL
1304 && thread->event.ex_type == EXC_BREAKPOINT)
1306 if (thread->single_step
1307 || cancel_breakpoint (ptid_t (inf->pid, 0, thread->gdb_port)))
1309 gdb_assert (thread->msg_state == DARWIN_MESSAGE);
1310 darwin_send_reply (inf, thread);
1311 thread->msg_state = DARWIN_RUNNING;
1315 (3, _("darwin_wait: thread 0x%x hit a non-gdb breakpoint\n"),
1319 inferior_debug (3, _("darwin_wait: unhandled pending message\n"));
1325 darwin_nat_target::wait (ptid_t ptid, struct target_waitstatus *status,
1328 return darwin_wait (ptid, status);
1332 darwin_nat_target::interrupt ()
1334 struct inferior *inf = current_inferior ();
1335 darwin_inferior *priv = get_darwin_inferior (inf);
1337 /* FIXME: handle in no_ptrace mode. */
1338 gdb_assert (!priv->no_ptrace);
1339 ::kill (inf->pid, SIGINT);
1342 /* Deallocate threads port and vector. */
1345 darwin_deallocate_threads (struct inferior *inf)
1347 darwin_inferior *priv = get_darwin_inferior (inf);
1349 for (darwin_thread_t *t : priv->threads)
1351 kern_return_t kret = mach_port_deallocate (gdb_task, t->gdb_port);
1352 MACH_CHECK_ERROR (kret);
1355 priv->threads.clear ();
1359 darwin_nat_target::mourn_inferior ()
1361 struct inferior *inf = current_inferior ();
1362 darwin_inferior *priv = get_darwin_inferior (inf);
1366 /* Deallocate threads. */
1367 darwin_deallocate_threads (inf);
1369 /* Remove notify_port from darwin_port_set. */
1370 kret = mach_port_move_member (gdb_task,
1371 priv->notify_port, MACH_PORT_NULL);
1372 MACH_CHECK_ERROR (kret);
1374 /* Remove task port dead_name notification. */
1375 kret = mach_port_request_notification (gdb_task, priv->task,
1376 MACH_NOTIFY_DEAD_NAME, 0,
1378 MACH_MSG_TYPE_MAKE_SEND_ONCE,
1380 /* This can fail if the task is dead. */
1381 inferior_debug (4, "task=0x%x, prev=0x%x, notify_port=0x%x\n",
1382 priv->task, prev, priv->notify_port);
1384 if (kret == KERN_SUCCESS)
1386 kret = mach_port_deallocate (gdb_task, prev);
1387 MACH_CHECK_ERROR (kret);
1390 /* Destroy notify_port. */
1391 kret = mach_port_destroy (gdb_task, priv->notify_port);
1392 MACH_CHECK_ERROR (kret);
1394 /* Deallocate saved exception ports. */
1395 darwin_deallocate_exception_ports (priv);
1397 /* Deallocate task port. */
1398 kret = mach_port_deallocate (gdb_task, priv->task);
1399 MACH_CHECK_ERROR (kret);
1403 inf_child_target::mourn_inferior ();
1407 darwin_reply_to_all_pending_messages (struct inferior *inf)
1409 darwin_inferior *priv = get_darwin_inferior (inf);
1411 for (darwin_thread_t *t : priv->threads)
1413 if (t->msg_state == DARWIN_MESSAGE)
1414 darwin_resume_thread (inf, t, 0, 0);
1419 darwin_stop_inferior (struct inferior *inf)
1421 struct target_waitstatus wstatus;
1424 darwin_inferior *priv = get_darwin_inferior (inf);
1426 gdb_assert (inf != NULL);
1428 darwin_suspend_inferior (inf);
1430 darwin_reply_to_all_pending_messages (inf);
1432 if (priv->no_ptrace)
1435 res = kill (inf->pid, SIGSTOP);
1437 warning (_("cannot kill: %s"), safe_strerror (errno));
1439 /* Wait until the process is really stopped. */
1442 ptid = darwin_wait (inferior_ptid, &wstatus);
1443 if (wstatus.kind == TARGET_WAITKIND_STOPPED
1444 && wstatus.value.sig == GDB_SIGNAL_STOP)
1449 static kern_return_t
1450 darwin_save_exception_ports (darwin_inferior *inf)
1454 inf->exception_info.count =
1455 sizeof (inf->exception_info.ports) / sizeof (inf->exception_info.ports[0]);
1457 kret = task_get_exception_ports
1458 (inf->task, EXC_MASK_ALL, inf->exception_info.masks,
1459 &inf->exception_info.count, inf->exception_info.ports,
1460 inf->exception_info.behaviors, inf->exception_info.flavors);
1464 static kern_return_t
1465 darwin_restore_exception_ports (darwin_inferior *inf)
1470 for (i = 0; i < inf->exception_info.count; i++)
1472 kret = task_set_exception_ports
1473 (inf->task, inf->exception_info.masks[i], inf->exception_info.ports[i],
1474 inf->exception_info.behaviors[i], inf->exception_info.flavors[i]);
1475 if (kret != KERN_SUCCESS)
1479 return KERN_SUCCESS;
1482 /* Deallocate saved exception ports. */
1485 darwin_deallocate_exception_ports (darwin_inferior *inf)
1490 for (i = 0; i < inf->exception_info.count; i++)
1492 kret = mach_port_deallocate (gdb_task, inf->exception_info.ports[i]);
1493 MACH_CHECK_ERROR (kret);
1495 inf->exception_info.count = 0;
1499 darwin_setup_exceptions (struct inferior *inf)
1501 darwin_inferior *priv = get_darwin_inferior (inf);
1503 exception_mask_t mask;
1505 kret = darwin_save_exception_ports (priv);
1506 if (kret != KERN_SUCCESS)
1507 error (_("Unable to save exception ports, task_get_exception_ports"
1511 /* Set exception port. */
1512 if (enable_mach_exceptions)
1513 mask = EXC_MASK_ALL;
1515 mask = EXC_MASK_SOFTWARE | EXC_MASK_BREAKPOINT;
1516 kret = task_set_exception_ports (priv->task, mask, darwin_ex_port,
1517 EXCEPTION_DEFAULT, THREAD_STATE_NONE);
1518 if (kret != KERN_SUCCESS)
1519 error (_("Unable to set exception ports, task_set_exception_ports"
1525 darwin_nat_target::kill ()
1527 struct inferior *inf = current_inferior ();
1528 darwin_inferior *priv = get_darwin_inferior (inf);
1529 struct target_waitstatus wstatus;
1534 if (inferior_ptid == null_ptid)
1537 gdb_assert (inf != NULL);
1539 kret = darwin_restore_exception_ports (priv);
1540 MACH_CHECK_ERROR (kret);
1542 darwin_reply_to_all_pending_messages (inf);
1544 res = ::kill (inf->pid, 9);
1548 /* On MacOS version Sierra, the darwin_restore_exception_ports call
1549 does not work as expected.
1550 When the kill function is called, the SIGKILL signal is received
1551 by gdb whereas it should have been received by the kernel since
1552 the exception ports have been restored.
1553 This behavior is not the expected one thus gdb does not reply to
1554 the received SIGKILL message. This situation leads to a "busy"
1555 resource from the kernel point of view and the inferior is never
1556 released, causing it to remain as a zombie process, even after
1558 To work around this, we mark all the threads of the inferior as
1559 signaled thus darwin_decode_message function knows that the kill
1560 signal was sent by gdb and will take the appropriate action
1561 (cancel signal and reply to the signal message). */
1562 darwin_inferior *priv = get_darwin_inferior (inf);
1563 for (darwin_thread_t *thread : priv->threads)
1564 thread->signaled = 1;
1566 darwin_resume_inferior (inf);
1568 ptid = darwin_wait (inferior_ptid, &wstatus);
1570 else if (errno != ESRCH)
1571 warning (_("Failed to kill inferior: kill (%d, 9) returned [%s]"),
1572 inf->pid, safe_strerror (errno));
1574 target_mourn_inferior (inferior_ptid);
1578 darwin_setup_request_notification (struct inferior *inf)
1580 darwin_inferior *priv = get_darwin_inferior (inf);
1582 mach_port_t prev_not;
1584 kret = mach_port_request_notification (gdb_task, priv->task,
1585 MACH_NOTIFY_DEAD_NAME, 0,
1587 MACH_MSG_TYPE_MAKE_SEND_ONCE,
1589 if (kret != KERN_SUCCESS)
1590 error (_("Termination notification request failed, "
1591 "mach_port_request_notification\n"
1594 if (prev_not != MACH_PORT_NULL)
1596 /* This is unexpected, as there should not be any previously
1597 registered notification request. But this is not a fatal
1598 issue, so just emit a warning. */
1600 A task termination request was registered before the debugger registered\n\
1601 its own. This is unexpected, but should otherwise not have any actual\n\
1602 impact on the debugging session."));
1607 darwin_attach_pid (struct inferior *inf)
1611 darwin_inferior *priv = new darwin_inferior;
1612 inf->priv.reset (priv);
1616 kret = task_for_pid (gdb_task, inf->pid, &priv->task);
1617 if (kret != KERN_SUCCESS)
1621 if (!inf->attach_flag)
1624 waitpid (inf->pid, &status, 0);
1628 (_("Unable to find Mach task port for process-id %d: %s (0x%lx).\n"
1629 " (please check gdb is codesigned - see taskgated(8))"),
1630 inf->pid, mach_error_string (kret), (unsigned long) kret);
1633 inferior_debug (2, _("inferior task: 0x%x, pid: %d\n"),
1634 priv->task, inf->pid);
1636 if (darwin_ex_port == MACH_PORT_NULL)
1638 /* Create a port to get exceptions. */
1639 kret = mach_port_allocate (gdb_task, MACH_PORT_RIGHT_RECEIVE,
1641 if (kret != KERN_SUCCESS)
1642 error (_("Unable to create exception port, mach_port_allocate "
1646 kret = mach_port_insert_right (gdb_task, darwin_ex_port,
1648 MACH_MSG_TYPE_MAKE_SEND);
1649 if (kret != KERN_SUCCESS)
1650 error (_("Unable to create exception port, mach_port_insert_right "
1654 /* Create a port set and put ex_port in it. */
1655 kret = mach_port_allocate (gdb_task, MACH_PORT_RIGHT_PORT_SET,
1657 if (kret != KERN_SUCCESS)
1658 error (_("Unable to create port set, mach_port_allocate "
1662 kret = mach_port_move_member (gdb_task, darwin_ex_port,
1664 if (kret != KERN_SUCCESS)
1665 error (_("Unable to move exception port into new port set, "
1666 "mach_port_move_member\n"
1671 /* Create a port to be notified when the child task terminates. */
1672 kret = mach_port_allocate (gdb_task, MACH_PORT_RIGHT_RECEIVE,
1673 &priv->notify_port);
1674 if (kret != KERN_SUCCESS)
1675 error (_("Unable to create notification port, mach_port_allocate "
1679 kret = mach_port_move_member (gdb_task,
1680 priv->notify_port, darwin_port_set);
1681 if (kret != KERN_SUCCESS)
1682 error (_("Unable to move notification port into new port set, "
1683 "mach_port_move_member\n"
1687 darwin_setup_request_notification (inf);
1689 darwin_setup_exceptions (inf);
1691 CATCH (ex, RETURN_MASK_ALL)
1693 exit_inferior (inf);
1694 inferior_ptid = null_ptid;
1696 throw_exception (ex);
1700 target_ops *darwin_ops = get_native_target ();
1701 if (!target_is_pushed (darwin_ops))
1702 push_target (darwin_ops);
1705 /* Get the thread_info object corresponding to this darwin_thread_info. */
1707 static struct thread_info *
1708 thread_info_from_private_thread_info (darwin_thread_info *pti)
1710 for (struct thread_info *it : all_threads ())
1712 darwin_thread_info *iter_pti = get_darwin_thread_info (it);
1714 if (iter_pti->gdb_port == pti->gdb_port)
1718 gdb_assert_not_reached ("did not find gdb thread for darwin thread");
1722 darwin_init_thread_list (struct inferior *inf)
1724 darwin_check_new_threads (inf);
1726 darwin_inferior *priv = get_darwin_inferior (inf);
1728 gdb_assert (!priv->threads.empty ());
1730 darwin_thread_info *first_pti = priv->threads.front ();
1731 struct thread_info *first_thread
1732 = thread_info_from_private_thread_info (first_pti);
1734 inferior_ptid = first_thread->ptid;
1737 /* The child must synchronize with gdb: gdb must set the exception port
1738 before the child call PTRACE_SIGEXC. We use a pipe to achieve this.
1739 FIXME: is there a lighter way ? */
1740 static int ptrace_fds[2];
1743 darwin_ptrace_me (void)
1748 /* Close write end point. */
1749 if (close (ptrace_fds[1]) < 0)
1750 trace_start_error_with_name ("close");
1752 /* Wait until gdb is ready. */
1753 res = read (ptrace_fds[0], &c, 1);
1755 trace_start_error (_("unable to read from pipe, read returned: %d"), res);
1757 if (close (ptrace_fds[0]) < 0)
1758 trace_start_error_with_name ("close");
1760 /* Get rid of privileges. */
1761 if (setegid (getgid ()) < 0)
1762 trace_start_error_with_name ("setegid");
1765 if (PTRACE (PT_TRACE_ME, 0, 0, 0) < 0)
1766 trace_start_error_with_name ("PTRACE");
1768 /* Redirect signals to exception port. */
1769 if (PTRACE (PT_SIGEXC, 0, 0, 0) < 0)
1770 trace_start_error_with_name ("PTRACE");
1773 /* Dummy function to be sure fork_inferior uses fork(2) and not vfork(2). */
1775 darwin_pre_ptrace (void)
1777 if (pipe (ptrace_fds) != 0)
1781 error (_("unable to create a pipe: %s"), safe_strerror (errno));
1784 mark_fd_no_cloexec (ptrace_fds[0]);
1785 mark_fd_no_cloexec (ptrace_fds[1]);
1789 darwin_ptrace_him (int pid)
1791 struct inferior *inf = current_inferior ();
1793 darwin_attach_pid (inf);
1795 /* Let's the child run. */
1796 close (ptrace_fds[0]);
1797 close (ptrace_fds[1]);
1799 unmark_fd_no_cloexec (ptrace_fds[0]);
1800 unmark_fd_no_cloexec (ptrace_fds[1]);
1802 darwin_init_thread_list (inf);
1804 gdb_startup_inferior (pid, START_INFERIOR_TRAPS_EXPECTED);
1808 darwin_execvp (const char *file, char * const argv[], char * const env[])
1810 posix_spawnattr_t attr;
1814 res = posix_spawnattr_init (&attr);
1818 (gdb_stderr, "Cannot initialize attribute for posix_spawn\n");
1822 /* Do like execve: replace the image. */
1823 ps_flags = POSIX_SPAWN_SETEXEC;
1825 /* Disable ASLR. The constant doesn't look to be available outside the
1826 kernel include files. */
1827 #ifndef _POSIX_SPAWN_DISABLE_ASLR
1828 #define _POSIX_SPAWN_DISABLE_ASLR 0x0100
1830 ps_flags |= _POSIX_SPAWN_DISABLE_ASLR;
1831 res = posix_spawnattr_setflags (&attr, ps_flags);
1834 fprintf_unfiltered (gdb_stderr, "Cannot set posix_spawn flags\n");
1838 posix_spawnp (NULL, argv[0], NULL, &attr, argv, env);
1841 /* Read kernel version, and return TRUE if this host may have System
1842 Integrity Protection (Sierra or later). */
1848 size_t sz = sizeof (str);
1851 ret = sysctlbyname ("kern.osrelease", str, &sz, NULL, 0);
1852 if (ret == 0 && sz < sizeof (str))
1854 unsigned long ver = strtoul (str, NULL, 10);
1861 /* A helper for maybe_cache_shell. This copies the shell to the
1862 cache. It will throw an exception on any failure. */
1865 copy_shell_to_cache (const char *shell, const std::string &new_name)
1867 scoped_fd from_fd (gdb_open_cloexec (shell, O_RDONLY, 0));
1868 if (from_fd.get () < 0)
1869 error (_("Could not open shell (%s) for reading: %s"),
1870 shell, safe_strerror (errno));
1872 std::string new_dir = ldirname (new_name.c_str ());
1873 if (!mkdir_recursive (new_dir.c_str ()))
1874 error (_("Could not make cache directory \"%s\": %s"),
1875 new_dir.c_str (), safe_strerror (errno));
1877 gdb::char_vector temp_name = make_temp_filename (new_name);
1878 scoped_fd to_fd (gdb_mkostemp_cloexec (&temp_name[0]));
1879 gdb::unlinker unlink_file_on_error (temp_name.data ());
1881 if (to_fd.get () < 0)
1882 error (_("Could not open temporary file \"%s\" for writing: %s"),
1883 temp_name.data (), safe_strerror (errno));
1885 if (fcopyfile (from_fd.get (), to_fd.get (), nullptr,
1886 COPYFILE_STAT | COPYFILE_DATA) != 0)
1887 error (_("Could not copy shell to cache as \"%s\": %s"),
1888 temp_name.data (), safe_strerror (errno));
1890 /* Be sure that the caching is atomic so that we don't get bad
1891 results from multiple copies of gdb running at the same time. */
1892 if (rename (temp_name.data (), new_name.c_str ()) != 0)
1893 error (_("Could not rename shell cache file to \"%s\": %s"),
1894 new_name.c_str (), safe_strerror (errno));
1896 unlink_file_on_error.keep ();
1899 /* If $SHELL is restricted, try to cache a copy. Starting with El
1900 Capitan, macOS introduced System Integrity Protection. Among other
1901 things, this prevents certain executables from being ptrace'd. In
1902 particular, executables in /bin, like most shells, are affected.
1903 To work around this, while preserving command-line glob expansion
1904 and redirections, gdb will cache a copy of the shell. Return true
1905 if all is well -- either the shell is not subject to SIP or it has
1906 been successfully cached. Returns false if something failed. */
1909 maybe_cache_shell ()
1911 /* SF_RESTRICTED is defined in sys/stat.h and lets us determine if a
1912 given file is subject to SIP. */
1913 #ifdef SF_RESTRICTED
1915 /* If a check fails we want to revert -- maybe the user deleted the
1916 cache while gdb was running, or something like that. */
1917 copied_shell = nullptr;
1919 const char *shell = get_shell ();
1920 if (!IS_ABSOLUTE_PATH (shell))
1922 warning (_("This version of macOS has System Integrity Protection.\n\
1923 Normally gdb would try to work around this by caching a copy of your shell,\n\
1924 but because your shell (%s) is not an absolute path, this is being skipped."),
1930 if (stat (shell, &sb) < 0)
1932 warning (_("This version of macOS has System Integrity Protection.\n\
1933 Normally gdb would try to work around this by caching a copy of your shell,\n\
1934 but because gdb could not stat your shell (%s), this is being skipped.\n\
1935 The error was: %s"),
1936 shell, safe_strerror (errno));
1940 if ((sb.st_flags & SF_RESTRICTED) == 0)
1943 /* Put the copy somewhere like ~/Library/Caches/gdb/bin/sh. */
1944 std::string new_name = get_standard_cache_dir ();
1945 /* There's no need to insert a directory separator here, because
1946 SHELL is known to be absolute. */
1947 new_name.append (shell);
1949 /* Maybe it was cached by some earlier gdb. */
1950 if (stat (new_name.c_str (), &sb) != 0 || !S_ISREG (sb.st_mode))
1954 copy_shell_to_cache (shell, new_name);
1956 CATCH (ex, RETURN_MASK_ERROR)
1958 warning (_("This version of macOS has System Integrity Protection.\n\
1959 Because `startup-with-shell' is enabled, gdb tried to work around SIP by\n\
1960 caching a copy of your shell. However, this failed:\n\
1962 If you correct the problem, gdb will automatically try again the next time\n\
1963 you \"run\". To prevent these attempts, you can use:\n\
1964 set startup-with-shell off"),
1970 printf_filtered (_("Note: this version of macOS has System Integrity Protection.\n\
1971 Because `startup-with-shell' is enabled, gdb has worked around this by\n\
1972 caching a copy of your shell. The shell used by \"run\" is now:\n\
1977 /* We need to make sure that the new name has the correct lifetime. */
1978 static std::string saved_shell = std::move (new_name);
1979 copied_shell = saved_shell.c_str ();
1981 #endif /* SF_RESTRICTED */
1987 darwin_nat_target::create_inferior (const char *exec_file,
1988 const std::string &allargs,
1989 char **env, int from_tty)
1991 gdb::optional<scoped_restore_tmpl<int>> restore_startup_with_shell;
1993 if (startup_with_shell && may_have_sip ())
1995 if (!maybe_cache_shell ())
1997 warning (_("startup-with-shell is now temporarily disabled"));
1998 restore_startup_with_shell.emplace (&startup_with_shell, 0);
2002 /* Do the hard work. */
2003 fork_inferior (exec_file, allargs, env, darwin_ptrace_me,
2004 darwin_ptrace_him, darwin_pre_ptrace, copied_shell,
2009 /* Set things up such that the next call to darwin_wait will immediately
2010 return a fake stop event for inferior INF.
2012 This assumes that the inferior's thread list has been initialized,
2013 as it will suspend the inferior's first thread. */
2016 darwin_setup_fake_stop_event (struct inferior *inf)
2018 darwin_inferior *priv = get_darwin_inferior (inf);
2019 darwin_thread_t *thread;
2022 gdb_assert (darwin_inf_fake_stop == NULL);
2023 darwin_inf_fake_stop = inf;
2025 /* When detecting a fake pending stop event, darwin_wait returns
2026 an event saying that the first thread is in a DARWIN_STOPPED
2027 state. To make that accurate, we need to suspend that thread
2028 as well. Otherwise, we'll try resuming it when resuming the
2029 inferior, and get a warning because the thread's suspend count
2030 is already zero, making the resume request useless. */
2031 thread = priv->threads[0];
2032 kret = thread_suspend (thread->gdb_port);
2033 MACH_CHECK_ERROR (kret);
2036 /* Attach to process PID, then initialize for debugging it
2037 and wait for the trace-trap that results from attaching. */
2039 darwin_nat_target::attach (const char *args, int from_tty)
2042 struct inferior *inf;
2044 pid = parse_pid_to_attach (args);
2046 if (pid == getpid ()) /* Trying to masturbate? */
2047 error (_("I refuse to debug myself!"));
2051 char *exec_file = get_exec_file (0);
2054 printf_unfiltered (_("Attaching to program: %s, %s\n"), exec_file,
2055 target_pid_to_str (ptid_t (pid)));
2057 printf_unfiltered (_("Attaching to %s\n"),
2058 target_pid_to_str (ptid_t (pid)));
2060 gdb_flush (gdb_stdout);
2063 if (pid == 0 || ::kill (pid, 0) < 0)
2064 error (_("Can't attach to process %d: %s (%d)"),
2065 pid, safe_strerror (errno), errno);
2067 inferior_ptid = ptid_t (pid);
2068 inf = current_inferior ();
2069 inferior_appeared (inf, pid);
2070 inf->attach_flag = 1;
2072 darwin_attach_pid (inf);
2074 darwin_suspend_inferior (inf);
2076 darwin_init_thread_list (inf);
2078 darwin_inferior *priv = get_darwin_inferior (inf);
2080 darwin_check_osabi (priv, inferior_ptid.tid ());
2082 darwin_setup_fake_stop_event (inf);
2084 priv->no_ptrace = 1;
2087 /* Take a program previously attached to and detaches it.
2088 The program resumes execution and will no longer stop
2089 on signals, etc. We'd better not have left any breakpoints
2090 in the program or it'll die when it hits one. For this
2091 to work, it may be necessary for the process to have been
2092 previously attached. It *might* work if the program was
2093 started via fork. */
2096 darwin_nat_target::detach (inferior *inf, int from_tty)
2098 darwin_inferior *priv = get_darwin_inferior (inf);
2102 /* Display message. */
2103 target_announce_detach (from_tty);
2105 /* If ptrace() is in use, stop the process. */
2106 if (!priv->no_ptrace)
2107 darwin_stop_inferior (inf);
2109 kret = darwin_restore_exception_ports (priv);
2110 MACH_CHECK_ERROR (kret);
2112 if (!priv->no_ptrace)
2114 res = PTRACE (PT_DETACH, inf->pid, 0, 0);
2116 printf_unfiltered (_("Unable to detach from process-id %d: %s (%d)"),
2117 inf->pid, safe_strerror (errno), errno);
2120 darwin_reply_to_all_pending_messages (inf);
2122 /* When using ptrace, we have just performed a PT_DETACH, which
2123 resumes the inferior. On the other hand, when we are not using
2124 ptrace, we need to resume its execution ourselves. */
2125 if (priv->no_ptrace)
2126 darwin_resume_inferior (inf);
2132 darwin_nat_target::pid_to_str (ptid_t ptid)
2134 static char buf[80];
2135 long tid = ptid.tid ();
2139 snprintf (buf, sizeof (buf), _("Thread 0x%lx of process %u"),
2144 return normal_pid_to_str (ptid);
2148 darwin_nat_target::thread_alive (ptid_t ptid)
2153 /* If RDADDR is not NULL, read inferior task's LEN bytes from ADDR and
2154 copy it to RDADDR in gdb's address space.
2155 If WRADDR is not NULL, write gdb's LEN bytes from WRADDR and copy it
2156 to ADDR in inferior task's address space.
2157 Return 0 on failure; number of bytes read / writen otherwise. */
2160 darwin_read_write_inferior (task_t task, CORE_ADDR addr,
2161 gdb_byte *rdaddr, const gdb_byte *wraddr,
2165 mach_vm_size_t res_length = 0;
2167 inferior_debug (8, _("darwin_read_write_inferior(task=0x%x, %s, len=%s)\n"),
2168 task, core_addr_to_string (addr), pulongest (length));
2173 mach_vm_size_t count;
2175 /* According to target.h(to_xfer_partial), one and only one may be
2177 gdb_assert (wraddr == NULL);
2179 kret = mach_vm_read_overwrite (task, addr, length,
2180 (mach_vm_address_t) rdaddr, &count);
2181 if (kret != KERN_SUCCESS)
2184 (1, _("darwin_read_write_inferior: mach_vm_read failed at %s: %s"),
2185 core_addr_to_string (addr), mach_error_string (kret));
2192 gdb_assert (wraddr != NULL);
2196 mach_vm_address_t offset = addr & (mach_page_size - 1);
2197 mach_vm_address_t region_address = (mach_vm_address_t) (addr - offset);
2198 mach_vm_size_t aligned_length =
2199 (mach_vm_size_t) PAGE_ROUND (offset + length);
2200 vm_region_submap_short_info_data_64_t info;
2201 mach_msg_type_number_t count = VM_REGION_SUBMAP_SHORT_INFO_COUNT_64;
2202 natural_t region_depth = 1000;
2203 mach_vm_address_t region_start = region_address;
2204 mach_vm_size_t region_length;
2205 mach_vm_size_t write_length;
2207 /* Read page protection. */
2208 kret = mach_vm_region_recurse
2209 (task, ®ion_start, ®ion_length, ®ion_depth,
2210 (vm_region_recurse_info_t) &info, &count);
2212 if (kret != KERN_SUCCESS)
2214 inferior_debug (1, _("darwin_read_write_inferior: "
2215 "mach_vm_region_recurse failed at %s: %s\n"),
2216 core_addr_to_string (region_address),
2217 mach_error_string (kret));
2222 (9, _("darwin_read_write_inferior: "
2223 "mach_vm_region_recurse addr=%s, start=%s, len=%s\n"),
2224 core_addr_to_string (region_address),
2225 core_addr_to_string (region_start),
2226 core_addr_to_string (region_length));
2228 /* Check for holes in memory. */
2229 if (region_start > region_address)
2231 warning (_("No memory at %s (vs %s+0x%x). Nothing written"),
2232 core_addr_to_string (region_address),
2233 core_addr_to_string (region_start),
2234 (unsigned)region_length);
2238 /* Adjust the length. */
2239 region_length -= (region_address - region_start);
2240 if (region_length > aligned_length)
2241 region_length = aligned_length;
2243 /* Make the pages RW. */
2244 if (!(info.protection & VM_PROT_WRITE))
2246 vm_prot_t prot = VM_PROT_READ | VM_PROT_WRITE;
2248 kret = mach_vm_protect (task, region_address, region_length,
2250 if (kret != KERN_SUCCESS)
2252 prot |= VM_PROT_COPY;
2253 kret = mach_vm_protect (task, region_address, region_length,
2256 if (kret != KERN_SUCCESS)
2258 warning (_("darwin_read_write_inferior: "
2259 "mach_vm_protect failed at %s "
2260 "(len=0x%lx, prot=0x%x): %s"),
2261 core_addr_to_string (region_address),
2262 (unsigned long) region_length, (unsigned) prot,
2263 mach_error_string (kret));
2268 if (offset + length > region_length)
2269 write_length = region_length - offset;
2271 write_length = length;
2274 kret = mach_vm_write (task, addr, (vm_offset_t) wraddr, write_length);
2275 if (kret != KERN_SUCCESS)
2277 warning (_("darwin_read_write_inferior: mach_vm_write failed: %s"),
2278 mach_error_string (kret));
2282 /* Restore page rights. */
2283 if (!(info.protection & VM_PROT_WRITE))
2285 kret = mach_vm_protect (task, region_address, region_length,
2286 FALSE, info.protection);
2287 if (kret != KERN_SUCCESS)
2289 warning (_("darwin_read_write_inferior: "
2290 "mach_vm_protect restore failed at %s "
2292 core_addr_to_string (region_address),
2293 (unsigned long) region_length,
2294 mach_error_string (kret));
2298 addr += write_length;
2299 wraddr += write_length;
2300 res_length += write_length;
2301 length -= write_length;
2307 /* Read LENGTH bytes at offset ADDR of task_dyld_info for TASK, and copy them
2308 to RDADDR (in big endian).
2309 Return 0 on failure; number of bytes read / written otherwise. */
2311 #ifdef TASK_DYLD_INFO_COUNT
2312 /* This is not available in Darwin 9. */
2313 static enum target_xfer_status
2314 darwin_read_dyld_info (task_t task, CORE_ADDR addr, gdb_byte *rdaddr,
2315 ULONGEST length, ULONGEST *xfered_len)
2317 struct task_dyld_info task_dyld_info;
2318 mach_msg_type_number_t count = TASK_DYLD_INFO_COUNT;
2321 if (addr != 0 || length > sizeof (mach_vm_address_t))
2322 return TARGET_XFER_EOF;
2324 kret = task_info (task, TASK_DYLD_INFO,
2325 (task_info_t) &task_dyld_info, &count);
2326 MACH_CHECK_ERROR (kret);
2327 if (kret != KERN_SUCCESS)
2328 return TARGET_XFER_E_IO;
2330 store_unsigned_integer (rdaddr, length, BFD_ENDIAN_BIG,
2331 task_dyld_info.all_image_info_addr);
2332 *xfered_len = (ULONGEST) length;
2333 return TARGET_XFER_OK;
2339 enum target_xfer_status
2340 darwin_nat_target::xfer_partial (enum target_object object, const char *annex,
2341 gdb_byte *readbuf, const gdb_byte *writebuf,
2342 ULONGEST offset, ULONGEST len,
2343 ULONGEST *xfered_len)
2345 struct inferior *inf = current_inferior ();
2346 darwin_inferior *priv = get_darwin_inferior (inf);
2349 (8, _("darwin_xfer_partial(%s, %s, rbuf=%s, wbuf=%s) pid=%u\n"),
2350 core_addr_to_string (offset), pulongest (len),
2351 host_address_to_string (readbuf), host_address_to_string (writebuf),
2356 case TARGET_OBJECT_MEMORY:
2358 int l = darwin_read_write_inferior (priv->task, offset,
2359 readbuf, writebuf, len);
2362 return TARGET_XFER_EOF;
2366 *xfered_len = (ULONGEST) l;
2367 return TARGET_XFER_OK;
2370 #ifdef TASK_DYLD_INFO_COUNT
2371 case TARGET_OBJECT_DARWIN_DYLD_INFO:
2372 if (writebuf != NULL || readbuf == NULL)
2374 /* Support only read. */
2375 return TARGET_XFER_E_IO;
2377 return darwin_read_dyld_info (priv->task, offset, readbuf, len,
2381 return TARGET_XFER_E_IO;
2387 set_enable_mach_exceptions (const char *args, int from_tty,
2388 struct cmd_list_element *c)
2390 if (inferior_ptid != null_ptid)
2392 struct inferior *inf = current_inferior ();
2393 darwin_inferior *priv = get_darwin_inferior (inf);
2394 exception_mask_t mask;
2397 if (enable_mach_exceptions)
2398 mask = EXC_MASK_ALL;
2401 darwin_restore_exception_ports (priv);
2402 mask = EXC_MASK_SOFTWARE | EXC_MASK_BREAKPOINT;
2404 kret = task_set_exception_ports (priv->task, mask, darwin_ex_port,
2405 EXCEPTION_DEFAULT, THREAD_STATE_NONE);
2406 MACH_CHECK_ERROR (kret);
2411 darwin_nat_target::pid_to_exec_file (int pid)
2413 static char path[PATH_MAX];
2416 res = proc_pidinfo (pid, PROC_PIDPATHINFO, 0, path, PATH_MAX);
2424 darwin_nat_target::get_ada_task_ptid (long lwp, long thread)
2426 struct inferior *inf = current_inferior ();
2427 darwin_inferior *priv = get_darwin_inferior (inf);
2429 mach_port_name_array_t names;
2430 mach_msg_type_number_t names_count;
2431 mach_port_type_array_t types;
2432 mach_msg_type_number_t types_count;
2435 /* First linear search. */
2436 for (darwin_thread_t *t : priv->threads)
2438 if (t->inf_port == lwp)
2439 return ptid_t (inferior_ptid.pid (), 0, t->gdb_port);
2442 /* Maybe the port was never extract. Do it now. */
2444 /* First get inferior port names. */
2445 kret = mach_port_names (priv->task, &names, &names_count, &types,
2447 MACH_CHECK_ERROR (kret);
2448 if (kret != KERN_SUCCESS)
2451 /* For each name, copy the right in the gdb space and then compare with
2452 our view of the inferior threads. We don't forget to deallocate the
2454 for (int i = 0; i < names_count; i++)
2456 mach_port_t local_name;
2457 mach_msg_type_name_t local_type;
2459 /* We just need to know the corresponding name in gdb name space.
2460 So extract and deallocate the right. */
2461 kret = mach_port_extract_right (priv->task, names[i],
2462 MACH_MSG_TYPE_COPY_SEND,
2463 &local_name, &local_type);
2464 if (kret != KERN_SUCCESS)
2466 mach_port_deallocate (gdb_task, local_name);
2468 for (darwin_thread_t *t : priv->threads)
2470 if (t->gdb_port == local_name)
2472 t->inf_port = names[i];
2473 if (names[i] == lwp)
2479 vm_deallocate (gdb_task, (vm_address_t) names,
2480 names_count * sizeof (mach_port_t));
2483 return ptid_t (inferior_ptid.pid (), 0, res);
2489 darwin_nat_target::supports_multi_process ()
2495 _initialize_darwin_nat ()
2499 gdb_task = mach_task_self ();
2500 darwin_host_self = mach_host_self ();
2502 /* Read page size. */
2503 kret = host_page_size (darwin_host_self, &mach_page_size);
2504 if (kret != KERN_SUCCESS)
2506 mach_page_size = 0x1000;
2507 MACH_CHECK_ERROR (kret);
2510 inferior_debug (2, _("GDB task: 0x%lx, pid: %d\n"),
2511 (unsigned long) mach_task_self (), getpid ());
2513 add_setshow_zuinteger_cmd ("darwin", class_obscure,
2514 &darwin_debug_flag, _("\
2515 Set if printing inferior communication debugging statements."), _("\
2516 Show if printing inferior communication debugging statements."), NULL,
2518 &setdebuglist, &showdebuglist);
2520 add_setshow_boolean_cmd ("mach-exceptions", class_support,
2521 &enable_mach_exceptions, _("\
2522 Set if mach exceptions are caught."), _("\
2523 Show if mach exceptions are caught."), _("\
2524 When this mode is on, all low level exceptions are reported before being\n\
2525 reported by the kernel."),
2526 &set_enable_mach_exceptions, NULL,
2527 &setlist, &showlist);