1 /* Interface GDB to the GNU Hurd
2 Copyright (C) 1992, 1995, 1996, 1997 Free Software Foundation, Inc.
4 This file is part of GDB.
10 This program is free software; you can redistribute it and/or modify
11 it under the terms of the GNU General Public License as published by
12 the Free Software Foundation; either version 2 of the License, or
13 (at your option) any later version.
15 This program is distributed in the hope that it will be useful,
16 but WITHOUT ANY WARRANTY; without even the implied warranty of
17 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 GNU General Public License for more details.
20 You should have received a copy of the GNU General Public License
21 along with this program; if not, write to the Free Software
22 Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
31 #include <sys/ptrace.h>
33 /* We include this because we don't need the access macros and they conflict
34 with gdb's definitions (ick). This is very non standard! */
35 #include <waitflags.h>
38 #include <mach/message.h>
39 #include <mach/notify.h>
40 #include <mach_error.h>
41 #include <mach/exception.h>
42 #include <mach/vm_attributes.h>
44 #include <hurd/process.h>
45 #include <hurd/process_request.h>
47 #include <hurd/msg_request.h>
48 #include <hurd/signal.h>
49 #include <hurd/interrupt.h>
50 #include <hurd/sigpreempt.h>
66 #include "exc_request_S.h"
68 #include "process_reply_S.h"
69 #include "msg_reply_S.h"
70 #include "exc_request_U.h"
73 static process_t proc_server = MACH_PORT_NULL;
75 /* If we've sent a proc_wait_request to the proc server, the pid of the
76 process we asked about. We can only ever have one outstanding. */
77 int proc_wait_pid = 0;
79 /* The number of wait requests we've sent, and expect replies from. */
80 int proc_waits_pending = 0;
82 int gnu_debug_flag = 0;
86 extern struct target_ops gnu_ops;
87 extern char *strerror();
89 int inf_update_procs (struct inf *inf);
90 struct inf *make_inf ();
91 void inf_clear_wait (struct inf *inf);
92 void inf_cleanup (struct inf *inf);
93 void inf_startup (struct inf *inf, int pid);
94 int inf_update_suspends (struct inf *inf);
95 void inf_set_pid (struct inf *inf, pid_t pid);
96 void inf_validate_procs (struct inf *inf);
97 void inf_steal_exc_ports (struct inf *inf);
98 void inf_restore_exc_ports (struct inf *inf);
99 struct proc *inf_tid_to_proc (struct inf *inf, int tid);
100 inline void inf_set_threads_resume_sc (struct inf *inf,
101 struct proc *run_thread,
103 inline int inf_set_threads_resume_sc_for_signal_thread (struct inf *inf);
104 inline void inf_suspend (struct inf *inf);
105 inline void inf_resume (struct inf *inf);
106 void inf_set_step_thread (struct inf *inf, struct proc *proc);
107 void inf_detach (struct inf *inf);
108 void inf_attach (struct inf *inf, int pid);
109 void inf_signal (struct inf *inf, enum target_signal sig);
111 #define inf_debug(_inf, msg, args...) \
112 do { struct inf *__inf = (_inf); \
113 debug ("{inf %d %p}: " msg, __inf->pid, __inf , ##args); } while (0)
115 void proc_abort (struct proc *proc, int force);
116 thread_state_t proc_get_state (struct proc *proc, int force);
117 struct proc *make_proc (struct inf *inf, mach_port_t port, int tid);
118 struct proc *_proc_free (struct proc *proc);
119 int proc_update_sc (struct proc *proc);
120 error_t proc_get_exception_port (struct proc *proc, mach_port_t *port);
121 error_t proc_set_exception_port (struct proc *proc, mach_port_t port);
122 static mach_port_t _proc_get_exc_port (struct proc *proc);
123 void proc_steal_exc_port (struct proc *proc, mach_port_t exc_port);
124 void proc_restore_exc_port (struct proc *proc);
125 int proc_trace (struct proc *proc, int set);
126 char *proc_string (struct proc *proc);
128 /* Evaluate RPC_EXPR in a scope with the variables MSGPORT and REFPORT bound
129 to INF's msg port and task port respectively. If it has no msg port,
130 EIEIO is returned. INF must refer to a running process! */
131 #define INF_MSGPORT_RPC(inf, rpc_expr) \
132 HURD_MSGPORT_RPC (proc_getmsgport (proc_server, inf->pid, &msgport), \
133 (refport = inf->task->port, 0), 0, \
134 msgport ? (rpc_expr) : EIEIO)
136 /* Like INF_MSGPORT_RPC, but will also resume the signal thread to ensure
137 there's someone around to deal with the RPC (and resuspend things
138 afterwards). This effects INF's threads' resume_sc count. */
139 #define INF_RESUME_MSGPORT_RPC(inf, rpc_expr) \
140 (inf_set_threads_resume_sc_for_signal_thread (inf) \
143 __e = INF_MSGPORT_RPC (inf, rpc_expr); \
148 #define MIG_SERVER_DIED EMIG_SERVER_DIED /* XXX */
150 /* The state passed by an exception message. */
153 int exception; /* The exception code */
155 mach_port_t handler; /* The real exception port to handle this. */
156 mach_port_t reply; /* The reply port from the exception call. */
159 /* The results of the last wait an inf did. */
162 struct target_waitstatus status; /* The status returned to gdb. */
163 struct exc_state exc; /* The exception that caused us to return. */
164 struct proc *thread; /* The thread in question. */
165 int suppress; /* Something trivial happened. */
168 /* The state of an inferior. */
171 /* Fields describing the current inferior. */
173 struct proc *task; /* The mach task. */
174 struct proc *threads; /* A linked list of all threads in TASK. */
176 /* True if THREADS needn't be validated by querying the task. We assume that
177 we and the task in question are the only ones frobbing the thread list,
178 so as long as we don't let any code run, we don't have to worry about
180 int threads_up_to_date;
182 pid_t pid; /* The real system PID. */
184 struct inf_wait wait; /* What to return from target_wait. */
186 /* One thread proc in INF may be in `single-stepping mode'. This is it. */
187 struct proc *step_thread;
189 /* The thread we think is the signal thread. */
190 struct proc *signal_thread;
192 mach_port_t event_port; /* Where we receive various msgs. */
194 /* True if we think at least one thread in the inferior could currently be
198 /* True if the process has stopped (in the proc server sense). Note that
199 since a proc server `stop' leaves the signal thread running, the inf can
200 be RUNNING && STOPPED... */
203 /* True if the inferior is traced. */
206 /* True if we shouldn't try waiting for the inferior, usually because we
207 can't for some reason. */
210 /* When starting a new inferior, we don't try to validate threads until all
211 the proper execs have been done. This is a count of how many execs we
213 unsigned pending_execs;
215 /* Fields describing global state */
217 /* The task suspend count used when gdb has control. This is normally 1 to
218 make things easier for us, but sometimes (like when attaching to vital
219 system servers) it may be desirable to let the task continue to run
220 (pausing individual threads as necessary). */
223 /* The task suspend count left when detaching from a task. */
226 /* The initial values used for the run_sc and pause_sc of newly discovered
227 threads -- see the definition of those fields in struct proc. */
228 int default_thread_run_sc;
229 int default_thread_pause_sc;
230 int default_thread_detach_sc;
232 /* True if the process should be traced when started/attached. Newly
233 started processes *must* be traced at first to exec them properly, but
234 if this is false, tracing is turned off as soon it has done so. */
237 /* True if exceptions from the inferior process should be trapped. This
238 must be on to use breakpoints. */
243 int __proc_pid (struct proc *proc)
245 return proc->inf->pid;
248 /* Update PROC's real suspend count to match it's desired one. Returns true
249 if we think PROC is now in a runnable state. */
251 proc_update_sc (struct proc *proc)
255 int delta = proc->sc - proc->cur_sc;
258 proc_debug (proc, "sc: %d --> %d", proc->cur_sc, proc->sc);
260 if (proc->sc == 0 && proc->state_changed)
261 /* Since PROC may start running, we must write back any state changes. */
263 assert (proc_is_thread (proc));
264 proc_debug (proc, "storing back changed thread state");
265 err = thread_set_state (proc->port, THREAD_STATE_FLAVOR,
266 (thread_state_t)&proc->state, THREAD_STATE_SIZE);
268 proc->state_changed = 0;
272 while (delta-- > 0 && !err)
273 if (proc_is_task (proc))
274 err = task_suspend (proc->port);
276 err = thread_suspend (proc->port);
278 while (delta++ < 0 && !err)
279 if (proc_is_task (proc))
280 err = task_resume (proc->port);
282 err = thread_resume (proc->port);
285 proc->cur_sc = proc->sc;
287 /* If we got an error, then the task/thread has disappeared. */
288 running = !err && proc->sc == 0;
290 proc_debug (proc, "is %s", err ? "dead" : running ? "running" : "suspended");
292 proc_debug (proc, "err = %s", strerror (err));
297 proc->state_valid = proc->state_changed = 0;
298 proc->fetched_regs = 0;
304 /* Thread_abort is called on PROC if needed. PROC must be a thread proc.
305 If PROC is deemed `precious', then nothing is done unless FORCE is true.
306 In particular, a thread is precious if it's running (in which case forcing
307 it includes suspending it first), or if it has an exception pending. */
309 proc_abort (struct proc *proc, int force)
311 assert (proc_is_thread (proc));
315 struct inf *inf = proc->inf;
316 int running = (proc->cur_sc == 0 && inf->task->cur_sc == 0);
318 if (running && force)
321 inf_update_suspends (proc->inf);
323 warning ("Stopped %s.", proc_string (proc));
325 else if (proc == inf->wait.thread && inf->wait.exc.reply && !force)
326 /* An exception is pending on PROC, which don't mess with. */
330 /* We only abort the thread if it's not actually running. */
332 thread_abort (proc->port);
333 proc_debug (proc, "aborted");
337 proc_debug (proc, "not aborting");
341 /* Make sure that the state field in PROC is up to date, and return a pointer
342 to it, or 0 if something is wrong. If WILL_MODIFY is true, makes sure
343 that the thread is stopped and aborted first, and sets the state_changed
344 field in PROC to true. */
346 proc_get_state (struct proc *proc, int will_modify)
348 int was_aborted = proc->aborted;
350 proc_debug (proc, "updating state info%s",
351 will_modify ? " (with intention to modify)" : "");
353 proc_abort (proc, will_modify);
355 if (! was_aborted && proc->aborted)
356 /* PROC's state may have changed since we last fetched it. */
357 proc->state_valid = 0;
359 if (! proc->state_valid)
361 mach_msg_type_number_t state_size = THREAD_STATE_SIZE;
363 thread_get_state (proc->port, THREAD_STATE_FLAVOR,
364 (thread_state_t)&proc->state, &state_size);
365 proc_debug (proc, "getting thread state");
366 proc->state_valid = !err;
369 if (proc->state_valid)
372 proc->state_changed = 1;
373 return (thread_state_t)&proc->state;
379 /* Set PORT to PROC's exception port. */
381 proc_get_exception_port (struct proc *proc, mach_port_t *port)
383 if (proc_is_task (proc))
384 return task_get_exception_port (proc->port, port);
386 return thread_get_exception_port (proc->port, port);
389 /* Set PROC's exception port to PORT. */
391 proc_set_exception_port (struct proc *proc, mach_port_t port)
393 proc_debug (proc, "setting exception port: %d", port);
394 if (proc_is_task (proc))
395 return task_set_exception_port (proc->port, port);
397 return thread_set_exception_port (proc->port, port);
400 /* Get PROC's exception port, cleaning up a bit if proc has died. */
402 _proc_get_exc_port (struct proc *proc)
404 mach_port_t exc_port;
405 error_t err = proc_get_exception_port (proc, &exc_port);
408 /* PROC must be dead. */
411 mach_port_deallocate (mach_task_self (), proc->exc_port);
412 proc->exc_port = MACH_PORT_NULL;
413 if (proc->saved_exc_port)
414 mach_port_deallocate (mach_task_self (), proc->saved_exc_port);
415 proc->saved_exc_port = MACH_PORT_NULL;
421 /* Replace PROC's exception port with EXC_PORT, unless it's already been
422 done. Stash away any existing exception port so we can restore it later. */
424 proc_steal_exc_port (struct proc *proc, mach_port_t exc_port)
426 mach_port_t cur_exc_port = _proc_get_exc_port (proc);
432 proc_debug (proc, "inserting exception port: %d", exc_port);
434 if (cur_exc_port != exc_port)
435 /* Put in our exception port. */
436 err = proc_set_exception_port (proc, exc_port);
438 if (err || cur_exc_port == proc->exc_port)
439 /* We previously set the exception port, and it's still set. So we
440 just keep the old saved port which is what the proc set. */
443 mach_port_deallocate (mach_task_self (), cur_exc_port);
446 /* Keep a copy of PROC's old exception port so it can be restored. */
448 if (proc->saved_exc_port)
449 mach_port_deallocate (mach_task_self (), proc->saved_exc_port);
450 proc->saved_exc_port = cur_exc_port;
453 proc_debug (proc, "saved exception port: %d", proc->saved_exc_port);
456 proc->exc_port = exc_port;
458 warning ("Error setting exception port for %s: %s",
459 proc_string (proc), strerror (err));
463 /* If we previously replaced PROC's exception port, put back what we
464 found there at the time, unless *our* exception port has since been
465 overwritten, in which case who knows what's going on. */
467 proc_restore_exc_port (struct proc *proc)
469 mach_port_t cur_exc_port = _proc_get_exc_port (proc);
475 proc_debug (proc, "restoring real exception port");
477 if (proc->exc_port == cur_exc_port)
478 /* Our's is still there. */
479 err = proc_set_exception_port (proc, proc->saved_exc_port);
481 if (proc->saved_exc_port)
482 mach_port_deallocate (mach_task_self (), proc->saved_exc_port);
483 proc->saved_exc_port = MACH_PORT_NULL;
486 proc->exc_port = MACH_PORT_NULL;
488 warning ("Error setting exception port for %s: %s",
489 proc_string (proc), strerror (err));
493 /* Turns hardware tracing in PROC on or off when SET is true or false,
494 respectively. Returns true on success. */
496 proc_trace (struct proc *proc, int set)
498 thread_state_t state = proc_get_state (proc, 1);
501 return 0; /* the thread must be dead. */
503 proc_debug (proc, "tracing %s", set ? "on" : "off");
507 /* XXX We don't get the exception unless the thread has its own
508 exception port???? */
509 if (proc->exc_port == MACH_PORT_NULL)
510 proc_steal_exc_port (proc, proc->inf->event_port);
511 THREAD_STATE_SET_TRACED (state);
514 THREAD_STATE_CLEAR_TRACED (state);
519 /* A variable from which to assign new TIDs. */
520 static int next_thread_id = 1;
522 /* Returns a new proc structure with the given fields. Also adds a
523 notification for PORT becoming dead to be sent to INF's notify port. */
525 make_proc (struct inf *inf, mach_port_t port, int tid)
528 mach_port_t prev_port = MACH_PORT_NULL;
529 struct proc *proc = malloc (sizeof (struct proc));
535 proc->saved_exc_port = MACH_PORT_NULL;
536 proc->exc_port = MACH_PORT_NULL;
541 /* Note that these are all the values for threads; the task simply uses the
542 corresponding field in INF directly. */
543 proc->run_sc = inf->default_thread_run_sc;
544 proc->pause_sc = inf->default_thread_pause_sc;
545 proc->detach_sc = inf->default_thread_detach_sc;
546 proc->resume_sc = proc->run_sc;
550 proc->state_valid = 0;
551 proc->state_changed = 0;
553 proc_debug (proc, "is new");
555 /* Get notified when things die. */
557 mach_port_request_notification (mach_task_self(), port,
558 MACH_NOTIFY_DEAD_NAME, 1,
560 MACH_MSG_TYPE_MAKE_SEND_ONCE,
563 warning ("Couldn't request notification for port %d: %s",
564 port, strerror (err));
567 proc_debug (proc, "notifications to: %d", inf->event_port);
568 if (prev_port != MACH_PORT_NULL)
569 mach_port_deallocate (mach_task_self (), prev_port);
572 if (inf->want_exceptions)
573 if (proc_is_task (proc))
574 /* Make the task exception port point to us. */
575 proc_steal_exc_port (proc, inf->event_port);
577 /* Just clear thread exception ports -- they default to the task one. */
578 proc_steal_exc_port (proc, MACH_PORT_NULL);
583 /* Frees PROC and any resources it uses, and returns the value of PROC's
586 _proc_free (struct proc *proc)
588 struct inf *inf = proc->inf;
589 struct proc *next = proc->next;
591 proc_debug (proc, "freeing...");
593 if (proc == inf->step_thread)
594 /* Turn off single stepping. */
595 inf_set_step_thread (inf, 0);
596 if (proc == inf->wait.thread)
597 inf_clear_wait (inf);
598 if (proc == inf->signal_thread)
599 inf->signal_thread = 0;
601 if (proc->port != MACH_PORT_NULL)
603 if (proc->exc_port != MACH_PORT_NULL)
604 /* Restore the original exception port. */
605 proc_restore_exc_port (proc);
606 if (proc->cur_sc != 0)
607 /* Resume the thread/task. */
610 proc_update_sc (proc);
612 mach_port_deallocate (mach_task_self (), proc->port);
619 struct inf *make_inf ()
621 struct inf *inf = malloc (sizeof (struct inf));
628 inf->threads_up_to_date = 0;
630 inf->wait.status.kind = TARGET_WAITKIND_SPURIOUS;
631 inf->wait.thread = 0;
632 inf->wait.exc.handler = MACH_PORT_NULL;
633 inf->wait.exc.reply = MACH_PORT_NULL;
634 inf->step_thread = 0;
635 inf->signal_thread = 0;
636 inf->event_port = MACH_PORT_NULL;
641 inf->pending_execs = 0;
644 inf->default_thread_run_sc = 0;
645 inf->default_thread_pause_sc = 0;
646 inf->default_thread_detach_sc = 0;
647 inf->want_signals = 1; /* By default */
648 inf->want_exceptions = 1; /* By default */
653 /* clear INF's target wait status. */
655 inf_clear_wait (struct inf *inf)
657 inf_debug (inf, "clearing wait");
658 inf->wait.status.kind = TARGET_WAITKIND_SPURIOUS;
659 inf->wait.thread = 0;
660 inf->wait.suppress = 0;
661 if (inf->wait.exc.handler != MACH_PORT_NULL)
663 mach_port_deallocate (mach_task_self (), inf->wait.exc.handler);
664 inf->wait.exc.handler = MACH_PORT_NULL;
666 if (inf->wait.exc.reply != MACH_PORT_NULL)
668 mach_port_deallocate (mach_task_self (), inf->wait.exc.reply);
669 inf->wait.exc.reply = MACH_PORT_NULL;
674 inf_cleanup (struct inf *inf)
676 inf_debug (inf, "cleanup");
678 inf_clear_wait (inf);
680 inf_set_pid (inf, -1);
686 inf->pending_execs = 0;
690 mach_port_destroy (mach_task_self (), inf->event_port);
691 inf->event_port = MACH_PORT_NULL;
696 inf_startup (struct inf *inf, int pid)
700 inf_debug (inf, "startup: pid = %d", pid);
704 /* Make the port on which we receive all events. */
705 err = mach_port_allocate (mach_task_self (),
706 MACH_PORT_RIGHT_RECEIVE, &inf->event_port);
708 error ("Error allocating event port: %s", strerror (err));
710 /* Make a send right for it, so we can easily copy it for other people. */
711 mach_port_insert_right (mach_task_self (), inf->event_port,
712 inf->event_port, MACH_MSG_TYPE_MAKE_SEND);
713 inf_set_pid (inf, pid);
716 /* close current process, if any, and attach INF to process PORT */
718 inf_set_pid (struct inf *inf, pid_t pid)
721 struct proc *task = inf->task;
723 inf_debug (inf, "setting pid: %d", pid);
726 task_port = MACH_PORT_NULL;
729 error_t err = proc_pid2task (proc_server, pid, &task_port);
731 error ("Error getting task for pid %d: %s", pid, strerror (err));
734 inf_debug (inf, "setting task: %d", task_port);
737 task_suspend (task_port);
739 if (task && task->port != task_port)
742 inf_validate_procs (inf); /* Trash all the threads. */
743 _proc_free (task); /* And the task. */
746 if (task_port != MACH_PORT_NULL)
748 inf->task = make_proc (inf, task_port, PROC_TID_TASK);
749 inf->threads_up_to_date = 0;
756 inf->task->sc = inf->task->cur_sc = 1; /* Reflect task_suspend above */
762 /* Validates INF's stopped field from the actual proc server state. */
764 inf_validate_stopped (struct inf *inf)
767 mach_msg_type_number_t noise_len = 0;
769 mach_msg_type_number_t pi_len = 0;
772 proc_getprocinfo (proc_server, inf->pid, &info_flags,
773 (procinfo_t *)&pi, &pi_len, &noise, &noise_len);
777 inf->stopped = !!(pi->state & PI_STOPPED);
778 vm_deallocate (mach_task_self (), (vm_address_t)pi, pi_len);
780 vm_deallocate (mach_task_self (), (vm_address_t)noise, noise_len);
784 /* Validates INF's task suspend count. If it's higher than we expect, verify
785 with the user before `stealing' the extra count. */
787 inf_validate_task_sc (struct inf *inf)
789 struct task_basic_info info;
790 mach_msg_type_number_t info_len = TASK_BASIC_INFO_COUNT;
792 task_info (inf->task->port, TASK_BASIC_INFO, (task_info_t)&info, &info_len);
795 inf->task->dead = 1; /* oh well */
796 else if (inf->task->cur_sc < info.suspend_count)
800 target_terminal_ours (); /* Allow I/O. */
802 !query ("Pid %d has an additional task suspend count of %d; clear it? ",
803 inf->pid, info.suspend_count - inf->task->cur_sc);
804 target_terminal_inferior (); /* Give it back to the child. */
807 error ("Additional task suspend count left untouched.");
809 inf->task->cur_sc = info.suspend_count;
813 /* Turns tracing for INF on or off, depending on ON, unless it already is.
814 If INF is running, the resume_sc count of INF's threads will be modified,
815 and the signal thread will briefly be run to change the trace state. */
817 inf_set_traced (struct inf *inf, int on)
819 if (on != inf->traced)
820 if (inf->task && !inf->task->dead)
821 /* Make it take effect immediately. */
823 sigset_t mask = on ? ~(sigset_t)0 : 0;
825 INF_RESUME_MSGPORT_RPC (inf, msg_set_init_int (msgport, refport,
826 INIT_TRACEMASK, mask));
830 warning ("Can't modify tracing state for pid %d: No signal thread",
835 warning ("Can't modify tracing state for pid %d: %s",
836 inf->pid, strerror (err));
844 /* Makes all the real suspend count deltas of all the procs in INF match the
845 desired values. Careful to always do thread/task suspend counts in the
846 safe order. Returns true if at least one thread is thought to be running.*/
848 inf_update_suspends (struct inf *inf)
850 struct proc *task = inf->task;
851 /* We don't have to update INF->threads even though we're iterating over it
852 because we'll change a thread only if it already has an existing proc
855 inf_debug (inf, "updating suspend counts");
860 int task_running = (task->sc == 0), thread_running = 0;
862 if (task->sc > task->cur_sc)
863 /* The task is becoming _more_ suspended; do before any threads. */
864 task_running = proc_update_sc (task);
866 if (inf->pending_execs)
867 /* When we're waiting for an exec, things may be happening behind our
868 back, so be conservative. */
871 /* Do all the thread suspend counts. */
872 for (thread = inf->threads; thread; thread = thread->next)
873 thread_running |= proc_update_sc (thread);
875 if (task->sc != task->cur_sc)
876 /* We didn't do the task first, because we wanted to wait for the
877 threads; do it now. */
878 task_running = proc_update_sc (task);
880 inf_debug (inf, "%srunning...",
881 (thread_running && task_running) ? "" : "not ");
883 inf->running = thread_running && task_running;
885 /* Once any thread has executed some code, we can't depend on the
886 threads list any more. */
888 inf->threads_up_to_date = 0;
896 /* Converts a GDB pid to a struct proc. */
898 inf_tid_to_thread (struct inf *inf, int tid)
900 struct proc *thread = inf->threads;
903 if (thread->tid == tid)
906 thread = thread->next;
910 /* Converts a thread port to a struct proc. */
912 inf_port_to_thread (struct inf *inf, mach_port_t port)
914 struct proc *thread = inf->threads;
916 if (thread->port == port)
919 thread = thread->next;
923 /* Make INF's list of threads be consistent with reality of TASK. */
925 inf_validate_procs (struct inf *inf)
928 thread_array_t threads;
929 unsigned num_threads;
930 struct proc *task = inf->task;
932 /* If no threads are currently running, this function will guarantee that
933 things are up to date. The exception is if there are zero threads --
934 then it is almost certainly in an odd state, and probably some outside
935 agent will create threads. */
936 inf->threads_up_to_date = inf->threads ? !inf->running : 0;
940 error_t err = task_threads (task->port, &threads, &num_threads);
941 inf_debug (inf, "fetching threads");
943 /* TASK must be dead. */
953 inf_debug (inf, "no task");
957 unsigned search_start = 0; /* Make things normally linear. */
958 /* Which thread in PROCS corresponds to each task thread, & the task. */
959 struct proc *matched[num_threads + 1];
960 /* The last thread in INF->threads, so we can add to the end. */
961 struct proc *last = 0;
962 /* The current thread we're considering. */
963 struct proc *thread = inf->threads;
965 bzero (matched, sizeof (matched));
971 for (i = search_start, left = num_threads; left; i++, left--)
973 if (i >= num_threads)
974 i -= num_threads; /* I wrapped around. */
975 if (thread->port == threads[i])
976 /* We already know about this thread. */
980 thread = thread->next;
988 proc_debug (thread, "died!");
989 thread->port = MACH_PORT_NULL;
990 thread = _proc_free (thread); /* THREAD is dead. */
991 (last ? last->next : inf->threads) = thread;
995 for (i = 0; i < num_threads; i++)
997 /* Throw away the duplicate send right. */
998 mach_port_deallocate (mach_task_self (), threads[i]);
1000 /* THREADS[I] is a thread we don't know about yet! */
1002 thread = make_proc (inf, threads[i], next_thread_id++);
1003 (last ? last->next : inf->threads) = thread;
1005 proc_debug (thread, "new thread: %d", threads[i]);
1006 add_thread (thread->tid); /* Tell GDB's generic thread code. */
1009 vm_deallocate(mach_task_self(),
1010 (vm_address_t)threads, (num_threads * sizeof(thread_t)));
1014 /* Makes sure that INF's thread list is synced with the actual process. */
1016 inf_update_procs (struct inf *inf)
1020 if (! inf->threads_up_to_date)
1021 inf_validate_procs (inf);
1025 /* Sets the resume_sc of each thread in inf. That of RUN_THREAD is set to 0,
1026 and others are set to their run_sc if RUN_OTHERS is true, and otherwise
1029 inf_set_threads_resume_sc (struct inf *inf,
1030 struct proc *run_thread, int run_others)
1032 struct proc *thread;
1033 inf_update_procs (inf);
1034 for (thread = inf->threads; thread; thread = thread->next)
1035 if (thread == run_thread)
1036 thread->resume_sc = 0;
1037 else if (run_others)
1038 thread->resume_sc = thread->run_sc;
1040 thread->resume_sc = thread->pause_sc;
1043 /* Cause INF to continue execution immediately; individual threads may still
1044 be suspended (but their suspend counts will be updated). */
1046 inf_resume (struct inf *inf)
1048 struct proc *thread;
1050 inf_update_procs (inf);
1052 for (thread = inf->threads; thread; thread = thread->next)
1053 thread->sc = thread->resume_sc;
1057 if (! inf->pending_execs)
1058 /* Try to make sure our task count is correct -- in the case where
1059 we're waiting for an exec though, things are too volatile, so just
1060 assume things will be reasonable (which they usually will be). */
1061 inf_validate_task_sc (inf);
1065 inf_update_suspends (inf);
1068 /* Cause INF to stop execution immediately; individual threads may still
1071 inf_suspend (struct inf *inf)
1073 struct proc *thread;
1075 inf_update_procs (inf);
1077 for (thread = inf->threads; thread; thread = thread->next)
1078 thread->sc = thread->pause_sc;
1081 inf->task->sc = inf->pause_sc;
1083 inf_update_suspends (inf);
1086 /* INF has one thread PROC that is in single-stepping mode. This function
1087 changes it to be PROC, changing any old step_thread to be a normal one. A
1088 PROC of 0 clears any existing value. */
1090 inf_set_step_thread (struct inf *inf, struct proc *thread)
1092 assert (!thread || proc_is_thread (thread));
1095 inf_debug (inf, "setting step thread: %d/%d", inf->pid, thread->tid);
1097 inf_debug (inf, "clearing step thread");
1099 if (inf->step_thread != thread)
1101 if (inf->step_thread && inf->step_thread->port != MACH_PORT_NULL)
1102 if (! proc_trace (inf->step_thread, 0))
1104 if (thread && proc_trace (thread, 1))
1105 inf->step_thread = thread;
1107 inf->step_thread = 0;
1111 /* Set up the thread resume_sc's so that only the signal thread is running
1112 (plus whatever other thread are set to always run). Returns true if we
1113 did so, or false if we can't find a signal thread. */
1115 inf_set_threads_resume_sc_for_signal_thread (struct inf *inf)
1117 if (inf->signal_thread)
1119 inf_set_threads_resume_sc (inf, inf->signal_thread, 0);
1127 inf_update_signal_thread (struct inf *inf)
1129 /* XXX for now we assume that if there's a msgport, the 2nd thread is
1130 the signal thread. */
1131 inf->signal_thread = inf->threads ? inf->threads->next : 0;
1134 /* Detachs from INF's inferior task, letting it run once again... */
1136 inf_detach (struct inf *inf)
1138 struct proc *task = inf->task;
1140 inf_debug (inf, "detaching...");
1142 inf_clear_wait (inf);
1143 inf_set_step_thread (inf, 0);
1147 struct proc *thread;
1149 inf_set_traced (inf, 0);
1151 inf_signal (inf, TARGET_SIGNAL_0);
1153 proc_restore_exc_port (task);
1154 task->sc = inf->detach_sc;
1156 for (thread = inf->threads; thread; thread = thread->next)
1158 proc_restore_exc_port (thread);
1159 thread->sc = thread->detach_sc;
1162 inf_update_suspends (inf);
1168 /* Attaches INF to the process with process id PID, returning it in a suspended
1169 state suitable for debugging. */
1171 inf_attach (struct inf *inf, int pid)
1173 inf_debug (inf, "attaching: %d", pid);
1178 inf_startup (inf, pid);
1181 /* Makes sure that we've got our exception ports entrenched in the process. */
1182 void inf_steal_exc_ports (struct inf *inf)
1184 struct proc *thread;
1186 inf_debug (inf, "stealing exception ports");
1188 inf_set_step_thread (inf, 0); /* The step thread is special. */
1190 proc_steal_exc_port (inf->task, inf->event_port);
1191 for (thread = inf->threads; thread; thread = thread->next)
1192 proc_steal_exc_port (thread, MACH_PORT_NULL);
1195 /* Makes sure the process has its own exception ports. */
1196 void inf_restore_exc_ports (struct inf *inf)
1198 struct proc *thread;
1200 inf_debug (inf, "restoring exception ports");
1202 inf_set_step_thread (inf, 0); /* The step thread is special. */
1204 proc_restore_exc_port (inf->task);
1205 for (thread = inf->threads; thread; thread = thread->next)
1206 proc_restore_exc_port (thread);
1209 /* Deliver signal SIG to INF. If INF is stopped, delivering a signal, even
1210 signal 0, will continue it. INF is assumed to be in a paused state, and
1211 the resume_sc's of INF's threads may be affected. */
1213 inf_signal (struct inf *inf, enum target_signal sig)
1216 int host_sig = target_signal_to_host (sig);
1218 #define NAME target_signal_to_name (sig)
1220 if (host_sig >= _NSIG)
1221 /* A mach exception. Exceptions are encoded in the signal space by
1222 putting them after _NSIG; this assumes they're positive (and not
1223 extremely large)! */
1225 struct inf_wait *w = &inf->wait;
1226 if (w->status.kind == TARGET_WAITKIND_STOPPED
1227 && w->status.value.sig == sig
1228 && w->thread && !w->thread->aborted)
1229 /* We're passing through the last exception we received. This is
1230 kind of bogus, because exceptions are per-thread whereas gdb
1231 treats signals as per-process. We just forward the exception to
1232 the correct handler, even it's not for the same thread as TID --
1233 i.e., we pretend it's global. */
1235 struct exc_state *e = &w->exc;
1236 inf_debug (inf, "passing through exception:"
1237 " task = %d, thread = %d, exc = %d"
1238 ", code = %d, subcode = %d",
1239 w->thread->port, inf->task->port,
1240 e->exception, e->code, e->subcode);
1242 exception_raise_request (e->handler,
1243 e->reply, MACH_MSG_TYPE_MOVE_SEND_ONCE,
1244 w->thread->port, inf->task->port,
1245 e->exception, e->code, e->subcode);
1248 error ("Can't forward spontaneous exception (%s).", NAME);
1251 /* A Unix signal. */
1253 /* The process is stopped and expecting a signal. Just send off a
1254 request and let it get handled when we resume everything. */
1256 inf_debug (inf, "sending %s to stopped process", NAME);
1258 INF_MSGPORT_RPC (inf,
1259 msg_sig_post_untraced_request (msgport,
1261 MACH_MSG_TYPE_MAKE_SEND_ONCE,
1265 /* Posting an untraced signal automatically continues it.
1266 We clear this here rather than when we get the reply
1267 because we'd rather assume it's not stopped when it
1268 actually is, than the reverse. */
1272 /* It's not expecting it. We have to let just the signal thread
1273 run, and wait for it to get into a reasonable state before we
1274 can continue the rest of the process. When we finally resume the
1275 process the signal we request will be the very first thing that
1278 inf_debug (inf, "sending %s to unstopped process (so resuming signal thread)", NAME);
1280 INF_RESUME_MSGPORT_RPC (inf, msg_sig_post_untraced (msgport,
1281 host_sig, 0, refport));
1285 /* Can't do too much... */
1286 warning ("Can't deliver signal %s: No signal thread.", NAME);
1288 warning ("Delivering signal %s: %s", NAME, strerror (err));
1293 /* The inferior used for all gdb target ops. */
1294 struct inf *current_inferior = 0;
1296 /* The inferior being waited for by gnu_wait. Since GDB is decidely not
1297 multi-threaded, we don't bother to lock this. */
1298 struct inf *waiting_inf;
1300 /* Wait for something to happen in the inferior, returning what in STATUS. */
1302 gnu_wait (int tid, struct target_waitstatus *status)
1305 mach_msg_header_t hdr;
1306 mach_msg_type_t type;
1310 struct proc *thread;
1311 struct inf *inf = current_inferior;
1315 if (!inf->threads && !inf->pending_execs)
1316 /* No threads! Assume that maybe some outside agency is frobbing our
1317 task, and really look for new threads. If we can't find any, just tell
1318 the user to try again later. */
1320 inf_validate_procs (inf);
1321 if (!inf->threads && !inf->task->dead)
1322 error ("There are no threads; try again later.");
1327 inf_debug (inf, "waiting for: %d", tid);
1330 if (proc_wait_pid != inf->pid && !inf->no_wait)
1331 /* Always get information on events from the proc server. */
1333 inf_debug (inf, "requesting wait on pid %d", inf->pid);
1336 /* The proc server is single-threaded, and only allows a single
1337 outstanding wait request, so we have to cancel the previous one. */
1339 inf_debug (inf, "cancelling previous wait on pid %d", proc_wait_pid);
1340 interrupt_operation (proc_server, 0);
1344 proc_wait_request (proc_server, inf->event_port, inf->pid, WUNTRACED);
1346 warning ("wait request failed: %s", strerror (err));
1349 inf_debug (inf, "waits pending: %d", proc_waits_pending);
1350 proc_wait_pid = inf->pid;
1351 /* Even if proc_waits_pending was > 0 before, we still won't get
1352 any other replies, because it was either from a different INF,
1353 or a different process attached to INF -- and the event port,
1354 which is the wait reply port, changes when you switch processes.*/
1355 proc_waits_pending = 1;
1359 inf_clear_wait (inf);
1361 /* What can happen? (1) Dead name notification; (2) Exceptions arrive;
1362 (3) wait reply from the proc server. */
1364 inf_debug (inf, "waiting for an event...");
1365 err = mach_msg (&msg.hdr, MACH_RCV_MSG | MACH_RCV_INTERRUPT,
1366 0, sizeof (struct msg), inf->event_port,
1367 MACH_MSG_TIMEOUT_NONE, MACH_PORT_NULL);
1369 /* Re-suspend the task. */
1372 if (!inf->task && inf->pending_execs)
1373 /* When doing an exec, it's possible that the old task wasn't reused
1374 (e.g., setuid execs). So if the task seems to have disappeared,
1375 attempt to refetch it, as the pid should still be the same. */
1376 inf_set_pid (inf, inf->pid);
1378 if (err == EMACH_RCV_INTERRUPTED)
1379 inf_debug (inf, "interrupted");
1381 error ("Couldn't wait for an event: %s", strerror (err));
1385 mach_msg_header_t hdr;
1386 mach_msg_type_t err_type;
1391 inf_debug (inf, "event: msgid = %d", msg.hdr.msgh_id);
1393 /* Handle what we got. */
1394 if (! notify_server (&msg.hdr, &reply.hdr)
1395 && ! exc_server (&msg.hdr, &reply.hdr)
1396 && ! process_reply_server (&msg.hdr, &reply.hdr)
1397 && ! msg_reply_server (&msg.hdr, &reply.hdr))
1398 /* Whatever it is, it's something strange. */
1399 error ("Got a strange event, msg id = %d.", msg.hdr.msgh_id);
1402 error ("Handling event, msgid = %d: %s",
1403 msg.hdr.msgh_id, strerror (reply.err));
1406 if (inf->pending_execs)
1407 /* We're waiting for the inferior to finish execing. */
1409 struct inf_wait *w = &inf->wait;
1410 enum target_waitkind kind = w->status.kind;
1412 if (kind == TARGET_WAITKIND_SPURIOUS)
1413 /* Since gdb is actually counting the number of times the inferior
1414 stops, expecting one stop per exec, we only return major events
1418 inf_debug (inf, "pending_execs = %d, ignoring minor event",
1419 inf->pending_execs);
1421 else if (kind == TARGET_WAITKIND_STOPPED
1422 && w->status.value.sig == TARGET_SIGNAL_TRAP)
1423 /* Ah hah! A SIGTRAP from the inferior while starting up probably
1424 means we've succesfully completed an exec! */
1426 if (--inf->pending_execs == 0)
1429 #if 0 /* do we need this? */
1430 prune_threads (1); /* Get rid of the old shell threads */
1431 renumber_threads (0); /* Give our threads reasonable names. */
1434 inf_debug (inf, "pending exec completed, pending_execs => %d",
1435 inf->pending_execs);
1437 else if (kind == TARGET_WAITKIND_STOPPED)
1438 /* It's possible that this signal is because of a crashed process
1439 being handled by the hurd crash server; in this case, the process
1440 will have an extra task suspend, which we need to know about.
1441 Since the code in inf_resume that normally checks for this is
1442 disabled while INF->pending_execs, we do the check here instead. */
1443 inf_validate_task_sc (inf);
1446 if (inf->wait.suppress)
1447 /* Some totally spurious event happened that we don't consider
1448 worth returning to gdb. Just keep waiting. */
1450 inf_debug (inf, "suppressing return, rewaiting...");
1455 /* Pass back out our results. */
1456 bcopy (&inf->wait.status, status, sizeof (*status));
1458 thread = inf->wait.thread;
1462 thread = inf_tid_to_thread (inf, tid);
1464 if (!thread || thread->port == MACH_PORT_NULL)
1465 /* TID is dead; try and find a new thread. */
1466 if (inf_update_procs (inf) && inf->threads)
1467 tid = inf->threads->tid; /* The first available thread. */
1469 tid = inferior_pid; /* let wait_for_inferior handle exit case */
1471 if (thread && tid >= 0 && status->kind != TARGET_WAITKIND_SPURIOUS
1472 && inf->pause_sc == 0 && thread->pause_sc == 0)
1473 /* If something actually happened to THREAD, make sure we suspend it. */
1476 inf_update_suspends (inf);
1479 inf_debug (inf, "returning tid = %d, status = %s (%d)", tid,
1480 status->kind == TARGET_WAITKIND_EXITED ? "EXITED"
1481 : status->kind == TARGET_WAITKIND_STOPPED ? "STOPPED"
1482 : status->kind == TARGET_WAITKIND_SIGNALLED ? "SIGNALLED"
1483 : status->kind == TARGET_WAITKIND_LOADED ? "LOADED"
1484 : status->kind == TARGET_WAITKIND_SPURIOUS ? "SPURIOUS"
1486 status->value.integer);
1491 /* The rpc handler called by exc_server. */
1493 S_exception_raise_request (mach_port_t port, mach_port_t reply_port,
1494 thread_t thread_port, task_t task_port,
1495 int exception, int code, int subcode)
1497 struct inf *inf = waiting_inf;
1498 struct proc *thread = inf_port_to_thread (inf, thread_port);
1500 inf_debug (waiting_inf,
1501 "thread = %d, task = %d, exc = %d, code = %d, subcode = %d",
1502 thread_port, task_port, exception, code);
1505 /* We don't know about thread? */
1507 inf_update_procs (inf);
1508 thread = inf_port_to_thread (inf, thread_port);
1510 /* Give up, the generating thread is gone. */
1514 mach_port_deallocate (mach_task_self (), thread_port);
1515 mach_port_deallocate (mach_task_self (), task_port);
1517 if (! thread->aborted)
1518 /* THREAD hasn't been aborted since this exception happened (abortion
1519 clears any exception state), so it must be real. */
1521 /* Store away the details; this will destroy any previous info. */
1522 inf->wait.thread = thread;
1524 inf->wait.status.kind = TARGET_WAITKIND_STOPPED;
1526 if (exception == EXC_BREAKPOINT)
1527 /* GDB likes to get SIGTRAP for breakpoints. */
1529 inf->wait.status.value.sig = TARGET_SIGNAL_TRAP;
1530 mach_port_deallocate (mach_task_self (), reply_port);
1533 /* Record the exception so that we can forward it later. */
1535 if (thread->exc_port == port)
1537 inf_debug (waiting_inf, "Handler is thread exeption port <%d>",
1538 thread->saved_exc_port);
1539 inf->wait.exc.handler = thread->saved_exc_port;
1543 inf_debug (waiting_inf, "Handler is task exeption port <%d>",
1544 inf->task->saved_exc_port);
1545 inf->wait.exc.handler = inf->task->saved_exc_port;
1546 assert (inf->task->exc_port == port);
1548 if (inf->wait.exc.handler != MACH_PORT_NULL)
1549 /* Add a reference to the exception handler. */
1550 mach_port_mod_refs (mach_task_self (),
1551 inf->wait.exc.handler, MACH_PORT_RIGHT_SEND,
1554 inf->wait.exc.exception = exception;
1555 inf->wait.exc.code = code;
1556 inf->wait.exc.subcode = subcode;
1557 inf->wait.exc.reply = reply_port;
1559 /* Exceptions are encoded in the signal space by putting them after
1560 _NSIG; this assumes they're positive (and not extremely large)! */
1561 inf->wait.status.value.sig =
1562 target_signal_from_host (_NSIG + exception);
1566 /* A supppressed exception, which ignore. */
1568 inf->wait.suppress = 1;
1569 mach_port_deallocate (mach_task_self (), reply_port);
1575 /* Fill in INF's wait field after a task has died without giving us more
1576 detailed information. */
1578 inf_task_died_status (struct inf *inf)
1580 warning ("Pid %d died with unknown exit status, using SIGKILL.", inf->pid);
1581 inf->wait.status.kind = TARGET_WAITKIND_SIGNALLED;
1582 inf->wait.status.value.sig = TARGET_SIGNAL_KILL;
1585 /* Notify server routines. The only real one is dead name notification. */
1587 do_mach_notify_dead_name (mach_port_t notify, mach_port_t dead_port)
1589 struct inf *inf = waiting_inf;
1591 inf_debug (waiting_inf, "port = %d", dead_port);
1593 if (inf->task && inf->task->port == dead_port)
1595 proc_debug (inf->task, "is dead");
1596 inf->task->port = MACH_PORT_NULL;
1597 if (proc_wait_pid == inf->pid)
1598 /* We have a wait outstanding on the process, which will return more
1599 detailed information, so delay until we get that. */
1600 inf->wait.suppress = 1;
1602 /* We never waited for the process (maybe it wasn't a child), so just
1603 pretend it got a SIGKILL. */
1604 inf_task_died_status (inf);
1608 struct proc *thread = inf_port_to_thread (inf, dead_port);
1611 proc_debug (thread, "is dead");
1612 thread->port = MACH_PORT_NULL;
1616 mach_port_deallocate (mach_task_self (), dead_port);
1617 inf->threads_up_to_date = 0; /* Just in case */
1625 warning ("illegal rpc: %s", fun);
1630 do_mach_notify_no_senders (mach_port_t notify, mach_port_mscount_t count)
1632 return ill_rpc (__FUNCTION__);
1636 do_mach_notify_port_deleted (mach_port_t notify, mach_port_t name)
1638 return ill_rpc (__FUNCTION__);
1642 do_mach_notify_msg_accepted (mach_port_t notify, mach_port_t name)
1644 return ill_rpc (__FUNCTION__);
1648 do_mach_notify_port_destroyed (mach_port_t notify, mach_port_t name)
1650 return ill_rpc (__FUNCTION__);
1654 do_mach_notify_send_once (mach_port_t notify)
1656 return ill_rpc (__FUNCTION__);
1659 /* Process_reply server routines. We only use process_wait_reply. */
1662 S_proc_wait_reply (mach_port_t reply, error_t err,
1663 int status, int sigcode, rusage_t rusage, pid_t pid)
1665 struct inf *inf = waiting_inf;
1667 inf_debug (inf, "err = %s, pid = %d, status = 0x%x, sigcode = %d",
1668 err ? strerror (err) : "0", pid, status, sigcode);
1670 if (err && proc_wait_pid && (!inf->task || !inf->task->port))
1671 /* Ack. The task has died, but the task-died notification code didn't
1672 tell anyone because it thought a more detailed reply from the
1673 procserver was forthcoming. However, we now learn that won't
1674 happen... So we have to act like the task just died, and this time,
1676 inf_task_died_status (inf);
1678 if (--proc_waits_pending == 0)
1679 /* PROC_WAIT_PID represents the most recent wait. We will always get
1680 replies in order because the proc server is single threaded. */
1683 inf_debug (inf, "waits pending now: %d", proc_waits_pending);
1689 warning ("Can't wait for pid %d: %s", inf->pid, strerror (err));
1692 /* Since we can't see the inferior's signals, don't trap them. */
1693 inf_set_traced (inf, 0);
1696 else if (pid == inf->pid)
1698 store_waitstatus (&inf->wait.status, status);
1699 if (inf->wait.status.kind == TARGET_WAITKIND_STOPPED)
1700 /* The process has sent us a signal, and stopped itself in a sane
1701 state pending our actions. */
1703 inf_debug (inf, "process has stopped itself");
1708 inf->wait.suppress = 1; /* Something odd happened. Ignore. */
1714 S_proc_setmsgport_reply (mach_port_t reply, error_t err,
1715 mach_port_t old_msg_port)
1717 return ill_rpc (__FUNCTION__);
1721 S_proc_getmsgport_reply (mach_port_t reply, error_t err, mach_port_t msg_port)
1723 return ill_rpc (__FUNCTION__);
1726 /* Msg_reply server routines. We only use msg_sig_post_untraced_reply. */
1729 S_msg_sig_post_untraced_reply (mach_port_t reply, error_t err)
1731 struct inf *inf = waiting_inf;
1734 /* EBUSY is what we get when the crash server has grabbed control of the
1735 process and doesn't like what signal we tried to send it. Just act
1736 like the process stopped (using a signal of 0 should mean that the
1737 *next* time the user continues, it will pass signal 0, which the crash
1738 server should like). */
1740 inf->wait.status.kind = TARGET_WAITKIND_STOPPED;
1741 inf->wait.status.value.sig = TARGET_SIGNAL_0;
1744 warning ("Signal delivery failed: %s", strerror (err));
1747 /* We only get this reply when we've posted a signal to a process which we
1748 thought was stopped, and which we expected to continue after the signal.
1749 Given that the signal has failed for some reason, it's reasonable to
1750 assume it's still stopped. */
1753 inf->wait.suppress = 1;
1759 S_msg_sig_post_reply (mach_port_t reply, error_t err)
1761 return ill_rpc (__FUNCTION__);
1764 /* Returns the number of messages queued for the receive right PORT. */
1765 static mach_port_msgcount_t
1766 port_msgs_queued (mach_port_t port)
1768 struct mach_port_status status;
1770 mach_port_get_receive_status (mach_task_self (), port, &status);
1775 return status.mps_msgcount;
1778 /* Resume execution of the inferior process.
1780 If STEP is nonzero, single-step it.
1781 If SIGNAL is nonzero, give it that signal.
1784 -1 true Single step the current thread allowing other threads to run.
1785 -1 false Continue the current thread allowing other threads to run.
1786 X true Single step the given thread, don't allow any others to run.
1787 X false Continue the given thread, do not allow any others to run.
1788 (Where X, of course, is anything except -1)
1790 Note that a resume may not `take' if there are pending exceptions/&c
1791 still unprocessed from the last resume we did (any given resume may result
1792 in multiple events returned by wait).
1795 gnu_resume (int tid, int step, enum target_signal sig)
1797 struct proc *step_thread = 0;
1798 struct inf *inf = current_inferior;
1800 inf_debug (inf, "tid = %d, step = %d, sig = %d", tid, step, sig);
1802 if (sig != TARGET_SIGNAL_0 || inf->stopped)
1803 inf_signal (inf, sig);
1804 else if (inf->wait.exc.reply != MACH_PORT_NULL)
1805 /* We received an exception to which we have chosen not to forward, so
1806 abort the faulting thread, which will perhaps retake it. */
1808 proc_abort (inf->wait.thread, 1);
1809 warning ("Aborting %s with unforwarded exception %s.",
1810 proc_string (inf->wait.thread),
1811 target_signal_to_name (inf->wait.status.value.sig));
1814 if (port_msgs_queued (inf->event_port))
1815 /* If there are still messages in our event queue, don't bother resuming
1816 the process, as we're just going to stop it right away anyway. */
1819 inf_update_procs (inf);
1822 /* Allow all threads to run, except perhaps single-stepping one. */
1824 inf_debug (inf, "running all threads; tid = %d", inferior_pid);
1825 tid = inferior_pid; /* What to step. */
1826 inf_set_threads_resume_sc (inf, 0, 1);
1829 /* Just allow a single thread to run. */
1831 struct proc *thread = inf_tid_to_thread (inf, tid);
1833 error ("Can't run single thread id %d: no such thread!");
1834 inf_debug (inf, "running one thread: %d/%d", inf->pid, thread->tid);
1835 inf_set_threads_resume_sc (inf, thread, 0);
1840 step_thread = inf_tid_to_thread (inf, tid);
1842 warning ("Can't step thread id %d: no such thread.", tid);
1844 inf_debug (inf, "stepping thread: %d/%d", inf->pid, step_thread->tid);
1846 if (step_thread != inf->step_thread)
1847 inf_set_step_thread (inf, step_thread);
1849 inf_debug (inf, "here we go...");
1854 gnu_kill_inferior ()
1856 struct proc *task = current_inferior->task;
1859 proc_debug (task, "terminating...");
1860 task_terminate (task->port);
1861 inf_set_pid (current_inferior, -1);
1863 target_mourn_inferior ();
1866 /* Clean up after the inferior dies. */
1869 gnu_mourn_inferior ()
1871 inf_debug (current_inferior, "rip");
1872 inf_detach (current_inferior);
1873 unpush_target (&gnu_ops);
1874 generic_mourn_inferior ();
1877 /* Fork an inferior process, and start debugging it. */
1879 /* Set INFERIOR_PID to the first thread available in the child, if any. */
1881 inf_pick_first_thread ()
1883 if (current_inferior->task && current_inferior->threads)
1884 /* The first thread. */
1885 return current_inferior->threads->tid;
1887 /* What may be the next thread. */
1888 return next_thread_id;
1894 if (! current_inferior)
1895 current_inferior = make_inf ();
1896 return current_inferior;
1900 gnu_create_inferior (exec_file, allargs, env)
1905 struct inf *inf = cur_inf ();
1909 /* We're in the child; make this process stop as soon as it execs. */
1910 inf_debug (inf, "tracing self");
1911 if (ptrace (PTRACE_TRACEME) != 0)
1912 error ("ptrace (PTRACE_TRACEME) failed!");
1914 int attach_to_child (int pid)
1916 /* Attach to the now stopped child, which is actually a shell... */
1917 inf_debug (inf, "attaching to child: %d", pid);
1919 inf_attach (inf, pid);
1922 push_target (&gnu_ops);
1924 inf->pending_execs = 2;
1927 /* Now let the child run again, knowing that it will stop immediately
1928 because of the ptrace. */
1930 inferior_pid = inf_pick_first_thread ();
1932 startup_inferior (inf->pending_execs);
1934 return inferior_pid;
1937 inf_debug (inf, "creating inferior");
1939 fork_inferior (exec_file, allargs, env, trace_me, attach_to_child, NULL);
1941 inf_update_signal_thread (inf);
1942 inf_set_traced (inf, inf->want_signals);
1944 /* Execing the process will have trashed our exception ports; steal them
1945 back (or make sure they're restored if the user wants that). */
1946 if (inf->want_exceptions)
1947 inf_steal_exc_ports (inf);
1949 inf_restore_exc_ports (inf);
1952 proceed ((CORE_ADDR) -1, 0, 0);
1955 /* Mark our target-struct as eligible for stray "run" and "attach"
1963 #ifdef ATTACH_DETACH
1965 /* Attach to process PID, then initialize for debugging it
1966 and wait for the trace-trap that results from attaching. */
1968 gnu_attach (args, from_tty)
1974 struct inf *inf = cur_inf ();
1977 error_no_arg ("PID to attach");
1981 if (pid == getpid()) /* Trying to masturbate? */
1982 error ("I refuse to debug myself!");
1986 exec_file = (char *) get_exec_file (0);
1989 printf_unfiltered ("Attaching to program `%s', pid %d\n",
1992 printf_unfiltered ("Attaching to pid %d\n", pid);
1994 gdb_flush (gdb_stdout);
1997 inf_debug (inf, "attaching to pid: %d", pid);
1999 inf_attach (inf, pid);
2000 inf_update_procs (inf);
2002 inferior_pid = inf_pick_first_thread ();
2005 push_target (&gnu_ops);
2007 inf_update_signal_thread (inf);
2008 inf_set_traced (inf, inf->want_signals);
2010 /* If the process was stopped before we attached, make it continue the next
2011 time the user does a continue. */
2012 inf_validate_stopped (inf);
2014 #if 0 /* Do we need this? */
2015 renumber_threads (0); /* Give our threads reasonable names. */
2019 /* Take a program previously attached to and detaches it.
2020 The program resumes execution and will no longer stop
2021 on signals, etc. We'd better not have left any breakpoints
2022 in the program or it'll die when it hits one. For this
2023 to work, it may be necessary for the process to have been
2024 previously attached. It *might* work if the program was
2025 started via fork. */
2027 gnu_detach (args, from_tty)
2033 char *exec_file = get_exec_file (0);
2035 printf_unfiltered ("Detaching from program `%s' pid %d\n",
2036 exec_file, current_inferior->pid);
2038 printf_unfiltered ("Detaching from pid %d\n", current_inferior->pid);
2039 gdb_flush (gdb_stdout);
2042 inf_detach (current_inferior);
2046 unpush_target (&gnu_ops); /* Pop out of handling an inferior */
2048 #endif /* ATTACH_DETACH */
2051 gnu_terminal_init_inferior ()
2053 assert (current_inferior);
2054 terminal_init_inferior_with_pgrp (current_inferior->pid);
2057 /* Get ready to modify the registers array. On machines which store
2058 individual registers, this doesn't need to do anything. On machines
2059 which store all the registers in one fell swoop, this makes sure
2060 that registers contains all the registers from the program being
2064 gnu_prepare_to_store ()
2066 #ifdef CHILD_PREPARE_TO_STORE
2067 CHILD_PREPARE_TO_STORE ();
2072 gnu_open (arg, from_tty)
2076 error ("Use the \"run\" command to start a Unix child process.");
2082 error ("to_stop target function not implemented");
2086 gnu_thread_alive (int tid)
2088 inf_update_procs (current_inferior);
2089 return !!inf_tid_to_thread (current_inferior, tid);
2093 * Read inferior task's LEN bytes from ADDR and copy it to MYADDR
2094 * in gdb's address space.
2096 * Return 0 on failure; number of bytes read otherwise.
2099 gnu_read_inferior (task, addr, myaddr, length)
2106 vm_address_t low_address = (vm_address_t) trunc_page (addr);
2107 vm_size_t aligned_length =
2108 (vm_size_t) round_page (addr+length) - low_address;
2112 /* Get memory from inferior with page aligned addresses */
2113 err = vm_read (task, low_address, aligned_length, &copied, ©_count);
2117 err = hurd_safe_copyin (myaddr, (void*)addr - low_address + copied, length);
2120 warning ("Read from inferior faulted: %s", strerror (err));
2124 err = vm_deallocate (mach_task_self (), copied, copy_count);
2126 warning ("gnu_read_inferior vm_deallocate failed: %s", strerror (err));
2131 #define CHK_GOTO_OUT(str,ret) \
2132 do if (ret != KERN_SUCCESS) { errstr = #str; goto out; } while(0)
2134 struct vm_region_list {
2135 struct vm_region_list *next;
2136 vm_prot_t protection;
2141 struct obstack region_obstack;
2144 * Write gdb's LEN bytes from MYADDR and copy it to ADDR
2145 * in inferior task's address space.
2148 gnu_write_inferior (task, addr, myaddr, length)
2155 vm_address_t low_address = (vm_address_t) trunc_page (addr);
2156 vm_size_t aligned_length =
2157 (vm_size_t) round_page (addr+length) - low_address;
2162 char *errstr = "Bug in gnu_write_inferior";
2164 struct vm_region_list *region_element;
2165 struct vm_region_list *region_head = (struct vm_region_list *)NULL;
2167 /* Get memory from inferior with page aligned addresses */
2168 err = vm_read (task,
2173 CHK_GOTO_OUT ("gnu_write_inferior vm_read failed", err);
2177 err = hurd_safe_copyout ((void*)addr - low_address + copied, myaddr, length);
2178 CHK_GOTO_OUT ("Write to inferior faulted", err);
2180 obstack_init (®ion_obstack);
2182 /* Do writes atomically.
2183 * First check for holes and unwritable memory.
2186 vm_size_t remaining_length = aligned_length;
2187 vm_address_t region_address = low_address;
2189 struct vm_region_list *scan;
2191 while(region_address < low_address + aligned_length)
2193 vm_prot_t protection;
2194 vm_prot_t max_protection;
2195 vm_inherit_t inheritance;
2197 mach_port_t object_name;
2199 vm_size_t region_length = remaining_length;
2200 vm_address_t old_address = region_address;
2202 err = vm_region (task,
2211 CHK_GOTO_OUT ("vm_region failed", err);
2213 /* Check for holes in memory */
2214 if (old_address != region_address)
2216 warning ("No memory at 0x%x. Nothing written",
2223 if (!(max_protection & VM_PROT_WRITE))
2225 warning ("Memory at address 0x%x is unwritable. Nothing written",
2232 /* Chain the regions for later use */
2234 (struct vm_region_list *)
2235 obstack_alloc (®ion_obstack, sizeof (struct vm_region_list));
2237 region_element->protection = protection;
2238 region_element->start = region_address;
2239 region_element->length = region_length;
2241 /* Chain the regions along with protections */
2242 region_element->next = region_head;
2243 region_head = region_element;
2245 region_address += region_length;
2246 remaining_length = remaining_length - region_length;
2249 /* If things fail after this, we give up.
2250 * Somebody is messing up inferior_task's mappings.
2253 /* Enable writes to the chained vm regions */
2254 for (scan = region_head; scan; scan = scan->next)
2256 boolean_t protection_changed = FALSE;
2258 if (!(scan->protection & VM_PROT_WRITE))
2260 err = vm_protect (task,
2264 scan->protection | VM_PROT_WRITE);
2265 CHK_GOTO_OUT ("vm_protect: enable write failed", err);
2269 err = vm_write (task,
2273 CHK_GOTO_OUT ("vm_write failed", err);
2275 /* Set up the original region protections, if they were changed */
2276 for (scan = region_head; scan; scan = scan->next)
2278 boolean_t protection_changed = FALSE;
2280 if (!(scan->protection & VM_PROT_WRITE))
2282 err = vm_protect (task,
2287 CHK_GOTO_OUT ("vm_protect: enable write failed", err);
2295 obstack_free (®ion_obstack, 0);
2297 (void) vm_deallocate (mach_task_self (),
2302 if (err != KERN_SUCCESS)
2304 warning ("%s: %s", errstr, mach_error_string (err));
2311 /* Return 0 on failure, number of bytes handled otherwise. */
2313 gnu_xfer_memory (memaddr, myaddr, len, write, target)
2318 struct target_ops *target; /* IGNORED */
2323 ? (current_inferior->task ? current_inferior->task->port : 0)
2326 if (task == MACH_PORT_NULL)
2330 inf_debug (current_inferior, "%s %p[%d] %s %p",
2331 write ? "writing" : "reading", memaddr, len,
2332 write ? "<--" : "-->", myaddr);
2334 return gnu_write_inferior (task, memaddr, myaddr, len);
2336 return gnu_read_inferior (task, memaddr, myaddr, len);
2340 extern void gnu_store_registers (int regno);
2341 extern void gnu_fetch_registers (int regno);
2343 struct target_ops gnu_ops ;
2348 gnu_ops.to_shortname = "GNU"; /* to_shortname */
2349 gnu_ops.to_longname = "GNU Hurd process"; /* to_longname */
2350 gnu_ops.to_doc = "GNU Hurd process"; /* to_doc */
2351 gnu_ops.to_open = gnu_open; /* to_open */
2352 gnu_ops.to_close = 0; /* to_close */
2353 gnu_ops.to_attach = gnu_attach; /* to_attach */
2354 gnu_ops.to_detach = gnu_detach; /* to_detach */
2355 gnu_ops.to_resume = gnu_resume; /* to_resume */
2356 gnu_ops.to_wait = gnu_wait; /* to_wait */
2357 gnu_ops.to_fetch_registers = gnu_fetch_registers; /* to_fetch_registers */
2358 gnu_ops.to_store_registers = gnu_store_registers; /* to_store_registers */
2359 gnu_ops.to_prepare_to_store = gnu_prepare_to_store; /* to_prepare_to_store */
2360 gnu_ops.to_xfer_memory = gnu_xfer_memory; /* to_xfer_memory */
2361 gnu_ops.to_files_info = 0; /* to_files_info */
2362 gnu_ops.to_insert_breakpoint = memory_insert_breakpoint;
2363 gnu_ops.to_remove_breakpoint = memory_remove_breakpoint;
2364 gnu_ops.to_terminal_init = gnu_terminal_init_inferior;
2365 gnu_ops.to_terminal_inferior = terminal_inferior;
2366 gnu_ops.to_terminal_ours_for_output = terminal_ours_for_output;
2367 gnu_ops.to_terminal_ours = terminal_ours;
2368 gnu_ops.to_terminal_info = child_terminal_info;
2369 gnu_ops.to_kill = gnu_kill_inferior; /* to_kill */
2370 gnu_ops.to_load = 0; /* to_load */
2371 gnu_ops.to_lookup_symbol = 0; /* to_lookup_symbol */
2372 gnu_ops.to_create_inferior = gnu_create_inferior; /* to_create_inferior */
2373 gnu_ops.to_mourn_inferior = gnu_mourn_inferior; /* to_mourn_inferior */
2374 gnu_ops.to_can_run = gnu_can_run; /* to_can_run */
2375 gnu_ops.to_notice_signals = 0; /* to_notice_signals */
2376 gnu_ops.to_thread_alive = gnu_thread_alive;/* to_thread_alive */
2377 gnu_ops.to_stop = gnu_stop; /* to_stop */
2378 gnu_ops.to_stratum = process_stratum; /* to_stratum */
2379 gnu_ops.DONT_USE = 0; /* to_next */
2380 gnu_ops.to_has_all_memory = 1; /* to_has_all_memory */
2381 gnu_ops.to_has_memory = 1; /* to_has_memory */
2382 gnu_ops.to_has_stack = 1; /* to_has_stack */
2383 gnu_ops.to_has_registers = 1; /* to_has_registers */
2384 gnu_ops.to_has_execution = 1; /* to_has_execution */
2385 gnu_ops.to_sections = 0; /* sections */
2386 gnu_ops.to_sections_end = 0; /* sections_end */
2387 gnu_ops.to_magic = OPS_MAGIC ; /* to_magic */
2388 } /* init_gnu_ops */
2390 /* Return printable description of proc. */
2391 char *proc_string (struct proc *proc)
2393 static char tid_str[80];
2394 if (proc_is_task (proc))
2395 sprintf (tid_str, "process %d", proc->inf->pid);
2397 sprintf (tid_str, "thread %d.%d",
2398 proc->inf->pid, pid_to_thread_id (proc->tid));
2403 gnu_target_pid_to_str (int tid)
2405 struct inf *inf = current_inferior;
2406 struct proc *thread = inf_tid_to_thread (inf, tid);
2409 return proc_string (thread);
2412 static char tid_str[80];
2413 sprintf (tid_str, "bogus thread id %d", tid);
2418 /* User task commands. */
2420 struct cmd_list_element *set_task_cmd_list = 0;
2421 struct cmd_list_element *show_task_cmd_list = 0;
2422 /* User thread commands. */
2424 /* Commands with a prefix of `set/show thread'. */
2425 extern struct cmd_list_element *thread_cmd_list;
2426 struct cmd_list_element *set_thread_cmd_list = NULL;
2427 struct cmd_list_element *show_thread_cmd_list = NULL;
2429 /* Commands with a prefix of `set/show thread default'. */
2430 struct cmd_list_element *set_thread_default_cmd_list = NULL;
2431 struct cmd_list_element *show_thread_default_cmd_list = NULL;
2434 set_thread_cmd (char *args, int from_tty)
2436 printf_unfiltered ("\"set thread\" must be followed by the name of a thread
2437 property, or \"default\".\n");
2441 show_thread_cmd (char *args, int from_tty)
2443 printf_unfiltered ("\"show thread\" must be followed by the name of a thread property, or \"default\".\n");
2447 set_thread_default_cmd (char *args, int from_tty)
2449 printf_unfiltered ("\"set thread default\" must be followed by the name of a thread property.\n");
2453 show_thread_default_cmd (char *args, int from_tty)
2455 printf_unfiltered ("\"show thread default\" must be followed by the name of a thread property.\n");
2459 parse_int_arg (char *args, char *cmd_prefix)
2464 int val = strtoul (args, &arg_end, 10);
2465 if (*args && *arg_end == '\0')
2468 error ("Illegal argument for \"%s\" command, should be an integer.", cmd_prefix);
2472 _parse_bool_arg (char *args, char *t_val, char *f_val, char *cmd_prefix)
2474 if (!args || strcmp (args, t_val) == 0)
2476 else if (strcmp (args, f_val) == 0)
2479 error ("Illegal argument for \"%s\" command, should be \"%s\" or \"%s\".",
2480 cmd_prefix, t_val, f_val);
2483 #define parse_bool_arg(args, cmd_prefix) \
2484 _parse_bool_arg (args, "on", "off", cmd_prefix)
2487 check_empty (char *args, char *cmd_prefix)
2490 error ("Garbage after \"%s\" command: `%s'", cmd_prefix, args);
2493 /* Returns the alive thread named by INFERIOR_PID, or signals an error. */
2494 static struct proc *
2497 struct inf *inf = cur_inf ();
2498 struct proc *thread = inf_tid_to_thread (inf, inferior_pid);
2500 error ("No current thread.");
2504 /* Returns the current inferior, but signals an error if it has no task. */
2508 struct inf *inf = cur_inf ();
2510 error ("No current process.");
2515 set_task_pause_cmd (char *args, int from_tty)
2517 struct inf *inf = cur_inf ();
2518 int old_sc = inf->pause_sc;
2520 inf->pause_sc = parse_bool_arg (args, "set task pause");
2522 if (old_sc == 0 && inf->pause_sc != 0)
2523 /* If the task is currently unsuspended, immediately suspend it,
2524 otherwise wait until the next time it gets control. */
2529 show_task_pause_cmd (char *args, int from_tty)
2531 struct inf *inf = cur_inf ();
2532 check_empty (args, "show task pause");
2533 printf_unfiltered ("The inferior task %s suspended while gdb has control.\n",
2535 ? (inf->pause_sc == 0 ? "isn't" : "is")
2536 : (inf->pause_sc == 0 ? "won't be" : "will be"));
2540 set_task_detach_sc_cmd (char *args, int from_tty)
2542 cur_inf ()->detach_sc = parse_int_arg (args, "set task detach-suspend-count");
2546 show_task_detach_sc_cmd (char *args, int from_tty)
2548 check_empty (args, "show task detach-suspend-count");
2549 printf_unfiltered ("The inferior task will be left with a suspend count of %d when detaching.\n",
2550 cur_inf ()->detach_sc);
2554 set_thread_default_pause_cmd (char *args, int from_tty)
2556 struct inf *inf = cur_inf ();
2557 inf->default_thread_pause_sc =
2558 parse_bool_arg (args, "set thread default pause") ? 0 : 1;
2562 show_thread_default_pause_cmd (char *args, int from_tty)
2564 struct inf *inf = cur_inf ();
2565 int sc = inf->default_thread_pause_sc;
2566 check_empty (args, "show thread default pause");
2567 printf_unfiltered ("New threads %s suspended while gdb has control%s.\n",
2568 sc ? "are" : "aren't",
2569 !sc && inf->pause_sc ? " (but the task is)" : "");
2573 set_thread_default_run_cmd (char *args, int from_tty)
2575 struct inf *inf = cur_inf ();
2576 inf->default_thread_run_sc =
2577 parse_bool_arg (args, "set thread default run") ? 0 : 1;
2581 show_thread_default_run_cmd (char *args, int from_tty)
2583 struct inf *inf = cur_inf ();
2584 check_empty (args, "show thread default run");
2585 printf_unfiltered ("New threads %s allowed to run.\n",
2586 inf->default_thread_run_sc == 0 ? "are" : "aren't");
2590 set_thread_default_detach_sc_cmd (char *args, int from_tty)
2592 cur_inf ()->default_thread_detach_sc =
2593 parse_int_arg (args, "set thread default detach-suspend-count");
2597 show_thread_default_detach_sc_cmd (char *args, int from_tty)
2599 check_empty (args, "show thread default detach-suspend-count");
2600 printf_unfiltered ("New threads will get a detach-suspend-count of %d.\n",
2601 cur_inf ()->default_thread_detach_sc);
2604 /* Steal a send right called NAME in the inferior task, and make it PROC's
2605 saved exception port. */
2607 steal_exc_port (struct proc *proc, mach_port_t name)
2611 mach_msg_type_name_t port_type;
2613 if (!proc || !proc->inf->task)
2614 error ("No inferior task.");
2616 err = mach_port_extract_right (proc->inf->task->port,
2617 name, MACH_MSG_TYPE_COPY_SEND,
2620 error ("Couldn't extract send right %d from inferior: %s",
2621 name, strerror (err));
2623 if (proc->saved_exc_port)
2624 /* Get rid of our reference to the old one. */
2625 mach_port_deallocate (mach_task_self (), proc->saved_exc_port);
2627 proc->saved_exc_port = port;
2629 if (! proc->exc_port)
2630 /* If PROC is a thread, we may not have set its exception port before.
2631 We can't use proc_steal_exc_port because it also sets saved_exc_port. */
2633 proc->exc_port = proc->inf->event_port;
2634 err = proc_set_exception_port (proc, proc->exc_port);
2635 error ("Can't set exception port for %s: %s",
2636 proc_string (proc), strerror (err));
2641 set_task_exc_port_cmd (char *args, int from_tty)
2643 struct inf *inf = cur_inf ();
2645 error ("No argument to \"set task exception-port\" command.");
2646 steal_exc_port (inf->task, parse_and_eval_address (args));
2650 set_stopped_cmd (char *args, int from_tty)
2652 cur_inf ()->stopped = _parse_bool_arg (args, "yes", "no", "set stopped");
2656 show_stopped_cmd (char *args, int from_tty)
2658 struct inf *inf = active_inf ();
2659 check_empty (args, "show stopped");
2660 printf_unfiltered ("The inferior process %s stopped.\n",
2661 inf->stopped ? "is" : "isn't");
2665 set_sig_thread_cmd (char *args, int from_tty)
2668 struct inf *inf = cur_inf ();
2670 if (!args || (! isdigit (*args) && strcmp (args, "none") != 0))
2671 error ("Illegal argument to \"set signal-thread\" command.\n"
2672 "Should be an integer thread ID, or `none'.");
2674 if (strcmp (args, "none") == 0)
2675 inf->signal_thread = 0;
2678 int tid = thread_id_to_pid (atoi (args));
2680 error ("Thread ID %s not known. Use the \"info threads\" command to\n"
2681 "see the IDs of currently known threads.", args);
2682 inf->signal_thread = inf_tid_to_thread (inf, tid);
2687 show_sig_thread_cmd (char *args, int from_tty)
2689 struct inf *inf = active_inf ();
2690 check_empty (args, "show signal-thread");
2691 if (inf->signal_thread)
2692 printf_unfiltered ("The signal thread is %s.\n",
2693 proc_string (inf->signal_thread));
2695 printf_unfiltered ("There is no signal thread.\n");
2699 set_signals_cmd (char *args, int from_tty)
2702 struct inf *inf = cur_inf ();
2704 inf->want_signals = parse_bool_arg (args, "set signals");
2706 if (inf->task && inf->want_signals != inf->traced)
2707 /* Make this take effect immediately in a running process. */
2708 inf_set_traced (inf, inf->want_signals);
2712 show_signals_cmd (char *args, int from_tty)
2714 struct inf *inf = cur_inf ();
2715 check_empty (args, "show signals");
2716 printf_unfiltered ("The inferior process's signals %s intercepted.\n",
2718 ? (inf->traced ? "are" : "aren't")
2719 : (inf->want_signals ? "will be" : "won't be"));
2723 set_exceptions_cmd (char *args, int from_tty)
2725 struct inf *inf = cur_inf ();
2726 int val = parse_bool_arg (args, "set exceptions");
2728 if (inf->task && inf->want_exceptions != val)
2729 /* Make this take effect immediately in a running process. */
2732 inf->want_exceptions = val;
2736 show_exceptions_cmd (char *args, int from_tty)
2738 struct inf *inf = cur_inf ();
2739 check_empty (args, "show exceptions");
2740 printf_unfiltered ("Exceptions in the inferior %s trapped.\n",
2742 ? (inf->want_exceptions ? "are" : "aren't")
2743 : (inf->want_exceptions ? "will be" : "won't be"));
2747 set_task_cmd (char *args, int from_tty)
2749 printf_unfiltered ("\"set task\" must be followed by the name of a task property.\n");
2753 show_task_cmd (char *args, int from_tty)
2755 struct inf *inf = cur_inf ();
2757 check_empty (args, "show task");
2759 show_signals_cmd (0, from_tty);
2760 show_exceptions_cmd (0, from_tty);
2761 show_task_pause_cmd (0, from_tty);
2763 if (inf->pause_sc == 0)
2764 show_thread_default_pause_cmd (0, from_tty);
2765 show_thread_default_run_cmd (0, from_tty);
2769 show_stopped_cmd (0, from_tty);
2770 show_sig_thread_cmd (0, from_tty);
2773 if (inf->detach_sc != 0)
2774 show_task_detach_sc_cmd (0, from_tty);
2775 if (inf->default_thread_detach_sc != 0)
2776 show_thread_default_detach_sc_cmd (0, from_tty);
2780 set_noninvasive_cmd (char *args, int from_tty)
2782 /* Invert the sense of the arg for each component. */
2783 char *inv_args = parse_bool_arg (args, "set noninvasive") ? "off" : "on";
2785 set_task_pause_cmd (inv_args, from_tty);
2786 set_signals_cmd (inv_args, from_tty);
2787 set_exceptions_cmd (inv_args, from_tty);
2791 info_port_rights (char *args, mach_port_type_t only)
2793 struct inf *inf = active_inf ();
2794 value_ptr vmark = value_mark ();
2797 /* Explicit list of port rights. */
2801 value_ptr val = parse_to_comma_and_eval (&args);
2802 long right = value_as_long (val);
2804 print_port_info (right, 0, inf->task->port, PORTINFO_DETAILS,
2807 error ("%ld: %s.", right, strerror (err));
2811 /* Print all of them. */
2814 print_task_ports_info (inf->task->port, only, PORTINFO_DETAILS,
2817 error ("%s.", strerror (err));
2820 value_free_to_mark (vmark);
2824 info_send_rights_cmd (char *args, int from_tty)
2826 info_port_rights (args, MACH_PORT_TYPE_SEND);
2829 info_recv_rights_cmd (char *args, int from_tty)
2831 info_port_rights (args, MACH_PORT_TYPE_RECEIVE);
2834 info_port_sets_cmd (char *args, int from_tty)
2836 info_port_rights (args, MACH_PORT_TYPE_PORT_SET);
2839 info_dead_names_cmd (char *args, int from_tty)
2841 info_port_rights (args, MACH_PORT_TYPE_DEAD_NAME);
2844 info_port_rights_cmd (char *args, int from_tty)
2846 info_port_rights (args, ~0);
2849 static void add_task_commands ()
2851 add_cmd ("pause", class_run, set_thread_default_pause_cmd,
2852 "Set whether the new threads are suspended while gdb has control.\n"
2853 "This property normally has no effect because the whole task is\n"
2854 "suspended, however, that may be disabled with \"set task pause off\".\n"
2855 "The default value is \"off\".",
2856 &set_thread_default_cmd_list);
2857 add_cmd ("pause", no_class, show_thread_default_pause_cmd,
2858 "Show whether new threads are suspended while gdb has control.",
2859 &show_thread_default_cmd_list);
2860 add_cmd ("run", class_run, set_thread_default_run_cmd,
2861 "Set whether new threads are allowed to run (once gdb has noticed them).",
2862 &set_thread_default_cmd_list);
2863 add_cmd ("run", no_class, show_thread_default_run_cmd,
2864 "Show whether new threads are allowed to run (once gdb has noticed
2866 &show_thread_default_cmd_list);
2867 add_cmd ("detach-suspend-count", class_run, set_thread_default_detach_sc_cmd,
2868 "Set the default detach-suspend-count value for new threads.",
2869 &set_thread_default_cmd_list);
2870 add_cmd ("detach-suspend-count", no_class, show_thread_default_detach_sc_cmd,
2871 "Show the default detach-suspend-count value for new threads.",
2872 &show_thread_default_cmd_list);
2874 add_cmd ("signals", class_run, set_signals_cmd,
2875 "Set whether the inferior process's signals will be intercepted.\n"
2876 "Mach exceptions (such as breakpoint traps) are not affected.",
2878 add_alias_cmd ("sigs", "signals", class_run, 1, &setlist);
2879 add_cmd ("signals", no_class, show_signals_cmd,
2880 "Show whether the inferior process's signals will be intercepted.",
2882 add_alias_cmd ("sigs", "signals", no_class, 1, &showlist);
2884 add_cmd ("signal-thread", class_run, set_sig_thread_cmd,
2885 "Set the thread that gdb thinks is the libc signal thread.\n"
2886 "This thread is run when delivering a signal to a non-stopped process.",
2888 add_alias_cmd ("sigthread", "signal-thread", class_run, 1, &setlist);
2889 add_cmd ("signal-thread", no_class, show_sig_thread_cmd,
2890 "Set the thread that gdb thinks is the libc signal thread.",
2892 add_alias_cmd ("sigthread", "signal-thread", no_class, 1, &showlist);
2894 add_cmd ("stopped", class_run, set_stopped_cmd,
2895 "Set whether gdb thinks the inferior process is stopped as with SIGSTOP.\n"
2896 "Stopped process will be continued by sending them a signal.",
2898 add_cmd ("stopped", no_class, show_signals_cmd,
2899 "Show whether gdb thinks the inferior process is stopped as with SIGSTOP.",
2902 add_cmd ("exceptions", class_run, set_exceptions_cmd,
2903 "Set whether exceptions in the inferior process will be trapped.\n"
2904 "When exceptions are turned off, neither breakpoints nor single-stepping\n"
2907 /* Allow `set exc' despite conflict with `set exception-port'. */
2908 add_alias_cmd ("exc", "exceptions", class_run, 1, &setlist);
2909 add_cmd ("exceptions", no_class, show_exceptions_cmd,
2910 "Show whether exceptions in the inferior process will be trapped.",
2913 add_prefix_cmd ("task", no_class, set_task_cmd,
2914 "Command prefix for setting task attributes.",
2915 &set_task_cmd_list, "set task ", 0, &setlist);
2916 add_prefix_cmd ("task", no_class, show_task_cmd,
2917 "Command prefix for showing task attributes.",
2918 &show_task_cmd_list, "show task ", 0, &showlist);
2920 add_cmd ("pause", class_run, set_task_pause_cmd,
2921 "Set whether the task is suspended while gdb has control.\n"
2922 "A value of \"on\" takes effect immediately, otherwise nothing\n"
2923 "happens until the next time the program is continued.\n"
2924 "When setting this to \"off\", \"set thread default pause on\"\n"
2925 "can be used to pause individual threads by default instead.",
2926 &set_task_cmd_list);
2927 add_cmd ("pause", no_class, show_task_pause_cmd,
2928 "Show whether the task is suspended while gdb has control.",
2929 &show_task_cmd_list);
2930 add_cmd ("detach-suspend-count", class_run, set_task_detach_sc_cmd,
2931 "Set the suspend count will leave on the thread when detaching.",
2932 &set_task_cmd_list);
2933 add_cmd ("detach-suspend-count", no_class, show_task_detach_sc_cmd,
2934 "Show the suspend count will leave on the thread when detaching.",
2935 &show_task_cmd_list);
2937 add_cmd ("exception-port", no_class, set_task_exc_port_cmd,
2938 "Set the task exception port to which we forward exceptions.\n"
2939 "The argument should be the value of the send right in the task.",
2940 &set_task_cmd_list);
2941 add_alias_cmd ("excp", "exception-port", no_class, 1, &set_task_cmd_list);
2942 add_alias_cmd ("exc-port", "exception-port", no_class, 1, &set_task_cmd_list);
2944 /* A convenient way of turning on all options require to noninvasively
2945 debug running tasks. */
2946 add_cmd ("noninvasive", no_class, set_noninvasive_cmd,
2947 "Set task options so that we interfere as little as possible.\n"
2948 "This is the same as setting `task pause', `exceptions', and"
2949 "`signals' to the opposite value.",
2952 /* Commands to show information about the task's ports. */
2953 add_cmd ("send-rights", class_info, info_send_rights_cmd,
2954 "Show information about the task's send rights",
2956 add_cmd ("receive-rights", class_info, info_recv_rights_cmd,
2957 "Show information about the task's receive rights",
2959 add_cmd ("port-rights", class_info, info_send_rights_cmd,
2960 "Show information about the task's port rights",
2962 add_cmd ("port-sets", class_info, info_port_sets_cmd,
2963 "Show information about the task's port sets",
2965 add_cmd ("dead-names", class_info, info_dead_names_cmd,
2966 "Show information about the task's dead names",
2968 add_info_alias ("ports", "port-rights", 1);
2969 add_info_alias ("port", "port-rights", 1);
2970 add_info_alias ("psets", "port-sets", 1);
2975 set_thread_pause_cmd (char *args, int from_tty)
2977 struct proc *thread = cur_thread ();
2978 int old_sc = thread->pause_sc;
2979 thread->pause_sc = parse_bool_arg (args, "set thread pause");
2980 if (old_sc == 0 && thread->pause_sc != 0 && thread->inf->pause_sc == 0)
2981 /* If the task is currently unsuspended, immediately suspend it,
2982 otherwise wait until the next time it gets control. */
2983 inf_suspend (thread->inf);
2987 show_thread_pause_cmd (char *args, int from_tty)
2989 struct proc *thread = cur_thread ();
2990 int sc = thread->pause_sc;
2991 check_empty (args, "show task pause");
2992 printf_unfiltered ("Thread %s %s suspended while gdb has control%s.\n",
2993 proc_string (thread),
2994 sc ? "is" : "isn't",
2995 !sc && thread->inf->pause_sc ? " (but the task is)" : "");
2999 set_thread_run_cmd (char *args, int from_tty)
3001 struct proc *thread = cur_thread ();
3002 thread->run_sc = parse_bool_arg (args, "set thread run") ? 0 : 1;
3006 show_thread_run_cmd (char *args, int from_tty)
3008 struct proc *thread = cur_thread ();
3009 check_empty (args, "show thread run");
3010 printf_unfiltered ("Thread %s %s allowed to run.",
3011 proc_string (thread),
3012 thread->run_sc == 0 ? "is" : "isn't");
3016 set_thread_detach_sc_cmd (char *args, int from_tty)
3018 cur_thread ()->detach_sc = parse_int_arg (args, "set thread detach-suspend-count");
3022 show_thread_detach_sc_cmd (char *args, int from_tty)
3024 struct proc *thread = cur_thread ();
3025 check_empty (args, "show thread detach-suspend-count");
3026 printf_unfiltered ("Thread %s will be left with a suspend count of %d when detaching.\n",
3027 proc_string (thread),
3032 set_thread_exc_port_cmd (char *args, int from_tty)
3034 struct proc *thread = cur_thread ();
3036 error ("No argument to \"set thread exception-port\" command.");
3037 steal_exc_port (thread, parse_and_eval_address (args));
3042 show_thread_cmd (char *args, int from_tty)
3044 struct proc *thread = cur_thread ();
3045 check_empty (args, "show thread");
3046 show_thread_run_cmd (0, from_tty);
3047 show_thread_pause_cmd (0, from_tty);
3048 if (thread->detach_sc != 0)
3049 show_thread_detach_sc_cmd (0, from_tty);
3054 thread_takeover_sc_cmd (char *args, int from_tty)
3056 struct proc *thread = cur_thread ();
3057 thread_basic_info_data_t _info;
3058 thread_basic_info_t info = &_info;
3059 mach_msg_type_number_t info_len = THREAD_BASIC_INFO_COUNT;
3061 thread_info (thread->port, THREAD_BASIC_INFO, (int *)&info, &info_len);
3063 error ("%s.", strerror (err));
3064 thread->sc = info->suspend_count;
3066 printf_unfiltered ("Suspend count was %d.\n", thread->sc);
3068 vm_deallocate (mach_task_self (), (vm_address_t)info, info_len * sizeof (int));
3071 add_thread_commands ()
3073 add_prefix_cmd ("thread", no_class, set_thread_cmd,
3074 "Command prefix for setting thread properties.",
3075 &set_thread_cmd_list, "set thread ", 0, &setlist);
3076 add_prefix_cmd ("default", no_class, show_thread_cmd,
3077 "Command prefix for setting default thread properties.",
3078 &set_thread_default_cmd_list, "set thread default ", 0,
3079 &set_thread_cmd_list);
3080 add_prefix_cmd ("thread", no_class, set_thread_default_cmd,
3081 "Command prefix for showing thread properties.",
3082 &show_thread_cmd_list, "show thread ", 0, &showlist);
3083 add_prefix_cmd ("default", no_class, show_thread_default_cmd,
3084 "Command prefix for showing default thread properties.",
3085 &show_thread_default_cmd_list, "show thread default ", 0,
3086 &show_thread_cmd_list);
3088 add_cmd ("pause", class_run, set_thread_pause_cmd,
3089 "Set whether the current thread is suspended while gdb has control.\n"
3090 "A value of \"on\" takes effect immediately, otherwise nothing\n"
3091 "happens until the next time the program is continued. This\n"
3092 "property normally has no effect because the whole task is suspended,\n"
3093 "however, that may be disabled with \"set task pause off\".\n"
3094 "The default value is \"off\".",
3095 &set_thread_cmd_list);
3096 add_cmd ("pause", no_class, show_thread_pause_cmd,
3097 "Show whether the current thread is suspended while gdb has control.",
3098 &show_thread_cmd_list);
3100 add_cmd ("run", class_run, set_thread_run_cmd,
3101 "Set whether the current thread is allowed to run.",
3102 &set_thread_cmd_list);
3103 add_cmd ("run", no_class, show_thread_run_cmd,
3104 "Show whether the current thread is allowed to run.",
3105 &show_thread_cmd_list);
3107 add_cmd ("detach-suspend-count", class_run, set_thread_detach_sc_cmd,
3108 "Set the suspend count will leave on the thread when detaching.\n"
3109 "Note that this is relative to suspend count when gdb noticed the thread;\n"
3110 "use the `thread takeover-suspend-count' to force it to an absolute value.",
3111 &set_thread_cmd_list);
3112 add_cmd ("detach-suspend-count", no_class, show_thread_detach_sc_cmd,
3113 "Show the suspend count will leave on the thread when detaching."
3114 "Note that this is relative to suspend count when gdb noticed the thread;\n"
3115 "use the `thread takeover-suspend-count' to force it to an absolute value.",
3116 &show_thread_cmd_list);
3118 add_cmd ("exception-port", no_class, set_thread_exc_port_cmd,
3119 "Set the exception port to which we forward exceptions for the\n"
3120 "current thread, overriding the task exception port.\n"
3121 "The argument should be the value of the send right in the task.",
3122 &set_thread_cmd_list);
3123 add_alias_cmd ("excp", "exception-port", no_class, 1, &set_thread_cmd_list);
3124 add_alias_cmd ("exc-port", "exception-port", no_class, 1, &set_thread_cmd_list);
3126 add_cmd ("takeover-suspend-count", no_class, thread_takeover_sc_cmd,
3127 "Force the threads absolute suspend-count to be gdb's.\n"
3128 "Prior to giving this command, gdb's thread suspend-counts are relative to\n"
3129 "the thread's initial suspend-count when gdb notices the threads.",
3134 _initialize_gnu_nat ()
3136 proc_server = getproc ();
3138 add_target (&gnu_ops);
3139 add_task_commands ();
3140 add_thread_commands ();
3142 #if MAINTENANCE_CMDS
3143 add_set_cmd ("gnu-debug", class_maintenance,
3144 var_boolean, (char *)&gnu_debug_flag,
3145 "Set debugging output for the gnu backend.", &maintenancelist);
3149 #ifdef FLUSH_INFERIOR_CACHE
3151 /* When over-writing code on some machines the I-Cache must be flushed
3152 explicitly, because it is not kept coherent by the lazy hardware.
3153 This definitely includes breakpoints, for instance, or else we
3154 end up looping in mysterious Bpt traps */
3157 flush_inferior_icache(pc, amount)
3160 vm_machine_attribute_val_t flush = MATTR_VAL_ICACHE_FLUSH;
3163 ret = vm_machine_attribute (current_inferior->task->port,
3168 if (ret != KERN_SUCCESS)
3169 warning ("Error flushing inferior's cache : %s", strerror (ret));
3171 #endif FLUSH_INFERIOR_CACHE