1 /* Start (run) and stop the inferior process, for GDB.
2 Copyright (C) 1986, 1987, 1988, 1989, 1991 Free Software Foundation, Inc.
4 This file is part of GDB.
6 GDB is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 1, or (at your option)
11 GDB is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with GDB; see the file COPYING. If not, write to
18 the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA. */
20 /* Notes on the algorithm used in wait_for_inferior to determine if we
21 just did a subroutine call when stepping. We have the following
22 information at that point:
24 Current and previous (just before this step) pc.
25 Current and previous sp.
26 Current and previous start of current function.
28 If the start's of the functions don't match, then
30 a) We did a subroutine call.
32 In this case, the pc will be at the beginning of a function.
34 b) We did a subroutine return.
40 If we did a longjump, we were doing "nexti", since a next would
41 have attempted to skip over the assembly language routine in which
42 the longjmp is coded and would have simply been the equivalent of a
43 continue. I consider this ok behaivior. We'd like one of two
44 things to happen if we are doing a nexti through the longjmp()
45 routine: 1) It behaves as a stepi, or 2) It acts like a continue as
46 above. Given that this is a special case, and that anybody who
47 thinks that the concept of sub calls is meaningful in the context
48 of a longjmp, I'll take either one. Let's see what happens.
50 Acts like a subroutine return. I can handle that with no problem
53 -->So: If the current and previous beginnings of the current
54 function don't match, *and* the pc is at the start of a function,
55 we've done a subroutine call. If the pc is not at the start of a
56 function, we *didn't* do a subroutine call.
58 -->If the beginnings of the current and previous function do match,
61 a) We just did a recursive call.
63 In this case, we would be at the very beginning of a
64 function and 1) it will have a prologue (don't jump to
65 before prologue, or 2) (we assume here that it doesn't have
66 a prologue) there will have been a change in the stack
67 pointer over the last instruction. (Ie. it's got to put
68 the saved pc somewhere. The stack is the usual place. In
69 a recursive call a register is only an option if there's a
70 prologue to do something with it. This is even true on
71 register window machines; the prologue sets up the new
72 window. It might not be true on a register window machine
73 where the call instruction moved the register window
74 itself. Hmmm. One would hope that the stack pointer would
75 also change. If it doesn't, somebody send me a note, and
76 I'll work out a more general theory.
78 so) on all machines I'm aware of:
80 m68k: Call changes stack pointer. Regular jumps don't.
82 sparc: Recursive calls must have frames and therefor,
85 vax: All calls have frames and hence change the
88 b) We did a return from a recursive call. I don't see that we
89 have either the ability or the need to distinguish this
90 from an ordinary jump. The stack frame will be printed
91 when and if the frame pointer changes; if we are in a
92 function without a frame pointer, it's the users own
95 c) We did a jump within a function. We assume that this is
96 true if we didn't do a recursive call.
98 d) We are in no-man's land ("I see no symbols here"). We
99 don't worry about this; it will make calls look like simple
100 jumps (and the stack frames will be printed when the frame
101 pointer moves), which is a reasonably non-violent response.
104 We skip this; it causes more problems than it's worth.
105 #ifdef SUN4_COMPILER_FEATURE
106 We do a special ifdef for the sun 4, forcing it to single step
107 into calls which don't have prologues. This means that we can't
108 nexti over leaf nodes, we can probably next over them (since they
109 won't have debugging symbols, usually), and we can next out of
110 functions returning structures (with a "call .stret4" at the end).
125 #include "inferior.h"
126 #include "breakpoint.h"
131 #include "terminal.h" /* For #ifdef TIOCGPGRP and new_tty */
136 /* unistd.h is needed to #define X_OK */
140 #include <sys/file.h>
143 #ifdef SET_STACK_LIMIT_HUGE
144 #include <sys/time.h>
145 #include <sys/resource.h>
147 extern int original_stack_limit;
148 #endif /* SET_STACK_LIMIT_HUGE */
150 extern char *getenv ();
152 extern struct target_ops child_ops; /* In inftarg.c */
154 /* Copy of inferior_io_terminal when inferior was last started. */
156 extern char *inferior_thisrun_terminal;
159 /* Sigtramp is a routine that the kernel calls (which then calls the
160 signal handler). On most machines it is a library routine that
161 is linked into the executable.
163 This macro, given a program counter value and the name of the
164 function in which that PC resides (which can be null if the
165 name is not known), returns nonzero if the PC and name show
166 that we are in sigtramp.
168 On most machines just see if the name is sigtramp (and if we have
169 no name, assume we are not in sigtramp). */
170 #if !defined (IN_SIGTRAMP)
171 #define IN_SIGTRAMP(pc, name) \
172 name && !strcmp ("_sigtramp", name)
177 int safe_to_init_tdesc_context = 0;
178 extern dc_dcontext_t current_context;
181 /* Tables of how to react to signals; the user sets them. */
183 static char signal_stop[NSIG];
184 static char signal_print[NSIG];
185 static char signal_program[NSIG];
187 /* Nonzero if breakpoints are now inserted in the inferior. */
188 /* Nonstatic for initialization during xxx_create_inferior. FIXME. */
190 /*static*/ int breakpoints_inserted;
192 /* Function inferior was in as of last step command. */
194 static struct symbol *step_start_function;
196 /* Nonzero => address for special breakpoint for resuming stepping. */
198 static CORE_ADDR step_resume_break_address;
200 /* Pointer to orig contents of the byte where the special breakpoint is. */
202 static char step_resume_break_shadow[BREAKPOINT_MAX];
204 /* Nonzero means the special breakpoint is a duplicate
205 so it has not itself been inserted. */
207 static int step_resume_break_duplicate;
209 /* Nonzero if we are expecting a trace trap and should proceed from it. */
211 static int trap_expected;
213 /* Nonzero if the next time we try to continue the inferior, it will
214 step one instruction and generate a spurious trace trap.
215 This is used to compensate for a bug in HP-UX. */
217 static int trap_expected_after_continue;
219 /* Nonzero means expecting a trace trap
220 and should stop the inferior and return silently when it happens. */
224 /* Nonzero means expecting a trap and caller will handle it themselves.
225 It is used after attach, due to attaching to a process;
226 when running in the shell before the child program has been exec'd;
227 and when running some kinds of remote stuff (FIXME?). */
229 int stop_soon_quietly;
231 /* Nonzero if pc has been changed by the debugger
232 since the inferior stopped. */
236 /* Nonzero if proceed is being used for a "finish" command or a similar
237 situation when stop_registers should be saved. */
239 int proceed_to_finish;
241 /* Save register contents here when about to pop a stack dummy frame,
242 if-and-only-if proceed_to_finish is set.
243 Thus this contains the return value from the called function (assuming
244 values are returned in a register). */
246 char stop_registers[REGISTER_BYTES];
248 /* Nonzero if program stopped due to error trying to insert breakpoints. */
250 static int breakpoints_failed;
252 /* Nonzero after stop if current stack frame should be printed. */
254 static int stop_print_frame;
256 #ifdef NO_SINGLE_STEP
257 extern int one_stepped; /* From machine dependent code */
258 extern void single_step (); /* Same. */
259 #endif /* NO_SINGLE_STEP */
261 static void insert_step_breakpoint ();
262 static void remove_step_breakpoint ();
263 /*static*/ void wait_for_inferior ();
264 void init_wait_for_inferior ();
268 /* Things to clean up if we QUIT out of resume (). */
271 resume_cleanups (arg)
277 /* Resume the inferior, but allow a QUIT. This is useful if the user
278 wants to interrupt some lengthy single-stepping operation
279 (for child processes, the SIGINT goes to the inferior, and so
280 we get a SIGINT random_signal, but for remote debugging and perhaps
281 other targets, that's not true).
283 STEP nonzero if we should step (zero to continue instead).
284 SIG is the signal to give the inferior (zero for none). */
290 struct cleanup *old_cleanups = make_cleanup (resume_cleanups, 0);
293 #ifdef NO_SINGLE_STEP
295 single_step(); /* Do it the hard way, w/temp breakpoints */
296 step = 0; /* ...and don't ask hardware to do it. */
300 target_resume (step, sig);
301 discard_cleanups (old_cleanups);
305 /* Clear out all variables saying what to do when inferior is continued.
306 First do this, then set the ones you want, then call `proceed'. */
309 clear_proceed_status ()
312 step_range_start = 0;
314 step_frame_address = 0;
315 step_over_calls = -1;
316 step_resume_break_address = 0;
318 stop_soon_quietly = 0;
319 proceed_to_finish = 0;
320 breakpoint_proceeded = 1; /* We're about to proceed... */
322 /* Discard any remaining commands or status from previous stop. */
323 bpstat_clear (&stop_bpstat);
326 /* Basic routine for continuing the program in various fashions.
328 ADDR is the address to resume at, or -1 for resume where stopped.
329 SIGGNAL is the signal to give it, or 0 for none,
330 or -1 for act according to how it stopped.
331 STEP is nonzero if should trap after one instruction.
332 -1 means return after that and print nothing.
333 You should probably set various step_... variables
334 before calling here, if you are stepping.
336 You should call clear_proceed_status before calling proceed. */
339 proceed (addr, siggnal, step)
347 step_start_function = find_pc_function (read_pc ());
353 /* If there is a breakpoint at the address we will resume at,
354 step one instruction before inserting breakpoints
355 so that we do not stop right away. */
357 if (!pc_changed && breakpoint_here_p (read_pc ()))
362 write_register (PC_REGNUM, addr);
364 write_register (NPC_REGNUM, addr + 4);
366 write_register (NNPC_REGNUM, addr + 8);
371 if (trap_expected_after_continue)
373 /* If (step == 0), a trap will be automatically generated after
374 the first instruction is executed. Force step one
375 instruction to clear this condition. This should not occur
376 if step is nonzero, but it is harmless in that case. */
378 trap_expected_after_continue = 0;
382 /* We will get a trace trap after one instruction.
383 Continue it automatically and insert breakpoints then. */
387 int temp = insert_breakpoints ();
390 print_sys_errmsg ("ptrace", temp);
391 error ("Cannot insert breakpoints.\n\
392 The same program may be running in another process.");
394 breakpoints_inserted = 1;
397 /* Install inferior's terminal modes. */
398 target_terminal_inferior ();
401 stop_signal = siggnal;
402 /* If this signal should not be seen by program,
403 give it zero. Used for debugging signals. */
404 else if (stop_signal < NSIG && !signal_program[stop_signal])
407 /* Handle any optimized stores to the inferior NOW... */
408 #ifdef DO_DEFERRED_STORES
412 /* Resume inferior. */
413 resume (oneproc || step || bpstat_should_step (), stop_signal);
415 /* Wait for it to stop (if not standalone)
416 and in any case decode why it stopped, and act accordingly. */
418 wait_for_inferior ();
423 /* This might be useful (not sure), but isn't currently used. See also
425 /* Writing the inferior pc as a register calls this function
426 to inform infrun that the pc has been set in the debugger. */
437 /* Record the pc and sp of the program the last time it stopped.
438 These are just used internally by wait_for_inferior, but need
439 to be preserved over calls to it and cleared when the inferior
441 static CORE_ADDR prev_pc;
442 static CORE_ADDR prev_sp;
443 static CORE_ADDR prev_func_start;
444 static char *prev_func_name;
447 /* Start an inferior Unix child process and sets inferior_pid to its pid.
448 EXEC_FILE is the file to run.
449 ALLARGS is a string containing the arguments to the program.
450 ENV is the environment vector to pass. Errors reported with error(). */
453 #define SHELL_FILE "/bin/sh"
457 child_create_inferior (exec_file, allargs, env)
465 extern char *sys_errlist[];
467 static char default_shell_file[] = SHELL_FILE;
470 /* Set debug_fork then attach to the child while it sleeps, to debug. */
471 static int debug_fork = 0;
472 /* This is set to the result of setpgrp, which if vforked, will be visible
473 to you in the parent process. It's only used by humans for debugging. */
474 static int debug_setpgrp = 657473;
476 /* The user might want tilde-expansion, and in general probably wants
477 the program to behave the same way as if run from
478 his/her favorite shell. So we let the shell run it for us.
479 FIXME, this should probably search the local environment (as
480 modified by the setenv command), not the env gdb inherited. */
481 shell_file = getenv ("SHELL");
482 if (shell_file == NULL)
483 shell_file = default_shell_file;
485 len = 5 + strlen (exec_file) + 1 + strlen (allargs) + 1 + /*slop*/ 10;
486 /* If desired, concat something onto the front of ALLARGS.
487 SHELL_COMMAND is the result. */
488 #ifdef SHELL_COMMAND_CONCAT
489 shell_command = (char *) alloca (strlen (SHELL_COMMAND_CONCAT) + len);
490 strcpy (shell_command, SHELL_COMMAND_CONCAT);
492 shell_command = (char *) alloca (len);
493 shell_command[0] = '\0';
495 strcat (shell_command, "exec ");
496 strcat (shell_command, exec_file);
497 strcat (shell_command, " ");
498 strcat (shell_command, allargs);
500 /* exec is said to fail if the executable is open. */
503 #if defined(USG) && !defined(HAVE_VFORK)
513 perror_with_name ("vfork");
521 /* Run inferior in a separate process group. */
522 debug_setpgrp = setpgrp (getpid (), getpid ());
523 if (0 != debug_setpgrp)
524 perror("setpgrp failed in child");
525 #endif /* TIOCGPGRP */
527 #ifdef SET_STACK_LIMIT_HUGE
528 /* Reset the stack limit back to what it was. */
532 getrlimit (RLIMIT_STACK, &rlim);
533 rlim.rlim_cur = original_stack_limit;
534 setrlimit (RLIMIT_STACK, &rlim);
536 #endif /* SET_STACK_LIMIT_HUGE */
538 /* Tell the terminal handling subsystem what tty we plan to run on;
539 it will now switch to that one if non-null. */
541 new_tty (inferior_io_terminal);
543 /* Changing the signal handlers for the inferior after
544 a vfork can also change them for the superior, so we don't mess
545 with signals here. See comments in
546 initialize_signals for how we get the right signal handlers
549 call_ptrace (0, 0, 0, 0); /* "Trace me, Dr. Memory!" */
550 execle (shell_file, shell_file, "-c", shell_command, (char *)0, env);
552 fprintf (stderr, "Cannot exec %s: %s.\n", shell_file,
553 errno < sys_nerr ? sys_errlist[errno] : "unknown error");
558 /* Now that we have a child process, make it our target. */
559 push_target (&child_ops);
561 #ifdef CREATE_INFERIOR_HOOK
562 CREATE_INFERIOR_HOOK (pid);
565 /* The process was started by the fork that created it,
566 but it will have stopped one instruction after execing the shell.
567 Here we must get it up to actual execution of the real program. */
569 inferior_pid = pid; /* Needed for wait_for_inferior stuff below */
571 clear_proceed_status ();
573 #if defined (START_INFERIOR_HOOK)
574 START_INFERIOR_HOOK ();
577 /* We will get a trace trap after one instruction.
578 Continue it automatically. Eventually (after shell does an exec)
579 it will get another trace trap. Then insert breakpoints and continue. */
581 #ifdef START_INFERIOR_TRAPS_EXPECTED
582 pending_execs = START_INFERIOR_TRAPS_EXPECTED;
587 init_wait_for_inferior ();
589 /* Set up the "saved terminal modes" of the inferior
590 based on what modes we are starting it with. */
591 target_terminal_init ();
593 /* Install inferior's terminal modes. */
594 target_terminal_inferior ();
598 stop_soon_quietly = 1; /* Make wait_for_inferior be quiet */
599 wait_for_inferior ();
600 if (stop_signal != SIGTRAP)
602 /* Let shell child handle its own signals in its own way */
603 /* FIXME, what if child has exit()ed? Must exit loop somehow */
604 resume (0, stop_signal);
608 /* We handle SIGTRAP, however; it means child did an exec. */
609 if (0 == --pending_execs)
611 resume (0, 0); /* Just make it go on */
614 stop_soon_quietly = 0;
616 /* Should this perhaps just be a "proceed" call? FIXME */
617 insert_step_breakpoint ();
618 breakpoints_failed = insert_breakpoints ();
619 if (!breakpoints_failed)
621 breakpoints_inserted = 1;
622 target_terminal_inferior();
623 /* Start the child program going on its first instruction, single-
624 stepping if we need to. */
625 resume (bpstat_should_step (), 0);
626 wait_for_inferior ();
631 /* Start remote-debugging of a machine over a serial link. */
636 init_wait_for_inferior ();
637 clear_proceed_status ();
638 stop_soon_quietly = 1;
640 wait_for_inferior ();
644 /* Initialize static vars when a new inferior begins. */
647 init_wait_for_inferior ()
649 /* These are meaningless until the first time through wait_for_inferior. */
653 prev_func_name = NULL;
655 trap_expected_after_continue = 0;
656 breakpoints_inserted = 0;
657 mark_breakpoints_out ();
658 stop_signal = 0; /* Don't confuse first call to proceed(). */
662 /* Attach to process PID, then initialize for debugging it
663 and wait for the trace-trap that results from attaching. */
666 child_attach (args, from_tty)
676 error_no_arg ("process-id to attach");
678 #ifndef ATTACH_DETACH
679 error ("Can't attach to a process on this machine.");
683 if (target_has_execution)
685 if (query ("A program is being debugged already. Kill it? "))
686 target_kill ((char *)0, from_tty);
688 error ("Inferior not killed.");
691 exec_file = (char *) get_exec_file (1);
695 printf ("Attaching program: %s pid %d\n",
702 push_target (&child_ops);
704 mark_breakpoints_out ();
705 target_terminal_init ();
706 clear_proceed_status ();
707 stop_soon_quietly = 1;
708 /*proceed (-1, 0, -2);*/
709 target_terminal_inferior ();
710 wait_for_inferior ();
712 #endif /* ATTACH_DETACH */
715 /* Wait for control to return from inferior to debugger.
716 If inferior gets a signal, we may decide to start it up again
717 instead of returning. That is why there is a loop in this function.
718 When this function actually returns it means the inferior
719 should be left stopped and GDB should read more commands. */
728 CORE_ADDR stop_func_start;
729 char *stop_func_name;
730 CORE_ADDR prologue_pc;
731 int stop_step_resume_break;
732 struct symtab_and_line sal;
733 int remove_breakpoints_on_following_step = 0;
735 extern dc_handle_t tdesc_handle;
739 /* This no longer works now that read_register is lazy;
740 it might try to ptrace when the process is not stopped. */
741 prev_pc = read_pc ();
742 (void) find_pc_partial_function (prev_pc, &prev_func_name,
744 prev_func_start += FUNCTION_START_OFFSET;
745 prev_sp = read_register (SP_REGNUM);
750 /* Clean up saved state that will become invalid. */
752 flush_cached_frames ();
753 registers_changed ();
757 /* See if the process still exists; clean up if it doesn't. */
760 target_terminal_ours (); /* Must do this before mourn anyway */
762 safe_to_init_tdesc_context = 0;
765 printf ("\nProgram exited with code 0%o.\n",
766 (unsigned int)WEXITSTATUS (w));
769 printf ("\nProgram exited normally.\n");
771 target_mourn_inferior ();
772 #ifdef NO_SINGLE_STEP
775 stop_print_frame = 0;
778 else if (!WIFSTOPPED (w))
780 stop_print_frame = 0;
781 stop_signal = WTERMSIG (w);
782 target_terminal_ours (); /* Must do this before mourn anyway */
783 target_kill ((char *)0, 0); /* kill mourns as well */
785 safe_to_init_tdesc_context = 0;
787 #ifdef PRINT_RANDOM_SIGNAL
788 printf ("\nProgram terminated: ");
789 PRINT_RANDOM_SIGNAL (stop_signal);
791 printf ("\nProgram terminated with signal %d, %s\n",
794 ? sys_siglist[stop_signal]
797 printf ("The inferior process no longer exists.\n");
799 #ifdef NO_SINGLE_STEP
805 #ifdef NO_SINGLE_STEP
807 single_step (0); /* This actually cleans up the ss */
808 #endif /* NO_SINGLE_STEP */
810 stop_pc = read_pc ();
812 if (safe_to_init_tdesc_context)
814 current_context = init_dcontext();
815 set_current_frame ( create_new_frame (get_frame_base (read_pc()),read_pc()));
819 set_current_frame ( create_new_frame (read_register (FP_REGNUM),
822 stop_frame_address = FRAME_FP (get_current_frame ());
823 stop_sp = read_register (SP_REGNUM);
826 /* Don't care about return value; stop_func_start and stop_func_name
827 will both be 0 if it doesn't work. */
828 (void) find_pc_partial_function (stop_pc, &stop_func_name,
830 stop_func_start += FUNCTION_START_OFFSET;
832 bpstat_clear (&stop_bpstat);
834 stop_stack_dummy = 0;
835 stop_print_frame = 1;
836 stop_step_resume_break = 0;
838 stopped_by_random_signal = 0;
839 breakpoints_failed = 0;
841 /* Look at the cause of the stop, and decide what to do.
842 The alternatives are:
843 1) break; to really stop and return to the debugger,
844 2) drop through to start up again
845 (set another_trap to 1 to single step once)
846 3) set random_signal to 1, and the decision between 1 and 2
847 will be made according to the signal handling tables. */
849 stop_signal = WSTOPSIG (w);
851 /* First, distinguish signals caused by the debugger from signals
852 that have to do with the program's own actions.
853 Note that breakpoint insns may cause SIGTRAP or SIGILL
854 or SIGEMT, depending on the operating system version.
855 Here we detect when a SIGILL or SIGEMT is really a breakpoint
856 and change it to SIGTRAP. */
858 if (stop_signal == SIGTRAP
859 || (breakpoints_inserted &&
860 (stop_signal == SIGILL
861 || stop_signal == SIGEMT))
862 || stop_soon_quietly)
864 if (stop_signal == SIGTRAP && stop_after_trap)
866 stop_print_frame = 0;
869 if (stop_soon_quietly)
872 /* Don't even think about breakpoints
873 if just proceeded over a breakpoint.
875 However, if we are trying to proceed over a breakpoint
876 and end up in sigtramp, then step_resume_break_address
877 will be set and we should check whether we've hit the
879 if (stop_signal == SIGTRAP && trap_expected
880 && step_resume_break_address == NULL)
881 bpstat_clear (&stop_bpstat);
884 /* See if there is a breakpoint at the current PC. */
885 #if DECR_PC_AFTER_BREAK
886 /* Notice the case of stepping through a jump
887 that leads just after a breakpoint.
888 Don't confuse that with hitting the breakpoint.
889 What we check for is that 1) stepping is going on
890 and 2) the pc before the last insn does not match
891 the address of the breakpoint before the current pc. */
892 if (!(prev_pc != stop_pc - DECR_PC_AFTER_BREAK
893 && step_range_end && !step_resume_break_address))
894 #endif /* DECR_PC_AFTER_BREAK not zero */
896 /* See if we stopped at the special breakpoint for
897 stepping over a subroutine call. If both are zero,
898 this wasn't the reason for the stop. */
899 if (stop_pc - DECR_PC_AFTER_BREAK
900 == step_resume_break_address
901 && step_resume_break_address)
903 stop_step_resume_break = 1;
904 if (DECR_PC_AFTER_BREAK)
906 stop_pc -= DECR_PC_AFTER_BREAK;
907 write_register (PC_REGNUM, stop_pc);
914 bpstat_stop_status (&stop_pc, stop_frame_address);
915 /* Following in case break condition called a
917 stop_print_frame = 1;
922 if (stop_signal == SIGTRAP)
924 = !(bpstat_explains_signal (stop_bpstat)
926 || stop_step_resume_break
927 || PC_IN_CALL_DUMMY (stop_pc, stop_sp, stop_frame_address)
928 || (step_range_end && !step_resume_break_address));
932 = !(bpstat_explains_signal (stop_bpstat)
933 || stop_step_resume_break
934 /* End of a stack dummy. Some systems (e.g. Sony
935 news) give another signal besides SIGTRAP,
936 so check here as well as above. */
937 || (stop_sp INNER_THAN stop_pc
938 && stop_pc INNER_THAN stop_frame_address)
941 stop_signal = SIGTRAP;
947 /* For the program's own signals, act according to
948 the signal handling tables. */
952 /* Signal not for debugging purposes. */
955 stopped_by_random_signal = 1;
957 if (stop_signal >= NSIG
958 || signal_print[stop_signal])
961 target_terminal_ours_for_output ();
962 #ifdef PRINT_RANDOM_SIGNAL
963 PRINT_RANDOM_SIGNAL (stop_signal);
965 printf ("\nProgram received signal %d, %s\n",
968 ? sys_siglist[stop_signal]
970 #endif /* PRINT_RANDOM_SIGNAL */
973 if (stop_signal >= NSIG
974 || signal_stop[stop_signal])
976 /* If not going to stop, give terminal back
977 if we took it away. */
979 target_terminal_inferior ();
982 /* Handle cases caused by hitting a breakpoint. */
985 && (bpstat_explains_signal (stop_bpstat) || stop_step_resume_break))
987 /* Does a breakpoint want us to stop? */
988 if (bpstat_stop (stop_bpstat))
990 stop_print_frame = bpstat_should_print (stop_bpstat);
993 /* But if we have hit the step-resumption breakpoint,
994 remove it. It has done its job getting us here.
995 The sp test is to make sure that we don't get hung
996 up in recursive calls in functions without frame
997 pointers. If the stack pointer isn't outside of
998 where the breakpoint was set (within a routine to be
999 stepped over), we're in the middle of a recursive
1000 call. Not true for reg window machines (sparc)
1001 because the must change frames to call things and
1002 the stack pointer doesn't have to change if it
1003 the bp was set in a routine without a frame (pc can
1004 be stored in some other window).
1006 The removal of the sp test is to allow calls to
1007 alloca. Nasty things were happening. Oh, well,
1008 gdb can only handle one level deep of lack of
1010 if (stop_step_resume_break
1011 && (step_frame_address == 0
1012 || (stop_frame_address == step_frame_address)))
1014 remove_step_breakpoint ();
1015 step_resume_break_address = 0;
1017 /* If were waiting for a trap, hitting the step_resume_break
1018 doesn't count as getting it. */
1022 /* Otherwise, must remove breakpoints and single-step
1023 to get us past the one we hit. */
1026 remove_breakpoints ();
1027 remove_step_breakpoint ();
1028 breakpoints_inserted = 0;
1032 /* We come here if we hit a breakpoint but should not
1033 stop for it. Possibly we also were stepping
1034 and should stop for that. So fall through and
1035 test for stepping. But, if not stepping,
1039 /* If this is the breakpoint at the end of a stack dummy,
1040 just stop silently. */
1041 if (PC_IN_CALL_DUMMY (stop_pc, stop_sp, stop_frame_address))
1043 stop_print_frame = 0;
1044 stop_stack_dummy = 1;
1046 trap_expected_after_continue = 1;
1051 if (step_resume_break_address)
1052 /* Having a step-resume breakpoint overrides anything
1053 else having to do with stepping commands until
1054 that breakpoint is reached. */
1056 /* If stepping through a line, keep going if still within it. */
1057 else if (!random_signal
1059 && stop_pc >= step_range_start
1060 && stop_pc < step_range_end
1061 /* The step range might include the start of the
1062 function, so if we are at the start of the
1063 step range and either the stack or frame pointers
1064 just changed, we've stepped outside */
1065 && !(stop_pc == step_range_start
1066 && stop_frame_address
1067 && (stop_sp INNER_THAN prev_sp
1068 || stop_frame_address != step_frame_address)))
1071 /* When "next"ing through a function,
1072 This causes an extra stop at the end.
1073 Is there any reason for this?
1074 It's confusing to the user. */
1075 /* Don't step through the return from a function
1076 unless that is the first instruction stepped through. */
1077 if (ABOUT_TO_RETURN (stop_pc))
1085 /* We stepped out of the stepping range. See if that was due
1086 to a subroutine call that we should proceed to the end of. */
1087 else if (!random_signal && step_range_end)
1089 if (stop_func_start)
1091 prologue_pc = stop_func_start;
1092 SKIP_PROLOGUE (prologue_pc);
1095 /* Did we just take a signal? */
1096 if (IN_SIGTRAMP (stop_pc, stop_func_name)
1097 && !IN_SIGTRAMP (prev_pc, prev_func_name))
1099 /* This code is needed at least in the following case:
1100 The user types "next" and then a signal arrives (before
1101 the "next" is done). */
1102 /* We've just taken a signal; go until we are back to
1103 the point where we took it and one more. */
1104 step_resume_break_address = prev_pc;
1105 step_resume_break_duplicate =
1106 breakpoint_here_p (step_resume_break_address);
1107 if (breakpoints_inserted)
1108 insert_step_breakpoint ();
1109 /* Make sure that the stepping range gets us past
1110 that instruction. */
1111 if (step_range_end == 1)
1112 step_range_end = (step_range_start = prev_pc) + 1;
1113 remove_breakpoints_on_following_step = 1;
1116 /* ==> See comments at top of file on this algorithm. <==*/
1118 else if (stop_pc == stop_func_start
1119 && (stop_func_start != prev_func_start
1120 || prologue_pc != stop_func_start
1121 || stop_sp != prev_sp))
1123 /* It's a subroutine call */
1124 if (step_over_calls > 0
1125 || (step_over_calls && find_pc_function (stop_pc) == 0))
1127 /* A subroutine call has happened. */
1128 /* Set a special breakpoint after the return */
1129 step_resume_break_address =
1131 (SAVED_PC_AFTER_CALL (get_current_frame ()));
1132 step_resume_break_duplicate
1133 = breakpoint_here_p (step_resume_break_address);
1134 if (breakpoints_inserted)
1135 insert_step_breakpoint ();
1137 /* Subroutine call with source code we should not step over.
1138 Do step to the first line of code in it. */
1139 else if (step_over_calls)
1141 SKIP_PROLOGUE (stop_func_start);
1142 sal = find_pc_line (stop_func_start, 0);
1143 /* Use the step_resume_break to step until
1144 the end of the prologue, even if that involves jumps
1145 (as it seems to on the vax under 4.2). */
1146 /* If the prologue ends in the middle of a source line,
1147 continue to the end of that source line.
1148 Otherwise, just go to end of prologue. */
1149 #ifdef PROLOGUE_FIRSTLINE_OVERLAP
1150 /* no, don't either. It skips any code that's
1151 legitimately on the first line. */
1153 if (sal.end && sal.pc != stop_func_start)
1154 stop_func_start = sal.end;
1157 if (stop_func_start == stop_pc)
1159 /* We are already there: stop now. */
1164 /* Put the step-breakpoint there and go until there. */
1166 step_resume_break_address = stop_func_start;
1168 step_resume_break_duplicate
1169 = breakpoint_here_p (step_resume_break_address);
1170 if (breakpoints_inserted)
1171 insert_step_breakpoint ();
1172 /* Do not specify what the fp should be when we stop
1173 since on some machines the prologue
1174 is where the new fp value is established. */
1175 step_frame_address = 0;
1176 /* And make sure stepping stops right away then. */
1177 step_range_end = step_range_start;
1182 /* We get here only if step_over_calls is 0 and we
1183 just stepped into a subroutine. I presume
1184 that step_over_calls is only 0 when we're
1185 supposed to be stepping at the assembly
1191 /* No subroutince call; stop now. */
1199 else if (trap_expected
1200 && IN_SIGTRAMP (stop_pc, stop_func_name)
1201 && !IN_SIGTRAMP (prev_pc, prev_func_name))
1203 /* What has happened here is that we have just stepped the inferior
1204 with a signal (because it is a signal which shouldn't make
1205 us stop), thus stepping into sigtramp.
1207 So we need to set a step_resume_break_address breakpoint
1208 and continue until we hit it, and then step. */
1209 step_resume_break_address = prev_pc;
1210 /* Always 1, I think, but it's probably easier to have
1211 the step_resume_break as usual rather than trying to
1212 re-use the breakpoint which is already there. */
1213 step_resume_break_duplicate =
1214 breakpoint_here_p (step_resume_break_address);
1215 if (breakpoints_inserted)
1216 insert_step_breakpoint ();
1217 remove_breakpoints_on_following_step = 1;
1221 /* Save the pc before execution, to compare with pc after stop. */
1222 prev_pc = read_pc (); /* Might have been DECR_AFTER_BREAK */
1223 prev_func_start = stop_func_start; /* Ok, since if DECR_PC_AFTER
1224 BREAK is defined, the
1225 original pc would not have
1226 been at the start of a
1228 prev_func_name = stop_func_name;
1231 /* If we did not do break;, it means we should keep
1232 running the inferior and not return to debugger. */
1234 if (trap_expected && stop_signal != SIGTRAP)
1236 /* We took a signal (which we are supposed to pass through to
1237 the inferior, else we'd have done a break above) and we
1238 haven't yet gotten our trap. Simply continue. */
1239 resume ((step_range_end && !step_resume_break_address)
1240 || (trap_expected && !step_resume_break_address)
1241 || bpstat_should_step (),
1246 /* Either the trap was not expected, but we are continuing
1247 anyway (the user asked that this signal be passed to the
1250 The signal was SIGTRAP, e.g. it was our signal, but we
1251 decided we should resume from it.
1253 We're going to run this baby now!
1255 Insert breakpoints now, unless we are trying
1256 to one-proceed past a breakpoint. */
1257 /* If we've just finished a special step resume and we don't
1258 want to hit a breakpoint, pull em out. */
1263 safe_to_init_tdesc_context = 1;
1267 if (!step_resume_break_address &&
1268 remove_breakpoints_on_following_step)
1270 remove_breakpoints_on_following_step = 0;
1271 remove_breakpoints ();
1272 breakpoints_inserted = 0;
1274 else if (!breakpoints_inserted &&
1275 (step_resume_break_address != NULL || !another_trap))
1277 insert_step_breakpoint ();
1278 breakpoints_failed = insert_breakpoints ();
1279 if (breakpoints_failed)
1281 breakpoints_inserted = 1;
1284 trap_expected = another_trap;
1286 if (stop_signal == SIGTRAP)
1289 #ifdef SHIFT_INST_REGS
1290 /* I'm not sure when this following segment applies. I do know, now,
1291 that we shouldn't rewrite the regs when we were stopped by a
1292 random signal from the inferior process. */
1294 if (!bpstat_explains_signal (stop_bpstat)
1295 && (stop_signal != SIGCLD)
1296 && !stopped_by_random_signal)
1298 CORE_ADDR pc_contents = read_register (PC_REGNUM);
1299 CORE_ADDR npc_contents = read_register (NPC_REGNUM);
1300 if (pc_contents != npc_contents)
1302 write_register (NNPC_REGNUM, npc_contents);
1303 write_register (NPC_REGNUM, pc_contents);
1306 #endif /* SHIFT_INST_REGS */
1308 resume ((step_range_end && !step_resume_break_address)
1309 || (trap_expected && !step_resume_break_address)
1310 || bpstat_should_step (),
1314 if (target_has_execution)
1316 /* Assuming the inferior still exists, set these up for next
1317 time, just like we did above if we didn't break out of the
1319 prev_pc = read_pc ();
1320 prev_func_start = stop_func_start;
1321 prev_func_name = stop_func_name;
1326 /* Here to return control to GDB when the inferior stops for real.
1327 Print appropriate messages, remove breakpoints, give terminal our modes.
1329 STOP_PRINT_FRAME nonzero means print the executing frame
1330 (pc, function, args, file, line number and line text).
1331 BREAKPOINTS_FAILED nonzero means stop was due to error
1332 attempting to insert breakpoints. */
1337 /* Make sure that the current_frame's pc is correct. This
1338 is a correction for setting up the frame info before doing
1339 DECR_PC_AFTER_BREAK */
1340 if (target_has_execution)
1341 (get_current_frame ())->pc = read_pc ();
1343 if (breakpoints_failed)
1345 target_terminal_ours_for_output ();
1346 print_sys_errmsg ("ptrace", breakpoints_failed);
1347 printf ("Stopped; cannot insert breakpoints.\n\
1348 The same program may be running in another process.\n");
1351 if (target_has_execution)
1352 remove_step_breakpoint ();
1354 if (target_has_execution && breakpoints_inserted)
1355 if (remove_breakpoints ())
1357 target_terminal_ours_for_output ();
1358 printf ("Cannot remove breakpoints because program is no longer writable.\n\
1359 It might be running in another process.\n\
1360 Further execution is probably impossible.\n");
1363 breakpoints_inserted = 0;
1365 /* Delete the breakpoint we stopped at, if it wants to be deleted.
1366 Delete any breakpoint that is to be deleted at the next stop. */
1368 breakpoint_auto_delete (stop_bpstat);
1370 /* If an auto-display called a function and that got a signal,
1371 delete that auto-display to avoid an infinite recursion. */
1373 if (stopped_by_random_signal)
1374 disable_current_display ();
1376 if (step_multi && stop_step)
1379 target_terminal_ours ();
1381 if (!target_has_stack)
1384 /* Select innermost stack frame except on return from a stack dummy routine,
1385 or if the program has exited. */
1386 if (!stop_stack_dummy)
1388 select_frame (get_current_frame (), 0);
1390 if (stop_print_frame)
1392 int source_only = bpstat_print (stop_bpstat);
1396 && step_frame_address == stop_frame_address
1397 && step_start_function == find_pc_function (stop_pc)));
1399 /* Display the auto-display expressions. */
1404 /* Save the function value return registers, if we care.
1405 We might be about to restore their previous contents. */
1406 if (proceed_to_finish)
1407 read_register_bytes (0, stop_registers, REGISTER_BYTES);
1409 if (stop_stack_dummy)
1411 /* Pop the empty frame that contains the stack dummy.
1412 POP_FRAME ends with a setting of the current frame, so we
1413 can use that next. */
1415 select_frame (get_current_frame (), 0);
1420 insert_step_breakpoint ()
1422 if (step_resume_break_address && !step_resume_break_duplicate)
1423 target_insert_breakpoint (step_resume_break_address,
1424 step_resume_break_shadow);
1428 remove_step_breakpoint ()
1430 if (step_resume_break_address && !step_resume_break_duplicate)
1431 target_remove_breakpoint (step_resume_break_address,
1432 step_resume_break_shadow);
1438 printf_filtered ("Signal\t\tStop\tPrint\tPass to program\tDescription\n");
1442 sig_print_info (number)
1445 char *abbrev = sig_abbrev(number);
1447 printf_filtered ("%d\t\t", number);
1449 printf_filtered ("SIG%s (%d)\t", abbrev, number);
1450 printf_filtered ("%s\t", signal_stop[number] ? "Yes" : "No");
1451 printf_filtered ("%s\t", signal_print[number] ? "Yes" : "No");
1452 printf_filtered ("%s\t\t", signal_program[number] ? "Yes" : "No");
1453 printf_filtered ("%s\n", sys_siglist[number]);
1456 /* Specify how various signals in the inferior should be handled. */
1459 handle_command (args, from_tty)
1463 register char *p = args;
1465 register int digits, wordlen;
1469 error_no_arg ("signal to handle");
1473 /* Find the end of the next word in the args. */
1475 p[wordlen] && p[wordlen] != ' ' && p[wordlen] != '\t';
1477 /* Set nextarg to the start of the word after the one we just
1478 found, and null-terminate this one. */
1479 if (p[wordlen] == '\0')
1480 nextarg = p + wordlen;
1484 nextarg = p + wordlen + 1;
1488 for (digits = 0; p[digits] >= '0' && p[digits] <= '9'; digits++);
1492 /* It is the first argument--must be the signal to operate on. */
1493 if (digits == wordlen)
1497 if (signum <= 0 || signum >= NSIG)
1500 error ("Invalid signal %s given as argument to \"handle\".", p);
1506 signum = sig_number (p);
1508 error ("No such signal \"%s\"", p);
1511 if (signum == SIGTRAP || signum == SIGINT)
1513 if (!query ("SIG%s is used by the debugger.\nAre you sure you want to change it? ", sig_abbrev (signum)))
1514 error ("Not confirmed.");
1517 /* Else, if already got a signal number, look for flag words
1518 saying what to do for it. */
1519 else if (!strncmp (p, "stop", wordlen))
1521 signal_stop[signum] = 1;
1522 signal_print[signum] = 1;
1524 else if (wordlen >= 2 && !strncmp (p, "print", wordlen))
1525 signal_print[signum] = 1;
1526 else if (wordlen >= 2 && !strncmp (p, "pass", wordlen))
1527 signal_program[signum] = 1;
1528 else if (!strncmp (p, "ignore", wordlen))
1529 signal_program[signum] = 0;
1530 else if (wordlen >= 3 && !strncmp (p, "nostop", wordlen))
1531 signal_stop[signum] = 0;
1532 else if (wordlen >= 4 && !strncmp (p, "noprint", wordlen))
1534 signal_print[signum] = 0;
1535 signal_stop[signum] = 0;
1537 else if (wordlen >= 4 && !strncmp (p, "nopass", wordlen))
1538 signal_program[signum] = 0;
1539 else if (wordlen >= 3 && !strncmp (p, "noignore", wordlen))
1540 signal_program[signum] = 1;
1541 /* Not a number and not a recognized flag word => complain. */
1544 error ("Unrecognized flag word: \"%s\".", p);
1547 /* Find start of next word. */
1549 while (*p == ' ' || *p == '\t') p++;
1554 /* Show the results. */
1555 sig_print_header ();
1556 sig_print_info (signum);
1560 /* Print current contents of the tables set by the handle command. */
1563 signals_info (signum_exp)
1567 sig_print_header ();
1571 /* First see if this is a symbol name. */
1572 i = sig_number (signum_exp);
1575 /* Nope, maybe it's an address which evaluates to a signal
1577 i = parse_and_eval_address (signum_exp);
1578 if (i >= NSIG || i < 0)
1579 error ("Signal number out of bounds.");
1585 printf_filtered ("\n");
1586 for (i = 0; i < NSIG; i++)
1593 printf_filtered ("\nUse the \"handle\" command to change these tables.\n");
1596 /* Save all of the information associated with the inferior<==>gdb
1597 connection. INF_STATUS is a pointer to a "struct inferior_status"
1598 (defined in inferior.h). */
1601 save_inferior_status (inf_status, restore_stack_info)
1602 struct inferior_status *inf_status;
1603 int restore_stack_info;
1605 inf_status->pc_changed = pc_changed;
1606 inf_status->stop_signal = stop_signal;
1607 inf_status->stop_pc = stop_pc;
1608 inf_status->stop_frame_address = stop_frame_address;
1609 inf_status->stop_step = stop_step;
1610 inf_status->stop_stack_dummy = stop_stack_dummy;
1611 inf_status->stopped_by_random_signal = stopped_by_random_signal;
1612 inf_status->trap_expected = trap_expected;
1613 inf_status->step_range_start = step_range_start;
1614 inf_status->step_range_end = step_range_end;
1615 inf_status->step_frame_address = step_frame_address;
1616 inf_status->step_over_calls = step_over_calls;
1617 inf_status->step_resume_break_address = step_resume_break_address;
1618 inf_status->stop_after_trap = stop_after_trap;
1619 inf_status->stop_soon_quietly = stop_soon_quietly;
1620 /* Save original bpstat chain here; replace it with copy of chain.
1621 If caller's caller is walking the chain, they'll be happier if we
1622 hand them back the original chain when restore_i_s is called. */
1623 inf_status->stop_bpstat = stop_bpstat;
1624 stop_bpstat = bpstat_copy (stop_bpstat);
1625 inf_status->breakpoint_proceeded = breakpoint_proceeded;
1626 inf_status->restore_stack_info = restore_stack_info;
1627 inf_status->proceed_to_finish = proceed_to_finish;
1629 bcopy (stop_registers, inf_status->stop_registers, REGISTER_BYTES);
1631 record_selected_frame (&(inf_status->selected_frame_address),
1632 &(inf_status->selected_level));
1637 restore_inferior_status (inf_status)
1638 struct inferior_status *inf_status;
1641 int level = inf_status->selected_level;
1643 pc_changed = inf_status->pc_changed;
1644 stop_signal = inf_status->stop_signal;
1645 stop_pc = inf_status->stop_pc;
1646 stop_frame_address = inf_status->stop_frame_address;
1647 stop_step = inf_status->stop_step;
1648 stop_stack_dummy = inf_status->stop_stack_dummy;
1649 stopped_by_random_signal = inf_status->stopped_by_random_signal;
1650 trap_expected = inf_status->trap_expected;
1651 step_range_start = inf_status->step_range_start;
1652 step_range_end = inf_status->step_range_end;
1653 step_frame_address = inf_status->step_frame_address;
1654 step_over_calls = inf_status->step_over_calls;
1655 step_resume_break_address = inf_status->step_resume_break_address;
1656 stop_after_trap = inf_status->stop_after_trap;
1657 stop_soon_quietly = inf_status->stop_soon_quietly;
1658 bpstat_clear (&stop_bpstat);
1659 stop_bpstat = inf_status->stop_bpstat;
1660 breakpoint_proceeded = inf_status->breakpoint_proceeded;
1661 proceed_to_finish = inf_status->proceed_to_finish;
1663 bcopy (inf_status->stop_registers, stop_registers, REGISTER_BYTES);
1665 /* The inferior can be gone if the user types "print exit(0)"
1666 (and perhaps other times). */
1667 if (target_has_stack && inf_status->restore_stack_info)
1669 fid = find_relative_frame (get_current_frame (),
1672 /* If inf_status->selected_frame_address is NULL, there was no
1673 previously selected frame. */
1675 FRAME_FP (fid) != inf_status->selected_frame_address ||
1679 /* I'm not sure this error message is a good idea. I have
1680 only seen it occur after "Can't continue previously
1681 requested operation" (we get called from do_cleanups), in
1682 which case it just adds insult to injury (one confusing
1683 error message after another. Besides which, does the
1684 user really care if we can't restore the previously
1686 fprintf (stderr, "Unable to restore previously selected frame.\n");
1688 select_frame (get_current_frame (), 0);
1692 select_frame (fid, inf_status->selected_level);
1698 _initialize_infrun ()
1702 add_info ("signals", signals_info,
1703 "What debugger does when program gets various signals.\n\
1704 Specify a signal number as argument to print info on that signal only.");
1706 add_com ("handle", class_run, handle_command,
1707 "Specify how to handle a signal.\n\
1708 Args are signal number followed by flags.\n\
1709 Flags allowed are \"stop\", \"print\", \"pass\",\n\
1710 \"nostop\", \"noprint\" or \"nopass\".\n\
1711 Print means print a message if this signal happens.\n\
1712 Stop means reenter debugger if this signal happens (implies print).\n\
1713 Pass means let program see this signal; otherwise program doesn't know.\n\
1714 Pass and Stop may be combined.");
1716 for (i = 0; i < NSIG; i++)
1719 signal_print[i] = 1;
1720 signal_program[i] = 1;
1723 /* Signals caused by debugger's own actions
1724 should not be given to the program afterwards. */
1725 signal_program[SIGTRAP] = 0;
1726 signal_program[SIGINT] = 0;
1728 /* Signals that are not errors should not normally enter the debugger. */
1730 signal_stop[SIGALRM] = 0;
1731 signal_print[SIGALRM] = 0;
1732 #endif /* SIGALRM */
1734 signal_stop[SIGVTALRM] = 0;
1735 signal_print[SIGVTALRM] = 0;
1736 #endif /* SIGVTALRM */
1738 signal_stop[SIGPROF] = 0;
1739 signal_print[SIGPROF] = 0;
1740 #endif /* SIGPROF */
1742 signal_stop[SIGCHLD] = 0;
1743 signal_print[SIGCHLD] = 0;
1744 #endif /* SIGCHLD */
1746 signal_stop[SIGCLD] = 0;
1747 signal_print[SIGCLD] = 0;
1750 signal_stop[SIGIO] = 0;
1751 signal_print[SIGIO] = 0;
1754 signal_stop[SIGURG] = 0;
1755 signal_print[SIGURG] = 0;