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"
71 #include "exc_request_U.h"
74 static process_t proc_server = MACH_PORT_NULL;
76 /* If we've sent a proc_wait_request to the proc server, the pid of the
77 process we asked about. We can only ever have one outstanding. */
78 int proc_wait_pid = 0;
80 /* The number of wait requests we've sent, and expect replies from. */
81 int proc_waits_pending = 0;
83 int gnu_debug_flag = 0;
87 extern struct target_ops gnu_ops;
88 extern char *strerror();
90 int inf_update_procs (struct inf *inf);
91 struct inf *make_inf ();
92 void inf_clear_wait (struct inf *inf);
93 void inf_cleanup (struct inf *inf);
94 void inf_startup (struct inf *inf, int pid);
95 int inf_update_suspends (struct inf *inf);
96 void inf_set_pid (struct inf *inf, pid_t pid);
97 void inf_validate_procs (struct inf *inf);
98 void inf_steal_exc_ports (struct inf *inf);
99 void inf_restore_exc_ports (struct inf *inf);
100 struct proc *inf_tid_to_proc (struct inf *inf, int tid);
101 inline void inf_set_threads_resume_sc (struct inf *inf,
102 struct proc *run_thread,
104 inline int inf_set_threads_resume_sc_for_signal_thread (struct inf *inf);
105 inline void inf_suspend (struct inf *inf);
106 inline void inf_resume (struct inf *inf);
107 void inf_set_step_thread (struct inf *inf, struct proc *proc);
108 void inf_detach (struct inf *inf);
109 void inf_attach (struct inf *inf, int pid);
110 void inf_signal (struct inf *inf, enum target_signal sig);
112 #define inf_debug(_inf, msg, args...) \
113 do { struct inf *__inf = (_inf); \
114 debug ("{inf %d %p}: " msg, __inf->pid, __inf , ##args); } while (0)
116 void proc_abort (struct proc *proc, int force);
117 thread_state_t proc_get_state (struct proc *proc, int force);
118 struct proc *make_proc (struct inf *inf, mach_port_t port, int tid);
119 struct proc *_proc_free (struct proc *proc);
120 int proc_update_sc (struct proc *proc);
121 error_t proc_get_exception_port (struct proc *proc, mach_port_t *port);
122 error_t proc_set_exception_port (struct proc *proc, mach_port_t port);
123 static mach_port_t _proc_get_exc_port (struct proc *proc);
124 void proc_steal_exc_port (struct proc *proc, mach_port_t exc_port);
125 void proc_restore_exc_port (struct proc *proc);
126 int proc_trace (struct proc *proc, int set);
127 char *proc_string (struct proc *proc);
129 /* Evaluate RPC_EXPR in a scope with the variables MSGPORT and REFPORT bound
130 to INF's msg port and task port respectively. If it has no msg port,
131 EIEIO is returned. INF must refer to a running process! */
132 #define INF_MSGPORT_RPC(inf, rpc_expr) \
133 HURD_MSGPORT_RPC (proc_getmsgport (proc_server, inf->pid, &msgport), \
134 (refport = inf->task->port, 0), 0, \
135 msgport ? (rpc_expr) : EIEIO)
137 /* Like INF_MSGPORT_RPC, but will also resume the signal thread to ensure
138 there's someone around to deal with the RPC (and resuspend things
139 afterwards). This effects INF's threads' resume_sc count. */
140 #define INF_RESUME_MSGPORT_RPC(inf, rpc_expr) \
141 (inf_set_threads_resume_sc_for_signal_thread (inf) \
144 __e = INF_MSGPORT_RPC (inf, rpc_expr); \
149 #define MIG_SERVER_DIED EMIG_SERVER_DIED /* XXX */
151 /* The state passed by an exception message. */
154 int exception; /* The exception code */
156 mach_port_t handler; /* The real exception port to handle this. */
157 mach_port_t reply; /* The reply port from the exception call. */
160 /* The results of the last wait an inf did. */
163 struct target_waitstatus status; /* The status returned to gdb. */
164 struct exc_state exc; /* The exception that caused us to return. */
165 struct proc *thread; /* The thread in question. */
166 int suppress; /* Something trivial happened. */
169 /* The state of an inferior. */
172 /* Fields describing the current inferior. */
174 struct proc *task; /* The mach task. */
175 struct proc *threads; /* A linked list of all threads in TASK. */
177 /* True if THREADS needn't be validated by querying the task. We assume that
178 we and the task in question are the only ones frobbing the thread list,
179 so as long as we don't let any code run, we don't have to worry about
181 int threads_up_to_date;
183 pid_t pid; /* The real system PID. */
185 struct inf_wait wait; /* What to return from target_wait. */
187 /* One thread proc in INF may be in `single-stepping mode'. This is it. */
188 struct proc *step_thread;
190 /* The thread we think is the signal thread. */
191 struct proc *signal_thread;
193 mach_port_t event_port; /* Where we receive various msgs. */
195 /* True if we think at least one thread in the inferior could currently be
199 /* True if the process has stopped (in the proc server sense). Note that
200 since a proc server `stop' leaves the signal thread running, the inf can
201 be RUNNING && STOPPED... */
204 /* True if the inferior is traced. */
207 /* True if we shouldn't try waiting for the inferior, usually because we
208 can't for some reason. */
211 /* When starting a new inferior, we don't try to validate threads until all
212 the proper execs have been done. This is a count of how many execs we
214 unsigned pending_execs;
216 /* Fields describing global state */
218 /* The task suspend count used when gdb has control. This is normally 1 to
219 make things easier for us, but sometimes (like when attaching to vital
220 system servers) it may be desirable to let the task continue to run
221 (pausing individual threads as necessary). */
224 /* The task suspend count left when detaching from a task. */
227 /* The initial values used for the run_sc and pause_sc of newly discovered
228 threads -- see the definition of those fields in struct proc. */
229 int default_thread_run_sc;
230 int default_thread_pause_sc;
231 int default_thread_detach_sc;
233 /* True if the process should be traced when started/attached. Newly
234 started processes *must* be traced at first to exec them properly, but
235 if this is false, tracing is turned off as soon it has done so. */
238 /* True if exceptions from the inferior process should be trapped. This
239 must be on to use breakpoints. */
244 int __proc_pid (struct proc *proc)
246 return proc->inf->pid;
249 /* Update PROC's real suspend count to match it's desired one. Returns true
250 if we think PROC is now in a runnable state. */
252 proc_update_sc (struct proc *proc)
256 int delta = proc->sc - proc->cur_sc;
259 proc_debug (proc, "sc: %d --> %d", proc->cur_sc, proc->sc);
261 if (proc->sc == 0 && proc->state_changed)
262 /* Since PROC may start running, we must write back any state changes. */
264 assert (proc_is_thread (proc));
265 proc_debug (proc, "storing back changed thread state");
266 err = thread_set_state (proc->port, THREAD_STATE_FLAVOR,
267 (thread_state_t)&proc->state, THREAD_STATE_SIZE);
269 proc->state_changed = 0;
273 while (delta-- > 0 && !err)
274 if (proc_is_task (proc))
275 err = task_suspend (proc->port);
277 err = thread_suspend (proc->port);
279 while (delta++ < 0 && !err)
280 if (proc_is_task (proc))
281 err = task_resume (proc->port);
283 err = thread_resume (proc->port);
286 proc->cur_sc = proc->sc;
288 /* If we got an error, then the task/thread has disappeared. */
289 running = !err && proc->sc == 0;
291 proc_debug (proc, "is %s", err ? "dead" : running ? "running" : "suspended");
293 proc_debug (proc, "err = %s", strerror (err));
298 proc->state_valid = proc->state_changed = 0;
299 proc->fetched_regs = 0;
305 /* Thread_abort is called on PROC if needed. PROC must be a thread proc.
306 If PROC is deemed `precious', then nothing is done unless FORCE is true.
307 In particular, a thread is precious if it's running (in which case forcing
308 it includes suspending it first), or if it has an exception pending. */
310 proc_abort (struct proc *proc, int force)
312 assert (proc_is_thread (proc));
316 struct inf *inf = proc->inf;
317 int running = (proc->cur_sc == 0 && inf->task->cur_sc == 0);
319 if (running && force)
322 inf_update_suspends (proc->inf);
324 warning ("Stopped %s.", proc_string (proc));
326 else if (proc == inf->wait.thread && inf->wait.exc.reply && !force)
327 /* An exception is pending on PROC, which don't mess with. */
331 /* We only abort the thread if it's not actually running. */
333 thread_abort (proc->port);
334 proc_debug (proc, "aborted");
338 proc_debug (proc, "not aborting");
342 /* Make sure that the state field in PROC is up to date, and return a pointer
343 to it, or 0 if something is wrong. If WILL_MODIFY is true, makes sure
344 that the thread is stopped and aborted first, and sets the state_changed
345 field in PROC to true. */
347 proc_get_state (struct proc *proc, int will_modify)
349 int was_aborted = proc->aborted;
351 proc_debug (proc, "updating state info%s",
352 will_modify ? " (with intention to modify)" : "");
354 proc_abort (proc, will_modify);
356 if (! was_aborted && proc->aborted)
357 /* PROC's state may have changed since we last fetched it. */
358 proc->state_valid = 0;
360 if (! proc->state_valid)
362 mach_msg_type_number_t state_size = THREAD_STATE_SIZE;
364 thread_get_state (proc->port, THREAD_STATE_FLAVOR,
365 (thread_state_t)&proc->state, &state_size);
366 proc_debug (proc, "getting thread state");
367 proc->state_valid = !err;
370 if (proc->state_valid)
373 proc->state_changed = 1;
374 return (thread_state_t)&proc->state;
380 /* Set PORT to PROC's exception port. */
382 proc_get_exception_port (struct proc *proc, mach_port_t *port)
384 if (proc_is_task (proc))
385 return task_get_exception_port (proc->port, port);
387 return thread_get_exception_port (proc->port, port);
390 /* Set PROC's exception port to PORT. */
392 proc_set_exception_port (struct proc *proc, mach_port_t port)
394 proc_debug (proc, "setting exception port: %d", port);
395 if (proc_is_task (proc))
396 return task_set_exception_port (proc->port, port);
398 return thread_set_exception_port (proc->port, port);
401 /* Get PROC's exception port, cleaning up a bit if proc has died. */
403 _proc_get_exc_port (struct proc *proc)
405 mach_port_t exc_port;
406 error_t err = proc_get_exception_port (proc, &exc_port);
409 /* PROC must be dead. */
412 mach_port_deallocate (mach_task_self (), proc->exc_port);
413 proc->exc_port = MACH_PORT_NULL;
414 if (proc->saved_exc_port)
415 mach_port_deallocate (mach_task_self (), proc->saved_exc_port);
416 proc->saved_exc_port = MACH_PORT_NULL;
422 /* Replace PROC's exception port with EXC_PORT, unless it's already been
423 done. Stash away any existing exception port so we can restore it later. */
425 proc_steal_exc_port (struct proc *proc, mach_port_t exc_port)
427 mach_port_t cur_exc_port = _proc_get_exc_port (proc);
433 proc_debug (proc, "inserting exception port: %d", exc_port);
435 if (cur_exc_port != exc_port)
436 /* Put in our exception port. */
437 err = proc_set_exception_port (proc, exc_port);
439 if (err || cur_exc_port == proc->exc_port)
440 /* We previously set the exception port, and it's still set. So we
441 just keep the old saved port which is what the proc set. */
444 mach_port_deallocate (mach_task_self (), cur_exc_port);
447 /* Keep a copy of PROC's old exception port so it can be restored. */
449 if (proc->saved_exc_port)
450 mach_port_deallocate (mach_task_self (), proc->saved_exc_port);
451 proc->saved_exc_port = cur_exc_port;
454 proc_debug (proc, "saved exception port: %d", proc->saved_exc_port);
457 proc->exc_port = exc_port;
459 warning ("Error setting exception port for %s: %s",
460 proc_string (proc), strerror (err));
464 /* If we previously replaced PROC's exception port, put back what we
465 found there at the time, unless *our* exception port has since been
466 overwritten, in which case who knows what's going on. */
468 proc_restore_exc_port (struct proc *proc)
470 mach_port_t cur_exc_port = _proc_get_exc_port (proc);
476 proc_debug (proc, "restoring real exception port");
478 if (proc->exc_port == cur_exc_port)
479 /* Our's is still there. */
480 err = proc_set_exception_port (proc, proc->saved_exc_port);
482 if (proc->saved_exc_port)
483 mach_port_deallocate (mach_task_self (), proc->saved_exc_port);
484 proc->saved_exc_port = MACH_PORT_NULL;
487 proc->exc_port = MACH_PORT_NULL;
489 warning ("Error setting exception port for %s: %s",
490 proc_string (proc), strerror (err));
494 /* Turns hardware tracing in PROC on or off when SET is true or false,
495 respectively. Returns true on success. */
497 proc_trace (struct proc *proc, int set)
499 thread_state_t state = proc_get_state (proc, 1);
502 return 0; /* the thread must be dead. */
504 proc_debug (proc, "tracing %s", set ? "on" : "off");
508 /* XXX We don't get the exception unless the thread has its own
509 exception port???? */
510 if (proc->exc_port == MACH_PORT_NULL)
511 proc_steal_exc_port (proc, proc->inf->event_port);
512 THREAD_STATE_SET_TRACED (state);
515 THREAD_STATE_CLEAR_TRACED (state);
520 /* A variable from which to assign new TIDs. */
521 static int next_thread_id = 1;
523 /* Returns a new proc structure with the given fields. Also adds a
524 notification for PORT becoming dead to be sent to INF's notify port. */
526 make_proc (struct inf *inf, mach_port_t port, int tid)
529 mach_port_t prev_port = MACH_PORT_NULL;
530 struct proc *proc = malloc (sizeof (struct proc));
536 proc->saved_exc_port = MACH_PORT_NULL;
537 proc->exc_port = MACH_PORT_NULL;
542 /* Note that these are all the values for threads; the task simply uses the
543 corresponding field in INF directly. */
544 proc->run_sc = inf->default_thread_run_sc;
545 proc->pause_sc = inf->default_thread_pause_sc;
546 proc->detach_sc = inf->default_thread_detach_sc;
547 proc->resume_sc = proc->run_sc;
551 proc->state_valid = 0;
552 proc->state_changed = 0;
554 proc_debug (proc, "is new");
556 /* Get notified when things die. */
558 mach_port_request_notification (mach_task_self(), port,
559 MACH_NOTIFY_DEAD_NAME, 1,
561 MACH_MSG_TYPE_MAKE_SEND_ONCE,
564 warning ("Couldn't request notification for port %d: %s",
565 port, strerror (err));
568 proc_debug (proc, "notifications to: %d", inf->event_port);
569 if (prev_port != MACH_PORT_NULL)
570 mach_port_deallocate (mach_task_self (), prev_port);
573 if (inf->want_exceptions)
574 if (proc_is_task (proc))
575 /* Make the task exception port point to us. */
576 proc_steal_exc_port (proc, inf->event_port);
578 /* Just clear thread exception ports -- they default to the task one. */
579 proc_steal_exc_port (proc, MACH_PORT_NULL);
584 /* Frees PROC and any resources it uses, and returns the value of PROC's
587 _proc_free (struct proc *proc)
589 struct inf *inf = proc->inf;
590 struct proc *next = proc->next;
592 proc_debug (proc, "freeing...");
594 if (proc == inf->step_thread)
595 /* Turn off single stepping. */
596 inf_set_step_thread (inf, 0);
597 if (proc == inf->wait.thread)
598 inf_clear_wait (inf);
599 if (proc == inf->signal_thread)
600 inf->signal_thread = 0;
602 if (proc->port != MACH_PORT_NULL)
604 if (proc->exc_port != MACH_PORT_NULL)
605 /* Restore the original exception port. */
606 proc_restore_exc_port (proc);
607 if (proc->cur_sc != 0)
608 /* Resume the thread/task. */
611 proc_update_sc (proc);
613 mach_port_deallocate (mach_task_self (), proc->port);
620 struct inf *make_inf ()
622 struct inf *inf = malloc (sizeof (struct inf));
629 inf->threads_up_to_date = 0;
631 inf->wait.status.kind = TARGET_WAITKIND_SPURIOUS;
632 inf->wait.thread = 0;
633 inf->wait.exc.handler = MACH_PORT_NULL;
634 inf->wait.exc.reply = MACH_PORT_NULL;
635 inf->step_thread = 0;
636 inf->signal_thread = 0;
637 inf->event_port = MACH_PORT_NULL;
642 inf->pending_execs = 0;
645 inf->default_thread_run_sc = 0;
646 inf->default_thread_pause_sc = 0;
647 inf->default_thread_detach_sc = 0;
648 inf->want_signals = 1; /* By default */
649 inf->want_exceptions = 1; /* By default */
654 /* clear INF's target wait status. */
656 inf_clear_wait (struct inf *inf)
658 inf_debug (inf, "clearing wait");
659 inf->wait.status.kind = TARGET_WAITKIND_SPURIOUS;
660 inf->wait.thread = 0;
661 inf->wait.suppress = 0;
662 if (inf->wait.exc.handler != MACH_PORT_NULL)
664 mach_port_deallocate (mach_task_self (), inf->wait.exc.handler);
665 inf->wait.exc.handler = MACH_PORT_NULL;
667 if (inf->wait.exc.reply != MACH_PORT_NULL)
669 mach_port_deallocate (mach_task_self (), inf->wait.exc.reply);
670 inf->wait.exc.reply = MACH_PORT_NULL;
675 inf_cleanup (struct inf *inf)
677 inf_debug (inf, "cleanup");
679 inf_clear_wait (inf);
681 inf_set_pid (inf, -1);
687 inf->pending_execs = 0;
691 mach_port_destroy (mach_task_self (), inf->event_port);
692 inf->event_port = MACH_PORT_NULL;
697 inf_startup (struct inf *inf, int pid)
701 inf_debug (inf, "startup: pid = %d", pid);
705 /* Make the port on which we receive all events. */
706 err = mach_port_allocate (mach_task_self (),
707 MACH_PORT_RIGHT_RECEIVE, &inf->event_port);
709 error ("Error allocating event port: %s", strerror (err));
711 /* Make a send right for it, so we can easily copy it for other people. */
712 mach_port_insert_right (mach_task_self (), inf->event_port,
713 inf->event_port, MACH_MSG_TYPE_MAKE_SEND);
714 inf_set_pid (inf, pid);
717 /* close current process, if any, and attach INF to process PORT */
719 inf_set_pid (struct inf *inf, pid_t pid)
722 struct proc *task = inf->task;
724 inf_debug (inf, "setting pid: %d", pid);
727 task_port = MACH_PORT_NULL;
730 error_t err = proc_pid2task (proc_server, pid, &task_port);
732 error ("Error getting task for pid %d: %s", pid, strerror (err));
735 inf_debug (inf, "setting task: %d", task_port);
738 task_suspend (task_port);
740 if (task && task->port != task_port)
743 inf_validate_procs (inf); /* Trash all the threads. */
744 _proc_free (task); /* And the task. */
747 if (task_port != MACH_PORT_NULL)
749 inf->task = make_proc (inf, task_port, PROC_TID_TASK);
750 inf->threads_up_to_date = 0;
757 inf->task->sc = inf->task->cur_sc = 1; /* Reflect task_suspend above */
763 /* Validates INF's stopped field from the actual proc server state. */
765 inf_validate_stopped (struct inf *inf)
768 mach_msg_type_number_t noise_len = 0;
770 mach_msg_type_number_t pi_len = 0;
773 proc_getprocinfo (proc_server, inf->pid, &info_flags,
774 (procinfo_t *)&pi, &pi_len, &noise, &noise_len);
778 inf->stopped = !!(pi->state & PI_STOPPED);
779 vm_deallocate (mach_task_self (), (vm_address_t)pi, pi_len);
781 vm_deallocate (mach_task_self (), (vm_address_t)noise, noise_len);
785 /* Validates INF's task suspend count. If it's higher than we expect, verify
786 with the user before `stealing' the extra count. */
788 inf_validate_task_sc (struct inf *inf)
790 struct task_basic_info info;
791 mach_msg_type_number_t info_len = TASK_BASIC_INFO_COUNT;
793 task_info (inf->task->port, TASK_BASIC_INFO, (task_info_t)&info, &info_len);
796 inf->task->dead = 1; /* oh well */
797 else if (inf->task->cur_sc < info.suspend_count)
801 target_terminal_ours (); /* Allow I/O. */
803 !query ("Pid %d has an additional task suspend count of %d; clear it? ",
804 inf->pid, info.suspend_count - inf->task->cur_sc);
805 target_terminal_inferior (); /* Give it back to the child. */
808 error ("Additional task suspend count left untouched.");
810 inf->task->cur_sc = info.suspend_count;
814 /* Turns tracing for INF on or off, depending on ON, unless it already is.
815 If INF is running, the resume_sc count of INF's threads will be modified,
816 and the signal thread will briefly be run to change the trace state. */
818 inf_set_traced (struct inf *inf, int on)
820 if (on != inf->traced)
821 if (inf->task && !inf->task->dead)
822 /* Make it take effect immediately. */
824 sigset_t mask = on ? ~(sigset_t)0 : 0;
826 INF_RESUME_MSGPORT_RPC (inf, msg_set_init_int (msgport, refport,
827 INIT_TRACEMASK, mask));
831 warning ("Can't modify tracing state for pid %d: No signal thread",
836 warning ("Can't modify tracing state for pid %d: %s",
837 inf->pid, strerror (err));
845 /* Makes all the real suspend count deltas of all the procs in INF match the
846 desired values. Careful to always do thread/task suspend counts in the
847 safe order. Returns true if at least one thread is thought to be running.*/
849 inf_update_suspends (struct inf *inf)
851 struct proc *task = inf->task;
852 /* We don't have to update INF->threads even though we're iterating over it
853 because we'll change a thread only if it already has an existing proc
856 inf_debug (inf, "updating suspend counts");
861 int task_running = (task->sc == 0), thread_running = 0;
863 if (task->sc > task->cur_sc)
864 /* The task is becoming _more_ suspended; do before any threads. */
865 task_running = proc_update_sc (task);
867 if (inf->pending_execs)
868 /* When we're waiting for an exec, things may be happening behind our
869 back, so be conservative. */
872 /* Do all the thread suspend counts. */
873 for (thread = inf->threads; thread; thread = thread->next)
874 thread_running |= proc_update_sc (thread);
876 if (task->sc != task->cur_sc)
877 /* We didn't do the task first, because we wanted to wait for the
878 threads; do it now. */
879 task_running = proc_update_sc (task);
881 inf_debug (inf, "%srunning...",
882 (thread_running && task_running) ? "" : "not ");
884 inf->running = thread_running && task_running;
886 /* Once any thread has executed some code, we can't depend on the
887 threads list any more. */
889 inf->threads_up_to_date = 0;
897 /* Converts a GDB pid to a struct proc. */
899 inf_tid_to_thread (struct inf *inf, int tid)
901 struct proc *thread = inf->threads;
904 if (thread->tid == tid)
907 thread = thread->next;
911 /* Converts a thread port to a struct proc. */
913 inf_port_to_thread (struct inf *inf, mach_port_t port)
915 struct proc *thread = inf->threads;
917 if (thread->port == port)
920 thread = thread->next;
924 /* Make INF's list of threads be consistent with reality of TASK. */
926 inf_validate_procs (struct inf *inf)
929 thread_array_t threads;
930 unsigned num_threads;
931 struct proc *task = inf->task;
933 /* If no threads are currently running, this function will guarantee that
934 things are up to date. The exception is if there are zero threads --
935 then it is almost certainly in an odd state, and probably some outside
936 agent will create threads. */
937 inf->threads_up_to_date = inf->threads ? !inf->running : 0;
941 error_t err = task_threads (task->port, &threads, &num_threads);
942 inf_debug (inf, "fetching threads");
944 /* TASK must be dead. */
954 inf_debug (inf, "no task");
958 unsigned search_start = 0; /* Make things normally linear. */
959 /* Which thread in PROCS corresponds to each task thread, & the task. */
960 struct proc *matched[num_threads + 1];
961 /* The last thread in INF->threads, so we can add to the end. */
962 struct proc *last = 0;
963 /* The current thread we're considering. */
964 struct proc *thread = inf->threads;
966 bzero (matched, sizeof (matched));
972 for (i = search_start, left = num_threads; left; i++, left--)
974 if (i >= num_threads)
975 i -= num_threads; /* I wrapped around. */
976 if (thread->port == threads[i])
977 /* We already know about this thread. */
981 thread = thread->next;
989 proc_debug (thread, "died!");
990 thread->port = MACH_PORT_NULL;
991 thread = _proc_free (thread); /* THREAD is dead. */
992 (last ? last->next : inf->threads) = thread;
996 for (i = 0; i < num_threads; i++)
998 /* Throw away the duplicate send right. */
999 mach_port_deallocate (mach_task_self (), threads[i]);
1001 /* THREADS[I] is a thread we don't know about yet! */
1003 thread = make_proc (inf, threads[i], next_thread_id++);
1004 (last ? last->next : inf->threads) = thread;
1006 proc_debug (thread, "new thread: %d", threads[i]);
1007 add_thread (thread->tid); /* Tell GDB's generic thread code. */
1010 vm_deallocate(mach_task_self(),
1011 (vm_address_t)threads, (num_threads * sizeof(thread_t)));
1015 /* Makes sure that INF's thread list is synced with the actual process. */
1017 inf_update_procs (struct inf *inf)
1021 if (! inf->threads_up_to_date)
1022 inf_validate_procs (inf);
1026 /* Sets the resume_sc of each thread in inf. That of RUN_THREAD is set to 0,
1027 and others are set to their run_sc if RUN_OTHERS is true, and otherwise
1030 inf_set_threads_resume_sc (struct inf *inf,
1031 struct proc *run_thread, int run_others)
1033 struct proc *thread;
1034 inf_update_procs (inf);
1035 for (thread = inf->threads; thread; thread = thread->next)
1036 if (thread == run_thread)
1037 thread->resume_sc = 0;
1038 else if (run_others)
1039 thread->resume_sc = thread->run_sc;
1041 thread->resume_sc = thread->pause_sc;
1044 /* Cause INF to continue execution immediately; individual threads may still
1045 be suspended (but their suspend counts will be updated). */
1047 inf_resume (struct inf *inf)
1049 struct proc *thread;
1051 inf_update_procs (inf);
1053 for (thread = inf->threads; thread; thread = thread->next)
1054 thread->sc = thread->resume_sc;
1058 if (! inf->pending_execs)
1059 /* Try to make sure our task count is correct -- in the case where
1060 we're waiting for an exec though, things are too volatile, so just
1061 assume things will be reasonable (which they usually will be). */
1062 inf_validate_task_sc (inf);
1066 inf_update_suspends (inf);
1069 /* Cause INF to stop execution immediately; individual threads may still
1072 inf_suspend (struct inf *inf)
1074 struct proc *thread;
1076 inf_update_procs (inf);
1078 for (thread = inf->threads; thread; thread = thread->next)
1079 thread->sc = thread->pause_sc;
1082 inf->task->sc = inf->pause_sc;
1084 inf_update_suspends (inf);
1087 /* INF has one thread PROC that is in single-stepping mode. This function
1088 changes it to be PROC, changing any old step_thread to be a normal one. A
1089 PROC of 0 clears any existing value. */
1091 inf_set_step_thread (struct inf *inf, struct proc *thread)
1093 assert (!thread || proc_is_thread (thread));
1096 inf_debug (inf, "setting step thread: %d/%d", inf->pid, thread->tid);
1098 inf_debug (inf, "clearing step thread");
1100 if (inf->step_thread != thread)
1102 if (inf->step_thread && inf->step_thread->port != MACH_PORT_NULL)
1103 if (! proc_trace (inf->step_thread, 0))
1105 if (thread && proc_trace (thread, 1))
1106 inf->step_thread = thread;
1108 inf->step_thread = 0;
1112 /* Set up the thread resume_sc's so that only the signal thread is running
1113 (plus whatever other thread are set to always run). Returns true if we
1114 did so, or false if we can't find a signal thread. */
1116 inf_set_threads_resume_sc_for_signal_thread (struct inf *inf)
1118 if (inf->signal_thread)
1120 inf_set_threads_resume_sc (inf, inf->signal_thread, 0);
1128 inf_update_signal_thread (struct inf *inf)
1130 /* XXX for now we assume that if there's a msgport, the 2nd thread is
1131 the signal thread. */
1132 inf->signal_thread = inf->threads ? inf->threads->next : 0;
1135 /* Detachs from INF's inferior task, letting it run once again... */
1137 inf_detach (struct inf *inf)
1139 struct proc *task = inf->task;
1141 inf_debug (inf, "detaching...");
1143 inf_clear_wait (inf);
1144 inf_set_step_thread (inf, 0);
1148 struct proc *thread;
1150 inf_set_traced (inf, 0);
1152 inf_signal (inf, TARGET_SIGNAL_0);
1154 proc_restore_exc_port (task);
1155 task->sc = inf->detach_sc;
1157 for (thread = inf->threads; thread; thread = thread->next)
1159 proc_restore_exc_port (thread);
1160 thread->sc = thread->detach_sc;
1163 inf_update_suspends (inf);
1169 /* Attaches INF to the process with process id PID, returning it in a suspended
1170 state suitable for debugging. */
1172 inf_attach (struct inf *inf, int pid)
1174 inf_debug (inf, "attaching: %d", pid);
1179 inf_startup (inf, pid);
1182 /* Makes sure that we've got our exception ports entrenched in the process. */
1183 void inf_steal_exc_ports (struct inf *inf)
1185 struct proc *thread;
1187 inf_debug (inf, "stealing exception ports");
1189 inf_set_step_thread (inf, 0); /* The step thread is special. */
1191 proc_steal_exc_port (inf->task, inf->event_port);
1192 for (thread = inf->threads; thread; thread = thread->next)
1193 proc_steal_exc_port (thread, MACH_PORT_NULL);
1196 /* Makes sure the process has its own exception ports. */
1197 void inf_restore_exc_ports (struct inf *inf)
1199 struct proc *thread;
1201 inf_debug (inf, "restoring exception ports");
1203 inf_set_step_thread (inf, 0); /* The step thread is special. */
1205 proc_restore_exc_port (inf->task);
1206 for (thread = inf->threads; thread; thread = thread->next)
1207 proc_restore_exc_port (thread);
1210 /* Deliver signal SIG to INF. If INF is stopped, delivering a signal, even
1211 signal 0, will continue it. INF is assumed to be in a paused state, and
1212 the resume_sc's of INF's threads may be affected. */
1214 inf_signal (struct inf *inf, enum target_signal sig)
1217 int host_sig = target_signal_to_host (sig);
1219 #define NAME target_signal_to_name (sig)
1221 if (host_sig >= _NSIG)
1222 /* A mach exception. Exceptions are encoded in the signal space by
1223 putting them after _NSIG; this assumes they're positive (and not
1224 extremely large)! */
1226 struct inf_wait *w = &inf->wait;
1227 if (w->status.kind == TARGET_WAITKIND_STOPPED
1228 && w->status.value.sig == sig
1229 && w->thread && !w->thread->aborted)
1230 /* We're passing through the last exception we received. This is
1231 kind of bogus, because exceptions are per-thread whereas gdb
1232 treats signals as per-process. We just forward the exception to
1233 the correct handler, even it's not for the same thread as TID --
1234 i.e., we pretend it's global. */
1236 struct exc_state *e = &w->exc;
1237 inf_debug (inf, "passing through exception:"
1238 " task = %d, thread = %d, exc = %d"
1239 ", code = %d, subcode = %d",
1240 w->thread->port, inf->task->port,
1241 e->exception, e->code, e->subcode);
1243 exception_raise_request (e->handler,
1244 e->reply, MACH_MSG_TYPE_MOVE_SEND_ONCE,
1245 w->thread->port, inf->task->port,
1246 e->exception, e->code, e->subcode);
1249 error ("Can't forward spontaneous exception (%s).", NAME);
1252 /* A Unix signal. */
1254 /* The process is stopped and expecting a signal. Just send off a
1255 request and let it get handled when we resume everything. */
1257 inf_debug (inf, "sending %s to stopped process", NAME);
1259 INF_MSGPORT_RPC (inf,
1260 msg_sig_post_untraced_request (msgport,
1262 MACH_MSG_TYPE_MAKE_SEND_ONCE,
1266 /* Posting an untraced signal automatically continues it.
1267 We clear this here rather than when we get the reply
1268 because we'd rather assume it's not stopped when it
1269 actually is, than the reverse. */
1273 /* It's not expecting it. We have to let just the signal thread
1274 run, and wait for it to get into a reasonable state before we
1275 can continue the rest of the process. When we finally resume the
1276 process the signal we request will be the very first thing that
1279 inf_debug (inf, "sending %s to unstopped process (so resuming signal thread)", NAME);
1281 INF_RESUME_MSGPORT_RPC (inf, msg_sig_post_untraced (msgport,
1282 host_sig, 0, refport));
1286 /* Can't do too much... */
1287 warning ("Can't deliver signal %s: No signal thread.", NAME);
1289 warning ("Delivering signal %s: %s", NAME, strerror (err));
1294 /* The inferior used for all gdb target ops. */
1295 struct inf *current_inferior = 0;
1297 /* The inferior being waited for by gnu_wait. Since GDB is decidely not
1298 multi-threaded, we don't bother to lock this. */
1299 struct inf *waiting_inf;
1301 /* Wait for something to happen in the inferior, returning what in STATUS. */
1303 gnu_wait (int tid, struct target_waitstatus *status)
1306 mach_msg_header_t hdr;
1307 mach_msg_type_t type;
1311 struct proc *thread;
1312 struct inf *inf = current_inferior;
1316 if (!inf->threads && !inf->pending_execs)
1317 /* No threads! Assume that maybe some outside agency is frobbing our
1318 task, and really look for new threads. If we can't find any, just tell
1319 the user to try again later. */
1321 inf_validate_procs (inf);
1322 if (!inf->threads && !inf->task->dead)
1323 error ("There are no threads; try again later.");
1328 inf_debug (inf, "waiting for: %d", tid);
1331 if (proc_wait_pid != inf->pid && !inf->no_wait)
1332 /* Always get information on events from the proc server. */
1334 inf_debug (inf, "requesting wait on pid %d", inf->pid);
1337 /* The proc server is single-threaded, and only allows a single
1338 outstanding wait request, so we have to cancel the previous one. */
1340 inf_debug (inf, "cancelling previous wait on pid %d", proc_wait_pid);
1341 interrupt_operation (proc_server, 0);
1345 proc_wait_request (proc_server, inf->event_port, inf->pid, WUNTRACED);
1347 warning ("wait request failed: %s", strerror (err));
1350 inf_debug (inf, "waits pending: %d", proc_waits_pending);
1351 proc_wait_pid = inf->pid;
1352 /* Even if proc_waits_pending was > 0 before, we still won't get
1353 any other replies, because it was either from a different INF,
1354 or a different process attached to INF -- and the event port,
1355 which is the wait reply port, changes when you switch processes.*/
1356 proc_waits_pending = 1;
1360 inf_clear_wait (inf);
1362 /* What can happen? (1) Dead name notification; (2) Exceptions arrive;
1363 (3) wait reply from the proc server. */
1365 inf_debug (inf, "waiting for an event...");
1366 err = mach_msg (&msg.hdr, MACH_RCV_MSG | MACH_RCV_INTERRUPT,
1367 0, sizeof (struct msg), inf->event_port,
1368 MACH_MSG_TIMEOUT_NONE, MACH_PORT_NULL);
1370 /* Re-suspend the task. */
1373 if (!inf->task && inf->pending_execs)
1374 /* When doing an exec, it's possible that the old task wasn't reused
1375 (e.g., setuid execs). So if the task seems to have disappeared,
1376 attempt to refetch it, as the pid should still be the same. */
1377 inf_set_pid (inf, inf->pid);
1379 if (err == EMACH_RCV_INTERRUPTED)
1380 inf_debug (inf, "interrupted");
1382 error ("Couldn't wait for an event: %s", strerror (err));
1386 mach_msg_header_t hdr;
1387 mach_msg_type_t err_type;
1392 inf_debug (inf, "event: msgid = %d", msg.hdr.msgh_id);
1394 /* Handle what we got. */
1395 if (! notify_server (&msg.hdr, &reply.hdr)
1396 && ! exc_server (&msg.hdr, &reply.hdr)
1397 && ! process_reply_server (&msg.hdr, &reply.hdr)
1398 && ! msg_reply_server (&msg.hdr, &reply.hdr))
1399 /* Whatever it is, it's something strange. */
1400 error ("Got a strange event, msg id = %d.", msg.hdr.msgh_id);
1403 error ("Handling event, msgid = %d: %s",
1404 msg.hdr.msgh_id, strerror (reply.err));
1407 if (inf->pending_execs)
1408 /* We're waiting for the inferior to finish execing. */
1410 struct inf_wait *w = &inf->wait;
1411 enum target_waitkind kind = w->status.kind;
1413 if (kind == TARGET_WAITKIND_SPURIOUS)
1414 /* Since gdb is actually counting the number of times the inferior
1415 stops, expecting one stop per exec, we only return major events
1419 inf_debug (inf, "pending_execs = %d, ignoring minor event",
1420 inf->pending_execs);
1422 else if (kind == TARGET_WAITKIND_STOPPED
1423 && w->status.value.sig == TARGET_SIGNAL_TRAP)
1424 /* Ah hah! A SIGTRAP from the inferior while starting up probably
1425 means we've succesfully completed an exec! */
1427 if (--inf->pending_execs == 0)
1430 #if 0 /* do we need this? */
1431 prune_threads (1); /* Get rid of the old shell threads */
1432 renumber_threads (0); /* Give our threads reasonable names. */
1435 inf_debug (inf, "pending exec completed, pending_execs => %d",
1436 inf->pending_execs);
1438 else if (kind == TARGET_WAITKIND_STOPPED)
1439 /* It's possible that this signal is because of a crashed process
1440 being handled by the hurd crash server; in this case, the process
1441 will have an extra task suspend, which we need to know about.
1442 Since the code in inf_resume that normally checks for this is
1443 disabled while INF->pending_execs, we do the check here instead. */
1444 inf_validate_task_sc (inf);
1447 if (inf->wait.suppress)
1448 /* Some totally spurious event happened that we don't consider
1449 worth returning to gdb. Just keep waiting. */
1451 inf_debug (inf, "suppressing return, rewaiting...");
1456 /* Pass back out our results. */
1457 bcopy (&inf->wait.status, status, sizeof (*status));
1459 thread = inf->wait.thread;
1463 thread = inf_tid_to_thread (inf, tid);
1465 if (!thread || thread->port == MACH_PORT_NULL)
1466 /* TID is dead; try and find a new thread. */
1467 if (inf_update_procs (inf) && inf->threads)
1468 tid = inf->threads->tid; /* The first available thread. */
1470 tid = inferior_pid; /* let wait_for_inferior handle exit case */
1472 if (thread && tid >= 0 && status->kind != TARGET_WAITKIND_SPURIOUS
1473 && inf->pause_sc == 0 && thread->pause_sc == 0)
1474 /* If something actually happened to THREAD, make sure we suspend it. */
1477 inf_update_suspends (inf);
1480 inf_debug (inf, "returning tid = %d, status = %s (%d)", tid,
1481 status->kind == TARGET_WAITKIND_EXITED ? "EXITED"
1482 : status->kind == TARGET_WAITKIND_STOPPED ? "STOPPED"
1483 : status->kind == TARGET_WAITKIND_SIGNALLED ? "SIGNALLED"
1484 : status->kind == TARGET_WAITKIND_LOADED ? "LOADED"
1485 : status->kind == TARGET_WAITKIND_SPURIOUS ? "SPURIOUS"
1487 status->value.integer);
1492 /* The rpc handler called by exc_server. */
1494 S_exception_raise_request (mach_port_t port, mach_port_t reply_port,
1495 thread_t thread_port, task_t task_port,
1496 int exception, int code, int subcode)
1498 struct inf *inf = waiting_inf;
1499 struct proc *thread = inf_port_to_thread (inf, thread_port);
1501 inf_debug (waiting_inf,
1502 "thread = %d, task = %d, exc = %d, code = %d, subcode = %d",
1503 thread_port, task_port, exception, code);
1506 /* We don't know about thread? */
1508 inf_update_procs (inf);
1509 thread = inf_port_to_thread (inf, thread_port);
1511 /* Give up, the generating thread is gone. */
1515 mach_port_deallocate (mach_task_self (), thread_port);
1516 mach_port_deallocate (mach_task_self (), task_port);
1518 if (! thread->aborted)
1519 /* THREAD hasn't been aborted since this exception happened (abortion
1520 clears any exception state), so it must be real. */
1522 /* Store away the details; this will destroy any previous info. */
1523 inf->wait.thread = thread;
1525 inf->wait.status.kind = TARGET_WAITKIND_STOPPED;
1527 if (exception == EXC_BREAKPOINT)
1528 /* GDB likes to get SIGTRAP for breakpoints. */
1530 inf->wait.status.value.sig = TARGET_SIGNAL_TRAP;
1531 mach_port_deallocate (mach_task_self (), reply_port);
1534 /* Record the exception so that we can forward it later. */
1536 if (thread->exc_port == port)
1538 inf_debug (waiting_inf, "Handler is thread exeption port <%d>",
1539 thread->saved_exc_port);
1540 inf->wait.exc.handler = thread->saved_exc_port;
1544 inf_debug (waiting_inf, "Handler is task exeption port <%d>",
1545 inf->task->saved_exc_port);
1546 inf->wait.exc.handler = inf->task->saved_exc_port;
1547 assert (inf->task->exc_port == port);
1549 if (inf->wait.exc.handler != MACH_PORT_NULL)
1550 /* Add a reference to the exception handler. */
1551 mach_port_mod_refs (mach_task_self (),
1552 inf->wait.exc.handler, MACH_PORT_RIGHT_SEND,
1555 inf->wait.exc.exception = exception;
1556 inf->wait.exc.code = code;
1557 inf->wait.exc.subcode = subcode;
1558 inf->wait.exc.reply = reply_port;
1560 /* Exceptions are encoded in the signal space by putting them after
1561 _NSIG; this assumes they're positive (and not extremely large)! */
1562 inf->wait.status.value.sig =
1563 target_signal_from_host (_NSIG + exception);
1567 /* A supppressed exception, which ignore. */
1569 inf->wait.suppress = 1;
1570 mach_port_deallocate (mach_task_self (), reply_port);
1576 /* Fill in INF's wait field after a task has died without giving us more
1577 detailed information. */
1579 inf_task_died_status (struct inf *inf)
1581 warning ("Pid %d died with unknown exit status, using SIGKILL.", inf->pid);
1582 inf->wait.status.kind = TARGET_WAITKIND_SIGNALLED;
1583 inf->wait.status.value.sig = TARGET_SIGNAL_KILL;
1586 /* Notify server routines. The only real one is dead name notification. */
1588 do_mach_notify_dead_name (mach_port_t notify, mach_port_t dead_port)
1590 struct inf *inf = waiting_inf;
1592 inf_debug (waiting_inf, "port = %d", dead_port);
1594 if (inf->task && inf->task->port == dead_port)
1596 proc_debug (inf->task, "is dead");
1597 inf->task->port = MACH_PORT_NULL;
1598 if (proc_wait_pid == inf->pid)
1599 /* We have a wait outstanding on the process, which will return more
1600 detailed information, so delay until we get that. */
1601 inf->wait.suppress = 1;
1603 /* We never waited for the process (maybe it wasn't a child), so just
1604 pretend it got a SIGKILL. */
1605 inf_task_died_status (inf);
1609 struct proc *thread = inf_port_to_thread (inf, dead_port);
1612 proc_debug (thread, "is dead");
1613 thread->port = MACH_PORT_NULL;
1617 mach_port_deallocate (mach_task_self (), dead_port);
1618 inf->threads_up_to_date = 0; /* Just in case */
1626 warning ("illegal rpc: %s", fun);
1631 do_mach_notify_no_senders (mach_port_t notify, mach_port_mscount_t count)
1633 return ill_rpc (__FUNCTION__);
1637 do_mach_notify_port_deleted (mach_port_t notify, mach_port_t name)
1639 return ill_rpc (__FUNCTION__);
1643 do_mach_notify_msg_accepted (mach_port_t notify, mach_port_t name)
1645 return ill_rpc (__FUNCTION__);
1649 do_mach_notify_port_destroyed (mach_port_t notify, mach_port_t name)
1651 return ill_rpc (__FUNCTION__);
1655 do_mach_notify_send_once (mach_port_t notify)
1657 return ill_rpc (__FUNCTION__);
1660 /* Process_reply server routines. We only use process_wait_reply. */
1663 S_proc_wait_reply (mach_port_t reply, error_t err,
1664 int status, int sigcode, rusage_t rusage, pid_t pid)
1666 struct inf *inf = waiting_inf;
1668 inf_debug (inf, "err = %s, pid = %d, status = 0x%x, sigcode = %d",
1669 err ? strerror (err) : "0", pid, status, sigcode);
1671 if (err && proc_wait_pid && (!inf->task || !inf->task->port))
1672 /* Ack. The task has died, but the task-died notification code didn't
1673 tell anyone because it thought a more detailed reply from the
1674 procserver was forthcoming. However, we now learn that won't
1675 happen... So we have to act like the task just died, and this time,
1677 inf_task_died_status (inf);
1679 if (--proc_waits_pending == 0)
1680 /* PROC_WAIT_PID represents the most recent wait. We will always get
1681 replies in order because the proc server is single threaded. */
1684 inf_debug (inf, "waits pending now: %d", proc_waits_pending);
1690 warning ("Can't wait for pid %d: %s", inf->pid, strerror (err));
1693 /* Since we can't see the inferior's signals, don't trap them. */
1694 inf_set_traced (inf, 0);
1697 else if (pid == inf->pid)
1699 store_waitstatus (&inf->wait.status, status);
1700 if (inf->wait.status.kind == TARGET_WAITKIND_STOPPED)
1701 /* The process has sent us a signal, and stopped itself in a sane
1702 state pending our actions. */
1704 inf_debug (inf, "process has stopped itself");
1709 inf->wait.suppress = 1; /* Something odd happened. Ignore. */
1715 S_proc_setmsgport_reply (mach_port_t reply, error_t err,
1716 mach_port_t old_msg_port)
1718 return ill_rpc (__FUNCTION__);
1722 S_proc_getmsgport_reply (mach_port_t reply, error_t err, mach_port_t msg_port)
1724 return ill_rpc (__FUNCTION__);
1727 /* Msg_reply server routines. We only use msg_sig_post_untraced_reply. */
1730 S_msg_sig_post_untraced_reply (mach_port_t reply, error_t err)
1732 struct inf *inf = waiting_inf;
1735 /* EBUSY is what we get when the crash server has grabbed control of the
1736 process and doesn't like what signal we tried to send it. Just act
1737 like the process stopped (using a signal of 0 should mean that the
1738 *next* time the user continues, it will pass signal 0, which the crash
1739 server should like). */
1741 inf->wait.status.kind = TARGET_WAITKIND_STOPPED;
1742 inf->wait.status.value.sig = TARGET_SIGNAL_0;
1745 warning ("Signal delivery failed: %s", strerror (err));
1748 /* We only get this reply when we've posted a signal to a process which we
1749 thought was stopped, and which we expected to continue after the signal.
1750 Given that the signal has failed for some reason, it's reasonable to
1751 assume it's still stopped. */
1754 inf->wait.suppress = 1;
1760 S_msg_sig_post_reply (mach_port_t reply, error_t err)
1762 return ill_rpc (__FUNCTION__);
1765 /* Returns the number of messages queued for the receive right PORT. */
1766 static mach_port_msgcount_t
1767 port_msgs_queued (mach_port_t port)
1769 struct mach_port_status status;
1771 mach_port_get_receive_status (mach_task_self (), port, &status);
1776 return status.mps_msgcount;
1779 /* Resume execution of the inferior process.
1781 If STEP is nonzero, single-step it.
1782 If SIGNAL is nonzero, give it that signal.
1785 -1 true Single step the current thread allowing other threads to run.
1786 -1 false Continue the current thread allowing other threads to run.
1787 X true Single step the given thread, don't allow any others to run.
1788 X false Continue the given thread, do not allow any others to run.
1789 (Where X, of course, is anything except -1)
1791 Note that a resume may not `take' if there are pending exceptions/&c
1792 still unprocessed from the last resume we did (any given resume may result
1793 in multiple events returned by wait).
1796 gnu_resume (int tid, int step, enum target_signal sig)
1798 struct proc *step_thread = 0;
1799 struct inf *inf = current_inferior;
1801 inf_debug (inf, "tid = %d, step = %d, sig = %d", tid, step, sig);
1803 if (sig != TARGET_SIGNAL_0 || inf->stopped)
1804 inf_signal (inf, sig);
1805 else if (inf->wait.exc.reply != MACH_PORT_NULL)
1806 /* We received an exception to which we have chosen not to forward, so
1807 abort the faulting thread, which will perhaps retake it. */
1809 proc_abort (inf->wait.thread, 1);
1810 warning ("Aborting %s with unforwarded exception %s.",
1811 proc_string (inf->wait.thread),
1812 target_signal_to_name (inf->wait.status.value.sig));
1815 if (port_msgs_queued (inf->event_port))
1816 /* If there are still messages in our event queue, don't bother resuming
1817 the process, as we're just going to stop it right away anyway. */
1820 inf_update_procs (inf);
1823 /* Allow all threads to run, except perhaps single-stepping one. */
1825 inf_debug (inf, "running all threads; tid = %d", inferior_pid);
1826 tid = inferior_pid; /* What to step. */
1827 inf_set_threads_resume_sc (inf, 0, 1);
1830 /* Just allow a single thread to run. */
1832 struct proc *thread = inf_tid_to_thread (inf, tid);
1834 error ("Can't run single thread id %d: no such thread!");
1835 inf_debug (inf, "running one thread: %d/%d", inf->pid, thread->tid);
1836 inf_set_threads_resume_sc (inf, thread, 0);
1841 step_thread = inf_tid_to_thread (inf, tid);
1843 warning ("Can't step thread id %d: no such thread.", tid);
1845 inf_debug (inf, "stepping thread: %d/%d", inf->pid, step_thread->tid);
1847 if (step_thread != inf->step_thread)
1848 inf_set_step_thread (inf, step_thread);
1850 inf_debug (inf, "here we go...");
1855 gnu_kill_inferior ()
1857 struct proc *task = current_inferior->task;
1860 proc_debug (task, "terminating...");
1861 task_terminate (task->port);
1862 inf_set_pid (current_inferior, -1);
1864 target_mourn_inferior ();
1867 /* Clean up after the inferior dies. */
1870 gnu_mourn_inferior ()
1872 inf_debug (current_inferior, "rip");
1873 inf_detach (current_inferior);
1874 unpush_target (&gnu_ops);
1875 generic_mourn_inferior ();
1878 /* Fork an inferior process, and start debugging it. */
1880 /* Set INFERIOR_PID to the first thread available in the child, if any. */
1882 inf_pick_first_thread ()
1884 if (current_inferior->task && current_inferior->threads)
1885 /* The first thread. */
1886 return current_inferior->threads->tid;
1888 /* What may be the next thread. */
1889 return next_thread_id;
1895 if (! current_inferior)
1896 current_inferior = make_inf ();
1897 return current_inferior;
1901 gnu_create_inferior (exec_file, allargs, env)
1906 struct inf *inf = cur_inf ();
1910 /* We're in the child; make this process stop as soon as it execs. */
1911 inf_debug (inf, "tracing self");
1912 if (ptrace (PTRACE_TRACEME) != 0)
1913 error ("ptrace (PTRACE_TRACEME) failed!");
1915 int attach_to_child (int pid)
1917 /* Attach to the now stopped child, which is actually a shell... */
1918 inf_debug (inf, "attaching to child: %d", pid);
1920 inf_attach (inf, pid);
1923 push_target (&gnu_ops);
1925 inf->pending_execs = 2;
1928 /* Now let the child run again, knowing that it will stop immediately
1929 because of the ptrace. */
1931 inferior_pid = inf_pick_first_thread ();
1933 startup_inferior (inf->pending_execs);
1935 return inferior_pid;
1938 inf_debug (inf, "creating inferior");
1940 fork_inferior (exec_file, allargs, env, trace_me, attach_to_child, NULL);
1942 inf_update_signal_thread (inf);
1943 inf_set_traced (inf, inf->want_signals);
1945 /* Execing the process will have trashed our exception ports; steal them
1946 back (or make sure they're restored if the user wants that). */
1947 if (inf->want_exceptions)
1948 inf_steal_exc_ports (inf);
1950 inf_restore_exc_ports (inf);
1953 proceed ((CORE_ADDR) -1, 0, 0);
1956 /* Mark our target-struct as eligible for stray "run" and "attach"
1964 #ifdef ATTACH_DETACH
1966 /* Attach to process PID, then initialize for debugging it
1967 and wait for the trace-trap that results from attaching. */
1969 gnu_attach (args, from_tty)
1975 struct inf *inf = cur_inf ();
1978 error_no_arg ("PID to attach");
1982 if (pid == getpid()) /* Trying to masturbate? */
1983 error ("I refuse to debug myself!");
1987 exec_file = (char *) get_exec_file (0);
1990 printf_unfiltered ("Attaching to program `%s', pid %d\n",
1993 printf_unfiltered ("Attaching to pid %d\n", pid);
1995 gdb_flush (gdb_stdout);
1998 inf_debug (inf, "attaching to pid: %d", pid);
2000 inf_attach (inf, pid);
2001 inf_update_procs (inf);
2003 inferior_pid = inf_pick_first_thread ();
2006 push_target (&gnu_ops);
2008 inf_update_signal_thread (inf);
2009 inf_set_traced (inf, inf->want_signals);
2011 /* If the process was stopped before we attached, make it continue the next
2012 time the user does a continue. */
2013 inf_validate_stopped (inf);
2015 #if 0 /* Do we need this? */
2016 renumber_threads (0); /* Give our threads reasonable names. */
2020 /* Take a program previously attached to and detaches it.
2021 The program resumes execution and will no longer stop
2022 on signals, etc. We'd better not have left any breakpoints
2023 in the program or it'll die when it hits one. For this
2024 to work, it may be necessary for the process to have been
2025 previously attached. It *might* work if the program was
2026 started via fork. */
2028 gnu_detach (args, from_tty)
2034 char *exec_file = get_exec_file (0);
2036 printf_unfiltered ("Detaching from program `%s' pid %d\n",
2037 exec_file, current_inferior->pid);
2039 printf_unfiltered ("Detaching from pid %d\n", current_inferior->pid);
2040 gdb_flush (gdb_stdout);
2043 inf_detach (current_inferior);
2047 unpush_target (&gnu_ops); /* Pop out of handling an inferior */
2049 #endif /* ATTACH_DETACH */
2052 gnu_terminal_init_inferior ()
2054 assert (current_inferior);
2055 terminal_init_inferior_with_pgrp (current_inferior->pid);
2058 /* Get ready to modify the registers array. On machines which store
2059 individual registers, this doesn't need to do anything. On machines
2060 which store all the registers in one fell swoop, this makes sure
2061 that registers contains all the registers from the program being
2065 gnu_prepare_to_store ()
2067 #ifdef CHILD_PREPARE_TO_STORE
2068 CHILD_PREPARE_TO_STORE ();
2073 gnu_open (arg, from_tty)
2077 error ("Use the \"run\" command to start a Unix child process.");
2083 error ("to_stop target function not implemented");
2087 gnu_thread_alive (int tid)
2089 inf_update_procs (current_inferior);
2090 return !!inf_tid_to_thread (current_inferior, tid);
2094 * Read inferior task's LEN bytes from ADDR and copy it to MYADDR
2095 * in gdb's address space.
2097 * Return 0 on failure; number of bytes read otherwise.
2100 gnu_read_inferior (task, addr, myaddr, length)
2107 vm_address_t low_address = (vm_address_t) trunc_page (addr);
2108 vm_size_t aligned_length =
2109 (vm_size_t) round_page (addr+length) - low_address;
2113 /* Get memory from inferior with page aligned addresses */
2114 err = vm_read (task, low_address, aligned_length, &copied, ©_count);
2118 err = hurd_safe_copyin (myaddr, (void*)addr - low_address + copied, length);
2121 warning ("Read from inferior faulted: %s", strerror (err));
2125 err = vm_deallocate (mach_task_self (), copied, copy_count);
2127 warning ("gnu_read_inferior vm_deallocate failed: %s", strerror (err));
2132 #define CHK_GOTO_OUT(str,ret) \
2133 do if (ret != KERN_SUCCESS) { errstr = #str; goto out; } while(0)
2135 struct vm_region_list {
2136 struct vm_region_list *next;
2137 vm_prot_t protection;
2142 struct obstack region_obstack;
2145 * Write gdb's LEN bytes from MYADDR and copy it to ADDR
2146 * in inferior task's address space.
2149 gnu_write_inferior (task, addr, myaddr, length)
2156 vm_address_t low_address = (vm_address_t) trunc_page (addr);
2157 vm_size_t aligned_length =
2158 (vm_size_t) round_page (addr+length) - low_address;
2163 char *errstr = "Bug in gnu_write_inferior";
2165 struct vm_region_list *region_element;
2166 struct vm_region_list *region_head = (struct vm_region_list *)NULL;
2168 /* Get memory from inferior with page aligned addresses */
2169 err = vm_read (task,
2174 CHK_GOTO_OUT ("gnu_write_inferior vm_read failed", err);
2178 err = hurd_safe_copyout ((void*)addr - low_address + copied, myaddr, length);
2179 CHK_GOTO_OUT ("Write to inferior faulted", err);
2181 obstack_init (®ion_obstack);
2183 /* Do writes atomically.
2184 * First check for holes and unwritable memory.
2187 vm_size_t remaining_length = aligned_length;
2188 vm_address_t region_address = low_address;
2190 struct vm_region_list *scan;
2192 while(region_address < low_address + aligned_length)
2194 vm_prot_t protection;
2195 vm_prot_t max_protection;
2196 vm_inherit_t inheritance;
2198 mach_port_t object_name;
2200 vm_size_t region_length = remaining_length;
2201 vm_address_t old_address = region_address;
2203 err = vm_region (task,
2212 CHK_GOTO_OUT ("vm_region failed", err);
2214 /* Check for holes in memory */
2215 if (old_address != region_address)
2217 warning ("No memory at 0x%x. Nothing written",
2224 if (!(max_protection & VM_PROT_WRITE))
2226 warning ("Memory at address 0x%x is unwritable. Nothing written",
2233 /* Chain the regions for later use */
2235 (struct vm_region_list *)
2236 obstack_alloc (®ion_obstack, sizeof (struct vm_region_list));
2238 region_element->protection = protection;
2239 region_element->start = region_address;
2240 region_element->length = region_length;
2242 /* Chain the regions along with protections */
2243 region_element->next = region_head;
2244 region_head = region_element;
2246 region_address += region_length;
2247 remaining_length = remaining_length - region_length;
2250 /* If things fail after this, we give up.
2251 * Somebody is messing up inferior_task's mappings.
2254 /* Enable writes to the chained vm regions */
2255 for (scan = region_head; scan; scan = scan->next)
2257 boolean_t protection_changed = FALSE;
2259 if (!(scan->protection & VM_PROT_WRITE))
2261 err = vm_protect (task,
2265 scan->protection | VM_PROT_WRITE);
2266 CHK_GOTO_OUT ("vm_protect: enable write failed", err);
2270 err = vm_write (task,
2274 CHK_GOTO_OUT ("vm_write failed", err);
2276 /* Set up the original region protections, if they were changed */
2277 for (scan = region_head; scan; scan = scan->next)
2279 boolean_t protection_changed = FALSE;
2281 if (!(scan->protection & VM_PROT_WRITE))
2283 err = vm_protect (task,
2288 CHK_GOTO_OUT ("vm_protect: enable write failed", err);
2296 obstack_free (®ion_obstack, 0);
2298 (void) vm_deallocate (mach_task_self (),
2303 if (err != KERN_SUCCESS)
2305 warning ("%s: %s", errstr, mach_error_string (err));
2312 /* Return 0 on failure, number of bytes handled otherwise. */
2314 gnu_xfer_memory (memaddr, myaddr, len, write, target)
2319 struct target_ops *target; /* IGNORED */
2324 ? (current_inferior->task ? current_inferior->task->port : 0)
2327 if (task == MACH_PORT_NULL)
2331 inf_debug (current_inferior, "%s %p[%d] %s %p",
2332 write ? "writing" : "reading", memaddr, len,
2333 write ? "<--" : "-->", myaddr);
2335 return gnu_write_inferior (task, memaddr, myaddr, len);
2337 return gnu_read_inferior (task, memaddr, myaddr, len);
2341 extern void gnu_store_registers (int regno);
2342 extern void gnu_fetch_registers (int regno);
2344 struct target_ops gnu_ops = {
2345 "GNU", /* to_shortname */
2346 "GNU Hurd process", /* to_longname */
2347 "GNU Hurd process", /* to_doc */
2348 gnu_open, /* to_open */
2350 gnu_attach, /* to_attach */
2351 gnu_detach, /* to_detach */
2352 gnu_resume, /* to_resume */
2353 gnu_wait, /* to_wait */
2354 gnu_fetch_registers, /* to_fetch_registers */
2355 gnu_store_registers, /* to_store_registers */
2356 gnu_prepare_to_store, /* to_prepare_to_store */
2357 gnu_xfer_memory, /* to_xfer_memory */
2358 0, /* to_files_info */
2359 memory_insert_breakpoint, /* to_insert_breakpoint */
2360 memory_remove_breakpoint, /* to_remove_breakpoint */
2361 gnu_terminal_init_inferior, /* to_terminal_init */
2362 terminal_inferior, /* to_terminal_inferior */
2363 terminal_ours_for_output, /* to_terminal_ours_for_output */
2364 terminal_ours, /* to_terminal_ours */
2365 child_terminal_info, /* to_terminal_info */
2366 gnu_kill_inferior, /* to_kill */
2368 0, /* to_lookup_symbol */
2370 gnu_create_inferior, /* to_create_inferior */
2371 gnu_mourn_inferior, /* to_mourn_inferior */
2372 gnu_can_run, /* to_can_run */
2373 0, /* to_notice_signals */
2374 gnu_thread_alive, /* to_thread_alive */
2375 gnu_stop, /* to_stop */
2376 process_stratum, /* to_stratum */
2378 1, /* to_has_all_memory */
2379 1, /* to_has_memory */
2380 1, /* to_has_stack */
2381 1, /* to_has_registers */
2382 1, /* to_has_execution */
2384 0, /* sections_end */
2385 OPS_MAGIC /* to_magic */
2388 /* Return printable description of proc. */
2389 char *proc_string (struct proc *proc)
2391 static char tid_str[80];
2392 if (proc_is_task (proc))
2393 sprintf (tid_str, "process %d", proc->inf->pid);
2395 sprintf (tid_str, "thread %d.%d",
2396 proc->inf->pid, pid_to_thread_id (proc->tid));
2401 gnu_target_pid_to_str (int tid)
2403 struct inf *inf = current_inferior;
2404 struct proc *thread = inf_tid_to_thread (inf, tid);
2407 return proc_string (thread);
2410 static char tid_str[80];
2411 sprintf (tid_str, "bogus thread id %d", tid);
2416 /* User task commands. */
2418 struct cmd_list_element *set_task_cmd_list = 0;
2419 struct cmd_list_element *show_task_cmd_list = 0;
2420 /* User thread commands. */
2422 /* Commands with a prefix of `set/show thread'. */
2423 extern struct cmd_list_element *thread_cmd_list;
2424 struct cmd_list_element *set_thread_cmd_list = NULL;
2425 struct cmd_list_element *show_thread_cmd_list = NULL;
2427 /* Commands with a prefix of `set/show thread default'. */
2428 struct cmd_list_element *set_thread_default_cmd_list = NULL;
2429 struct cmd_list_element *show_thread_default_cmd_list = NULL;
2432 set_thread_cmd (char *args, int from_tty)
2434 printf_unfiltered ("\"set thread\" must be followed by the name of a thread
2435 property, or \"default\".\n");
2439 show_thread_cmd (char *args, int from_tty)
2441 printf_unfiltered ("\"show thread\" must be followed by the name of a thread property, or \"default\".\n");
2445 set_thread_default_cmd (char *args, int from_tty)
2447 printf_unfiltered ("\"set thread default\" must be followed by the name of a thread property.\n");
2451 show_thread_default_cmd (char *args, int from_tty)
2453 printf_unfiltered ("\"show thread default\" must be followed by the name of a thread property.\n");
2457 parse_int_arg (char *args, char *cmd_prefix)
2462 int val = strtoul (args, &arg_end, 10);
2463 if (*args && *arg_end == '\0')
2466 error ("Illegal argument for \"%s\" command, should be an integer.", cmd_prefix);
2470 _parse_bool_arg (char *args, char *t_val, char *f_val, char *cmd_prefix)
2472 if (!args || strcmp (args, t_val) == 0)
2474 else if (strcmp (args, f_val) == 0)
2477 error ("Illegal argument for \"%s\" command, should be \"%s\" or \"%s\".",
2478 cmd_prefix, t_val, f_val);
2481 #define parse_bool_arg(args, cmd_prefix) \
2482 _parse_bool_arg (args, "on", "off", cmd_prefix)
2485 check_empty (char *args, char *cmd_prefix)
2488 error ("Garbage after \"%s\" command: `%s'", cmd_prefix, args);
2491 /* Returns the alive thread named by INFERIOR_PID, or signals an error. */
2492 static struct proc *
2495 struct inf *inf = cur_inf ();
2496 struct proc *thread = inf_tid_to_thread (inf, inferior_pid);
2498 error ("No current thread.");
2502 /* Returns the current inferior, but signals an error if it has no task. */
2506 struct inf *inf = cur_inf ();
2508 error ("No current process.");
2513 set_task_pause_cmd (char *args, int from_tty)
2515 struct inf *inf = cur_inf ();
2516 int old_sc = inf->pause_sc;
2518 inf->pause_sc = parse_bool_arg (args, "set task pause");
2520 if (old_sc == 0 && inf->pause_sc != 0)
2521 /* If the task is currently unsuspended, immediately suspend it,
2522 otherwise wait until the next time it gets control. */
2527 show_task_pause_cmd (char *args, int from_tty)
2529 struct inf *inf = cur_inf ();
2530 check_empty (args, "show task pause");
2531 printf_unfiltered ("The inferior task %s suspended while gdb has control.\n",
2533 ? (inf->pause_sc == 0 ? "isn't" : "is")
2534 : (inf->pause_sc == 0 ? "won't be" : "will be"));
2538 set_task_detach_sc_cmd (char *args, int from_tty)
2540 cur_inf ()->detach_sc = parse_int_arg (args, "set task detach-suspend-count");
2544 show_task_detach_sc_cmd (char *args, int from_tty)
2546 check_empty (args, "show task detach-suspend-count");
2547 printf_unfiltered ("The inferior task will be left with a suspend count of %d when detaching.\n",
2548 cur_inf ()->detach_sc);
2552 set_thread_default_pause_cmd (char *args, int from_tty)
2554 struct inf *inf = cur_inf ();
2555 inf->default_thread_pause_sc =
2556 parse_bool_arg (args, "set thread default pause") ? 0 : 1;
2560 show_thread_default_pause_cmd (char *args, int from_tty)
2562 struct inf *inf = cur_inf ();
2563 int sc = inf->default_thread_pause_sc;
2564 check_empty (args, "show thread default pause");
2565 printf_unfiltered ("New threads %s suspended while gdb has control%s.\n",
2566 sc ? "are" : "aren't",
2567 !sc && inf->pause_sc ? " (but the task is)" : "");
2571 set_thread_default_run_cmd (char *args, int from_tty)
2573 struct inf *inf = cur_inf ();
2574 inf->default_thread_run_sc =
2575 parse_bool_arg (args, "set thread default run") ? 0 : 1;
2579 show_thread_default_run_cmd (char *args, int from_tty)
2581 struct inf *inf = cur_inf ();
2582 check_empty (args, "show thread default run");
2583 printf_unfiltered ("New threads %s allowed to run.\n",
2584 inf->default_thread_run_sc == 0 ? "are" : "aren't");
2588 set_thread_default_detach_sc_cmd (char *args, int from_tty)
2590 cur_inf ()->default_thread_detach_sc =
2591 parse_int_arg (args, "set thread default detach-suspend-count");
2595 show_thread_default_detach_sc_cmd (char *args, int from_tty)
2597 check_empty (args, "show thread default detach-suspend-count");
2598 printf_unfiltered ("New threads will get a detach-suspend-count of %d.\n",
2599 cur_inf ()->default_thread_detach_sc);
2602 /* Steal a send right called NAME in the inferior task, and make it PROC's
2603 saved exception port. */
2605 steal_exc_port (struct proc *proc, mach_port_t name)
2609 mach_msg_type_name_t port_type;
2611 if (!proc || !proc->inf->task)
2612 error ("No inferior task.");
2614 err = mach_port_extract_right (proc->inf->task->port,
2615 name, MACH_MSG_TYPE_COPY_SEND,
2618 error ("Couldn't extract send right %d from inferior: %s",
2619 name, strerror (err));
2621 if (proc->saved_exc_port)
2622 /* Get rid of our reference to the old one. */
2623 mach_port_deallocate (mach_task_self (), proc->saved_exc_port);
2625 proc->saved_exc_port = port;
2627 if (! proc->exc_port)
2628 /* If PROC is a thread, we may not have set its exception port before.
2629 We can't use proc_steal_exc_port because it also sets saved_exc_port. */
2631 proc->exc_port = proc->inf->event_port;
2632 err = proc_set_exception_port (proc, proc->exc_port);
2633 error ("Can't set exception port for %s: %s",
2634 proc_string (proc), strerror (err));
2639 set_task_exc_port_cmd (char *args, int from_tty)
2641 struct inf *inf = cur_inf ();
2643 error ("No argument to \"set task exception-port\" command.");
2644 steal_exc_port (inf->task, parse_and_eval_address (args));
2648 set_stopped_cmd (char *args, int from_tty)
2650 cur_inf ()->stopped = _parse_bool_arg (args, "yes", "no", "set stopped");
2654 show_stopped_cmd (char *args, int from_tty)
2656 struct inf *inf = active_inf ();
2657 check_empty (args, "show stopped");
2658 printf_unfiltered ("The inferior process %s stopped.\n",
2659 inf->stopped ? "is" : "isn't");
2663 set_sig_thread_cmd (char *args, int from_tty)
2666 struct inf *inf = cur_inf ();
2668 if (!args || (! isdigit (*args) && strcmp (args, "none") != 0))
2669 error ("Illegal argument to \"set signal-thread\" command.\n"
2670 "Should be an integer thread ID, or `none'.");
2672 if (strcmp (args, "none") == 0)
2673 inf->signal_thread = 0;
2676 int tid = thread_id_to_pid (atoi (args));
2678 error ("Thread ID %s not known. Use the \"info threads\" command to\n"
2679 "see the IDs of currently known threads.", args);
2680 inf->signal_thread = inf_tid_to_thread (inf, tid);
2685 show_sig_thread_cmd (char *args, int from_tty)
2687 struct inf *inf = active_inf ();
2688 check_empty (args, "show signal-thread");
2689 if (inf->signal_thread)
2690 printf_unfiltered ("The signal thread is %s.\n",
2691 proc_string (inf->signal_thread));
2693 printf_unfiltered ("There is no signal thread.\n");
2697 set_signals_cmd (char *args, int from_tty)
2700 struct inf *inf = cur_inf ();
2702 inf->want_signals = parse_bool_arg (args, "set signals");
2704 if (inf->task && inf->want_signals != inf->traced)
2705 /* Make this take effect immediately in a running process. */
2706 inf_set_traced (inf, inf->want_signals);
2710 show_signals_cmd (char *args, int from_tty)
2712 struct inf *inf = cur_inf ();
2713 check_empty (args, "show signals");
2714 printf_unfiltered ("The inferior process's signals %s intercepted.\n",
2716 ? (inf->traced ? "are" : "aren't")
2717 : (inf->want_signals ? "will be" : "won't be"));
2721 set_exceptions_cmd (char *args, int from_tty)
2723 struct inf *inf = cur_inf ();
2724 int val = parse_bool_arg (args, "set exceptions");
2726 if (inf->task && inf->want_exceptions != val)
2727 /* Make this take effect immediately in a running process. */
2730 inf->want_exceptions = val;
2734 show_exceptions_cmd (char *args, int from_tty)
2736 struct inf *inf = cur_inf ();
2737 check_empty (args, "show exceptions");
2738 printf_unfiltered ("Exceptions in the inferior %s trapped.\n",
2740 ? (inf->want_exceptions ? "are" : "aren't")
2741 : (inf->want_exceptions ? "will be" : "won't be"));
2745 set_task_cmd (char *args, int from_tty)
2747 printf_unfiltered ("\"set task\" must be followed by the name of a task property.\n");
2751 show_task_cmd (char *args, int from_tty)
2753 struct inf *inf = cur_inf ();
2755 check_empty (args, "show task");
2757 show_signals_cmd (0, from_tty);
2758 show_exceptions_cmd (0, from_tty);
2759 show_task_pause_cmd (0, from_tty);
2761 if (inf->pause_sc == 0)
2762 show_thread_default_pause_cmd (0, from_tty);
2763 show_thread_default_run_cmd (0, from_tty);
2767 show_stopped_cmd (0, from_tty);
2768 show_sig_thread_cmd (0, from_tty);
2771 if (inf->detach_sc != 0)
2772 show_task_detach_sc_cmd (0, from_tty);
2773 if (inf->default_thread_detach_sc != 0)
2774 show_thread_default_detach_sc_cmd (0, from_tty);
2778 set_noninvasive_cmd (char *args, int from_tty)
2780 /* Invert the sense of the arg for each component. */
2781 char *inv_args = parse_bool_arg (args, "set noninvasive") ? "off" : "on";
2783 set_task_pause_cmd (inv_args, from_tty);
2784 set_signals_cmd (inv_args, from_tty);
2785 set_exceptions_cmd (inv_args, from_tty);
2789 info_port_rights (char *args, mach_port_type_t only)
2791 struct inf *inf = active_inf ();
2792 value_ptr vmark = value_mark ();
2795 /* Explicit list of port rights. */
2799 value_ptr val = parse_to_comma_and_eval (&args);
2800 long right = value_as_long (val);
2802 print_port_info (right, 0, inf->task->port, PORTINFO_DETAILS,
2805 error ("%ld: %s.", right, strerror (err));
2809 /* Print all of them. */
2812 print_task_ports_info (inf->task->port, only, PORTINFO_DETAILS,
2815 error ("%s.", strerror (err));
2818 value_free_to_mark (vmark);
2822 info_send_rights_cmd (char *args, int from_tty)
2824 info_port_rights (args, MACH_PORT_TYPE_SEND);
2827 info_recv_rights_cmd (char *args, int from_tty)
2829 info_port_rights (args, MACH_PORT_TYPE_RECEIVE);
2832 info_port_sets_cmd (char *args, int from_tty)
2834 info_port_rights (args, MACH_PORT_TYPE_PORT_SET);
2837 info_dead_names_cmd (char *args, int from_tty)
2839 info_port_rights (args, MACH_PORT_TYPE_DEAD_NAME);
2842 info_port_rights_cmd (char *args, int from_tty)
2844 info_port_rights (args, ~0);
2847 static void add_task_commands ()
2849 add_cmd ("pause", class_run, set_thread_default_pause_cmd,
2850 "Set whether the new threads are suspended while gdb has control.\n"
2851 "This property normally has no effect because the whole task is\n"
2852 "suspended, however, that may be disabled with \"set task pause off\".\n"
2853 "The default value is \"off\".",
2854 &set_thread_default_cmd_list);
2855 add_cmd ("pause", no_class, show_thread_default_pause_cmd,
2856 "Show whether new threads are suspended while gdb has control.",
2857 &show_thread_default_cmd_list);
2858 add_cmd ("run", class_run, set_thread_default_run_cmd,
2859 "Set whether new threads are allowed to run (once gdb has noticed them).",
2860 &set_thread_default_cmd_list);
2861 add_cmd ("run", no_class, show_thread_default_run_cmd,
2862 "Show whether new threads are allowed to run (once gdb has noticed
2864 &show_thread_default_cmd_list);
2865 add_cmd ("detach-suspend-count", class_run, set_thread_default_detach_sc_cmd,
2866 "Set the default detach-suspend-count value for new threads.",
2867 &set_thread_default_cmd_list);
2868 add_cmd ("detach-suspend-count", no_class, show_thread_default_detach_sc_cmd,
2869 "Show the default detach-suspend-count value for new threads.",
2870 &show_thread_default_cmd_list);
2872 add_cmd ("signals", class_run, set_signals_cmd,
2873 "Set whether the inferior process's signals will be intercepted.\n"
2874 "Mach exceptions (such as breakpoint traps) are not affected.",
2876 add_alias_cmd ("sigs", "signals", class_run, 1, &setlist);
2877 add_cmd ("signals", no_class, show_signals_cmd,
2878 "Show whether the inferior process's signals will be intercepted.",
2880 add_alias_cmd ("sigs", "signals", no_class, 1, &showlist);
2882 add_cmd ("signal-thread", class_run, set_sig_thread_cmd,
2883 "Set the thread that gdb thinks is the libc signal thread.\n"
2884 "This thread is run when delivering a signal to a non-stopped process.",
2886 add_alias_cmd ("sigthread", "signal-thread", class_run, 1, &setlist);
2887 add_cmd ("signal-thread", no_class, show_sig_thread_cmd,
2888 "Set the thread that gdb thinks is the libc signal thread.",
2890 add_alias_cmd ("sigthread", "signal-thread", no_class, 1, &showlist);
2892 add_cmd ("stopped", class_run, set_stopped_cmd,
2893 "Set whether gdb thinks the inferior process is stopped as with SIGSTOP.\n"
2894 "Stopped process will be continued by sending them a signal.",
2896 add_cmd ("stopped", no_class, show_signals_cmd,
2897 "Show whether gdb thinks the inferior process is stopped as with SIGSTOP.",
2900 add_cmd ("exceptions", class_run, set_exceptions_cmd,
2901 "Set whether exceptions in the inferior process will be trapped.\n"
2902 "When exceptions are turned off, neither breakpoints nor single-stepping\n"
2905 /* Allow `set exc' despite conflict with `set exception-port'. */
2906 add_alias_cmd ("exc", "exceptions", class_run, 1, &setlist);
2907 add_cmd ("exceptions", no_class, show_exceptions_cmd,
2908 "Show whether exceptions in the inferior process will be trapped.",
2911 add_prefix_cmd ("task", no_class, set_task_cmd,
2912 "Command prefix for setting task attributes.",
2913 &set_task_cmd_list, "set task ", 0, &setlist);
2914 add_prefix_cmd ("task", no_class, show_task_cmd,
2915 "Command prefix for showing task attributes.",
2916 &show_task_cmd_list, "show task ", 0, &showlist);
2918 add_cmd ("pause", class_run, set_task_pause_cmd,
2919 "Set whether the task is suspended while gdb has control.\n"
2920 "A value of \"on\" takes effect immediately, otherwise nothing\n"
2921 "happens until the next time the program is continued.\n"
2922 "When setting this to \"off\", \"set thread default pause on\"\n"
2923 "can be used to pause individual threads by default instead.",
2924 &set_task_cmd_list);
2925 add_cmd ("pause", no_class, show_task_pause_cmd,
2926 "Show whether the task is suspended while gdb has control.",
2927 &show_task_cmd_list);
2928 add_cmd ("detach-suspend-count", class_run, set_task_detach_sc_cmd,
2929 "Set the suspend count will leave on the thread when detaching.",
2930 &set_task_cmd_list);
2931 add_cmd ("detach-suspend-count", no_class, show_task_detach_sc_cmd,
2932 "Show the suspend count will leave on the thread when detaching.",
2933 &show_task_cmd_list);
2935 add_cmd ("exception-port", no_class, set_task_exc_port_cmd,
2936 "Set the task exception port to which we forward exceptions.\n"
2937 "The argument should be the value of the send right in the task.",
2938 &set_task_cmd_list);
2939 add_alias_cmd ("excp", "exception-port", no_class, 1, &set_task_cmd_list);
2940 add_alias_cmd ("exc-port", "exception-port", no_class, 1, &set_task_cmd_list);
2942 /* A convenient way of turning on all options require to noninvasively
2943 debug running tasks. */
2944 add_cmd ("noninvasive", no_class, set_noninvasive_cmd,
2945 "Set task options so that we interfere as little as possible.\n"
2946 "This is the same as setting `task pause', `exceptions', and"
2947 "`signals' to the opposite value.",
2950 /* Commands to show information about the task's ports. */
2951 add_cmd ("send-rights", class_info, info_send_rights_cmd,
2952 "Show information about the task's send rights",
2954 add_cmd ("receive-rights", class_info, info_recv_rights_cmd,
2955 "Show information about the task's receive rights",
2957 add_cmd ("port-rights", class_info, info_send_rights_cmd,
2958 "Show information about the task's port rights",
2960 add_cmd ("port-sets", class_info, info_port_sets_cmd,
2961 "Show information about the task's port sets",
2963 add_cmd ("dead-names", class_info, info_dead_names_cmd,
2964 "Show information about the task's dead names",
2966 add_info_alias ("ports", "port-rights", 1);
2967 add_info_alias ("port", "port-rights", 1);
2968 add_info_alias ("psets", "port-sets", 1);
2973 set_thread_pause_cmd (char *args, int from_tty)
2975 struct proc *thread = cur_thread ();
2976 int old_sc = thread->pause_sc;
2977 thread->pause_sc = parse_bool_arg (args, "set thread pause");
2978 if (old_sc == 0 && thread->pause_sc != 0 && thread->inf->pause_sc == 0)
2979 /* If the task is currently unsuspended, immediately suspend it,
2980 otherwise wait until the next time it gets control. */
2981 inf_suspend (thread->inf);
2985 show_thread_pause_cmd (char *args, int from_tty)
2987 struct proc *thread = cur_thread ();
2988 int sc = thread->pause_sc;
2989 check_empty (args, "show task pause");
2990 printf_unfiltered ("Thread %s %s suspended while gdb has control%s.\n",
2991 proc_string (thread),
2992 sc ? "is" : "isn't",
2993 !sc && thread->inf->pause_sc ? " (but the task is)" : "");
2997 set_thread_run_cmd (char *args, int from_tty)
2999 struct proc *thread = cur_thread ();
3000 thread->run_sc = parse_bool_arg (args, "set thread run") ? 0 : 1;
3004 show_thread_run_cmd (char *args, int from_tty)
3006 struct proc *thread = cur_thread ();
3007 check_empty (args, "show thread run");
3008 printf_unfiltered ("Thread %s %s allowed to run.",
3009 proc_string (thread),
3010 thread->run_sc == 0 ? "is" : "isn't");
3014 set_thread_detach_sc_cmd (char *args, int from_tty)
3016 cur_thread ()->detach_sc = parse_int_arg (args, "set thread detach-suspend-count");
3020 show_thread_detach_sc_cmd (char *args, int from_tty)
3022 struct proc *thread = cur_thread ();
3023 check_empty (args, "show thread detach-suspend-count");
3024 printf_unfiltered ("Thread %s will be left with a suspend count of %d when detaching.\n",
3025 proc_string (thread),
3030 set_thread_exc_port_cmd (char *args, int from_tty)
3032 struct proc *thread = cur_thread ();
3034 error ("No argument to \"set thread exception-port\" command.");
3035 steal_exc_port (thread, parse_and_eval_address (args));
3040 show_thread_cmd (char *args, int from_tty)
3042 struct proc *thread = cur_thread ();
3043 check_empty (args, "show thread");
3044 show_thread_run_cmd (0, from_tty);
3045 show_thread_pause_cmd (0, from_tty);
3046 if (thread->detach_sc != 0)
3047 show_thread_detach_sc_cmd (0, from_tty);
3052 thread_takeover_sc_cmd (char *args, int from_tty)
3054 struct proc *thread = cur_thread ();
3055 thread_basic_info_data_t _info;
3056 thread_basic_info_t info = &_info;
3057 mach_msg_type_number_t info_len = THREAD_BASIC_INFO_COUNT;
3059 thread_info (thread->port, THREAD_BASIC_INFO, (int *)&info, &info_len);
3061 error ("%s.", strerror (err));
3062 thread->sc = info->suspend_count;
3064 printf_unfiltered ("Suspend count was %d.\n", thread->sc);
3066 vm_deallocate (mach_task_self (), (vm_address_t)info, info_len * sizeof (int));
3069 add_thread_commands ()
3071 add_prefix_cmd ("thread", no_class, set_thread_cmd,
3072 "Command prefix for setting thread properties.",
3073 &set_thread_cmd_list, "set thread ", 0, &setlist);
3074 add_prefix_cmd ("default", no_class, show_thread_cmd,
3075 "Command prefix for setting default thread properties.",
3076 &set_thread_default_cmd_list, "set thread default ", 0,
3077 &set_thread_cmd_list);
3078 add_prefix_cmd ("thread", no_class, set_thread_default_cmd,
3079 "Command prefix for showing thread properties.",
3080 &show_thread_cmd_list, "show thread ", 0, &showlist);
3081 add_prefix_cmd ("default", no_class, show_thread_default_cmd,
3082 "Command prefix for showing default thread properties.",
3083 &show_thread_default_cmd_list, "show thread default ", 0,
3084 &show_thread_cmd_list);
3086 add_cmd ("pause", class_run, set_thread_pause_cmd,
3087 "Set whether the current thread is suspended while gdb has control.\n"
3088 "A value of \"on\" takes effect immediately, otherwise nothing\n"
3089 "happens until the next time the program is continued. This\n"
3090 "property normally has no effect because the whole task is suspended,\n"
3091 "however, that may be disabled with \"set task pause off\".\n"
3092 "The default value is \"off\".",
3093 &set_thread_cmd_list);
3094 add_cmd ("pause", no_class, show_thread_pause_cmd,
3095 "Show whether the current thread is suspended while gdb has control.",
3096 &show_thread_cmd_list);
3098 add_cmd ("run", class_run, set_thread_run_cmd,
3099 "Set whether the current thread is allowed to run.",
3100 &set_thread_cmd_list);
3101 add_cmd ("run", no_class, show_thread_run_cmd,
3102 "Show whether the current thread is allowed to run.",
3103 &show_thread_cmd_list);
3105 add_cmd ("detach-suspend-count", class_run, set_thread_detach_sc_cmd,
3106 "Set the suspend count will leave on the thread when detaching.\n"
3107 "Note that this is relative to suspend count when gdb noticed the thread;\n"
3108 "use the `thread takeover-suspend-count' to force it to an absolute value.",
3109 &set_thread_cmd_list);
3110 add_cmd ("detach-suspend-count", no_class, show_thread_detach_sc_cmd,
3111 "Show the suspend count will leave on the thread when detaching."
3112 "Note that this is relative to suspend count when gdb noticed the thread;\n"
3113 "use the `thread takeover-suspend-count' to force it to an absolute value.",
3114 &show_thread_cmd_list);
3116 add_cmd ("exception-port", no_class, set_thread_exc_port_cmd,
3117 "Set the exception port to which we forward exceptions for the\n"
3118 "current thread, overriding the task exception port.\n"
3119 "The argument should be the value of the send right in the task.",
3120 &set_thread_cmd_list);
3121 add_alias_cmd ("excp", "exception-port", no_class, 1, &set_thread_cmd_list);
3122 add_alias_cmd ("exc-port", "exception-port", no_class, 1, &set_thread_cmd_list);
3124 add_cmd ("takeover-suspend-count", no_class, thread_takeover_sc_cmd,
3125 "Force the threads absolute suspend-count to be gdb's.\n"
3126 "Prior to giving this command, gdb's thread suspend-counts are relative to\n"
3127 "the thread's initial suspend-count when gdb notices the threads.",
3132 _initialize_gnu_nat ()
3134 proc_server = getproc ();
3136 add_target (&gnu_ops);
3138 add_task_commands ();
3139 add_thread_commands ();
3141 #if MAINTENANCE_CMDS
3142 add_set_cmd ("gnu-debug", class_maintenance,
3143 var_boolean, (char *)&gnu_debug_flag,
3144 "Set debugging output for the gnu backend.", &maintenancelist);
3148 #ifdef FLUSH_INFERIOR_CACHE
3150 /* When over-writing code on some machines the I-Cache must be flushed
3151 explicitly, because it is not kept coherent by the lazy hardware.
3152 This definitely includes breakpoints, for instance, or else we
3153 end up looping in mysterious Bpt traps */
3156 flush_inferior_icache(pc, amount)
3159 vm_machine_attribute_val_t flush = MATTR_VAL_ICACHE_FLUSH;
3162 ret = vm_machine_attribute (current_inferior->task->port,
3167 if (ret != KERN_SUCCESS)
3168 warning ("Error flushing inferior's cache : %s", strerror (ret));
3170 #endif FLUSH_INFERIOR_CACHE