1 /* Target-struct-independent code to start (run) and stop an inferior
4 Copyright 1986, 1987, 1988, 1989, 1990, 1991, 1992, 1993, 1994,
5 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002 Free Software
8 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,
23 Boston, MA 02111-1307, USA. */
26 #include "gdb_string.h"
31 #include "breakpoint.h"
35 #include "cli/cli-script.h"
37 #include "gdbthread.h"
46 /* Prototypes for local functions */
48 static void signals_info (char *, int);
50 static void handle_command (char *, int);
52 static void sig_print_info (enum target_signal);
54 static void sig_print_header (void);
56 static void resume_cleanups (void *);
58 static int hook_stop_stub (void *);
60 static void delete_breakpoint_current_contents (void *);
62 static void set_follow_fork_mode_command (char *arg, int from_tty,
63 struct cmd_list_element * c);
65 static struct inferior_status *xmalloc_inferior_status (void);
67 static void free_inferior_status (struct inferior_status *);
69 static int restore_selected_frame (void *);
71 static void build_infrun (void);
73 static void follow_inferior_fork (int parent_pid, int child_pid,
74 int has_forked, int has_vforked);
76 static void follow_fork (int parent_pid, int child_pid);
78 static void follow_vfork (int parent_pid, int child_pid);
80 static void set_schedlock_func (char *args, int from_tty,
81 struct cmd_list_element * c);
83 struct execution_control_state;
85 static int currently_stepping (struct execution_control_state *ecs);
87 static void xdb_handle_command (char *args, int from_tty);
89 void _initialize_infrun (void);
91 int inferior_ignoring_startup_exec_events = 0;
92 int inferior_ignoring_leading_exec_events = 0;
94 /* When set, stop the 'step' command if we enter a function which has
95 no line number information. The normal behavior is that we step
96 over such function. */
97 int step_stop_if_no_debug = 0;
99 /* In asynchronous mode, but simulating synchronous execution. */
101 int sync_execution = 0;
103 /* wait_for_inferior and normal_stop use this to notify the user
104 when the inferior stopped in a different thread than it had been
107 static ptid_t previous_inferior_ptid;
109 /* This is true for configurations that may follow through execl() and
110 similar functions. At present this is only true for HP-UX native. */
112 #ifndef MAY_FOLLOW_EXEC
113 #define MAY_FOLLOW_EXEC (0)
116 static int may_follow_exec = MAY_FOLLOW_EXEC;
118 /* Dynamic function trampolines are similar to solib trampolines in that they
119 are between the caller and the callee. The difference is that when you
120 enter a dynamic trampoline, you can't determine the callee's address. Some
121 (usually complex) code needs to run in the dynamic trampoline to figure out
122 the callee's address. This macro is usually called twice. First, when we
123 enter the trampoline (looks like a normal function call at that point). It
124 should return the PC of a point within the trampoline where the callee's
125 address is known. Second, when we hit the breakpoint, this routine returns
126 the callee's address. At that point, things proceed as per a step resume
129 #ifndef DYNAMIC_TRAMPOLINE_NEXTPC
130 #define DYNAMIC_TRAMPOLINE_NEXTPC(pc) 0
133 /* If the program uses ELF-style shared libraries, then calls to
134 functions in shared libraries go through stubs, which live in a
135 table called the PLT (Procedure Linkage Table). The first time the
136 function is called, the stub sends control to the dynamic linker,
137 which looks up the function's real address, patches the stub so
138 that future calls will go directly to the function, and then passes
139 control to the function.
141 If we are stepping at the source level, we don't want to see any of
142 this --- we just want to skip over the stub and the dynamic linker.
143 The simple approach is to single-step until control leaves the
146 However, on some systems (e.g., Red Hat's 5.2 distribution) the
147 dynamic linker calls functions in the shared C library, so you
148 can't tell from the PC alone whether the dynamic linker is still
149 running. In this case, we use a step-resume breakpoint to get us
150 past the dynamic linker, as if we were using "next" to step over a
153 IN_SOLIB_DYNSYM_RESOLVE_CODE says whether we're in the dynamic
154 linker code or not. Normally, this means we single-step. However,
155 if SKIP_SOLIB_RESOLVER then returns non-zero, then its value is an
156 address where we can place a step-resume breakpoint to get past the
157 linker's symbol resolution function.
159 IN_SOLIB_DYNSYM_RESOLVE_CODE can generally be implemented in a
160 pretty portable way, by comparing the PC against the address ranges
161 of the dynamic linker's sections.
163 SKIP_SOLIB_RESOLVER is generally going to be system-specific, since
164 it depends on internal details of the dynamic linker. It's usually
165 not too hard to figure out where to put a breakpoint, but it
166 certainly isn't portable. SKIP_SOLIB_RESOLVER should do plenty of
167 sanity checking. If it can't figure things out, returning zero and
168 getting the (possibly confusing) stepping behavior is better than
169 signalling an error, which will obscure the change in the
172 #ifndef IN_SOLIB_DYNSYM_RESOLVE_CODE
173 #define IN_SOLIB_DYNSYM_RESOLVE_CODE(pc) 0
176 #ifndef SKIP_SOLIB_RESOLVER
177 #define SKIP_SOLIB_RESOLVER(pc) 0
180 /* In some shared library schemes, the return path from a shared library
181 call may need to go through a trampoline too. */
183 #ifndef IN_SOLIB_RETURN_TRAMPOLINE
184 #define IN_SOLIB_RETURN_TRAMPOLINE(pc,name) 0
187 /* This function returns TRUE if pc is the address of an instruction
188 that lies within the dynamic linker (such as the event hook, or the
191 This function must be used only when a dynamic linker event has
192 been caught, and the inferior is being stepped out of the hook, or
193 undefined results are guaranteed. */
195 #ifndef SOLIB_IN_DYNAMIC_LINKER
196 #define SOLIB_IN_DYNAMIC_LINKER(pid,pc) 0
199 /* On MIPS16, a function that returns a floating point value may call
200 a library helper function to copy the return value to a floating point
201 register. The IGNORE_HELPER_CALL macro returns non-zero if we
202 should ignore (i.e. step over) this function call. */
203 #ifndef IGNORE_HELPER_CALL
204 #define IGNORE_HELPER_CALL(pc) 0
207 /* On some systems, the PC may be left pointing at an instruction that won't
208 actually be executed. This is usually indicated by a bit in the PSW. If
209 we find ourselves in such a state, then we step the target beyond the
210 nullified instruction before returning control to the user so as to avoid
213 #ifndef INSTRUCTION_NULLIFIED
214 #define INSTRUCTION_NULLIFIED 0
217 /* We can't step off a permanent breakpoint in the ordinary way, because we
218 can't remove it. Instead, we have to advance the PC to the next
219 instruction. This macro should expand to a pointer to a function that
220 does that, or zero if we have no such function. If we don't have a
221 definition for it, we have to report an error. */
222 #ifndef SKIP_PERMANENT_BREAKPOINT
223 #define SKIP_PERMANENT_BREAKPOINT (default_skip_permanent_breakpoint)
225 default_skip_permanent_breakpoint (void)
228 The program is stopped at a permanent breakpoint, but GDB does not know\n\
229 how to step past a permanent breakpoint on this architecture. Try using\n\
230 a command like `return' or `jump' to continue execution.");
235 /* Convert the #defines into values. This is temporary until wfi control
236 flow is completely sorted out. */
238 #ifndef HAVE_STEPPABLE_WATCHPOINT
239 #define HAVE_STEPPABLE_WATCHPOINT 0
241 #undef HAVE_STEPPABLE_WATCHPOINT
242 #define HAVE_STEPPABLE_WATCHPOINT 1
245 #ifndef HAVE_NONSTEPPABLE_WATCHPOINT
246 #define HAVE_NONSTEPPABLE_WATCHPOINT 0
248 #undef HAVE_NONSTEPPABLE_WATCHPOINT
249 #define HAVE_NONSTEPPABLE_WATCHPOINT 1
252 #ifndef HAVE_CONTINUABLE_WATCHPOINT
253 #define HAVE_CONTINUABLE_WATCHPOINT 0
255 #undef HAVE_CONTINUABLE_WATCHPOINT
256 #define HAVE_CONTINUABLE_WATCHPOINT 1
259 #ifndef CANNOT_STEP_HW_WATCHPOINTS
260 #define CANNOT_STEP_HW_WATCHPOINTS 0
262 #undef CANNOT_STEP_HW_WATCHPOINTS
263 #define CANNOT_STEP_HW_WATCHPOINTS 1
266 /* Tables of how to react to signals; the user sets them. */
268 static unsigned char *signal_stop;
269 static unsigned char *signal_print;
270 static unsigned char *signal_program;
272 #define SET_SIGS(nsigs,sigs,flags) \
274 int signum = (nsigs); \
275 while (signum-- > 0) \
276 if ((sigs)[signum]) \
277 (flags)[signum] = 1; \
280 #define UNSET_SIGS(nsigs,sigs,flags) \
282 int signum = (nsigs); \
283 while (signum-- > 0) \
284 if ((sigs)[signum]) \
285 (flags)[signum] = 0; \
288 /* Value to pass to target_resume() to cause all threads to resume */
290 #define RESUME_ALL (pid_to_ptid (-1))
292 /* Command list pointer for the "stop" placeholder. */
294 static struct cmd_list_element *stop_command;
296 /* Nonzero if breakpoints are now inserted in the inferior. */
298 static int breakpoints_inserted;
300 /* Function inferior was in as of last step command. */
302 static struct symbol *step_start_function;
304 /* Nonzero if we are expecting a trace trap and should proceed from it. */
306 static int trap_expected;
309 /* Nonzero if we want to give control to the user when we're notified
310 of shared library events by the dynamic linker. */
311 static int stop_on_solib_events;
315 /* Nonzero if the next time we try to continue the inferior, it will
316 step one instruction and generate a spurious trace trap.
317 This is used to compensate for a bug in HP-UX. */
319 static int trap_expected_after_continue;
322 /* Nonzero means expecting a trace trap
323 and should stop the inferior and return silently when it happens. */
327 /* Nonzero means expecting a trap and caller will handle it themselves.
328 It is used after attach, due to attaching to a process;
329 when running in the shell before the child program has been exec'd;
330 and when running some kinds of remote stuff (FIXME?). */
332 int stop_soon_quietly;
334 /* Nonzero if proceed is being used for a "finish" command or a similar
335 situation when stop_registers should be saved. */
337 int proceed_to_finish;
339 /* Save register contents here when about to pop a stack dummy frame,
340 if-and-only-if proceed_to_finish is set.
341 Thus this contains the return value from the called function (assuming
342 values are returned in a register). */
344 char *stop_registers;
346 /* Nonzero if program stopped due to error trying to insert breakpoints. */
348 static int breakpoints_failed;
350 /* Nonzero after stop if current stack frame should be printed. */
352 static int stop_print_frame;
354 static struct breakpoint *step_resume_breakpoint = NULL;
355 static struct breakpoint *through_sigtramp_breakpoint = NULL;
357 /* On some platforms (e.g., HP-UX), hardware watchpoints have bad
358 interactions with an inferior that is running a kernel function
359 (aka, a system call or "syscall"). wait_for_inferior therefore
360 may have a need to know when the inferior is in a syscall. This
361 is a count of the number of inferior threads which are known to
362 currently be running in a syscall. */
363 static int number_of_threads_in_syscalls;
365 /* This is a cached copy of the pid/waitstatus of the last event
366 returned by target_wait()/target_wait_hook(). This information is
367 returned by get_last_target_status(). */
368 static ptid_t target_last_wait_ptid;
369 static struct target_waitstatus target_last_waitstatus;
371 /* This is used to remember when a fork, vfork or exec event
372 was caught by a catchpoint, and thus the event is to be
373 followed at the next resume of the inferior, and not
377 enum target_waitkind kind;
387 char *execd_pathname;
391 /* Some platforms don't allow us to do anything meaningful with a
392 vforked child until it has exec'd. Vforked processes on such
393 platforms can only be followed after they've exec'd.
395 When this is set to 0, a vfork can be immediately followed,
396 and an exec can be followed merely as an exec. When this is
397 set to 1, a vfork event has been seen, but cannot be followed
398 until the exec is seen.
400 (In the latter case, inferior_ptid is still the parent of the
401 vfork, and pending_follow.fork_event.child_pid is the child. The
402 appropriate process is followed, according to the setting of
403 follow-fork-mode.) */
404 static int follow_vfork_when_exec;
406 static const char follow_fork_mode_ask[] = "ask";
407 static const char follow_fork_mode_both[] = "both";
408 static const char follow_fork_mode_child[] = "child";
409 static const char follow_fork_mode_parent[] = "parent";
411 static const char *follow_fork_mode_kind_names[] =
413 follow_fork_mode_ask,
414 /* ??rehrauer: The "both" option is broken, by what may be a 10.20
415 kernel problem. It's also not terribly useful without a GUI to
416 help the user drive two debuggers. So for now, I'm disabling the
418 /* follow_fork_mode_both, */
419 follow_fork_mode_child,
420 follow_fork_mode_parent,
424 static const char *follow_fork_mode_string = follow_fork_mode_parent;
428 follow_inferior_fork (int parent_pid, int child_pid, int has_forked,
431 int followed_parent = 0;
432 int followed_child = 0;
434 /* Which process did the user want us to follow? */
435 const char *follow_mode = follow_fork_mode_string;
437 /* Or, did the user not know, and want us to ask? */
438 if (follow_fork_mode_string == follow_fork_mode_ask)
440 internal_error (__FILE__, __LINE__,
441 "follow_inferior_fork: \"ask\" mode not implemented");
442 /* follow_mode = follow_fork_mode_...; */
445 /* If we're to be following the parent, then detach from child_pid.
446 We're already following the parent, so need do nothing explicit
448 if (follow_mode == follow_fork_mode_parent)
452 /* We're already attached to the parent, by default. */
454 /* Before detaching from the child, remove all breakpoints from
455 it. (This won't actually modify the breakpoint list, but will
456 physically remove the breakpoints from the child.) */
457 if (!has_vforked || !follow_vfork_when_exec)
459 detach_breakpoints (child_pid);
460 #ifdef SOLIB_REMOVE_INFERIOR_HOOK
461 SOLIB_REMOVE_INFERIOR_HOOK (child_pid);
465 /* Detach from the child. */
468 target_require_detach (child_pid, "", 1);
471 /* If we're to be following the child, then attach to it, detach
472 from inferior_ptid, and set inferior_ptid to child_pid. */
473 else if (follow_mode == follow_fork_mode_child)
475 char child_pid_spelling[100]; /* Arbitrary length. */
479 /* Before detaching from the parent, detach all breakpoints from
480 the child. But only if we're forking, or if we follow vforks
481 as soon as they happen. (If we're following vforks only when
482 the child has exec'd, then it's very wrong to try to write
483 back the "shadow contents" of inserted breakpoints now -- they
484 belong to the child's pre-exec'd a.out.) */
485 if (!has_vforked || !follow_vfork_when_exec)
487 detach_breakpoints (child_pid);
490 /* Before detaching from the parent, remove all breakpoints from it. */
491 remove_breakpoints ();
493 /* Also reset the solib inferior hook from the parent. */
494 #ifdef SOLIB_REMOVE_INFERIOR_HOOK
495 SOLIB_REMOVE_INFERIOR_HOOK (PIDGET (inferior_ptid));
498 /* Detach from the parent. */
500 target_detach (NULL, 1);
502 /* Attach to the child. */
503 inferior_ptid = pid_to_ptid (child_pid);
504 sprintf (child_pid_spelling, "%d", child_pid);
507 target_require_attach (child_pid_spelling, 1);
509 /* Was there a step_resume breakpoint? (There was if the user
510 did a "next" at the fork() call.) If so, explicitly reset its
513 step_resumes are a form of bp that are made to be per-thread.
514 Since we created the step_resume bp when the parent process
515 was being debugged, and now are switching to the child process,
516 from the breakpoint package's viewpoint, that's a switch of
517 "threads". We must update the bp's notion of which thread
518 it is for, or it'll be ignored when it triggers... */
519 if (step_resume_breakpoint &&
520 (!has_vforked || !follow_vfork_when_exec))
521 breakpoint_re_set_thread (step_resume_breakpoint);
523 /* Reinsert all breakpoints in the child. (The user may've set
524 breakpoints after catching the fork, in which case those
525 actually didn't get set in the child, but only in the parent.) */
526 if (!has_vforked || !follow_vfork_when_exec)
528 breakpoint_re_set ();
529 insert_breakpoints ();
533 /* If we're to be following both parent and child, then fork ourselves,
534 and attach the debugger clone to the child. */
535 else if (follow_mode == follow_fork_mode_both)
537 char pid_suffix[100]; /* Arbitrary length. */
539 /* Clone ourselves to follow the child. This is the end of our
540 involvement with child_pid; our clone will take it from here... */
542 target_clone_and_follow_inferior (child_pid, &followed_child);
543 followed_parent = !followed_child;
545 /* We continue to follow the parent. To help distinguish the two
546 debuggers, though, both we and our clone will reset our prompts. */
547 sprintf (pid_suffix, "[%d] ", PIDGET (inferior_ptid));
548 set_prompt (strcat (get_prompt (), pid_suffix));
551 /* The parent and child of a vfork share the same address space.
552 Also, on some targets the order in which vfork and exec events
553 are received for parent in child requires some delicate handling
556 For instance, on ptrace-based HPUX we receive the child's vfork
557 event first, at which time the parent has been suspended by the
558 OS and is essentially untouchable until the child's exit or second
559 exec event arrives. At that time, the parent's vfork event is
560 delivered to us, and that's when we see and decide how to follow
561 the vfork. But to get to that point, we must continue the child
562 until it execs or exits. To do that smoothly, all breakpoints
563 must be removed from the child, in case there are any set between
564 the vfork() and exec() calls. But removing them from the child
565 also removes them from the parent, due to the shared-address-space
566 nature of a vfork'd parent and child. On HPUX, therefore, we must
567 take care to restore the bp's to the parent before we continue it.
568 Else, it's likely that we may not stop in the expected place. (The
569 worst scenario is when the user tries to step over a vfork() call;
570 the step-resume bp must be restored for the step to properly stop
571 in the parent after the call completes!)
573 Sequence of events, as reported to gdb from HPUX:
575 Parent Child Action for gdb to take
576 -------------------------------------------------------
577 1 VFORK Continue child
583 target_post_follow_vfork (parent_pid,
589 pending_follow.fork_event.saw_parent_fork = 0;
590 pending_follow.fork_event.saw_child_fork = 0;
594 follow_fork (int parent_pid, int child_pid)
596 follow_inferior_fork (parent_pid, child_pid, 1, 0);
600 /* Forward declaration. */
601 static void follow_exec (int, char *);
604 follow_vfork (int parent_pid, int child_pid)
606 follow_inferior_fork (parent_pid, child_pid, 0, 1);
608 /* Did we follow the child? Had it exec'd before we saw the parent vfork? */
609 if (pending_follow.fork_event.saw_child_exec
610 && (PIDGET (inferior_ptid) == child_pid))
612 pending_follow.fork_event.saw_child_exec = 0;
613 pending_follow.kind = TARGET_WAITKIND_SPURIOUS;
614 follow_exec (PIDGET (inferior_ptid), pending_follow.execd_pathname);
615 xfree (pending_follow.execd_pathname);
619 /* EXECD_PATHNAME is assumed to be non-NULL. */
622 follow_exec (int pid, char *execd_pathname)
625 struct target_ops *tgt;
627 if (!may_follow_exec)
630 /* Did this exec() follow a vfork()? If so, we must follow the
631 vfork now too. Do it before following the exec. */
632 if (follow_vfork_when_exec &&
633 (pending_follow.kind == TARGET_WAITKIND_VFORKED))
635 pending_follow.kind = TARGET_WAITKIND_SPURIOUS;
636 follow_vfork (PIDGET (inferior_ptid),
637 pending_follow.fork_event.child_pid);
638 follow_vfork_when_exec = 0;
639 saved_pid = PIDGET (inferior_ptid);
641 /* Did we follow the parent? If so, we're done. If we followed
642 the child then we must also follow its exec(). */
643 if (PIDGET (inferior_ptid) == pending_follow.fork_event.parent_pid)
647 /* This is an exec event that we actually wish to pay attention to.
648 Refresh our symbol table to the newly exec'd program, remove any
651 If there are breakpoints, they aren't really inserted now,
652 since the exec() transformed our inferior into a fresh set
655 We want to preserve symbolic breakpoints on the list, since
656 we have hopes that they can be reset after the new a.out's
657 symbol table is read.
659 However, any "raw" breakpoints must be removed from the list
660 (e.g., the solib bp's), since their address is probably invalid
663 And, we DON'T want to call delete_breakpoints() here, since
664 that may write the bp's "shadow contents" (the instruction
665 value that was overwritten witha TRAP instruction). Since
666 we now have a new a.out, those shadow contents aren't valid. */
667 update_breakpoints_after_exec ();
669 /* If there was one, it's gone now. We cannot truly step-to-next
670 statement through an exec(). */
671 step_resume_breakpoint = NULL;
672 step_range_start = 0;
675 /* If there was one, it's gone now. */
676 through_sigtramp_breakpoint = NULL;
678 /* What is this a.out's name? */
679 printf_unfiltered ("Executing new program: %s\n", execd_pathname);
681 /* We've followed the inferior through an exec. Therefore, the
682 inferior has essentially been killed & reborn. */
684 /* First collect the run target in effect. */
685 tgt = find_run_target ();
686 /* If we can't find one, things are in a very strange state... */
688 error ("Could find run target to save before following exec");
690 gdb_flush (gdb_stdout);
691 target_mourn_inferior ();
692 inferior_ptid = pid_to_ptid (saved_pid);
693 /* Because mourn_inferior resets inferior_ptid. */
696 /* That a.out is now the one to use. */
697 exec_file_attach (execd_pathname, 0);
699 /* And also is where symbols can be found. */
700 symbol_file_add_main (execd_pathname, 0);
702 /* Reset the shared library package. This ensures that we get
703 a shlib event when the child reaches "_start", at which point
704 the dld will have had a chance to initialize the child. */
705 #if defined(SOLIB_RESTART)
708 #ifdef SOLIB_CREATE_INFERIOR_HOOK
709 SOLIB_CREATE_INFERIOR_HOOK (PIDGET (inferior_ptid));
712 /* Reinsert all breakpoints. (Those which were symbolic have
713 been reset to the proper address in the new a.out, thanks
714 to symbol_file_command...) */
715 insert_breakpoints ();
717 /* The next resume of this inferior should bring it to the shlib
718 startup breakpoints. (If the user had also set bp's on
719 "main" from the old (parent) process, then they'll auto-
720 matically get reset there in the new process.) */
723 /* Non-zero if we just simulating a single-step. This is needed
724 because we cannot remove the breakpoints in the inferior process
725 until after the `wait' in `wait_for_inferior'. */
726 static int singlestep_breakpoints_inserted_p = 0;
729 /* Things to clean up if we QUIT out of resume (). */
732 resume_cleanups (void *ignore)
737 static const char schedlock_off[] = "off";
738 static const char schedlock_on[] = "on";
739 static const char schedlock_step[] = "step";
740 static const char *scheduler_mode = schedlock_off;
741 static const char *scheduler_enums[] =
750 set_schedlock_func (char *args, int from_tty, struct cmd_list_element *c)
752 /* NOTE: cagney/2002-03-17: The add_show_from_set() function clones
753 the set command passed as a parameter. The clone operation will
754 include (BUG?) any ``set'' command callback, if present.
755 Commands like ``info set'' call all the ``show'' command
756 callbacks. Unfortunatly, for ``show'' commands cloned from
757 ``set'', this includes callbacks belonging to ``set'' commands.
758 Making this worse, this only occures if add_show_from_set() is
759 called after add_cmd_sfunc() (BUG?). */
760 if (cmd_type (c) == set_cmd)
761 if (!target_can_lock_scheduler)
763 scheduler_mode = schedlock_off;
764 error ("Target '%s' cannot support this command.",
770 /* Resume the inferior, but allow a QUIT. This is useful if the user
771 wants to interrupt some lengthy single-stepping operation
772 (for child processes, the SIGINT goes to the inferior, and so
773 we get a SIGINT random_signal, but for remote debugging and perhaps
774 other targets, that's not true).
776 STEP nonzero if we should step (zero to continue instead).
777 SIG is the signal to give the inferior (zero for none). */
779 resume (int step, enum target_signal sig)
781 int should_resume = 1;
782 struct cleanup *old_cleanups = make_cleanup (resume_cleanups, 0);
785 /* FIXME: calling breakpoint_here_p (read_pc ()) three times! */
788 /* Some targets (e.g. Solaris x86) have a kernel bug when stepping
789 over an instruction that causes a page fault without triggering
790 a hardware watchpoint. The kernel properly notices that it shouldn't
791 stop, because the hardware watchpoint is not triggered, but it forgets
792 the step request and continues the program normally.
793 Work around the problem by removing hardware watchpoints if a step is
794 requested, GDB will check for a hardware watchpoint trigger after the
796 if (CANNOT_STEP_HW_WATCHPOINTS && step && breakpoints_inserted)
797 remove_hw_watchpoints ();
800 /* Normally, by the time we reach `resume', the breakpoints are either
801 removed or inserted, as appropriate. The exception is if we're sitting
802 at a permanent breakpoint; we need to step over it, but permanent
803 breakpoints can't be removed. So we have to test for it here. */
804 if (breakpoint_here_p (read_pc ()) == permanent_breakpoint_here)
805 SKIP_PERMANENT_BREAKPOINT ();
807 if (SOFTWARE_SINGLE_STEP_P () && step)
809 /* Do it the hard way, w/temp breakpoints */
810 SOFTWARE_SINGLE_STEP (sig, 1 /*insert-breakpoints */ );
811 /* ...and don't ask hardware to do it. */
813 /* and do not pull these breakpoints until after a `wait' in
814 `wait_for_inferior' */
815 singlestep_breakpoints_inserted_p = 1;
818 /* Handle any optimized stores to the inferior NOW... */
819 #ifdef DO_DEFERRED_STORES
823 /* If there were any forks/vforks/execs that were caught and are
824 now to be followed, then do so. */
825 switch (pending_follow.kind)
827 case (TARGET_WAITKIND_FORKED):
828 pending_follow.kind = TARGET_WAITKIND_SPURIOUS;
829 follow_fork (PIDGET (inferior_ptid),
830 pending_follow.fork_event.child_pid);
833 case (TARGET_WAITKIND_VFORKED):
835 int saw_child_exec = pending_follow.fork_event.saw_child_exec;
837 pending_follow.kind = TARGET_WAITKIND_SPURIOUS;
838 follow_vfork (PIDGET (inferior_ptid),
839 pending_follow.fork_event.child_pid);
841 /* Did we follow the child, but not yet see the child's exec event?
842 If so, then it actually ought to be waiting for us; we respond to
843 parent vfork events. We don't actually want to resume the child
844 in this situation; we want to just get its exec event. */
845 if (!saw_child_exec &&
846 (PIDGET (inferior_ptid) == pending_follow.fork_event.child_pid))
851 case (TARGET_WAITKIND_EXECD):
852 /* If we saw a vfork event but couldn't follow it until we saw
853 an exec, then now might be the time! */
854 pending_follow.kind = TARGET_WAITKIND_SPURIOUS;
855 /* follow_exec is called as soon as the exec event is seen. */
862 /* Install inferior's terminal modes. */
863 target_terminal_inferior ();
869 resume_ptid = RESUME_ALL; /* Default */
871 if ((step || singlestep_breakpoints_inserted_p) &&
872 !breakpoints_inserted && breakpoint_here_p (read_pc ()))
874 /* Stepping past a breakpoint without inserting breakpoints.
875 Make sure only the current thread gets to step, so that
876 other threads don't sneak past breakpoints while they are
879 resume_ptid = inferior_ptid;
882 if ((scheduler_mode == schedlock_on) ||
883 (scheduler_mode == schedlock_step &&
884 (step || singlestep_breakpoints_inserted_p)))
886 /* User-settable 'scheduler' mode requires solo thread resume. */
887 resume_ptid = inferior_ptid;
890 #ifdef CANNOT_STEP_BREAKPOINT
891 /* Most targets can step a breakpoint instruction, thus executing it
892 normally. But if this one cannot, just continue and we will hit
894 if (step && breakpoints_inserted && breakpoint_here_p (read_pc ()))
897 target_resume (resume_ptid, step, sig);
900 discard_cleanups (old_cleanups);
904 /* Clear out all variables saying what to do when inferior is continued.
905 First do this, then set the ones you want, then call `proceed'. */
908 clear_proceed_status (void)
911 step_range_start = 0;
913 step_frame_address = 0;
914 step_over_calls = STEP_OVER_UNDEBUGGABLE;
916 stop_soon_quietly = 0;
917 proceed_to_finish = 0;
918 breakpoint_proceeded = 1; /* We're about to proceed... */
920 /* Discard any remaining commands or status from previous stop. */
921 bpstat_clear (&stop_bpstat);
924 /* Basic routine for continuing the program in various fashions.
926 ADDR is the address to resume at, or -1 for resume where stopped.
927 SIGGNAL is the signal to give it, or 0 for none,
928 or -1 for act according to how it stopped.
929 STEP is nonzero if should trap after one instruction.
930 -1 means return after that and print nothing.
931 You should probably set various step_... variables
932 before calling here, if you are stepping.
934 You should call clear_proceed_status before calling proceed. */
937 proceed (CORE_ADDR addr, enum target_signal siggnal, int step)
942 step_start_function = find_pc_function (read_pc ());
946 if (addr == (CORE_ADDR) -1)
948 /* If there is a breakpoint at the address we will resume at,
949 step one instruction before inserting breakpoints
950 so that we do not stop right away (and report a second
951 hit at this breakpoint). */
953 if (read_pc () == stop_pc && breakpoint_here_p (read_pc ()))
956 #ifndef STEP_SKIPS_DELAY
957 #define STEP_SKIPS_DELAY(pc) (0)
958 #define STEP_SKIPS_DELAY_P (0)
960 /* Check breakpoint_here_p first, because breakpoint_here_p is fast
961 (it just checks internal GDB data structures) and STEP_SKIPS_DELAY
962 is slow (it needs to read memory from the target). */
963 if (STEP_SKIPS_DELAY_P
964 && breakpoint_here_p (read_pc () + 4)
965 && STEP_SKIPS_DELAY (read_pc ()))
973 #ifdef PREPARE_TO_PROCEED
974 /* In a multi-threaded task we may select another thread
975 and then continue or step.
977 But if the old thread was stopped at a breakpoint, it
978 will immediately cause another breakpoint stop without
979 any execution (i.e. it will report a breakpoint hit
980 incorrectly). So we must step over it first.
982 PREPARE_TO_PROCEED checks the current thread against the thread
983 that reported the most recent event. If a step-over is required
984 it returns TRUE and sets the current thread to the old thread. */
985 if (PREPARE_TO_PROCEED (1) && breakpoint_here_p (read_pc ()))
990 #endif /* PREPARE_TO_PROCEED */
993 if (trap_expected_after_continue)
995 /* If (step == 0), a trap will be automatically generated after
996 the first instruction is executed. Force step one
997 instruction to clear this condition. This should not occur
998 if step is nonzero, but it is harmless in that case. */
1000 trap_expected_after_continue = 0;
1002 #endif /* HP_OS_BUG */
1005 /* We will get a trace trap after one instruction.
1006 Continue it automatically and insert breakpoints then. */
1010 int temp = insert_breakpoints ();
1013 print_sys_errmsg ("insert_breakpoints", temp);
1014 error ("Cannot insert breakpoints.\n\
1015 The same program may be running in another process,\n\
1016 or you may have requested too many hardware\n\
1017 breakpoints and/or watchpoints.\n");
1020 breakpoints_inserted = 1;
1023 if (siggnal != TARGET_SIGNAL_DEFAULT)
1024 stop_signal = siggnal;
1025 /* If this signal should not be seen by program,
1026 give it zero. Used for debugging signals. */
1027 else if (!signal_program[stop_signal])
1028 stop_signal = TARGET_SIGNAL_0;
1030 annotate_starting ();
1032 /* Make sure that output from GDB appears before output from the
1034 gdb_flush (gdb_stdout);
1036 /* Resume inferior. */
1037 resume (oneproc || step || bpstat_should_step (), stop_signal);
1039 /* Wait for it to stop (if not standalone)
1040 and in any case decode why it stopped, and act accordingly. */
1041 /* Do this only if we are not using the event loop, or if the target
1042 does not support asynchronous execution. */
1043 if (!event_loop_p || !target_can_async_p ())
1045 wait_for_inferior ();
1050 /* Record the pc and sp of the program the last time it stopped.
1051 These are just used internally by wait_for_inferior, but need
1052 to be preserved over calls to it and cleared when the inferior
1054 static CORE_ADDR prev_pc;
1055 static CORE_ADDR prev_func_start;
1056 static char *prev_func_name;
1059 /* Start remote-debugging of a machine over a serial link. */
1064 init_thread_list ();
1065 init_wait_for_inferior ();
1066 stop_soon_quietly = 1;
1069 /* Always go on waiting for the target, regardless of the mode. */
1070 /* FIXME: cagney/1999-09-23: At present it isn't possible to
1071 indicate to wait_for_inferior that a target should timeout if
1072 nothing is returned (instead of just blocking). Because of this,
1073 targets expecting an immediate response need to, internally, set
1074 things up so that the target_wait() is forced to eventually
1076 /* FIXME: cagney/1999-09-24: It isn't possible for target_open() to
1077 differentiate to its caller what the state of the target is after
1078 the initial open has been performed. Here we're assuming that
1079 the target has stopped. It should be possible to eventually have
1080 target_open() return to the caller an indication that the target
1081 is currently running and GDB state should be set to the same as
1082 for an async run. */
1083 wait_for_inferior ();
1087 /* Initialize static vars when a new inferior begins. */
1090 init_wait_for_inferior (void)
1092 /* These are meaningless until the first time through wait_for_inferior. */
1094 prev_func_start = 0;
1095 prev_func_name = NULL;
1098 trap_expected_after_continue = 0;
1100 breakpoints_inserted = 0;
1101 breakpoint_init_inferior (inf_starting);
1103 /* Don't confuse first call to proceed(). */
1104 stop_signal = TARGET_SIGNAL_0;
1106 /* The first resume is not following a fork/vfork/exec. */
1107 pending_follow.kind = TARGET_WAITKIND_SPURIOUS; /* I.e., none. */
1108 pending_follow.fork_event.saw_parent_fork = 0;
1109 pending_follow.fork_event.saw_child_fork = 0;
1110 pending_follow.fork_event.saw_child_exec = 0;
1112 /* See wait_for_inferior's handling of SYSCALL_ENTRY/RETURN events. */
1113 number_of_threads_in_syscalls = 0;
1115 clear_proceed_status ();
1119 delete_breakpoint_current_contents (void *arg)
1121 struct breakpoint **breakpointp = (struct breakpoint **) arg;
1122 if (*breakpointp != NULL)
1124 delete_breakpoint (*breakpointp);
1125 *breakpointp = NULL;
1129 /* This enum encodes possible reasons for doing a target_wait, so that
1130 wfi can call target_wait in one place. (Ultimately the call will be
1131 moved out of the infinite loop entirely.) */
1135 infwait_normal_state,
1136 infwait_thread_hop_state,
1137 infwait_nullified_state,
1138 infwait_nonstep_watch_state
1141 /* Why did the inferior stop? Used to print the appropriate messages
1142 to the interface from within handle_inferior_event(). */
1143 enum inferior_stop_reason
1145 /* We don't know why. */
1147 /* Step, next, nexti, stepi finished. */
1149 /* Found breakpoint. */
1151 /* Inferior terminated by signal. */
1153 /* Inferior exited. */
1155 /* Inferior received signal, and user asked to be notified. */
1159 /* This structure contains what used to be local variables in
1160 wait_for_inferior. Probably many of them can return to being
1161 locals in handle_inferior_event. */
1163 struct execution_control_state
1165 struct target_waitstatus ws;
1166 struct target_waitstatus *wp;
1169 CORE_ADDR stop_func_start;
1170 CORE_ADDR stop_func_end;
1171 char *stop_func_name;
1172 struct symtab_and_line sal;
1173 int remove_breakpoints_on_following_step;
1175 struct symtab *current_symtab;
1176 int handling_longjmp; /* FIXME */
1178 ptid_t saved_inferior_ptid;
1180 int stepping_through_solib_after_catch;
1181 bpstat stepping_through_solib_catchpoints;
1182 int enable_hw_watchpoints_after_wait;
1183 int stepping_through_sigtramp;
1184 int new_thread_event;
1185 struct target_waitstatus tmpstatus;
1186 enum infwait_states infwait_state;
1191 void init_execution_control_state (struct execution_control_state * ecs);
1193 void handle_inferior_event (struct execution_control_state * ecs);
1195 static void check_sigtramp2 (struct execution_control_state *ecs);
1196 static void step_into_function (struct execution_control_state *ecs);
1197 static void step_over_function (struct execution_control_state *ecs);
1198 static void stop_stepping (struct execution_control_state *ecs);
1199 static void prepare_to_wait (struct execution_control_state *ecs);
1200 static void keep_going (struct execution_control_state *ecs);
1201 static void print_stop_reason (enum inferior_stop_reason stop_reason, int stop_info);
1203 /* Wait for control to return from inferior to debugger.
1204 If inferior gets a signal, we may decide to start it up again
1205 instead of returning. That is why there is a loop in this function.
1206 When this function actually returns it means the inferior
1207 should be left stopped and GDB should read more commands. */
1210 wait_for_inferior (void)
1212 struct cleanup *old_cleanups;
1213 struct execution_control_state ecss;
1214 struct execution_control_state *ecs;
1216 old_cleanups = make_cleanup (delete_step_resume_breakpoint,
1217 &step_resume_breakpoint);
1218 make_cleanup (delete_breakpoint_current_contents,
1219 &through_sigtramp_breakpoint);
1221 /* wfi still stays in a loop, so it's OK just to take the address of
1222 a local to get the ecs pointer. */
1225 /* Fill in with reasonable starting values. */
1226 init_execution_control_state (ecs);
1228 /* We'll update this if & when we switch to a new thread. */
1229 previous_inferior_ptid = inferior_ptid;
1231 overlay_cache_invalid = 1;
1233 /* We have to invalidate the registers BEFORE calling target_wait
1234 because they can be loaded from the target while in target_wait.
1235 This makes remote debugging a bit more efficient for those
1236 targets that provide critical registers as part of their normal
1237 status mechanism. */
1239 registers_changed ();
1243 if (target_wait_hook)
1244 ecs->ptid = target_wait_hook (ecs->waiton_ptid, ecs->wp);
1246 ecs->ptid = target_wait (ecs->waiton_ptid, ecs->wp);
1248 /* Now figure out what to do with the result of the result. */
1249 handle_inferior_event (ecs);
1251 if (!ecs->wait_some_more)
1254 do_cleanups (old_cleanups);
1257 /* Asynchronous version of wait_for_inferior. It is called by the
1258 event loop whenever a change of state is detected on the file
1259 descriptor corresponding to the target. It can be called more than
1260 once to complete a single execution command. In such cases we need
1261 to keep the state in a global variable ASYNC_ECSS. If it is the
1262 last time that this function is called for a single execution
1263 command, then report to the user that the inferior has stopped, and
1264 do the necessary cleanups. */
1266 struct execution_control_state async_ecss;
1267 struct execution_control_state *async_ecs;
1270 fetch_inferior_event (void *client_data)
1272 static struct cleanup *old_cleanups;
1274 async_ecs = &async_ecss;
1276 if (!async_ecs->wait_some_more)
1278 old_cleanups = make_exec_cleanup (delete_step_resume_breakpoint,
1279 &step_resume_breakpoint);
1280 make_exec_cleanup (delete_breakpoint_current_contents,
1281 &through_sigtramp_breakpoint);
1283 /* Fill in with reasonable starting values. */
1284 init_execution_control_state (async_ecs);
1286 /* We'll update this if & when we switch to a new thread. */
1287 previous_inferior_ptid = inferior_ptid;
1289 overlay_cache_invalid = 1;
1291 /* We have to invalidate the registers BEFORE calling target_wait
1292 because they can be loaded from the target while in target_wait.
1293 This makes remote debugging a bit more efficient for those
1294 targets that provide critical registers as part of their normal
1295 status mechanism. */
1297 registers_changed ();
1300 if (target_wait_hook)
1301 async_ecs->ptid = target_wait_hook (async_ecs->waiton_ptid, async_ecs->wp);
1303 async_ecs->ptid = target_wait (async_ecs->waiton_ptid, async_ecs->wp);
1305 /* Now figure out what to do with the result of the result. */
1306 handle_inferior_event (async_ecs);
1308 if (!async_ecs->wait_some_more)
1310 /* Do only the cleanups that have been added by this
1311 function. Let the continuations for the commands do the rest,
1312 if there are any. */
1313 do_exec_cleanups (old_cleanups);
1315 if (step_multi && stop_step)
1316 inferior_event_handler (INF_EXEC_CONTINUE, NULL);
1318 inferior_event_handler (INF_EXEC_COMPLETE, NULL);
1322 /* Prepare an execution control state for looping through a
1323 wait_for_inferior-type loop. */
1326 init_execution_control_state (struct execution_control_state *ecs)
1328 /* ecs->another_trap? */
1329 ecs->random_signal = 0;
1330 ecs->remove_breakpoints_on_following_step = 0;
1331 ecs->handling_longjmp = 0; /* FIXME */
1332 ecs->update_step_sp = 0;
1333 ecs->stepping_through_solib_after_catch = 0;
1334 ecs->stepping_through_solib_catchpoints = NULL;
1335 ecs->enable_hw_watchpoints_after_wait = 0;
1336 ecs->stepping_through_sigtramp = 0;
1337 ecs->sal = find_pc_line (prev_pc, 0);
1338 ecs->current_line = ecs->sal.line;
1339 ecs->current_symtab = ecs->sal.symtab;
1340 ecs->infwait_state = infwait_normal_state;
1341 ecs->waiton_ptid = pid_to_ptid (-1);
1342 ecs->wp = &(ecs->ws);
1345 /* Call this function before setting step_resume_breakpoint, as a
1346 sanity check. There should never be more than one step-resume
1347 breakpoint per thread, so we should never be setting a new
1348 step_resume_breakpoint when one is already active. */
1350 check_for_old_step_resume_breakpoint (void)
1352 if (step_resume_breakpoint)
1353 warning ("GDB bug: infrun.c (wait_for_inferior): dropping old step_resume breakpoint");
1356 /* Return the cached copy of the last pid/waitstatus returned by
1357 target_wait()/target_wait_hook(). The data is actually cached by
1358 handle_inferior_event(), which gets called immediately after
1359 target_wait()/target_wait_hook(). */
1362 get_last_target_status(ptid_t *ptidp, struct target_waitstatus *status)
1364 *ptidp = target_last_wait_ptid;
1365 *status = target_last_waitstatus;
1368 /* Switch thread contexts, maintaining "infrun state". */
1371 context_switch (struct execution_control_state *ecs)
1373 /* Caution: it may happen that the new thread (or the old one!)
1374 is not in the thread list. In this case we must not attempt
1375 to "switch context", or we run the risk that our context may
1376 be lost. This may happen as a result of the target module
1377 mishandling thread creation. */
1379 if (in_thread_list (inferior_ptid) && in_thread_list (ecs->ptid))
1380 { /* Perform infrun state context switch: */
1381 /* Save infrun state for the old thread. */
1382 save_infrun_state (inferior_ptid, prev_pc,
1383 prev_func_start, prev_func_name,
1384 trap_expected, step_resume_breakpoint,
1385 through_sigtramp_breakpoint, step_range_start,
1386 step_range_end, step_frame_address,
1387 ecs->handling_longjmp, ecs->another_trap,
1388 ecs->stepping_through_solib_after_catch,
1389 ecs->stepping_through_solib_catchpoints,
1390 ecs->stepping_through_sigtramp,
1391 ecs->current_line, ecs->current_symtab,
1394 /* Load infrun state for the new thread. */
1395 load_infrun_state (ecs->ptid, &prev_pc,
1396 &prev_func_start, &prev_func_name,
1397 &trap_expected, &step_resume_breakpoint,
1398 &through_sigtramp_breakpoint, &step_range_start,
1399 &step_range_end, &step_frame_address,
1400 &ecs->handling_longjmp, &ecs->another_trap,
1401 &ecs->stepping_through_solib_after_catch,
1402 &ecs->stepping_through_solib_catchpoints,
1403 &ecs->stepping_through_sigtramp,
1404 &ecs->current_line, &ecs->current_symtab,
1407 inferior_ptid = ecs->ptid;
1411 /* Given an execution control state that has been freshly filled in
1412 by an event from the inferior, figure out what it means and take
1413 appropriate action. */
1416 handle_inferior_event (struct execution_control_state *ecs)
1419 int stepped_after_stopped_by_watchpoint;
1421 /* Cache the last pid/waitstatus. */
1422 target_last_wait_ptid = ecs->ptid;
1423 target_last_waitstatus = *ecs->wp;
1425 /* Keep this extra brace for now, minimizes diffs. */
1427 switch (ecs->infwait_state)
1429 case infwait_thread_hop_state:
1430 /* Cancel the waiton_ptid. */
1431 ecs->waiton_ptid = pid_to_ptid (-1);
1432 /* Fall thru to the normal_state case. */
1434 case infwait_normal_state:
1435 /* See comments where a TARGET_WAITKIND_SYSCALL_RETURN event
1436 is serviced in this loop, below. */
1437 if (ecs->enable_hw_watchpoints_after_wait)
1439 TARGET_ENABLE_HW_WATCHPOINTS (PIDGET (inferior_ptid));
1440 ecs->enable_hw_watchpoints_after_wait = 0;
1442 stepped_after_stopped_by_watchpoint = 0;
1445 case infwait_nullified_state:
1448 case infwait_nonstep_watch_state:
1449 insert_breakpoints ();
1451 /* FIXME-maybe: is this cleaner than setting a flag? Does it
1452 handle things like signals arriving and other things happening
1453 in combination correctly? */
1454 stepped_after_stopped_by_watchpoint = 1;
1457 ecs->infwait_state = infwait_normal_state;
1459 flush_cached_frames ();
1461 /* If it's a new process, add it to the thread database */
1463 ecs->new_thread_event = (! ptid_equal (ecs->ptid, inferior_ptid)
1464 && ! in_thread_list (ecs->ptid));
1466 if (ecs->ws.kind != TARGET_WAITKIND_EXITED
1467 && ecs->ws.kind != TARGET_WAITKIND_SIGNALLED
1468 && ecs->new_thread_event)
1470 add_thread (ecs->ptid);
1472 ui_out_text (uiout, "[New ");
1473 ui_out_text (uiout, target_pid_or_tid_to_str (ecs->ptid));
1474 ui_out_text (uiout, "]\n");
1477 /* NOTE: This block is ONLY meant to be invoked in case of a
1478 "thread creation event"! If it is invoked for any other
1479 sort of event (such as a new thread landing on a breakpoint),
1480 the event will be discarded, which is almost certainly
1483 To avoid this, the low-level module (eg. target_wait)
1484 should call in_thread_list and add_thread, so that the
1485 new thread is known by the time we get here. */
1487 /* We may want to consider not doing a resume here in order
1488 to give the user a chance to play with the new thread.
1489 It might be good to make that a user-settable option. */
1491 /* At this point, all threads are stopped (happens
1492 automatically in either the OS or the native code).
1493 Therefore we need to continue all threads in order to
1496 target_resume (RESUME_ALL, 0, TARGET_SIGNAL_0);
1497 prepare_to_wait (ecs);
1502 switch (ecs->ws.kind)
1504 case TARGET_WAITKIND_LOADED:
1505 /* Ignore gracefully during startup of the inferior, as it
1506 might be the shell which has just loaded some objects,
1507 otherwise add the symbols for the newly loaded objects. */
1509 if (!stop_soon_quietly)
1511 /* Remove breakpoints, SOLIB_ADD might adjust
1512 breakpoint addresses via breakpoint_re_set. */
1513 if (breakpoints_inserted)
1514 remove_breakpoints ();
1516 /* Check for any newly added shared libraries if we're
1517 supposed to be adding them automatically. Switch
1518 terminal for any messages produced by
1519 breakpoint_re_set. */
1520 target_terminal_ours_for_output ();
1521 SOLIB_ADD (NULL, 0, NULL, auto_solib_add);
1522 target_terminal_inferior ();
1524 /* Reinsert breakpoints and continue. */
1525 if (breakpoints_inserted)
1526 insert_breakpoints ();
1529 resume (0, TARGET_SIGNAL_0);
1530 prepare_to_wait (ecs);
1533 case TARGET_WAITKIND_SPURIOUS:
1534 resume (0, TARGET_SIGNAL_0);
1535 prepare_to_wait (ecs);
1538 case TARGET_WAITKIND_EXITED:
1539 target_terminal_ours (); /* Must do this before mourn anyway */
1540 print_stop_reason (EXITED, ecs->ws.value.integer);
1542 /* Record the exit code in the convenience variable $_exitcode, so
1543 that the user can inspect this again later. */
1544 set_internalvar (lookup_internalvar ("_exitcode"),
1545 value_from_longest (builtin_type_int,
1546 (LONGEST) ecs->ws.value.integer));
1547 gdb_flush (gdb_stdout);
1548 target_mourn_inferior ();
1549 singlestep_breakpoints_inserted_p = 0; /*SOFTWARE_SINGLE_STEP_P() */
1550 stop_print_frame = 0;
1551 stop_stepping (ecs);
1554 case TARGET_WAITKIND_SIGNALLED:
1555 stop_print_frame = 0;
1556 stop_signal = ecs->ws.value.sig;
1557 target_terminal_ours (); /* Must do this before mourn anyway */
1559 /* Note: By definition of TARGET_WAITKIND_SIGNALLED, we shouldn't
1560 reach here unless the inferior is dead. However, for years
1561 target_kill() was called here, which hints that fatal signals aren't
1562 really fatal on some systems. If that's true, then some changes
1564 target_mourn_inferior ();
1566 print_stop_reason (SIGNAL_EXITED, stop_signal);
1567 singlestep_breakpoints_inserted_p = 0; /*SOFTWARE_SINGLE_STEP_P() */
1568 stop_stepping (ecs);
1571 /* The following are the only cases in which we keep going;
1572 the above cases end in a continue or goto. */
1573 case TARGET_WAITKIND_FORKED:
1574 stop_signal = TARGET_SIGNAL_TRAP;
1575 pending_follow.kind = ecs->ws.kind;
1577 /* Ignore fork events reported for the parent; we're only
1578 interested in reacting to forks of the child. Note that
1579 we expect the child's fork event to be available if we
1580 waited for it now. */
1581 if (ptid_equal (inferior_ptid, ecs->ptid))
1583 pending_follow.fork_event.saw_parent_fork = 1;
1584 pending_follow.fork_event.parent_pid = PIDGET (ecs->ptid);
1585 pending_follow.fork_event.child_pid = ecs->ws.value.related_pid;
1586 prepare_to_wait (ecs);
1591 pending_follow.fork_event.saw_child_fork = 1;
1592 pending_follow.fork_event.child_pid = PIDGET (ecs->ptid);
1593 pending_follow.fork_event.parent_pid = ecs->ws.value.related_pid;
1596 stop_pc = read_pc_pid (ecs->ptid);
1597 ecs->saved_inferior_ptid = inferior_ptid;
1598 inferior_ptid = ecs->ptid;
1599 /* The second argument of bpstat_stop_status is meant to help
1600 distinguish between a breakpoint trap and a singlestep trap.
1601 This is only important on targets where DECR_PC_AFTER_BREAK
1602 is non-zero. The prev_pc test is meant to distinguish between
1603 singlestepping a trap instruction, and singlestepping thru a
1604 jump to the instruction following a trap instruction. */
1606 stop_bpstat = bpstat_stop_status (&stop_pc,
1607 currently_stepping (ecs) &&
1609 stop_pc - DECR_PC_AFTER_BREAK);
1610 ecs->random_signal = !bpstat_explains_signal (stop_bpstat);
1611 inferior_ptid = ecs->saved_inferior_ptid;
1612 goto process_event_stop_test;
1614 /* If this a platform which doesn't allow a debugger to touch a
1615 vfork'd inferior until after it exec's, then we'd best keep
1616 our fingers entirely off the inferior, other than continuing
1617 it. This has the unfortunate side-effect that catchpoints
1618 of vforks will be ignored. But since the platform doesn't
1619 allow the inferior be touched at vfork time, there's really
1621 case TARGET_WAITKIND_VFORKED:
1622 stop_signal = TARGET_SIGNAL_TRAP;
1623 pending_follow.kind = ecs->ws.kind;
1625 /* Is this a vfork of the parent? If so, then give any
1626 vfork catchpoints a chance to trigger now. (It's
1627 dangerous to do so if the child canot be touched until
1628 it execs, and the child has not yet exec'd. We probably
1629 should warn the user to that effect when the catchpoint
1631 if (ptid_equal (ecs->ptid, inferior_ptid))
1633 pending_follow.fork_event.saw_parent_fork = 1;
1634 pending_follow.fork_event.parent_pid = PIDGET (ecs->ptid);
1635 pending_follow.fork_event.child_pid = ecs->ws.value.related_pid;
1638 /* If we've seen the child's vfork event but cannot really touch
1639 the child until it execs, then we must continue the child now.
1640 Else, give any vfork catchpoints a chance to trigger now. */
1643 pending_follow.fork_event.saw_child_fork = 1;
1644 pending_follow.fork_event.child_pid = PIDGET (ecs->ptid);
1645 pending_follow.fork_event.parent_pid = ecs->ws.value.related_pid;
1646 target_post_startup_inferior (
1647 pid_to_ptid (pending_follow.fork_event.child_pid));
1648 follow_vfork_when_exec = !target_can_follow_vfork_prior_to_exec ();
1649 if (follow_vfork_when_exec)
1651 target_resume (ecs->ptid, 0, TARGET_SIGNAL_0);
1652 prepare_to_wait (ecs);
1657 stop_pc = read_pc ();
1658 /* The second argument of bpstat_stop_status is meant to help
1659 distinguish between a breakpoint trap and a singlestep trap.
1660 This is only important on targets where DECR_PC_AFTER_BREAK
1661 is non-zero. The prev_pc test is meant to distinguish between
1662 singlestepping a trap instruction, and singlestepping thru a
1663 jump to the instruction following a trap instruction. */
1665 stop_bpstat = bpstat_stop_status (&stop_pc,
1666 currently_stepping (ecs) &&
1668 stop_pc - DECR_PC_AFTER_BREAK);
1669 ecs->random_signal = !bpstat_explains_signal (stop_bpstat);
1670 goto process_event_stop_test;
1672 case TARGET_WAITKIND_EXECD:
1673 stop_signal = TARGET_SIGNAL_TRAP;
1675 /* Is this a target which reports multiple exec events per actual
1676 call to exec()? (HP-UX using ptrace does, for example.) If so,
1677 ignore all but the last one. Just resume the exec'r, and wait
1678 for the next exec event. */
1679 if (inferior_ignoring_leading_exec_events)
1681 inferior_ignoring_leading_exec_events--;
1682 if (pending_follow.kind == TARGET_WAITKIND_VFORKED)
1683 ENSURE_VFORKING_PARENT_REMAINS_STOPPED (pending_follow.fork_event.parent_pid);
1684 target_resume (ecs->ptid, 0, TARGET_SIGNAL_0);
1685 prepare_to_wait (ecs);
1688 inferior_ignoring_leading_exec_events =
1689 target_reported_exec_events_per_exec_call () - 1;
1691 pending_follow.execd_pathname =
1692 savestring (ecs->ws.value.execd_pathname,
1693 strlen (ecs->ws.value.execd_pathname));
1695 /* Did inferior_ptid exec, or did a (possibly not-yet-followed)
1696 child of a vfork exec?
1698 ??rehrauer: This is unabashedly an HP-UX specific thing. On
1699 HP-UX, events associated with a vforking inferior come in
1700 threes: a vfork event for the child (always first), followed
1701 a vfork event for the parent and an exec event for the child.
1702 The latter two can come in either order.
1704 If we get the parent vfork event first, life's good: We follow
1705 either the parent or child, and then the child's exec event is
1708 But if we get the child's exec event first, then we delay
1709 responding to it until we handle the parent's vfork. Because,
1710 otherwise we can't satisfy a "catch vfork". */
1711 if (pending_follow.kind == TARGET_WAITKIND_VFORKED)
1713 pending_follow.fork_event.saw_child_exec = 1;
1715 /* On some targets, the child must be resumed before
1716 the parent vfork event is delivered. A single-step
1718 if (RESUME_EXECD_VFORKING_CHILD_TO_GET_PARENT_VFORK ())
1719 target_resume (ecs->ptid, 1, TARGET_SIGNAL_0);
1720 /* We expect the parent vfork event to be available now. */
1721 prepare_to_wait (ecs);
1725 /* This causes the eventpoints and symbol table to be reset. Must
1726 do this now, before trying to determine whether to stop. */
1727 follow_exec (PIDGET (inferior_ptid), pending_follow.execd_pathname);
1728 xfree (pending_follow.execd_pathname);
1730 stop_pc = read_pc_pid (ecs->ptid);
1731 ecs->saved_inferior_ptid = inferior_ptid;
1732 inferior_ptid = ecs->ptid;
1733 /* The second argument of bpstat_stop_status is meant to help
1734 distinguish between a breakpoint trap and a singlestep trap.
1735 This is only important on targets where DECR_PC_AFTER_BREAK
1736 is non-zero. The prev_pc test is meant to distinguish between
1737 singlestepping a trap instruction, and singlestepping thru a
1738 jump to the instruction following a trap instruction. */
1740 stop_bpstat = bpstat_stop_status (&stop_pc,
1741 currently_stepping (ecs) &&
1743 stop_pc - DECR_PC_AFTER_BREAK);
1744 ecs->random_signal = !bpstat_explains_signal (stop_bpstat);
1745 inferior_ptid = ecs->saved_inferior_ptid;
1746 goto process_event_stop_test;
1748 /* These syscall events are returned on HP-UX, as part of its
1749 implementation of page-protection-based "hardware" watchpoints.
1750 HP-UX has unfortunate interactions between page-protections and
1751 some system calls. Our solution is to disable hardware watches
1752 when a system call is entered, and reenable them when the syscall
1753 completes. The downside of this is that we may miss the precise
1754 point at which a watched piece of memory is modified. "Oh well."
1756 Note that we may have multiple threads running, which may each
1757 enter syscalls at roughly the same time. Since we don't have a
1758 good notion currently of whether a watched piece of memory is
1759 thread-private, we'd best not have any page-protections active
1760 when any thread is in a syscall. Thus, we only want to reenable
1761 hardware watches when no threads are in a syscall.
1763 Also, be careful not to try to gather much state about a thread
1764 that's in a syscall. It's frequently a losing proposition. */
1765 case TARGET_WAITKIND_SYSCALL_ENTRY:
1766 number_of_threads_in_syscalls++;
1767 if (number_of_threads_in_syscalls == 1)
1769 TARGET_DISABLE_HW_WATCHPOINTS (PIDGET (inferior_ptid));
1771 resume (0, TARGET_SIGNAL_0);
1772 prepare_to_wait (ecs);
1775 /* Before examining the threads further, step this thread to
1776 get it entirely out of the syscall. (We get notice of the
1777 event when the thread is just on the verge of exiting a
1778 syscall. Stepping one instruction seems to get it back
1781 Note that although the logical place to reenable h/w watches
1782 is here, we cannot. We cannot reenable them before stepping
1783 the thread (this causes the next wait on the thread to hang).
1785 Nor can we enable them after stepping until we've done a wait.
1786 Thus, we simply set the flag ecs->enable_hw_watchpoints_after_wait
1787 here, which will be serviced immediately after the target
1789 case TARGET_WAITKIND_SYSCALL_RETURN:
1790 target_resume (ecs->ptid, 1, TARGET_SIGNAL_0);
1792 if (number_of_threads_in_syscalls > 0)
1794 number_of_threads_in_syscalls--;
1795 ecs->enable_hw_watchpoints_after_wait =
1796 (number_of_threads_in_syscalls == 0);
1798 prepare_to_wait (ecs);
1801 case TARGET_WAITKIND_STOPPED:
1802 stop_signal = ecs->ws.value.sig;
1805 /* We had an event in the inferior, but we are not interested
1806 in handling it at this level. The lower layers have already
1807 done what needs to be done, if anything. This case can
1808 occur only when the target is async or extended-async. One
1809 of the circumstamces for this to happen is when the
1810 inferior produces output for the console. The inferior has
1811 not stopped, and we are ignoring the event. */
1812 case TARGET_WAITKIND_IGNORE:
1813 ecs->wait_some_more = 1;
1817 /* We may want to consider not doing a resume here in order to give
1818 the user a chance to play with the new thread. It might be good
1819 to make that a user-settable option. */
1821 /* At this point, all threads are stopped (happens automatically in
1822 either the OS or the native code). Therefore we need to continue
1823 all threads in order to make progress. */
1824 if (ecs->new_thread_event)
1826 target_resume (RESUME_ALL, 0, TARGET_SIGNAL_0);
1827 prepare_to_wait (ecs);
1831 stop_pc = read_pc_pid (ecs->ptid);
1833 /* See if a thread hit a thread-specific breakpoint that was meant for
1834 another thread. If so, then step that thread past the breakpoint,
1837 if (stop_signal == TARGET_SIGNAL_TRAP)
1839 if (SOFTWARE_SINGLE_STEP_P () && singlestep_breakpoints_inserted_p)
1840 ecs->random_signal = 0;
1841 else if (breakpoints_inserted
1842 && breakpoint_here_p (stop_pc - DECR_PC_AFTER_BREAK))
1844 ecs->random_signal = 0;
1845 if (!breakpoint_thread_match (stop_pc - DECR_PC_AFTER_BREAK,
1850 /* Saw a breakpoint, but it was hit by the wrong thread.
1852 if (DECR_PC_AFTER_BREAK)
1853 write_pc_pid (stop_pc - DECR_PC_AFTER_BREAK, ecs->ptid);
1855 remove_status = remove_breakpoints ();
1856 /* Did we fail to remove breakpoints? If so, try
1857 to set the PC past the bp. (There's at least
1858 one situation in which we can fail to remove
1859 the bp's: On HP-UX's that use ttrace, we can't
1860 change the address space of a vforking child
1861 process until the child exits (well, okay, not
1862 then either :-) or execs. */
1863 if (remove_status != 0)
1865 /* FIXME! This is obviously non-portable! */
1866 write_pc_pid (stop_pc - DECR_PC_AFTER_BREAK + 4,
1868 /* We need to restart all the threads now,
1869 * unles we're running in scheduler-locked mode.
1870 * Use currently_stepping to determine whether to
1873 /* FIXME MVS: is there any reason not to call resume()? */
1874 if (scheduler_mode == schedlock_on)
1875 target_resume (ecs->ptid,
1876 currently_stepping (ecs),
1879 target_resume (RESUME_ALL,
1880 currently_stepping (ecs),
1882 prepare_to_wait (ecs);
1887 breakpoints_inserted = 0;
1888 if (!ptid_equal (inferior_ptid, ecs->ptid))
1889 context_switch (ecs);
1890 ecs->waiton_ptid = ecs->ptid;
1891 ecs->wp = &(ecs->ws);
1892 ecs->another_trap = 1;
1894 ecs->infwait_state = infwait_thread_hop_state;
1896 registers_changed ();
1903 ecs->random_signal = 1;
1905 /* See if something interesting happened to the non-current thread. If
1906 so, then switch to that thread, and eventually give control back to
1909 Note that if there's any kind of pending follow (i.e., of a fork,
1910 vfork or exec), we don't want to do this now. Rather, we'll let
1911 the next resume handle it. */
1912 if (! ptid_equal (ecs->ptid, inferior_ptid) &&
1913 (pending_follow.kind == TARGET_WAITKIND_SPURIOUS))
1917 /* If it's a random signal for a non-current thread, notify user
1918 if he's expressed an interest. */
1919 if (ecs->random_signal
1920 && signal_print[stop_signal])
1922 /* ??rehrauer: I don't understand the rationale for this code. If the
1923 inferior will stop as a result of this signal, then the act of handling
1924 the stop ought to print a message that's couches the stoppage in user
1925 terms, e.g., "Stopped for breakpoint/watchpoint". If the inferior
1926 won't stop as a result of the signal -- i.e., if the signal is merely
1927 a side-effect of something GDB's doing "under the covers" for the
1928 user, such as stepping threads over a breakpoint they shouldn't stop
1929 for -- then the message seems to be a serious annoyance at best.
1931 For now, remove the message altogether. */
1934 target_terminal_ours_for_output ();
1935 printf_filtered ("\nProgram received signal %s, %s.\n",
1936 target_signal_to_name (stop_signal),
1937 target_signal_to_string (stop_signal));
1938 gdb_flush (gdb_stdout);
1942 /* If it's not SIGTRAP and not a signal we want to stop for, then
1943 continue the thread. */
1945 if (stop_signal != TARGET_SIGNAL_TRAP
1946 && !signal_stop[stop_signal])
1949 target_terminal_inferior ();
1951 /* Clear the signal if it should not be passed. */
1952 if (signal_program[stop_signal] == 0)
1953 stop_signal = TARGET_SIGNAL_0;
1955 target_resume (ecs->ptid, 0, stop_signal);
1956 prepare_to_wait (ecs);
1960 /* It's a SIGTRAP or a signal we're interested in. Switch threads,
1961 and fall into the rest of wait_for_inferior(). */
1963 context_switch (ecs);
1966 context_hook (pid_to_thread_id (ecs->ptid));
1968 flush_cached_frames ();
1971 if (SOFTWARE_SINGLE_STEP_P () && singlestep_breakpoints_inserted_p)
1973 /* Pull the single step breakpoints out of the target. */
1974 SOFTWARE_SINGLE_STEP (0, 0);
1975 singlestep_breakpoints_inserted_p = 0;
1978 /* If PC is pointing at a nullified instruction, then step beyond
1979 it so that the user won't be confused when GDB appears to be ready
1982 /* if (INSTRUCTION_NULLIFIED && currently_stepping (ecs)) */
1983 if (INSTRUCTION_NULLIFIED)
1985 registers_changed ();
1986 target_resume (ecs->ptid, 1, TARGET_SIGNAL_0);
1988 /* We may have received a signal that we want to pass to
1989 the inferior; therefore, we must not clobber the waitstatus
1992 ecs->infwait_state = infwait_nullified_state;
1993 ecs->waiton_ptid = ecs->ptid;
1994 ecs->wp = &(ecs->tmpstatus);
1995 prepare_to_wait (ecs);
1999 /* It may not be necessary to disable the watchpoint to stop over
2000 it. For example, the PA can (with some kernel cooperation)
2001 single step over a watchpoint without disabling the watchpoint. */
2002 if (HAVE_STEPPABLE_WATCHPOINT && STOPPED_BY_WATCHPOINT (ecs->ws))
2005 prepare_to_wait (ecs);
2009 /* It is far more common to need to disable a watchpoint to step
2010 the inferior over it. FIXME. What else might a debug
2011 register or page protection watchpoint scheme need here? */
2012 if (HAVE_NONSTEPPABLE_WATCHPOINT && STOPPED_BY_WATCHPOINT (ecs->ws))
2014 /* At this point, we are stopped at an instruction which has
2015 attempted to write to a piece of memory under control of
2016 a watchpoint. The instruction hasn't actually executed
2017 yet. If we were to evaluate the watchpoint expression
2018 now, we would get the old value, and therefore no change
2019 would seem to have occurred.
2021 In order to make watchpoints work `right', we really need
2022 to complete the memory write, and then evaluate the
2023 watchpoint expression. The following code does that by
2024 removing the watchpoint (actually, all watchpoints and
2025 breakpoints), single-stepping the target, re-inserting
2026 watchpoints, and then falling through to let normal
2027 single-step processing handle proceed. Since this
2028 includes evaluating watchpoints, things will come to a
2029 stop in the correct manner. */
2031 if (DECR_PC_AFTER_BREAK)
2032 write_pc (stop_pc - DECR_PC_AFTER_BREAK);
2034 remove_breakpoints ();
2035 registers_changed ();
2036 target_resume (ecs->ptid, 1, TARGET_SIGNAL_0); /* Single step */
2038 ecs->waiton_ptid = ecs->ptid;
2039 ecs->wp = &(ecs->ws);
2040 ecs->infwait_state = infwait_nonstep_watch_state;
2041 prepare_to_wait (ecs);
2045 /* It may be possible to simply continue after a watchpoint. */
2046 if (HAVE_CONTINUABLE_WATCHPOINT)
2047 STOPPED_BY_WATCHPOINT (ecs->ws);
2049 ecs->stop_func_start = 0;
2050 ecs->stop_func_end = 0;
2051 ecs->stop_func_name = 0;
2052 /* Don't care about return value; stop_func_start and stop_func_name
2053 will both be 0 if it doesn't work. */
2054 find_pc_partial_function (stop_pc, &ecs->stop_func_name,
2055 &ecs->stop_func_start, &ecs->stop_func_end);
2056 ecs->stop_func_start += FUNCTION_START_OFFSET;
2057 ecs->another_trap = 0;
2058 bpstat_clear (&stop_bpstat);
2060 stop_stack_dummy = 0;
2061 stop_print_frame = 1;
2062 ecs->random_signal = 0;
2063 stopped_by_random_signal = 0;
2064 breakpoints_failed = 0;
2066 /* Look at the cause of the stop, and decide what to do.
2067 The alternatives are:
2068 1) break; to really stop and return to the debugger,
2069 2) drop through to start up again
2070 (set ecs->another_trap to 1 to single step once)
2071 3) set ecs->random_signal to 1, and the decision between 1 and 2
2072 will be made according to the signal handling tables. */
2074 /* First, distinguish signals caused by the debugger from signals
2075 that have to do with the program's own actions.
2076 Note that breakpoint insns may cause SIGTRAP or SIGILL
2077 or SIGEMT, depending on the operating system version.
2078 Here we detect when a SIGILL or SIGEMT is really a breakpoint
2079 and change it to SIGTRAP. */
2081 if (stop_signal == TARGET_SIGNAL_TRAP
2082 || (breakpoints_inserted &&
2083 (stop_signal == TARGET_SIGNAL_ILL
2084 || stop_signal == TARGET_SIGNAL_EMT
2086 || stop_soon_quietly)
2088 if (stop_signal == TARGET_SIGNAL_TRAP && stop_after_trap)
2090 stop_print_frame = 0;
2091 stop_stepping (ecs);
2094 if (stop_soon_quietly)
2096 stop_stepping (ecs);
2100 /* Don't even think about breakpoints
2101 if just proceeded over a breakpoint.
2103 However, if we are trying to proceed over a breakpoint
2104 and end up in sigtramp, then through_sigtramp_breakpoint
2105 will be set and we should check whether we've hit the
2107 if (stop_signal == TARGET_SIGNAL_TRAP && trap_expected
2108 && through_sigtramp_breakpoint == NULL)
2109 bpstat_clear (&stop_bpstat);
2112 /* See if there is a breakpoint at the current PC. */
2114 /* The second argument of bpstat_stop_status is meant to help
2115 distinguish between a breakpoint trap and a singlestep trap.
2116 This is only important on targets where DECR_PC_AFTER_BREAK
2117 is non-zero. The prev_pc test is meant to distinguish between
2118 singlestepping a trap instruction, and singlestepping thru a
2119 jump to the instruction following a trap instruction. */
2121 stop_bpstat = bpstat_stop_status
2123 /* Pass TRUE if our reason for stopping is something other
2124 than hitting a breakpoint. We do this by checking that
2125 1) stepping is going on and 2) we didn't hit a breakpoint
2126 in a signal handler without an intervening stop in
2127 sigtramp, which is detected by a new stack pointer value
2128 below any usual function calling stack adjustments. */
2129 (currently_stepping (ecs)
2130 && prev_pc != stop_pc - DECR_PC_AFTER_BREAK
2132 && INNER_THAN (read_sp (), (step_sp - 16))))
2134 /* Following in case break condition called a
2136 stop_print_frame = 1;
2139 if (stop_signal == TARGET_SIGNAL_TRAP)
2141 = !(bpstat_explains_signal (stop_bpstat)
2143 || (!CALL_DUMMY_BREAKPOINT_OFFSET_P
2144 && PC_IN_CALL_DUMMY (stop_pc, read_sp (),
2145 FRAME_FP (get_current_frame ())))
2146 || (step_range_end && step_resume_breakpoint == NULL));
2151 = !(bpstat_explains_signal (stop_bpstat)
2152 /* End of a stack dummy. Some systems (e.g. Sony
2153 news) give another signal besides SIGTRAP, so
2154 check here as well as above. */
2155 || (!CALL_DUMMY_BREAKPOINT_OFFSET_P
2156 && PC_IN_CALL_DUMMY (stop_pc, read_sp (),
2157 FRAME_FP (get_current_frame ())))
2159 if (!ecs->random_signal)
2160 stop_signal = TARGET_SIGNAL_TRAP;
2164 /* When we reach this point, we've pretty much decided
2165 that the reason for stopping must've been a random
2166 (unexpected) signal. */
2169 ecs->random_signal = 1;
2170 /* If a fork, vfork or exec event was seen, then there are two
2171 possible responses we can make:
2173 1. If a catchpoint triggers for the event (ecs->random_signal == 0),
2174 then we must stop now and issue a prompt. We will resume
2175 the inferior when the user tells us to.
2176 2. If no catchpoint triggers for the event (ecs->random_signal == 1),
2177 then we must resume the inferior now and keep checking.
2179 In either case, we must take appropriate steps to "follow" the
2180 the fork/vfork/exec when the inferior is resumed. For example,
2181 if follow-fork-mode is "child", then we must detach from the
2182 parent inferior and follow the new child inferior.
2184 In either case, setting pending_follow causes the next resume()
2185 to take the appropriate following action. */
2186 process_event_stop_test:
2187 if (ecs->ws.kind == TARGET_WAITKIND_FORKED)
2189 if (ecs->random_signal) /* I.e., no catchpoint triggered for this. */
2192 stop_signal = TARGET_SIGNAL_0;
2197 else if (ecs->ws.kind == TARGET_WAITKIND_VFORKED)
2199 if (ecs->random_signal) /* I.e., no catchpoint triggered for this. */
2201 stop_signal = TARGET_SIGNAL_0;
2206 else if (ecs->ws.kind == TARGET_WAITKIND_EXECD)
2208 pending_follow.kind = ecs->ws.kind;
2209 if (ecs->random_signal) /* I.e., no catchpoint triggered for this. */
2212 stop_signal = TARGET_SIGNAL_0;
2218 /* For the program's own signals, act according to
2219 the signal handling tables. */
2221 if (ecs->random_signal)
2223 /* Signal not for debugging purposes. */
2226 stopped_by_random_signal = 1;
2228 if (signal_print[stop_signal])
2231 target_terminal_ours_for_output ();
2232 print_stop_reason (SIGNAL_RECEIVED, stop_signal);
2234 if (signal_stop[stop_signal])
2236 stop_stepping (ecs);
2239 /* If not going to stop, give terminal back
2240 if we took it away. */
2242 target_terminal_inferior ();
2244 /* Clear the signal if it should not be passed. */
2245 if (signal_program[stop_signal] == 0)
2246 stop_signal = TARGET_SIGNAL_0;
2248 /* I'm not sure whether this needs to be check_sigtramp2 or
2249 whether it could/should be keep_going.
2251 This used to jump to step_over_function if we are stepping,
2254 Suppose the user does a `next' over a function call, and while
2255 that call is in progress, the inferior receives a signal for
2256 which GDB does not stop (i.e., signal_stop[SIG] is false). In
2257 that case, when we reach this point, there is already a
2258 step-resume breakpoint established, right where it should be:
2259 immediately after the function call the user is "next"-ing
2260 over. If we call step_over_function now, two bad things
2263 - we'll create a new breakpoint, at wherever the current
2264 frame's return address happens to be. That could be
2265 anywhere, depending on what function call happens to be on
2266 the top of the stack at that point. Point is, it's probably
2267 not where we need it.
2269 - the existing step-resume breakpoint (which is at the correct
2270 address) will get orphaned: step_resume_breakpoint will point
2271 to the new breakpoint, and the old step-resume breakpoint
2272 will never be cleaned up.
2274 The old behavior was meant to help HP-UX single-step out of
2275 sigtramps. It would place the new breakpoint at prev_pc, which
2276 was certainly wrong. I don't know the details there, so fixing
2277 this probably breaks that. As with anything else, it's up to
2278 the HP-UX maintainer to furnish a fix that doesn't break other
2279 platforms. --JimB, 20 May 1999 */
2280 check_sigtramp2 (ecs);
2285 /* Handle cases caused by hitting a breakpoint. */
2287 CORE_ADDR jmp_buf_pc;
2288 struct bpstat_what what;
2290 what = bpstat_what (stop_bpstat);
2292 if (what.call_dummy)
2294 stop_stack_dummy = 1;
2296 trap_expected_after_continue = 1;
2300 switch (what.main_action)
2302 case BPSTAT_WHAT_SET_LONGJMP_RESUME:
2303 /* If we hit the breakpoint at longjmp, disable it for the
2304 duration of this command. Then, install a temporary
2305 breakpoint at the target of the jmp_buf. */
2306 disable_longjmp_breakpoint ();
2307 remove_breakpoints ();
2308 breakpoints_inserted = 0;
2309 if (!GET_LONGJMP_TARGET_P ()
2310 || !GET_LONGJMP_TARGET (&jmp_buf_pc))
2316 /* Need to blow away step-resume breakpoint, as it
2317 interferes with us */
2318 if (step_resume_breakpoint != NULL)
2320 delete_step_resume_breakpoint (&step_resume_breakpoint);
2322 /* Not sure whether we need to blow this away too, but probably
2323 it is like the step-resume breakpoint. */
2324 if (through_sigtramp_breakpoint != NULL)
2326 delete_breakpoint (through_sigtramp_breakpoint);
2327 through_sigtramp_breakpoint = NULL;
2331 /* FIXME - Need to implement nested temporary breakpoints */
2332 if (step_over_calls > 0)
2333 set_longjmp_resume_breakpoint (jmp_buf_pc,
2334 get_current_frame ());
2337 set_longjmp_resume_breakpoint (jmp_buf_pc, NULL);
2338 ecs->handling_longjmp = 1; /* FIXME */
2342 case BPSTAT_WHAT_CLEAR_LONGJMP_RESUME:
2343 case BPSTAT_WHAT_CLEAR_LONGJMP_RESUME_SINGLE:
2344 remove_breakpoints ();
2345 breakpoints_inserted = 0;
2347 /* FIXME - Need to implement nested temporary breakpoints */
2349 && (INNER_THAN (FRAME_FP (get_current_frame ()),
2350 step_frame_address)))
2352 ecs->another_trap = 1;
2357 disable_longjmp_breakpoint ();
2358 ecs->handling_longjmp = 0; /* FIXME */
2359 if (what.main_action == BPSTAT_WHAT_CLEAR_LONGJMP_RESUME)
2361 /* else fallthrough */
2363 case BPSTAT_WHAT_SINGLE:
2364 if (breakpoints_inserted)
2366 remove_breakpoints ();
2368 breakpoints_inserted = 0;
2369 ecs->another_trap = 1;
2370 /* Still need to check other stuff, at least the case
2371 where we are stepping and step out of the right range. */
2374 case BPSTAT_WHAT_STOP_NOISY:
2375 stop_print_frame = 1;
2377 /* We are about to nuke the step_resume_breakpoint and
2378 through_sigtramp_breakpoint via the cleanup chain, so
2379 no need to worry about it here. */
2381 stop_stepping (ecs);
2384 case BPSTAT_WHAT_STOP_SILENT:
2385 stop_print_frame = 0;
2387 /* We are about to nuke the step_resume_breakpoint and
2388 through_sigtramp_breakpoint via the cleanup chain, so
2389 no need to worry about it here. */
2391 stop_stepping (ecs);
2394 case BPSTAT_WHAT_STEP_RESUME:
2395 /* This proably demands a more elegant solution, but, yeah
2398 This function's use of the simple variable
2399 step_resume_breakpoint doesn't seem to accomodate
2400 simultaneously active step-resume bp's, although the
2401 breakpoint list certainly can.
2403 If we reach here and step_resume_breakpoint is already
2404 NULL, then apparently we have multiple active
2405 step-resume bp's. We'll just delete the breakpoint we
2406 stopped at, and carry on.
2408 Correction: what the code currently does is delete a
2409 step-resume bp, but it makes no effort to ensure that
2410 the one deleted is the one currently stopped at. MVS */
2412 if (step_resume_breakpoint == NULL)
2414 step_resume_breakpoint =
2415 bpstat_find_step_resume_breakpoint (stop_bpstat);
2417 delete_step_resume_breakpoint (&step_resume_breakpoint);
2420 case BPSTAT_WHAT_THROUGH_SIGTRAMP:
2421 if (through_sigtramp_breakpoint)
2422 delete_breakpoint (through_sigtramp_breakpoint);
2423 through_sigtramp_breakpoint = NULL;
2425 /* If were waiting for a trap, hitting the step_resume_break
2426 doesn't count as getting it. */
2428 ecs->another_trap = 1;
2431 case BPSTAT_WHAT_CHECK_SHLIBS:
2432 case BPSTAT_WHAT_CHECK_SHLIBS_RESUME_FROM_HOOK:
2435 /* Remove breakpoints, we eventually want to step over the
2436 shlib event breakpoint, and SOLIB_ADD might adjust
2437 breakpoint addresses via breakpoint_re_set. */
2438 if (breakpoints_inserted)
2439 remove_breakpoints ();
2440 breakpoints_inserted = 0;
2442 /* Check for any newly added shared libraries if we're
2443 supposed to be adding them automatically. Switch
2444 terminal for any messages produced by
2445 breakpoint_re_set. */
2446 target_terminal_ours_for_output ();
2447 SOLIB_ADD (NULL, 0, NULL, auto_solib_add);
2448 target_terminal_inferior ();
2450 /* Try to reenable shared library breakpoints, additional
2451 code segments in shared libraries might be mapped in now. */
2452 re_enable_breakpoints_in_shlibs ();
2454 /* If requested, stop when the dynamic linker notifies
2455 gdb of events. This allows the user to get control
2456 and place breakpoints in initializer routines for
2457 dynamically loaded objects (among other things). */
2458 if (stop_on_solib_events)
2460 stop_stepping (ecs);
2464 /* If we stopped due to an explicit catchpoint, then the
2465 (see above) call to SOLIB_ADD pulled in any symbols
2466 from a newly-loaded library, if appropriate.
2468 We do want the inferior to stop, but not where it is
2469 now, which is in the dynamic linker callback. Rather,
2470 we would like it stop in the user's program, just after
2471 the call that caused this catchpoint to trigger. That
2472 gives the user a more useful vantage from which to
2473 examine their program's state. */
2474 else if (what.main_action == BPSTAT_WHAT_CHECK_SHLIBS_RESUME_FROM_HOOK)
2476 /* ??rehrauer: If I could figure out how to get the
2477 right return PC from here, we could just set a temp
2478 breakpoint and resume. I'm not sure we can without
2479 cracking open the dld's shared libraries and sniffing
2480 their unwind tables and text/data ranges, and that's
2481 not a terribly portable notion.
2483 Until that time, we must step the inferior out of the
2484 dld callback, and also out of the dld itself (and any
2485 code or stubs in libdld.sl, such as "shl_load" and
2486 friends) until we reach non-dld code. At that point,
2487 we can stop stepping. */
2488 bpstat_get_triggered_catchpoints (stop_bpstat,
2489 &ecs->stepping_through_solib_catchpoints);
2490 ecs->stepping_through_solib_after_catch = 1;
2492 /* Be sure to lift all breakpoints, so the inferior does
2493 actually step past this point... */
2494 ecs->another_trap = 1;
2499 /* We want to step over this breakpoint, then keep going. */
2500 ecs->another_trap = 1;
2507 case BPSTAT_WHAT_LAST:
2508 /* Not a real code, but listed here to shut up gcc -Wall. */
2510 case BPSTAT_WHAT_KEEP_CHECKING:
2515 /* We come here if we hit a breakpoint but should not
2516 stop for it. Possibly we also were stepping
2517 and should stop for that. So fall through and
2518 test for stepping. But, if not stepping,
2521 /* Are we stepping to get the inferior out of the dynamic
2522 linker's hook (and possibly the dld itself) after catching
2524 if (ecs->stepping_through_solib_after_catch)
2526 #if defined(SOLIB_ADD)
2527 /* Have we reached our destination? If not, keep going. */
2528 if (SOLIB_IN_DYNAMIC_LINKER (PIDGET (ecs->ptid), stop_pc))
2530 ecs->another_trap = 1;
2535 /* Else, stop and report the catchpoint(s) whose triggering
2536 caused us to begin stepping. */
2537 ecs->stepping_through_solib_after_catch = 0;
2538 bpstat_clear (&stop_bpstat);
2539 stop_bpstat = bpstat_copy (ecs->stepping_through_solib_catchpoints);
2540 bpstat_clear (&ecs->stepping_through_solib_catchpoints);
2541 stop_print_frame = 1;
2542 stop_stepping (ecs);
2546 if (!CALL_DUMMY_BREAKPOINT_OFFSET_P)
2548 /* This is the old way of detecting the end of the stack dummy.
2549 An architecture which defines CALL_DUMMY_BREAKPOINT_OFFSET gets
2550 handled above. As soon as we can test it on all of them, all
2551 architectures should define it. */
2553 /* If this is the breakpoint at the end of a stack dummy,
2554 just stop silently, unless the user was doing an si/ni, in which
2555 case she'd better know what she's doing. */
2557 if (CALL_DUMMY_HAS_COMPLETED (stop_pc, read_sp (),
2558 FRAME_FP (get_current_frame ()))
2561 stop_print_frame = 0;
2562 stop_stack_dummy = 1;
2564 trap_expected_after_continue = 1;
2566 stop_stepping (ecs);
2571 if (step_resume_breakpoint)
2573 /* Having a step-resume breakpoint overrides anything
2574 else having to do with stepping commands until
2575 that breakpoint is reached. */
2576 /* I'm not sure whether this needs to be check_sigtramp2 or
2577 whether it could/should be keep_going. */
2578 check_sigtramp2 (ecs);
2583 if (step_range_end == 0)
2585 /* Likewise if we aren't even stepping. */
2586 /* I'm not sure whether this needs to be check_sigtramp2 or
2587 whether it could/should be keep_going. */
2588 check_sigtramp2 (ecs);
2593 /* If stepping through a line, keep going if still within it.
2595 Note that step_range_end is the address of the first instruction
2596 beyond the step range, and NOT the address of the last instruction
2598 if (stop_pc >= step_range_start
2599 && stop_pc < step_range_end)
2601 /* We might be doing a BPSTAT_WHAT_SINGLE and getting a signal.
2602 So definately need to check for sigtramp here. */
2603 check_sigtramp2 (ecs);
2608 /* We stepped out of the stepping range. */
2610 /* If we are stepping at the source level and entered the runtime
2611 loader dynamic symbol resolution code, we keep on single stepping
2612 until we exit the run time loader code and reach the callee's
2614 if (step_over_calls == STEP_OVER_UNDEBUGGABLE && IN_SOLIB_DYNSYM_RESOLVE_CODE (stop_pc))
2616 CORE_ADDR pc_after_resolver = SKIP_SOLIB_RESOLVER (stop_pc);
2618 if (pc_after_resolver)
2620 /* Set up a step-resume breakpoint at the address
2621 indicated by SKIP_SOLIB_RESOLVER. */
2622 struct symtab_and_line sr_sal;
2624 sr_sal.pc = pc_after_resolver;
2626 check_for_old_step_resume_breakpoint ();
2627 step_resume_breakpoint =
2628 set_momentary_breakpoint (sr_sal, NULL, bp_step_resume);
2629 if (breakpoints_inserted)
2630 insert_breakpoints ();
2637 /* We can't update step_sp every time through the loop, because
2638 reading the stack pointer would slow down stepping too much.
2639 But we can update it every time we leave the step range. */
2640 ecs->update_step_sp = 1;
2642 /* Did we just take a signal? */
2643 if (PC_IN_SIGTRAMP (stop_pc, ecs->stop_func_name)
2644 && !PC_IN_SIGTRAMP (prev_pc, prev_func_name)
2645 && INNER_THAN (read_sp (), step_sp))
2647 /* We've just taken a signal; go until we are back to
2648 the point where we took it and one more. */
2650 /* Note: The test above succeeds not only when we stepped
2651 into a signal handler, but also when we step past the last
2652 statement of a signal handler and end up in the return stub
2653 of the signal handler trampoline. To distinguish between
2654 these two cases, check that the frame is INNER_THAN the
2655 previous one below. pai/1997-09-11 */
2659 CORE_ADDR current_frame = FRAME_FP (get_current_frame ());
2661 if (INNER_THAN (current_frame, step_frame_address))
2663 /* We have just taken a signal; go until we are back to
2664 the point where we took it and one more. */
2666 /* This code is needed at least in the following case:
2667 The user types "next" and then a signal arrives (before
2668 the "next" is done). */
2670 /* Note that if we are stopped at a breakpoint, then we need
2671 the step_resume breakpoint to override any breakpoints at
2672 the same location, so that we will still step over the
2673 breakpoint even though the signal happened. */
2674 struct symtab_and_line sr_sal;
2677 sr_sal.symtab = NULL;
2679 sr_sal.pc = prev_pc;
2680 /* We could probably be setting the frame to
2681 step_frame_address; I don't think anyone thought to
2683 check_for_old_step_resume_breakpoint ();
2684 step_resume_breakpoint =
2685 set_momentary_breakpoint (sr_sal, NULL, bp_step_resume);
2686 if (breakpoints_inserted)
2687 insert_breakpoints ();
2691 /* We just stepped out of a signal handler and into
2692 its calling trampoline.
2694 Normally, we'd call step_over_function from
2695 here, but for some reason GDB can't unwind the
2696 stack correctly to find the real PC for the point
2697 user code where the signal trampoline will return
2698 -- FRAME_SAVED_PC fails, at least on HP-UX 10.20.
2699 But signal trampolines are pretty small stubs of
2700 code, anyway, so it's OK instead to just
2701 single-step out. Note: assuming such trampolines
2702 don't exhibit recursion on any platform... */
2703 find_pc_partial_function (stop_pc, &ecs->stop_func_name,
2704 &ecs->stop_func_start,
2705 &ecs->stop_func_end);
2706 /* Readjust stepping range */
2707 step_range_start = ecs->stop_func_start;
2708 step_range_end = ecs->stop_func_end;
2709 ecs->stepping_through_sigtramp = 1;
2714 /* If this is stepi or nexti, make sure that the stepping range
2715 gets us past that instruction. */
2716 if (step_range_end == 1)
2717 /* FIXME: Does this run afoul of the code below which, if
2718 we step into the middle of a line, resets the stepping
2720 step_range_end = (step_range_start = prev_pc) + 1;
2722 ecs->remove_breakpoints_on_following_step = 1;
2727 if (stop_pc == ecs->stop_func_start /* Quick test */
2728 || (in_prologue (stop_pc, ecs->stop_func_start) &&
2729 !IN_SOLIB_RETURN_TRAMPOLINE (stop_pc, ecs->stop_func_name))
2730 || IN_SOLIB_CALL_TRAMPOLINE (stop_pc, ecs->stop_func_name)
2731 || ecs->stop_func_name == 0)
2733 /* It's a subroutine call. */
2735 if ((step_over_calls == STEP_OVER_NONE)
2736 || ((step_range_end == 1)
2737 && in_prologue (prev_pc, ecs->stop_func_start)))
2739 /* I presume that step_over_calls is only 0 when we're
2740 supposed to be stepping at the assembly language level
2741 ("stepi"). Just stop. */
2742 /* Also, maybe we just did a "nexti" inside a prolog,
2743 so we thought it was a subroutine call but it was not.
2744 Stop as well. FENN */
2746 print_stop_reason (END_STEPPING_RANGE, 0);
2747 stop_stepping (ecs);
2751 if (step_over_calls == STEP_OVER_ALL || IGNORE_HELPER_CALL (stop_pc))
2753 /* We're doing a "next". */
2755 if (PC_IN_SIGTRAMP (stop_pc, ecs->stop_func_name)
2756 && INNER_THAN (step_frame_address, read_sp()))
2757 /* We stepped out of a signal handler, and into its
2758 calling trampoline. This is misdetected as a
2759 subroutine call, but stepping over the signal
2760 trampoline isn't such a bad idea. In order to do
2761 that, we have to ignore the value in
2762 step_frame_address, since that doesn't represent the
2763 frame that'll reach when we return from the signal
2764 trampoline. Otherwise we'll probably continue to the
2765 end of the program. */
2766 step_frame_address = 0;
2768 step_over_function (ecs);
2773 /* If we are in a function call trampoline (a stub between
2774 the calling routine and the real function), locate the real
2775 function. That's what tells us (a) whether we want to step
2776 into it at all, and (b) what prologue we want to run to
2777 the end of, if we do step into it. */
2778 tmp = SKIP_TRAMPOLINE_CODE (stop_pc);
2780 ecs->stop_func_start = tmp;
2783 tmp = DYNAMIC_TRAMPOLINE_NEXTPC (stop_pc);
2786 struct symtab_and_line xxx;
2787 /* Why isn't this s_a_l called "sr_sal", like all of the
2788 other s_a_l's where this code is duplicated? */
2789 INIT_SAL (&xxx); /* initialize to zeroes */
2791 xxx.section = find_pc_overlay (xxx.pc);
2792 check_for_old_step_resume_breakpoint ();
2793 step_resume_breakpoint =
2794 set_momentary_breakpoint (xxx, NULL, bp_step_resume);
2795 insert_breakpoints ();
2801 /* If we have line number information for the function we
2802 are thinking of stepping into, step into it.
2804 If there are several symtabs at that PC (e.g. with include
2805 files), just want to know whether *any* of them have line
2806 numbers. find_pc_line handles this. */
2808 struct symtab_and_line tmp_sal;
2810 tmp_sal = find_pc_line (ecs->stop_func_start, 0);
2811 if (tmp_sal.line != 0)
2813 step_into_function (ecs);
2818 /* If we have no line number and the step-stop-if-no-debug
2819 is set, we stop the step so that the user has a chance to
2820 switch in assembly mode. */
2821 if (step_over_calls == STEP_OVER_UNDEBUGGABLE && step_stop_if_no_debug)
2824 print_stop_reason (END_STEPPING_RANGE, 0);
2825 stop_stepping (ecs);
2829 step_over_function (ecs);
2835 /* We've wandered out of the step range. */
2837 ecs->sal = find_pc_line (stop_pc, 0);
2839 if (step_range_end == 1)
2841 /* It is stepi or nexti. We always want to stop stepping after
2844 print_stop_reason (END_STEPPING_RANGE, 0);
2845 stop_stepping (ecs);
2849 /* If we're in the return path from a shared library trampoline,
2850 we want to proceed through the trampoline when stepping. */
2851 if (IN_SOLIB_RETURN_TRAMPOLINE (stop_pc, ecs->stop_func_name))
2855 /* Determine where this trampoline returns. */
2856 tmp = SKIP_TRAMPOLINE_CODE (stop_pc);
2858 /* Only proceed through if we know where it's going. */
2861 /* And put the step-breakpoint there and go until there. */
2862 struct symtab_and_line sr_sal;
2864 INIT_SAL (&sr_sal); /* initialize to zeroes */
2866 sr_sal.section = find_pc_overlay (sr_sal.pc);
2867 /* Do not specify what the fp should be when we stop
2868 since on some machines the prologue
2869 is where the new fp value is established. */
2870 check_for_old_step_resume_breakpoint ();
2871 step_resume_breakpoint =
2872 set_momentary_breakpoint (sr_sal, NULL, bp_step_resume);
2873 if (breakpoints_inserted)
2874 insert_breakpoints ();
2876 /* Restart without fiddling with the step ranges or
2883 if (ecs->sal.line == 0)
2885 /* We have no line number information. That means to stop
2886 stepping (does this always happen right after one instruction,
2887 when we do "s" in a function with no line numbers,
2888 or can this happen as a result of a return or longjmp?). */
2890 print_stop_reason (END_STEPPING_RANGE, 0);
2891 stop_stepping (ecs);
2895 if ((stop_pc == ecs->sal.pc)
2896 && (ecs->current_line != ecs->sal.line || ecs->current_symtab != ecs->sal.symtab))
2898 /* We are at the start of a different line. So stop. Note that
2899 we don't stop if we step into the middle of a different line.
2900 That is said to make things like for (;;) statements work
2903 print_stop_reason (END_STEPPING_RANGE, 0);
2904 stop_stepping (ecs);
2908 /* We aren't done stepping.
2910 Optimize by setting the stepping range to the line.
2911 (We might not be in the original line, but if we entered a
2912 new line in mid-statement, we continue stepping. This makes
2913 things like for(;;) statements work better.) */
2915 if (ecs->stop_func_end && ecs->sal.end >= ecs->stop_func_end)
2917 /* If this is the last line of the function, don't keep stepping
2918 (it would probably step us out of the function).
2919 This is particularly necessary for a one-line function,
2920 in which after skipping the prologue we better stop even though
2921 we will be in mid-line. */
2923 print_stop_reason (END_STEPPING_RANGE, 0);
2924 stop_stepping (ecs);
2927 step_range_start = ecs->sal.pc;
2928 step_range_end = ecs->sal.end;
2929 step_frame_address = FRAME_FP (get_current_frame ());
2930 ecs->current_line = ecs->sal.line;
2931 ecs->current_symtab = ecs->sal.symtab;
2933 /* In the case where we just stepped out of a function into the middle
2934 of a line of the caller, continue stepping, but step_frame_address
2935 must be modified to current frame */
2937 CORE_ADDR current_frame = FRAME_FP (get_current_frame ());
2938 if (!(INNER_THAN (current_frame, step_frame_address)))
2939 step_frame_address = current_frame;
2944 } /* extra brace, to preserve old indentation */
2947 /* Are we in the middle of stepping? */
2950 currently_stepping (struct execution_control_state *ecs)
2952 return ((through_sigtramp_breakpoint == NULL
2953 && !ecs->handling_longjmp
2954 && ((step_range_end && step_resume_breakpoint == NULL)
2956 || ecs->stepping_through_solib_after_catch
2957 || bpstat_should_step ());
2961 check_sigtramp2 (struct execution_control_state *ecs)
2964 && PC_IN_SIGTRAMP (stop_pc, ecs->stop_func_name)
2965 && !PC_IN_SIGTRAMP (prev_pc, prev_func_name)
2966 && INNER_THAN (read_sp (), step_sp))
2968 /* What has happened here is that we have just stepped the
2969 inferior with a signal (because it is a signal which
2970 shouldn't make us stop), thus stepping into sigtramp.
2972 So we need to set a step_resume_break_address breakpoint and
2973 continue until we hit it, and then step. FIXME: This should
2974 be more enduring than a step_resume breakpoint; we should
2975 know that we will later need to keep going rather than
2976 re-hitting the breakpoint here (see the testsuite,
2977 gdb.base/signals.exp where it says "exceedingly difficult"). */
2979 struct symtab_and_line sr_sal;
2981 INIT_SAL (&sr_sal); /* initialize to zeroes */
2982 sr_sal.pc = prev_pc;
2983 sr_sal.section = find_pc_overlay (sr_sal.pc);
2984 /* We perhaps could set the frame if we kept track of what the
2985 frame corresponding to prev_pc was. But we don't, so don't. */
2986 through_sigtramp_breakpoint =
2987 set_momentary_breakpoint (sr_sal, NULL, bp_through_sigtramp);
2988 if (breakpoints_inserted)
2989 insert_breakpoints ();
2991 ecs->remove_breakpoints_on_following_step = 1;
2992 ecs->another_trap = 1;
2996 /* Subroutine call with source code we should not step over. Do step
2997 to the first line of code in it. */
3000 step_into_function (struct execution_control_state *ecs)
3003 struct symtab_and_line sr_sal;
3005 s = find_pc_symtab (stop_pc);
3006 if (s && s->language != language_asm)
3007 ecs->stop_func_start = SKIP_PROLOGUE (ecs->stop_func_start);
3009 ecs->sal = find_pc_line (ecs->stop_func_start, 0);
3010 /* Use the step_resume_break to step until the end of the prologue,
3011 even if that involves jumps (as it seems to on the vax under
3013 /* If the prologue ends in the middle of a source line, continue to
3014 the end of that source line (if it is still within the function).
3015 Otherwise, just go to end of prologue. */
3016 #ifdef PROLOGUE_FIRSTLINE_OVERLAP
3017 /* no, don't either. It skips any code that's legitimately on the
3021 && ecs->sal.pc != ecs->stop_func_start
3022 && ecs->sal.end < ecs->stop_func_end)
3023 ecs->stop_func_start = ecs->sal.end;
3026 if (ecs->stop_func_start == stop_pc)
3028 /* We are already there: stop now. */
3030 print_stop_reason (END_STEPPING_RANGE, 0);
3031 stop_stepping (ecs);
3036 /* Put the step-breakpoint there and go until there. */
3037 INIT_SAL (&sr_sal); /* initialize to zeroes */
3038 sr_sal.pc = ecs->stop_func_start;
3039 sr_sal.section = find_pc_overlay (ecs->stop_func_start);
3040 /* Do not specify what the fp should be when we stop since on
3041 some machines the prologue is where the new fp value is
3043 check_for_old_step_resume_breakpoint ();
3044 step_resume_breakpoint =
3045 set_momentary_breakpoint (sr_sal, NULL, bp_step_resume);
3046 if (breakpoints_inserted)
3047 insert_breakpoints ();
3049 /* And make sure stepping stops right away then. */
3050 step_range_end = step_range_start;
3055 /* We've just entered a callee, and we wish to resume until it returns
3056 to the caller. Setting a step_resume breakpoint on the return
3057 address will catch a return from the callee.
3059 However, if the callee is recursing, we want to be careful not to
3060 catch returns of those recursive calls, but only of THIS instance
3063 To do this, we set the step_resume bp's frame to our current
3064 caller's frame (step_frame_address, which is set by the "next" or
3065 "until" command, before execution begins). */
3068 step_over_function (struct execution_control_state *ecs)
3070 struct symtab_and_line sr_sal;
3072 INIT_SAL (&sr_sal); /* initialize to zeros */
3073 sr_sal.pc = ADDR_BITS_REMOVE (SAVED_PC_AFTER_CALL (get_current_frame ()));
3074 sr_sal.section = find_pc_overlay (sr_sal.pc);
3076 check_for_old_step_resume_breakpoint ();
3077 step_resume_breakpoint =
3078 set_momentary_breakpoint (sr_sal, get_current_frame (), bp_step_resume);
3080 if (step_frame_address && !IN_SOLIB_DYNSYM_RESOLVE_CODE (sr_sal.pc))
3081 step_resume_breakpoint->frame = step_frame_address;
3083 if (breakpoints_inserted)
3084 insert_breakpoints ();
3088 stop_stepping (struct execution_control_state *ecs)
3090 if (target_has_execution)
3092 /* Are we stopping for a vfork event? We only stop when we see
3093 the child's event. However, we may not yet have seen the
3094 parent's event. And, inferior_ptid is still set to the
3095 parent's pid, until we resume again and follow either the
3098 To ensure that we can really touch inferior_ptid (aka, the
3099 parent process) -- which calls to functions like read_pc
3100 implicitly do -- wait on the parent if necessary. */
3101 if ((pending_follow.kind == TARGET_WAITKIND_VFORKED)
3102 && !pending_follow.fork_event.saw_parent_fork)
3108 if (target_wait_hook)
3109 parent_ptid = target_wait_hook (pid_to_ptid (-1), &(ecs->ws));
3111 parent_ptid = target_wait (pid_to_ptid (-1), &(ecs->ws));
3113 while (! ptid_equal (parent_ptid, inferior_ptid));
3116 /* Assuming the inferior still exists, set these up for next
3117 time, just like we did above if we didn't break out of the
3119 prev_pc = read_pc ();
3120 prev_func_start = ecs->stop_func_start;
3121 prev_func_name = ecs->stop_func_name;
3124 /* Let callers know we don't want to wait for the inferior anymore. */
3125 ecs->wait_some_more = 0;
3128 /* This function handles various cases where we need to continue
3129 waiting for the inferior. */
3130 /* (Used to be the keep_going: label in the old wait_for_inferior) */
3133 keep_going (struct execution_control_state *ecs)
3135 /* ??rehrauer: ttrace on HP-UX theoretically allows one to debug a
3136 vforked child between its creation and subsequent exit or call to
3137 exec(). However, I had big problems in this rather creaky exec
3138 engine, getting that to work. The fundamental problem is that
3139 I'm trying to debug two processes via an engine that only
3140 understands a single process with possibly multiple threads.
3142 Hence, this spot is known to have problems when
3143 target_can_follow_vfork_prior_to_exec returns 1. */
3145 /* Save the pc before execution, to compare with pc after stop. */
3146 prev_pc = read_pc (); /* Might have been DECR_AFTER_BREAK */
3147 prev_func_start = ecs->stop_func_start; /* Ok, since if DECR_PC_AFTER
3148 BREAK is defined, the
3149 original pc would not have
3150 been at the start of a
3152 prev_func_name = ecs->stop_func_name;
3154 if (ecs->update_step_sp)
3155 step_sp = read_sp ();
3156 ecs->update_step_sp = 0;
3158 /* If we did not do break;, it means we should keep running the
3159 inferior and not return to debugger. */
3161 if (trap_expected && stop_signal != TARGET_SIGNAL_TRAP)
3163 /* We took a signal (which we are supposed to pass through to
3164 the inferior, else we'd have done a break above) and we
3165 haven't yet gotten our trap. Simply continue. */
3166 resume (currently_stepping (ecs), stop_signal);
3170 /* Either the trap was not expected, but we are continuing
3171 anyway (the user asked that this signal be passed to the
3174 The signal was SIGTRAP, e.g. it was our signal, but we
3175 decided we should resume from it.
3177 We're going to run this baby now!
3179 Insert breakpoints now, unless we are trying to one-proceed
3180 past a breakpoint. */
3181 /* If we've just finished a special step resume and we don't
3182 want to hit a breakpoint, pull em out. */
3183 if (step_resume_breakpoint == NULL
3184 && through_sigtramp_breakpoint == NULL
3185 && ecs->remove_breakpoints_on_following_step)
3187 ecs->remove_breakpoints_on_following_step = 0;
3188 remove_breakpoints ();
3189 breakpoints_inserted = 0;
3191 else if (!breakpoints_inserted &&
3192 (through_sigtramp_breakpoint != NULL || !ecs->another_trap))
3194 breakpoints_failed = insert_breakpoints ();
3195 if (breakpoints_failed)
3197 stop_stepping (ecs);
3200 breakpoints_inserted = 1;
3203 trap_expected = ecs->another_trap;
3205 /* Do not deliver SIGNAL_TRAP (except when the user explicitly
3206 specifies that such a signal should be delivered to the
3209 Typically, this would occure when a user is debugging a
3210 target monitor on a simulator: the target monitor sets a
3211 breakpoint; the simulator encounters this break-point and
3212 halts the simulation handing control to GDB; GDB, noteing
3213 that the break-point isn't valid, returns control back to the
3214 simulator; the simulator then delivers the hardware
3215 equivalent of a SIGNAL_TRAP to the program being debugged. */
3217 if (stop_signal == TARGET_SIGNAL_TRAP
3218 && !signal_program[stop_signal])
3219 stop_signal = TARGET_SIGNAL_0;
3221 #ifdef SHIFT_INST_REGS
3222 /* I'm not sure when this following segment applies. I do know,
3223 now, that we shouldn't rewrite the regs when we were stopped
3224 by a random signal from the inferior process. */
3225 /* FIXME: Shouldn't this be based on the valid bit of the SXIP?
3226 (this is only used on the 88k). */
3228 if (!bpstat_explains_signal (stop_bpstat)
3229 && (stop_signal != TARGET_SIGNAL_CHLD)
3230 && !stopped_by_random_signal)
3232 #endif /* SHIFT_INST_REGS */
3234 resume (currently_stepping (ecs), stop_signal);
3237 prepare_to_wait (ecs);
3240 /* This function normally comes after a resume, before
3241 handle_inferior_event exits. It takes care of any last bits of
3242 housekeeping, and sets the all-important wait_some_more flag. */
3245 prepare_to_wait (struct execution_control_state *ecs)
3247 if (ecs->infwait_state == infwait_normal_state)
3249 overlay_cache_invalid = 1;
3251 /* We have to invalidate the registers BEFORE calling
3252 target_wait because they can be loaded from the target while
3253 in target_wait. This makes remote debugging a bit more
3254 efficient for those targets that provide critical registers
3255 as part of their normal status mechanism. */
3257 registers_changed ();
3258 ecs->waiton_ptid = pid_to_ptid (-1);
3259 ecs->wp = &(ecs->ws);
3261 /* This is the old end of the while loop. Let everybody know we
3262 want to wait for the inferior some more and get called again
3264 ecs->wait_some_more = 1;
3267 /* Print why the inferior has stopped. We always print something when
3268 the inferior exits, or receives a signal. The rest of the cases are
3269 dealt with later on in normal_stop() and print_it_typical(). Ideally
3270 there should be a call to this function from handle_inferior_event()
3271 each time stop_stepping() is called.*/
3273 print_stop_reason (enum inferior_stop_reason stop_reason, int stop_info)
3275 switch (stop_reason)
3278 /* We don't deal with these cases from handle_inferior_event()
3281 case END_STEPPING_RANGE:
3282 /* We are done with a step/next/si/ni command. */
3283 /* For now print nothing. */
3284 /* Print a message only if not in the middle of doing a "step n"
3285 operation for n > 1 */
3286 if (!step_multi || !stop_step)
3287 if (ui_out_is_mi_like_p (uiout))
3288 ui_out_field_string (uiout, "reason", "end-stepping-range");
3290 case BREAKPOINT_HIT:
3291 /* We found a breakpoint. */
3292 /* For now print nothing. */
3295 /* The inferior was terminated by a signal. */
3296 annotate_signalled ();
3297 if (ui_out_is_mi_like_p (uiout))
3298 ui_out_field_string (uiout, "reason", "exited-signalled");
3299 ui_out_text (uiout, "\nProgram terminated with signal ");
3300 annotate_signal_name ();
3301 ui_out_field_string (uiout, "signal-name", target_signal_to_name (stop_info));
3302 annotate_signal_name_end ();
3303 ui_out_text (uiout, ", ");
3304 annotate_signal_string ();
3305 ui_out_field_string (uiout, "signal-meaning", target_signal_to_string (stop_info));
3306 annotate_signal_string_end ();
3307 ui_out_text (uiout, ".\n");
3308 ui_out_text (uiout, "The program no longer exists.\n");
3311 /* The inferior program is finished. */
3312 annotate_exited (stop_info);
3315 if (ui_out_is_mi_like_p (uiout))
3316 ui_out_field_string (uiout, "reason", "exited");
3317 ui_out_text (uiout, "\nProgram exited with code ");
3318 ui_out_field_fmt (uiout, "exit-code", "0%o", (unsigned int) stop_info);
3319 ui_out_text (uiout, ".\n");
3323 if (ui_out_is_mi_like_p (uiout))
3324 ui_out_field_string (uiout, "reason", "exited-normally");
3325 ui_out_text (uiout, "\nProgram exited normally.\n");
3328 case SIGNAL_RECEIVED:
3329 /* Signal received. The signal table tells us to print about
3332 ui_out_text (uiout, "\nProgram received signal ");
3333 annotate_signal_name ();
3334 if (ui_out_is_mi_like_p (uiout))
3335 ui_out_field_string (uiout, "reason", "signal-received");
3336 ui_out_field_string (uiout, "signal-name", target_signal_to_name (stop_info));
3337 annotate_signal_name_end ();
3338 ui_out_text (uiout, ", ");
3339 annotate_signal_string ();
3340 ui_out_field_string (uiout, "signal-meaning", target_signal_to_string (stop_info));
3341 annotate_signal_string_end ();
3342 ui_out_text (uiout, ".\n");
3345 internal_error (__FILE__, __LINE__,
3346 "print_stop_reason: unrecognized enum value");
3352 /* Here to return control to GDB when the inferior stops for real.
3353 Print appropriate messages, remove breakpoints, give terminal our modes.
3355 STOP_PRINT_FRAME nonzero means print the executing frame
3356 (pc, function, args, file, line number and line text).
3357 BREAKPOINTS_FAILED nonzero means stop was due to error
3358 attempting to insert breakpoints. */
3363 /* As with the notification of thread events, we want to delay
3364 notifying the user that we've switched thread context until
3365 the inferior actually stops.
3367 (Note that there's no point in saying anything if the inferior
3369 if (! ptid_equal (previous_inferior_ptid, inferior_ptid)
3370 && target_has_execution)
3372 target_terminal_ours_for_output ();
3373 printf_filtered ("[Switching to %s]\n",
3374 target_pid_or_tid_to_str (inferior_ptid));
3375 previous_inferior_ptid = inferior_ptid;
3378 /* Make sure that the current_frame's pc is correct. This
3379 is a correction for setting up the frame info before doing
3380 DECR_PC_AFTER_BREAK */
3381 if (target_has_execution && get_current_frame ())
3382 (get_current_frame ())->pc = read_pc ();
3384 if (breakpoints_failed)
3386 target_terminal_ours_for_output ();
3387 print_sys_errmsg ("While inserting breakpoints", breakpoints_failed);
3388 printf_filtered ("Stopped; cannot insert breakpoints.\n\
3389 The same program may be running in another process,\n\
3390 or you may have requested too many hardware breakpoints\n\
3391 and/or watchpoints.\n");
3394 if (target_has_execution && breakpoints_inserted)
3396 if (remove_breakpoints ())
3398 target_terminal_ours_for_output ();
3399 printf_filtered ("Cannot remove breakpoints because ");
3400 printf_filtered ("program is no longer writable.\n");
3401 printf_filtered ("It might be running in another process.\n");
3402 printf_filtered ("Further execution is probably impossible.\n");
3405 breakpoints_inserted = 0;
3407 /* Delete the breakpoint we stopped at, if it wants to be deleted.
3408 Delete any breakpoint that is to be deleted at the next stop. */
3410 breakpoint_auto_delete (stop_bpstat);
3412 /* If an auto-display called a function and that got a signal,
3413 delete that auto-display to avoid an infinite recursion. */
3415 if (stopped_by_random_signal)
3416 disable_current_display ();
3418 /* Don't print a message if in the middle of doing a "step n"
3419 operation for n > 1 */
3420 if (step_multi && stop_step)
3423 target_terminal_ours ();
3425 /* Look up the hook_stop and run it (CLI internally handles problem
3426 of stop_command's pre-hook not existing). */
3428 catch_errors (hook_stop_stub, stop_command,
3429 "Error while running hook_stop:\n", RETURN_MASK_ALL);
3431 if (!target_has_stack)
3437 /* Select innermost stack frame - i.e., current frame is frame 0,
3438 and current location is based on that.
3439 Don't do this on return from a stack dummy routine,
3440 or if the program has exited. */
3442 if (!stop_stack_dummy)
3444 select_frame (get_current_frame ());
3446 /* Print current location without a level number, if
3447 we have changed functions or hit a breakpoint.
3448 Print source line if we have one.
3449 bpstat_print() contains the logic deciding in detail
3450 what to print, based on the event(s) that just occurred. */
3452 if (stop_print_frame
3457 int do_frame_printing = 1;
3459 bpstat_ret = bpstat_print (stop_bpstat);
3464 && step_frame_address == FRAME_FP (get_current_frame ())
3465 && step_start_function == find_pc_function (stop_pc))
3466 source_flag = SRC_LINE; /* finished step, just print source line */
3468 source_flag = SRC_AND_LOC; /* print location and source line */
3470 case PRINT_SRC_AND_LOC:
3471 source_flag = SRC_AND_LOC; /* print location and source line */
3473 case PRINT_SRC_ONLY:
3474 source_flag = SRC_LINE;
3477 source_flag = SRC_LINE; /* something bogus */
3478 do_frame_printing = 0;
3481 internal_error (__FILE__, __LINE__,
3484 /* For mi, have the same behavior every time we stop:
3485 print everything but the source line. */
3486 if (ui_out_is_mi_like_p (uiout))
3487 source_flag = LOC_AND_ADDRESS;
3489 if (ui_out_is_mi_like_p (uiout))
3490 ui_out_field_int (uiout, "thread-id",
3491 pid_to_thread_id (inferior_ptid));
3492 /* The behavior of this routine with respect to the source
3494 SRC_LINE: Print only source line
3495 LOCATION: Print only location
3496 SRC_AND_LOC: Print location and source line */
3497 if (do_frame_printing)
3498 show_and_print_stack_frame (selected_frame, -1, source_flag);
3500 /* Display the auto-display expressions. */
3505 /* Save the function value return registers, if we care.
3506 We might be about to restore their previous contents. */
3507 if (proceed_to_finish)
3508 read_register_bytes (0, stop_registers, REGISTER_BYTES);
3510 if (stop_stack_dummy)
3512 /* Pop the empty frame that contains the stack dummy.
3513 POP_FRAME ends with a setting of the current frame, so we
3514 can use that next. */
3516 /* Set stop_pc to what it was before we called the function.
3517 Can't rely on restore_inferior_status because that only gets
3518 called if we don't stop in the called function. */
3519 stop_pc = read_pc ();
3520 select_frame (get_current_frame ());
3524 annotate_stopped ();
3528 hook_stop_stub (void *cmd)
3530 execute_cmd_pre_hook ((struct cmd_list_element *) cmd);
3535 signal_stop_state (int signo)
3537 return signal_stop[signo];
3541 signal_print_state (int signo)
3543 return signal_print[signo];
3547 signal_pass_state (int signo)
3549 return signal_program[signo];
3552 int signal_stop_update (signo, state)
3556 int ret = signal_stop[signo];
3557 signal_stop[signo] = state;
3561 int signal_print_update (signo, state)
3565 int ret = signal_print[signo];
3566 signal_print[signo] = state;
3570 int signal_pass_update (signo, state)
3574 int ret = signal_program[signo];
3575 signal_program[signo] = state;
3580 sig_print_header (void)
3583 Signal Stop\tPrint\tPass to program\tDescription\n");
3587 sig_print_info (enum target_signal oursig)
3589 char *name = target_signal_to_name (oursig);
3590 int name_padding = 13 - strlen (name);
3592 if (name_padding <= 0)
3595 printf_filtered ("%s", name);
3596 printf_filtered ("%*.*s ", name_padding, name_padding,
3598 printf_filtered ("%s\t", signal_stop[oursig] ? "Yes" : "No");
3599 printf_filtered ("%s\t", signal_print[oursig] ? "Yes" : "No");
3600 printf_filtered ("%s\t\t", signal_program[oursig] ? "Yes" : "No");
3601 printf_filtered ("%s\n", target_signal_to_string (oursig));
3604 /* Specify how various signals in the inferior should be handled. */
3607 handle_command (char *args, int from_tty)
3610 int digits, wordlen;
3611 int sigfirst, signum, siglast;
3612 enum target_signal oursig;
3615 unsigned char *sigs;
3616 struct cleanup *old_chain;
3620 error_no_arg ("signal to handle");
3623 /* Allocate and zero an array of flags for which signals to handle. */
3625 nsigs = (int) TARGET_SIGNAL_LAST;
3626 sigs = (unsigned char *) alloca (nsigs);
3627 memset (sigs, 0, nsigs);
3629 /* Break the command line up into args. */
3631 argv = buildargv (args);
3636 old_chain = make_cleanup_freeargv (argv);
3638 /* Walk through the args, looking for signal oursigs, signal names, and
3639 actions. Signal numbers and signal names may be interspersed with
3640 actions, with the actions being performed for all signals cumulatively
3641 specified. Signal ranges can be specified as <LOW>-<HIGH>. */
3643 while (*argv != NULL)
3645 wordlen = strlen (*argv);
3646 for (digits = 0; isdigit ((*argv)[digits]); digits++)
3650 sigfirst = siglast = -1;
3652 if (wordlen >= 1 && !strncmp (*argv, "all", wordlen))
3654 /* Apply action to all signals except those used by the
3655 debugger. Silently skip those. */
3658 siglast = nsigs - 1;
3660 else if (wordlen >= 1 && !strncmp (*argv, "stop", wordlen))
3662 SET_SIGS (nsigs, sigs, signal_stop);
3663 SET_SIGS (nsigs, sigs, signal_print);
3665 else if (wordlen >= 1 && !strncmp (*argv, "ignore", wordlen))
3667 UNSET_SIGS (nsigs, sigs, signal_program);
3669 else if (wordlen >= 2 && !strncmp (*argv, "print", wordlen))
3671 SET_SIGS (nsigs, sigs, signal_print);
3673 else if (wordlen >= 2 && !strncmp (*argv, "pass", wordlen))
3675 SET_SIGS (nsigs, sigs, signal_program);
3677 else if (wordlen >= 3 && !strncmp (*argv, "nostop", wordlen))
3679 UNSET_SIGS (nsigs, sigs, signal_stop);
3681 else if (wordlen >= 3 && !strncmp (*argv, "noignore", wordlen))
3683 SET_SIGS (nsigs, sigs, signal_program);
3685 else if (wordlen >= 4 && !strncmp (*argv, "noprint", wordlen))
3687 UNSET_SIGS (nsigs, sigs, signal_print);
3688 UNSET_SIGS (nsigs, sigs, signal_stop);
3690 else if (wordlen >= 4 && !strncmp (*argv, "nopass", wordlen))
3692 UNSET_SIGS (nsigs, sigs, signal_program);
3694 else if (digits > 0)
3696 /* It is numeric. The numeric signal refers to our own
3697 internal signal numbering from target.h, not to host/target
3698 signal number. This is a feature; users really should be
3699 using symbolic names anyway, and the common ones like
3700 SIGHUP, SIGINT, SIGALRM, etc. will work right anyway. */
3702 sigfirst = siglast = (int)
3703 target_signal_from_command (atoi (*argv));
3704 if ((*argv)[digits] == '-')
3707 target_signal_from_command (atoi ((*argv) + digits + 1));
3709 if (sigfirst > siglast)
3711 /* Bet he didn't figure we'd think of this case... */
3719 oursig = target_signal_from_name (*argv);
3720 if (oursig != TARGET_SIGNAL_UNKNOWN)
3722 sigfirst = siglast = (int) oursig;
3726 /* Not a number and not a recognized flag word => complain. */
3727 error ("Unrecognized or ambiguous flag word: \"%s\".", *argv);
3731 /* If any signal numbers or symbol names were found, set flags for
3732 which signals to apply actions to. */
3734 for (signum = sigfirst; signum >= 0 && signum <= siglast; signum++)
3736 switch ((enum target_signal) signum)
3738 case TARGET_SIGNAL_TRAP:
3739 case TARGET_SIGNAL_INT:
3740 if (!allsigs && !sigs[signum])
3742 if (query ("%s is used by the debugger.\n\
3743 Are you sure you want to change it? ",
3744 target_signal_to_name
3745 ((enum target_signal) signum)))
3751 printf_unfiltered ("Not confirmed, unchanged.\n");
3752 gdb_flush (gdb_stdout);
3756 case TARGET_SIGNAL_0:
3757 case TARGET_SIGNAL_DEFAULT:
3758 case TARGET_SIGNAL_UNKNOWN:
3759 /* Make sure that "all" doesn't print these. */
3770 target_notice_signals (inferior_ptid);
3774 /* Show the results. */
3775 sig_print_header ();
3776 for (signum = 0; signum < nsigs; signum++)
3780 sig_print_info (signum);
3785 do_cleanups (old_chain);
3789 xdb_handle_command (char *args, int from_tty)
3792 struct cleanup *old_chain;
3794 /* Break the command line up into args. */
3796 argv = buildargv (args);
3801 old_chain = make_cleanup_freeargv (argv);
3802 if (argv[1] != (char *) NULL)
3807 bufLen = strlen (argv[0]) + 20;
3808 argBuf = (char *) xmalloc (bufLen);
3812 enum target_signal oursig;
3814 oursig = target_signal_from_name (argv[0]);
3815 memset (argBuf, 0, bufLen);
3816 if (strcmp (argv[1], "Q") == 0)
3817 sprintf (argBuf, "%s %s", argv[0], "noprint");
3820 if (strcmp (argv[1], "s") == 0)
3822 if (!signal_stop[oursig])
3823 sprintf (argBuf, "%s %s", argv[0], "stop");
3825 sprintf (argBuf, "%s %s", argv[0], "nostop");
3827 else if (strcmp (argv[1], "i") == 0)
3829 if (!signal_program[oursig])
3830 sprintf (argBuf, "%s %s", argv[0], "pass");
3832 sprintf (argBuf, "%s %s", argv[0], "nopass");
3834 else if (strcmp (argv[1], "r") == 0)
3836 if (!signal_print[oursig])
3837 sprintf (argBuf, "%s %s", argv[0], "print");
3839 sprintf (argBuf, "%s %s", argv[0], "noprint");
3845 handle_command (argBuf, from_tty);
3847 printf_filtered ("Invalid signal handling flag.\n");
3852 do_cleanups (old_chain);
3855 /* Print current contents of the tables set by the handle command.
3856 It is possible we should just be printing signals actually used
3857 by the current target (but for things to work right when switching
3858 targets, all signals should be in the signal tables). */
3861 signals_info (char *signum_exp, int from_tty)
3863 enum target_signal oursig;
3864 sig_print_header ();
3868 /* First see if this is a symbol name. */
3869 oursig = target_signal_from_name (signum_exp);
3870 if (oursig == TARGET_SIGNAL_UNKNOWN)
3872 /* No, try numeric. */
3874 target_signal_from_command (parse_and_eval_long (signum_exp));
3876 sig_print_info (oursig);
3880 printf_filtered ("\n");
3881 /* These ugly casts brought to you by the native VAX compiler. */
3882 for (oursig = TARGET_SIGNAL_FIRST;
3883 (int) oursig < (int) TARGET_SIGNAL_LAST;
3884 oursig = (enum target_signal) ((int) oursig + 1))
3888 if (oursig != TARGET_SIGNAL_UNKNOWN
3889 && oursig != TARGET_SIGNAL_DEFAULT
3890 && oursig != TARGET_SIGNAL_0)
3891 sig_print_info (oursig);
3894 printf_filtered ("\nUse the \"handle\" command to change these tables.\n");
3897 struct inferior_status
3899 enum target_signal stop_signal;
3903 int stop_stack_dummy;
3904 int stopped_by_random_signal;
3906 CORE_ADDR step_range_start;
3907 CORE_ADDR step_range_end;
3908 CORE_ADDR step_frame_address;
3909 enum step_over_calls_kind step_over_calls;
3910 CORE_ADDR step_resume_break_address;
3911 int stop_after_trap;
3912 int stop_soon_quietly;
3913 char *stop_registers;
3915 /* These are here because if call_function_by_hand has written some
3916 registers and then decides to call error(), we better not have changed
3920 /* A frame unique identifier. */
3921 struct frame_id selected_frame_id;
3923 int breakpoint_proceeded;
3924 int restore_stack_info;
3925 int proceed_to_finish;
3928 static struct inferior_status *
3929 xmalloc_inferior_status (void)
3931 struct inferior_status *inf_status;
3932 inf_status = xmalloc (sizeof (struct inferior_status));
3933 inf_status->stop_registers = xmalloc (REGISTER_BYTES);
3934 inf_status->registers = xmalloc (REGISTER_BYTES);
3939 free_inferior_status (struct inferior_status *inf_status)
3941 xfree (inf_status->registers);
3942 xfree (inf_status->stop_registers);
3947 write_inferior_status_register (struct inferior_status *inf_status, int regno,
3950 int size = REGISTER_RAW_SIZE (regno);
3951 void *buf = alloca (size);
3952 store_signed_integer (buf, size, val);
3953 memcpy (&inf_status->registers[REGISTER_BYTE (regno)], buf, size);
3956 /* Save all of the information associated with the inferior<==>gdb
3957 connection. INF_STATUS is a pointer to a "struct inferior_status"
3958 (defined in inferior.h). */
3960 struct inferior_status *
3961 save_inferior_status (int restore_stack_info)
3963 struct inferior_status *inf_status = xmalloc_inferior_status ();
3965 inf_status->stop_signal = stop_signal;
3966 inf_status->stop_pc = stop_pc;
3967 inf_status->stop_step = stop_step;
3968 inf_status->stop_stack_dummy = stop_stack_dummy;
3969 inf_status->stopped_by_random_signal = stopped_by_random_signal;
3970 inf_status->trap_expected = trap_expected;
3971 inf_status->step_range_start = step_range_start;
3972 inf_status->step_range_end = step_range_end;
3973 inf_status->step_frame_address = step_frame_address;
3974 inf_status->step_over_calls = step_over_calls;
3975 inf_status->stop_after_trap = stop_after_trap;
3976 inf_status->stop_soon_quietly = stop_soon_quietly;
3977 /* Save original bpstat chain here; replace it with copy of chain.
3978 If caller's caller is walking the chain, they'll be happier if we
3979 hand them back the original chain when restore_inferior_status is
3981 inf_status->stop_bpstat = stop_bpstat;
3982 stop_bpstat = bpstat_copy (stop_bpstat);
3983 inf_status->breakpoint_proceeded = breakpoint_proceeded;
3984 inf_status->restore_stack_info = restore_stack_info;
3985 inf_status->proceed_to_finish = proceed_to_finish;
3987 memcpy (inf_status->stop_registers, stop_registers, REGISTER_BYTES);
3989 read_register_bytes (0, inf_status->registers, REGISTER_BYTES);
3991 get_frame_id (selected_frame, &inf_status->selected_frame_id);
3996 restore_selected_frame (void *args)
3998 struct frame_id *fid = (struct frame_id *) args;
3999 struct frame_info *frame;
4001 frame = frame_find_by_id (*fid);
4003 /* If inf_status->selected_frame_address is NULL, there was no
4004 previously selected frame. */
4007 warning ("Unable to restore previously selected frame.\n");
4011 select_frame (frame);
4017 restore_inferior_status (struct inferior_status *inf_status)
4019 stop_signal = inf_status->stop_signal;
4020 stop_pc = inf_status->stop_pc;
4021 stop_step = inf_status->stop_step;
4022 stop_stack_dummy = inf_status->stop_stack_dummy;
4023 stopped_by_random_signal = inf_status->stopped_by_random_signal;
4024 trap_expected = inf_status->trap_expected;
4025 step_range_start = inf_status->step_range_start;
4026 step_range_end = inf_status->step_range_end;
4027 step_frame_address = inf_status->step_frame_address;
4028 step_over_calls = inf_status->step_over_calls;
4029 stop_after_trap = inf_status->stop_after_trap;
4030 stop_soon_quietly = inf_status->stop_soon_quietly;
4031 bpstat_clear (&stop_bpstat);
4032 stop_bpstat = inf_status->stop_bpstat;
4033 breakpoint_proceeded = inf_status->breakpoint_proceeded;
4034 proceed_to_finish = inf_status->proceed_to_finish;
4036 /* FIXME: Is the restore of stop_registers always needed */
4037 memcpy (stop_registers, inf_status->stop_registers, REGISTER_BYTES);
4039 /* The inferior can be gone if the user types "print exit(0)"
4040 (and perhaps other times). */
4041 if (target_has_execution)
4042 write_register_bytes (0, inf_status->registers, REGISTER_BYTES);
4044 /* FIXME: If we are being called after stopping in a function which
4045 is called from gdb, we should not be trying to restore the
4046 selected frame; it just prints a spurious error message (The
4047 message is useful, however, in detecting bugs in gdb (like if gdb
4048 clobbers the stack)). In fact, should we be restoring the
4049 inferior status at all in that case? . */
4051 if (target_has_stack && inf_status->restore_stack_info)
4053 /* The point of catch_errors is that if the stack is clobbered,
4054 walking the stack might encounter a garbage pointer and
4055 error() trying to dereference it. */
4056 if (catch_errors (restore_selected_frame, &inf_status->selected_frame_id,
4057 "Unable to restore previously selected frame:\n",
4058 RETURN_MASK_ERROR) == 0)
4059 /* Error in restoring the selected frame. Select the innermost
4061 select_frame (get_current_frame ());
4065 free_inferior_status (inf_status);
4069 do_restore_inferior_status_cleanup (void *sts)
4071 restore_inferior_status (sts);
4075 make_cleanup_restore_inferior_status (struct inferior_status *inf_status)
4077 return make_cleanup (do_restore_inferior_status_cleanup, inf_status);
4081 discard_inferior_status (struct inferior_status *inf_status)
4083 /* See save_inferior_status for info on stop_bpstat. */
4084 bpstat_clear (&inf_status->stop_bpstat);
4085 free_inferior_status (inf_status);
4088 /* Oft used ptids */
4090 ptid_t minus_one_ptid;
4092 /* Create a ptid given the necessary PID, LWP, and TID components. */
4095 ptid_build (int pid, long lwp, long tid)
4105 /* Create a ptid from just a pid. */
4108 pid_to_ptid (int pid)
4110 return ptid_build (pid, 0, 0);
4113 /* Fetch the pid (process id) component from a ptid. */
4116 ptid_get_pid (ptid_t ptid)
4121 /* Fetch the lwp (lightweight process) component from a ptid. */
4124 ptid_get_lwp (ptid_t ptid)
4129 /* Fetch the tid (thread id) component from a ptid. */
4132 ptid_get_tid (ptid_t ptid)
4137 /* ptid_equal() is used to test equality of two ptids. */
4140 ptid_equal (ptid_t ptid1, ptid_t ptid2)
4142 return (ptid1.pid == ptid2.pid && ptid1.lwp == ptid2.lwp
4143 && ptid1.tid == ptid2.tid);
4146 /* restore_inferior_ptid() will be used by the cleanup machinery
4147 to restore the inferior_ptid value saved in a call to
4148 save_inferior_ptid(). */
4151 restore_inferior_ptid (void *arg)
4153 ptid_t *saved_ptid_ptr = arg;
4154 inferior_ptid = *saved_ptid_ptr;
4158 /* Save the value of inferior_ptid so that it may be restored by a
4159 later call to do_cleanups(). Returns the struct cleanup pointer
4160 needed for later doing the cleanup. */
4163 save_inferior_ptid (void)
4165 ptid_t *saved_ptid_ptr;
4167 saved_ptid_ptr = xmalloc (sizeof (ptid_t));
4168 *saved_ptid_ptr = inferior_ptid;
4169 return make_cleanup (restore_inferior_ptid, saved_ptid_ptr);
4176 stop_registers = xmalloc (REGISTER_BYTES);
4180 _initialize_infrun (void)
4183 register int numsigs;
4184 struct cmd_list_element *c;
4186 register_gdbarch_swap (&stop_registers, sizeof (stop_registers), NULL);
4187 register_gdbarch_swap (NULL, 0, build_infrun);
4189 add_info ("signals", signals_info,
4190 "What debugger does when program gets various signals.\n\
4191 Specify a signal as argument to print info on that signal only.");
4192 add_info_alias ("handle", "signals", 0);
4194 add_com ("handle", class_run, handle_command,
4195 concat ("Specify how to handle a signal.\n\
4196 Args are signals and actions to apply to those signals.\n\
4197 Symbolic signals (e.g. SIGSEGV) are recommended but numeric signals\n\
4198 from 1-15 are allowed for compatibility with old versions of GDB.\n\
4199 Numeric ranges may be specified with the form LOW-HIGH (e.g. 1-5).\n\
4200 The special arg \"all\" is recognized to mean all signals except those\n\
4201 used by the debugger, typically SIGTRAP and SIGINT.\n",
4202 "Recognized actions include \"stop\", \"nostop\", \"print\", \"noprint\",\n\
4203 \"pass\", \"nopass\", \"ignore\", or \"noignore\".\n\
4204 Stop means reenter debugger if this signal happens (implies print).\n\
4205 Print means print a message if this signal happens.\n\
4206 Pass means let program see this signal; otherwise program doesn't know.\n\
4207 Ignore is a synonym for nopass and noignore is a synonym for pass.\n\
4208 Pass and Stop may be combined.", NULL));
4211 add_com ("lz", class_info, signals_info,
4212 "What debugger does when program gets various signals.\n\
4213 Specify a signal as argument to print info on that signal only.");
4214 add_com ("z", class_run, xdb_handle_command,
4215 concat ("Specify how to handle a signal.\n\
4216 Args are signals and actions to apply to those signals.\n\
4217 Symbolic signals (e.g. SIGSEGV) are recommended but numeric signals\n\
4218 from 1-15 are allowed for compatibility with old versions of GDB.\n\
4219 Numeric ranges may be specified with the form LOW-HIGH (e.g. 1-5).\n\
4220 The special arg \"all\" is recognized to mean all signals except those\n\
4221 used by the debugger, typically SIGTRAP and SIGINT.\n",
4222 "Recognized actions include \"s\" (toggles between stop and nostop), \n\
4223 \"r\" (toggles between print and noprint), \"i\" (toggles between pass and \
4224 nopass), \"Q\" (noprint)\n\
4225 Stop means reenter debugger if this signal happens (implies print).\n\
4226 Print means print a message if this signal happens.\n\
4227 Pass means let program see this signal; otherwise program doesn't know.\n\
4228 Ignore is a synonym for nopass and noignore is a synonym for pass.\n\
4229 Pass and Stop may be combined.", NULL));
4233 stop_command = add_cmd ("stop", class_obscure, not_just_help_class_command,
4234 "There is no `stop' command, but you can set a hook on `stop'.\n\
4235 This allows you to set a list of commands to be run each time execution\n\
4236 of the program stops.", &cmdlist);
4238 numsigs = (int) TARGET_SIGNAL_LAST;
4239 signal_stop = (unsigned char *)
4240 xmalloc (sizeof (signal_stop[0]) * numsigs);
4241 signal_print = (unsigned char *)
4242 xmalloc (sizeof (signal_print[0]) * numsigs);
4243 signal_program = (unsigned char *)
4244 xmalloc (sizeof (signal_program[0]) * numsigs);
4245 for (i = 0; i < numsigs; i++)
4248 signal_print[i] = 1;
4249 signal_program[i] = 1;
4252 /* Signals caused by debugger's own actions
4253 should not be given to the program afterwards. */
4254 signal_program[TARGET_SIGNAL_TRAP] = 0;
4255 signal_program[TARGET_SIGNAL_INT] = 0;
4257 /* Signals that are not errors should not normally enter the debugger. */
4258 signal_stop[TARGET_SIGNAL_ALRM] = 0;
4259 signal_print[TARGET_SIGNAL_ALRM] = 0;
4260 signal_stop[TARGET_SIGNAL_VTALRM] = 0;
4261 signal_print[TARGET_SIGNAL_VTALRM] = 0;
4262 signal_stop[TARGET_SIGNAL_PROF] = 0;
4263 signal_print[TARGET_SIGNAL_PROF] = 0;
4264 signal_stop[TARGET_SIGNAL_CHLD] = 0;
4265 signal_print[TARGET_SIGNAL_CHLD] = 0;
4266 signal_stop[TARGET_SIGNAL_IO] = 0;
4267 signal_print[TARGET_SIGNAL_IO] = 0;
4268 signal_stop[TARGET_SIGNAL_POLL] = 0;
4269 signal_print[TARGET_SIGNAL_POLL] = 0;
4270 signal_stop[TARGET_SIGNAL_URG] = 0;
4271 signal_print[TARGET_SIGNAL_URG] = 0;
4272 signal_stop[TARGET_SIGNAL_WINCH] = 0;
4273 signal_print[TARGET_SIGNAL_WINCH] = 0;
4275 /* These signals are used internally by user-level thread
4276 implementations. (See signal(5) on Solaris.) Like the above
4277 signals, a healthy program receives and handles them as part of
4278 its normal operation. */
4279 signal_stop[TARGET_SIGNAL_LWP] = 0;
4280 signal_print[TARGET_SIGNAL_LWP] = 0;
4281 signal_stop[TARGET_SIGNAL_WAITING] = 0;
4282 signal_print[TARGET_SIGNAL_WAITING] = 0;
4283 signal_stop[TARGET_SIGNAL_CANCEL] = 0;
4284 signal_print[TARGET_SIGNAL_CANCEL] = 0;
4288 (add_set_cmd ("stop-on-solib-events", class_support, var_zinteger,
4289 (char *) &stop_on_solib_events,
4290 "Set stopping for shared library events.\n\
4291 If nonzero, gdb will give control to the user when the dynamic linker\n\
4292 notifies gdb of shared library events. The most common event of interest\n\
4293 to the user would be loading/unloading of a new library.\n",
4298 c = add_set_enum_cmd ("follow-fork-mode",
4300 follow_fork_mode_kind_names,
4301 &follow_fork_mode_string,
4302 /* ??rehrauer: The "both" option is broken, by what may be a 10.20
4303 kernel problem. It's also not terribly useful without a GUI to
4304 help the user drive two debuggers. So for now, I'm disabling
4305 the "both" option. */
4306 /* "Set debugger response to a program call of fork \
4308 A fork or vfork creates a new process. follow-fork-mode can be:\n\
4309 parent - the original process is debugged after a fork\n\
4310 child - the new process is debugged after a fork\n\
4311 both - both the parent and child are debugged after a fork\n\
4312 ask - the debugger will ask for one of the above choices\n\
4313 For \"both\", another copy of the debugger will be started to follow\n\
4314 the new child process. The original debugger will continue to follow\n\
4315 the original parent process. To distinguish their prompts, the\n\
4316 debugger copy's prompt will be changed.\n\
4317 For \"parent\" or \"child\", the unfollowed process will run free.\n\
4318 By default, the debugger will follow the parent process.",
4320 "Set debugger response to a program call of fork \
4322 A fork or vfork creates a new process. follow-fork-mode can be:\n\
4323 parent - the original process is debugged after a fork\n\
4324 child - the new process is debugged after a fork\n\
4325 ask - the debugger will ask for one of the above choices\n\
4326 For \"parent\" or \"child\", the unfollowed process will run free.\n\
4327 By default, the debugger will follow the parent process.",
4329 add_show_from_set (c, &showlist);
4331 c = add_set_enum_cmd ("scheduler-locking", class_run,
4332 scheduler_enums, /* array of string names */
4333 &scheduler_mode, /* current mode */
4334 "Set mode for locking scheduler during execution.\n\
4335 off == no locking (threads may preempt at any time)\n\
4336 on == full locking (no thread except the current thread may run)\n\
4337 step == scheduler locked during every single-step operation.\n\
4338 In this mode, no other thread may run during a step command.\n\
4339 Other threads may run while stepping over a function call ('next').",
4342 set_cmd_sfunc (c, set_schedlock_func); /* traps on target vector */
4343 add_show_from_set (c, &showlist);
4345 c = add_set_cmd ("step-mode", class_run,
4346 var_boolean, (char*) &step_stop_if_no_debug,
4347 "Set mode of the step operation. When set, doing a step over a\n\
4348 function without debug line information will stop at the first\n\
4349 instruction of that function. Otherwise, the function is skipped and\n\
4350 the step command stops at a different source line.",
4352 add_show_from_set (c, &showlist);
4354 /* ptid initializations */
4355 null_ptid = ptid_build (0, 0, 0);
4356 minus_one_ptid = ptid_build (-1, 0, 0);
4357 inferior_ptid = null_ptid;
4358 target_last_wait_ptid = minus_one_ptid;