Index: ChangeLog
[external/binutils.git] / gdb / infrun.c
1 /* Target-struct-independent code to start (run) and stop an inferior
2    process.
3
4    Copyright 1986, 1987, 1988, 1989, 1990, 1991, 1992, 1993, 1994,
5    1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004 Free
6    Software Foundation, Inc.
7
8    This file is part of GDB.
9
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.
14
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.
19
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.  */
24
25 #include "defs.h"
26 #include "gdb_string.h"
27 #include <ctype.h>
28 #include "symtab.h"
29 #include "frame.h"
30 #include "inferior.h"
31 #include "breakpoint.h"
32 #include "gdb_wait.h"
33 #include "gdbcore.h"
34 #include "gdbcmd.h"
35 #include "cli/cli-script.h"
36 #include "target.h"
37 #include "gdbthread.h"
38 #include "annotate.h"
39 #include "symfile.h"
40 #include "top.h"
41 #include <signal.h>
42 #include "inf-loop.h"
43 #include "regcache.h"
44 #include "value.h"
45 #include "observer.h"
46 #include "language.h"
47 #include "gdb_assert.h"
48
49 /* Prototypes for local functions */
50
51 static void signals_info (char *, int);
52
53 static void handle_command (char *, int);
54
55 static void sig_print_info (enum target_signal);
56
57 static void sig_print_header (void);
58
59 static void resume_cleanups (void *);
60
61 static int hook_stop_stub (void *);
62
63 static void delete_breakpoint_current_contents (void *);
64
65 static int restore_selected_frame (void *);
66
67 static void build_infrun (void);
68
69 static int follow_fork (void);
70
71 static void set_schedlock_func (char *args, int from_tty,
72                                 struct cmd_list_element *c);
73
74 struct execution_control_state;
75
76 static int currently_stepping (struct execution_control_state *ecs);
77
78 static void xdb_handle_command (char *args, int from_tty);
79
80 static int prepare_to_proceed (void);
81
82 void _initialize_infrun (void);
83
84 int inferior_ignoring_startup_exec_events = 0;
85 int inferior_ignoring_leading_exec_events = 0;
86
87 /* When set, stop the 'step' command if we enter a function which has
88    no line number information.  The normal behavior is that we step
89    over such function.  */
90 int step_stop_if_no_debug = 0;
91
92 /* In asynchronous mode, but simulating synchronous execution. */
93
94 int sync_execution = 0;
95
96 /* wait_for_inferior and normal_stop use this to notify the user
97    when the inferior stopped in a different thread than it had been
98    running in.  */
99
100 static ptid_t previous_inferior_ptid;
101
102 /* This is true for configurations that may follow through execl() and
103    similar functions.  At present this is only true for HP-UX native.  */
104
105 #ifndef MAY_FOLLOW_EXEC
106 #define MAY_FOLLOW_EXEC (0)
107 #endif
108
109 static int may_follow_exec = MAY_FOLLOW_EXEC;
110
111 /* If the program uses ELF-style shared libraries, then calls to
112    functions in shared libraries go through stubs, which live in a
113    table called the PLT (Procedure Linkage Table).  The first time the
114    function is called, the stub sends control to the dynamic linker,
115    which looks up the function's real address, patches the stub so
116    that future calls will go directly to the function, and then passes
117    control to the function.
118
119    If we are stepping at the source level, we don't want to see any of
120    this --- we just want to skip over the stub and the dynamic linker.
121    The simple approach is to single-step until control leaves the
122    dynamic linker.
123
124    However, on some systems (e.g., Red Hat's 5.2 distribution) the
125    dynamic linker calls functions in the shared C library, so you
126    can't tell from the PC alone whether the dynamic linker is still
127    running.  In this case, we use a step-resume breakpoint to get us
128    past the dynamic linker, as if we were using "next" to step over a
129    function call.
130
131    IN_SOLIB_DYNSYM_RESOLVE_CODE says whether we're in the dynamic
132    linker code or not.  Normally, this means we single-step.  However,
133    if SKIP_SOLIB_RESOLVER then returns non-zero, then its value is an
134    address where we can place a step-resume breakpoint to get past the
135    linker's symbol resolution function.
136
137    IN_SOLIB_DYNSYM_RESOLVE_CODE can generally be implemented in a
138    pretty portable way, by comparing the PC against the address ranges
139    of the dynamic linker's sections.
140
141    SKIP_SOLIB_RESOLVER is generally going to be system-specific, since
142    it depends on internal details of the dynamic linker.  It's usually
143    not too hard to figure out where to put a breakpoint, but it
144    certainly isn't portable.  SKIP_SOLIB_RESOLVER should do plenty of
145    sanity checking.  If it can't figure things out, returning zero and
146    getting the (possibly confusing) stepping behavior is better than
147    signalling an error, which will obscure the change in the
148    inferior's state.  */
149
150 #ifndef IN_SOLIB_DYNSYM_RESOLVE_CODE
151 #define IN_SOLIB_DYNSYM_RESOLVE_CODE(pc) 0
152 #endif
153
154 /* This function returns TRUE if pc is the address of an instruction
155    that lies within the dynamic linker (such as the event hook, or the
156    dld itself).
157
158    This function must be used only when a dynamic linker event has
159    been caught, and the inferior is being stepped out of the hook, or
160    undefined results are guaranteed.  */
161
162 #ifndef SOLIB_IN_DYNAMIC_LINKER
163 #define SOLIB_IN_DYNAMIC_LINKER(pid,pc) 0
164 #endif
165
166 /* On MIPS16, a function that returns a floating point value may call
167    a library helper function to copy the return value to a floating point
168    register.  The IGNORE_HELPER_CALL macro returns non-zero if we
169    should ignore (i.e. step over) this function call.  */
170 #ifndef IGNORE_HELPER_CALL
171 #define IGNORE_HELPER_CALL(pc)  0
172 #endif
173
174 /* On some systems, the PC may be left pointing at an instruction that  won't
175    actually be executed.  This is usually indicated by a bit in the PSW.  If
176    we find ourselves in such a state, then we step the target beyond the
177    nullified instruction before returning control to the user so as to avoid
178    confusion. */
179
180 #ifndef INSTRUCTION_NULLIFIED
181 #define INSTRUCTION_NULLIFIED 0
182 #endif
183
184 /* We can't step off a permanent breakpoint in the ordinary way, because we
185    can't remove it.  Instead, we have to advance the PC to the next
186    instruction.  This macro should expand to a pointer to a function that
187    does that, or zero if we have no such function.  If we don't have a
188    definition for it, we have to report an error.  */
189 #ifndef SKIP_PERMANENT_BREAKPOINT
190 #define SKIP_PERMANENT_BREAKPOINT (default_skip_permanent_breakpoint)
191 static void
192 default_skip_permanent_breakpoint (void)
193 {
194   error ("\
195 The program is stopped at a permanent breakpoint, but GDB does not know\n\
196 how to step past a permanent breakpoint on this architecture.  Try using\n\
197 a command like `return' or `jump' to continue execution.");
198 }
199 #endif
200
201
202 /* Convert the #defines into values.  This is temporary until wfi control
203    flow is completely sorted out.  */
204
205 #ifndef HAVE_STEPPABLE_WATCHPOINT
206 #define HAVE_STEPPABLE_WATCHPOINT 0
207 #else
208 #undef  HAVE_STEPPABLE_WATCHPOINT
209 #define HAVE_STEPPABLE_WATCHPOINT 1
210 #endif
211
212 #ifndef CANNOT_STEP_HW_WATCHPOINTS
213 #define CANNOT_STEP_HW_WATCHPOINTS 0
214 #else
215 #undef  CANNOT_STEP_HW_WATCHPOINTS
216 #define CANNOT_STEP_HW_WATCHPOINTS 1
217 #endif
218
219 /* Tables of how to react to signals; the user sets them.  */
220
221 static unsigned char *signal_stop;
222 static unsigned char *signal_print;
223 static unsigned char *signal_program;
224
225 #define SET_SIGS(nsigs,sigs,flags) \
226   do { \
227     int signum = (nsigs); \
228     while (signum-- > 0) \
229       if ((sigs)[signum]) \
230         (flags)[signum] = 1; \
231   } while (0)
232
233 #define UNSET_SIGS(nsigs,sigs,flags) \
234   do { \
235     int signum = (nsigs); \
236     while (signum-- > 0) \
237       if ((sigs)[signum]) \
238         (flags)[signum] = 0; \
239   } while (0)
240
241 /* Value to pass to target_resume() to cause all threads to resume */
242
243 #define RESUME_ALL (pid_to_ptid (-1))
244
245 /* Command list pointer for the "stop" placeholder.  */
246
247 static struct cmd_list_element *stop_command;
248
249 /* Nonzero if breakpoints are now inserted in the inferior.  */
250
251 static int breakpoints_inserted;
252
253 /* Function inferior was in as of last step command.  */
254
255 static struct symbol *step_start_function;
256
257 /* Nonzero if we are expecting a trace trap and should proceed from it.  */
258
259 static int trap_expected;
260
261 #ifdef SOLIB_ADD
262 /* Nonzero if we want to give control to the user when we're notified
263    of shared library events by the dynamic linker.  */
264 static int stop_on_solib_events;
265 #endif
266
267 #ifdef HP_OS_BUG
268 /* Nonzero if the next time we try to continue the inferior, it will
269    step one instruction and generate a spurious trace trap.
270    This is used to compensate for a bug in HP-UX.  */
271
272 static int trap_expected_after_continue;
273 #endif
274
275 /* Nonzero means expecting a trace trap
276    and should stop the inferior and return silently when it happens.  */
277
278 int stop_after_trap;
279
280 /* Nonzero means expecting a trap and caller will handle it themselves.
281    It is used after attach, due to attaching to a process;
282    when running in the shell before the child program has been exec'd;
283    and when running some kinds of remote stuff (FIXME?).  */
284
285 enum stop_kind stop_soon;
286
287 /* Nonzero if proceed is being used for a "finish" command or a similar
288    situation when stop_registers should be saved.  */
289
290 int proceed_to_finish;
291
292 /* Save register contents here when about to pop a stack dummy frame,
293    if-and-only-if proceed_to_finish is set.
294    Thus this contains the return value from the called function (assuming
295    values are returned in a register).  */
296
297 struct regcache *stop_registers;
298
299 /* Nonzero if program stopped due to error trying to insert breakpoints.  */
300
301 static int breakpoints_failed;
302
303 /* Nonzero after stop if current stack frame should be printed.  */
304
305 static int stop_print_frame;
306
307 static struct breakpoint *step_resume_breakpoint = NULL;
308 static struct breakpoint *through_sigtramp_breakpoint = NULL;
309
310 /* On some platforms (e.g., HP-UX), hardware watchpoints have bad
311    interactions with an inferior that is running a kernel function
312    (aka, a system call or "syscall").  wait_for_inferior therefore
313    may have a need to know when the inferior is in a syscall.  This
314    is a count of the number of inferior threads which are known to
315    currently be running in a syscall. */
316 static int number_of_threads_in_syscalls;
317
318 /* This is a cached copy of the pid/waitstatus of the last event
319    returned by target_wait()/target_wait_hook().  This information is
320    returned by get_last_target_status(). */
321 static ptid_t target_last_wait_ptid;
322 static struct target_waitstatus target_last_waitstatus;
323
324 /* This is used to remember when a fork, vfork or exec event
325    was caught by a catchpoint, and thus the event is to be
326    followed at the next resume of the inferior, and not
327    immediately. */
328 static struct
329 {
330   enum target_waitkind kind;
331   struct
332   {
333     int parent_pid;
334     int child_pid;
335   }
336   fork_event;
337   char *execd_pathname;
338 }
339 pending_follow;
340
341 static const char follow_fork_mode_child[] = "child";
342 static const char follow_fork_mode_parent[] = "parent";
343
344 static const char *follow_fork_mode_kind_names[] = {
345   follow_fork_mode_child,
346   follow_fork_mode_parent,
347   NULL
348 };
349
350 static const char *follow_fork_mode_string = follow_fork_mode_parent;
351 \f
352
353 static int
354 follow_fork (void)
355 {
356   int follow_child = (follow_fork_mode_string == follow_fork_mode_child);
357
358   return target_follow_fork (follow_child);
359 }
360
361 void
362 follow_inferior_reset_breakpoints (void)
363 {
364   /* Was there a step_resume breakpoint?  (There was if the user
365      did a "next" at the fork() call.)  If so, explicitly reset its
366      thread number.
367
368      step_resumes are a form of bp that are made to be per-thread.
369      Since we created the step_resume bp when the parent process
370      was being debugged, and now are switching to the child process,
371      from the breakpoint package's viewpoint, that's a switch of
372      "threads".  We must update the bp's notion of which thread
373      it is for, or it'll be ignored when it triggers.  */
374
375   if (step_resume_breakpoint)
376     breakpoint_re_set_thread (step_resume_breakpoint);
377
378   /* Reinsert all breakpoints in the child.  The user may have set
379      breakpoints after catching the fork, in which case those
380      were never set in the child, but only in the parent.  This makes
381      sure the inserted breakpoints match the breakpoint list.  */
382
383   breakpoint_re_set ();
384   insert_breakpoints ();
385 }
386
387 /* EXECD_PATHNAME is assumed to be non-NULL. */
388
389 static void
390 follow_exec (int pid, char *execd_pathname)
391 {
392   int saved_pid = pid;
393   struct target_ops *tgt;
394
395   if (!may_follow_exec)
396     return;
397
398   /* This is an exec event that we actually wish to pay attention to.
399      Refresh our symbol table to the newly exec'd program, remove any
400      momentary bp's, etc.
401
402      If there are breakpoints, they aren't really inserted now,
403      since the exec() transformed our inferior into a fresh set
404      of instructions.
405
406      We want to preserve symbolic breakpoints on the list, since
407      we have hopes that they can be reset after the new a.out's
408      symbol table is read.
409
410      However, any "raw" breakpoints must be removed from the list
411      (e.g., the solib bp's), since their address is probably invalid
412      now.
413
414      And, we DON'T want to call delete_breakpoints() here, since
415      that may write the bp's "shadow contents" (the instruction
416      value that was overwritten witha TRAP instruction).  Since
417      we now have a new a.out, those shadow contents aren't valid. */
418   update_breakpoints_after_exec ();
419
420   /* If there was one, it's gone now.  We cannot truly step-to-next
421      statement through an exec(). */
422   step_resume_breakpoint = NULL;
423   step_range_start = 0;
424   step_range_end = 0;
425
426   /* If there was one, it's gone now. */
427   through_sigtramp_breakpoint = NULL;
428
429   /* What is this a.out's name? */
430   printf_unfiltered ("Executing new program: %s\n", execd_pathname);
431
432   /* We've followed the inferior through an exec.  Therefore, the
433      inferior has essentially been killed & reborn. */
434
435   /* First collect the run target in effect.  */
436   tgt = find_run_target ();
437   /* If we can't find one, things are in a very strange state...  */
438   if (tgt == NULL)
439     error ("Could find run target to save before following exec");
440
441   gdb_flush (gdb_stdout);
442   target_mourn_inferior ();
443   inferior_ptid = pid_to_ptid (saved_pid);
444   /* Because mourn_inferior resets inferior_ptid. */
445   push_target (tgt);
446
447   /* That a.out is now the one to use. */
448   exec_file_attach (execd_pathname, 0);
449
450   /* And also is where symbols can be found. */
451   symbol_file_add_main (execd_pathname, 0);
452
453   /* Reset the shared library package.  This ensures that we get
454      a shlib event when the child reaches "_start", at which point
455      the dld will have had a chance to initialize the child. */
456 #if defined(SOLIB_RESTART)
457   SOLIB_RESTART ();
458 #endif
459 #ifdef SOLIB_CREATE_INFERIOR_HOOK
460   SOLIB_CREATE_INFERIOR_HOOK (PIDGET (inferior_ptid));
461 #endif
462
463   /* Reinsert all breakpoints.  (Those which were symbolic have
464      been reset to the proper address in the new a.out, thanks
465      to symbol_file_command...) */
466   insert_breakpoints ();
467
468   /* The next resume of this inferior should bring it to the shlib
469      startup breakpoints.  (If the user had also set bp's on
470      "main" from the old (parent) process, then they'll auto-
471      matically get reset there in the new process.) */
472 }
473
474 /* Non-zero if we just simulating a single-step.  This is needed
475    because we cannot remove the breakpoints in the inferior process
476    until after the `wait' in `wait_for_inferior'.  */
477 static int singlestep_breakpoints_inserted_p = 0;
478
479 /* The thread we inserted single-step breakpoints for.  */
480 static ptid_t singlestep_ptid;
481
482 /* If another thread hit the singlestep breakpoint, we save the original
483    thread here so that we can resume single-stepping it later.  */
484 static ptid_t saved_singlestep_ptid;
485 static int stepping_past_singlestep_breakpoint;
486 \f
487
488 /* Things to clean up if we QUIT out of resume ().  */
489 static void
490 resume_cleanups (void *ignore)
491 {
492   normal_stop ();
493 }
494
495 static const char schedlock_off[] = "off";
496 static const char schedlock_on[] = "on";
497 static const char schedlock_step[] = "step";
498 static const char *scheduler_mode = schedlock_off;
499 static const char *scheduler_enums[] = {
500   schedlock_off,
501   schedlock_on,
502   schedlock_step,
503   NULL
504 };
505
506 static void
507 set_schedlock_func (char *args, int from_tty, struct cmd_list_element *c)
508 {
509   /* NOTE: cagney/2002-03-17: The add_show_from_set() function clones
510      the set command passed as a parameter.  The clone operation will
511      include (BUG?) any ``set'' command callback, if present.
512      Commands like ``info set'' call all the ``show'' command
513      callbacks.  Unfortunately, for ``show'' commands cloned from
514      ``set'', this includes callbacks belonging to ``set'' commands.
515      Making this worse, this only occures if add_show_from_set() is
516      called after add_cmd_sfunc() (BUG?).  */
517   if (cmd_type (c) == set_cmd)
518     if (!target_can_lock_scheduler)
519       {
520         scheduler_mode = schedlock_off;
521         error ("Target '%s' cannot support this command.", target_shortname);
522       }
523 }
524
525
526 /* Resume the inferior, but allow a QUIT.  This is useful if the user
527    wants to interrupt some lengthy single-stepping operation
528    (for child processes, the SIGINT goes to the inferior, and so
529    we get a SIGINT random_signal, but for remote debugging and perhaps
530    other targets, that's not true).
531
532    STEP nonzero if we should step (zero to continue instead).
533    SIG is the signal to give the inferior (zero for none).  */
534 void
535 resume (int step, enum target_signal sig)
536 {
537   int should_resume = 1;
538   struct cleanup *old_cleanups = make_cleanup (resume_cleanups, 0);
539   QUIT;
540
541   /* FIXME: calling breakpoint_here_p (read_pc ()) three times! */
542
543
544   /* Some targets (e.g. Solaris x86) have a kernel bug when stepping
545      over an instruction that causes a page fault without triggering
546      a hardware watchpoint. The kernel properly notices that it shouldn't
547      stop, because the hardware watchpoint is not triggered, but it forgets
548      the step request and continues the program normally.
549      Work around the problem by removing hardware watchpoints if a step is
550      requested, GDB will check for a hardware watchpoint trigger after the
551      step anyway.  */
552   if (CANNOT_STEP_HW_WATCHPOINTS && step && breakpoints_inserted)
553     remove_hw_watchpoints ();
554
555
556   /* Normally, by the time we reach `resume', the breakpoints are either
557      removed or inserted, as appropriate.  The exception is if we're sitting
558      at a permanent breakpoint; we need to step over it, but permanent
559      breakpoints can't be removed.  So we have to test for it here.  */
560   if (breakpoint_here_p (read_pc ()) == permanent_breakpoint_here)
561     SKIP_PERMANENT_BREAKPOINT ();
562
563   if (SOFTWARE_SINGLE_STEP_P () && step)
564     {
565       /* Do it the hard way, w/temp breakpoints */
566       SOFTWARE_SINGLE_STEP (sig, 1 /*insert-breakpoints */ );
567       /* ...and don't ask hardware to do it.  */
568       step = 0;
569       /* and do not pull these breakpoints until after a `wait' in
570          `wait_for_inferior' */
571       singlestep_breakpoints_inserted_p = 1;
572       singlestep_ptid = inferior_ptid;
573     }
574
575   /* Handle any optimized stores to the inferior NOW...  */
576 #ifdef DO_DEFERRED_STORES
577   DO_DEFERRED_STORES;
578 #endif
579
580   /* If there were any forks/vforks/execs that were caught and are
581      now to be followed, then do so.  */
582   switch (pending_follow.kind)
583     {
584     case TARGET_WAITKIND_FORKED:
585     case TARGET_WAITKIND_VFORKED:
586       pending_follow.kind = TARGET_WAITKIND_SPURIOUS;
587       if (follow_fork ())
588         should_resume = 0;
589       break;
590
591     case TARGET_WAITKIND_EXECD:
592       /* follow_exec is called as soon as the exec event is seen. */
593       pending_follow.kind = TARGET_WAITKIND_SPURIOUS;
594       break;
595
596     default:
597       break;
598     }
599
600   /* Install inferior's terminal modes.  */
601   target_terminal_inferior ();
602
603   if (should_resume)
604     {
605       ptid_t resume_ptid;
606
607       resume_ptid = RESUME_ALL; /* Default */
608
609       if ((step || singlestep_breakpoints_inserted_p) &&
610           (stepping_past_singlestep_breakpoint
611            || (!breakpoints_inserted && breakpoint_here_p (read_pc ()))))
612         {
613           /* Stepping past a breakpoint without inserting breakpoints.
614              Make sure only the current thread gets to step, so that
615              other threads don't sneak past breakpoints while they are
616              not inserted. */
617
618           resume_ptid = inferior_ptid;
619         }
620
621       if ((scheduler_mode == schedlock_on) ||
622           (scheduler_mode == schedlock_step &&
623            (step || singlestep_breakpoints_inserted_p)))
624         {
625           /* User-settable 'scheduler' mode requires solo thread resume. */
626           resume_ptid = inferior_ptid;
627         }
628
629       if (CANNOT_STEP_BREAKPOINT)
630         {
631           /* Most targets can step a breakpoint instruction, thus
632              executing it normally.  But if this one cannot, just
633              continue and we will hit it anyway.  */
634           if (step && breakpoints_inserted && breakpoint_here_p (read_pc ()))
635             step = 0;
636         }
637       target_resume (resume_ptid, step, sig);
638     }
639
640   discard_cleanups (old_cleanups);
641 }
642 \f
643
644 /* Clear out all variables saying what to do when inferior is continued.
645    First do this, then set the ones you want, then call `proceed'.  */
646
647 void
648 clear_proceed_status (void)
649 {
650   trap_expected = 0;
651   step_range_start = 0;
652   step_range_end = 0;
653   step_frame_id = null_frame_id;
654   step_over_calls = STEP_OVER_UNDEBUGGABLE;
655   stop_after_trap = 0;
656   stop_soon = NO_STOP_QUIETLY;
657   proceed_to_finish = 0;
658   breakpoint_proceeded = 1;     /* We're about to proceed... */
659
660   /* Discard any remaining commands or status from previous stop.  */
661   bpstat_clear (&stop_bpstat);
662 }
663
664 /* This should be suitable for any targets that support threads. */
665
666 static int
667 prepare_to_proceed (void)
668 {
669   ptid_t wait_ptid;
670   struct target_waitstatus wait_status;
671
672   /* Get the last target status returned by target_wait().  */
673   get_last_target_status (&wait_ptid, &wait_status);
674
675   /* Make sure we were stopped either at a breakpoint, or because
676      of a Ctrl-C.  */
677   if (wait_status.kind != TARGET_WAITKIND_STOPPED
678       || (wait_status.value.sig != TARGET_SIGNAL_TRAP &&
679           wait_status.value.sig != TARGET_SIGNAL_INT))
680     {
681       return 0;
682     }
683
684   if (!ptid_equal (wait_ptid, minus_one_ptid)
685       && !ptid_equal (inferior_ptid, wait_ptid))
686     {
687       /* Switched over from WAIT_PID.  */
688       CORE_ADDR wait_pc = read_pc_pid (wait_ptid);
689
690       if (wait_pc != read_pc ())
691         {
692           /* Switch back to WAIT_PID thread.  */
693           inferior_ptid = wait_ptid;
694
695           /* FIXME: This stuff came from switch_to_thread() in
696              thread.c (which should probably be a public function).  */
697           flush_cached_frames ();
698           registers_changed ();
699           stop_pc = wait_pc;
700           select_frame (get_current_frame ());
701         }
702
703         /* We return 1 to indicate that there is a breakpoint here,
704            so we need to step over it before continuing to avoid
705            hitting it straight away. */
706         if (breakpoint_here_p (wait_pc))
707            return 1;
708     }
709
710   return 0;
711   
712 }
713
714 /* Record the pc of the program the last time it stopped.  This is
715    just used internally by wait_for_inferior, but need to be preserved
716    over calls to it and cleared when the inferior is started.  */
717 static CORE_ADDR prev_pc;
718
719 /* Basic routine for continuing the program in various fashions.
720
721    ADDR is the address to resume at, or -1 for resume where stopped.
722    SIGGNAL is the signal to give it, or 0 for none,
723    or -1 for act according to how it stopped.
724    STEP is nonzero if should trap after one instruction.
725    -1 means return after that and print nothing.
726    You should probably set various step_... variables
727    before calling here, if you are stepping.
728
729    You should call clear_proceed_status before calling proceed.  */
730
731 void
732 proceed (CORE_ADDR addr, enum target_signal siggnal, int step)
733 {
734   int oneproc = 0;
735
736   if (step > 0)
737     step_start_function = find_pc_function (read_pc ());
738   if (step < 0)
739     stop_after_trap = 1;
740
741   if (addr == (CORE_ADDR) -1)
742     {
743       /* If there is a breakpoint at the address we will resume at,
744          step one instruction before inserting breakpoints
745          so that we do not stop right away (and report a second
746          hit at this breakpoint).  */
747
748       if (read_pc () == stop_pc && breakpoint_here_p (read_pc ()))
749         oneproc = 1;
750
751 #ifndef STEP_SKIPS_DELAY
752 #define STEP_SKIPS_DELAY(pc) (0)
753 #define STEP_SKIPS_DELAY_P (0)
754 #endif
755       /* Check breakpoint_here_p first, because breakpoint_here_p is fast
756          (it just checks internal GDB data structures) and STEP_SKIPS_DELAY
757          is slow (it needs to read memory from the target).  */
758       if (STEP_SKIPS_DELAY_P
759           && breakpoint_here_p (read_pc () + 4)
760           && STEP_SKIPS_DELAY (read_pc ()))
761         oneproc = 1;
762     }
763   else
764     {
765       write_pc (addr);
766     }
767
768   /* In a multi-threaded task we may select another thread
769      and then continue or step.
770
771      But if the old thread was stopped at a breakpoint, it
772      will immediately cause another breakpoint stop without
773      any execution (i.e. it will report a breakpoint hit
774      incorrectly).  So we must step over it first.
775
776      prepare_to_proceed checks the current thread against the thread
777      that reported the most recent event.  If a step-over is required
778      it returns TRUE and sets the current thread to the old thread. */
779   if (prepare_to_proceed () && breakpoint_here_p (read_pc ()))
780     oneproc = 1;
781
782 #ifdef HP_OS_BUG
783   if (trap_expected_after_continue)
784     {
785       /* If (step == 0), a trap will be automatically generated after
786          the first instruction is executed.  Force step one
787          instruction to clear this condition.  This should not occur
788          if step is nonzero, but it is harmless in that case.  */
789       oneproc = 1;
790       trap_expected_after_continue = 0;
791     }
792 #endif /* HP_OS_BUG */
793
794   if (oneproc)
795     /* We will get a trace trap after one instruction.
796        Continue it automatically and insert breakpoints then.  */
797     trap_expected = 1;
798   else
799     {
800       insert_breakpoints ();
801       /* If we get here there was no call to error() in 
802          insert breakpoints -- so they were inserted.  */
803       breakpoints_inserted = 1;
804     }
805
806   if (siggnal != TARGET_SIGNAL_DEFAULT)
807     stop_signal = siggnal;
808   /* If this signal should not be seen by program,
809      give it zero.  Used for debugging signals.  */
810   else if (!signal_program[stop_signal])
811     stop_signal = TARGET_SIGNAL_0;
812
813   annotate_starting ();
814
815   /* Make sure that output from GDB appears before output from the
816      inferior.  */
817   gdb_flush (gdb_stdout);
818
819   /* Refresh prev_pc value just prior to resuming.  This used to be
820      done in stop_stepping, however, setting prev_pc there did not handle
821      scenarios such as inferior function calls or returning from
822      a function via the return command.  In those cases, the prev_pc
823      value was not set properly for subsequent commands.  The prev_pc value 
824      is used to initialize the starting line number in the ecs.  With an 
825      invalid value, the gdb next command ends up stopping at the position
826      represented by the next line table entry past our start position.
827      On platforms that generate one line table entry per line, this
828      is not a problem.  However, on the ia64, the compiler generates
829      extraneous line table entries that do not increase the line number.
830      When we issue the gdb next command on the ia64 after an inferior call
831      or a return command, we often end up a few instructions forward, still 
832      within the original line we started.
833
834      An attempt was made to have init_execution_control_state () refresh
835      the prev_pc value before calculating the line number.  This approach
836      did not work because on platforms that use ptrace, the pc register
837      cannot be read unless the inferior is stopped.  At that point, we
838      are not guaranteed the inferior is stopped and so the read_pc ()
839      call can fail.  Setting the prev_pc value here ensures the value is 
840      updated correctly when the inferior is stopped.  */  
841   prev_pc = read_pc ();
842
843   /* Resume inferior.  */
844   resume (oneproc || step || bpstat_should_step (), stop_signal);
845
846   /* Wait for it to stop (if not standalone)
847      and in any case decode why it stopped, and act accordingly.  */
848   /* Do this only if we are not using the event loop, or if the target
849      does not support asynchronous execution. */
850   if (!event_loop_p || !target_can_async_p ())
851     {
852       wait_for_inferior ();
853       normal_stop ();
854     }
855 }
856 \f
857
858 /* Start remote-debugging of a machine over a serial link.  */
859
860 void
861 start_remote (void)
862 {
863   init_thread_list ();
864   init_wait_for_inferior ();
865   stop_soon = STOP_QUIETLY;
866   trap_expected = 0;
867
868   /* Always go on waiting for the target, regardless of the mode. */
869   /* FIXME: cagney/1999-09-23: At present it isn't possible to
870      indicate to wait_for_inferior that a target should timeout if
871      nothing is returned (instead of just blocking).  Because of this,
872      targets expecting an immediate response need to, internally, set
873      things up so that the target_wait() is forced to eventually
874      timeout. */
875   /* FIXME: cagney/1999-09-24: It isn't possible for target_open() to
876      differentiate to its caller what the state of the target is after
877      the initial open has been performed.  Here we're assuming that
878      the target has stopped.  It should be possible to eventually have
879      target_open() return to the caller an indication that the target
880      is currently running and GDB state should be set to the same as
881      for an async run. */
882   wait_for_inferior ();
883   normal_stop ();
884 }
885
886 /* Initialize static vars when a new inferior begins.  */
887
888 void
889 init_wait_for_inferior (void)
890 {
891   /* These are meaningless until the first time through wait_for_inferior.  */
892   prev_pc = 0;
893
894 #ifdef HP_OS_BUG
895   trap_expected_after_continue = 0;
896 #endif
897   breakpoints_inserted = 0;
898   breakpoint_init_inferior (inf_starting);
899
900   /* Don't confuse first call to proceed(). */
901   stop_signal = TARGET_SIGNAL_0;
902
903   /* The first resume is not following a fork/vfork/exec. */
904   pending_follow.kind = TARGET_WAITKIND_SPURIOUS;       /* I.e., none. */
905
906   /* See wait_for_inferior's handling of SYSCALL_ENTRY/RETURN events. */
907   number_of_threads_in_syscalls = 0;
908
909   clear_proceed_status ();
910
911   stepping_past_singlestep_breakpoint = 0;
912 }
913
914 static void
915 delete_breakpoint_current_contents (void *arg)
916 {
917   struct breakpoint **breakpointp = (struct breakpoint **) arg;
918   if (*breakpointp != NULL)
919     {
920       delete_breakpoint (*breakpointp);
921       *breakpointp = NULL;
922     }
923 }
924 \f
925 /* This enum encodes possible reasons for doing a target_wait, so that
926    wfi can call target_wait in one place.  (Ultimately the call will be
927    moved out of the infinite loop entirely.) */
928
929 enum infwait_states
930 {
931   infwait_normal_state,
932   infwait_thread_hop_state,
933   infwait_nullified_state,
934   infwait_nonstep_watch_state
935 };
936
937 /* Why did the inferior stop? Used to print the appropriate messages
938    to the interface from within handle_inferior_event(). */
939 enum inferior_stop_reason
940 {
941   /* We don't know why. */
942   STOP_UNKNOWN,
943   /* Step, next, nexti, stepi finished. */
944   END_STEPPING_RANGE,
945   /* Found breakpoint. */
946   BREAKPOINT_HIT,
947   /* Inferior terminated by signal. */
948   SIGNAL_EXITED,
949   /* Inferior exited. */
950   EXITED,
951   /* Inferior received signal, and user asked to be notified. */
952   SIGNAL_RECEIVED
953 };
954
955 /* This structure contains what used to be local variables in
956    wait_for_inferior.  Probably many of them can return to being
957    locals in handle_inferior_event.  */
958
959 struct execution_control_state
960 {
961   struct target_waitstatus ws;
962   struct target_waitstatus *wp;
963   int another_trap;
964   int random_signal;
965   CORE_ADDR stop_func_start;
966   CORE_ADDR stop_func_end;
967   char *stop_func_name;
968   struct symtab_and_line sal;
969   int remove_breakpoints_on_following_step;
970   int current_line;
971   struct symtab *current_symtab;
972   int handling_longjmp;         /* FIXME */
973   ptid_t ptid;
974   ptid_t saved_inferior_ptid;
975   int update_step_sp;
976   int stepping_through_solib_after_catch;
977   bpstat stepping_through_solib_catchpoints;
978   int enable_hw_watchpoints_after_wait;
979   int stepping_through_sigtramp;
980   int new_thread_event;
981   struct target_waitstatus tmpstatus;
982   enum infwait_states infwait_state;
983   ptid_t waiton_ptid;
984   int wait_some_more;
985 };
986
987 void init_execution_control_state (struct execution_control_state *ecs);
988
989 static void handle_step_into_function (struct execution_control_state *ecs);
990 void handle_inferior_event (struct execution_control_state *ecs);
991
992 static void check_sigtramp2 (struct execution_control_state *ecs);
993 static void step_into_function (struct execution_control_state *ecs);
994 static void step_over_function (struct execution_control_state *ecs);
995 static void stop_stepping (struct execution_control_state *ecs);
996 static void prepare_to_wait (struct execution_control_state *ecs);
997 static void keep_going (struct execution_control_state *ecs);
998 static void print_stop_reason (enum inferior_stop_reason stop_reason,
999                                int stop_info);
1000
1001 /* Wait for control to return from inferior to debugger.
1002    If inferior gets a signal, we may decide to start it up again
1003    instead of returning.  That is why there is a loop in this function.
1004    When this function actually returns it means the inferior
1005    should be left stopped and GDB should read more commands.  */
1006
1007 void
1008 wait_for_inferior (void)
1009 {
1010   struct cleanup *old_cleanups;
1011   struct execution_control_state ecss;
1012   struct execution_control_state *ecs;
1013
1014   old_cleanups = make_cleanup (delete_step_resume_breakpoint,
1015                                &step_resume_breakpoint);
1016   make_cleanup (delete_breakpoint_current_contents,
1017                 &through_sigtramp_breakpoint);
1018
1019   /* wfi still stays in a loop, so it's OK just to take the address of
1020      a local to get the ecs pointer.  */
1021   ecs = &ecss;
1022
1023   /* Fill in with reasonable starting values.  */
1024   init_execution_control_state (ecs);
1025
1026   /* We'll update this if & when we switch to a new thread. */
1027   previous_inferior_ptid = inferior_ptid;
1028
1029   overlay_cache_invalid = 1;
1030
1031   /* We have to invalidate the registers BEFORE calling target_wait
1032      because they can be loaded from the target while in target_wait.
1033      This makes remote debugging a bit more efficient for those
1034      targets that provide critical registers as part of their normal
1035      status mechanism. */
1036
1037   registers_changed ();
1038
1039   while (1)
1040     {
1041       if (target_wait_hook)
1042         ecs->ptid = target_wait_hook (ecs->waiton_ptid, ecs->wp);
1043       else
1044         ecs->ptid = target_wait (ecs->waiton_ptid, ecs->wp);
1045
1046       /* Now figure out what to do with the result of the result.  */
1047       handle_inferior_event (ecs);
1048
1049       if (!ecs->wait_some_more)
1050         break;
1051     }
1052   do_cleanups (old_cleanups);
1053 }
1054
1055 /* Asynchronous version of wait_for_inferior. It is called by the
1056    event loop whenever a change of state is detected on the file
1057    descriptor corresponding to the target. It can be called more than
1058    once to complete a single execution command. In such cases we need
1059    to keep the state in a global variable ASYNC_ECSS. If it is the
1060    last time that this function is called for a single execution
1061    command, then report to the user that the inferior has stopped, and
1062    do the necessary cleanups. */
1063
1064 struct execution_control_state async_ecss;
1065 struct execution_control_state *async_ecs;
1066
1067 void
1068 fetch_inferior_event (void *client_data)
1069 {
1070   static struct cleanup *old_cleanups;
1071
1072   async_ecs = &async_ecss;
1073
1074   if (!async_ecs->wait_some_more)
1075     {
1076       old_cleanups = make_exec_cleanup (delete_step_resume_breakpoint,
1077                                         &step_resume_breakpoint);
1078       make_exec_cleanup (delete_breakpoint_current_contents,
1079                          &through_sigtramp_breakpoint);
1080
1081       /* Fill in with reasonable starting values.  */
1082       init_execution_control_state (async_ecs);
1083
1084       /* We'll update this if & when we switch to a new thread. */
1085       previous_inferior_ptid = inferior_ptid;
1086
1087       overlay_cache_invalid = 1;
1088
1089       /* We have to invalidate the registers BEFORE calling target_wait
1090          because they can be loaded from the target while in target_wait.
1091          This makes remote debugging a bit more efficient for those
1092          targets that provide critical registers as part of their normal
1093          status mechanism. */
1094
1095       registers_changed ();
1096     }
1097
1098   if (target_wait_hook)
1099     async_ecs->ptid =
1100       target_wait_hook (async_ecs->waiton_ptid, async_ecs->wp);
1101   else
1102     async_ecs->ptid = target_wait (async_ecs->waiton_ptid, async_ecs->wp);
1103
1104   /* Now figure out what to do with the result of the result.  */
1105   handle_inferior_event (async_ecs);
1106
1107   if (!async_ecs->wait_some_more)
1108     {
1109       /* Do only the cleanups that have been added by this
1110          function. Let the continuations for the commands do the rest,
1111          if there are any. */
1112       do_exec_cleanups (old_cleanups);
1113       normal_stop ();
1114       if (step_multi && stop_step)
1115         inferior_event_handler (INF_EXEC_CONTINUE, NULL);
1116       else
1117         inferior_event_handler (INF_EXEC_COMPLETE, NULL);
1118     }
1119 }
1120
1121 /* Prepare an execution control state for looping through a
1122    wait_for_inferior-type loop.  */
1123
1124 void
1125 init_execution_control_state (struct execution_control_state *ecs)
1126 {
1127   /* ecs->another_trap? */
1128   ecs->random_signal = 0;
1129   ecs->remove_breakpoints_on_following_step = 0;
1130   ecs->handling_longjmp = 0;    /* FIXME */
1131   ecs->update_step_sp = 0;
1132   ecs->stepping_through_solib_after_catch = 0;
1133   ecs->stepping_through_solib_catchpoints = NULL;
1134   ecs->enable_hw_watchpoints_after_wait = 0;
1135   ecs->stepping_through_sigtramp = 0;
1136   ecs->sal = find_pc_line (prev_pc, 0);
1137   ecs->current_line = ecs->sal.line;
1138   ecs->current_symtab = ecs->sal.symtab;
1139   ecs->infwait_state = infwait_normal_state;
1140   ecs->waiton_ptid = pid_to_ptid (-1);
1141   ecs->wp = &(ecs->ws);
1142 }
1143
1144 /* Call this function before setting step_resume_breakpoint, as a
1145    sanity check.  There should never be more than one step-resume
1146    breakpoint per thread, so we should never be setting a new
1147    step_resume_breakpoint when one is already active.  */
1148 static void
1149 check_for_old_step_resume_breakpoint (void)
1150 {
1151   if (step_resume_breakpoint)
1152     warning
1153       ("GDB bug: infrun.c (wait_for_inferior): dropping old step_resume breakpoint");
1154 }
1155
1156 /* Return the cached copy of the last pid/waitstatus returned by
1157    target_wait()/target_wait_hook().  The data is actually cached by
1158    handle_inferior_event(), which gets called immediately after
1159    target_wait()/target_wait_hook().  */
1160
1161 void
1162 get_last_target_status (ptid_t *ptidp, struct target_waitstatus *status)
1163 {
1164   *ptidp = target_last_wait_ptid;
1165   *status = target_last_waitstatus;
1166 }
1167
1168 /* Switch thread contexts, maintaining "infrun state". */
1169
1170 static void
1171 context_switch (struct execution_control_state *ecs)
1172 {
1173   /* Caution: it may happen that the new thread (or the old one!)
1174      is not in the thread list.  In this case we must not attempt
1175      to "switch context", or we run the risk that our context may
1176      be lost.  This may happen as a result of the target module
1177      mishandling thread creation.  */
1178
1179   if (in_thread_list (inferior_ptid) && in_thread_list (ecs->ptid))
1180     {                           /* Perform infrun state context switch: */
1181       /* Save infrun state for the old thread.  */
1182       save_infrun_state (inferior_ptid, prev_pc,
1183                          trap_expected, step_resume_breakpoint,
1184                          through_sigtramp_breakpoint, step_range_start,
1185                          step_range_end, &step_frame_id,
1186                          ecs->handling_longjmp, ecs->another_trap,
1187                          ecs->stepping_through_solib_after_catch,
1188                          ecs->stepping_through_solib_catchpoints,
1189                          ecs->stepping_through_sigtramp,
1190                          ecs->current_line, ecs->current_symtab, step_sp);
1191
1192       /* Load infrun state for the new thread.  */
1193       load_infrun_state (ecs->ptid, &prev_pc,
1194                          &trap_expected, &step_resume_breakpoint,
1195                          &through_sigtramp_breakpoint, &step_range_start,
1196                          &step_range_end, &step_frame_id,
1197                          &ecs->handling_longjmp, &ecs->another_trap,
1198                          &ecs->stepping_through_solib_after_catch,
1199                          &ecs->stepping_through_solib_catchpoints,
1200                          &ecs->stepping_through_sigtramp,
1201                          &ecs->current_line, &ecs->current_symtab, &step_sp);
1202     }
1203   inferior_ptid = ecs->ptid;
1204 }
1205
1206 /* Wrapper for PC_IN_SIGTRAMP that takes care of the need to find the
1207    function's name.
1208
1209    In a classic example of "left hand VS right hand", "infrun.c" was
1210    trying to improve GDB's performance by caching the result of calls
1211    to calls to find_pc_partial_funtion, while at the same time
1212    find_pc_partial_function was also trying to ramp up performance by
1213    caching its most recent return value.  The below makes the the
1214    function find_pc_partial_function solely responsibile for
1215    performance issues (the local cache that relied on a global
1216    variable - arrrggg - deleted).
1217
1218    Using the testsuite and gcov, it was found that dropping the local
1219    "infrun.c" cache and instead relying on find_pc_partial_function
1220    increased the number of calls to 12000 (from 10000), but the number
1221    of times find_pc_partial_function's cache missed (this is what
1222    matters) was only increased by only 4 (to 3569).  (A quick back of
1223    envelope caculation suggests that the extra 2000 function calls
1224    @1000 extra instructions per call make the 1 MIP VAX testsuite run
1225    take two extra seconds, oops :-)
1226
1227    Long term, this function can be eliminated, replaced by the code:
1228    get_frame_type(current_frame()) == SIGTRAMP_FRAME (for new
1229    architectures this is very cheap).  */
1230
1231 static int
1232 pc_in_sigtramp (CORE_ADDR pc)
1233 {
1234   char *name;
1235   find_pc_partial_function (pc, &name, NULL, NULL);
1236   return PC_IN_SIGTRAMP (pc, name);
1237 }
1238
1239 /* Handle the inferior event in the cases when we just stepped
1240    into a function.  */
1241
1242 static void
1243 handle_step_into_function (struct execution_control_state *ecs)
1244 {
1245   CORE_ADDR real_stop_pc;
1246
1247   if ((step_over_calls == STEP_OVER_NONE)
1248       || ((step_range_end == 1)
1249           && in_prologue (prev_pc, ecs->stop_func_start)))
1250     {
1251       /* I presume that step_over_calls is only 0 when we're
1252          supposed to be stepping at the assembly language level
1253          ("stepi").  Just stop.  */
1254       /* Also, maybe we just did a "nexti" inside a prolog,
1255          so we thought it was a subroutine call but it was not.
1256          Stop as well.  FENN */
1257       stop_step = 1;
1258       print_stop_reason (END_STEPPING_RANGE, 0);
1259       stop_stepping (ecs);
1260       return;
1261     }
1262
1263   if (step_over_calls == STEP_OVER_ALL || IGNORE_HELPER_CALL (stop_pc))
1264     {
1265       /* We're doing a "next".  */
1266
1267       if (legacy_frame_p (current_gdbarch)
1268           && pc_in_sigtramp (stop_pc)
1269           && frame_id_inner (step_frame_id,
1270                              frame_id_build (read_sp (), 0)))
1271         /* NOTE: cagney/2004-03-15: This is only needed for legacy
1272            systems.  On non-legacy systems step_over_function doesn't
1273            use STEP_FRAME_ID and hence the below update "hack" isn't
1274            needed.  */
1275         /* We stepped out of a signal handler, and into its calling
1276            trampoline.  This is misdetected as a subroutine call, but
1277            stepping over the signal trampoline isn't such a bad idea.
1278            In order to do that, we have to ignore the value in
1279            step_frame_id, since that doesn't represent the frame
1280            that'll reach when we return from the signal trampoline.
1281            Otherwise we'll probably continue to the end of the
1282            program.  */
1283         step_frame_id = null_frame_id;
1284
1285       step_over_function (ecs);
1286       keep_going (ecs);
1287       return;
1288     }
1289
1290   /* If we are in a function call trampoline (a stub between
1291      the calling routine and the real function), locate the real
1292      function.  That's what tells us (a) whether we want to step
1293      into it at all, and (b) what prologue we want to run to
1294      the end of, if we do step into it.  */
1295   real_stop_pc = skip_language_trampoline (stop_pc);
1296   if (real_stop_pc == 0)
1297     real_stop_pc = SKIP_TRAMPOLINE_CODE (stop_pc);
1298   if (real_stop_pc != 0)
1299     ecs->stop_func_start = real_stop_pc;
1300
1301   /* If we have line number information for the function we
1302      are thinking of stepping into, step into it.
1303
1304      If there are several symtabs at that PC (e.g. with include
1305      files), just want to know whether *any* of them have line
1306      numbers.  find_pc_line handles this.  */
1307   {
1308     struct symtab_and_line tmp_sal;
1309
1310     tmp_sal = find_pc_line (ecs->stop_func_start, 0);
1311     if (tmp_sal.line != 0)
1312       {
1313         step_into_function (ecs);
1314         return;
1315       }
1316   }
1317
1318   /* If we have no line number and the step-stop-if-no-debug
1319      is set, we stop the step so that the user has a chance to
1320      switch in assembly mode.  */
1321   if (step_over_calls == STEP_OVER_UNDEBUGGABLE && step_stop_if_no_debug)
1322     {
1323       stop_step = 1;
1324       print_stop_reason (END_STEPPING_RANGE, 0);
1325       stop_stepping (ecs);
1326       return;
1327     }
1328
1329   step_over_function (ecs);
1330   keep_going (ecs);
1331   return;
1332 }
1333
1334 static void
1335 adjust_pc_after_break (struct execution_control_state *ecs)
1336 {
1337   CORE_ADDR stop_pc;
1338
1339   /* If this target does not decrement the PC after breakpoints, then
1340      we have nothing to do.  */
1341   if (DECR_PC_AFTER_BREAK == 0)
1342     return;
1343
1344   /* If we've hit a breakpoint, we'll normally be stopped with SIGTRAP.  If
1345      we aren't, just return.
1346
1347      We assume that waitkinds other than TARGET_WAITKIND_STOPPED are not
1348      affected by DECR_PC_AFTER_BREAK.  Other waitkinds which are implemented
1349      by software breakpoints should be handled through the normal breakpoint
1350      layer.
1351      
1352      NOTE drow/2004-01-31: On some targets, breakpoints may generate
1353      different signals (SIGILL or SIGEMT for instance), but it is less
1354      clear where the PC is pointing afterwards.  It may not match
1355      DECR_PC_AFTER_BREAK.  I don't know any specific target that generates
1356      these signals at breakpoints (the code has been in GDB since at least
1357      1992) so I can not guess how to handle them here.
1358      
1359      In earlier versions of GDB, a target with HAVE_NONSTEPPABLE_WATCHPOINTS
1360      would have the PC after hitting a watchpoint affected by
1361      DECR_PC_AFTER_BREAK.  I haven't found any target with both of these set
1362      in GDB history, and it seems unlikely to be correct, so
1363      HAVE_NONSTEPPABLE_WATCHPOINTS is not checked here.  */
1364
1365   if (ecs->ws.kind != TARGET_WAITKIND_STOPPED)
1366     return;
1367
1368   if (ecs->ws.value.sig != TARGET_SIGNAL_TRAP)
1369     return;
1370
1371   /* Find the location where (if we've hit a breakpoint) the breakpoint would
1372      be.  */
1373   stop_pc = read_pc_pid (ecs->ptid) - DECR_PC_AFTER_BREAK;
1374
1375   /* If we're software-single-stepping, then assume this is a breakpoint.
1376      NOTE drow/2004-01-17: This doesn't check that the PC matches, or that
1377      we're even in the right thread.  The software-single-step code needs
1378      some modernization.
1379
1380      If we're not software-single-stepping, then we first check that there
1381      is an enabled software breakpoint at this address.  If there is, and
1382      we weren't using hardware-single-step, then we've hit the breakpoint.
1383
1384      If we were using hardware-single-step, we check prev_pc; if we just
1385      stepped over an inserted software breakpoint, then we should decrement
1386      the PC and eventually report hitting the breakpoint.  The prev_pc check
1387      prevents us from decrementing the PC if we just stepped over a jump
1388      instruction and landed on the instruction after a breakpoint.
1389
1390      The last bit checks that we didn't hit a breakpoint in a signal handler
1391      without an intervening stop in sigtramp, which is detected by a new
1392      stack pointer value below any usual function calling stack adjustments.
1393
1394      NOTE drow/2004-01-17: I'm not sure that this is necessary.  The check
1395      predates checking for software single step at the same time.  Also,
1396      if we've moved into a signal handler we should have seen the
1397      signal.  */
1398
1399   if ((SOFTWARE_SINGLE_STEP_P () && singlestep_breakpoints_inserted_p)
1400       || (software_breakpoint_inserted_here_p (stop_pc)
1401           && !(currently_stepping (ecs)
1402                && prev_pc != stop_pc
1403                && !(step_range_end && INNER_THAN (read_sp (), (step_sp - 16))))))
1404     write_pc_pid (stop_pc, ecs->ptid);
1405 }
1406
1407 /* Given an execution control state that has been freshly filled in
1408    by an event from the inferior, figure out what it means and take
1409    appropriate action.  */
1410
1411 void
1412 handle_inferior_event (struct execution_control_state *ecs)
1413 {
1414   /* NOTE: cagney/2003-03-28: If you're looking at this code and
1415      thinking that the variable stepped_after_stopped_by_watchpoint
1416      isn't used, then you're wrong!  The macro STOPPED_BY_WATCHPOINT,
1417      defined in the file "config/pa/nm-hppah.h", accesses the variable
1418      indirectly.  Mutter something rude about the HP merge.  */
1419   int stepped_after_stopped_by_watchpoint;
1420   int sw_single_step_trap_p = 0;
1421
1422   /* Cache the last pid/waitstatus. */
1423   target_last_wait_ptid = ecs->ptid;
1424   target_last_waitstatus = *ecs->wp;
1425
1426   adjust_pc_after_break (ecs);
1427
1428   switch (ecs->infwait_state)
1429     {
1430     case infwait_thread_hop_state:
1431       /* Cancel the waiton_ptid. */
1432       ecs->waiton_ptid = pid_to_ptid (-1);
1433       /* See comments where a TARGET_WAITKIND_SYSCALL_RETURN event
1434          is serviced in this loop, below. */
1435       if (ecs->enable_hw_watchpoints_after_wait)
1436         {
1437           TARGET_ENABLE_HW_WATCHPOINTS (PIDGET (inferior_ptid));
1438           ecs->enable_hw_watchpoints_after_wait = 0;
1439         }
1440       stepped_after_stopped_by_watchpoint = 0;
1441       break;
1442
1443     case infwait_normal_state:
1444       /* See comments where a TARGET_WAITKIND_SYSCALL_RETURN event
1445          is serviced in this loop, below. */
1446       if (ecs->enable_hw_watchpoints_after_wait)
1447         {
1448           TARGET_ENABLE_HW_WATCHPOINTS (PIDGET (inferior_ptid));
1449           ecs->enable_hw_watchpoints_after_wait = 0;
1450         }
1451       stepped_after_stopped_by_watchpoint = 0;
1452       break;
1453
1454     case infwait_nullified_state:
1455       stepped_after_stopped_by_watchpoint = 0;
1456       break;
1457
1458     case infwait_nonstep_watch_state:
1459       insert_breakpoints ();
1460
1461       /* FIXME-maybe: is this cleaner than setting a flag?  Does it
1462          handle things like signals arriving and other things happening
1463          in combination correctly?  */
1464       stepped_after_stopped_by_watchpoint = 1;
1465       break;
1466
1467     default:
1468       internal_error (__FILE__, __LINE__, "bad switch");
1469     }
1470   ecs->infwait_state = infwait_normal_state;
1471
1472   flush_cached_frames ();
1473
1474   /* If it's a new process, add it to the thread database */
1475
1476   ecs->new_thread_event = (!ptid_equal (ecs->ptid, inferior_ptid)
1477                            && !in_thread_list (ecs->ptid));
1478
1479   if (ecs->ws.kind != TARGET_WAITKIND_EXITED
1480       && ecs->ws.kind != TARGET_WAITKIND_SIGNALLED && ecs->new_thread_event)
1481     {
1482       add_thread (ecs->ptid);
1483
1484       ui_out_text (uiout, "[New ");
1485       ui_out_text (uiout, target_pid_or_tid_to_str (ecs->ptid));
1486       ui_out_text (uiout, "]\n");
1487
1488 #if 0
1489       /* NOTE: This block is ONLY meant to be invoked in case of a
1490          "thread creation event"!  If it is invoked for any other
1491          sort of event (such as a new thread landing on a breakpoint),
1492          the event will be discarded, which is almost certainly
1493          a bad thing!
1494
1495          To avoid this, the low-level module (eg. target_wait)
1496          should call in_thread_list and add_thread, so that the
1497          new thread is known by the time we get here.  */
1498
1499       /* We may want to consider not doing a resume here in order
1500          to give the user a chance to play with the new thread.
1501          It might be good to make that a user-settable option.  */
1502
1503       /* At this point, all threads are stopped (happens
1504          automatically in either the OS or the native code).
1505          Therefore we need to continue all threads in order to
1506          make progress.  */
1507
1508       target_resume (RESUME_ALL, 0, TARGET_SIGNAL_0);
1509       prepare_to_wait (ecs);
1510       return;
1511 #endif
1512     }
1513
1514   switch (ecs->ws.kind)
1515     {
1516     case TARGET_WAITKIND_LOADED:
1517       /* Ignore gracefully during startup of the inferior, as it
1518          might be the shell which has just loaded some objects,
1519          otherwise add the symbols for the newly loaded objects.  */
1520 #ifdef SOLIB_ADD
1521       if (stop_soon == NO_STOP_QUIETLY)
1522         {
1523           /* Remove breakpoints, SOLIB_ADD might adjust
1524              breakpoint addresses via breakpoint_re_set.  */
1525           if (breakpoints_inserted)
1526             remove_breakpoints ();
1527
1528           /* Check for any newly added shared libraries if we're
1529              supposed to be adding them automatically.  Switch
1530              terminal for any messages produced by
1531              breakpoint_re_set.  */
1532           target_terminal_ours_for_output ();
1533           /* NOTE: cagney/2003-11-25: Make certain that the target
1534              stack's section table is kept up-to-date.  Architectures,
1535              (e.g., PPC64), use the section table to perform
1536              operations such as address => section name and hence
1537              require the table to contain all sections (including
1538              those found in shared libraries).  */
1539           /* NOTE: cagney/2003-11-25: Pass current_target and not
1540              exec_ops to SOLIB_ADD.  This is because current GDB is
1541              only tooled to propagate section_table changes out from
1542              the "current_target" (see target_resize_to_sections), and
1543              not up from the exec stratum.  This, of course, isn't
1544              right.  "infrun.c" should only interact with the
1545              exec/process stratum, instead relying on the target stack
1546              to propagate relevant changes (stop, section table
1547              changed, ...) up to other layers.  */
1548           SOLIB_ADD (NULL, 0, &current_target, auto_solib_add);
1549           target_terminal_inferior ();
1550
1551           /* Reinsert breakpoints and continue.  */
1552           if (breakpoints_inserted)
1553             insert_breakpoints ();
1554         }
1555 #endif
1556       resume (0, TARGET_SIGNAL_0);
1557       prepare_to_wait (ecs);
1558       return;
1559
1560     case TARGET_WAITKIND_SPURIOUS:
1561       resume (0, TARGET_SIGNAL_0);
1562       prepare_to_wait (ecs);
1563       return;
1564
1565     case TARGET_WAITKIND_EXITED:
1566       target_terminal_ours ();  /* Must do this before mourn anyway */
1567       print_stop_reason (EXITED, ecs->ws.value.integer);
1568
1569       /* Record the exit code in the convenience variable $_exitcode, so
1570          that the user can inspect this again later.  */
1571       set_internalvar (lookup_internalvar ("_exitcode"),
1572                        value_from_longest (builtin_type_int,
1573                                            (LONGEST) ecs->ws.value.integer));
1574       gdb_flush (gdb_stdout);
1575       target_mourn_inferior ();
1576       singlestep_breakpoints_inserted_p = 0;    /*SOFTWARE_SINGLE_STEP_P() */
1577       stop_print_frame = 0;
1578       stop_stepping (ecs);
1579       return;
1580
1581     case TARGET_WAITKIND_SIGNALLED:
1582       stop_print_frame = 0;
1583       stop_signal = ecs->ws.value.sig;
1584       target_terminal_ours ();  /* Must do this before mourn anyway */
1585
1586       /* Note: By definition of TARGET_WAITKIND_SIGNALLED, we shouldn't
1587          reach here unless the inferior is dead.  However, for years
1588          target_kill() was called here, which hints that fatal signals aren't
1589          really fatal on some systems.  If that's true, then some changes
1590          may be needed. */
1591       target_mourn_inferior ();
1592
1593       print_stop_reason (SIGNAL_EXITED, stop_signal);
1594       singlestep_breakpoints_inserted_p = 0;    /*SOFTWARE_SINGLE_STEP_P() */
1595       stop_stepping (ecs);
1596       return;
1597
1598       /* The following are the only cases in which we keep going;
1599          the above cases end in a continue or goto. */
1600     case TARGET_WAITKIND_FORKED:
1601     case TARGET_WAITKIND_VFORKED:
1602       stop_signal = TARGET_SIGNAL_TRAP;
1603       pending_follow.kind = ecs->ws.kind;
1604
1605       pending_follow.fork_event.parent_pid = PIDGET (ecs->ptid);
1606       pending_follow.fork_event.child_pid = ecs->ws.value.related_pid;
1607
1608       stop_pc = read_pc ();
1609
1610       stop_bpstat = bpstat_stop_status (stop_pc, ecs->ptid);
1611
1612       ecs->random_signal = !bpstat_explains_signal (stop_bpstat);
1613
1614       /* If no catchpoint triggered for this, then keep going.  */
1615       if (ecs->random_signal)
1616         {
1617           stop_signal = TARGET_SIGNAL_0;
1618           keep_going (ecs);
1619           return;
1620         }
1621       goto process_event_stop_test;
1622
1623     case TARGET_WAITKIND_EXECD:
1624       stop_signal = TARGET_SIGNAL_TRAP;
1625
1626       /* NOTE drow/2002-12-05: This code should be pushed down into the
1627          target_wait function.  Until then following vfork on HP/UX 10.20
1628          is probably broken by this.  Of course, it's broken anyway.  */
1629       /* Is this a target which reports multiple exec events per actual
1630          call to exec()?  (HP-UX using ptrace does, for example.)  If so,
1631          ignore all but the last one.  Just resume the exec'r, and wait
1632          for the next exec event. */
1633       if (inferior_ignoring_leading_exec_events)
1634         {
1635           inferior_ignoring_leading_exec_events--;
1636           if (pending_follow.kind == TARGET_WAITKIND_VFORKED)
1637             ENSURE_VFORKING_PARENT_REMAINS_STOPPED (pending_follow.fork_event.
1638                                                     parent_pid);
1639           target_resume (ecs->ptid, 0, TARGET_SIGNAL_0);
1640           prepare_to_wait (ecs);
1641           return;
1642         }
1643       inferior_ignoring_leading_exec_events =
1644         target_reported_exec_events_per_exec_call () - 1;
1645
1646       pending_follow.execd_pathname =
1647         savestring (ecs->ws.value.execd_pathname,
1648                     strlen (ecs->ws.value.execd_pathname));
1649
1650       /* This causes the eventpoints and symbol table to be reset.  Must
1651          do this now, before trying to determine whether to stop. */
1652       follow_exec (PIDGET (inferior_ptid), pending_follow.execd_pathname);
1653       xfree (pending_follow.execd_pathname);
1654
1655       stop_pc = read_pc_pid (ecs->ptid);
1656       ecs->saved_inferior_ptid = inferior_ptid;
1657       inferior_ptid = ecs->ptid;
1658
1659       stop_bpstat = bpstat_stop_status (stop_pc, ecs->ptid);
1660
1661       ecs->random_signal = !bpstat_explains_signal (stop_bpstat);
1662       inferior_ptid = ecs->saved_inferior_ptid;
1663
1664       /* If no catchpoint triggered for this, then keep going.  */
1665       if (ecs->random_signal)
1666         {
1667           stop_signal = TARGET_SIGNAL_0;
1668           keep_going (ecs);
1669           return;
1670         }
1671       goto process_event_stop_test;
1672
1673       /* These syscall events are returned on HP-UX, as part of its
1674          implementation of page-protection-based "hardware" watchpoints.
1675          HP-UX has unfortunate interactions between page-protections and
1676          some system calls.  Our solution is to disable hardware watches
1677          when a system call is entered, and reenable them when the syscall
1678          completes.  The downside of this is that we may miss the precise
1679          point at which a watched piece of memory is modified.  "Oh well."
1680
1681          Note that we may have multiple threads running, which may each
1682          enter syscalls at roughly the same time.  Since we don't have a
1683          good notion currently of whether a watched piece of memory is
1684          thread-private, we'd best not have any page-protections active
1685          when any thread is in a syscall.  Thus, we only want to reenable
1686          hardware watches when no threads are in a syscall.
1687
1688          Also, be careful not to try to gather much state about a thread
1689          that's in a syscall.  It's frequently a losing proposition. */
1690     case TARGET_WAITKIND_SYSCALL_ENTRY:
1691       number_of_threads_in_syscalls++;
1692       if (number_of_threads_in_syscalls == 1)
1693         {
1694           TARGET_DISABLE_HW_WATCHPOINTS (PIDGET (inferior_ptid));
1695         }
1696       resume (0, TARGET_SIGNAL_0);
1697       prepare_to_wait (ecs);
1698       return;
1699
1700       /* Before examining the threads further, step this thread to
1701          get it entirely out of the syscall.  (We get notice of the
1702          event when the thread is just on the verge of exiting a
1703          syscall.  Stepping one instruction seems to get it back
1704          into user code.)
1705
1706          Note that although the logical place to reenable h/w watches
1707          is here, we cannot.  We cannot reenable them before stepping
1708          the thread (this causes the next wait on the thread to hang).
1709
1710          Nor can we enable them after stepping until we've done a wait.
1711          Thus, we simply set the flag ecs->enable_hw_watchpoints_after_wait
1712          here, which will be serviced immediately after the target
1713          is waited on. */
1714     case TARGET_WAITKIND_SYSCALL_RETURN:
1715       target_resume (ecs->ptid, 1, TARGET_SIGNAL_0);
1716
1717       if (number_of_threads_in_syscalls > 0)
1718         {
1719           number_of_threads_in_syscalls--;
1720           ecs->enable_hw_watchpoints_after_wait =
1721             (number_of_threads_in_syscalls == 0);
1722         }
1723       prepare_to_wait (ecs);
1724       return;
1725
1726     case TARGET_WAITKIND_STOPPED:
1727       stop_signal = ecs->ws.value.sig;
1728       break;
1729
1730       /* We had an event in the inferior, but we are not interested
1731          in handling it at this level. The lower layers have already
1732          done what needs to be done, if anything.
1733          
1734          One of the possible circumstances for this is when the
1735          inferior produces output for the console. The inferior has
1736          not stopped, and we are ignoring the event.  Another possible
1737          circumstance is any event which the lower level knows will be
1738          reported multiple times without an intervening resume.  */
1739     case TARGET_WAITKIND_IGNORE:
1740       prepare_to_wait (ecs);
1741       return;
1742     }
1743
1744   /* We may want to consider not doing a resume here in order to give
1745      the user a chance to play with the new thread.  It might be good
1746      to make that a user-settable option.  */
1747
1748   /* At this point, all threads are stopped (happens automatically in
1749      either the OS or the native code).  Therefore we need to continue
1750      all threads in order to make progress.  */
1751   if (ecs->new_thread_event)
1752     {
1753       target_resume (RESUME_ALL, 0, TARGET_SIGNAL_0);
1754       prepare_to_wait (ecs);
1755       return;
1756     }
1757
1758   stop_pc = read_pc_pid (ecs->ptid);
1759
1760   if (stepping_past_singlestep_breakpoint)
1761     {
1762       gdb_assert (SOFTWARE_SINGLE_STEP_P () && singlestep_breakpoints_inserted_p);
1763       gdb_assert (ptid_equal (singlestep_ptid, ecs->ptid));
1764       gdb_assert (!ptid_equal (singlestep_ptid, saved_singlestep_ptid));
1765
1766       stepping_past_singlestep_breakpoint = 0;
1767
1768       /* We've either finished single-stepping past the single-step
1769          breakpoint, or stopped for some other reason.  It would be nice if
1770          we could tell, but we can't reliably.  */
1771       if (stop_signal == TARGET_SIGNAL_TRAP)
1772         {
1773           /* Pull the single step breakpoints out of the target.  */
1774           SOFTWARE_SINGLE_STEP (0, 0);
1775           singlestep_breakpoints_inserted_p = 0;
1776
1777           ecs->random_signal = 0;
1778
1779           ecs->ptid = saved_singlestep_ptid;
1780           context_switch (ecs);
1781           if (context_hook)
1782             context_hook (pid_to_thread_id (ecs->ptid));
1783
1784           resume (1, TARGET_SIGNAL_0);
1785           prepare_to_wait (ecs);
1786           return;
1787         }
1788     }
1789
1790   stepping_past_singlestep_breakpoint = 0;
1791
1792   /* See if a thread hit a thread-specific breakpoint that was meant for
1793      another thread.  If so, then step that thread past the breakpoint,
1794      and continue it.  */
1795
1796   if (stop_signal == TARGET_SIGNAL_TRAP)
1797     {
1798       int thread_hop_needed = 0;
1799
1800       /* Check if a regular breakpoint has been hit before checking
1801          for a potential single step breakpoint. Otherwise, GDB will
1802          not see this breakpoint hit when stepping onto breakpoints.  */
1803       if (breakpoints_inserted && breakpoint_here_p (stop_pc))
1804         {
1805           ecs->random_signal = 0;
1806           if (!breakpoint_thread_match (stop_pc, ecs->ptid))
1807             thread_hop_needed = 1;
1808         }
1809       else if (SOFTWARE_SINGLE_STEP_P () && singlestep_breakpoints_inserted_p)
1810         {
1811           ecs->random_signal = 0;
1812           /* The call to in_thread_list is necessary because PTIDs sometimes
1813              change when we go from single-threaded to multi-threaded.  If
1814              the singlestep_ptid is still in the list, assume that it is
1815              really different from ecs->ptid.  */
1816           if (!ptid_equal (singlestep_ptid, ecs->ptid)
1817               && in_thread_list (singlestep_ptid))
1818             {
1819               thread_hop_needed = 1;
1820               stepping_past_singlestep_breakpoint = 1;
1821               saved_singlestep_ptid = singlestep_ptid;
1822             }
1823         }
1824
1825       if (thread_hop_needed)
1826             {
1827               int remove_status;
1828
1829               /* Saw a breakpoint, but it was hit by the wrong thread.
1830                  Just continue. */
1831
1832               if (SOFTWARE_SINGLE_STEP_P () && singlestep_breakpoints_inserted_p)
1833                 {
1834                   /* Pull the single step breakpoints out of the target. */
1835                   SOFTWARE_SINGLE_STEP (0, 0);
1836                   singlestep_breakpoints_inserted_p = 0;
1837                 }
1838
1839               remove_status = remove_breakpoints ();
1840               /* Did we fail to remove breakpoints?  If so, try
1841                  to set the PC past the bp.  (There's at least
1842                  one situation in which we can fail to remove
1843                  the bp's: On HP-UX's that use ttrace, we can't
1844                  change the address space of a vforking child
1845                  process until the child exits (well, okay, not
1846                  then either :-) or execs. */
1847               if (remove_status != 0)
1848                 {
1849                   /* FIXME!  This is obviously non-portable! */
1850                   write_pc_pid (stop_pc + 4, ecs->ptid);
1851                   /* We need to restart all the threads now,
1852                    * unles we're running in scheduler-locked mode. 
1853                    * Use currently_stepping to determine whether to 
1854                    * step or continue.
1855                    */
1856                   /* FIXME MVS: is there any reason not to call resume()? */
1857                   if (scheduler_mode == schedlock_on)
1858                     target_resume (ecs->ptid,
1859                                    currently_stepping (ecs), TARGET_SIGNAL_0);
1860                   else
1861                     target_resume (RESUME_ALL,
1862                                    currently_stepping (ecs), TARGET_SIGNAL_0);
1863                   prepare_to_wait (ecs);
1864                   return;
1865                 }
1866               else
1867                 {               /* Single step */
1868                   breakpoints_inserted = 0;
1869                   if (!ptid_equal (inferior_ptid, ecs->ptid))
1870                     context_switch (ecs);
1871                   ecs->waiton_ptid = ecs->ptid;
1872                   ecs->wp = &(ecs->ws);
1873                   ecs->another_trap = 1;
1874
1875                   ecs->infwait_state = infwait_thread_hop_state;
1876                   keep_going (ecs);
1877                   registers_changed ();
1878                   return;
1879                 }
1880         }
1881       else if (SOFTWARE_SINGLE_STEP_P () && singlestep_breakpoints_inserted_p)
1882         {
1883           sw_single_step_trap_p = 1;
1884           ecs->random_signal = 0;
1885         }
1886     }
1887   else
1888     ecs->random_signal = 1;
1889
1890   /* See if something interesting happened to the non-current thread.  If
1891      so, then switch to that thread.  */
1892   if (!ptid_equal (ecs->ptid, inferior_ptid))
1893     {
1894       context_switch (ecs);
1895
1896       if (context_hook)
1897         context_hook (pid_to_thread_id (ecs->ptid));
1898
1899       flush_cached_frames ();
1900     }
1901
1902   if (SOFTWARE_SINGLE_STEP_P () && singlestep_breakpoints_inserted_p)
1903     {
1904       /* Pull the single step breakpoints out of the target. */
1905       SOFTWARE_SINGLE_STEP (0, 0);
1906       singlestep_breakpoints_inserted_p = 0;
1907     }
1908
1909   /* If PC is pointing at a nullified instruction, then step beyond
1910      it so that the user won't be confused when GDB appears to be ready
1911      to execute it. */
1912
1913   /*      if (INSTRUCTION_NULLIFIED && currently_stepping (ecs)) */
1914   if (INSTRUCTION_NULLIFIED)
1915     {
1916       registers_changed ();
1917       target_resume (ecs->ptid, 1, TARGET_SIGNAL_0);
1918
1919       /* We may have received a signal that we want to pass to
1920          the inferior; therefore, we must not clobber the waitstatus
1921          in WS. */
1922
1923       ecs->infwait_state = infwait_nullified_state;
1924       ecs->waiton_ptid = ecs->ptid;
1925       ecs->wp = &(ecs->tmpstatus);
1926       prepare_to_wait (ecs);
1927       return;
1928     }
1929
1930   /* It may not be necessary to disable the watchpoint to stop over
1931      it.  For example, the PA can (with some kernel cooperation)
1932      single step over a watchpoint without disabling the watchpoint.  */
1933   if (HAVE_STEPPABLE_WATCHPOINT && STOPPED_BY_WATCHPOINT (ecs->ws))
1934     {
1935       resume (1, 0);
1936       prepare_to_wait (ecs);
1937       return;
1938     }
1939
1940   /* It is far more common to need to disable a watchpoint to step
1941      the inferior over it.  FIXME.  What else might a debug
1942      register or page protection watchpoint scheme need here?  */
1943   if (HAVE_NONSTEPPABLE_WATCHPOINT && STOPPED_BY_WATCHPOINT (ecs->ws))
1944     {
1945       /* At this point, we are stopped at an instruction which has
1946          attempted to write to a piece of memory under control of
1947          a watchpoint.  The instruction hasn't actually executed
1948          yet.  If we were to evaluate the watchpoint expression
1949          now, we would get the old value, and therefore no change
1950          would seem to have occurred.
1951
1952          In order to make watchpoints work `right', we really need
1953          to complete the memory write, and then evaluate the
1954          watchpoint expression.  The following code does that by
1955          removing the watchpoint (actually, all watchpoints and
1956          breakpoints), single-stepping the target, re-inserting
1957          watchpoints, and then falling through to let normal
1958          single-step processing handle proceed.  Since this
1959          includes evaluating watchpoints, things will come to a
1960          stop in the correct manner.  */
1961
1962       remove_breakpoints ();
1963       registers_changed ();
1964       target_resume (ecs->ptid, 1, TARGET_SIGNAL_0);    /* Single step */
1965
1966       ecs->waiton_ptid = ecs->ptid;
1967       ecs->wp = &(ecs->ws);
1968       ecs->infwait_state = infwait_nonstep_watch_state;
1969       prepare_to_wait (ecs);
1970       return;
1971     }
1972
1973   /* It may be possible to simply continue after a watchpoint.  */
1974   if (HAVE_CONTINUABLE_WATCHPOINT)
1975     STOPPED_BY_WATCHPOINT (ecs->ws);
1976
1977   ecs->stop_func_start = 0;
1978   ecs->stop_func_end = 0;
1979   ecs->stop_func_name = 0;
1980   /* Don't care about return value; stop_func_start and stop_func_name
1981      will both be 0 if it doesn't work.  */
1982   find_pc_partial_function (stop_pc, &ecs->stop_func_name,
1983                             &ecs->stop_func_start, &ecs->stop_func_end);
1984   ecs->stop_func_start += FUNCTION_START_OFFSET;
1985   ecs->another_trap = 0;
1986   bpstat_clear (&stop_bpstat);
1987   stop_step = 0;
1988   stop_stack_dummy = 0;
1989   stop_print_frame = 1;
1990   ecs->random_signal = 0;
1991   stopped_by_random_signal = 0;
1992   breakpoints_failed = 0;
1993
1994   /* Look at the cause of the stop, and decide what to do.
1995      The alternatives are:
1996      1) break; to really stop and return to the debugger,
1997      2) drop through to start up again
1998      (set ecs->another_trap to 1 to single step once)
1999      3) set ecs->random_signal to 1, and the decision between 1 and 2
2000      will be made according to the signal handling tables.  */
2001
2002   /* First, distinguish signals caused by the debugger from signals
2003      that have to do with the program's own actions.  Note that
2004      breakpoint insns may cause SIGTRAP or SIGILL or SIGEMT, depending
2005      on the operating system version.  Here we detect when a SIGILL or
2006      SIGEMT is really a breakpoint and change it to SIGTRAP.  We do
2007      something similar for SIGSEGV, since a SIGSEGV will be generated
2008      when we're trying to execute a breakpoint instruction on a
2009      non-executable stack.  This happens for call dummy breakpoints
2010      for architectures like SPARC that place call dummies on the
2011      stack.  */
2012
2013   if (stop_signal == TARGET_SIGNAL_TRAP
2014       || (breakpoints_inserted &&
2015           (stop_signal == TARGET_SIGNAL_ILL
2016            || stop_signal == TARGET_SIGNAL_SEGV
2017            || stop_signal == TARGET_SIGNAL_EMT))
2018       || stop_soon == STOP_QUIETLY
2019       || stop_soon == STOP_QUIETLY_NO_SIGSTOP)
2020     {
2021       if (stop_signal == TARGET_SIGNAL_TRAP && stop_after_trap)
2022         {
2023           stop_print_frame = 0;
2024           stop_stepping (ecs);
2025           return;
2026         }
2027
2028       /* This is originated from start_remote(), start_inferior() and
2029          shared libraries hook functions.  */
2030       if (stop_soon == STOP_QUIETLY)
2031         {
2032           stop_stepping (ecs);
2033           return;
2034         }
2035
2036       /* This originates from attach_command().  We need to overwrite
2037          the stop_signal here, because some kernels don't ignore a
2038          SIGSTOP in a subsequent ptrace(PTRACE_SONT,SOGSTOP) call.
2039          See more comments in inferior.h.  */
2040       if (stop_soon == STOP_QUIETLY_NO_SIGSTOP)
2041         {
2042           stop_stepping (ecs);
2043           if (stop_signal == TARGET_SIGNAL_STOP)
2044             stop_signal = TARGET_SIGNAL_0;
2045           return;
2046         }
2047
2048       /* Don't even think about breakpoints
2049          if just proceeded over a breakpoint.
2050
2051          However, if we are trying to proceed over a breakpoint
2052          and end up in sigtramp, then through_sigtramp_breakpoint
2053          will be set and we should check whether we've hit the
2054          step breakpoint.  */
2055       if (stop_signal == TARGET_SIGNAL_TRAP && trap_expected
2056           && through_sigtramp_breakpoint == NULL)
2057         bpstat_clear (&stop_bpstat);
2058       else
2059         {
2060           /* See if there is a breakpoint at the current PC.  */
2061           stop_bpstat = bpstat_stop_status (stop_pc, ecs->ptid);
2062
2063           /* Following in case break condition called a
2064              function.  */
2065           stop_print_frame = 1;
2066         }
2067
2068       /* NOTE: cagney/2003-03-29: These two checks for a random signal
2069          at one stage in the past included checks for an inferior
2070          function call's call dummy's return breakpoint.  The original
2071          comment, that went with the test, read:
2072
2073          ``End of a stack dummy.  Some systems (e.g. Sony news) give
2074          another signal besides SIGTRAP, so check here as well as
2075          above.''
2076
2077          If someone ever tries to get get call dummys on a
2078          non-executable stack to work (where the target would stop
2079          with something like a SIGSEGV), then those tests might need
2080          to be re-instated.  Given, however, that the tests were only
2081          enabled when momentary breakpoints were not being used, I
2082          suspect that it won't be the case.
2083
2084          NOTE: kettenis/2004-02-05: Indeed such checks don't seem to
2085          be necessary for call dummies on a non-executable stack on
2086          SPARC.  */
2087
2088       if (stop_signal == TARGET_SIGNAL_TRAP)
2089         ecs->random_signal
2090           = !(bpstat_explains_signal (stop_bpstat)
2091               || trap_expected
2092               || (step_range_end && step_resume_breakpoint == NULL));
2093       else
2094         {
2095           ecs->random_signal = !bpstat_explains_signal (stop_bpstat);
2096           if (!ecs->random_signal)
2097             stop_signal = TARGET_SIGNAL_TRAP;
2098         }
2099     }
2100
2101   /* When we reach this point, we've pretty much decided
2102      that the reason for stopping must've been a random
2103      (unexpected) signal. */
2104
2105   else
2106     ecs->random_signal = 1;
2107
2108 process_event_stop_test:
2109   /* For the program's own signals, act according to
2110      the signal handling tables.  */
2111
2112   if (ecs->random_signal)
2113     {
2114       /* Signal not for debugging purposes.  */
2115       int printed = 0;
2116
2117       stopped_by_random_signal = 1;
2118
2119       if (signal_print[stop_signal])
2120         {
2121           printed = 1;
2122           target_terminal_ours_for_output ();
2123           print_stop_reason (SIGNAL_RECEIVED, stop_signal);
2124         }
2125       if (signal_stop[stop_signal])
2126         {
2127           stop_stepping (ecs);
2128           return;
2129         }
2130       /* If not going to stop, give terminal back
2131          if we took it away.  */
2132       else if (printed)
2133         target_terminal_inferior ();
2134
2135       /* Clear the signal if it should not be passed.  */
2136       if (signal_program[stop_signal] == 0)
2137         stop_signal = TARGET_SIGNAL_0;
2138
2139       /* I'm not sure whether this needs to be check_sigtramp2 or
2140          whether it could/should be keep_going.
2141
2142          This used to jump to step_over_function if we are stepping,
2143          which is wrong.
2144
2145          Suppose the user does a `next' over a function call, and while
2146          that call is in progress, the inferior receives a signal for
2147          which GDB does not stop (i.e., signal_stop[SIG] is false).  In
2148          that case, when we reach this point, there is already a
2149          step-resume breakpoint established, right where it should be:
2150          immediately after the function call the user is "next"-ing
2151          over.  If we call step_over_function now, two bad things
2152          happen:
2153
2154          - we'll create a new breakpoint, at wherever the current
2155          frame's return address happens to be.  That could be
2156          anywhere, depending on what function call happens to be on
2157          the top of the stack at that point.  Point is, it's probably
2158          not where we need it.
2159
2160          - the existing step-resume breakpoint (which is at the correct
2161          address) will get orphaned: step_resume_breakpoint will point
2162          to the new breakpoint, and the old step-resume breakpoint
2163          will never be cleaned up.
2164
2165          The old behavior was meant to help HP-UX single-step out of
2166          sigtramps.  It would place the new breakpoint at prev_pc, which
2167          was certainly wrong.  I don't know the details there, so fixing
2168          this probably breaks that.  As with anything else, it's up to
2169          the HP-UX maintainer to furnish a fix that doesn't break other
2170          platforms.  --JimB, 20 May 1999 */
2171       check_sigtramp2 (ecs);
2172       keep_going (ecs);
2173       return;
2174     }
2175
2176   /* Handle cases caused by hitting a breakpoint.  */
2177   {
2178     CORE_ADDR jmp_buf_pc;
2179     struct bpstat_what what;
2180
2181     what = bpstat_what (stop_bpstat);
2182
2183     if (what.call_dummy)
2184       {
2185         stop_stack_dummy = 1;
2186 #ifdef HP_OS_BUG
2187         trap_expected_after_continue = 1;
2188 #endif
2189       }
2190
2191     switch (what.main_action)
2192       {
2193       case BPSTAT_WHAT_SET_LONGJMP_RESUME:
2194         /* If we hit the breakpoint at longjmp, disable it for the
2195            duration of this command.  Then, install a temporary
2196            breakpoint at the target of the jmp_buf. */
2197         disable_longjmp_breakpoint ();
2198         remove_breakpoints ();
2199         breakpoints_inserted = 0;
2200         if (!GET_LONGJMP_TARGET_P () || !GET_LONGJMP_TARGET (&jmp_buf_pc))
2201           {
2202             keep_going (ecs);
2203             return;
2204           }
2205
2206         /* Need to blow away step-resume breakpoint, as it
2207            interferes with us */
2208         if (step_resume_breakpoint != NULL)
2209           {
2210             delete_step_resume_breakpoint (&step_resume_breakpoint);
2211           }
2212         /* Not sure whether we need to blow this away too, but probably
2213            it is like the step-resume breakpoint.  */
2214         if (through_sigtramp_breakpoint != NULL)
2215           {
2216             delete_breakpoint (through_sigtramp_breakpoint);
2217             through_sigtramp_breakpoint = NULL;
2218           }
2219
2220 #if 0
2221         /* FIXME - Need to implement nested temporary breakpoints */
2222         if (step_over_calls > 0)
2223           set_longjmp_resume_breakpoint (jmp_buf_pc, get_current_frame ());
2224         else
2225 #endif /* 0 */
2226           set_longjmp_resume_breakpoint (jmp_buf_pc, null_frame_id);
2227         ecs->handling_longjmp = 1;      /* FIXME */
2228         keep_going (ecs);
2229         return;
2230
2231       case BPSTAT_WHAT_CLEAR_LONGJMP_RESUME:
2232       case BPSTAT_WHAT_CLEAR_LONGJMP_RESUME_SINGLE:
2233         remove_breakpoints ();
2234         breakpoints_inserted = 0;
2235 #if 0
2236         /* FIXME - Need to implement nested temporary breakpoints */
2237         if (step_over_calls
2238             && (frame_id_inner (get_frame_id (get_current_frame ()),
2239                                 step_frame_id)))
2240           {
2241             ecs->another_trap = 1;
2242             keep_going (ecs);
2243             return;
2244           }
2245 #endif /* 0 */
2246         disable_longjmp_breakpoint ();
2247         ecs->handling_longjmp = 0;      /* FIXME */
2248         if (what.main_action == BPSTAT_WHAT_CLEAR_LONGJMP_RESUME)
2249           break;
2250         /* else fallthrough */
2251
2252       case BPSTAT_WHAT_SINGLE:
2253         if (breakpoints_inserted)
2254           {
2255             remove_breakpoints ();
2256           }
2257         breakpoints_inserted = 0;
2258         ecs->another_trap = 1;
2259         /* Still need to check other stuff, at least the case
2260            where we are stepping and step out of the right range.  */
2261         break;
2262
2263       case BPSTAT_WHAT_STOP_NOISY:
2264         stop_print_frame = 1;
2265
2266         /* We are about to nuke the step_resume_breakpoint and
2267            through_sigtramp_breakpoint via the cleanup chain, so
2268            no need to worry about it here.  */
2269
2270         stop_stepping (ecs);
2271         return;
2272
2273       case BPSTAT_WHAT_STOP_SILENT:
2274         stop_print_frame = 0;
2275
2276         /* We are about to nuke the step_resume_breakpoint and
2277            through_sigtramp_breakpoint via the cleanup chain, so
2278            no need to worry about it here.  */
2279
2280         stop_stepping (ecs);
2281         return;
2282
2283       case BPSTAT_WHAT_STEP_RESUME:
2284         /* This proably demands a more elegant solution, but, yeah
2285            right...
2286
2287            This function's use of the simple variable
2288            step_resume_breakpoint doesn't seem to accomodate
2289            simultaneously active step-resume bp's, although the
2290            breakpoint list certainly can.
2291
2292            If we reach here and step_resume_breakpoint is already
2293            NULL, then apparently we have multiple active
2294            step-resume bp's.  We'll just delete the breakpoint we
2295            stopped at, and carry on.  
2296
2297            Correction: what the code currently does is delete a
2298            step-resume bp, but it makes no effort to ensure that
2299            the one deleted is the one currently stopped at.  MVS  */
2300
2301         if (step_resume_breakpoint == NULL)
2302           {
2303             step_resume_breakpoint =
2304               bpstat_find_step_resume_breakpoint (stop_bpstat);
2305           }
2306         delete_step_resume_breakpoint (&step_resume_breakpoint);
2307         break;
2308
2309       case BPSTAT_WHAT_THROUGH_SIGTRAMP:
2310         if (through_sigtramp_breakpoint)
2311           delete_breakpoint (through_sigtramp_breakpoint);
2312         through_sigtramp_breakpoint = NULL;
2313
2314         /* If were waiting for a trap, hitting the step_resume_break
2315            doesn't count as getting it.  */
2316         if (trap_expected)
2317           ecs->another_trap = 1;
2318         break;
2319
2320       case BPSTAT_WHAT_CHECK_SHLIBS:
2321       case BPSTAT_WHAT_CHECK_SHLIBS_RESUME_FROM_HOOK:
2322 #ifdef SOLIB_ADD
2323         {
2324           /* Remove breakpoints, we eventually want to step over the
2325              shlib event breakpoint, and SOLIB_ADD might adjust
2326              breakpoint addresses via breakpoint_re_set.  */
2327           if (breakpoints_inserted)
2328             remove_breakpoints ();
2329           breakpoints_inserted = 0;
2330
2331           /* Check for any newly added shared libraries if we're
2332              supposed to be adding them automatically.  Switch
2333              terminal for any messages produced by
2334              breakpoint_re_set.  */
2335           target_terminal_ours_for_output ();
2336           /* NOTE: cagney/2003-11-25: Make certain that the target
2337              stack's section table is kept up-to-date.  Architectures,
2338              (e.g., PPC64), use the section table to perform
2339              operations such as address => section name and hence
2340              require the table to contain all sections (including
2341              those found in shared libraries).  */
2342           /* NOTE: cagney/2003-11-25: Pass current_target and not
2343              exec_ops to SOLIB_ADD.  This is because current GDB is
2344              only tooled to propagate section_table changes out from
2345              the "current_target" (see target_resize_to_sections), and
2346              not up from the exec stratum.  This, of course, isn't
2347              right.  "infrun.c" should only interact with the
2348              exec/process stratum, instead relying on the target stack
2349              to propagate relevant changes (stop, section table
2350              changed, ...) up to other layers.  */
2351           SOLIB_ADD (NULL, 0, &current_target, auto_solib_add);
2352           target_terminal_inferior ();
2353
2354           /* Try to reenable shared library breakpoints, additional
2355              code segments in shared libraries might be mapped in now. */
2356           re_enable_breakpoints_in_shlibs ();
2357
2358           /* If requested, stop when the dynamic linker notifies
2359              gdb of events.  This allows the user to get control
2360              and place breakpoints in initializer routines for
2361              dynamically loaded objects (among other things).  */
2362           if (stop_on_solib_events || stop_stack_dummy)
2363             {
2364               stop_stepping (ecs);
2365               return;
2366             }
2367
2368           /* If we stopped due to an explicit catchpoint, then the
2369              (see above) call to SOLIB_ADD pulled in any symbols
2370              from a newly-loaded library, if appropriate.
2371
2372              We do want the inferior to stop, but not where it is
2373              now, which is in the dynamic linker callback.  Rather,
2374              we would like it stop in the user's program, just after
2375              the call that caused this catchpoint to trigger.  That
2376              gives the user a more useful vantage from which to
2377              examine their program's state. */
2378           else if (what.main_action ==
2379                    BPSTAT_WHAT_CHECK_SHLIBS_RESUME_FROM_HOOK)
2380             {
2381               /* ??rehrauer: If I could figure out how to get the
2382                  right return PC from here, we could just set a temp
2383                  breakpoint and resume.  I'm not sure we can without
2384                  cracking open the dld's shared libraries and sniffing
2385                  their unwind tables and text/data ranges, and that's
2386                  not a terribly portable notion.
2387
2388                  Until that time, we must step the inferior out of the
2389                  dld callback, and also out of the dld itself (and any
2390                  code or stubs in libdld.sl, such as "shl_load" and
2391                  friends) until we reach non-dld code.  At that point,
2392                  we can stop stepping. */
2393               bpstat_get_triggered_catchpoints (stop_bpstat,
2394                                                 &ecs->
2395                                                 stepping_through_solib_catchpoints);
2396               ecs->stepping_through_solib_after_catch = 1;
2397
2398               /* Be sure to lift all breakpoints, so the inferior does
2399                  actually step past this point... */
2400               ecs->another_trap = 1;
2401               break;
2402             }
2403           else
2404             {
2405               /* We want to step over this breakpoint, then keep going.  */
2406               ecs->another_trap = 1;
2407               break;
2408             }
2409         }
2410 #endif
2411         break;
2412
2413       case BPSTAT_WHAT_LAST:
2414         /* Not a real code, but listed here to shut up gcc -Wall.  */
2415
2416       case BPSTAT_WHAT_KEEP_CHECKING:
2417         break;
2418       }
2419   }
2420
2421   /* We come here if we hit a breakpoint but should not
2422      stop for it.  Possibly we also were stepping
2423      and should stop for that.  So fall through and
2424      test for stepping.  But, if not stepping,
2425      do not stop.  */
2426
2427   /* Are we stepping to get the inferior out of the dynamic
2428      linker's hook (and possibly the dld itself) after catching
2429      a shlib event? */
2430   if (ecs->stepping_through_solib_after_catch)
2431     {
2432 #if defined(SOLIB_ADD)
2433       /* Have we reached our destination?  If not, keep going. */
2434       if (SOLIB_IN_DYNAMIC_LINKER (PIDGET (ecs->ptid), stop_pc))
2435         {
2436           ecs->another_trap = 1;
2437           keep_going (ecs);
2438           return;
2439         }
2440 #endif
2441       /* Else, stop and report the catchpoint(s) whose triggering
2442          caused us to begin stepping. */
2443       ecs->stepping_through_solib_after_catch = 0;
2444       bpstat_clear (&stop_bpstat);
2445       stop_bpstat = bpstat_copy (ecs->stepping_through_solib_catchpoints);
2446       bpstat_clear (&ecs->stepping_through_solib_catchpoints);
2447       stop_print_frame = 1;
2448       stop_stepping (ecs);
2449       return;
2450     }
2451
2452   if (step_resume_breakpoint)
2453     {
2454       /* Having a step-resume breakpoint overrides anything
2455          else having to do with stepping commands until
2456          that breakpoint is reached.  */
2457       /* I'm not sure whether this needs to be check_sigtramp2 or
2458          whether it could/should be keep_going.  */
2459       check_sigtramp2 (ecs);
2460       keep_going (ecs);
2461       return;
2462     }
2463
2464   if (step_range_end == 0)
2465     {
2466       /* Likewise if we aren't even stepping.  */
2467       /* I'm not sure whether this needs to be check_sigtramp2 or
2468          whether it could/should be keep_going.  */
2469       check_sigtramp2 (ecs);
2470       keep_going (ecs);
2471       return;
2472     }
2473
2474   /* If stepping through a line, keep going if still within it.
2475
2476      Note that step_range_end is the address of the first instruction
2477      beyond the step range, and NOT the address of the last instruction
2478      within it! */
2479   if (stop_pc >= step_range_start && stop_pc < step_range_end)
2480     {
2481       /* We might be doing a BPSTAT_WHAT_SINGLE and getting a signal.
2482          So definately need to check for sigtramp here.  */
2483       check_sigtramp2 (ecs);
2484       keep_going (ecs);
2485       return;
2486     }
2487
2488   /* We stepped out of the stepping range.  */
2489
2490   /* If we are stepping at the source level and entered the runtime
2491      loader dynamic symbol resolution code, we keep on single stepping
2492      until we exit the run time loader code and reach the callee's
2493      address.  */
2494   if (step_over_calls == STEP_OVER_UNDEBUGGABLE
2495       && IN_SOLIB_DYNSYM_RESOLVE_CODE (stop_pc))
2496     {
2497       CORE_ADDR pc_after_resolver =
2498         gdbarch_skip_solib_resolver (current_gdbarch, stop_pc);
2499
2500       if (pc_after_resolver)
2501         {
2502           /* Set up a step-resume breakpoint at the address
2503              indicated by SKIP_SOLIB_RESOLVER.  */
2504           struct symtab_and_line sr_sal;
2505           init_sal (&sr_sal);
2506           sr_sal.pc = pc_after_resolver;
2507
2508           check_for_old_step_resume_breakpoint ();
2509           step_resume_breakpoint =
2510             set_momentary_breakpoint (sr_sal, null_frame_id, bp_step_resume);
2511           if (breakpoints_inserted)
2512             insert_breakpoints ();
2513         }
2514
2515       keep_going (ecs);
2516       return;
2517     }
2518
2519   /* We can't update step_sp every time through the loop, because
2520      reading the stack pointer would slow down stepping too much.
2521      But we can update it every time we leave the step range.  */
2522   ecs->update_step_sp = 1;
2523
2524   /* Did we just take a signal?  */
2525   if (pc_in_sigtramp (stop_pc)
2526       && !pc_in_sigtramp (prev_pc)
2527       && INNER_THAN (read_sp (), step_sp))
2528     {
2529       /* We've just taken a signal; go until we are back to
2530          the point where we took it and one more.  */
2531
2532       /* Note: The test above succeeds not only when we stepped
2533          into a signal handler, but also when we step past the last
2534          statement of a signal handler and end up in the return stub
2535          of the signal handler trampoline.  To distinguish between
2536          these two cases, check that the frame is INNER_THAN the
2537          previous one below. pai/1997-09-11 */
2538
2539
2540       {
2541         struct frame_id current_frame = get_frame_id (get_current_frame ());
2542
2543         if (frame_id_inner (current_frame, step_frame_id))
2544           {
2545             /* We have just taken a signal; go until we are back to
2546                the point where we took it and one more.  */
2547
2548             /* This code is needed at least in the following case:
2549                The user types "next" and then a signal arrives (before
2550                the "next" is done).  */
2551
2552             /* Note that if we are stopped at a breakpoint, then we need
2553                the step_resume breakpoint to override any breakpoints at
2554                the same location, so that we will still step over the
2555                breakpoint even though the signal happened.  */
2556             struct symtab_and_line sr_sal;
2557
2558             init_sal (&sr_sal);
2559             sr_sal.symtab = NULL;
2560             sr_sal.line = 0;
2561             sr_sal.pc = prev_pc;
2562             /* We could probably be setting the frame to
2563                step_frame_id; I don't think anyone thought to try it.  */
2564             check_for_old_step_resume_breakpoint ();
2565             step_resume_breakpoint =
2566               set_momentary_breakpoint (sr_sal, null_frame_id, bp_step_resume);
2567             if (breakpoints_inserted)
2568               insert_breakpoints ();
2569           }
2570         else
2571           {
2572             /* We just stepped out of a signal handler and into
2573                its calling trampoline.
2574
2575                Normally, we'd call step_over_function from
2576                here, but for some reason GDB can't unwind the
2577                stack correctly to find the real PC for the point
2578                user code where the signal trampoline will return
2579                -- FRAME_SAVED_PC fails, at least on HP-UX 10.20.
2580                But signal trampolines are pretty small stubs of
2581                code, anyway, so it's OK instead to just
2582                single-step out.  Note: assuming such trampolines
2583                don't exhibit recursion on any platform... */
2584             find_pc_partial_function (stop_pc, &ecs->stop_func_name,
2585                                       &ecs->stop_func_start,
2586                                       &ecs->stop_func_end);
2587             /* Readjust stepping range */
2588             step_range_start = ecs->stop_func_start;
2589             step_range_end = ecs->stop_func_end;
2590             ecs->stepping_through_sigtramp = 1;
2591           }
2592       }
2593
2594
2595       /* If this is stepi or nexti, make sure that the stepping range
2596          gets us past that instruction.  */
2597       if (step_range_end == 1)
2598         /* FIXME: Does this run afoul of the code below which, if
2599            we step into the middle of a line, resets the stepping
2600            range?  */
2601         step_range_end = (step_range_start = prev_pc) + 1;
2602
2603       ecs->remove_breakpoints_on_following_step = 1;
2604       keep_going (ecs);
2605       return;
2606     }
2607
2608   if (((stop_pc == ecs->stop_func_start /* Quick test */
2609         || in_prologue (stop_pc, ecs->stop_func_start))
2610        && !IN_SOLIB_RETURN_TRAMPOLINE (stop_pc, ecs->stop_func_name))
2611       || IN_SOLIB_CALL_TRAMPOLINE (stop_pc, ecs->stop_func_name)
2612       || ecs->stop_func_name == 0)
2613     {
2614       /* It's a subroutine call.  */
2615       handle_step_into_function (ecs);
2616       return;
2617     }
2618
2619   /* We've wandered out of the step range.  */
2620
2621   ecs->sal = find_pc_line (stop_pc, 0);
2622
2623   if (step_range_end == 1)
2624     {
2625       /* It is stepi or nexti.  We always want to stop stepping after
2626          one instruction.  */
2627       stop_step = 1;
2628       print_stop_reason (END_STEPPING_RANGE, 0);
2629       stop_stepping (ecs);
2630       return;
2631     }
2632
2633   /* If we're in the return path from a shared library trampoline,
2634      we want to proceed through the trampoline when stepping.  */
2635   if (IN_SOLIB_RETURN_TRAMPOLINE (stop_pc, ecs->stop_func_name))
2636     {
2637       /* Determine where this trampoline returns.  */
2638       CORE_ADDR real_stop_pc = SKIP_TRAMPOLINE_CODE (stop_pc);
2639
2640       /* Only proceed through if we know where it's going.  */
2641       if (real_stop_pc)
2642         {
2643           /* And put the step-breakpoint there and go until there. */
2644           struct symtab_and_line sr_sal;
2645
2646           init_sal (&sr_sal);   /* initialize to zeroes */
2647           sr_sal.pc = real_stop_pc;
2648           sr_sal.section = find_pc_overlay (sr_sal.pc);
2649           /* Do not specify what the fp should be when we stop
2650              since on some machines the prologue
2651              is where the new fp value is established.  */
2652           check_for_old_step_resume_breakpoint ();
2653           step_resume_breakpoint =
2654             set_momentary_breakpoint (sr_sal, null_frame_id, bp_step_resume);
2655           if (breakpoints_inserted)
2656             insert_breakpoints ();
2657
2658           /* Restart without fiddling with the step ranges or
2659              other state.  */
2660           keep_going (ecs);
2661           return;
2662         }
2663     }
2664
2665   if (ecs->sal.line == 0)
2666     {
2667       /* We have no line number information.  That means to stop
2668          stepping (does this always happen right after one instruction,
2669          when we do "s" in a function with no line numbers,
2670          or can this happen as a result of a return or longjmp?).  */
2671       stop_step = 1;
2672       print_stop_reason (END_STEPPING_RANGE, 0);
2673       stop_stepping (ecs);
2674       return;
2675     }
2676
2677   if ((stop_pc == ecs->sal.pc)
2678       && (ecs->current_line != ecs->sal.line
2679           || ecs->current_symtab != ecs->sal.symtab))
2680     {
2681       /* We are at the start of a different line.  So stop.  Note that
2682          we don't stop if we step into the middle of a different line.
2683          That is said to make things like for (;;) statements work
2684          better.  */
2685       stop_step = 1;
2686       print_stop_reason (END_STEPPING_RANGE, 0);
2687       stop_stepping (ecs);
2688       return;
2689     }
2690
2691   /* We aren't done stepping.
2692
2693      Optimize by setting the stepping range to the line.
2694      (We might not be in the original line, but if we entered a
2695      new line in mid-statement, we continue stepping.  This makes
2696      things like for(;;) statements work better.)  */
2697
2698   if (ecs->stop_func_end && ecs->sal.end >= ecs->stop_func_end)
2699     {
2700       /* If this is the last line of the function, don't keep stepping
2701          (it would probably step us out of the function).
2702          This is particularly necessary for a one-line function,
2703          in which after skipping the prologue we better stop even though
2704          we will be in mid-line.  */
2705       stop_step = 1;
2706       print_stop_reason (END_STEPPING_RANGE, 0);
2707       stop_stepping (ecs);
2708       return;
2709     }
2710   step_range_start = ecs->sal.pc;
2711   step_range_end = ecs->sal.end;
2712   step_frame_id = get_frame_id (get_current_frame ());
2713   ecs->current_line = ecs->sal.line;
2714   ecs->current_symtab = ecs->sal.symtab;
2715
2716   /* In the case where we just stepped out of a function into the
2717      middle of a line of the caller, continue stepping, but
2718      step_frame_id must be modified to current frame */
2719 #if 0
2720   /* NOTE: cagney/2003-10-16: I think this frame ID inner test is too
2721      generous.  It will trigger on things like a step into a frameless
2722      stackless leaf function.  I think the logic should instead look
2723      at the unwound frame ID has that should give a more robust
2724      indication of what happened.  */
2725      if (step-ID == current-ID)
2726        still stepping in same function;
2727      else if (step-ID == unwind (current-ID))
2728        stepped into a function;
2729      else
2730        stepped out of a function;
2731      /* Of course this assumes that the frame ID unwind code is robust
2732         and we're willing to introduce frame unwind logic into this
2733         function.  Fortunately, those days are nearly upon us.  */
2734 #endif
2735   {
2736     struct frame_id current_frame = get_frame_id (get_current_frame ());
2737     if (!(frame_id_inner (current_frame, step_frame_id)))
2738       step_frame_id = current_frame;
2739   }
2740
2741   keep_going (ecs);
2742 }
2743
2744 /* Are we in the middle of stepping?  */
2745
2746 static int
2747 currently_stepping (struct execution_control_state *ecs)
2748 {
2749   return ((through_sigtramp_breakpoint == NULL
2750            && !ecs->handling_longjmp
2751            && ((step_range_end && step_resume_breakpoint == NULL)
2752                || trap_expected))
2753           || ecs->stepping_through_solib_after_catch
2754           || bpstat_should_step ());
2755 }
2756
2757 static void
2758 check_sigtramp2 (struct execution_control_state *ecs)
2759 {
2760   if (trap_expected
2761       && pc_in_sigtramp (stop_pc)
2762       && !pc_in_sigtramp (prev_pc)
2763       && INNER_THAN (read_sp (), step_sp))
2764     {
2765       /* What has happened here is that we have just stepped the
2766          inferior with a signal (because it is a signal which
2767          shouldn't make us stop), thus stepping into sigtramp.
2768
2769          So we need to set a step_resume_break_address breakpoint and
2770          continue until we hit it, and then step.  FIXME: This should
2771          be more enduring than a step_resume breakpoint; we should
2772          know that we will later need to keep going rather than
2773          re-hitting the breakpoint here (see the testsuite,
2774          gdb.base/signals.exp where it says "exceedingly difficult").  */
2775
2776       struct symtab_and_line sr_sal;
2777
2778       init_sal (&sr_sal);       /* initialize to zeroes */
2779       sr_sal.pc = prev_pc;
2780       sr_sal.section = find_pc_overlay (sr_sal.pc);
2781       /* We perhaps could set the frame if we kept track of what the
2782          frame corresponding to prev_pc was.  But we don't, so don't.  */
2783       through_sigtramp_breakpoint =
2784         set_momentary_breakpoint (sr_sal, null_frame_id, bp_through_sigtramp);
2785       if (breakpoints_inserted)
2786         insert_breakpoints ();
2787
2788       ecs->remove_breakpoints_on_following_step = 1;
2789       ecs->another_trap = 1;
2790     }
2791 }
2792
2793 /* Subroutine call with source code we should not step over.  Do step
2794    to the first line of code in it.  */
2795
2796 static void
2797 step_into_function (struct execution_control_state *ecs)
2798 {
2799   struct symtab *s;
2800   struct symtab_and_line sr_sal;
2801
2802   s = find_pc_symtab (stop_pc);
2803   if (s && s->language != language_asm)
2804     ecs->stop_func_start = SKIP_PROLOGUE (ecs->stop_func_start);
2805
2806   ecs->sal = find_pc_line (ecs->stop_func_start, 0);
2807   /* Use the step_resume_break to step until the end of the prologue,
2808      even if that involves jumps (as it seems to on the vax under
2809      4.2).  */
2810   /* If the prologue ends in the middle of a source line, continue to
2811      the end of that source line (if it is still within the function).
2812      Otherwise, just go to end of prologue.  */
2813   if (ecs->sal.end
2814       && ecs->sal.pc != ecs->stop_func_start
2815       && ecs->sal.end < ecs->stop_func_end)
2816     ecs->stop_func_start = ecs->sal.end;
2817
2818   /* Architectures which require breakpoint adjustment might not be able
2819      to place a breakpoint at the computed address.  If so, the test
2820      ``ecs->stop_func_start == stop_pc'' will never succeed.  Adjust
2821      ecs->stop_func_start to an address at which a breakpoint may be
2822      legitimately placed.
2823      
2824      Note:  kevinb/2004-01-19:  On FR-V, if this adjustment is not
2825      made, GDB will enter an infinite loop when stepping through
2826      optimized code consisting of VLIW instructions which contain
2827      subinstructions corresponding to different source lines.  On
2828      FR-V, it's not permitted to place a breakpoint on any but the
2829      first subinstruction of a VLIW instruction.  When a breakpoint is
2830      set, GDB will adjust the breakpoint address to the beginning of
2831      the VLIW instruction.  Thus, we need to make the corresponding
2832      adjustment here when computing the stop address.  */
2833      
2834   if (gdbarch_adjust_breakpoint_address_p (current_gdbarch))
2835     {
2836       ecs->stop_func_start
2837         = gdbarch_adjust_breakpoint_address (current_gdbarch,
2838                                              ecs->stop_func_start);
2839     }
2840
2841   if (ecs->stop_func_start == stop_pc)
2842     {
2843       /* We are already there: stop now.  */
2844       stop_step = 1;
2845       print_stop_reason (END_STEPPING_RANGE, 0);
2846       stop_stepping (ecs);
2847       return;
2848     }
2849   else
2850     {
2851       /* Put the step-breakpoint there and go until there.  */
2852       init_sal (&sr_sal);       /* initialize to zeroes */
2853       sr_sal.pc = ecs->stop_func_start;
2854       sr_sal.section = find_pc_overlay (ecs->stop_func_start);
2855       /* Do not specify what the fp should be when we stop since on
2856          some machines the prologue is where the new fp value is
2857          established.  */
2858       check_for_old_step_resume_breakpoint ();
2859       step_resume_breakpoint =
2860         set_momentary_breakpoint (sr_sal, null_frame_id, bp_step_resume);
2861       if (breakpoints_inserted)
2862         insert_breakpoints ();
2863
2864       /* And make sure stepping stops right away then.  */
2865       step_range_end = step_range_start;
2866     }
2867   keep_going (ecs);
2868 }
2869
2870 /* We've just entered a callee, and we wish to resume until it returns
2871    to the caller.  Setting a step_resume breakpoint on the return
2872    address will catch a return from the callee.
2873      
2874    However, if the callee is recursing, we want to be careful not to
2875    catch returns of those recursive calls, but only of THIS instance
2876    of the caller.
2877
2878    To do this, we set the step_resume bp's frame to our current
2879    caller's frame (obtained by doing a frame ID unwind).  */
2880
2881 static void
2882 step_over_function (struct execution_control_state *ecs)
2883 {
2884   struct symtab_and_line sr_sal;
2885   struct frame_id sr_id;
2886
2887   init_sal (&sr_sal);           /* initialize to zeros */
2888
2889   /* NOTE: cagney/2003-04-06:
2890
2891      At this point the equality get_frame_pc() == get_frame_func()
2892      should hold.  This may make it possible for this code to tell the
2893      frame where it's function is, instead of the reverse.  This would
2894      avoid the need to search for the frame's function, which can get
2895      very messy when there is no debug info available (look at the
2896      heuristic find pc start code found in targets like the MIPS).  */
2897
2898   /* NOTE: cagney/2003-04-06:
2899
2900      The intent of DEPRECATED_SAVED_PC_AFTER_CALL was to:
2901
2902      - provide a very light weight equivalent to frame_unwind_pc()
2903      (nee FRAME_SAVED_PC) that avoids the prologue analyzer
2904
2905      - avoid handling the case where the PC hasn't been saved in the
2906      prologue analyzer
2907
2908      Unfortunately, not five lines further down, is a call to
2909      get_frame_id() and that is guarenteed to trigger the prologue
2910      analyzer.
2911      
2912      The `correct fix' is for the prologe analyzer to handle the case
2913      where the prologue is incomplete (PC in prologue) and,
2914      consequently, the return pc has not yet been saved.  It should be
2915      noted that the prologue analyzer needs to handle this case
2916      anyway: frameless leaf functions that don't save the return PC;
2917      single stepping through a prologue.
2918
2919      The d10v handles all this by bailing out of the prologue analsis
2920      when it reaches the current instruction.  */
2921
2922   if (DEPRECATED_SAVED_PC_AFTER_CALL_P ())
2923     sr_sal.pc = ADDR_BITS_REMOVE (DEPRECATED_SAVED_PC_AFTER_CALL (get_current_frame ()));
2924   else
2925     sr_sal.pc = ADDR_BITS_REMOVE (frame_pc_unwind (get_current_frame ()));
2926   sr_sal.section = find_pc_overlay (sr_sal.pc);
2927
2928   check_for_old_step_resume_breakpoint ();
2929
2930   /* NOTE: cagney/2004-03-15: Code using the current value of
2931      "step_frame_id", instead of unwinding that frame ID, removed (at
2932      least for non-legacy platforms).  On s390 GNU/Linux, after taking
2933      a signal, the program is directly resumed at the signal handler
2934      and, consequently, the PC would point at at the first instruction
2935      of that signal handler but STEP_FRAME_ID would [incorrectly] at
2936      the interrupted code when it should point at the signal
2937      trampoline.  By always and locally doing a frame ID unwind, it's
2938      possible to assert that the code is always using the correct
2939      ID.  */
2940   if (legacy_frame_p (current_gdbarch))
2941     {
2942       if (frame_id_p (step_frame_id)
2943           && !IN_SOLIB_DYNSYM_RESOLVE_CODE (sr_sal.pc))
2944         /* NOTE: cagney/2004-02-27: Use the global state's idea of the
2945            stepping frame ID.  I suspect this is done as it is lighter
2946            weight than a call to get_prev_frame.  */
2947         /* NOTE: cagney/2004-03-15: See comment above about how this
2948            is also broken.  */
2949         sr_id = step_frame_id;
2950       else
2951         /* NOTE: cagney/2004-03-15: This is the way it was 'cos this
2952            is the way it always was.  It should be using the unwound
2953            (or caller's) ID, and not this (or the callee's) ID.  It
2954            appeared to work because: legacy architectures used the
2955            wrong end of the frame for the ID.stack (inner-most rather
2956            than outer-most) so that the callee's id.stack (un
2957            adjusted) matched the caller's id.stack giving the
2958            "correct" id; more often than not
2959            !IN_SOLIB_DYNSYM_RESOLVE_CODE and hence the code above (it
2960            was originally later in the function) fixed the ID by using
2961            global state.  */
2962         sr_id = get_frame_id (get_current_frame ());
2963     }
2964   else
2965     sr_id = get_frame_id (get_prev_frame (get_current_frame ()));
2966
2967   step_resume_breakpoint = set_momentary_breakpoint (sr_sal, sr_id, bp_step_resume);
2968
2969   if (breakpoints_inserted)
2970     insert_breakpoints ();
2971 }
2972
2973 static void
2974 stop_stepping (struct execution_control_state *ecs)
2975 {
2976   /* Let callers know we don't want to wait for the inferior anymore.  */
2977   ecs->wait_some_more = 0;
2978 }
2979
2980 /* This function handles various cases where we need to continue
2981    waiting for the inferior.  */
2982 /* (Used to be the keep_going: label in the old wait_for_inferior) */
2983
2984 static void
2985 keep_going (struct execution_control_state *ecs)
2986 {
2987   /* Save the pc before execution, to compare with pc after stop.  */
2988   prev_pc = read_pc ();         /* Might have been DECR_AFTER_BREAK */
2989
2990   if (ecs->update_step_sp)
2991     step_sp = read_sp ();
2992   ecs->update_step_sp = 0;
2993
2994   /* If we did not do break;, it means we should keep running the
2995      inferior and not return to debugger.  */
2996
2997   if (trap_expected && stop_signal != TARGET_SIGNAL_TRAP)
2998     {
2999       /* We took a signal (which we are supposed to pass through to
3000          the inferior, else we'd have done a break above) and we
3001          haven't yet gotten our trap.  Simply continue.  */
3002       resume (currently_stepping (ecs), stop_signal);
3003     }
3004   else
3005     {
3006       /* Either the trap was not expected, but we are continuing
3007          anyway (the user asked that this signal be passed to the
3008          child)
3009          -- or --
3010          The signal was SIGTRAP, e.g. it was our signal, but we
3011          decided we should resume from it.
3012
3013          We're going to run this baby now!
3014
3015          Insert breakpoints now, unless we are trying to one-proceed
3016          past a breakpoint.  */
3017       /* If we've just finished a special step resume and we don't
3018          want to hit a breakpoint, pull em out.  */
3019       if (step_resume_breakpoint == NULL
3020           && through_sigtramp_breakpoint == NULL
3021           && ecs->remove_breakpoints_on_following_step)
3022         {
3023           ecs->remove_breakpoints_on_following_step = 0;
3024           remove_breakpoints ();
3025           breakpoints_inserted = 0;
3026         }
3027       else if (!breakpoints_inserted &&
3028                (through_sigtramp_breakpoint != NULL || !ecs->another_trap))
3029         {
3030           breakpoints_failed = insert_breakpoints ();
3031           if (breakpoints_failed)
3032             {
3033               stop_stepping (ecs);
3034               return;
3035             }
3036           breakpoints_inserted = 1;
3037         }
3038
3039       trap_expected = ecs->another_trap;
3040
3041       /* Do not deliver SIGNAL_TRAP (except when the user explicitly
3042          specifies that such a signal should be delivered to the
3043          target program).
3044
3045          Typically, this would occure when a user is debugging a
3046          target monitor on a simulator: the target monitor sets a
3047          breakpoint; the simulator encounters this break-point and
3048          halts the simulation handing control to GDB; GDB, noteing
3049          that the break-point isn't valid, returns control back to the
3050          simulator; the simulator then delivers the hardware
3051          equivalent of a SIGNAL_TRAP to the program being debugged. */
3052
3053       if (stop_signal == TARGET_SIGNAL_TRAP && !signal_program[stop_signal])
3054         stop_signal = TARGET_SIGNAL_0;
3055
3056
3057       resume (currently_stepping (ecs), stop_signal);
3058     }
3059
3060   prepare_to_wait (ecs);
3061 }
3062
3063 /* This function normally comes after a resume, before
3064    handle_inferior_event exits.  It takes care of any last bits of
3065    housekeeping, and sets the all-important wait_some_more flag.  */
3066
3067 static void
3068 prepare_to_wait (struct execution_control_state *ecs)
3069 {
3070   if (ecs->infwait_state == infwait_normal_state)
3071     {
3072       overlay_cache_invalid = 1;
3073
3074       /* We have to invalidate the registers BEFORE calling
3075          target_wait because they can be loaded from the target while
3076          in target_wait.  This makes remote debugging a bit more
3077          efficient for those targets that provide critical registers
3078          as part of their normal status mechanism. */
3079
3080       registers_changed ();
3081       ecs->waiton_ptid = pid_to_ptid (-1);
3082       ecs->wp = &(ecs->ws);
3083     }
3084   /* This is the old end of the while loop.  Let everybody know we
3085      want to wait for the inferior some more and get called again
3086      soon.  */
3087   ecs->wait_some_more = 1;
3088 }
3089
3090 /* Print why the inferior has stopped. We always print something when
3091    the inferior exits, or receives a signal. The rest of the cases are
3092    dealt with later on in normal_stop() and print_it_typical().  Ideally
3093    there should be a call to this function from handle_inferior_event()
3094    each time stop_stepping() is called.*/
3095 static void
3096 print_stop_reason (enum inferior_stop_reason stop_reason, int stop_info)
3097 {
3098   switch (stop_reason)
3099     {
3100     case STOP_UNKNOWN:
3101       /* We don't deal with these cases from handle_inferior_event()
3102          yet. */
3103       break;
3104     case END_STEPPING_RANGE:
3105       /* We are done with a step/next/si/ni command. */
3106       /* For now print nothing. */
3107       /* Print a message only if not in the middle of doing a "step n"
3108          operation for n > 1 */
3109       if (!step_multi || !stop_step)
3110         if (ui_out_is_mi_like_p (uiout))
3111           ui_out_field_string (uiout, "reason", "end-stepping-range");
3112       break;
3113     case BREAKPOINT_HIT:
3114       /* We found a breakpoint. */
3115       /* For now print nothing. */
3116       break;
3117     case SIGNAL_EXITED:
3118       /* The inferior was terminated by a signal. */
3119       annotate_signalled ();
3120       if (ui_out_is_mi_like_p (uiout))
3121         ui_out_field_string (uiout, "reason", "exited-signalled");
3122       ui_out_text (uiout, "\nProgram terminated with signal ");
3123       annotate_signal_name ();
3124       ui_out_field_string (uiout, "signal-name",
3125                            target_signal_to_name (stop_info));
3126       annotate_signal_name_end ();
3127       ui_out_text (uiout, ", ");
3128       annotate_signal_string ();
3129       ui_out_field_string (uiout, "signal-meaning",
3130                            target_signal_to_string (stop_info));
3131       annotate_signal_string_end ();
3132       ui_out_text (uiout, ".\n");
3133       ui_out_text (uiout, "The program no longer exists.\n");
3134       break;
3135     case EXITED:
3136       /* The inferior program is finished. */
3137       annotate_exited (stop_info);
3138       if (stop_info)
3139         {
3140           if (ui_out_is_mi_like_p (uiout))
3141             ui_out_field_string (uiout, "reason", "exited");
3142           ui_out_text (uiout, "\nProgram exited with code ");
3143           ui_out_field_fmt (uiout, "exit-code", "0%o",
3144                             (unsigned int) stop_info);
3145           ui_out_text (uiout, ".\n");
3146         }
3147       else
3148         {
3149           if (ui_out_is_mi_like_p (uiout))
3150             ui_out_field_string (uiout, "reason", "exited-normally");
3151           ui_out_text (uiout, "\nProgram exited normally.\n");
3152         }
3153       break;
3154     case SIGNAL_RECEIVED:
3155       /* Signal received. The signal table tells us to print about
3156          it. */
3157       annotate_signal ();
3158       ui_out_text (uiout, "\nProgram received signal ");
3159       annotate_signal_name ();
3160       if (ui_out_is_mi_like_p (uiout))
3161         ui_out_field_string (uiout, "reason", "signal-received");
3162       ui_out_field_string (uiout, "signal-name",
3163                            target_signal_to_name (stop_info));
3164       annotate_signal_name_end ();
3165       ui_out_text (uiout, ", ");
3166       annotate_signal_string ();
3167       ui_out_field_string (uiout, "signal-meaning",
3168                            target_signal_to_string (stop_info));
3169       annotate_signal_string_end ();
3170       ui_out_text (uiout, ".\n");
3171       break;
3172     default:
3173       internal_error (__FILE__, __LINE__,
3174                       "print_stop_reason: unrecognized enum value");
3175       break;
3176     }
3177 }
3178 \f
3179
3180 /* Here to return control to GDB when the inferior stops for real.
3181    Print appropriate messages, remove breakpoints, give terminal our modes.
3182
3183    STOP_PRINT_FRAME nonzero means print the executing frame
3184    (pc, function, args, file, line number and line text).
3185    BREAKPOINTS_FAILED nonzero means stop was due to error
3186    attempting to insert breakpoints.  */
3187
3188 void
3189 normal_stop (void)
3190 {
3191   struct target_waitstatus last;
3192   ptid_t last_ptid;
3193
3194   get_last_target_status (&last_ptid, &last);
3195
3196   /* As with the notification of thread events, we want to delay
3197      notifying the user that we've switched thread context until
3198      the inferior actually stops.
3199
3200      There's no point in saying anything if the inferior has exited.
3201      Note that SIGNALLED here means "exited with a signal", not
3202      "received a signal".  */
3203   if (!ptid_equal (previous_inferior_ptid, inferior_ptid)
3204       && target_has_execution
3205       && last.kind != TARGET_WAITKIND_SIGNALLED
3206       && last.kind != TARGET_WAITKIND_EXITED)
3207     {
3208       target_terminal_ours_for_output ();
3209       printf_filtered ("[Switching to %s]\n",
3210                        target_pid_or_tid_to_str (inferior_ptid));
3211       previous_inferior_ptid = inferior_ptid;
3212     }
3213
3214   /* NOTE drow/2004-01-17: Is this still necessary?  */
3215   /* Make sure that the current_frame's pc is correct.  This
3216      is a correction for setting up the frame info before doing
3217      DECR_PC_AFTER_BREAK */
3218   if (target_has_execution)
3219     /* FIXME: cagney/2002-12-06: Has the PC changed?  Thanks to
3220        DECR_PC_AFTER_BREAK, the program counter can change.  Ask the
3221        frame code to check for this and sort out any resultant mess.
3222        DECR_PC_AFTER_BREAK needs to just go away.  */
3223     deprecated_update_frame_pc_hack (get_current_frame (), read_pc ());
3224
3225   if (target_has_execution && breakpoints_inserted)
3226     {
3227       if (remove_breakpoints ())
3228         {
3229           target_terminal_ours_for_output ();
3230           printf_filtered ("Cannot remove breakpoints because ");
3231           printf_filtered ("program is no longer writable.\n");
3232           printf_filtered ("It might be running in another process.\n");
3233           printf_filtered ("Further execution is probably impossible.\n");
3234         }
3235     }
3236   breakpoints_inserted = 0;
3237
3238   /* Delete the breakpoint we stopped at, if it wants to be deleted.
3239      Delete any breakpoint that is to be deleted at the next stop.  */
3240
3241   breakpoint_auto_delete (stop_bpstat);
3242
3243   /* If an auto-display called a function and that got a signal,
3244      delete that auto-display to avoid an infinite recursion.  */
3245
3246   if (stopped_by_random_signal)
3247     disable_current_display ();
3248
3249   /* Don't print a message if in the middle of doing a "step n"
3250      operation for n > 1 */
3251   if (step_multi && stop_step)
3252     goto done;
3253
3254   target_terminal_ours ();
3255
3256   /* Look up the hook_stop and run it (CLI internally handles problem
3257      of stop_command's pre-hook not existing).  */
3258   if (stop_command)
3259     catch_errors (hook_stop_stub, stop_command,
3260                   "Error while running hook_stop:\n", RETURN_MASK_ALL);
3261
3262   if (!target_has_stack)
3263     {
3264
3265       goto done;
3266     }
3267
3268   /* Select innermost stack frame - i.e., current frame is frame 0,
3269      and current location is based on that.
3270      Don't do this on return from a stack dummy routine,
3271      or if the program has exited. */
3272
3273   if (!stop_stack_dummy)
3274     {
3275       select_frame (get_current_frame ());
3276
3277       /* Print current location without a level number, if
3278          we have changed functions or hit a breakpoint.
3279          Print source line if we have one.
3280          bpstat_print() contains the logic deciding in detail
3281          what to print, based on the event(s) that just occurred. */
3282
3283       if (stop_print_frame && deprecated_selected_frame)
3284         {
3285           int bpstat_ret;
3286           int source_flag;
3287           int do_frame_printing = 1;
3288
3289           bpstat_ret = bpstat_print (stop_bpstat);
3290           switch (bpstat_ret)
3291             {
3292             case PRINT_UNKNOWN:
3293               /* FIXME: cagney/2002-12-01: Given that a frame ID does
3294                  (or should) carry around the function and does (or
3295                  should) use that when doing a frame comparison.  */
3296               if (stop_step
3297                   && frame_id_eq (step_frame_id,
3298                                   get_frame_id (get_current_frame ()))
3299                   && step_start_function == find_pc_function (stop_pc))
3300                 source_flag = SRC_LINE; /* finished step, just print source line */
3301               else
3302                 source_flag = SRC_AND_LOC;      /* print location and source line */
3303               break;
3304             case PRINT_SRC_AND_LOC:
3305               source_flag = SRC_AND_LOC;        /* print location and source line */
3306               break;
3307             case PRINT_SRC_ONLY:
3308               source_flag = SRC_LINE;
3309               break;
3310             case PRINT_NOTHING:
3311               source_flag = SRC_LINE;   /* something bogus */
3312               do_frame_printing = 0;
3313               break;
3314             default:
3315               internal_error (__FILE__, __LINE__, "Unknown value.");
3316             }
3317           /* For mi, have the same behavior every time we stop:
3318              print everything but the source line. */
3319           if (ui_out_is_mi_like_p (uiout))
3320             source_flag = LOC_AND_ADDRESS;
3321
3322           if (ui_out_is_mi_like_p (uiout))
3323             ui_out_field_int (uiout, "thread-id",
3324                               pid_to_thread_id (inferior_ptid));
3325           /* The behavior of this routine with respect to the source
3326              flag is:
3327              SRC_LINE: Print only source line
3328              LOCATION: Print only location
3329              SRC_AND_LOC: Print location and source line */
3330           if (do_frame_printing)
3331             print_stack_frame (deprecated_selected_frame, -1, source_flag);
3332
3333           /* Display the auto-display expressions.  */
3334           do_displays ();
3335         }
3336     }
3337
3338   /* Save the function value return registers, if we care.
3339      We might be about to restore their previous contents.  */
3340   if (proceed_to_finish)
3341     /* NB: The copy goes through to the target picking up the value of
3342        all the registers.  */
3343     regcache_cpy (stop_registers, current_regcache);
3344
3345   if (stop_stack_dummy)
3346     {
3347       /* Pop the empty frame that contains the stack dummy.  POP_FRAME
3348          ends with a setting of the current frame, so we can use that
3349          next. */
3350       frame_pop (get_current_frame ());
3351       /* Set stop_pc to what it was before we called the function.
3352          Can't rely on restore_inferior_status because that only gets
3353          called if we don't stop in the called function.  */
3354       stop_pc = read_pc ();
3355       select_frame (get_current_frame ());
3356     }
3357
3358 done:
3359   annotate_stopped ();
3360   observer_notify_normal_stop ();
3361 }
3362
3363 static int
3364 hook_stop_stub (void *cmd)
3365 {
3366   execute_cmd_pre_hook ((struct cmd_list_element *) cmd);
3367   return (0);
3368 }
3369 \f
3370 int
3371 signal_stop_state (int signo)
3372 {
3373   return signal_stop[signo];
3374 }
3375
3376 int
3377 signal_print_state (int signo)
3378 {
3379   return signal_print[signo];
3380 }
3381
3382 int
3383 signal_pass_state (int signo)
3384 {
3385   return signal_program[signo];
3386 }
3387
3388 int
3389 signal_stop_update (int signo, int state)
3390 {
3391   int ret = signal_stop[signo];
3392   signal_stop[signo] = state;
3393   return ret;
3394 }
3395
3396 int
3397 signal_print_update (int signo, int state)
3398 {
3399   int ret = signal_print[signo];
3400   signal_print[signo] = state;
3401   return ret;
3402 }
3403
3404 int
3405 signal_pass_update (int signo, int state)
3406 {
3407   int ret = signal_program[signo];
3408   signal_program[signo] = state;
3409   return ret;
3410 }
3411
3412 static void
3413 sig_print_header (void)
3414 {
3415   printf_filtered ("\
3416 Signal        Stop\tPrint\tPass to program\tDescription\n");
3417 }
3418
3419 static void
3420 sig_print_info (enum target_signal oursig)
3421 {
3422   char *name = target_signal_to_name (oursig);
3423   int name_padding = 13 - strlen (name);
3424
3425   if (name_padding <= 0)
3426     name_padding = 0;
3427
3428   printf_filtered ("%s", name);
3429   printf_filtered ("%*.*s ", name_padding, name_padding, "                 ");
3430   printf_filtered ("%s\t", signal_stop[oursig] ? "Yes" : "No");
3431   printf_filtered ("%s\t", signal_print[oursig] ? "Yes" : "No");
3432   printf_filtered ("%s\t\t", signal_program[oursig] ? "Yes" : "No");
3433   printf_filtered ("%s\n", target_signal_to_string (oursig));
3434 }
3435
3436 /* Specify how various signals in the inferior should be handled.  */
3437
3438 static void
3439 handle_command (char *args, int from_tty)
3440 {
3441   char **argv;
3442   int digits, wordlen;
3443   int sigfirst, signum, siglast;
3444   enum target_signal oursig;
3445   int allsigs;
3446   int nsigs;
3447   unsigned char *sigs;
3448   struct cleanup *old_chain;
3449
3450   if (args == NULL)
3451     {
3452       error_no_arg ("signal to handle");
3453     }
3454
3455   /* Allocate and zero an array of flags for which signals to handle. */
3456
3457   nsigs = (int) TARGET_SIGNAL_LAST;
3458   sigs = (unsigned char *) alloca (nsigs);
3459   memset (sigs, 0, nsigs);
3460
3461   /* Break the command line up into args. */
3462
3463   argv = buildargv (args);
3464   if (argv == NULL)
3465     {
3466       nomem (0);
3467     }
3468   old_chain = make_cleanup_freeargv (argv);
3469
3470   /* Walk through the args, looking for signal oursigs, signal names, and
3471      actions.  Signal numbers and signal names may be interspersed with
3472      actions, with the actions being performed for all signals cumulatively
3473      specified.  Signal ranges can be specified as <LOW>-<HIGH>. */
3474
3475   while (*argv != NULL)
3476     {
3477       wordlen = strlen (*argv);
3478       for (digits = 0; isdigit ((*argv)[digits]); digits++)
3479         {;
3480         }
3481       allsigs = 0;
3482       sigfirst = siglast = -1;
3483
3484       if (wordlen >= 1 && !strncmp (*argv, "all", wordlen))
3485         {
3486           /* Apply action to all signals except those used by the
3487              debugger.  Silently skip those. */
3488           allsigs = 1;
3489           sigfirst = 0;
3490           siglast = nsigs - 1;
3491         }
3492       else if (wordlen >= 1 && !strncmp (*argv, "stop", wordlen))
3493         {
3494           SET_SIGS (nsigs, sigs, signal_stop);
3495           SET_SIGS (nsigs, sigs, signal_print);
3496         }
3497       else if (wordlen >= 1 && !strncmp (*argv, "ignore", wordlen))
3498         {
3499           UNSET_SIGS (nsigs, sigs, signal_program);
3500         }
3501       else if (wordlen >= 2 && !strncmp (*argv, "print", wordlen))
3502         {
3503           SET_SIGS (nsigs, sigs, signal_print);
3504         }
3505       else if (wordlen >= 2 && !strncmp (*argv, "pass", wordlen))
3506         {
3507           SET_SIGS (nsigs, sigs, signal_program);
3508         }
3509       else if (wordlen >= 3 && !strncmp (*argv, "nostop", wordlen))
3510         {
3511           UNSET_SIGS (nsigs, sigs, signal_stop);
3512         }
3513       else if (wordlen >= 3 && !strncmp (*argv, "noignore", wordlen))
3514         {
3515           SET_SIGS (nsigs, sigs, signal_program);
3516         }
3517       else if (wordlen >= 4 && !strncmp (*argv, "noprint", wordlen))
3518         {
3519           UNSET_SIGS (nsigs, sigs, signal_print);
3520           UNSET_SIGS (nsigs, sigs, signal_stop);
3521         }
3522       else if (wordlen >= 4 && !strncmp (*argv, "nopass", wordlen))
3523         {
3524           UNSET_SIGS (nsigs, sigs, signal_program);
3525         }
3526       else if (digits > 0)
3527         {
3528           /* It is numeric.  The numeric signal refers to our own
3529              internal signal numbering from target.h, not to host/target
3530              signal  number.  This is a feature; users really should be
3531              using symbolic names anyway, and the common ones like
3532              SIGHUP, SIGINT, SIGALRM, etc. will work right anyway.  */
3533
3534           sigfirst = siglast = (int)
3535             target_signal_from_command (atoi (*argv));
3536           if ((*argv)[digits] == '-')
3537             {
3538               siglast = (int)
3539                 target_signal_from_command (atoi ((*argv) + digits + 1));
3540             }
3541           if (sigfirst > siglast)
3542             {
3543               /* Bet he didn't figure we'd think of this case... */
3544               signum = sigfirst;
3545               sigfirst = siglast;
3546               siglast = signum;
3547             }
3548         }
3549       else
3550         {
3551           oursig = target_signal_from_name (*argv);
3552           if (oursig != TARGET_SIGNAL_UNKNOWN)
3553             {
3554               sigfirst = siglast = (int) oursig;
3555             }
3556           else
3557             {
3558               /* Not a number and not a recognized flag word => complain.  */
3559               error ("Unrecognized or ambiguous flag word: \"%s\".", *argv);
3560             }
3561         }
3562
3563       /* If any signal numbers or symbol names were found, set flags for
3564          which signals to apply actions to. */
3565
3566       for (signum = sigfirst; signum >= 0 && signum <= siglast; signum++)
3567         {
3568           switch ((enum target_signal) signum)
3569             {
3570             case TARGET_SIGNAL_TRAP:
3571             case TARGET_SIGNAL_INT:
3572               if (!allsigs && !sigs[signum])
3573                 {
3574                   if (query ("%s is used by the debugger.\n\
3575 Are you sure you want to change it? ", target_signal_to_name ((enum target_signal) signum)))
3576                     {
3577                       sigs[signum] = 1;
3578                     }
3579                   else
3580                     {
3581                       printf_unfiltered ("Not confirmed, unchanged.\n");
3582                       gdb_flush (gdb_stdout);
3583                     }
3584                 }
3585               break;
3586             case TARGET_SIGNAL_0:
3587             case TARGET_SIGNAL_DEFAULT:
3588             case TARGET_SIGNAL_UNKNOWN:
3589               /* Make sure that "all" doesn't print these.  */
3590               break;
3591             default:
3592               sigs[signum] = 1;
3593               break;
3594             }
3595         }
3596
3597       argv++;
3598     }
3599
3600   target_notice_signals (inferior_ptid);
3601
3602   if (from_tty)
3603     {
3604       /* Show the results.  */
3605       sig_print_header ();
3606       for (signum = 0; signum < nsigs; signum++)
3607         {
3608           if (sigs[signum])
3609             {
3610               sig_print_info (signum);
3611             }
3612         }
3613     }
3614
3615   do_cleanups (old_chain);
3616 }
3617
3618 static void
3619 xdb_handle_command (char *args, int from_tty)
3620 {
3621   char **argv;
3622   struct cleanup *old_chain;
3623
3624   /* Break the command line up into args. */
3625
3626   argv = buildargv (args);
3627   if (argv == NULL)
3628     {
3629       nomem (0);
3630     }
3631   old_chain = make_cleanup_freeargv (argv);
3632   if (argv[1] != (char *) NULL)
3633     {
3634       char *argBuf;
3635       int bufLen;
3636
3637       bufLen = strlen (argv[0]) + 20;
3638       argBuf = (char *) xmalloc (bufLen);
3639       if (argBuf)
3640         {
3641           int validFlag = 1;
3642           enum target_signal oursig;
3643
3644           oursig = target_signal_from_name (argv[0]);
3645           memset (argBuf, 0, bufLen);
3646           if (strcmp (argv[1], "Q") == 0)
3647             sprintf (argBuf, "%s %s", argv[0], "noprint");
3648           else
3649             {
3650               if (strcmp (argv[1], "s") == 0)
3651                 {
3652                   if (!signal_stop[oursig])
3653                     sprintf (argBuf, "%s %s", argv[0], "stop");
3654                   else
3655                     sprintf (argBuf, "%s %s", argv[0], "nostop");
3656                 }
3657               else if (strcmp (argv[1], "i") == 0)
3658                 {
3659                   if (!signal_program[oursig])
3660                     sprintf (argBuf, "%s %s", argv[0], "pass");
3661                   else
3662                     sprintf (argBuf, "%s %s", argv[0], "nopass");
3663                 }
3664               else if (strcmp (argv[1], "r") == 0)
3665                 {
3666                   if (!signal_print[oursig])
3667                     sprintf (argBuf, "%s %s", argv[0], "print");
3668                   else
3669                     sprintf (argBuf, "%s %s", argv[0], "noprint");
3670                 }
3671               else
3672                 validFlag = 0;
3673             }
3674           if (validFlag)
3675             handle_command (argBuf, from_tty);
3676           else
3677             printf_filtered ("Invalid signal handling flag.\n");
3678           if (argBuf)
3679             xfree (argBuf);
3680         }
3681     }
3682   do_cleanups (old_chain);
3683 }
3684
3685 /* Print current contents of the tables set by the handle command.
3686    It is possible we should just be printing signals actually used
3687    by the current target (but for things to work right when switching
3688    targets, all signals should be in the signal tables).  */
3689
3690 static void
3691 signals_info (char *signum_exp, int from_tty)
3692 {
3693   enum target_signal oursig;
3694   sig_print_header ();
3695
3696   if (signum_exp)
3697     {
3698       /* First see if this is a symbol name.  */
3699       oursig = target_signal_from_name (signum_exp);
3700       if (oursig == TARGET_SIGNAL_UNKNOWN)
3701         {
3702           /* No, try numeric.  */
3703           oursig =
3704             target_signal_from_command (parse_and_eval_long (signum_exp));
3705         }
3706       sig_print_info (oursig);
3707       return;
3708     }
3709
3710   printf_filtered ("\n");
3711   /* These ugly casts brought to you by the native VAX compiler.  */
3712   for (oursig = TARGET_SIGNAL_FIRST;
3713        (int) oursig < (int) TARGET_SIGNAL_LAST;
3714        oursig = (enum target_signal) ((int) oursig + 1))
3715     {
3716       QUIT;
3717
3718       if (oursig != TARGET_SIGNAL_UNKNOWN
3719           && oursig != TARGET_SIGNAL_DEFAULT && oursig != TARGET_SIGNAL_0)
3720         sig_print_info (oursig);
3721     }
3722
3723   printf_filtered ("\nUse the \"handle\" command to change these tables.\n");
3724 }
3725 \f
3726 struct inferior_status
3727 {
3728   enum target_signal stop_signal;
3729   CORE_ADDR stop_pc;
3730   bpstat stop_bpstat;
3731   int stop_step;
3732   int stop_stack_dummy;
3733   int stopped_by_random_signal;
3734   int trap_expected;
3735   CORE_ADDR step_range_start;
3736   CORE_ADDR step_range_end;
3737   struct frame_id step_frame_id;
3738   enum step_over_calls_kind step_over_calls;
3739   CORE_ADDR step_resume_break_address;
3740   int stop_after_trap;
3741   int stop_soon;
3742   struct regcache *stop_registers;
3743
3744   /* These are here because if call_function_by_hand has written some
3745      registers and then decides to call error(), we better not have changed
3746      any registers.  */
3747   struct regcache *registers;
3748
3749   /* A frame unique identifier.  */
3750   struct frame_id selected_frame_id;
3751
3752   int breakpoint_proceeded;
3753   int restore_stack_info;
3754   int proceed_to_finish;
3755 };
3756
3757 void
3758 write_inferior_status_register (struct inferior_status *inf_status, int regno,
3759                                 LONGEST val)
3760 {
3761   int size = DEPRECATED_REGISTER_RAW_SIZE (regno);
3762   void *buf = alloca (size);
3763   store_signed_integer (buf, size, val);
3764   regcache_raw_write (inf_status->registers, regno, buf);
3765 }
3766
3767 /* Save all of the information associated with the inferior<==>gdb
3768    connection.  INF_STATUS is a pointer to a "struct inferior_status"
3769    (defined in inferior.h).  */
3770
3771 struct inferior_status *
3772 save_inferior_status (int restore_stack_info)
3773 {
3774   struct inferior_status *inf_status = XMALLOC (struct inferior_status);
3775
3776   inf_status->stop_signal = stop_signal;
3777   inf_status->stop_pc = stop_pc;
3778   inf_status->stop_step = stop_step;
3779   inf_status->stop_stack_dummy = stop_stack_dummy;
3780   inf_status->stopped_by_random_signal = stopped_by_random_signal;
3781   inf_status->trap_expected = trap_expected;
3782   inf_status->step_range_start = step_range_start;
3783   inf_status->step_range_end = step_range_end;
3784   inf_status->step_frame_id = step_frame_id;
3785   inf_status->step_over_calls = step_over_calls;
3786   inf_status->stop_after_trap = stop_after_trap;
3787   inf_status->stop_soon = stop_soon;
3788   /* Save original bpstat chain here; replace it with copy of chain.
3789      If caller's caller is walking the chain, they'll be happier if we
3790      hand them back the original chain when restore_inferior_status is
3791      called.  */
3792   inf_status->stop_bpstat = stop_bpstat;
3793   stop_bpstat = bpstat_copy (stop_bpstat);
3794   inf_status->breakpoint_proceeded = breakpoint_proceeded;
3795   inf_status->restore_stack_info = restore_stack_info;
3796   inf_status->proceed_to_finish = proceed_to_finish;
3797
3798   inf_status->stop_registers = regcache_dup_no_passthrough (stop_registers);
3799
3800   inf_status->registers = regcache_dup (current_regcache);
3801
3802   inf_status->selected_frame_id = get_frame_id (deprecated_selected_frame);
3803   return inf_status;
3804 }
3805
3806 static int
3807 restore_selected_frame (void *args)
3808 {
3809   struct frame_id *fid = (struct frame_id *) args;
3810   struct frame_info *frame;
3811
3812   frame = frame_find_by_id (*fid);
3813
3814   /* If inf_status->selected_frame_id is NULL, there was no previously
3815      selected frame.  */
3816   if (frame == NULL)
3817     {
3818       warning ("Unable to restore previously selected frame.\n");
3819       return 0;
3820     }
3821
3822   select_frame (frame);
3823
3824   return (1);
3825 }
3826
3827 void
3828 restore_inferior_status (struct inferior_status *inf_status)
3829 {
3830   stop_signal = inf_status->stop_signal;
3831   stop_pc = inf_status->stop_pc;
3832   stop_step = inf_status->stop_step;
3833   stop_stack_dummy = inf_status->stop_stack_dummy;
3834   stopped_by_random_signal = inf_status->stopped_by_random_signal;
3835   trap_expected = inf_status->trap_expected;
3836   step_range_start = inf_status->step_range_start;
3837   step_range_end = inf_status->step_range_end;
3838   step_frame_id = inf_status->step_frame_id;
3839   step_over_calls = inf_status->step_over_calls;
3840   stop_after_trap = inf_status->stop_after_trap;
3841   stop_soon = inf_status->stop_soon;
3842   bpstat_clear (&stop_bpstat);
3843   stop_bpstat = inf_status->stop_bpstat;
3844   breakpoint_proceeded = inf_status->breakpoint_proceeded;
3845   proceed_to_finish = inf_status->proceed_to_finish;
3846
3847   /* FIXME: Is the restore of stop_registers always needed. */
3848   regcache_xfree (stop_registers);
3849   stop_registers = inf_status->stop_registers;
3850
3851   /* The inferior can be gone if the user types "print exit(0)"
3852      (and perhaps other times).  */
3853   if (target_has_execution)
3854     /* NB: The register write goes through to the target.  */
3855     regcache_cpy (current_regcache, inf_status->registers);
3856   regcache_xfree (inf_status->registers);
3857
3858   /* FIXME: If we are being called after stopping in a function which
3859      is called from gdb, we should not be trying to restore the
3860      selected frame; it just prints a spurious error message (The
3861      message is useful, however, in detecting bugs in gdb (like if gdb
3862      clobbers the stack)).  In fact, should we be restoring the
3863      inferior status at all in that case?  .  */
3864
3865   if (target_has_stack && inf_status->restore_stack_info)
3866     {
3867       /* The point of catch_errors is that if the stack is clobbered,
3868          walking the stack might encounter a garbage pointer and
3869          error() trying to dereference it.  */
3870       if (catch_errors
3871           (restore_selected_frame, &inf_status->selected_frame_id,
3872            "Unable to restore previously selected frame:\n",
3873            RETURN_MASK_ERROR) == 0)
3874         /* Error in restoring the selected frame.  Select the innermost
3875            frame.  */
3876         select_frame (get_current_frame ());
3877
3878     }
3879
3880   xfree (inf_status);
3881 }
3882
3883 static void
3884 do_restore_inferior_status_cleanup (void *sts)
3885 {
3886   restore_inferior_status (sts);
3887 }
3888
3889 struct cleanup *
3890 make_cleanup_restore_inferior_status (struct inferior_status *inf_status)
3891 {
3892   return make_cleanup (do_restore_inferior_status_cleanup, inf_status);
3893 }
3894
3895 void
3896 discard_inferior_status (struct inferior_status *inf_status)
3897 {
3898   /* See save_inferior_status for info on stop_bpstat. */
3899   bpstat_clear (&inf_status->stop_bpstat);
3900   regcache_xfree (inf_status->registers);
3901   regcache_xfree (inf_status->stop_registers);
3902   xfree (inf_status);
3903 }
3904
3905 int
3906 inferior_has_forked (int pid, int *child_pid)
3907 {
3908   struct target_waitstatus last;
3909   ptid_t last_ptid;
3910
3911   get_last_target_status (&last_ptid, &last);
3912
3913   if (last.kind != TARGET_WAITKIND_FORKED)
3914     return 0;
3915
3916   if (ptid_get_pid (last_ptid) != pid)
3917     return 0;
3918
3919   *child_pid = last.value.related_pid;
3920   return 1;
3921 }
3922
3923 int
3924 inferior_has_vforked (int pid, int *child_pid)
3925 {
3926   struct target_waitstatus last;
3927   ptid_t last_ptid;
3928
3929   get_last_target_status (&last_ptid, &last);
3930
3931   if (last.kind != TARGET_WAITKIND_VFORKED)
3932     return 0;
3933
3934   if (ptid_get_pid (last_ptid) != pid)
3935     return 0;
3936
3937   *child_pid = last.value.related_pid;
3938   return 1;
3939 }
3940
3941 int
3942 inferior_has_execd (int pid, char **execd_pathname)
3943 {
3944   struct target_waitstatus last;
3945   ptid_t last_ptid;
3946
3947   get_last_target_status (&last_ptid, &last);
3948
3949   if (last.kind != TARGET_WAITKIND_EXECD)
3950     return 0;
3951
3952   if (ptid_get_pid (last_ptid) != pid)
3953     return 0;
3954
3955   *execd_pathname = xstrdup (last.value.execd_pathname);
3956   return 1;
3957 }
3958
3959 /* Oft used ptids */
3960 ptid_t null_ptid;
3961 ptid_t minus_one_ptid;
3962
3963 /* Create a ptid given the necessary PID, LWP, and TID components.  */
3964
3965 ptid_t
3966 ptid_build (int pid, long lwp, long tid)
3967 {
3968   ptid_t ptid;
3969
3970   ptid.pid = pid;
3971   ptid.lwp = lwp;
3972   ptid.tid = tid;
3973   return ptid;
3974 }
3975
3976 /* Create a ptid from just a pid.  */
3977
3978 ptid_t
3979 pid_to_ptid (int pid)
3980 {
3981   return ptid_build (pid, 0, 0);
3982 }
3983
3984 /* Fetch the pid (process id) component from a ptid.  */
3985
3986 int
3987 ptid_get_pid (ptid_t ptid)
3988 {
3989   return ptid.pid;
3990 }
3991
3992 /* Fetch the lwp (lightweight process) component from a ptid.  */
3993
3994 long
3995 ptid_get_lwp (ptid_t ptid)
3996 {
3997   return ptid.lwp;
3998 }
3999
4000 /* Fetch the tid (thread id) component from a ptid.  */
4001
4002 long
4003 ptid_get_tid (ptid_t ptid)
4004 {
4005   return ptid.tid;
4006 }
4007
4008 /* ptid_equal() is used to test equality of two ptids.  */
4009
4010 int
4011 ptid_equal (ptid_t ptid1, ptid_t ptid2)
4012 {
4013   return (ptid1.pid == ptid2.pid && ptid1.lwp == ptid2.lwp
4014           && ptid1.tid == ptid2.tid);
4015 }
4016
4017 /* restore_inferior_ptid() will be used by the cleanup machinery
4018    to restore the inferior_ptid value saved in a call to
4019    save_inferior_ptid().  */
4020
4021 static void
4022 restore_inferior_ptid (void *arg)
4023 {
4024   ptid_t *saved_ptid_ptr = arg;
4025   inferior_ptid = *saved_ptid_ptr;
4026   xfree (arg);
4027 }
4028
4029 /* Save the value of inferior_ptid so that it may be restored by a
4030    later call to do_cleanups().  Returns the struct cleanup pointer
4031    needed for later doing the cleanup.  */
4032
4033 struct cleanup *
4034 save_inferior_ptid (void)
4035 {
4036   ptid_t *saved_ptid_ptr;
4037
4038   saved_ptid_ptr = xmalloc (sizeof (ptid_t));
4039   *saved_ptid_ptr = inferior_ptid;
4040   return make_cleanup (restore_inferior_ptid, saved_ptid_ptr);
4041 }
4042 \f
4043
4044 static void
4045 build_infrun (void)
4046 {
4047   stop_registers = regcache_xmalloc (current_gdbarch);
4048 }
4049
4050 void
4051 _initialize_infrun (void)
4052 {
4053   int i;
4054   int numsigs;
4055   struct cmd_list_element *c;
4056
4057   DEPRECATED_REGISTER_GDBARCH_SWAP (stop_registers);
4058   deprecated_register_gdbarch_swap (NULL, 0, build_infrun);
4059
4060   add_info ("signals", signals_info,
4061             "What debugger does when program gets various signals.\n\
4062 Specify a signal as argument to print info on that signal only.");
4063   add_info_alias ("handle", "signals", 0);
4064
4065   add_com ("handle", class_run, handle_command,
4066            concat ("Specify how to handle a signal.\n\
4067 Args are signals and actions to apply to those signals.\n\
4068 Symbolic signals (e.g. SIGSEGV) are recommended but numeric signals\n\
4069 from 1-15 are allowed for compatibility with old versions of GDB.\n\
4070 Numeric ranges may be specified with the form LOW-HIGH (e.g. 1-5).\n\
4071 The special arg \"all\" is recognized to mean all signals except those\n\
4072 used by the debugger, typically SIGTRAP and SIGINT.\n", "Recognized actions include \"stop\", \"nostop\", \"print\", \"noprint\",\n\
4073 \"pass\", \"nopass\", \"ignore\", or \"noignore\".\n\
4074 Stop means reenter debugger if this signal happens (implies print).\n\
4075 Print means print a message if this signal happens.\n\
4076 Pass means let program see this signal; otherwise program doesn't know.\n\
4077 Ignore is a synonym for nopass and noignore is a synonym for pass.\n\
4078 Pass and Stop may be combined.", NULL));
4079   if (xdb_commands)
4080     {
4081       add_com ("lz", class_info, signals_info,
4082                "What debugger does when program gets various signals.\n\
4083 Specify a signal as argument to print info on that signal only.");
4084       add_com ("z", class_run, xdb_handle_command,
4085                concat ("Specify how to handle a signal.\n\
4086 Args are signals and actions to apply to those signals.\n\
4087 Symbolic signals (e.g. SIGSEGV) are recommended but numeric signals\n\
4088 from 1-15 are allowed for compatibility with old versions of GDB.\n\
4089 Numeric ranges may be specified with the form LOW-HIGH (e.g. 1-5).\n\
4090 The special arg \"all\" is recognized to mean all signals except those\n\
4091 used by the debugger, typically SIGTRAP and SIGINT.\n", "Recognized actions include \"s\" (toggles between stop and nostop), \n\
4092 \"r\" (toggles between print and noprint), \"i\" (toggles between pass and \
4093 nopass), \"Q\" (noprint)\n\
4094 Stop means reenter debugger if this signal happens (implies print).\n\
4095 Print means print a message if this signal happens.\n\
4096 Pass means let program see this signal; otherwise program doesn't know.\n\
4097 Ignore is a synonym for nopass and noignore is a synonym for pass.\n\
4098 Pass and Stop may be combined.", NULL));
4099     }
4100
4101   if (!dbx_commands)
4102     stop_command =
4103       add_cmd ("stop", class_obscure, not_just_help_class_command, "There is no `stop' command, but you can set a hook on `stop'.\n\
4104 This allows you to set a list of commands to be run each time execution\n\
4105 of the program stops.", &cmdlist);
4106
4107   numsigs = (int) TARGET_SIGNAL_LAST;
4108   signal_stop = (unsigned char *) xmalloc (sizeof (signal_stop[0]) * numsigs);
4109   signal_print = (unsigned char *)
4110     xmalloc (sizeof (signal_print[0]) * numsigs);
4111   signal_program = (unsigned char *)
4112     xmalloc (sizeof (signal_program[0]) * numsigs);
4113   for (i = 0; i < numsigs; i++)
4114     {
4115       signal_stop[i] = 1;
4116       signal_print[i] = 1;
4117       signal_program[i] = 1;
4118     }
4119
4120   /* Signals caused by debugger's own actions
4121      should not be given to the program afterwards.  */
4122   signal_program[TARGET_SIGNAL_TRAP] = 0;
4123   signal_program[TARGET_SIGNAL_INT] = 0;
4124
4125   /* Signals that are not errors should not normally enter the debugger.  */
4126   signal_stop[TARGET_SIGNAL_ALRM] = 0;
4127   signal_print[TARGET_SIGNAL_ALRM] = 0;
4128   signal_stop[TARGET_SIGNAL_VTALRM] = 0;
4129   signal_print[TARGET_SIGNAL_VTALRM] = 0;
4130   signal_stop[TARGET_SIGNAL_PROF] = 0;
4131   signal_print[TARGET_SIGNAL_PROF] = 0;
4132   signal_stop[TARGET_SIGNAL_CHLD] = 0;
4133   signal_print[TARGET_SIGNAL_CHLD] = 0;
4134   signal_stop[TARGET_SIGNAL_IO] = 0;
4135   signal_print[TARGET_SIGNAL_IO] = 0;
4136   signal_stop[TARGET_SIGNAL_POLL] = 0;
4137   signal_print[TARGET_SIGNAL_POLL] = 0;
4138   signal_stop[TARGET_SIGNAL_URG] = 0;
4139   signal_print[TARGET_SIGNAL_URG] = 0;
4140   signal_stop[TARGET_SIGNAL_WINCH] = 0;
4141   signal_print[TARGET_SIGNAL_WINCH] = 0;
4142
4143   /* These signals are used internally by user-level thread
4144      implementations.  (See signal(5) on Solaris.)  Like the above
4145      signals, a healthy program receives and handles them as part of
4146      its normal operation.  */
4147   signal_stop[TARGET_SIGNAL_LWP] = 0;
4148   signal_print[TARGET_SIGNAL_LWP] = 0;
4149   signal_stop[TARGET_SIGNAL_WAITING] = 0;
4150   signal_print[TARGET_SIGNAL_WAITING] = 0;
4151   signal_stop[TARGET_SIGNAL_CANCEL] = 0;
4152   signal_print[TARGET_SIGNAL_CANCEL] = 0;
4153
4154 #ifdef SOLIB_ADD
4155   add_show_from_set
4156     (add_set_cmd ("stop-on-solib-events", class_support, var_zinteger,
4157                   (char *) &stop_on_solib_events,
4158                   "Set stopping for shared library events.\n\
4159 If nonzero, gdb will give control to the user when the dynamic linker\n\
4160 notifies gdb of shared library events.  The most common event of interest\n\
4161 to the user would be loading/unloading of a new library.\n", &setlist), &showlist);
4162 #endif
4163
4164   c = add_set_enum_cmd ("follow-fork-mode",
4165                         class_run,
4166                         follow_fork_mode_kind_names, &follow_fork_mode_string,
4167                         "Set debugger response to a program call of fork \
4168 or vfork.\n\
4169 A fork or vfork creates a new process.  follow-fork-mode can be:\n\
4170   parent  - the original process is debugged after a fork\n\
4171   child   - the new process is debugged after a fork\n\
4172 The unfollowed process will continue to run.\n\
4173 By default, the debugger will follow the parent process.", &setlist);
4174   add_show_from_set (c, &showlist);
4175
4176   c = add_set_enum_cmd ("scheduler-locking", class_run, scheduler_enums,        /* array of string names */
4177                         &scheduler_mode,        /* current mode  */
4178                         "Set mode for locking scheduler during execution.\n\
4179 off  == no locking (threads may preempt at any time)\n\
4180 on   == full locking (no thread except the current thread may run)\n\
4181 step == scheduler locked during every single-step operation.\n\
4182         In this mode, no other thread may run during a step command.\n\
4183         Other threads may run while stepping over a function call ('next').", &setlist);
4184
4185   set_cmd_sfunc (c, set_schedlock_func);        /* traps on target vector */
4186   add_show_from_set (c, &showlist);
4187
4188   c = add_set_cmd ("step-mode", class_run,
4189                    var_boolean, (char *) &step_stop_if_no_debug,
4190                    "Set mode of the step operation. When set, doing a step over a\n\
4191 function without debug line information will stop at the first\n\
4192 instruction of that function. Otherwise, the function is skipped and\n\
4193 the step command stops at a different source line.", &setlist);
4194   add_show_from_set (c, &showlist);
4195
4196   /* ptid initializations */
4197   null_ptid = ptid_build (0, 0, 0);
4198   minus_one_ptid = ptid_build (-1, 0, 0);
4199   inferior_ptid = null_ptid;
4200   target_last_wait_ptid = minus_one_ptid;
4201 }