1 /* Everything about breakpoints, for GDB.
2 Copyright 1986, 1987, 1989, 1990, 1991, 1992 Free Software Foundation, Inc.
4 This file is part of GDB.
6 This program 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 2 of the License, or
9 (at your option) any later version.
11 This program 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 this program; if not, write to the Free Software
18 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */
24 #include "breakpoint.h"
26 #include "expression.h"
39 /* local function prototypes */
42 catch_command_1 PARAMS ((char *, int, int));
45 enable_delete_command PARAMS ((char *, int));
48 enable_delete_breakpoint PARAMS ((struct breakpoint *));
51 enable_once_command PARAMS ((char *, int));
54 enable_once_breakpoint PARAMS ((struct breakpoint *));
57 disable_command PARAMS ((char *, int));
60 disable_breakpoint PARAMS ((struct breakpoint *));
63 enable_command PARAMS ((char *, int));
66 enable_breakpoint PARAMS ((struct breakpoint *));
69 map_breakpoint_numbers PARAMS ((char *, void (*)(struct breakpoint *)));
72 ignore_command PARAMS ((char *, int));
75 breakpoint_re_set_one PARAMS ((char *));
78 delete_command PARAMS ((char *, int));
81 clear_command PARAMS ((char *, int));
84 catch_command PARAMS ((char *, int));
86 static struct symtabs_and_lines
87 get_catch_sals PARAMS ((int));
90 watch_command PARAMS ((char *, int));
93 tbreak_command PARAMS ((char *, int));
96 break_command_1 PARAMS ((char *, int, int));
99 mention PARAMS ((struct breakpoint *));
101 static struct breakpoint *
102 set_raw_breakpoint PARAMS ((struct symtab_and_line));
105 check_duplicates PARAMS ((CORE_ADDR));
108 describe_other_breakpoints PARAMS ((CORE_ADDR));
111 breakpoints_info PARAMS ((char *, int));
114 breakpoint_1 PARAMS ((int, int));
117 bpstat_alloc PARAMS ((struct breakpoint *, bpstat));
120 breakpoint_cond_eval PARAMS ((char *));
123 cleanup_executing_breakpoints PARAMS ((int));
126 commands_command PARAMS ((char *, int));
129 condition_command PARAMS ((char *, int));
132 get_number PARAMS ((char **));
135 set_breakpoint_count PARAMS ((int));
138 extern int addressprint; /* Print machine addresses? */
139 extern int demangle; /* Print de-mangled symbol names? */
141 /* Are we executing breakpoint commands? */
142 static int executing_breakpoint_commands;
144 /* Walk the following statement or block through all breakpoints.
145 ALL_BREAKPOINTS_SAFE does so even if the statment deletes the current
148 #define ALL_BREAKPOINTS(b) for (b = breakpoint_chain; b; b = b->next)
150 #define ALL_BREAKPOINTS_SAFE(b,tmp) \
151 for (b = breakpoint_chain; \
152 b? (tmp=b->next, 1): 0; \
155 /* Chain of all breakpoints defined. */
157 static struct breakpoint *breakpoint_chain;
159 /* Number of last breakpoint made. */
161 static int breakpoint_count;
163 /* Set breakpoint count to NUM. */
165 set_breakpoint_count (num)
168 breakpoint_count = num;
169 set_internalvar (lookup_internalvar ("bpnum"),
170 value_from_longest (builtin_type_int, (LONGEST) num));
173 /* Default address, symtab and line to put a breakpoint at
174 for "break" command with no arg.
175 if default_breakpoint_valid is zero, the other three are
176 not valid, and "break" with no arg is an error.
178 This set by print_stack_frame, which calls set_default_breakpoint. */
180 int default_breakpoint_valid;
181 CORE_ADDR default_breakpoint_address;
182 struct symtab *default_breakpoint_symtab;
183 int default_breakpoint_line;
185 /* Flag indicating extra verbosity for xgdb. */
186 extern int xgdb_verbose;
188 /* *PP is a string denoting a breakpoint. Get the number of the breakpoint.
189 Advance *PP after the string and any trailing whitespace.
191 Currently the string can either be a number or "$" followed by the name
192 of a convenience variable. Making it an expression wouldn't work well
193 for map_breakpoint_numbers (e.g. "4 + 5 + 6"). */
202 /* Empty line means refer to the last breakpoint. */
203 return breakpoint_count;
206 /* Make a copy of the name, so we can null-terminate it
207 to pass to lookup_internalvar(). */
212 while (isalnum (*p) || *p == '_')
214 varname = (char *) alloca (p - start + 1);
215 strncpy (varname, start, p - start);
216 varname[p - start] = '\0';
217 val = value_of_internalvar (lookup_internalvar (varname));
218 if (TYPE_CODE (VALUE_TYPE (val)) != TYPE_CODE_INT)
220 "Convenience variables used to specify breakpoints must have integer values."
222 retval = (int) value_as_long (val);
228 while (*p >= '0' && *p <= '9')
231 /* There is no number here. (e.g. "cond a == b"). */
232 error_no_arg ("breakpoint number");
235 if (!(isspace (*p) || *p == '\0'))
236 error ("breakpoint number expected");
243 /* condition N EXP -- set break condition of breakpoint N to EXP. */
246 condition_command (arg, from_tty)
250 register struct breakpoint *b;
255 error_no_arg ("breakpoint number");
258 bnum = get_number (&p);
261 if (b->number == bnum)
268 if (b->cond_string != NULL)
269 free ((PTR)b->cond_string);
274 b->cond_string = NULL;
276 printf_filtered ("Breakpoint %d now unconditional.\n", bnum);
281 /* I don't know if it matters whether this is the string the user
282 typed in or the decompiled expression. */
283 b->cond_string = savestring (arg, strlen (arg));
284 b->cond = parse_exp_1 (&arg, block_for_pc (b->address), 0);
286 error ("Junk at end of expression");
291 error ("No breakpoint number %d.", bnum);
296 commands_command (arg, from_tty)
300 register struct breakpoint *b;
303 struct command_line *l;
305 /* If we allowed this, we would have problems with when to
306 free the storage, if we change the commands currently
309 if (executing_breakpoint_commands)
310 error ("Can't use the \"commands\" command among a breakpoint's commands.");
313 bnum = get_number (&p);
315 error ("Unexpected extra arguments following breakpoint number.");
318 if (b->number == bnum)
320 if (from_tty && input_from_terminal_p ())
321 printf_filtered ("Type commands for when breakpoint %d is hit, one per line.\n\
322 End with a line saying just \"end\".\n", bnum);
323 l = read_command_lines ();
324 free_command_lines (&b->commands);
328 error ("No breakpoint number %d.", bnum);
331 extern int memory_breakpoint_size; /* from mem-break.c */
333 /* Like target_read_memory() but if breakpoints are inserted, return
334 the shadow contents instead of the breakpoints themselves.
336 Read "memory data" from whatever target or inferior we have.
337 Returns zero if successful, errno value if not. EIO is used
338 for address out of bounds. If breakpoints are inserted, returns
339 shadow contents, not the breakpoints themselves. From breakpoint.c. */
342 read_memory_nobpt (memaddr, myaddr, len)
348 struct breakpoint *b;
350 if (memory_breakpoint_size < 0)
351 /* No breakpoints on this machine. FIXME: This should be
352 dependent on the debugging target. Probably want
353 target_insert_breakpoint to return a size, saying how many
354 bytes of the shadow contents are used, or perhaps have
355 something like target_xfer_shadow. */
356 return target_read_memory (memaddr, myaddr, len);
360 if (b->type == bp_watchpoint || !b->inserted)
362 else if (b->address + memory_breakpoint_size <= memaddr)
363 /* The breakpoint is entirely before the chunk of memory
366 else if (b->address >= memaddr + len)
367 /* The breakpoint is entirely after the chunk of memory we
372 /* Copy the breakpoint from the shadow contents, and recurse
373 for the things before and after. */
375 /* Addresses and length of the part of the breakpoint that
377 CORE_ADDR membpt = b->address;
378 unsigned int bptlen = memory_breakpoint_size;
379 /* Offset within shadow_contents. */
382 if (membpt < memaddr)
384 /* Only copy the second part of the breakpoint. */
385 bptlen -= memaddr - membpt;
386 bptoffset = memaddr - membpt;
390 if (membpt + bptlen > memaddr + len)
392 /* Only copy the first part of the breakpoint. */
393 bptlen -= (membpt + bptlen) - (memaddr + len);
396 memcpy (myaddr + membpt - memaddr,
397 b->shadow_contents + bptoffset, bptlen);
399 if (membpt > memaddr)
401 /* Copy the section of memory before the breakpoint. */
402 status = read_memory_nobpt (memaddr, myaddr, membpt - memaddr);
407 if (membpt + bptlen < memaddr + len)
409 /* Copy the section of memory after the breakpoint. */
410 status = read_memory_nobpt
412 myaddr + membpt + bptlen - memaddr,
413 memaddr + len - (membpt + bptlen));
420 /* Nothing overlaps. Just call read_memory_noerr. */
421 return target_read_memory (memaddr, myaddr, len);
424 /* insert_breakpoints is used when starting or continuing the program.
425 remove_breakpoints is used when the program stops.
426 Both return zero if successful,
427 or an `errno' value if could not write the inferior. */
430 insert_breakpoints ()
432 register struct breakpoint *b;
434 int disabled_breaks = 0;
437 if (b->type != bp_watchpoint
438 && b->enable != disabled
442 val = target_insert_breakpoint(b->address, b->shadow_contents);
445 /* Can't set the breakpoint. */
446 #if defined (DISABLE_UNSETTABLE_BREAK)
447 if (DISABLE_UNSETTABLE_BREAK (b->address))
450 b->enable = disabled;
451 if (!disabled_breaks)
453 target_terminal_ours_for_output ();
454 fprintf_unfiltered (gdb_stderr,
455 "Cannot insert breakpoint %d:\n", b->number);
456 printf_filtered ("Disabling shared library breakpoints:\n");
459 printf_filtered ("%d ", b->number);
464 target_terminal_ours_for_output ();
465 fprintf_unfiltered (gdb_stderr, "Cannot insert breakpoint %d:\n", b->number);
466 #ifdef ONE_PROCESS_WRITETEXT
467 fprintf_unfiltered (gdb_stderr,
468 "The same program may be running in another process.\n");
470 memory_error (val, b->address); /* which bombs us out */
477 printf_filtered ("\n");
482 remove_breakpoints ()
484 register struct breakpoint *b;
488 if (b->type != bp_watchpoint && b->inserted)
490 val = target_remove_breakpoint(b->address, b->shadow_contents);
499 /* Clear the "inserted" flag in all breakpoints. */
502 mark_breakpoints_out ()
504 register struct breakpoint *b;
510 /* Clear the "inserted" flag in all breakpoints and delete any breakpoints
511 which should go away between runs of the program. */
514 breakpoint_init_inferior ()
516 register struct breakpoint *b, *temp;
518 ALL_BREAKPOINTS_SAFE (b, temp)
522 /* If the call dummy breakpoint is at the entry point it will
523 cause problems when the inferior is rerun, so we better
525 if (b->type == bp_call_dummy)
526 delete_breakpoint (b);
530 /* breakpoint_here_p (PC) returns 1 if an enabled breakpoint exists at PC.
531 When continuing from a location with a breakpoint,
532 we actually single step once before calling insert_breakpoints. */
535 breakpoint_here_p (pc)
538 register struct breakpoint *b;
541 if (b->enable != disabled && b->address == pc)
547 /* Return nonzero if FRAME is a dummy frame. We can't use PC_IN_CALL_DUMMY
548 because figuring out the saved SP would take too much time, at least using
549 get_saved_register on the 68k. This means that for this function to
550 work right a port must use the bp_call_dummy breakpoint. */
553 frame_in_dummy (frame)
556 struct breakpoint *b;
561 static unsigned LONGEST dummy[] = CALL_DUMMY;
563 if (b->type == bp_call_dummy
564 && b->frame == frame->frame
566 /* We need to check the PC as well as the frame on the sparc,
567 for signals.exp in the testsuite. */
570 - sizeof (dummy) / sizeof (LONGEST) * REGISTER_SIZE))
571 && frame->pc <= b->address)
574 #endif /* CALL_DUMMY */
578 /* breakpoint_match_thread (PC, PID) returns true if the breakpoint at PC
579 is valid for process/thread PID. */
582 breakpoint_thread_match (pc, pid)
586 struct breakpoint *b;
589 thread = pid_to_thread_id (pid);
592 if (b->enable != disabled
594 && (b->thread == -1 || b->thread == thread))
601 /* bpstat stuff. External routines' interfaces are documented
604 /* Clear a bpstat so that it says we are not at any breakpoint.
605 Also free any storage that is part of a bpstat. */
620 if (p->old_val != NULL)
621 value_free (p->old_val);
628 /* Return a copy of a bpstat. Like "bs1 = bs2" but all storage that
629 is part of the bpstat is copied as well. */
637 bpstat retval = NULL;
642 for (; bs != NULL; bs = bs->next)
644 tmp = (bpstat) xmalloc (sizeof (*tmp));
645 memcpy (tmp, bs, sizeof (*tmp));
647 /* This is the first thing in the chain. */
657 /* Find the bpstat associated with this breakpoint */
660 bpstat_find_breakpoint(bsp, breakpoint)
662 struct breakpoint *breakpoint;
664 if (bsp == NULL) return NULL;
666 for (;bsp != NULL; bsp = bsp->next) {
667 if (bsp->breakpoint_at == breakpoint) return bsp;
672 /* Return the breakpoint number of the first breakpoint we are stopped
673 at. *BSP upon return is a bpstat which points to the remaining
674 breakpoints stopped at (but which is not guaranteed to be good for
675 anything but further calls to bpstat_num).
676 Return 0 if passed a bpstat which does not indicate any breakpoints. */
682 struct breakpoint *b;
685 return 0; /* No more breakpoint values */
688 b = (*bsp)->breakpoint_at;
691 return -1; /* breakpoint that's been deleted since */
693 return b->number; /* We have its number */
697 /* Modify BS so that the actions will not be performed. */
700 bpstat_clear_actions (bs)
703 for (; bs != NULL; bs = bs->next)
706 if (bs->old_val != NULL)
708 value_free (bs->old_val);
714 /* Stub for cleaning up our state if we error-out of a breakpoint command */
717 cleanup_executing_breakpoints (ignore)
720 executing_breakpoint_commands = 0;
723 /* Execute all the commands associated with all the breakpoints at this
724 location. Any of these commands could cause the process to proceed
725 beyond this point, etc. We look out for such changes by checking
726 the global "breakpoint_proceeded" after each command. */
729 bpstat_do_actions (bsp)
733 struct cleanup *old_chain;
735 executing_breakpoint_commands = 1;
736 old_chain = make_cleanup (cleanup_executing_breakpoints, 0);
741 breakpoint_proceeded = 0;
742 for (; bs != NULL; bs = bs->next)
746 char *line = bs->commands->line;
747 bs->commands = bs->commands->next;
748 execute_command (line, 0);
749 /* If the inferior is proceeded by the command, bomb out now.
750 The bpstat chain has been blown away by wait_for_inferior.
751 But since execution has stopped again, there is a new bpstat
752 to look at, so start over. */
753 if (breakpoint_proceeded)
758 executing_breakpoint_commands = 0;
759 discard_cleanups (old_chain);
762 /* This is the normal print_it function for a bpstat. In the future,
763 much of this logic could (should?) be moved to bpstat_stop_status,
764 by having it set different print_it functions. */
770 /* bs->breakpoint_at can be NULL if it was a momentary breakpoint
771 which has since been deleted. */
772 if (bs->breakpoint_at == NULL
773 || (bs->breakpoint_at->type != bp_breakpoint
774 && bs->breakpoint_at->type != bp_watchpoint))
777 if (bs->breakpoint_at->type == bp_breakpoint)
779 /* I think the user probably only wants to see one breakpoint
780 number, not all of them. */
781 printf_filtered ("\nBreakpoint %d, ", bs->breakpoint_at->number);
785 if (bs->old_val != NULL)
787 printf_filtered ("\nWatchpoint %d, ", bs->breakpoint_at->number);
788 print_expression (bs->breakpoint_at->exp, gdb_stdout);
789 printf_filtered ("\nOld value = ");
790 value_print (bs->old_val, gdb_stdout, 0, Val_pretty_default);
791 printf_filtered ("\nNew value = ");
792 value_print (bs->breakpoint_at->val, gdb_stdout, 0,
794 printf_filtered ("\n");
795 value_free (bs->old_val);
797 /* More than one watchpoint may have been triggered. */
800 /* We can't deal with it. Maybe another member of the bpstat chain can. */
804 /* Print a message indicating what happened. Returns nonzero to
805 say that only the source line should be printed after this (zero
806 return means print the frame as well as the source line). */
807 /* Currently we always return zero. */
817 val = (*bs->print_it) (bs);
821 /* Maybe another breakpoint in the chain caused us to stop.
822 (Currently all watchpoints go on the bpstat whether hit or
823 not. That probably could (should) be changed, provided care is taken
824 with respect to bpstat_explains_signal). */
826 return bpstat_print (bs->next);
828 /* We reached the end of the chain without printing anything. */
832 /* Evaluate the expression EXP and return 1 if value is zero.
833 This is used inside a catch_errors to evaluate the breakpoint condition.
834 The argument is a "struct expression *" that has been cast to char * to
835 make it pass through catch_errors. */
838 breakpoint_cond_eval (exp)
841 return !value_true (evaluate_expression ((struct expression *)exp));
844 /* Allocate a new bpstat and chain it to the current one. */
847 bpstat_alloc (b, cbs)
848 register struct breakpoint *b;
849 bpstat cbs; /* Current "bs" value */
853 bs = (bpstat) xmalloc (sizeof (*bs));
855 bs->breakpoint_at = b;
856 /* If the condition is false, etc., don't do the commands. */
859 bs->print_it = print_it_normal;
863 /* Return the frame which we can use to evaluate the expression
864 whose valid block is valid_block, or NULL if not in scope.
866 This whole concept is probably not the way to do things (it is incredibly
867 slow being the main reason, not to mention fragile (e.g. the sparc
868 frame pointer being fetched as 0 bug causes it to stop)). Instead,
869 introduce a version of "struct frame" which survives over calls to the
870 inferior, but which is better than FRAME_ADDR in the sense that it lets
871 us evaluate expressions relative to that frame (on some machines, it
872 can just be a FRAME_ADDR). Save one of those instead of (or in addition
873 to) the exp_valid_block, and then use it to evaluate the watchpoint
874 expression, with no need to do all this backtracing every time.
876 Or better yet, what if it just copied the struct frame and its next
877 frame? Off the top of my head, I would think that would work
878 because things like (a29k) rsize and msize, or (sparc) bottom just
879 depend on the frame, and aren't going to be different just because
880 the inferior has done something. Trying to recalculate them
881 strikes me as a lot of work, possibly even impossible. Saving the
882 next frame is needed at least on a29k, where get_saved_register
883 uses fi->next->saved_msp. For figuring out whether that frame is
884 still on the stack, I guess this needs to be machine-specific (e.g.
887 read_fp () INNER_THAN watchpoint_frame->frame
889 would generally work.
891 Of course the scope of the expression could be less than a whole
892 function; perhaps if the innermost frame is the one which the
893 watchpoint is relative to (another machine-specific thing, usually
895 FRAMELESS_FUNCTION_INVOCATION (get_current_frame(), fromleaf)
896 read_fp () == wp_frame->frame
899 ), *then* it could do a
901 contained_in (get_current_block (), wp->exp_valid_block).
906 within_scope (valid_block)
907 struct block *valid_block;
909 FRAME fr = get_current_frame ();
910 struct frame_info *fi = get_frame_info (fr);
911 CORE_ADDR func_start;
913 /* If caller_pc_valid is true, we are stepping through
914 a function prologue, which is bounded by callee_func_start
915 (inclusive) and callee_prologue_end (exclusive).
916 caller_pc is the pc of the caller.
918 Yes, this is hairy. */
919 static int caller_pc_valid = 0;
920 static CORE_ADDR caller_pc;
921 static CORE_ADDR callee_func_start;
922 static CORE_ADDR callee_prologue_end;
924 find_pc_partial_function (fi->pc, (PTR)NULL, &func_start, (CORE_ADDR *)NULL);
925 func_start += FUNCTION_START_OFFSET;
926 if (fi->pc == func_start)
928 /* We just called a function. The only other case I
929 can think of where the pc would equal the pc of the
930 start of a function is a frameless function (i.e.
931 no prologue) where we branch back to the start
932 of the function. In that case, SKIP_PROLOGUE won't
933 find one, and we'll clear caller_pc_valid a few lines
936 caller_pc = SAVED_PC_AFTER_CALL (fr);
937 callee_func_start = func_start;
938 SKIP_PROLOGUE (func_start);
939 callee_prologue_end = func_start;
943 if (fi->pc < callee_func_start
944 || fi->pc >= callee_prologue_end)
948 if (contained_in (block_for_pc (caller_pc_valid
955 fr = get_prev_frame (fr);
957 /* If any active frame is in the exp_valid_block, then it's
958 OK. Note that this might not be the same invocation of
959 the exp_valid_block that we were watching a little while
960 ago, or the same one as when the watchpoint was set (e.g.
961 we are watching a local variable in a recursive function.
962 When we return from a recursive invocation, then we are
963 suddenly watching a different instance of the variable).
965 At least for now I am going to consider this a feature. */
966 for (; fr != NULL; fr = get_prev_frame (fr))
968 fi = get_frame_info (fr);
969 if (contained_in (block_for_pc (fi->pc),
978 /* Possible return values for watchpoint_check (this can't be an enum
979 because of check_errors). */
980 /* The watchpoint has been disabled. */
981 #define WP_DISABLED 1
982 /* The value has changed. */
983 #define WP_VALUE_CHANGED 2
984 /* The value has not changed. */
985 #define WP_VALUE_NOT_CHANGED 3
987 /* Check watchpoint condition. */
992 bpstat bs = (bpstat) p;
995 int within_current_scope;
996 if (bs->breakpoint_at->exp_valid_block == NULL)
997 within_current_scope = 1;
1000 fr = within_scope (bs->breakpoint_at->exp_valid_block);
1001 within_current_scope = fr != NULL;
1002 if (within_current_scope)
1003 /* If we end up stopping, the current frame will get selected
1004 in normal_stop. So this call to select_frame won't affect
1006 select_frame (fr, -1);
1009 if (within_current_scope)
1011 /* We use value_{,free_to_}mark because it could be a
1012 *long* time before we return to the command level and
1013 call free_all_values. We can't call free_all_values because
1014 we might be in the middle of evaluating a function call. */
1016 value_ptr mark = value_mark ();
1017 value_ptr new_val = evaluate_expression (bs->breakpoint_at->exp);
1018 if (!value_equal (bs->breakpoint_at->val, new_val))
1020 release_value (new_val);
1021 value_free_to_mark (mark);
1022 bs->old_val = bs->breakpoint_at->val;
1023 bs->breakpoint_at->val = new_val;
1024 /* We will stop here */
1025 return WP_VALUE_CHANGED;
1029 /* Nothing changed, don't do anything. */
1030 value_free_to_mark (mark);
1031 /* We won't stop here */
1032 return WP_VALUE_NOT_CHANGED;
1037 /* This seems like the only logical thing to do because
1038 if we temporarily ignored the watchpoint, then when
1039 we reenter the block in which it is valid it contains
1040 garbage (in the case of a function, it may have two
1041 garbage values, one before and one after the prologue).
1042 So we can't even detect the first assignment to it and
1043 watch after that (since the garbage may or may not equal
1044 the first value assigned). */
1045 bs->breakpoint_at->enable = disabled;
1047 Watchpoint %d disabled because the program has left the block in\n\
1048 which its expression is valid.\n", bs->breakpoint_at->number);
1053 /* This is used when everything which needs to be printed has
1054 already been printed. But we still want to print the frame. */
1062 /* This is used when nothing should be printed for this bpstat entry. */
1071 /* Get a bpstat associated with having just stopped at address *PC
1072 and frame address FRAME_ADDRESS. Update *PC to point at the
1073 breakpoint (if we hit a breakpoint). NOT_A_BREAKPOINT is nonzero
1074 if this is known to not be a real breakpoint (it could still be a
1075 watchpoint, though). */
1077 /* Determine whether we stopped at a breakpoint, etc, or whether we
1078 don't understand this stop. Result is a chain of bpstat's such that:
1080 if we don't understand the stop, the result is a null pointer.
1082 if we understand why we stopped, the result is not null.
1084 Each element of the chain refers to a particular breakpoint or
1085 watchpoint at which we have stopped. (We may have stopped for
1086 several reasons concurrently.)
1088 Each element of the chain has valid next, breakpoint_at,
1089 commands, FIXME??? fields.
1094 bpstat_stop_status (pc, frame_address, not_a_breakpoint)
1096 FRAME_ADDR frame_address;
1097 int not_a_breakpoint;
1099 register struct breakpoint *b;
1101 #if DECR_PC_AFTER_BREAK != 0 || defined (SHIFT_INST_REGS)
1102 /* True if we've hit a breakpoint (as opposed to a watchpoint). */
1103 int real_breakpoint = 0;
1105 /* Root of the chain of bpstat's */
1106 struct bpstat root_bs[1];
1107 /* Pointer to the last thing in the chain currently. */
1108 bpstat bs = root_bs;
1110 /* Get the address where the breakpoint would have been. */
1111 bp_addr = *pc - DECR_PC_AFTER_BREAK;
1115 if (b->enable == disabled)
1118 if (b->type != bp_watchpoint && b->address != bp_addr)
1121 if (b->type != bp_watchpoint && not_a_breakpoint)
1124 /* Come here if it's a watchpoint, or if the break address matches */
1126 bs = bpstat_alloc (b, bs); /* Alloc a bpstat to explain stop */
1131 if (b->type == bp_watchpoint)
1133 static char message1[] =
1134 "Error evaluating expression for watchpoint %d\n";
1135 char message[sizeof (message1) + 30 /* slop */];
1136 sprintf (message, message1, b->number);
1137 switch (catch_errors (watchpoint_check, (char *) bs, message,
1141 /* We've already printed what needs to be printed. */
1142 bs->print_it = print_it_done;
1145 case WP_VALUE_CHANGED:
1148 case WP_VALUE_NOT_CHANGED:
1150 bs->print_it = print_it_noop;
1157 /* Error from catch_errors. */
1158 b->enable = disabled;
1159 printf_filtered ("Watchpoint %d disabled.\n", b->number);
1160 /* We've already printed what needs to be printed. */
1161 bs->print_it = print_it_done;
1166 #if DECR_PC_AFTER_BREAK != 0 || defined (SHIFT_INST_REGS)
1168 real_breakpoint = 1;
1171 if (b->frame && b->frame != frame_address)
1175 int value_is_zero = 0;
1179 /* Need to select the frame, with all that implies
1180 so that the conditions will have the right context. */
1181 select_frame (get_current_frame (), 0);
1183 = catch_errors (breakpoint_cond_eval, (char *)(b->cond),
1184 "Error in testing breakpoint condition:\n",
1186 /* FIXME-someday, should give breakpoint # */
1189 if (b->cond && value_is_zero)
1193 else if (b->ignore_count > 0)
1200 /* We will stop here */
1201 if (b->disposition == disable)
1202 b->enable = disabled;
1203 bs->commands = b->commands;
1206 if (bs->commands && STREQ ("silent", bs->commands->line))
1208 bs->commands = bs->commands->next;
1213 /* Print nothing for this entry if we dont stop or if we dont print. */
1214 if (bs->stop == 0 || bs->print == 0)
1215 bs->print_it = print_it_noop;
1218 bs->next = NULL; /* Terminate the chain */
1219 bs = root_bs->next; /* Re-grab the head of the chain */
1220 #if DECR_PC_AFTER_BREAK != 0 || defined (SHIFT_INST_REGS)
1223 if (real_breakpoint)
1226 #if defined (SHIFT_INST_REGS)
1228 #else /* No SHIFT_INST_REGS. */
1230 #endif /* No SHIFT_INST_REGS. */
1233 #endif /* DECR_PC_AFTER_BREAK != 0. */
1237 /* Tell what to do about this bpstat. */
1242 /* Classify each bpstat as one of the following. */
1244 /* This bpstat element has no effect on the main_action. */
1247 /* There was a watchpoint, stop but don't print. */
1250 /* There was a watchpoint, stop and print. */
1253 /* There was a breakpoint but we're not stopping. */
1256 /* There was a breakpoint, stop but don't print. */
1259 /* There was a breakpoint, stop and print. */
1262 /* We hit the longjmp breakpoint. */
1265 /* We hit the longjmp_resume breakpoint. */
1268 /* We hit the step_resume breakpoint. */
1271 /* We hit the through_sigtramp breakpoint. */
1274 /* This is just used to count how many enums there are. */
1278 /* Here is the table which drives this routine. So that we can
1279 format it pretty, we define some abbreviations for the
1280 enum bpstat_what codes. */
1281 #define keep_c BPSTAT_WHAT_KEEP_CHECKING
1282 #define stop_s BPSTAT_WHAT_STOP_SILENT
1283 #define stop_n BPSTAT_WHAT_STOP_NOISY
1284 #define single BPSTAT_WHAT_SINGLE
1285 #define setlr BPSTAT_WHAT_SET_LONGJMP_RESUME
1286 #define clrlr BPSTAT_WHAT_CLEAR_LONGJMP_RESUME
1287 #define clrlrs BPSTAT_WHAT_CLEAR_LONGJMP_RESUME_SINGLE
1288 #define sr BPSTAT_WHAT_STEP_RESUME
1289 #define ts BPSTAT_WHAT_THROUGH_SIGTRAMP
1291 /* "Can't happen." Might want to print an error message.
1292 abort() is not out of the question, but chances are GDB is just
1293 a bit confused, not unusable. */
1294 #define err BPSTAT_WHAT_STOP_NOISY
1296 /* Given an old action and a class, come up with a new action. */
1297 /* One interesting property of this table is that wp_silent is the same
1298 as bp_silent and wp_noisy is the same as bp_noisy. That is because
1299 after stopping, the check for whether to step over a breakpoint
1300 (BPSTAT_WHAT_SINGLE type stuff) is handled in proceed() without
1301 reference to how we stopped. We retain separate wp_silent and bp_silent
1302 codes in case we want to change that someday. */
1304 /* step_resume entries: a step resume breakpoint overrides another
1305 breakpoint of signal handling (see comment in wait_for_inferior
1306 at first IN_SIGTRAMP where we set the step_resume breakpoint). */
1307 /* We handle the through_sigtramp_breakpoint the same way; having both
1308 one of those and a step_resume_breakpoint is probably very rare (?). */
1310 static const enum bpstat_what_main_action
1311 table[(int)class_last][(int)BPSTAT_WHAT_LAST] =
1314 /* keep_c stop_s stop_n single setlr clrlr clrlrs sr ts
1316 /*no_effect*/ {keep_c,stop_s,stop_n,single, setlr , clrlr , clrlrs, sr, ts},
1317 /*wp_silent*/ {stop_s,stop_s,stop_n,stop_s, stop_s, stop_s, stop_s, sr, ts},
1318 /*wp_noisy*/ {stop_n,stop_n,stop_n,stop_n, stop_n, stop_n, stop_n, sr, ts},
1319 /*bp_nostop*/ {single,stop_s,stop_n,single, setlr , clrlrs, clrlrs, sr, ts},
1320 /*bp_silent*/ {stop_s,stop_s,stop_n,stop_s, stop_s, stop_s, stop_s, sr, ts},
1321 /*bp_noisy*/ {stop_n,stop_n,stop_n,stop_n, stop_n, stop_n, stop_n, sr, ts},
1322 /*long_jump*/ {setlr ,stop_s,stop_n,setlr , err , err , err , sr, ts},
1323 /*long_resume*/ {clrlr ,stop_s,stop_n,clrlrs, err , err , err , sr, ts},
1324 /*step_resume*/ {sr ,sr ,sr ,sr , sr , sr , sr , sr, ts},
1325 /*through_sig*/ {ts ,ts ,ts ,ts , ts , ts , ts , ts, ts}
1337 enum bpstat_what_main_action current_action = BPSTAT_WHAT_KEEP_CHECKING;
1338 struct bpstat_what retval;
1340 retval.call_dummy = 0;
1341 for (; bs != NULL; bs = bs->next)
1343 enum class bs_class = no_effect;
1344 if (bs->breakpoint_at == NULL)
1345 /* I suspect this can happen if it was a momentary breakpoint
1346 which has since been deleted. */
1348 switch (bs->breakpoint_at->type)
1356 bs_class = bp_noisy;
1358 bs_class = bp_silent;
1361 bs_class = bp_nostop;
1367 bs_class = wp_noisy;
1369 bs_class = wp_silent;
1372 /* There was a watchpoint, but we're not stopping. This requires
1373 no further action. */
1374 bs_class = no_effect;
1377 bs_class = long_jump;
1379 case bp_longjmp_resume:
1380 bs_class = long_resume;
1382 case bp_step_resume:
1385 bs_class = step_resume;
1388 /* It is for the wrong frame. */
1389 bs_class = bp_nostop;
1391 case bp_through_sigtramp:
1392 bs_class = through_sig;
1395 /* Make sure the action is stop (silent or noisy), so infrun.c
1396 pops the dummy frame. */
1397 bs_class = bp_silent;
1398 retval.call_dummy = 1;
1401 current_action = table[(int)bs_class][(int)current_action];
1403 retval.main_action = current_action;
1407 /* Nonzero if we should step constantly (e.g. watchpoints on machines
1408 without hardware support). This isn't related to a specific bpstat,
1409 just to things like whether watchpoints are set. */
1412 bpstat_should_step ()
1414 struct breakpoint *b;
1416 if (b->enable == enabled && b->type == bp_watchpoint)
1421 /* Print information on breakpoint number BNUM, or -1 if all.
1422 If WATCHPOINTS is zero, process only breakpoints; if WATCHPOINTS
1423 is nonzero, process only watchpoints. */
1426 breakpoint_1 (bnum, allflag)
1430 register struct breakpoint *b;
1431 register struct command_line *l;
1432 register struct symbol *sym;
1433 CORE_ADDR last_addr = (CORE_ADDR)-1;
1434 int found_a_breakpoint = 0;
1435 static char *bptypes[] = {"breakpoint", "until", "finish", "watchpoint",
1436 "longjmp", "longjmp resume", "step resume",
1438 static char *bpdisps[] = {"del", "dis", "keep"};
1439 static char bpenables[] = "ny";
1440 char wrap_indent[80];
1444 || bnum == b->number)
1446 /* We only print out user settable breakpoints unless the allflag is set. */
1448 && b->type != bp_breakpoint
1449 && b->type != bp_watchpoint)
1452 if (!found_a_breakpoint++)
1453 printf_filtered ("Num Type Disp Enb %sWhat\n",
1454 addressprint ? "Address " : "");
1456 printf_filtered ("%-3d %-14s %-4s %-3c ",
1458 bptypes[(int)b->type],
1459 bpdisps[(int)b->disposition],
1460 bpenables[(int)b->enable]);
1461 strcpy (wrap_indent, " ");
1463 strcat (wrap_indent, " ");
1467 print_expression (b->exp, gdb_stdout);
1474 case bp_longjmp_resume:
1475 case bp_step_resume:
1476 case bp_through_sigtramp:
1479 printf_filtered ("%s ", local_hex_string_custom ((unsigned long) b->address, "08l"));
1481 last_addr = b->address;
1484 sym = find_pc_function (b->address);
1487 fputs_filtered ("in ", gdb_stdout);
1488 fputs_filtered (SYMBOL_SOURCE_NAME (sym), gdb_stdout);
1489 wrap_here (wrap_indent);
1490 fputs_filtered (" at ", gdb_stdout);
1492 fputs_filtered (b->source_file, gdb_stdout);
1493 printf_filtered (":%d", b->line_number);
1496 print_address_symbolic (b->address, gdb_stdout, demangle, " ");
1500 printf_filtered ("\n");
1504 printf_filtered ("\tstop only in stack frame at ");
1505 print_address_numeric (b->frame, gdb_stdout);
1506 printf_filtered ("\n");
1510 printf_filtered ("\tstop only if ");
1511 print_expression (b->cond, gdb_stdout);
1512 printf_filtered ("\n");
1514 if (b->ignore_count)
1515 printf_filtered ("\tignore next %d hits\n", b->ignore_count);
1516 if ((l = b->commands))
1519 fputs_filtered ("\t", gdb_stdout);
1520 fputs_filtered (l->line, gdb_stdout);
1521 fputs_filtered ("\n", gdb_stdout);
1526 if (!found_a_breakpoint)
1529 printf_filtered ("No breakpoints or watchpoints.\n");
1531 printf_filtered ("No breakpoint or watchpoint number %d.\n", bnum);
1534 /* Compare against (CORE_ADDR)-1 in case some compiler decides
1535 that a comparison of an unsigned with -1 is always false. */
1536 if (last_addr != (CORE_ADDR)-1)
1537 set_next_address (last_addr);
1542 breakpoints_info (bnum_exp, from_tty)
1549 bnum = parse_and_eval_address (bnum_exp);
1551 breakpoint_1 (bnum, 0);
1554 #if MAINTENANCE_CMDS
1558 maintenance_info_breakpoints (bnum_exp, from_tty)
1565 bnum = parse_and_eval_address (bnum_exp);
1567 breakpoint_1 (bnum, 1);
1572 /* Print a message describing any breakpoints set at PC. */
1575 describe_other_breakpoints (pc)
1576 register CORE_ADDR pc;
1578 register int others = 0;
1579 register struct breakpoint *b;
1582 if (b->address == pc)
1586 printf_filtered ("Note: breakpoint%s ", (others > 1) ? "s" : "");
1588 if (b->address == pc)
1594 (b->enable == disabled) ? " (disabled)" : "",
1595 (others > 1) ? "," : ((others == 1) ? " and" : ""));
1597 printf_filtered ("also set at pc ");
1598 print_address_numeric (pc, gdb_stdout);
1599 printf_filtered (".\n");
1603 /* Set the default place to put a breakpoint
1604 for the `break' command with no arguments. */
1607 set_default_breakpoint (valid, addr, symtab, line)
1610 struct symtab *symtab;
1613 default_breakpoint_valid = valid;
1614 default_breakpoint_address = addr;
1615 default_breakpoint_symtab = symtab;
1616 default_breakpoint_line = line;
1619 /* Rescan breakpoints at address ADDRESS,
1620 marking the first one as "first" and any others as "duplicates".
1621 This is so that the bpt instruction is only inserted once. */
1624 check_duplicates (address)
1627 register struct breakpoint *b;
1628 register int count = 0;
1630 if (address == 0) /* Watchpoints are uninteresting */
1634 if (b->enable != disabled && b->address == address)
1637 b->duplicate = count > 1;
1641 /* Low level routine to set a breakpoint.
1642 Takes as args the three things that every breakpoint must have.
1643 Returns the breakpoint object so caller can set other things.
1644 Does not set the breakpoint number!
1645 Does not print anything.
1647 ==> This routine should not be called if there is a chance of later
1648 error(); otherwise it leaves a bogus breakpoint on the chain. Validate
1649 your arguments BEFORE calling this routine! */
1651 static struct breakpoint *
1652 set_raw_breakpoint (sal)
1653 struct symtab_and_line sal;
1655 register struct breakpoint *b, *b1;
1657 b = (struct breakpoint *) xmalloc (sizeof (struct breakpoint));
1658 memset (b, 0, sizeof (*b));
1659 b->address = sal.pc;
1660 if (sal.symtab == NULL)
1661 b->source_file = NULL;
1663 b->source_file = savestring (sal.symtab->filename,
1664 strlen (sal.symtab->filename));
1666 b->line_number = sal.line;
1667 b->enable = enabled;
1670 b->ignore_count = 0;
1674 /* Add this breakpoint to the end of the chain
1675 so that a list of breakpoints will come out in order
1676 of increasing numbers. */
1678 b1 = breakpoint_chain;
1680 breakpoint_chain = b;
1688 check_duplicates (sal.pc);
1694 create_longjmp_breakpoint(func_name)
1697 struct symtab_and_line sal;
1698 struct breakpoint *b;
1699 static int internal_breakpoint_number = -1;
1701 if (func_name != NULL)
1703 struct minimal_symbol *m;
1705 m = lookup_minimal_symbol(func_name, (struct objfile *)NULL);
1707 sal.pc = SYMBOL_VALUE_ADDRESS (m);
1717 b = set_raw_breakpoint(sal);
1720 b->type = func_name != NULL ? bp_longjmp : bp_longjmp_resume;
1721 b->disposition = donttouch;
1722 b->enable = disabled;
1725 b->addr_string = strsave(func_name);
1726 b->number = internal_breakpoint_number--;
1729 /* Call this routine when stepping and nexting to enable a breakpoint if we do
1730 a longjmp(). When we hit that breakpoint, call
1731 set_longjmp_resume_breakpoint() to figure out where we are going. */
1734 enable_longjmp_breakpoint()
1736 register struct breakpoint *b;
1739 if (b->type == bp_longjmp)
1741 b->enable = enabled;
1742 check_duplicates (b->address);
1747 disable_longjmp_breakpoint()
1749 register struct breakpoint *b;
1752 if ( b->type == bp_longjmp
1753 || b->type == bp_longjmp_resume)
1755 b->enable = disabled;
1756 check_duplicates (b->address);
1760 /* Call this after hitting the longjmp() breakpoint. Use this to set a new
1761 breakpoint at the target of the jmp_buf.
1763 FIXME - This ought to be done by setting a temporary breakpoint that gets
1764 deleted automatically...
1768 set_longjmp_resume_breakpoint(pc, frame)
1772 register struct breakpoint *b;
1775 if (b->type == bp_longjmp_resume)
1778 b->enable = enabled;
1780 b->frame = FRAME_FP(frame);
1783 check_duplicates (b->address);
1788 /* Set a breakpoint that will evaporate an end of command
1789 at address specified by SAL.
1790 Restrict it to frame FRAME if FRAME is nonzero. */
1793 set_momentary_breakpoint (sal, frame, type)
1794 struct symtab_and_line sal;
1798 register struct breakpoint *b;
1799 b = set_raw_breakpoint (sal);
1801 b->enable = enabled;
1802 b->disposition = donttouch;
1803 b->frame = (frame ? FRAME_FP (frame) : 0);
1809 clear_momentary_breakpoints ()
1811 register struct breakpoint *b;
1813 if (b->disposition == delete)
1815 delete_breakpoint (b);
1821 /* Tell the user we have just set a breakpoint B. */
1824 struct breakpoint *b;
1829 printf_filtered ("Watchpoint %d: ", b->number);
1830 print_expression (b->exp, gdb_stdout);
1833 printf_filtered ("Breakpoint %d at ", b->number);
1834 print_address_numeric (b->address, gdb_stdout);
1836 printf_filtered (": file %s, line %d.",
1837 b->source_file, b->line_number);
1842 case bp_longjmp_resume:
1843 case bp_step_resume:
1844 case bp_through_sigtramp:
1848 printf_filtered ("\n");
1852 /* Nobody calls this currently. */
1853 /* Set a breakpoint from a symtab and line.
1854 If TEMPFLAG is nonzero, it is a temporary breakpoint.
1855 ADDR_STRING is a malloc'd string holding the name of where we are
1856 setting the breakpoint. This is used later to re-set it after the
1857 program is relinked and symbols are reloaded.
1858 Print the same confirmation messages that the breakpoint command prints. */
1861 set_breakpoint (s, line, tempflag, addr_string)
1867 register struct breakpoint *b;
1868 struct symtab_and_line sal;
1873 resolve_sal_pc (&sal); /* Might error out */
1874 describe_other_breakpoints (sal.pc);
1876 b = set_raw_breakpoint (sal);
1877 set_breakpoint_count (breakpoint_count + 1);
1878 b->number = breakpoint_count;
1879 b->type = bp_breakpoint;
1881 b->addr_string = addr_string;
1882 b->enable = enabled;
1883 b->disposition = tempflag ? delete : donttouch;
1889 /* Set a breakpoint according to ARG (function, linenum or *address)
1890 and make it temporary if TEMPFLAG is nonzero. */
1893 break_command_1 (arg, tempflag, from_tty)
1895 int tempflag, from_tty;
1897 struct symtabs_and_lines sals;
1898 struct symtab_and_line sal;
1899 register struct expression *cond = 0;
1900 register struct breakpoint *b;
1902 /* Pointers in arg to the start, and one past the end, of the condition. */
1903 char *cond_start = NULL;
1904 char *cond_end = NULL;
1905 /* Pointers in arg to the start, and one past the end,
1906 of the address part. */
1907 char *addr_start = NULL;
1908 char *addr_end = NULL;
1909 struct cleanup *old_chain;
1910 struct cleanup *canonical_strings_chain = NULL;
1911 char **canonical = (char **)NULL;
1918 sal.line = sal.pc = sal.end = 0;
1921 /* If no arg given, or if first arg is 'if ', use the default breakpoint. */
1923 if (!arg || (arg[0] == 'i' && arg[1] == 'f'
1924 && (arg[2] == ' ' || arg[2] == '\t')))
1926 if (default_breakpoint_valid)
1928 sals.sals = (struct symtab_and_line *)
1929 xmalloc (sizeof (struct symtab_and_line));
1930 sal.pc = default_breakpoint_address;
1931 sal.line = default_breakpoint_line;
1932 sal.symtab = default_breakpoint_symtab;
1937 error ("No default breakpoint address now.");
1943 /* Force almost all breakpoints to be in terms of the
1944 current_source_symtab (which is decode_line_1's default). This
1945 should produce the results we want almost all of the time while
1946 leaving default_breakpoint_* alone. */
1947 if (default_breakpoint_valid
1948 && (!current_source_symtab
1949 || (arg && (*arg == '+' || *arg == '-'))))
1950 sals = decode_line_1 (&arg, 1, default_breakpoint_symtab,
1951 default_breakpoint_line, &canonical);
1953 sals = decode_line_1 (&arg, 1, (struct symtab *)NULL, 0, &canonical);
1961 /* Make sure that all storage allocated in decode_line_1 gets freed in case
1962 the following `for' loop errors out. */
1963 old_chain = make_cleanup (free, sals.sals);
1964 if (canonical != (char **)NULL)
1966 make_cleanup (free, canonical);
1967 canonical_strings_chain = make_cleanup (null_cleanup, 0);
1968 for (i = 0; i < sals.nelts; i++)
1970 if (canonical[i] != NULL)
1971 make_cleanup (free, canonical[i]);
1975 thread = -1; /* No specific thread yet */
1977 /* Resolve all line numbers to PC's, and verify that conditions
1978 can be parsed, before setting any breakpoints. */
1979 for (i = 0; i < sals.nelts; i++)
1981 char *tok, *end_tok;
1984 resolve_sal_pc (&sals.sals[i]);
1990 while (*tok == ' ' || *tok == '\t')
1995 while (*end_tok != ' ' && *end_tok != '\t' && *end_tok != '\000')
1998 toklen = end_tok - tok;
2000 if (toklen >= 1 && strncmp (tok, "if", toklen) == 0)
2002 tok = cond_start = end_tok + 1;
2003 cond = parse_exp_1 (&tok, block_for_pc (sals.sals[i].pc), 0);
2006 else if (toklen >= 1 && strncmp (tok, "thread", toklen) == 0)
2012 thread = strtol (tok, &tok, 0);
2014 error ("Junk after thread keyword.");
2015 if (!valid_thread_id (thread))
2016 error ("Unknown thread %d\n", thread);
2019 error ("Junk at end of arguments.");
2023 /* Remove the canonical strings from the cleanup, they are needed below. */
2024 if (canonical != (char **)NULL)
2025 discard_cleanups (canonical_strings_chain);
2027 /* Now set all the breakpoints. */
2028 for (i = 0; i < sals.nelts; i++)
2033 describe_other_breakpoints (sal.pc);
2035 b = set_raw_breakpoint (sal);
2036 set_breakpoint_count (breakpoint_count + 1);
2037 b->number = breakpoint_count;
2038 b->type = bp_breakpoint;
2042 /* If a canonical line spec is needed use that instead of the
2044 if (canonical != (char **)NULL && canonical[i] != NULL)
2045 b->addr_string = canonical[i];
2046 else if (addr_start)
2047 b->addr_string = savestring (addr_start, addr_end - addr_start);
2049 b->cond_string = savestring (cond_start, cond_end - cond_start);
2051 b->enable = enabled;
2052 b->disposition = tempflag ? delete : donttouch;
2059 printf_filtered ("Multiple breakpoints were set.\n");
2060 printf_filtered ("Use the \"delete\" command to delete unwanted breakpoints.\n");
2062 do_cleanups (old_chain);
2065 /* Helper function for break_command_1 and disassemble_command. */
2068 resolve_sal_pc (sal)
2069 struct symtab_and_line *sal;
2073 if (sal->pc == 0 && sal->symtab != 0)
2075 pc = find_line_pc (sal->symtab, sal->line);
2077 error ("No line %d in file \"%s\".",
2078 sal->line, sal->symtab->filename);
2084 break_command (arg, from_tty)
2088 break_command_1 (arg, 0, from_tty);
2092 tbreak_command (arg, from_tty)
2096 break_command_1 (arg, 1, from_tty);
2101 watch_command (arg, from_tty)
2105 struct breakpoint *b;
2106 struct symtab_and_line sal;
2107 struct expression *exp;
2108 struct block *exp_valid_block;
2115 /* Parse arguments. */
2116 innermost_block = NULL;
2117 exp = parse_expression (arg);
2118 exp_valid_block = innermost_block;
2119 val = evaluate_expression (exp);
2120 release_value (val);
2121 if (VALUE_LAZY (val))
2122 value_fetch_lazy (val);
2124 /* Now set up the breakpoint. */
2125 b = set_raw_breakpoint (sal);
2126 set_breakpoint_count (breakpoint_count + 1);
2127 b->number = breakpoint_count;
2128 b->type = bp_watchpoint;
2129 b->disposition = donttouch;
2131 b->exp_valid_block = exp_valid_block;
2134 b->cond_string = NULL;
2135 b->exp_string = savestring (arg, strlen (arg));
2140 * Helper routine for the until_command routine in infcmd.c. Here
2141 * because it uses the mechanisms of breakpoints.
2145 until_break_command (arg, from_tty)
2149 struct symtabs_and_lines sals;
2150 struct symtab_and_line sal;
2151 FRAME prev_frame = get_prev_frame (selected_frame);
2152 struct breakpoint *breakpoint;
2153 struct cleanup *old_chain;
2155 clear_proceed_status ();
2157 /* Set a breakpoint where the user wants it and at return from
2160 if (default_breakpoint_valid)
2161 sals = decode_line_1 (&arg, 1, default_breakpoint_symtab,
2162 default_breakpoint_line, (char ***)NULL);
2164 sals = decode_line_1 (&arg, 1, (struct symtab *)NULL, 0, (char ***)NULL);
2166 if (sals.nelts != 1)
2167 error ("Couldn't get information on specified line.");
2170 free ((PTR)sals.sals); /* malloc'd, so freed */
2173 error ("Junk at end of arguments.");
2175 resolve_sal_pc (&sal);
2177 breakpoint = set_momentary_breakpoint (sal, selected_frame, bp_until);
2179 old_chain = make_cleanup(delete_breakpoint, breakpoint);
2181 /* Keep within the current frame */
2185 struct frame_info *fi;
2187 fi = get_frame_info (prev_frame);
2188 sal = find_pc_line (fi->pc, 0);
2190 breakpoint = set_momentary_breakpoint (sal, prev_frame, bp_until);
2191 make_cleanup(delete_breakpoint, breakpoint);
2194 proceed (-1, TARGET_SIGNAL_DEFAULT, 0);
2195 do_cleanups(old_chain);
2199 /* These aren't used; I don't konw what they were for. */
2200 /* Set a breakpoint at the catch clause for NAME. */
2202 catch_breakpoint (name)
2208 disable_catch_breakpoint ()
2213 delete_catch_breakpoint ()
2218 enable_catch_breakpoint ()
2225 struct sal_chain *next;
2226 struct symtab_and_line sal;
2230 /* This isn't used; I don't know what it was for. */
2231 /* For each catch clause identified in ARGS, run FUNCTION
2232 with that clause as an argument. */
2233 static struct symtabs_and_lines
2234 map_catch_names (args, function)
2238 register char *p = args;
2240 struct symtabs_and_lines sals;
2242 struct sal_chain *sal_chain = 0;
2246 error_no_arg ("one or more catch names");
2254 /* Don't swallow conditional part. */
2255 if (p1[0] == 'i' && p1[1] == 'f'
2256 && (p1[2] == ' ' || p1[2] == '\t'))
2262 while (isalnum (*p1) || *p1 == '_' || *p1 == '$')
2266 if (*p1 && *p1 != ' ' && *p1 != '\t')
2267 error ("Arguments must be catch names.");
2273 struct sal_chain *next
2274 = (struct sal_chain *)alloca (sizeof (struct sal_chain));
2275 next->next = sal_chain;
2276 next->sal = get_catch_sal (p);
2281 printf_unfiltered ("No catch clause for exception %s.\n", p);
2286 while (*p == ' ' || *p == '\t') p++;
2291 /* This shares a lot of code with `print_frame_label_vars' from stack.c. */
2293 static struct symtabs_and_lines
2294 get_catch_sals (this_level_only)
2295 int this_level_only;
2297 register struct blockvector *bl;
2298 register struct block *block;
2299 int index, have_default = 0;
2300 struct frame_info *fi;
2302 struct symtabs_and_lines sals;
2303 struct sal_chain *sal_chain = 0;
2304 char *blocks_searched;
2306 /* Not sure whether an error message is always the correct response,
2307 but it's better than a core dump. */
2308 if (selected_frame == NULL)
2309 error ("No selected frame.");
2310 block = get_frame_block (selected_frame);
2311 fi = get_frame_info (selected_frame);
2318 error ("No symbol table info available.\n");
2320 bl = blockvector_for_pc (BLOCK_END (block) - 4, &index);
2321 blocks_searched = (char *) alloca (BLOCKVECTOR_NBLOCKS (bl) * sizeof (char));
2322 memset (blocks_searched, 0, BLOCKVECTOR_NBLOCKS (bl) * sizeof (char));
2326 CORE_ADDR end = BLOCK_END (block) - 4;
2329 if (bl != blockvector_for_pc (end, &index))
2330 error ("blockvector blotch");
2331 if (BLOCKVECTOR_BLOCK (bl, index) != block)
2332 error ("blockvector botch");
2333 last_index = BLOCKVECTOR_NBLOCKS (bl);
2336 /* Don't print out blocks that have gone by. */
2337 while (index < last_index
2338 && BLOCK_END (BLOCKVECTOR_BLOCK (bl, index)) < pc)
2341 while (index < last_index
2342 && BLOCK_END (BLOCKVECTOR_BLOCK (bl, index)) < end)
2344 if (blocks_searched[index] == 0)
2346 struct block *b = BLOCKVECTOR_BLOCK (bl, index);
2349 register struct symbol *sym;
2351 nsyms = BLOCK_NSYMS (b);
2353 for (i = 0; i < nsyms; i++)
2355 sym = BLOCK_SYM (b, i);
2356 if (STREQ (SYMBOL_NAME (sym), "default"))
2362 if (SYMBOL_CLASS (sym) == LOC_LABEL)
2364 struct sal_chain *next = (struct sal_chain *)
2365 alloca (sizeof (struct sal_chain));
2366 next->next = sal_chain;
2367 next->sal = find_pc_line (SYMBOL_VALUE_ADDRESS (sym), 0);
2371 blocks_searched[index] = 1;
2377 if (sal_chain && this_level_only)
2380 /* After handling the function's top-level block, stop.
2381 Don't continue to its superblock, the block of
2382 per-file symbols. */
2383 if (BLOCK_FUNCTION (block))
2385 block = BLOCK_SUPERBLOCK (block);
2390 struct sal_chain *tmp_chain;
2392 /* Count the number of entries. */
2393 for (index = 0, tmp_chain = sal_chain; tmp_chain;
2394 tmp_chain = tmp_chain->next)
2398 sals.sals = (struct symtab_and_line *)
2399 xmalloc (index * sizeof (struct symtab_and_line));
2400 for (index = 0; sal_chain; sal_chain = sal_chain->next, index++)
2401 sals.sals[index] = sal_chain->sal;
2407 /* Commands to deal with catching exceptions. */
2410 catch_command_1 (arg, tempflag, from_tty)
2415 /* First, translate ARG into something we can deal with in terms
2418 struct symtabs_and_lines sals;
2419 struct symtab_and_line sal;
2420 register struct expression *cond = 0;
2421 register struct breakpoint *b;
2425 sal.line = sal.pc = sal.end = 0;
2428 /* If no arg given, or if first arg is 'if ', all active catch clauses
2429 are breakpointed. */
2431 if (!arg || (arg[0] == 'i' && arg[1] == 'f'
2432 && (arg[2] == ' ' || arg[2] == '\t')))
2434 /* Grab all active catch clauses. */
2435 sals = get_catch_sals (0);
2439 /* Grab selected catch clauses. */
2440 error ("catch NAME not implemented");
2442 /* This isn't used; I don't know what it was for. */
2443 sals = map_catch_names (arg, catch_breakpoint);
2451 for (i = 0; i < sals.nelts; i++)
2453 resolve_sal_pc (&sals.sals[i]);
2457 if (arg[0] == 'i' && arg[1] == 'f'
2458 && (arg[2] == ' ' || arg[2] == '\t'))
2459 cond = parse_exp_1 ((arg += 2, &arg),
2460 block_for_pc (sals.sals[i].pc), 0);
2462 error ("Junk at end of arguments.");
2467 for (i = 0; i < sals.nelts; i++)
2472 describe_other_breakpoints (sal.pc);
2474 b = set_raw_breakpoint (sal);
2475 set_breakpoint_count (breakpoint_count + 1);
2476 b->number = breakpoint_count;
2477 b->type = bp_breakpoint;
2479 b->enable = enabled;
2480 b->disposition = tempflag ? delete : donttouch;
2487 printf_unfiltered ("Multiple breakpoints were set.\n");
2488 printf_unfiltered ("Use the \"delete\" command to delete unwanted breakpoints.\n");
2490 free ((PTR)sals.sals);
2494 /* These aren't used; I don't know what they were for. */
2495 /* Disable breakpoints on all catch clauses described in ARGS. */
2497 disable_catch (args)
2500 /* Map the disable command to catch clauses described in ARGS. */
2503 /* Enable breakpoints on all catch clauses described in ARGS. */
2508 /* Map the disable command to catch clauses described in ARGS. */
2511 /* Delete breakpoints on all catch clauses in the active scope. */
2516 /* Map the delete command to catch clauses described in ARGS. */
2521 catch_command (arg, from_tty)
2525 catch_command_1 (arg, 0, from_tty);
2529 clear_command (arg, from_tty)
2533 register struct breakpoint *b, *b1;
2534 struct symtabs_and_lines sals;
2535 struct symtab_and_line sal;
2536 register struct breakpoint *found;
2541 sals = decode_line_spec (arg, 1);
2545 sals.sals = (struct symtab_and_line *) xmalloc (sizeof (struct symtab_and_line));
2546 sal.line = default_breakpoint_line;
2547 sal.symtab = default_breakpoint_symtab;
2549 if (sal.symtab == 0)
2550 error ("No source file specified.");
2556 for (i = 0; i < sals.nelts; i++)
2558 /* If exact pc given, clear bpts at that pc.
2559 But if sal.pc is zero, clear all bpts on specified line. */
2561 found = (struct breakpoint *) 0;
2562 while (breakpoint_chain
2564 ? breakpoint_chain->address == sal.pc
2565 : (breakpoint_chain->source_file != NULL
2566 && sal.symtab != NULL
2567 && STREQ (breakpoint_chain->source_file,
2568 sal.symtab->filename)
2569 && breakpoint_chain->line_number == sal.line)))
2571 b1 = breakpoint_chain;
2572 breakpoint_chain = b1->next;
2579 && b->next->type != bp_watchpoint
2581 ? b->next->address == sal.pc
2582 : (b->next->source_file != NULL
2583 && sal.symtab != NULL
2584 && STREQ (b->next->source_file, sal.symtab->filename)
2585 && b->next->line_number == sal.line)))
2596 error ("No breakpoint at %s.", arg);
2598 error ("No breakpoint at this line.");
2601 if (found->next) from_tty = 1; /* Always report if deleted more than one */
2602 if (from_tty) printf_unfiltered ("Deleted breakpoint%s ", found->next ? "s" : "");
2605 if (from_tty) printf_unfiltered ("%d ", found->number);
2607 delete_breakpoint (found);
2610 if (from_tty) putchar_unfiltered ('\n');
2612 free ((PTR)sals.sals);
2615 /* Delete breakpoint in BS if they are `delete' breakpoints.
2616 This is called after any breakpoint is hit, or after errors. */
2619 breakpoint_auto_delete (bs)
2622 for (; bs; bs = bs->next)
2623 if (bs->breakpoint_at && bs->breakpoint_at->disposition == delete
2625 delete_breakpoint (bs->breakpoint_at);
2628 /* Delete a breakpoint and clean up all traces of it in the data structures. */
2631 delete_breakpoint (bpt)
2632 struct breakpoint *bpt;
2634 register struct breakpoint *b;
2638 target_remove_breakpoint(bpt->address, bpt->shadow_contents);
2640 if (breakpoint_chain == bpt)
2641 breakpoint_chain = bpt->next;
2646 b->next = bpt->next;
2650 check_duplicates (bpt->address);
2651 /* If this breakpoint was inserted, and there is another breakpoint
2652 at the same address, we need to insert the other breakpoint. */
2656 if (b->address == bpt->address
2658 && b->enable != disabled)
2661 val = target_insert_breakpoint (b->address, b->shadow_contents);
2664 target_terminal_ours_for_output ();
2665 fprintf_unfiltered (gdb_stderr, "Cannot insert breakpoint %d:\n", b->number);
2666 memory_error (val, b->address); /* which bombs us out */
2673 free_command_lines (&bpt->commands);
2676 if (bpt->cond_string != NULL)
2677 free (bpt->cond_string);
2678 if (bpt->addr_string != NULL)
2679 free (bpt->addr_string);
2680 if (bpt->exp_string != NULL)
2681 free (bpt->exp_string);
2682 if (bpt->source_file != NULL)
2683 free (bpt->source_file);
2685 if (xgdb_verbose && bpt->type == bp_breakpoint)
2687 target_terminal_ours_for_output ();
2688 printf_unfiltered ("breakpoint #%d deleted\n", bpt->number);
2691 /* Be sure no bpstat's are pointing at it after it's been freed. */
2692 /* FIXME, how can we find all bpstat's?
2693 We just check stop_bpstat for now. */
2694 for (bs = stop_bpstat; bs; bs = bs->next)
2695 if (bs->breakpoint_at == bpt)
2696 bs->breakpoint_at = NULL;
2701 delete_command (arg, from_tty)
2708 /* Ask user only if there are some breakpoints to delete. */
2710 || (breakpoint_chain && query ("Delete all breakpoints? ", 0, 0)))
2712 /* No arg; clear all breakpoints. */
2713 while (breakpoint_chain)
2714 delete_breakpoint (breakpoint_chain);
2718 map_breakpoint_numbers (arg, delete_breakpoint);
2721 /* Reset a breakpoint given it's struct breakpoint * BINT.
2722 The value we return ends up being the return value from catch_errors.
2723 Unused in this case. */
2726 breakpoint_re_set_one (bint)
2729 struct breakpoint *b = (struct breakpoint *)bint; /* get past catch_errs */
2731 struct symtabs_and_lines sals;
2733 enum enable save_enable;
2738 if (b->addr_string == NULL)
2740 /* Anything without a string can't be re-set. */
2741 delete_breakpoint (b);
2744 /* In case we have a problem, disable this breakpoint. We'll restore
2745 its status if we succeed. */
2746 save_enable = b->enable;
2747 b->enable = disabled;
2750 sals = decode_line_1 (&s, 1, (struct symtab *)NULL, 0, (char ***)NULL);
2751 for (i = 0; i < sals.nelts; i++)
2753 resolve_sal_pc (&sals.sals[i]);
2755 /* Reparse conditions, they might contain references to the
2757 if (b->cond_string != NULL)
2761 free ((PTR)b->cond);
2762 b->cond = parse_exp_1 (&s, block_for_pc (sals.sals[i].pc), 0);
2765 /* We need to re-set the breakpoint if the address changes...*/
2766 if (b->address != sals.sals[i].pc
2767 /* ...or new and old breakpoints both have source files, and
2768 the source file name or the line number changes... */
2769 || (b->source_file != NULL
2770 && sals.sals[i].symtab != NULL
2771 && (!STREQ (b->source_file, sals.sals[i].symtab->filename)
2772 || b->line_number != sals.sals[i].line)
2774 /* ...or we switch between having a source file and not having
2776 || ((b->source_file == NULL) != (sals.sals[i].symtab == NULL))
2779 if (b->source_file != NULL)
2780 free (b->source_file);
2781 if (sals.sals[i].symtab == NULL)
2782 b->source_file = NULL;
2785 savestring (sals.sals[i].symtab->filename,
2786 strlen (sals.sals[i].symtab->filename));
2787 b->line_number = sals.sals[i].line;
2788 b->address = sals.sals[i].pc;
2790 check_duplicates (b->address);
2794 b->enable = save_enable; /* Restore it, this worked. */
2796 free ((PTR)sals.sals);
2800 innermost_block = NULL;
2801 /* The issue arises of what context to evaluate this in. The same
2802 one as when it was set, but what does that mean when symbols have
2803 been re-read? We could save the filename and functionname, but
2804 if the context is more local than that, the best we could do would
2805 be something like how many levels deep and which index at that
2806 particular level, but that's going to be less stable than filenames
2807 or functionnames. */
2808 /* So for now, just use a global context. */
2809 b->exp = parse_expression (b->exp_string);
2810 b->exp_valid_block = innermost_block;
2811 b->val = evaluate_expression (b->exp);
2812 release_value (b->val);
2813 if (VALUE_LAZY (b->val))
2814 value_fetch_lazy (b->val);
2816 if (b->cond_string != NULL)
2819 b->cond = parse_exp_1 (&s, (struct block *)0, 0);
2821 if (b->enable == enabled)
2826 printf_filtered ("Deleting unknown breakpoint type %d\n", b->type);
2831 case bp_longjmp_resume:
2833 delete_breakpoint (b);
2840 /* Re-set all breakpoints after symbols have been re-loaded. */
2842 breakpoint_re_set ()
2844 struct breakpoint *b, *temp;
2845 static char message1[] = "Error in re-setting breakpoint %d:\n";
2846 char message[sizeof (message1) + 30 /* slop */];
2848 ALL_BREAKPOINTS_SAFE (b, temp)
2850 sprintf (message, message1, b->number); /* Format possible error msg */
2851 catch_errors (breakpoint_re_set_one, (char *) b, message,
2855 create_longjmp_breakpoint("longjmp");
2856 create_longjmp_breakpoint("_longjmp");
2857 create_longjmp_breakpoint("siglongjmp");
2858 create_longjmp_breakpoint(NULL);
2861 /* Took this out (temporaliy at least), since it produces an extra
2862 blank line at startup. This messes up the gdbtests. -PB */
2863 /* Blank line to finish off all those mention() messages we just printed. */
2864 printf_filtered ("\n");
2868 /* Set ignore-count of breakpoint number BPTNUM to COUNT.
2869 If from_tty is nonzero, it prints a message to that effect,
2870 which ends with a period (no newline). */
2873 set_ignore_count (bptnum, count, from_tty)
2874 int bptnum, count, from_tty;
2876 register struct breakpoint *b;
2882 if (b->number == bptnum)
2884 b->ignore_count = count;
2887 else if (count == 0)
2888 printf_filtered ("Will stop next time breakpoint %d is reached.",
2890 else if (count == 1)
2891 printf_filtered ("Will ignore next crossing of breakpoint %d.",
2894 printf_filtered ("Will ignore next %d crossings of breakpoint %d.",
2899 error ("No breakpoint number %d.", bptnum);
2902 /* Clear the ignore counts of all breakpoints. */
2904 breakpoint_clear_ignore_counts ()
2906 struct breakpoint *b;
2909 b->ignore_count = 0;
2912 /* Command to set ignore-count of breakpoint N to COUNT. */
2915 ignore_command (args, from_tty)
2923 error_no_arg ("a breakpoint number");
2925 num = get_number (&p);
2928 error ("Second argument (specified ignore-count) is missing.");
2930 set_ignore_count (num,
2931 longest_to_int (value_as_long (parse_and_eval (p))),
2933 printf_filtered ("\n");
2936 /* Call FUNCTION on each of the breakpoints
2937 whose numbers are given in ARGS. */
2940 map_breakpoint_numbers (args, function)
2942 void (*function) PARAMS ((struct breakpoint *));
2944 register char *p = args;
2947 register struct breakpoint *b;
2950 error_no_arg ("one or more breakpoint numbers");
2956 num = get_number (&p1);
2959 if (b->number == num)
2964 printf_unfiltered ("No breakpoint number %d.\n", num);
2971 enable_breakpoint (bpt)
2972 struct breakpoint *bpt;
2974 FRAME save_selected_frame = NULL;
2975 int save_selected_frame_level = -1;
2977 bpt->enable = enabled;
2979 if (xgdb_verbose && bpt->type == bp_breakpoint)
2980 printf_unfiltered ("breakpoint #%d enabled\n", bpt->number);
2982 check_duplicates (bpt->address);
2983 if (bpt->type == bp_watchpoint)
2985 if (bpt->exp_valid_block != NULL)
2987 FRAME fr = within_scope (bpt->exp_valid_block);
2991 Cannot enable watchpoint %d because the block in which its expression\n\
2992 is valid is not currently in scope.\n", bpt->number);
2993 bpt->enable = disabled;
2996 save_selected_frame = selected_frame;
2997 save_selected_frame_level = selected_frame_level;
2998 select_frame (fr, -1);
3001 value_free (bpt->val);
3003 bpt->val = evaluate_expression (bpt->exp);
3004 release_value (bpt->val);
3005 if (VALUE_LAZY (bpt->val))
3006 value_fetch_lazy (bpt->val);
3008 if (save_selected_frame_level >= 0)
3009 select_frame (save_selected_frame, save_selected_frame_level);
3015 enable_command (args, from_tty)
3019 struct breakpoint *bpt;
3021 ALL_BREAKPOINTS (bpt)
3026 enable_breakpoint (bpt);
3031 map_breakpoint_numbers (args, enable_breakpoint);
3035 disable_breakpoint (bpt)
3036 struct breakpoint *bpt;
3038 bpt->enable = disabled;
3040 if (xgdb_verbose && bpt->type == bp_breakpoint)
3041 printf_filtered ("breakpoint #%d disabled\n", bpt->number);
3043 check_duplicates (bpt->address);
3048 disable_command (args, from_tty)
3052 register struct breakpoint *bpt;
3054 ALL_BREAKPOINTS (bpt)
3059 disable_breakpoint (bpt);
3064 map_breakpoint_numbers (args, disable_breakpoint);
3068 enable_once_breakpoint (bpt)
3069 struct breakpoint *bpt;
3071 bpt->enable = enabled;
3072 bpt->disposition = disable;
3074 check_duplicates (bpt->address);
3079 enable_once_command (args, from_tty)
3083 map_breakpoint_numbers (args, enable_once_breakpoint);
3087 enable_delete_breakpoint (bpt)
3088 struct breakpoint *bpt;
3090 bpt->enable = enabled;
3091 bpt->disposition = delete;
3093 check_duplicates (bpt->address);
3098 enable_delete_command (args, from_tty)
3102 map_breakpoint_numbers (args, enable_delete_breakpoint);
3106 * Use default_breakpoint_'s, or nothing if they aren't valid.
3108 struct symtabs_and_lines
3109 decode_line_spec_1 (string, funfirstline)
3113 struct symtabs_and_lines sals;
3115 error ("Empty line specification.");
3116 if (default_breakpoint_valid)
3117 sals = decode_line_1 (&string, funfirstline,
3118 default_breakpoint_symtab, default_breakpoint_line,
3121 sals = decode_line_1 (&string, funfirstline,
3122 (struct symtab *)NULL, 0, (char ***)NULL);
3124 error ("Junk at end of line specification: %s", string);
3129 _initialize_breakpoint ()
3131 breakpoint_chain = 0;
3132 /* Don't bother to call set_breakpoint_count. $bpnum isn't useful
3133 before a breakpoint is set. */
3134 breakpoint_count = 0;
3136 add_com ("ignore", class_breakpoint, ignore_command,
3137 "Set ignore-count of breakpoint number N to COUNT.");
3139 add_com ("commands", class_breakpoint, commands_command,
3140 "Set commands to be executed when a breakpoint is hit.\n\
3141 Give breakpoint number as argument after \"commands\".\n\
3142 With no argument, the targeted breakpoint is the last one set.\n\
3143 The commands themselves follow starting on the next line.\n\
3144 Type a line containing \"end\" to indicate the end of them.\n\
3145 Give \"silent\" as the first line to make the breakpoint silent;\n\
3146 then no output is printed when it is hit, except what the commands print.");
3148 add_com ("condition", class_breakpoint, condition_command,
3149 "Specify breakpoint number N to break only if COND is true.\n\
3150 N is an integer; COND is an expression to be evaluated whenever\n\
3151 breakpoint N is reached. ");
3153 add_com ("tbreak", class_breakpoint, tbreak_command,
3154 "Set a temporary breakpoint. Args like \"break\" command.\n\
3155 Like \"break\" except the breakpoint is only temporary,\n\
3156 so it will be deleted when hit. Equivalent to \"break\" followed\n\
3157 by using \"enable delete\" on the breakpoint number.");
3159 add_prefix_cmd ("enable", class_breakpoint, enable_command,
3160 "Enable some breakpoints.\n\
3161 Give breakpoint numbers (separated by spaces) as arguments.\n\
3162 With no subcommand, breakpoints are enabled until you command otherwise.\n\
3163 This is used to cancel the effect of the \"disable\" command.\n\
3164 With a subcommand you can enable temporarily.",
3165 &enablelist, "enable ", 1, &cmdlist);
3167 add_abbrev_prefix_cmd ("breakpoints", class_breakpoint, enable_command,
3168 "Enable some breakpoints.\n\
3169 Give breakpoint numbers (separated by spaces) as arguments.\n\
3170 This is used to cancel the effect of the \"disable\" command.\n\
3171 May be abbreviated to simply \"enable\".\n",
3172 &enablebreaklist, "enable breakpoints ", 1, &enablelist);
3174 add_cmd ("once", no_class, enable_once_command,
3175 "Enable breakpoints for one hit. Give breakpoint numbers.\n\
3176 If a breakpoint is hit while enabled in this fashion, it becomes disabled.",
3179 add_cmd ("delete", no_class, enable_delete_command,
3180 "Enable breakpoints and delete when hit. Give breakpoint numbers.\n\
3181 If a breakpoint is hit while enabled in this fashion, it is deleted.",
3184 add_cmd ("delete", no_class, enable_delete_command,
3185 "Enable breakpoints and delete when hit. Give breakpoint numbers.\n\
3186 If a breakpoint is hit while enabled in this fashion, it is deleted.",
3189 add_cmd ("once", no_class, enable_once_command,
3190 "Enable breakpoints for one hit. Give breakpoint numbers.\n\
3191 If a breakpoint is hit while enabled in this fashion, it becomes disabled.",
3194 add_prefix_cmd ("disable", class_breakpoint, disable_command,
3195 "Disable some breakpoints.\n\
3196 Arguments are breakpoint numbers with spaces in between.\n\
3197 To disable all breakpoints, give no argument.\n\
3198 A disabled breakpoint is not forgotten, but has no effect until reenabled.",
3199 &disablelist, "disable ", 1, &cmdlist);
3200 add_com_alias ("dis", "disable", class_breakpoint, 1);
3201 add_com_alias ("disa", "disable", class_breakpoint, 1);
3203 add_cmd ("breakpoints", class_alias, disable_command,
3204 "Disable some breakpoints.\n\
3205 Arguments are breakpoint numbers with spaces in between.\n\
3206 To disable all breakpoints, give no argument.\n\
3207 A disabled breakpoint is not forgotten, but has no effect until reenabled.\n\
3208 This command may be abbreviated \"disable\".",
3211 add_prefix_cmd ("delete", class_breakpoint, delete_command,
3212 "Delete some breakpoints or auto-display expressions.\n\
3213 Arguments are breakpoint numbers with spaces in between.\n\
3214 To delete all breakpoints, give no argument.\n\
3216 Also a prefix command for deletion of other GDB objects.\n\
3217 The \"unset\" command is also an alias for \"delete\".",
3218 &deletelist, "delete ", 1, &cmdlist);
3219 add_com_alias ("d", "delete", class_breakpoint, 1);
3221 add_cmd ("breakpoints", class_alias, delete_command,
3222 "Delete some breakpoints or auto-display expressions.\n\
3223 Arguments are breakpoint numbers with spaces in between.\n\
3224 To delete all breakpoints, give no argument.\n\
3225 This command may be abbreviated \"delete\".",
3228 add_com ("clear", class_breakpoint, clear_command,
3229 "Clear breakpoint at specified line or function.\n\
3230 Argument may be line number, function name, or \"*\" and an address.\n\
3231 If line number is specified, all breakpoints in that line are cleared.\n\
3232 If function is specified, breakpoints at beginning of function are cleared.\n\
3233 If an address is specified, breakpoints at that address are cleared.\n\n\
3234 With no argument, clears all breakpoints in the line that the selected frame\n\
3237 See also the \"delete\" command which clears breakpoints by number.");
3239 add_com ("break", class_breakpoint, break_command,
3240 "Set breakpoint at specified line or function.\n\
3241 Argument may be line number, function name, or \"*\" and an address.\n\
3242 If line number is specified, break at start of code for that line.\n\
3243 If function is specified, break at start of code for that function.\n\
3244 If an address is specified, break at that exact address.\n\
3245 With no arg, uses current execution address of selected stack frame.\n\
3246 This is useful for breaking on return to a stack frame.\n\
3248 Multiple breakpoints at one place are permitted, and useful if conditional.\n\
3250 Do \"help breakpoints\" for info on other commands dealing with breakpoints.");
3251 add_com_alias ("b", "break", class_run, 1);
3252 add_com_alias ("br", "break", class_run, 1);
3253 add_com_alias ("bre", "break", class_run, 1);
3254 add_com_alias ("brea", "break", class_run, 1);
3256 add_info ("breakpoints", breakpoints_info,
3257 "Status of user-settable breakpoints, or breakpoint number NUMBER.\n\
3258 The \"Type\" column indicates one of:\n\
3259 \tbreakpoint - normal breakpoint\n\
3260 \twatchpoint - watchpoint\n\
3261 The \"Disp\" column contains one of \"keep\", \"del\", or \"dis\" to indicate\n\
3262 the disposition of the breakpoint after it gets hit. \"dis\" means that the\n\
3263 breakpoint will be disabled. The \"Address\" and \"What\" columns indicate the\n\
3264 address and file/line number respectively.\n\n\
3265 Convenience variable \"$_\" and default examine address for \"x\"\n\
3266 are set to the address of the last breakpoint listed.\n\n\
3267 Convenience variable \"$bpnum\" contains the number of the last\n\
3270 #if MAINTENANCE_CMDS
3272 add_cmd ("breakpoints", class_maintenance, maintenance_info_breakpoints,
3273 "Status of all breakpoints, or breakpoint number NUMBER.\n\
3274 The \"Type\" column indicates one of:\n\
3275 \tbreakpoint - normal breakpoint\n\
3276 \twatchpoint - watchpoint\n\
3277 \tlongjmp - internal breakpoint used to step through longjmp()\n\
3278 \tlongjmp resume - internal breakpoint at the target of longjmp()\n\
3279 \tuntil - internal breakpoint used by the \"until\" command\n\
3280 \tfinish - internal breakpoint used by the \"finish\" command\n\
3281 The \"Disp\" column contains one of \"keep\", \"del\", or \"dis\" to indicate\n\
3282 the disposition of the breakpoint after it gets hit. \"dis\" means that the\n\
3283 breakpoint will be disabled. The \"Address\" and \"What\" columns indicate the\n\
3284 address and file/line number respectively.\n\n\
3285 Convenience variable \"$_\" and default examine address for \"x\"\n\
3286 are set to the address of the last breakpoint listed.\n\n\
3287 Convenience variable \"$bpnum\" contains the number of the last\n\
3289 &maintenanceinfolist);
3291 #endif /* MAINTENANCE_CMDS */
3293 add_com ("catch", class_breakpoint, catch_command,
3294 "Set breakpoints to catch exceptions that are raised.\n\
3295 Argument may be a single exception to catch, multiple exceptions\n\
3296 to catch, or the default exception \"default\". If no arguments\n\
3297 are given, breakpoints are set at all exception handlers catch clauses\n\
3298 within the current scope.\n\
3300 A condition specified for the catch applies to all breakpoints set\n\
3301 with this command\n\
3303 Do \"help breakpoints\" for info on other commands dealing with breakpoints.");
3305 add_com ("watch", class_breakpoint, watch_command,
3306 "Set a watchpoint for an expression.\n\
3307 A watchpoint stops execution of your program whenever the value of\n\
3308 an expression changes.");
3310 add_info ("watchpoints", breakpoints_info,
3311 "Synonym for ``info breakpoints''.");
3314 /* OK, when we call objfile_relocate, we need to relocate breakpoints
3315 too. breakpoint_re_set is not a good choice--for example, if
3316 addr_string contains just a line number without a file name the
3317 breakpoint might get set in a different file. In general, there is
3318 no need to go all the way back to the user's string (though this might
3319 work if some effort were made to canonicalize it), since symtabs and
3320 everything except addresses are still valid.
3322 Probably the best way to solve this is to have each breakpoint save
3323 the objfile and the section number that was used to set it (if set
3324 by "*addr", probably it is best to use find_pc_line to get a symtab
3325 and use the objfile and block_line_section for that symtab). Then
3326 objfile_relocate can call fixup_breakpoints with the objfile and
3327 the new_offsets, and it can relocate only the appropriate breakpoints. */
3329 #ifdef IBM6000_TARGET
3330 /* But for now, just kludge it based on the concept that before an
3331 objfile is relocated the breakpoint is below 0x10000000, and afterwards
3332 it is higher, so that way we only relocate each breakpoint once. */
3335 fixup_breakpoints (low, high, delta)
3340 struct breakpoint *b;
3344 if (b->address >= low && b->address <= high)
3345 b->address += delta;