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);
799 /* We can't deal with it. Maybe another member of the bpstat chain can. */
803 /* Print a message indicating what happened. Returns nonzero to
804 say that only the source line should be printed after this (zero
805 return means print the frame as well as the source line). */
806 /* Currently we always return zero. */
816 val = (*bs->print_it) (bs);
820 /* Maybe another breakpoint in the chain caused us to stop.
821 (Currently all watchpoints go on the bpstat whether hit or
822 not. That probably could (should) be changed, provided care is taken
823 with respect to bpstat_explains_signal). */
825 return bpstat_print (bs->next);
827 /* We reached the end of the chain without printing anything. */
831 /* Evaluate the expression EXP and return 1 if value is zero.
832 This is used inside a catch_errors to evaluate the breakpoint condition.
833 The argument is a "struct expression *" that has been cast to char * to
834 make it pass through catch_errors. */
837 breakpoint_cond_eval (exp)
840 return !value_true (evaluate_expression ((struct expression *)exp));
843 /* Allocate a new bpstat and chain it to the current one. */
846 bpstat_alloc (b, cbs)
847 register struct breakpoint *b;
848 bpstat cbs; /* Current "bs" value */
852 bs = (bpstat) xmalloc (sizeof (*bs));
854 bs->breakpoint_at = b;
855 /* If the condition is false, etc., don't do the commands. */
858 bs->print_it = print_it_normal;
862 /* Return the frame which we can use to evaluate the expression
863 whose valid block is valid_block, or NULL if not in scope.
865 This whole concept is probably not the way to do things (it is incredibly
866 slow being the main reason, not to mention fragile (e.g. the sparc
867 frame pointer being fetched as 0 bug causes it to stop)). Instead,
868 introduce a version of "struct frame" which survives over calls to the
869 inferior, but which is better than FRAME_ADDR in the sense that it lets
870 us evaluate expressions relative to that frame (on some machines, it
871 can just be a FRAME_ADDR). Save one of those instead of (or in addition
872 to) the exp_valid_block, and then use it to evaluate the watchpoint
873 expression, with no need to do all this backtracing every time.
875 Or better yet, what if it just copied the struct frame and its next
876 frame? Off the top of my head, I would think that would work
877 because things like (a29k) rsize and msize, or (sparc) bottom just
878 depend on the frame, and aren't going to be different just because
879 the inferior has done something. Trying to recalculate them
880 strikes me as a lot of work, possibly even impossible. Saving the
881 next frame is needed at least on a29k, where get_saved_register
882 uses fi->next->saved_msp. For figuring out whether that frame is
883 still on the stack, I guess this needs to be machine-specific (e.g.
886 read_fp () INNER_THAN watchpoint_frame->frame
888 would generally work.
890 Of course the scope of the expression could be less than a whole
891 function; perhaps if the innermost frame is the one which the
892 watchpoint is relative to (another machine-specific thing, usually
894 FRAMELESS_FUNCTION_INVOCATION (get_current_frame(), fromleaf)
895 read_fp () == wp_frame->frame
898 ), *then* it could do a
900 contained_in (get_current_block (), wp->exp_valid_block).
905 within_scope (valid_block)
906 struct block *valid_block;
908 FRAME fr = get_current_frame ();
909 struct frame_info *fi = get_frame_info (fr);
910 CORE_ADDR func_start;
912 /* If caller_pc_valid is true, we are stepping through
913 a function prologue, which is bounded by callee_func_start
914 (inclusive) and callee_prologue_end (exclusive).
915 caller_pc is the pc of the caller.
917 Yes, this is hairy. */
918 static int caller_pc_valid = 0;
919 static CORE_ADDR caller_pc;
920 static CORE_ADDR callee_func_start;
921 static CORE_ADDR callee_prologue_end;
923 find_pc_partial_function (fi->pc, (PTR)NULL, &func_start, (CORE_ADDR *)NULL);
924 func_start += FUNCTION_START_OFFSET;
925 if (fi->pc == func_start)
927 /* We just called a function. The only other case I
928 can think of where the pc would equal the pc of the
929 start of a function is a frameless function (i.e.
930 no prologue) where we branch back to the start
931 of the function. In that case, SKIP_PROLOGUE won't
932 find one, and we'll clear caller_pc_valid a few lines
935 caller_pc = SAVED_PC_AFTER_CALL (fr);
936 callee_func_start = func_start;
937 SKIP_PROLOGUE (func_start);
938 callee_prologue_end = func_start;
942 if (fi->pc < callee_func_start
943 || fi->pc >= callee_prologue_end)
947 if (contained_in (block_for_pc (caller_pc_valid
954 fr = get_prev_frame (fr);
956 /* If any active frame is in the exp_valid_block, then it's
957 OK. Note that this might not be the same invocation of
958 the exp_valid_block that we were watching a little while
959 ago, or the same one as when the watchpoint was set (e.g.
960 we are watching a local variable in a recursive function.
961 When we return from a recursive invocation, then we are
962 suddenly watching a different instance of the variable).
964 At least for now I am going to consider this a feature. */
965 for (; fr != NULL; fr = get_prev_frame (fr))
967 fi = get_frame_info (fr);
968 if (contained_in (block_for_pc (fi->pc),
977 /* Possible return values for watchpoint_check (this can't be an enum
978 because of check_errors). */
979 /* The watchpoint has been disabled. */
980 #define WP_DISABLED 1
981 /* The value has changed. */
982 #define WP_VALUE_CHANGED 2
983 /* The value has not changed. */
984 #define WP_VALUE_NOT_CHANGED 3
986 /* Check watchpoint condition. */
991 bpstat bs = (bpstat) p;
994 int within_current_scope;
995 if (bs->breakpoint_at->exp_valid_block == NULL)
996 within_current_scope = 1;
999 fr = within_scope (bs->breakpoint_at->exp_valid_block);
1000 within_current_scope = fr != NULL;
1001 if (within_current_scope)
1002 /* If we end up stopping, the current frame will get selected
1003 in normal_stop. So this call to select_frame won't affect
1005 select_frame (fr, -1);
1008 if (within_current_scope)
1010 /* We use value_{,free_to_}mark because it could be a
1011 *long* time before we return to the command level and
1012 call free_all_values. We can't call free_all_values because
1013 we might be in the middle of evaluating a function call. */
1015 value mark = value_mark ();
1016 value new_val = evaluate_expression (bs->breakpoint_at->exp);
1017 if (!value_equal (bs->breakpoint_at->val, new_val))
1019 release_value (new_val);
1020 value_free_to_mark (mark);
1021 bs->old_val = bs->breakpoint_at->val;
1022 bs->breakpoint_at->val = new_val;
1023 /* We will stop here */
1024 return WP_VALUE_CHANGED;
1028 /* Nothing changed, don't do anything. */
1029 value_free_to_mark (mark);
1030 /* We won't stop here */
1031 return WP_VALUE_NOT_CHANGED;
1036 /* This seems like the only logical thing to do because
1037 if we temporarily ignored the watchpoint, then when
1038 we reenter the block in which it is valid it contains
1039 garbage (in the case of a function, it may have two
1040 garbage values, one before and one after the prologue).
1041 So we can't even detect the first assignment to it and
1042 watch after that (since the garbage may or may not equal
1043 the first value assigned). */
1044 bs->breakpoint_at->enable = disabled;
1046 Watchpoint %d disabled because the program has left the block in\n\
1047 which its expression is valid.\n", bs->breakpoint_at->number);
1052 /* This is used when everything which needs to be printed has
1053 already been printed. But we still want to print the frame. */
1061 /* This is used when nothing should be printed for this bpstat entry. */
1070 /* Get a bpstat associated with having just stopped at address *PC
1071 and frame address FRAME_ADDRESS. Update *PC to point at the
1072 breakpoint (if we hit a breakpoint). NOT_A_BREAKPOINT is nonzero
1073 if this is known to not be a real breakpoint (it could still be a
1074 watchpoint, though). */
1076 /* Determine whether we stopped at a breakpoint, etc, or whether we
1077 don't understand this stop. Result is a chain of bpstat's such that:
1079 if we don't understand the stop, the result is a null pointer.
1081 if we understand why we stopped, the result is not null.
1083 Each element of the chain refers to a particular breakpoint or
1084 watchpoint at which we have stopped. (We may have stopped for
1085 several reasons concurrently.)
1087 Each element of the chain has valid next, breakpoint_at,
1088 commands, FIXME??? fields.
1093 bpstat_stop_status (pc, frame_address, not_a_breakpoint)
1095 FRAME_ADDR frame_address;
1096 int not_a_breakpoint;
1098 register struct breakpoint *b;
1100 #if DECR_PC_AFTER_BREAK != 0 || defined (SHIFT_INST_REGS)
1101 /* True if we've hit a breakpoint (as opposed to a watchpoint). */
1102 int real_breakpoint = 0;
1104 /* Root of the chain of bpstat's */
1105 struct bpstat root_bs[1];
1106 /* Pointer to the last thing in the chain currently. */
1107 bpstat bs = root_bs;
1109 /* Get the address where the breakpoint would have been. */
1110 bp_addr = *pc - DECR_PC_AFTER_BREAK;
1114 if (b->enable == disabled)
1117 if (b->type != bp_watchpoint && b->address != bp_addr)
1120 if (b->type != bp_watchpoint && not_a_breakpoint)
1123 /* Come here if it's a watchpoint, or if the break address matches */
1125 bs = bpstat_alloc (b, bs); /* Alloc a bpstat to explain stop */
1130 if (b->type == bp_watchpoint)
1132 static char message1[] =
1133 "Error evaluating expression for watchpoint %d\n";
1134 char message[sizeof (message1) + 30 /* slop */];
1135 sprintf (message, message1, b->number);
1136 switch (catch_errors (watchpoint_check, (char *) bs, message,
1140 /* We've already printed what needs to be printed. */
1141 bs->print_it = print_it_done;
1144 case WP_VALUE_CHANGED:
1147 case WP_VALUE_NOT_CHANGED:
1149 bs->print_it = print_it_noop;
1156 /* Error from catch_errors. */
1157 b->enable = disabled;
1158 printf_filtered ("Watchpoint %d disabled.\n", b->number);
1159 /* We've already printed what needs to be printed. */
1160 bs->print_it = print_it_done;
1165 #if DECR_PC_AFTER_BREAK != 0 || defined (SHIFT_INST_REGS)
1167 real_breakpoint = 1;
1170 if (b->frame && b->frame != frame_address)
1174 int value_is_zero = 0;
1178 /* Need to select the frame, with all that implies
1179 so that the conditions will have the right context. */
1180 select_frame (get_current_frame (), 0);
1182 = catch_errors (breakpoint_cond_eval, (char *)(b->cond),
1183 "Error in testing breakpoint condition:\n",
1185 /* FIXME-someday, should give breakpoint # */
1188 if (b->cond && value_is_zero)
1192 else if (b->ignore_count > 0)
1199 /* We will stop here */
1200 if (b->disposition == disable)
1201 b->enable = disabled;
1202 bs->commands = b->commands;
1205 if (bs->commands && STREQ ("silent", bs->commands->line))
1207 bs->commands = bs->commands->next;
1212 /* Print nothing for this entry if we dont stop or if we dont print. */
1213 if (bs->stop == 0 || bs->print == 0)
1214 bs->print_it = print_it_noop;
1217 bs->next = NULL; /* Terminate the chain */
1218 bs = root_bs->next; /* Re-grab the head of the chain */
1219 #if DECR_PC_AFTER_BREAK != 0 || defined (SHIFT_INST_REGS)
1222 if (real_breakpoint)
1225 #if defined (SHIFT_INST_REGS)
1227 #else /* No SHIFT_INST_REGS. */
1229 #endif /* No SHIFT_INST_REGS. */
1232 #endif /* DECR_PC_AFTER_BREAK != 0. */
1236 /* Tell what to do about this bpstat. */
1241 /* Classify each bpstat as one of the following. */
1243 /* This bpstat element has no effect on the main_action. */
1246 /* There was a watchpoint, stop but don't print. */
1249 /* There was a watchpoint, stop and print. */
1252 /* There was a breakpoint but we're not stopping. */
1255 /* There was a breakpoint, stop but don't print. */
1258 /* There was a breakpoint, stop and print. */
1261 /* We hit the longjmp breakpoint. */
1264 /* We hit the longjmp_resume breakpoint. */
1267 /* We hit the step_resume breakpoint. */
1270 /* This is just used to count how many enums there are. */
1274 /* Here is the table which drives this routine. So that we can
1275 format it pretty, we define some abbreviations for the
1276 enum bpstat_what codes. */
1277 #define keep_c BPSTAT_WHAT_KEEP_CHECKING
1278 #define stop_s BPSTAT_WHAT_STOP_SILENT
1279 #define stop_n BPSTAT_WHAT_STOP_NOISY
1280 #define single BPSTAT_WHAT_SINGLE
1281 #define setlr BPSTAT_WHAT_SET_LONGJMP_RESUME
1282 #define clrlr BPSTAT_WHAT_CLEAR_LONGJMP_RESUME
1283 #define clrlrs BPSTAT_WHAT_CLEAR_LONGJMP_RESUME_SINGLE
1284 #define sr BPSTAT_WHAT_STEP_RESUME
1286 /* "Can't happen." Might want to print an error message.
1287 abort() is not out of the question, but chances are GDB is just
1288 a bit confused, not unusable. */
1289 #define err BPSTAT_WHAT_STOP_NOISY
1291 /* Given an old action and a class, come up with a new action. */
1292 /* One interesting property of this table is that wp_silent is the same
1293 as bp_silent and wp_noisy is the same as bp_noisy. That is because
1294 after stopping, the check for whether to step over a breakpoint
1295 (BPSTAT_WHAT_SINGLE type stuff) is handled in proceed() without
1296 reference to how we stopped. We retain separate wp_silent and bp_silent
1297 codes in case we want to change that someday. */
1299 /* step_resume entries: a step resume breakpoint overrides another
1300 breakpoint of signal handling (see comment in wait_for_inferior
1301 at first IN_SIGTRAMP where we set the step_resume breakpoint). */
1303 static const enum bpstat_what_main_action
1304 table[(int)class_last][(int)BPSTAT_WHAT_LAST] =
1307 /* keep_c stop_s stop_n single setlr clrlr clrlrs sr */
1309 /*no_effect*/ {keep_c, stop_s, stop_n, single, setlr , clrlr , clrlrs, sr},
1310 /*wp_silent*/ {stop_s, stop_s, stop_n, stop_s, stop_s, stop_s, stop_s, sr},
1311 /*wp_noisy*/ {stop_n, stop_n, stop_n, stop_n, stop_n, stop_n, stop_n, sr},
1312 /*bp_nostop*/ {single, stop_s, stop_n, single, setlr , clrlrs, clrlrs, sr},
1313 /*bp_silent*/ {stop_s, stop_s, stop_n, stop_s, stop_s, stop_s, stop_s, sr},
1314 /*bp_noisy*/ {stop_n, stop_n, stop_n, stop_n, stop_n, stop_n, stop_n, sr},
1315 /*long_jump*/ {setlr , stop_s, stop_n, setlr , err , err , err , sr},
1316 /*long_resume*/ {clrlr , stop_s, stop_n, clrlrs, err , err , err , sr},
1317 /*step_resume*/ {sr , sr , sr , sr , sr , sr , sr , sr}
1327 enum bpstat_what_main_action current_action = BPSTAT_WHAT_KEEP_CHECKING;
1328 struct bpstat_what retval;
1330 retval.call_dummy = 0;
1331 for (; bs != NULL; bs = bs->next)
1333 enum class bs_class = no_effect;
1334 if (bs->breakpoint_at == NULL)
1335 /* I suspect this can happen if it was a momentary breakpoint
1336 which has since been deleted. */
1338 switch (bs->breakpoint_at->type)
1346 bs_class = bp_noisy;
1348 bs_class = bp_silent;
1351 bs_class = bp_nostop;
1357 bs_class = wp_noisy;
1359 bs_class = wp_silent;
1362 /* There was a watchpoint, but we're not stopping. This requires
1363 no further action. */
1364 bs_class = no_effect;
1367 bs_class = long_jump;
1369 case bp_longjmp_resume:
1370 bs_class = long_resume;
1372 case bp_step_resume:
1374 /* Need to temporarily disable this until we can fix the bug
1375 with nexting over a breakpoint with ->stop clear causing
1376 an infinite loop. For now, treat the breakpoint as having
1377 been hit even if the frame is wrong. */
1381 bs_class = step_resume;
1385 /* It is for the wrong frame. */
1386 bs_class = bp_nostop;
1390 /* Make sure the action is stop (silent or noisy), so infrun.c
1391 pops the dummy frame. */
1392 bs_class = bp_silent;
1393 retval.call_dummy = 1;
1396 current_action = table[(int)bs_class][(int)current_action];
1398 retval.main_action = current_action;
1402 /* Nonzero if we should step constantly (e.g. watchpoints on machines
1403 without hardware support). This isn't related to a specific bpstat,
1404 just to things like whether watchpoints are set. */
1407 bpstat_should_step ()
1409 struct breakpoint *b;
1411 if (b->enable == enabled && b->type == bp_watchpoint)
1416 /* Print information on breakpoint number BNUM, or -1 if all.
1417 If WATCHPOINTS is zero, process only breakpoints; if WATCHPOINTS
1418 is nonzero, process only watchpoints. */
1421 breakpoint_1 (bnum, allflag)
1425 register struct breakpoint *b;
1426 register struct command_line *l;
1427 register struct symbol *sym;
1428 CORE_ADDR last_addr = (CORE_ADDR)-1;
1429 int found_a_breakpoint = 0;
1430 static char *bptypes[] = {"breakpoint", "until", "finish", "watchpoint",
1431 "longjmp", "longjmp resume", "step resume",
1433 static char *bpdisps[] = {"del", "dis", "keep"};
1434 static char bpenables[] = "ny";
1435 char wrap_indent[80];
1439 || bnum == b->number)
1441 /* We only print out user settable breakpoints unless the allflag is set. */
1443 && b->type != bp_breakpoint
1444 && b->type != bp_watchpoint)
1447 if (!found_a_breakpoint++)
1448 printf_filtered ("Num Type Disp Enb %sWhat\n",
1449 addressprint ? "Address " : "");
1451 printf_filtered ("%-3d %-14s %-4s %-3c ",
1453 bptypes[(int)b->type],
1454 bpdisps[(int)b->disposition],
1455 bpenables[(int)b->enable]);
1456 strcpy (wrap_indent, " ");
1458 strcat (wrap_indent, " ");
1462 print_expression (b->exp, gdb_stdout);
1469 case bp_longjmp_resume:
1470 case bp_step_resume:
1473 printf_filtered ("%s ", local_hex_string_custom ((unsigned long) b->address, "08l"));
1475 last_addr = b->address;
1478 sym = find_pc_function (b->address);
1481 fputs_filtered ("in ", gdb_stdout);
1482 fputs_filtered (SYMBOL_SOURCE_NAME (sym), gdb_stdout);
1483 wrap_here (wrap_indent);
1484 fputs_filtered (" at ", gdb_stdout);
1486 fputs_filtered (b->source_file, gdb_stdout);
1487 printf_filtered (":%d", b->line_number);
1490 print_address_symbolic (b->address, gdb_stdout, demangle, " ");
1494 printf_filtered ("\n");
1498 printf_filtered ("\tstop only in stack frame at ");
1499 print_address_numeric (b->frame, gdb_stdout);
1500 printf_filtered ("\n");
1503 printf_filtered ("\tstop only if ");
1504 print_expression (b->cond, gdb_stdout);
1505 printf_filtered ("\n");
1507 if (b->ignore_count)
1508 printf_filtered ("\tignore next %d hits\n", b->ignore_count);
1509 if ((l = b->commands))
1512 fputs_filtered ("\t", gdb_stdout);
1513 fputs_filtered (l->line, gdb_stdout);
1514 fputs_filtered ("\n", gdb_stdout);
1519 if (!found_a_breakpoint)
1522 printf_filtered ("No breakpoints or watchpoints.\n");
1524 printf_filtered ("No breakpoint or watchpoint number %d.\n", bnum);
1527 /* Compare against (CORE_ADDR)-1 in case some compiler decides
1528 that a comparison of an unsigned with -1 is always false. */
1529 if (last_addr != (CORE_ADDR)-1)
1530 set_next_address (last_addr);
1535 breakpoints_info (bnum_exp, from_tty)
1542 bnum = parse_and_eval_address (bnum_exp);
1544 breakpoint_1 (bnum, 0);
1547 #if MAINTENANCE_CMDS
1551 maintenance_info_breakpoints (bnum_exp, from_tty)
1558 bnum = parse_and_eval_address (bnum_exp);
1560 breakpoint_1 (bnum, 1);
1565 /* Print a message describing any breakpoints set at PC. */
1568 describe_other_breakpoints (pc)
1569 register CORE_ADDR pc;
1571 register int others = 0;
1572 register struct breakpoint *b;
1575 if (b->address == pc)
1579 printf_filtered ("Note: breakpoint%s ", (others > 1) ? "s" : "");
1581 if (b->address == pc)
1587 (b->enable == disabled) ? " (disabled)" : "",
1588 (others > 1) ? "," : ((others == 1) ? " and" : ""));
1590 printf_filtered ("also set at pc ");
1591 print_address_numeric (pc, gdb_stdout);
1592 printf_filtered (".\n");
1596 /* Set the default place to put a breakpoint
1597 for the `break' command with no arguments. */
1600 set_default_breakpoint (valid, addr, symtab, line)
1603 struct symtab *symtab;
1606 default_breakpoint_valid = valid;
1607 default_breakpoint_address = addr;
1608 default_breakpoint_symtab = symtab;
1609 default_breakpoint_line = line;
1612 /* Rescan breakpoints at address ADDRESS,
1613 marking the first one as "first" and any others as "duplicates".
1614 This is so that the bpt instruction is only inserted once. */
1617 check_duplicates (address)
1620 register struct breakpoint *b;
1621 register int count = 0;
1623 if (address == 0) /* Watchpoints are uninteresting */
1627 if (b->enable != disabled && b->address == address)
1630 b->duplicate = count > 1;
1634 /* Low level routine to set a breakpoint.
1635 Takes as args the three things that every breakpoint must have.
1636 Returns the breakpoint object so caller can set other things.
1637 Does not set the breakpoint number!
1638 Does not print anything.
1640 ==> This routine should not be called if there is a chance of later
1641 error(); otherwise it leaves a bogus breakpoint on the chain. Validate
1642 your arguments BEFORE calling this routine! */
1644 static struct breakpoint *
1645 set_raw_breakpoint (sal)
1646 struct symtab_and_line sal;
1648 register struct breakpoint *b, *b1;
1650 b = (struct breakpoint *) xmalloc (sizeof (struct breakpoint));
1651 memset (b, 0, sizeof (*b));
1652 b->address = sal.pc;
1653 if (sal.symtab == NULL)
1654 b->source_file = NULL;
1656 b->source_file = savestring (sal.symtab->filename,
1657 strlen (sal.symtab->filename));
1659 b->line_number = sal.line;
1660 b->enable = enabled;
1663 b->ignore_count = 0;
1667 /* Add this breakpoint to the end of the chain
1668 so that a list of breakpoints will come out in order
1669 of increasing numbers. */
1671 b1 = breakpoint_chain;
1673 breakpoint_chain = b;
1681 check_duplicates (sal.pc);
1687 create_longjmp_breakpoint(func_name)
1690 struct symtab_and_line sal;
1691 struct breakpoint *b;
1692 static int internal_breakpoint_number = -1;
1694 if (func_name != NULL)
1696 struct minimal_symbol *m;
1698 m = lookup_minimal_symbol(func_name, (struct objfile *)NULL);
1700 sal.pc = SYMBOL_VALUE_ADDRESS (m);
1710 b = set_raw_breakpoint(sal);
1713 b->type = func_name != NULL ? bp_longjmp : bp_longjmp_resume;
1714 b->disposition = donttouch;
1715 b->enable = disabled;
1718 b->addr_string = strsave(func_name);
1719 b->number = internal_breakpoint_number--;
1722 /* Call this routine when stepping and nexting to enable a breakpoint if we do
1723 a longjmp(). When we hit that breakpoint, call
1724 set_longjmp_resume_breakpoint() to figure out where we are going. */
1727 enable_longjmp_breakpoint()
1729 register struct breakpoint *b;
1732 if (b->type == bp_longjmp)
1734 b->enable = enabled;
1735 check_duplicates (b->address);
1740 disable_longjmp_breakpoint()
1742 register struct breakpoint *b;
1745 if ( b->type == bp_longjmp
1746 || b->type == bp_longjmp_resume)
1748 b->enable = disabled;
1749 check_duplicates (b->address);
1753 /* Call this after hitting the longjmp() breakpoint. Use this to set a new
1754 breakpoint at the target of the jmp_buf.
1756 FIXME - This ought to be done by setting a temporary breakpoint that gets
1757 deleted automatically...
1761 set_longjmp_resume_breakpoint(pc, frame)
1765 register struct breakpoint *b;
1768 if (b->type == bp_longjmp_resume)
1771 b->enable = enabled;
1773 b->frame = FRAME_FP(frame);
1776 check_duplicates (b->address);
1781 /* Set a breakpoint that will evaporate an end of command
1782 at address specified by SAL.
1783 Restrict it to frame FRAME if FRAME is nonzero. */
1786 set_momentary_breakpoint (sal, frame, type)
1787 struct symtab_and_line sal;
1791 register struct breakpoint *b;
1792 b = set_raw_breakpoint (sal);
1794 b->enable = enabled;
1795 b->disposition = donttouch;
1796 b->frame = (frame ? FRAME_FP (frame) : 0);
1802 clear_momentary_breakpoints ()
1804 register struct breakpoint *b;
1806 if (b->disposition == delete)
1808 delete_breakpoint (b);
1814 /* Tell the user we have just set a breakpoint B. */
1817 struct breakpoint *b;
1822 printf_filtered ("Watchpoint %d: ", b->number);
1823 print_expression (b->exp, gdb_stdout);
1826 printf_filtered ("Breakpoint %d at ", b->number);
1827 print_address_numeric (b->address);
1829 printf_filtered (": file %s, line %d.",
1830 b->source_file, b->line_number);
1835 case bp_longjmp_resume:
1836 case bp_step_resume:
1840 printf_filtered ("\n");
1844 /* Nobody calls this currently. */
1845 /* Set a breakpoint from a symtab and line.
1846 If TEMPFLAG is nonzero, it is a temporary breakpoint.
1847 ADDR_STRING is a malloc'd string holding the name of where we are
1848 setting the breakpoint. This is used later to re-set it after the
1849 program is relinked and symbols are reloaded.
1850 Print the same confirmation messages that the breakpoint command prints. */
1853 set_breakpoint (s, line, tempflag, addr_string)
1859 register struct breakpoint *b;
1860 struct symtab_and_line sal;
1865 resolve_sal_pc (&sal); /* Might error out */
1866 describe_other_breakpoints (sal.pc);
1868 b = set_raw_breakpoint (sal);
1869 set_breakpoint_count (breakpoint_count + 1);
1870 b->number = breakpoint_count;
1871 b->type = bp_breakpoint;
1873 b->addr_string = addr_string;
1874 b->enable = enabled;
1875 b->disposition = tempflag ? delete : donttouch;
1881 /* Set a breakpoint according to ARG (function, linenum or *address)
1882 and make it temporary if TEMPFLAG is nonzero. */
1885 break_command_1 (arg, tempflag, from_tty)
1887 int tempflag, from_tty;
1889 struct symtabs_and_lines sals;
1890 struct symtab_and_line sal;
1891 register struct expression *cond = 0;
1892 register struct breakpoint *b;
1894 /* Pointers in arg to the start, and one past the end, of the condition. */
1895 char *cond_start = NULL;
1896 char *cond_end = NULL;
1897 /* Pointers in arg to the start, and one past the end,
1898 of the address part. */
1899 char *addr_start = NULL;
1900 char *addr_end = NULL;
1901 struct cleanup *old_chain;
1902 struct cleanup *canonical_strings_chain = NULL;
1903 char **canonical = (char **)NULL;
1910 sal.line = sal.pc = sal.end = 0;
1913 /* If no arg given, or if first arg is 'if ', use the default breakpoint. */
1915 if (!arg || (arg[0] == 'i' && arg[1] == 'f'
1916 && (arg[2] == ' ' || arg[2] == '\t')))
1918 if (default_breakpoint_valid)
1920 sals.sals = (struct symtab_and_line *)
1921 xmalloc (sizeof (struct symtab_and_line));
1922 sal.pc = default_breakpoint_address;
1923 sal.line = default_breakpoint_line;
1924 sal.symtab = default_breakpoint_symtab;
1929 error ("No default breakpoint address now.");
1935 /* Force almost all breakpoints to be in terms of the
1936 current_source_symtab (which is decode_line_1's default). This
1937 should produce the results we want almost all of the time while
1938 leaving default_breakpoint_* alone. */
1939 if (default_breakpoint_valid
1940 && (!current_source_symtab
1941 || (arg && (*arg == '+' || *arg == '-'))))
1942 sals = decode_line_1 (&arg, 1, default_breakpoint_symtab,
1943 default_breakpoint_line, &canonical);
1945 sals = decode_line_1 (&arg, 1, (struct symtab *)NULL, 0, &canonical);
1953 /* Make sure that all storage allocated in decode_line_1 gets freed in case
1954 the following `for' loop errors out. */
1955 old_chain = make_cleanup (free, sals.sals);
1956 if (canonical != (char **)NULL)
1958 make_cleanup (free, canonical);
1959 canonical_strings_chain = make_cleanup (null_cleanup, 0);
1960 for (i = 0; i < sals.nelts; i++)
1962 if (canonical[i] != NULL)
1963 make_cleanup (free, canonical[i]);
1967 thread = -1; /* No specific thread yet */
1969 /* Resolve all line numbers to PC's, and verify that conditions
1970 can be parsed, before setting any breakpoints. */
1971 for (i = 0; i < sals.nelts; i++)
1973 char *tok, *end_tok;
1976 resolve_sal_pc (&sals.sals[i]);
1982 while (*tok == ' ' || *tok == '\t')
1987 while (*end_tok != ' ' && *end_tok != '\t' && *end_tok != '\000')
1990 toklen = end_tok - tok;
1992 if (toklen >= 1 && strncmp (tok, "if", toklen) == 0)
1994 tok = cond_start = end_tok + 1;
1995 cond = parse_exp_1 (&tok, block_for_pc (sals.sals[i].pc), 0);
1998 else if (toklen >= 1 && strncmp (tok, "thread", toklen) == 0)
2004 thread = strtol (tok, &tok, 0);
2006 error ("Junk after thread keyword.");
2007 if (!valid_thread_id (thread))
2008 error ("Unknown thread %d\n", thread);
2011 error ("Junk at end of arguments.");
2015 /* Remove the canonical strings from the cleanup, they are needed below. */
2016 if (canonical != (char **)NULL)
2017 discard_cleanups (canonical_strings_chain);
2019 /* Now set all the breakpoints. */
2020 for (i = 0; i < sals.nelts; i++)
2025 describe_other_breakpoints (sal.pc);
2027 b = set_raw_breakpoint (sal);
2028 set_breakpoint_count (breakpoint_count + 1);
2029 b->number = breakpoint_count;
2030 b->type = bp_breakpoint;
2034 /* If a canonical line spec is needed use that instead of the
2036 if (canonical != (char **)NULL && canonical[i] != NULL)
2037 b->addr_string = canonical[i];
2038 else if (addr_start)
2039 b->addr_string = savestring (addr_start, addr_end - addr_start);
2041 b->cond_string = savestring (cond_start, cond_end - cond_start);
2043 b->enable = enabled;
2044 b->disposition = tempflag ? delete : donttouch;
2051 printf_filtered ("Multiple breakpoints were set.\n");
2052 printf_filtered ("Use the \"delete\" command to delete unwanted breakpoints.\n");
2054 do_cleanups (old_chain);
2057 /* Helper function for break_command_1 and disassemble_command. */
2060 resolve_sal_pc (sal)
2061 struct symtab_and_line *sal;
2065 if (sal->pc == 0 && sal->symtab != 0)
2067 pc = find_line_pc (sal->symtab, sal->line);
2069 error ("No line %d in file \"%s\".",
2070 sal->line, sal->symtab->filename);
2076 break_command (arg, from_tty)
2080 break_command_1 (arg, 0, from_tty);
2084 tbreak_command (arg, from_tty)
2088 break_command_1 (arg, 1, from_tty);
2093 watch_command (arg, from_tty)
2097 struct breakpoint *b;
2098 struct symtab_and_line sal;
2099 struct expression *exp;
2100 struct block *exp_valid_block;
2107 /* Parse arguments. */
2108 innermost_block = NULL;
2109 exp = parse_expression (arg);
2110 exp_valid_block = innermost_block;
2111 val = evaluate_expression (exp);
2112 release_value (val);
2113 if (VALUE_LAZY (val))
2114 value_fetch_lazy (val);
2116 /* Now set up the breakpoint. */
2117 b = set_raw_breakpoint (sal);
2118 set_breakpoint_count (breakpoint_count + 1);
2119 b->number = breakpoint_count;
2120 b->type = bp_watchpoint;
2121 b->disposition = donttouch;
2123 b->exp_valid_block = exp_valid_block;
2126 b->cond_string = NULL;
2127 b->exp_string = savestring (arg, strlen (arg));
2132 * Helper routine for the until_command routine in infcmd.c. Here
2133 * because it uses the mechanisms of breakpoints.
2137 until_break_command (arg, from_tty)
2141 struct symtabs_and_lines sals;
2142 struct symtab_and_line sal;
2143 FRAME prev_frame = get_prev_frame (selected_frame);
2144 struct breakpoint *breakpoint;
2145 struct cleanup *old_chain;
2147 clear_proceed_status ();
2149 /* Set a breakpoint where the user wants it and at return from
2152 if (default_breakpoint_valid)
2153 sals = decode_line_1 (&arg, 1, default_breakpoint_symtab,
2154 default_breakpoint_line, (char ***)NULL);
2156 sals = decode_line_1 (&arg, 1, (struct symtab *)NULL, 0, (char ***)NULL);
2158 if (sals.nelts != 1)
2159 error ("Couldn't get information on specified line.");
2162 free ((PTR)sals.sals); /* malloc'd, so freed */
2165 error ("Junk at end of arguments.");
2167 resolve_sal_pc (&sal);
2169 breakpoint = set_momentary_breakpoint (sal, selected_frame, bp_until);
2171 old_chain = make_cleanup(delete_breakpoint, breakpoint);
2173 /* Keep within the current frame */
2177 struct frame_info *fi;
2179 fi = get_frame_info (prev_frame);
2180 sal = find_pc_line (fi->pc, 0);
2182 breakpoint = set_momentary_breakpoint (sal, prev_frame, bp_until);
2183 make_cleanup(delete_breakpoint, breakpoint);
2186 proceed (-1, TARGET_SIGNAL_DEFAULT, 0);
2187 do_cleanups(old_chain);
2191 /* These aren't used; I don't konw what they were for. */
2192 /* Set a breakpoint at the catch clause for NAME. */
2194 catch_breakpoint (name)
2200 disable_catch_breakpoint ()
2205 delete_catch_breakpoint ()
2210 enable_catch_breakpoint ()
2217 struct sal_chain *next;
2218 struct symtab_and_line sal;
2222 /* This isn't used; I don't know what it was for. */
2223 /* For each catch clause identified in ARGS, run FUNCTION
2224 with that clause as an argument. */
2225 static struct symtabs_and_lines
2226 map_catch_names (args, function)
2230 register char *p = args;
2232 struct symtabs_and_lines sals;
2234 struct sal_chain *sal_chain = 0;
2238 error_no_arg ("one or more catch names");
2246 /* Don't swallow conditional part. */
2247 if (p1[0] == 'i' && p1[1] == 'f'
2248 && (p1[2] == ' ' || p1[2] == '\t'))
2254 while (isalnum (*p1) || *p1 == '_' || *p1 == '$')
2258 if (*p1 && *p1 != ' ' && *p1 != '\t')
2259 error ("Arguments must be catch names.");
2265 struct sal_chain *next
2266 = (struct sal_chain *)alloca (sizeof (struct sal_chain));
2267 next->next = sal_chain;
2268 next->sal = get_catch_sal (p);
2273 printf_unfiltered ("No catch clause for exception %s.\n", p);
2278 while (*p == ' ' || *p == '\t') p++;
2283 /* This shares a lot of code with `print_frame_label_vars' from stack.c. */
2285 static struct symtabs_and_lines
2286 get_catch_sals (this_level_only)
2287 int this_level_only;
2289 register struct blockvector *bl;
2290 register struct block *block;
2291 int index, have_default = 0;
2292 struct frame_info *fi;
2294 struct symtabs_and_lines sals;
2295 struct sal_chain *sal_chain = 0;
2296 char *blocks_searched;
2298 /* Not sure whether an error message is always the correct response,
2299 but it's better than a core dump. */
2300 if (selected_frame == NULL)
2301 error ("No selected frame.");
2302 block = get_frame_block (selected_frame);
2303 fi = get_frame_info (selected_frame);
2310 error ("No symbol table info available.\n");
2312 bl = blockvector_for_pc (BLOCK_END (block) - 4, &index);
2313 blocks_searched = (char *) alloca (BLOCKVECTOR_NBLOCKS (bl) * sizeof (char));
2314 memset (blocks_searched, 0, BLOCKVECTOR_NBLOCKS (bl) * sizeof (char));
2318 CORE_ADDR end = BLOCK_END (block) - 4;
2321 if (bl != blockvector_for_pc (end, &index))
2322 error ("blockvector blotch");
2323 if (BLOCKVECTOR_BLOCK (bl, index) != block)
2324 error ("blockvector botch");
2325 last_index = BLOCKVECTOR_NBLOCKS (bl);
2328 /* Don't print out blocks that have gone by. */
2329 while (index < last_index
2330 && BLOCK_END (BLOCKVECTOR_BLOCK (bl, index)) < pc)
2333 while (index < last_index
2334 && BLOCK_END (BLOCKVECTOR_BLOCK (bl, index)) < end)
2336 if (blocks_searched[index] == 0)
2338 struct block *b = BLOCKVECTOR_BLOCK (bl, index);
2341 register struct symbol *sym;
2343 nsyms = BLOCK_NSYMS (b);
2345 for (i = 0; i < nsyms; i++)
2347 sym = BLOCK_SYM (b, i);
2348 if (STREQ (SYMBOL_NAME (sym), "default"))
2354 if (SYMBOL_CLASS (sym) == LOC_LABEL)
2356 struct sal_chain *next = (struct sal_chain *)
2357 alloca (sizeof (struct sal_chain));
2358 next->next = sal_chain;
2359 next->sal = find_pc_line (SYMBOL_VALUE_ADDRESS (sym), 0);
2363 blocks_searched[index] = 1;
2369 if (sal_chain && this_level_only)
2372 /* After handling the function's top-level block, stop.
2373 Don't continue to its superblock, the block of
2374 per-file symbols. */
2375 if (BLOCK_FUNCTION (block))
2377 block = BLOCK_SUPERBLOCK (block);
2382 struct sal_chain *tmp_chain;
2384 /* Count the number of entries. */
2385 for (index = 0, tmp_chain = sal_chain; tmp_chain;
2386 tmp_chain = tmp_chain->next)
2390 sals.sals = (struct symtab_and_line *)
2391 xmalloc (index * sizeof (struct symtab_and_line));
2392 for (index = 0; sal_chain; sal_chain = sal_chain->next, index++)
2393 sals.sals[index] = sal_chain->sal;
2399 /* Commands to deal with catching exceptions. */
2402 catch_command_1 (arg, tempflag, from_tty)
2407 /* First, translate ARG into something we can deal with in terms
2410 struct symtabs_and_lines sals;
2411 struct symtab_and_line sal;
2412 register struct expression *cond = 0;
2413 register struct breakpoint *b;
2417 sal.line = sal.pc = sal.end = 0;
2420 /* If no arg given, or if first arg is 'if ', all active catch clauses
2421 are breakpointed. */
2423 if (!arg || (arg[0] == 'i' && arg[1] == 'f'
2424 && (arg[2] == ' ' || arg[2] == '\t')))
2426 /* Grab all active catch clauses. */
2427 sals = get_catch_sals (0);
2431 /* Grab selected catch clauses. */
2432 error ("catch NAME not implemented");
2434 /* This isn't used; I don't know what it was for. */
2435 sals = map_catch_names (arg, catch_breakpoint);
2443 for (i = 0; i < sals.nelts; i++)
2445 resolve_sal_pc (&sals.sals[i]);
2449 if (arg[0] == 'i' && arg[1] == 'f'
2450 && (arg[2] == ' ' || arg[2] == '\t'))
2451 cond = parse_exp_1 ((arg += 2, &arg),
2452 block_for_pc (sals.sals[i].pc), 0);
2454 error ("Junk at end of arguments.");
2459 for (i = 0; i < sals.nelts; i++)
2464 describe_other_breakpoints (sal.pc);
2466 b = set_raw_breakpoint (sal);
2467 set_breakpoint_count (breakpoint_count + 1);
2468 b->number = breakpoint_count;
2469 b->type = bp_breakpoint;
2471 b->enable = enabled;
2472 b->disposition = tempflag ? delete : donttouch;
2479 printf_unfiltered ("Multiple breakpoints were set.\n");
2480 printf_unfiltered ("Use the \"delete\" command to delete unwanted breakpoints.\n");
2482 free ((PTR)sals.sals);
2486 /* These aren't used; I don't know what they were for. */
2487 /* Disable breakpoints on all catch clauses described in ARGS. */
2489 disable_catch (args)
2492 /* Map the disable command to catch clauses described in ARGS. */
2495 /* Enable breakpoints on all catch clauses described in ARGS. */
2500 /* Map the disable command to catch clauses described in ARGS. */
2503 /* Delete breakpoints on all catch clauses in the active scope. */
2508 /* Map the delete command to catch clauses described in ARGS. */
2513 catch_command (arg, from_tty)
2517 catch_command_1 (arg, 0, from_tty);
2521 clear_command (arg, from_tty)
2525 register struct breakpoint *b, *b1;
2526 struct symtabs_and_lines sals;
2527 struct symtab_and_line sal;
2528 register struct breakpoint *found;
2533 sals = decode_line_spec (arg, 1);
2537 sals.sals = (struct symtab_and_line *) xmalloc (sizeof (struct symtab_and_line));
2538 sal.line = default_breakpoint_line;
2539 sal.symtab = default_breakpoint_symtab;
2541 if (sal.symtab == 0)
2542 error ("No source file specified.");
2548 for (i = 0; i < sals.nelts; i++)
2550 /* If exact pc given, clear bpts at that pc.
2551 But if sal.pc is zero, clear all bpts on specified line. */
2553 found = (struct breakpoint *) 0;
2554 while (breakpoint_chain
2556 ? breakpoint_chain->address == sal.pc
2557 : (breakpoint_chain->source_file != NULL
2558 && sal.symtab != NULL
2559 && STREQ (breakpoint_chain->source_file,
2560 sal.symtab->filename)
2561 && breakpoint_chain->line_number == sal.line)))
2563 b1 = breakpoint_chain;
2564 breakpoint_chain = b1->next;
2571 && b->next->type != bp_watchpoint
2573 ? b->next->address == sal.pc
2574 : (b->next->source_file != NULL
2575 && sal.symtab != NULL
2576 && STREQ (b->next->source_file, sal.symtab->filename)
2577 && b->next->line_number == sal.line)))
2588 error ("No breakpoint at %s.", arg);
2590 error ("No breakpoint at this line.");
2593 if (found->next) from_tty = 1; /* Always report if deleted more than one */
2594 if (from_tty) printf_unfiltered ("Deleted breakpoint%s ", found->next ? "s" : "");
2597 if (from_tty) printf_unfiltered ("%d ", found->number);
2599 delete_breakpoint (found);
2602 if (from_tty) putchar_unfiltered ('\n');
2604 free ((PTR)sals.sals);
2607 /* Delete breakpoint in BS if they are `delete' breakpoints.
2608 This is called after any breakpoint is hit, or after errors. */
2611 breakpoint_auto_delete (bs)
2614 for (; bs; bs = bs->next)
2615 if (bs->breakpoint_at && bs->breakpoint_at->disposition == delete
2617 delete_breakpoint (bs->breakpoint_at);
2620 /* Delete a breakpoint and clean up all traces of it in the data structures. */
2623 delete_breakpoint (bpt)
2624 struct breakpoint *bpt;
2626 register struct breakpoint *b;
2630 target_remove_breakpoint(bpt->address, bpt->shadow_contents);
2632 if (breakpoint_chain == bpt)
2633 breakpoint_chain = bpt->next;
2638 b->next = bpt->next;
2642 check_duplicates (bpt->address);
2643 /* If this breakpoint was inserted, and there is another breakpoint
2644 at the same address, we need to insert the other breakpoint. */
2648 if (b->address == bpt->address
2650 && b->enable != disabled)
2653 val = target_insert_breakpoint (b->address, b->shadow_contents);
2656 target_terminal_ours_for_output ();
2657 fprintf_unfiltered (gdb_stderr, "Cannot insert breakpoint %d:\n", b->number);
2658 memory_error (val, b->address); /* which bombs us out */
2665 free_command_lines (&bpt->commands);
2668 if (bpt->cond_string != NULL)
2669 free (bpt->cond_string);
2670 if (bpt->addr_string != NULL)
2671 free (bpt->addr_string);
2672 if (bpt->exp_string != NULL)
2673 free (bpt->exp_string);
2674 if (bpt->source_file != NULL)
2675 free (bpt->source_file);
2677 if (xgdb_verbose && bpt->type == bp_breakpoint)
2679 target_terminal_ours_for_output ();
2680 printf_unfiltered ("breakpoint #%d deleted\n", bpt->number);
2683 /* Be sure no bpstat's are pointing at it after it's been freed. */
2684 /* FIXME, how can we find all bpstat's?
2685 We just check stop_bpstat for now. */
2686 for (bs = stop_bpstat; bs; bs = bs->next)
2687 if (bs->breakpoint_at == bpt)
2688 bs->breakpoint_at = NULL;
2693 delete_command (arg, from_tty)
2700 /* Ask user only if there are some breakpoints to delete. */
2702 || (breakpoint_chain && query ("Delete all breakpoints? ", 0, 0)))
2704 /* No arg; clear all breakpoints. */
2705 while (breakpoint_chain)
2706 delete_breakpoint (breakpoint_chain);
2710 map_breakpoint_numbers (arg, delete_breakpoint);
2713 /* Reset a breakpoint given it's struct breakpoint * BINT.
2714 The value we return ends up being the return value from catch_errors.
2715 Unused in this case. */
2718 breakpoint_re_set_one (bint)
2721 struct breakpoint *b = (struct breakpoint *)bint; /* get past catch_errs */
2723 struct symtabs_and_lines sals;
2725 enum enable save_enable;
2730 if (b->addr_string == NULL)
2732 /* Anything without a string can't be re-set. */
2733 delete_breakpoint (b);
2736 /* In case we have a problem, disable this breakpoint. We'll restore
2737 its status if we succeed. */
2738 save_enable = b->enable;
2739 b->enable = disabled;
2742 sals = decode_line_1 (&s, 1, (struct symtab *)NULL, 0, (char ***)NULL);
2743 for (i = 0; i < sals.nelts; i++)
2745 resolve_sal_pc (&sals.sals[i]);
2747 /* Reparse conditions, they might contain references to the
2749 if (b->cond_string != NULL)
2753 free ((PTR)b->cond);
2754 b->cond = parse_exp_1 (&s, block_for_pc (sals.sals[i].pc), 0);
2757 /* We need to re-set the breakpoint if the address changes...*/
2758 if (b->address != sals.sals[i].pc
2759 /* ...or new and old breakpoints both have source files, and
2760 the source file name or the line number changes... */
2761 || (b->source_file != NULL
2762 && sals.sals[i].symtab != NULL
2763 && (!STREQ (b->source_file, sals.sals[i].symtab->filename)
2764 || b->line_number != sals.sals[i].line)
2766 /* ...or we switch between having a source file and not having
2768 || ((b->source_file == NULL) != (sals.sals[i].symtab == NULL))
2771 if (b->source_file != NULL)
2772 free (b->source_file);
2773 if (sals.sals[i].symtab == NULL)
2774 b->source_file = NULL;
2777 savestring (sals.sals[i].symtab->filename,
2778 strlen (sals.sals[i].symtab->filename));
2779 b->line_number = sals.sals[i].line;
2780 b->address = sals.sals[i].pc;
2782 check_duplicates (b->address);
2786 b->enable = save_enable; /* Restore it, this worked. */
2788 free ((PTR)sals.sals);
2792 innermost_block = NULL;
2793 /* The issue arises of what context to evaluate this in. The same
2794 one as when it was set, but what does that mean when symbols have
2795 been re-read? We could save the filename and functionname, but
2796 if the context is more local than that, the best we could do would
2797 be something like how many levels deep and which index at that
2798 particular level, but that's going to be less stable than filenames
2799 or functionnames. */
2800 /* So for now, just use a global context. */
2801 b->exp = parse_expression (b->exp_string);
2802 b->exp_valid_block = innermost_block;
2803 b->val = evaluate_expression (b->exp);
2804 release_value (b->val);
2805 if (VALUE_LAZY (b->val))
2806 value_fetch_lazy (b->val);
2808 if (b->cond_string != NULL)
2811 b->cond = parse_exp_1 (&s, (struct block *)0, 0);
2813 if (b->enable == enabled)
2818 printf_filtered ("Deleting unknown breakpoint type %d\n", b->type);
2823 case bp_longjmp_resume:
2825 delete_breakpoint (b);
2832 /* Re-set all breakpoints after symbols have been re-loaded. */
2834 breakpoint_re_set ()
2836 struct breakpoint *b, *temp;
2837 static char message1[] = "Error in re-setting breakpoint %d:\n";
2838 char message[sizeof (message1) + 30 /* slop */];
2840 ALL_BREAKPOINTS_SAFE (b, temp)
2842 sprintf (message, message1, b->number); /* Format possible error msg */
2843 catch_errors (breakpoint_re_set_one, (char *) b, message,
2847 create_longjmp_breakpoint("longjmp");
2848 create_longjmp_breakpoint("_longjmp");
2849 create_longjmp_breakpoint("siglongjmp");
2850 create_longjmp_breakpoint(NULL);
2853 /* Took this out (temporaliy at least), since it produces an extra
2854 blank line at startup. This messes up the gdbtests. -PB */
2855 /* Blank line to finish off all those mention() messages we just printed. */
2856 printf_filtered ("\n");
2860 /* Set ignore-count of breakpoint number BPTNUM to COUNT.
2861 If from_tty is nonzero, it prints a message to that effect,
2862 which ends with a period (no newline). */
2865 set_ignore_count (bptnum, count, from_tty)
2866 int bptnum, count, from_tty;
2868 register struct breakpoint *b;
2874 if (b->number == bptnum)
2876 b->ignore_count = count;
2879 else if (count == 0)
2880 printf_filtered ("Will stop next time breakpoint %d is reached.",
2882 else if (count == 1)
2883 printf_filtered ("Will ignore next crossing of breakpoint %d.",
2886 printf_filtered ("Will ignore next %d crossings of breakpoint %d.",
2891 error ("No breakpoint number %d.", bptnum);
2894 /* Clear the ignore counts of all breakpoints. */
2896 breakpoint_clear_ignore_counts ()
2898 struct breakpoint *b;
2901 b->ignore_count = 0;
2904 /* Command to set ignore-count of breakpoint N to COUNT. */
2907 ignore_command (args, from_tty)
2915 error_no_arg ("a breakpoint number");
2917 num = get_number (&p);
2920 error ("Second argument (specified ignore-count) is missing.");
2922 set_ignore_count (num,
2923 longest_to_int (value_as_long (parse_and_eval (p))),
2925 printf_filtered ("\n");
2928 /* Call FUNCTION on each of the breakpoints
2929 whose numbers are given in ARGS. */
2932 map_breakpoint_numbers (args, function)
2934 void (*function) PARAMS ((struct breakpoint *));
2936 register char *p = args;
2939 register struct breakpoint *b;
2942 error_no_arg ("one or more breakpoint numbers");
2948 num = get_number (&p1);
2951 if (b->number == num)
2956 printf_unfiltered ("No breakpoint number %d.\n", num);
2963 enable_breakpoint (bpt)
2964 struct breakpoint *bpt;
2966 FRAME save_selected_frame = NULL;
2967 int save_selected_frame_level = -1;
2969 bpt->enable = enabled;
2971 if (xgdb_verbose && bpt->type == bp_breakpoint)
2972 printf_unfiltered ("breakpoint #%d enabled\n", bpt->number);
2974 check_duplicates (bpt->address);
2975 if (bpt->type == bp_watchpoint)
2977 if (bpt->exp_valid_block != NULL)
2979 FRAME fr = within_scope (bpt->exp_valid_block);
2983 Cannot enable watchpoint %d because the block in which its expression\n\
2984 is valid is not currently in scope.\n", bpt->number);
2985 bpt->enable = disabled;
2988 save_selected_frame = selected_frame;
2989 save_selected_frame_level = selected_frame_level;
2990 select_frame (fr, -1);
2993 value_free (bpt->val);
2995 bpt->val = evaluate_expression (bpt->exp);
2996 release_value (bpt->val);
2997 if (VALUE_LAZY (bpt->val))
2998 value_fetch_lazy (bpt->val);
3000 if (save_selected_frame_level >= 0)
3001 select_frame (save_selected_frame, save_selected_frame_level);
3007 enable_command (args, from_tty)
3011 struct breakpoint *bpt;
3013 ALL_BREAKPOINTS (bpt)
3018 enable_breakpoint (bpt);
3023 map_breakpoint_numbers (args, enable_breakpoint);
3027 disable_breakpoint (bpt)
3028 struct breakpoint *bpt;
3030 bpt->enable = disabled;
3032 if (xgdb_verbose && bpt->type == bp_breakpoint)
3033 printf_filtered ("breakpoint #%d disabled\n", bpt->number);
3035 check_duplicates (bpt->address);
3040 disable_command (args, from_tty)
3044 register struct breakpoint *bpt;
3046 ALL_BREAKPOINTS (bpt)
3051 disable_breakpoint (bpt);
3056 map_breakpoint_numbers (args, disable_breakpoint);
3060 enable_once_breakpoint (bpt)
3061 struct breakpoint *bpt;
3063 bpt->enable = enabled;
3064 bpt->disposition = disable;
3066 check_duplicates (bpt->address);
3071 enable_once_command (args, from_tty)
3075 map_breakpoint_numbers (args, enable_once_breakpoint);
3079 enable_delete_breakpoint (bpt)
3080 struct breakpoint *bpt;
3082 bpt->enable = enabled;
3083 bpt->disposition = delete;
3085 check_duplicates (bpt->address);
3090 enable_delete_command (args, from_tty)
3094 map_breakpoint_numbers (args, enable_delete_breakpoint);
3098 * Use default_breakpoint_'s, or nothing if they aren't valid.
3100 struct symtabs_and_lines
3101 decode_line_spec_1 (string, funfirstline)
3105 struct symtabs_and_lines sals;
3107 error ("Empty line specification.");
3108 if (default_breakpoint_valid)
3109 sals = decode_line_1 (&string, funfirstline,
3110 default_breakpoint_symtab, default_breakpoint_line,
3113 sals = decode_line_1 (&string, funfirstline,
3114 (struct symtab *)NULL, 0, (char ***)NULL);
3116 error ("Junk at end of line specification: %s", string);
3121 _initialize_breakpoint ()
3123 breakpoint_chain = 0;
3124 /* Don't bother to call set_breakpoint_count. $bpnum isn't useful
3125 before a breakpoint is set. */
3126 breakpoint_count = 0;
3128 add_com ("ignore", class_breakpoint, ignore_command,
3129 "Set ignore-count of breakpoint number N to COUNT.");
3131 add_com ("commands", class_breakpoint, commands_command,
3132 "Set commands to be executed when a breakpoint is hit.\n\
3133 Give breakpoint number as argument after \"commands\".\n\
3134 With no argument, the targeted breakpoint is the last one set.\n\
3135 The commands themselves follow starting on the next line.\n\
3136 Type a line containing \"end\" to indicate the end of them.\n\
3137 Give \"silent\" as the first line to make the breakpoint silent;\n\
3138 then no output is printed when it is hit, except what the commands print.");
3140 add_com ("condition", class_breakpoint, condition_command,
3141 "Specify breakpoint number N to break only if COND is true.\n\
3142 N is an integer; COND is an expression to be evaluated whenever\n\
3143 breakpoint N is reached. ");
3145 add_com ("tbreak", class_breakpoint, tbreak_command,
3146 "Set a temporary breakpoint. Args like \"break\" command.\n\
3147 Like \"break\" except the breakpoint is only enabled temporarily,\n\
3148 so it will be disabled when hit. Equivalent to \"break\" followed\n\
3149 by using \"enable once\" on the breakpoint number.");
3151 add_prefix_cmd ("enable", class_breakpoint, enable_command,
3152 "Enable some breakpoints.\n\
3153 Give breakpoint numbers (separated by spaces) as arguments.\n\
3154 With no subcommand, breakpoints are enabled until you command otherwise.\n\
3155 This is used to cancel the effect of the \"disable\" command.\n\
3156 With a subcommand you can enable temporarily.",
3157 &enablelist, "enable ", 1, &cmdlist);
3159 add_abbrev_prefix_cmd ("breakpoints", class_breakpoint, enable_command,
3160 "Enable some breakpoints.\n\
3161 Give breakpoint numbers (separated by spaces) as arguments.\n\
3162 This is used to cancel the effect of the \"disable\" command.\n\
3163 May be abbreviated to simply \"enable\".\n",
3164 &enablebreaklist, "enable breakpoints ", 1, &enablelist);
3166 add_cmd ("once", no_class, enable_once_command,
3167 "Enable breakpoints for one hit. Give breakpoint numbers.\n\
3168 If a breakpoint is hit while enabled in this fashion, it becomes disabled.\n\
3169 See the \"tbreak\" command which sets a breakpoint and enables it once.",
3172 add_cmd ("delete", no_class, enable_delete_command,
3173 "Enable breakpoints and delete when hit. Give breakpoint numbers.\n\
3174 If a breakpoint is hit while enabled in this fashion, it is deleted.",
3177 add_cmd ("delete", no_class, enable_delete_command,
3178 "Enable breakpoints and delete when hit. Give breakpoint numbers.\n\
3179 If a breakpoint is hit while enabled in this fashion, it is deleted.",
3182 add_cmd ("once", no_class, enable_once_command,
3183 "Enable breakpoints for one hit. Give breakpoint numbers.\n\
3184 If a breakpoint is hit while enabled in this fashion, it becomes disabled.\n\
3185 See the \"tbreak\" command which sets a breakpoint and enables it once.",
3188 add_prefix_cmd ("disable", class_breakpoint, disable_command,
3189 "Disable some breakpoints.\n\
3190 Arguments are breakpoint numbers with spaces in between.\n\
3191 To disable all breakpoints, give no argument.\n\
3192 A disabled breakpoint is not forgotten, but has no effect until reenabled.",
3193 &disablelist, "disable ", 1, &cmdlist);
3194 add_com_alias ("dis", "disable", class_breakpoint, 1);
3195 add_com_alias ("disa", "disable", class_breakpoint, 1);
3197 add_cmd ("breakpoints", class_alias, disable_command,
3198 "Disable some breakpoints.\n\
3199 Arguments are breakpoint numbers with spaces in between.\n\
3200 To disable all breakpoints, give no argument.\n\
3201 A disabled breakpoint is not forgotten, but has no effect until reenabled.\n\
3202 This command may be abbreviated \"disable\".",
3205 add_prefix_cmd ("delete", class_breakpoint, delete_command,
3206 "Delete some breakpoints or auto-display expressions.\n\
3207 Arguments are breakpoint numbers with spaces in between.\n\
3208 To delete all breakpoints, give no argument.\n\
3210 Also a prefix command for deletion of other GDB objects.\n\
3211 The \"unset\" command is also an alias for \"delete\".",
3212 &deletelist, "delete ", 1, &cmdlist);
3213 add_com_alias ("d", "delete", class_breakpoint, 1);
3215 add_cmd ("breakpoints", class_alias, delete_command,
3216 "Delete some breakpoints or auto-display expressions.\n\
3217 Arguments are breakpoint numbers with spaces in between.\n\
3218 To delete all breakpoints, give no argument.\n\
3219 This command may be abbreviated \"delete\".",
3222 add_com ("clear", class_breakpoint, clear_command,
3223 "Clear breakpoint at specified line or function.\n\
3224 Argument may be line number, function name, or \"*\" and an address.\n\
3225 If line number is specified, all breakpoints in that line are cleared.\n\
3226 If function is specified, breakpoints at beginning of function are cleared.\n\
3227 If an address is specified, breakpoints at that address are cleared.\n\n\
3228 With no argument, clears all breakpoints in the line that the selected frame\n\
3231 See also the \"delete\" command which clears breakpoints by number.");
3233 add_com ("break", class_breakpoint, break_command,
3234 "Set breakpoint at specified line or function.\n\
3235 Argument may be line number, function name, or \"*\" and an address.\n\
3236 If line number is specified, break at start of code for that line.\n\
3237 If function is specified, break at start of code for that function.\n\
3238 If an address is specified, break at that exact address.\n\
3239 With no arg, uses current execution address of selected stack frame.\n\
3240 This is useful for breaking on return to a stack frame.\n\
3242 Multiple breakpoints at one place are permitted, and useful if conditional.\n\
3244 Do \"help breakpoints\" for info on other commands dealing with breakpoints.");
3245 add_com_alias ("b", "break", class_run, 1);
3246 add_com_alias ("br", "break", class_run, 1);
3247 add_com_alias ("bre", "break", class_run, 1);
3248 add_com_alias ("brea", "break", class_run, 1);
3250 add_info ("breakpoints", breakpoints_info,
3251 "Status of user-settable breakpoints, or breakpoint number NUMBER.\n\
3252 The \"Type\" column indicates one of:\n\
3253 \tbreakpoint - normal breakpoint\n\
3254 \twatchpoint - watchpoint\n\
3255 The \"Disp\" column contains one of \"keep\", \"del\", or \"dis\" to indicate\n\
3256 the disposition of the breakpoint after it gets hit. \"dis\" means that the\n\
3257 breakpoint will be disabled. The \"Address\" and \"What\" columns indicate the\n\
3258 address and file/line number respectively.\n\n\
3259 Convenience variable \"$_\" and default examine address for \"x\"\n\
3260 are set to the address of the last breakpoint listed.\n\n\
3261 Convenience variable \"$bpnum\" contains the number of the last\n\
3264 #if MAINTENANCE_CMDS
3266 add_cmd ("breakpoints", class_maintenance, maintenance_info_breakpoints,
3267 "Status of all breakpoints, or breakpoint number NUMBER.\n\
3268 The \"Type\" column indicates one of:\n\
3269 \tbreakpoint - normal breakpoint\n\
3270 \twatchpoint - watchpoint\n\
3271 \tlongjmp - internal breakpoint used to step through longjmp()\n\
3272 \tlongjmp resume - internal breakpoint at the target of longjmp()\n\
3273 \tuntil - internal breakpoint used by the \"until\" command\n\
3274 \tfinish - internal breakpoint used by the \"finish\" command\n\
3275 The \"Disp\" column contains one of \"keep\", \"del\", or \"dis\" to indicate\n\
3276 the disposition of the breakpoint after it gets hit. \"dis\" means that the\n\
3277 breakpoint will be disabled. The \"Address\" and \"What\" columns indicate the\n\
3278 address and file/line number respectively.\n\n\
3279 Convenience variable \"$_\" and default examine address for \"x\"\n\
3280 are set to the address of the last breakpoint listed.\n\n\
3281 Convenience variable \"$bpnum\" contains the number of the last\n\
3283 &maintenanceinfolist);
3285 #endif /* MAINTENANCE_CMDS */
3287 add_com ("catch", class_breakpoint, catch_command,
3288 "Set breakpoints to catch exceptions that are raised.\n\
3289 Argument may be a single exception to catch, multiple exceptions\n\
3290 to catch, or the default exception \"default\". If no arguments\n\
3291 are given, breakpoints are set at all exception handlers catch clauses\n\
3292 within the current scope.\n\
3294 A condition specified for the catch applies to all breakpoints set\n\
3295 with this command\n\
3297 Do \"help breakpoints\" for info on other commands dealing with breakpoints.");
3299 add_com ("watch", class_breakpoint, watch_command,
3300 "Set a watchpoint for an expression.\n\
3301 A watchpoint stops execution of your program whenever the value of\n\
3302 an expression changes.");
3304 add_info ("watchpoints", breakpoints_info,
3305 "Synonym for ``info breakpoints''.");
3308 /* OK, when we call objfile_relocate, we need to relocate breakpoints
3309 too. breakpoint_re_set is not a good choice--for example, if
3310 addr_string contains just a line number without a file name the
3311 breakpoint might get set in a different file. In general, there is
3312 no need to go all the way back to the user's string (though this might
3313 work if some effort were made to canonicalize it), since symtabs and
3314 everything except addresses are still valid.
3316 Probably the best way to solve this is to have each breakpoint save
3317 the objfile and the section number that was used to set it (if set
3318 by "*addr", probably it is best to use find_pc_line to get a symtab
3319 and use the objfile and block_line_section for that symtab). Then
3320 objfile_relocate can call fixup_breakpoints with the objfile and
3321 the new_offsets, and it can relocate only the appropriate breakpoints. */
3323 #ifdef IBM6000_TARGET
3324 /* But for now, just kludge it based on the concept that before an
3325 objfile is relocated the breakpoint is below 0x10000000, and afterwards
3326 it is higher, so that way we only relocate each breakpoint once. */
3329 fixup_breakpoints (low, high, delta)
3334 struct breakpoint *b;
3338 if (b->address >= low && b->address <= high)
3339 b->address += delta;