1 /* Everything about breakpoints, for GDB.
2 Copyright 1986, 1987, 1989, 1990, 1991, 1992, 1993, 1994, 1995, 1996, 1997
3 Free Software Foundation, Inc.
5 This file is part of GDB.
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2 of the License, or
10 (at your option) any later version.
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with this program; if not, write to the Free Software
19 Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. */
25 #include "breakpoint.h"
27 #include "expression.h"
33 #include "gdbthread.h"
36 #include "gdb_string.h"
42 /* local function prototypes */
45 catch_command_1 PARAMS ((char *, int, int));
48 enable_delete_command PARAMS ((char *, int));
51 enable_delete_breakpoint PARAMS ((struct breakpoint *));
54 enable_once_command PARAMS ((char *, int));
57 enable_once_breakpoint PARAMS ((struct breakpoint *));
60 disable_command PARAMS ((char *, int));
63 enable_command PARAMS ((char *, int));
66 map_breakpoint_numbers PARAMS ((char *, void (*)(struct breakpoint *)));
69 ignore_command PARAMS ((char *, int));
72 breakpoint_re_set_one PARAMS ((char *));
75 delete_command PARAMS ((char *, int));
78 clear_command PARAMS ((char *, int));
81 catch_command PARAMS ((char *, int));
83 static struct symtabs_and_lines
84 get_catch_sals PARAMS ((int));
87 watch_command PARAMS ((char *, int));
90 can_use_hardware_watchpoint PARAMS ((struct value *));
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, asection *));
108 describe_other_breakpoints PARAMS ((CORE_ADDR, asection *));
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 ((PTR));
126 commands_command PARAMS ((char *, int));
129 condition_command PARAMS ((char *, int));
132 get_number PARAMS ((char **));
135 set_breakpoint_count PARAMS ((int));
138 remove_breakpoint PARAMS ((struct breakpoint *));
141 print_it_normal PARAMS ((bpstat));
144 watchpoint_check PARAMS ((char *));
147 print_it_done PARAMS ((bpstat));
150 print_it_noop PARAMS ((bpstat));
153 maintenance_info_breakpoints PARAMS ((char *, int));
155 #ifdef GET_LONGJMP_TARGET
157 create_longjmp_breakpoint PARAMS ((char *));
161 hw_breakpoint_used_count PARAMS ((void));
164 hw_watchpoint_used_count PARAMS ((enum bptype, int *));
167 hbreak_command PARAMS ((char *, int));
170 thbreak_command PARAMS ((char *, int));
173 watch_command_1 PARAMS ((char *, int, int));
176 rwatch_command PARAMS ((char *, int));
179 awatch_command PARAMS ((char *, int));
182 do_enable_breakpoint PARAMS ((struct breakpoint *, enum bpdisp));
184 extern int addressprint; /* Print machine addresses? */
186 #if defined (GET_LONGJMP_TARGET) || defined (SOLIB_ADD)
187 static int internal_breakpoint_number = -1;
190 /* Are we executing breakpoint commands? */
191 static int executing_breakpoint_commands;
193 /* Walk the following statement or block through all breakpoints.
194 ALL_BREAKPOINTS_SAFE does so even if the statment deletes the current
197 #define ALL_BREAKPOINTS(b) for (b = breakpoint_chain; b; b = b->next)
199 #define ALL_BREAKPOINTS_SAFE(b,tmp) \
200 for (b = breakpoint_chain; \
201 b? (tmp=b->next, 1): 0; \
204 /* True if SHIFT_INST_REGS defined, false otherwise. */
206 int must_shift_inst_regs =
207 #if defined(SHIFT_INST_REGS)
214 /* True if breakpoint hit counts should be displayed in breakpoint info. */
216 int show_breakpoint_hit_counts = 1;
218 /* Chain of all breakpoints defined. */
220 struct breakpoint *breakpoint_chain;
222 /* Number of last breakpoint made. */
224 static int breakpoint_count;
226 /* Set breakpoint count to NUM. */
229 set_breakpoint_count (num)
232 breakpoint_count = num;
233 set_internalvar (lookup_internalvar ("bpnum"),
234 value_from_longest (builtin_type_int, (LONGEST) num));
237 /* Used in run_command to zero the hit count when a new run starts. */
240 clear_breakpoint_hit_counts ()
242 struct breakpoint *b;
248 /* Default address, symtab and line to put a breakpoint at
249 for "break" command with no arg.
250 if default_breakpoint_valid is zero, the other three are
251 not valid, and "break" with no arg is an error.
253 This set by print_stack_frame, which calls set_default_breakpoint. */
255 int default_breakpoint_valid;
256 CORE_ADDR default_breakpoint_address;
257 struct symtab *default_breakpoint_symtab;
258 int default_breakpoint_line;
260 /* *PP is a string denoting a breakpoint. Get the number of the breakpoint.
261 Advance *PP after the string and any trailing whitespace.
263 Currently the string can either be a number or "$" followed by the name
264 of a convenience variable. Making it an expression wouldn't work well
265 for map_breakpoint_numbers (e.g. "4 + 5 + 6"). */
274 /* Empty line means refer to the last breakpoint. */
275 return breakpoint_count;
278 /* Make a copy of the name, so we can null-terminate it
279 to pass to lookup_internalvar(). */
284 while (isalnum (*p) || *p == '_')
286 varname = (char *) alloca (p - start + 1);
287 strncpy (varname, start, p - start);
288 varname[p - start] = '\0';
289 val = value_of_internalvar (lookup_internalvar (varname));
290 if (TYPE_CODE (VALUE_TYPE (val)) != TYPE_CODE_INT)
292 "Convenience variables used to specify breakpoints must have integer values."
294 retval = (int) value_as_long (val);
300 while (*p >= '0' && *p <= '9')
303 /* There is no number here. (e.g. "cond a == b"). */
304 error_no_arg ("breakpoint number");
307 if (!(isspace (*p) || *p == '\0'))
308 error ("breakpoint number expected");
315 /* condition N EXP -- set break condition of breakpoint N to EXP. */
318 condition_command (arg, from_tty)
322 register struct breakpoint *b;
327 error_no_arg ("breakpoint number");
330 bnum = get_number (&p);
333 if (b->number == bnum)
340 if (b->cond_string != NULL)
341 free ((PTR)b->cond_string);
346 b->cond_string = NULL;
348 printf_filtered ("Breakpoint %d now unconditional.\n", bnum);
353 /* I don't know if it matters whether this is the string the user
354 typed in or the decompiled expression. */
355 b->cond_string = savestring (arg, strlen (arg));
356 b->cond = parse_exp_1 (&arg, block_for_pc (b->address), 0);
358 error ("Junk at end of expression");
360 breakpoints_changed ();
364 error ("No breakpoint number %d.", bnum);
369 commands_command (arg, from_tty)
373 register struct breakpoint *b;
376 struct command_line *l;
378 /* If we allowed this, we would have problems with when to
379 free the storage, if we change the commands currently
382 if (executing_breakpoint_commands)
383 error ("Can't use the \"commands\" command among a breakpoint's commands.");
386 bnum = get_number (&p);
388 error ("Unexpected extra arguments following breakpoint number.");
391 if (b->number == bnum)
394 sprintf (tmpbuf, "Type commands for when breakpoint %d is hit, one per line.", bnum);
395 l = read_command_lines (tmpbuf, from_tty);
396 free_command_lines (&b->commands);
398 breakpoints_changed ();
401 error ("No breakpoint number %d.", bnum);
404 extern int memory_breakpoint_size; /* from mem-break.c */
406 /* Like target_read_memory() but if breakpoints are inserted, return
407 the shadow contents instead of the breakpoints themselves.
409 Read "memory data" from whatever target or inferior we have.
410 Returns zero if successful, errno value if not. EIO is used
411 for address out of bounds. If breakpoints are inserted, returns
412 shadow contents, not the breakpoints themselves. From breakpoint.c. */
415 read_memory_nobpt (memaddr, myaddr, len)
421 struct breakpoint *b;
423 if (memory_breakpoint_size < 0)
424 /* No breakpoints on this machine. FIXME: This should be
425 dependent on the debugging target. Probably want
426 target_insert_breakpoint to return a size, saying how many
427 bytes of the shadow contents are used, or perhaps have
428 something like target_xfer_shadow. */
429 return target_read_memory (memaddr, myaddr, len);
433 if (b->type == bp_watchpoint
434 || b->type == bp_hardware_watchpoint
435 || b->type == bp_read_watchpoint
436 || b->type == bp_access_watchpoint
439 else if (b->address + memory_breakpoint_size <= memaddr)
440 /* The breakpoint is entirely before the chunk of memory
443 else if (b->address >= memaddr + len)
444 /* The breakpoint is entirely after the chunk of memory we
449 /* Copy the breakpoint from the shadow contents, and recurse
450 for the things before and after. */
452 /* Addresses and length of the part of the breakpoint that
454 CORE_ADDR membpt = b->address;
455 unsigned int bptlen = memory_breakpoint_size;
456 /* Offset within shadow_contents. */
459 if (membpt < memaddr)
461 /* Only copy the second part of the breakpoint. */
462 bptlen -= memaddr - membpt;
463 bptoffset = memaddr - membpt;
467 if (membpt + bptlen > memaddr + len)
469 /* Only copy the first part of the breakpoint. */
470 bptlen -= (membpt + bptlen) - (memaddr + len);
473 memcpy (myaddr + membpt - memaddr,
474 b->shadow_contents + bptoffset, bptlen);
476 if (membpt > memaddr)
478 /* Copy the section of memory before the breakpoint. */
479 status = read_memory_nobpt (memaddr, myaddr, membpt - memaddr);
484 if (membpt + bptlen < memaddr + len)
486 /* Copy the section of memory after the breakpoint. */
487 status = read_memory_nobpt
489 myaddr + membpt + bptlen - memaddr,
490 memaddr + len - (membpt + bptlen));
497 /* Nothing overlaps. Just call read_memory_noerr. */
498 return target_read_memory (memaddr, myaddr, len);
501 /* insert_breakpoints is used when starting or continuing the program.
502 remove_breakpoints is used when the program stops.
503 Both return zero if successful,
504 or an `errno' value if could not write the inferior. */
507 insert_breakpoints ()
509 register struct breakpoint *b, *temp;
511 int disabled_breaks = 0;
513 ALL_BREAKPOINTS_SAFE (b, temp)
514 if (b->type != bp_watchpoint
515 && b->type != bp_hardware_watchpoint
516 && b->type != bp_read_watchpoint
517 && b->type != bp_access_watchpoint
518 && b->enable != disabled
519 && b->enable != shlib_disabled
523 if (b->type == bp_hardware_breakpoint)
524 val = target_insert_hw_breakpoint(b->address, b->shadow_contents);
527 /* Check to see if breakpoint is in an overlay section;
528 if so, we should set the breakpoint at the LMA address.
529 Only if the section is currently mapped should we ALSO
530 set a break at the VMA address. */
531 if (overlay_debugging && b->section &&
532 section_is_overlay (b->section))
536 addr = overlay_unmapped_address (b->address, b->section);
537 val = target_insert_breakpoint (addr, b->shadow_contents);
538 /* This would be the time to check val, to see if the
539 breakpoint write to the load address succeeded.
540 However, this might be an ordinary occurrance, eg. if
541 the unmapped overlay is in ROM. */
542 val = 0; /* in case unmapped address failed */
543 if (section_is_mapped (b->section))
544 val = target_insert_breakpoint (b->address,
547 else /* ordinary (non-overlay) address */
548 val = target_insert_breakpoint(b->address, b->shadow_contents);
552 /* Can't set the breakpoint. */
553 #if defined (DISABLE_UNSETTABLE_BREAK)
554 if (DISABLE_UNSETTABLE_BREAK (b->address))
557 b->enable = shlib_disabled;
558 if (!disabled_breaks)
560 target_terminal_ours_for_output ();
561 fprintf_unfiltered (gdb_stderr,
562 "Cannot insert breakpoint %d:\n", b->number);
563 printf_filtered ("Temporarily disabling shared library breakpoints:\n");
566 printf_filtered ("%d ", b->number);
571 target_terminal_ours_for_output ();
572 fprintf_unfiltered (gdb_stderr, "Cannot insert breakpoint %d:\n", b->number);
573 #ifdef ONE_PROCESS_WRITETEXT
574 fprintf_unfiltered (gdb_stderr,
575 "The same program may be running in another process.\n");
577 memory_error (val, b->address); /* which bombs us out */
583 else if ((b->type == bp_hardware_watchpoint ||
584 b->type == bp_read_watchpoint ||
585 b->type == bp_access_watchpoint)
586 && b->enable == enabled
590 struct frame_info *saved_frame;
591 int saved_level, within_current_scope;
592 value_ptr mark = value_mark ();
595 /* Save the current frame and level so we can restore it after
596 evaluating the watchpoint expression on its own frame. */
597 saved_frame = selected_frame;
598 saved_level = selected_frame_level;
600 /* Determine if the watchpoint is within scope. */
601 if (b->exp_valid_block == NULL)
602 within_current_scope = 1;
605 struct frame_info *fi;
607 /* There might be no current frame at this moment if we are
608 resuming from a step over a breakpoint.
609 Set up current frame before trying to find the watchpoint
611 get_current_frame ();
612 fi = find_frame_addr_in_frame_chain (b->watchpoint_frame);
613 within_current_scope = (fi != NULL);
614 if (within_current_scope)
615 select_frame (fi, -1);
618 if (within_current_scope)
620 /* Evaluate the expression and cut the chain of values
621 produced off from the value chain. */
622 v = evaluate_expression (b->exp);
623 value_release_to_mark (mark);
628 /* Look at each value on the value chain. */
629 for ( ; v; v=v->next)
631 /* If it's a memory location, then we must watch it. */
632 if (v->lval == lval_memory)
636 addr = VALUE_ADDRESS (v) + VALUE_OFFSET (v);
637 len = TYPE_LENGTH (VALUE_TYPE (v));
639 if (b->type == bp_read_watchpoint)
641 else if (b->type == bp_access_watchpoint)
644 val = target_insert_watchpoint (addr, len, type);
653 /* Failure to insert a watchpoint on any memory value in the
654 value chain brings us here. */
656 warning ("Hardware watchpoint %d: Could not insert watchpoint\n",
662 Hardware watchpoint %d deleted because the program has left the block in\n\
663 which its expression is valid.\n", b->number);
664 if (b->related_breakpoint)
665 b->related_breakpoint->disposition = del_at_next_stop;
666 b->disposition = del_at_next_stop;
669 /* Restore the frame and level. */
670 select_frame (saved_frame, saved_level);
673 printf_filtered ("\n");
679 remove_breakpoints ()
681 register struct breakpoint *b;
688 val = remove_breakpoint (b);
698 remove_breakpoint (b)
699 struct breakpoint *b;
703 if (b->type != bp_watchpoint
704 && b->type != bp_hardware_watchpoint
705 && b->type != bp_read_watchpoint
706 && b->type != bp_access_watchpoint)
708 if (b->type == bp_hardware_breakpoint)
709 val = target_remove_hw_breakpoint(b->address, b->shadow_contents);
712 /* Check to see if breakpoint is in an overlay section;
713 if so, we should remove the breakpoint at the LMA address.
714 If that is not equal to the raw address, then we should
715 presumable remove the breakpoint there as well. */
716 if (overlay_debugging && b->section &&
717 section_is_overlay (b->section))
721 addr = overlay_unmapped_address (b->address, b->section);
722 val = target_remove_breakpoint (addr, b->shadow_contents);
723 /* This would be the time to check val, to see if the
724 shadow breakpoint write to the load address succeeded.
725 However, this might be an ordinary occurrance, eg. if
726 the unmapped overlay is in ROM. */
727 val = 0; /* in case unmapped address failed */
728 if (section_is_mapped (b->section))
729 val = target_remove_breakpoint (b->address,
732 else /* ordinary (non-overlay) address */
733 val = target_remove_breakpoint(b->address, b->shadow_contents);
739 else if ((b->type == bp_hardware_watchpoint ||
740 b->type == bp_read_watchpoint ||
741 b->type == bp_access_watchpoint)
742 && b->enable == enabled
748 /* Walk down the saved value chain. */
749 for (v = b->val_chain; v; v = v->next)
751 /* For each memory reference remove the watchpoint
753 if (v->lval == lval_memory)
757 addr = VALUE_ADDRESS (v) + VALUE_OFFSET (v);
758 len = TYPE_LENGTH (VALUE_TYPE (v));
760 if (b->type == bp_read_watchpoint)
762 else if (b->type == bp_access_watchpoint)
765 val = target_remove_watchpoint (addr, len, type);
771 /* Failure to remove any of the hardware watchpoints comes here. */
773 warning ("Hardware watchpoint %d: Could not remove watchpoint\n",
776 /* Free the saved value chain. We will construct a new one
777 the next time the watchpoint is inserted. */
778 for (v = b->val_chain; v; v = n)
788 /* Clear the "inserted" flag in all breakpoints. */
791 mark_breakpoints_out ()
793 register struct breakpoint *b;
799 /* Clear the "inserted" flag in all breakpoints and delete any breakpoints
800 which should go away between runs of the program. */
803 breakpoint_init_inferior ()
805 register struct breakpoint *b, *temp;
807 ALL_BREAKPOINTS_SAFE (b, temp)
814 case bp_watchpoint_scope:
816 /* If the call dummy breakpoint is at the entry point it will
817 cause problems when the inferior is rerun, so we better
820 Also get rid of scope breakpoints. */
821 delete_breakpoint (b);
825 case bp_hardware_watchpoint:
826 case bp_read_watchpoint:
827 case bp_access_watchpoint:
829 /* Likewise for watchpoints on local expressions. */
830 if (b->exp_valid_block != NULL)
831 delete_breakpoint (b);
840 /* breakpoint_here_p (PC) returns 1 if an enabled breakpoint exists at PC.
841 When continuing from a location with a breakpoint,
842 we actually single step once before calling insert_breakpoints. */
845 breakpoint_here_p (pc)
848 register struct breakpoint *b;
851 if (b->enable == enabled
852 && b->address == pc) /* bp is enabled and matches pc */
853 if (overlay_debugging &&
854 section_is_overlay (b->section) &&
855 !section_is_mapped (b->section))
856 continue; /* unmapped overlay -- can't be a match */
863 /* breakpoint_inserted_here_p (PC) is just like breakpoint_here_p(), but it
864 only returns true if there is actually a breakpoint inserted at PC. */
867 breakpoint_inserted_here_p (pc)
870 register struct breakpoint *b;
874 && b->address == pc) /* bp is inserted and matches pc */
875 if (overlay_debugging &&
876 section_is_overlay (b->section) &&
877 !section_is_mapped (b->section))
878 continue; /* unmapped overlay -- can't be a match */
885 /* Return nonzero if FRAME is a dummy frame. We can't use PC_IN_CALL_DUMMY
886 because figuring out the saved SP would take too much time, at least using
887 get_saved_register on the 68k. This means that for this function to
888 work right a port must use the bp_call_dummy breakpoint. */
891 frame_in_dummy (frame)
892 struct frame_info *frame;
895 #ifdef USE_GENERIC_DUMMY_FRAMES
896 return generic_pc_in_call_dummy (frame->pc, frame->frame);
898 struct breakpoint *b;
902 static ULONGEST dummy[] = CALL_DUMMY;
904 if (b->type == bp_call_dummy
905 && b->frame == frame->frame
907 /* We need to check the PC as well as the frame on the sparc,
908 for signals.exp in the testsuite. */
911 - sizeof (dummy) / sizeof (LONGEST) * REGISTER_SIZE))
912 && frame->pc <= b->address)
915 #endif /* GENERIC_DUMMY_FRAMES */
916 #endif /* CALL_DUMMY */
920 /* breakpoint_match_thread (PC, PID) returns true if the breakpoint at PC
921 is valid for process/thread PID. */
924 breakpoint_thread_match (pc, pid)
928 struct breakpoint *b;
931 thread = pid_to_thread_id (pid);
934 if (b->enable != disabled
935 && b->enable != shlib_disabled
937 && (b->thread == -1 || b->thread == thread))
938 if (overlay_debugging &&
939 section_is_overlay (b->section) &&
940 !section_is_mapped (b->section))
941 continue; /* unmapped overlay -- can't be a match */
949 /* bpstat stuff. External routines' interfaces are documented
952 /* Clear a bpstat so that it says we are not at any breakpoint.
953 Also free any storage that is part of a bpstat. */
968 if (p->old_val != NULL)
969 value_free (p->old_val);
976 /* Return a copy of a bpstat. Like "bs1 = bs2" but all storage that
977 is part of the bpstat is copied as well. */
985 bpstat retval = NULL;
990 for (; bs != NULL; bs = bs->next)
992 tmp = (bpstat) xmalloc (sizeof (*tmp));
993 memcpy (tmp, bs, sizeof (*tmp));
995 /* This is the first thing in the chain. */
1005 /* Find the bpstat associated with this breakpoint */
1008 bpstat_find_breakpoint(bsp, breakpoint)
1010 struct breakpoint *breakpoint;
1012 if (bsp == NULL) return NULL;
1014 for (;bsp != NULL; bsp = bsp->next) {
1015 if (bsp->breakpoint_at == breakpoint) return bsp;
1020 /* Return the breakpoint number of the first breakpoint we are stopped
1021 at. *BSP upon return is a bpstat which points to the remaining
1022 breakpoints stopped at (but which is not guaranteed to be good for
1023 anything but further calls to bpstat_num).
1024 Return 0 if passed a bpstat which does not indicate any breakpoints. */
1030 struct breakpoint *b;
1033 return 0; /* No more breakpoint values */
1036 b = (*bsp)->breakpoint_at;
1037 *bsp = (*bsp)->next;
1039 return -1; /* breakpoint that's been deleted since */
1041 return b->number; /* We have its number */
1045 /* Modify BS so that the actions will not be performed. */
1048 bpstat_clear_actions (bs)
1051 for (; bs != NULL; bs = bs->next)
1053 bs->commands = NULL;
1054 if (bs->old_val != NULL)
1056 value_free (bs->old_val);
1062 /* Stub for cleaning up our state if we error-out of a breakpoint command */
1065 cleanup_executing_breakpoints (ignore)
1068 executing_breakpoint_commands = 0;
1071 /* Execute all the commands associated with all the breakpoints at this
1072 location. Any of these commands could cause the process to proceed
1073 beyond this point, etc. We look out for such changes by checking
1074 the global "breakpoint_proceeded" after each command. */
1077 bpstat_do_actions (bsp)
1081 struct cleanup *old_chain;
1082 struct command_line *cmd;
1084 /* Avoid endless recursion if a `source' command is contained
1086 if (executing_breakpoint_commands)
1089 executing_breakpoint_commands = 1;
1090 old_chain = make_cleanup (cleanup_executing_breakpoints, 0);
1095 breakpoint_proceeded = 0;
1096 for (; bs != NULL; bs = bs->next)
1101 execute_control_command (cmd);
1104 if (breakpoint_proceeded)
1105 /* The inferior is proceeded by the command; bomb out now.
1106 The bpstat chain has been blown away by wait_for_inferior.
1107 But since execution has stopped again, there is a new bpstat
1108 to look at, so start over. */
1111 bs->commands = NULL;
1114 executing_breakpoint_commands = 0;
1115 discard_cleanups (old_chain);
1118 /* This is the normal print_it function for a bpstat. In the future,
1119 much of this logic could (should?) be moved to bpstat_stop_status,
1120 by having it set different print_it functions. */
1123 print_it_normal (bs)
1126 /* bs->breakpoint_at can be NULL if it was a momentary breakpoint
1127 which has since been deleted. */
1128 if (bs->breakpoint_at == NULL
1129 || (bs->breakpoint_at->type != bp_breakpoint
1130 && bs->breakpoint_at->type != bp_hardware_breakpoint
1131 && bs->breakpoint_at->type != bp_watchpoint
1132 && bs->breakpoint_at->type != bp_read_watchpoint
1133 && bs->breakpoint_at->type != bp_access_watchpoint
1134 && bs->breakpoint_at->type != bp_hardware_watchpoint))
1137 if (bs->breakpoint_at->type == bp_breakpoint ||
1138 bs->breakpoint_at->type == bp_hardware_breakpoint)
1140 /* I think the user probably only wants to see one breakpoint
1141 number, not all of them. */
1142 annotate_breakpoint (bs->breakpoint_at->number);
1143 printf_filtered ("\nBreakpoint %d, ", bs->breakpoint_at->number);
1146 else if ((bs->old_val != NULL) &&
1147 (bs->breakpoint_at->type == bp_watchpoint ||
1148 bs->breakpoint_at->type == bp_access_watchpoint ||
1149 bs->breakpoint_at->type == bp_hardware_watchpoint))
1151 annotate_watchpoint (bs->breakpoint_at->number);
1152 mention (bs->breakpoint_at);
1153 printf_filtered ("\nOld value = ");
1154 value_print (bs->old_val, gdb_stdout, 0, Val_pretty_default);
1155 printf_filtered ("\nNew value = ");
1156 value_print (bs->breakpoint_at->val, gdb_stdout, 0,
1157 Val_pretty_default);
1158 printf_filtered ("\n");
1159 value_free (bs->old_val);
1161 /* More than one watchpoint may have been triggered. */
1164 else if (bs->breakpoint_at->type == bp_access_watchpoint ||
1165 bs->breakpoint_at->type == bp_read_watchpoint)
1167 mention (bs->breakpoint_at);
1168 printf_filtered ("\nValue = ");
1169 value_print (bs->breakpoint_at->val, gdb_stdout, 0,
1170 Val_pretty_default);
1171 printf_filtered ("\n");
1174 /* We can't deal with it. Maybe another member of the bpstat chain can. */
1178 /* Print a message indicating what happened. Returns nonzero to
1179 say that only the source line should be printed after this (zero
1180 return means print the frame as well as the source line). */
1181 /* Currently we always return zero. */
1191 val = (*bs->print_it) (bs);
1195 /* Maybe another breakpoint in the chain caused us to stop.
1196 (Currently all watchpoints go on the bpstat whether hit or
1197 not. That probably could (should) be changed, provided care is taken
1198 with respect to bpstat_explains_signal). */
1200 return bpstat_print (bs->next);
1202 /* We reached the end of the chain without printing anything. */
1206 /* Evaluate the expression EXP and return 1 if value is zero.
1207 This is used inside a catch_errors to evaluate the breakpoint condition.
1208 The argument is a "struct expression *" that has been cast to char * to
1209 make it pass through catch_errors. */
1212 breakpoint_cond_eval (exp)
1215 value_ptr mark = value_mark ();
1216 int i = !value_true (evaluate_expression ((struct expression *)exp));
1217 value_free_to_mark (mark);
1221 /* Allocate a new bpstat and chain it to the current one. */
1224 bpstat_alloc (b, cbs)
1225 register struct breakpoint *b;
1226 bpstat cbs; /* Current "bs" value */
1230 bs = (bpstat) xmalloc (sizeof (*bs));
1232 bs->breakpoint_at = b;
1233 /* If the condition is false, etc., don't do the commands. */
1234 bs->commands = NULL;
1236 bs->print_it = print_it_normal;
1240 /* Possible return values for watchpoint_check (this can't be an enum
1241 because of check_errors). */
1242 /* The watchpoint has been deleted. */
1243 #define WP_DELETED 1
1244 /* The value has changed. */
1245 #define WP_VALUE_CHANGED 2
1246 /* The value has not changed. */
1247 #define WP_VALUE_NOT_CHANGED 3
1249 #define BP_TEMPFLAG 1
1250 #define BP_HARDWAREFLAG 2
1252 /* Check watchpoint condition. */
1255 watchpoint_check (p)
1258 bpstat bs = (bpstat) p;
1259 struct breakpoint *b;
1260 struct frame_info *fr;
1261 int within_current_scope;
1263 b = bs->breakpoint_at;
1265 if (b->exp_valid_block == NULL)
1266 within_current_scope = 1;
1269 /* There is no current frame at this moment. If we're going to have
1270 any chance of handling watchpoints on local variables, we'll need
1271 the frame chain (so we can determine if we're in scope). */
1272 reinit_frame_cache();
1273 fr = find_frame_addr_in_frame_chain (b->watchpoint_frame);
1274 within_current_scope = (fr != NULL);
1275 if (within_current_scope)
1276 /* If we end up stopping, the current frame will get selected
1277 in normal_stop. So this call to select_frame won't affect
1279 select_frame (fr, -1);
1282 if (within_current_scope)
1284 /* We use value_{,free_to_}mark because it could be a
1285 *long* time before we return to the command level and
1286 call free_all_values. We can't call free_all_values because
1287 we might be in the middle of evaluating a function call. */
1289 value_ptr mark = value_mark ();
1290 value_ptr new_val = evaluate_expression (bs->breakpoint_at->exp);
1291 if (!value_equal (b->val, new_val))
1293 release_value (new_val);
1294 value_free_to_mark (mark);
1295 bs->old_val = b->val;
1297 /* We will stop here */
1298 return WP_VALUE_CHANGED;
1302 /* Nothing changed, don't do anything. */
1303 value_free_to_mark (mark);
1304 /* We won't stop here */
1305 return WP_VALUE_NOT_CHANGED;
1310 /* This seems like the only logical thing to do because
1311 if we temporarily ignored the watchpoint, then when
1312 we reenter the block in which it is valid it contains
1313 garbage (in the case of a function, it may have two
1314 garbage values, one before and one after the prologue).
1315 So we can't even detect the first assignment to it and
1316 watch after that (since the garbage may or may not equal
1317 the first value assigned). */
1319 Watchpoint %d deleted because the program has left the block in\n\
1320 which its expression is valid.\n", bs->breakpoint_at->number);
1321 if (b->related_breakpoint)
1322 b->related_breakpoint->disposition = del_at_next_stop;
1323 b->disposition = del_at_next_stop;
1329 /* This is used when everything which needs to be printed has
1330 already been printed. But we still want to print the frame. */
1338 /* This is used when nothing should be printed for this bpstat entry. */
1347 /* Get a bpstat associated with having just stopped at address *PC
1348 and frame address CORE_ADDRESS. Update *PC to point at the
1349 breakpoint (if we hit a breakpoint). NOT_A_BREAKPOINT is nonzero
1350 if this is known to not be a real breakpoint (it could still be a
1351 watchpoint, though). */
1353 /* Determine whether we stopped at a breakpoint, etc, or whether we
1354 don't understand this stop. Result is a chain of bpstat's such that:
1356 if we don't understand the stop, the result is a null pointer.
1358 if we understand why we stopped, the result is not null.
1360 Each element of the chain refers to a particular breakpoint or
1361 watchpoint at which we have stopped. (We may have stopped for
1362 several reasons concurrently.)
1364 Each element of the chain has valid next, breakpoint_at,
1365 commands, FIXME??? fields.
1370 bpstat_stop_status (pc, not_a_breakpoint)
1372 int not_a_breakpoint;
1374 register struct breakpoint *b, *temp;
1376 /* True if we've hit a breakpoint (as opposed to a watchpoint). */
1377 int real_breakpoint = 0;
1378 /* Root of the chain of bpstat's */
1379 struct bpstats root_bs[1];
1380 /* Pointer to the last thing in the chain currently. */
1381 bpstat bs = root_bs;
1382 static char message1[] =
1383 "Error evaluating expression for watchpoint %d\n";
1384 char message[sizeof (message1) + 30 /* slop */];
1386 /* Get the address where the breakpoint would have been. */
1387 bp_addr = *pc - DECR_PC_AFTER_BREAK;
1389 ALL_BREAKPOINTS_SAFE (b, temp)
1391 if (b->enable == disabled
1392 || b->enable == shlib_disabled)
1395 if (b->type != bp_watchpoint
1396 && b->type != bp_hardware_watchpoint
1397 && b->type != bp_read_watchpoint
1398 && b->type != bp_access_watchpoint
1399 && b->type != bp_hardware_breakpoint) /* a non-watchpoint bp */
1400 if (b->address != bp_addr || /* address doesn't match or */
1401 (overlay_debugging && /* overlay doesn't match */
1402 section_is_overlay (b->section) &&
1403 !section_is_mapped (b->section)))
1406 if (b->type == bp_hardware_breakpoint
1407 && b->address != (bp_addr - DECR_PC_AFTER_HW_BREAK))
1410 if (b->type != bp_watchpoint
1411 && b->type != bp_hardware_watchpoint
1412 && b->type != bp_read_watchpoint
1413 && b->type != bp_access_watchpoint
1414 && not_a_breakpoint)
1417 /* Come here if it's a watchpoint, or if the break address matches */
1421 bs = bpstat_alloc (b, bs); /* Alloc a bpstat to explain stop */
1426 sprintf (message, message1, b->number);
1427 if (b->type == bp_watchpoint || b->type == bp_hardware_watchpoint)
1429 switch (catch_errors (watchpoint_check, (char *) bs, message,
1433 /* We've already printed what needs to be printed. */
1434 bs->print_it = print_it_done;
1437 case WP_VALUE_CHANGED:
1440 case WP_VALUE_NOT_CHANGED:
1442 bs->print_it = print_it_noop;
1449 /* Error from catch_errors. */
1450 printf_filtered ("Watchpoint %d deleted.\n", b->number);
1451 if (b->related_breakpoint)
1452 b->related_breakpoint->disposition = del_at_next_stop;
1453 b->disposition = del_at_next_stop;
1454 /* We've already printed what needs to be printed. */
1455 bs->print_it = print_it_done;
1461 else if (b->type == bp_read_watchpoint || b->type == bp_access_watchpoint)
1467 addr = target_stopped_data_address();
1468 if (addr == 0) continue;
1469 for (v = b->val_chain; v; v = v->next)
1471 if (v->lval == lval_memory)
1475 vaddr = VALUE_ADDRESS (v) + VALUE_OFFSET (v);
1481 switch (catch_errors (watchpoint_check, (char *) bs, message,
1485 /* We've already printed what needs to be printed. */
1486 bs->print_it = print_it_done;
1489 case WP_VALUE_CHANGED:
1490 case WP_VALUE_NOT_CHANGED:
1496 /* Error from catch_errors. */
1497 printf_filtered ("Watchpoint %d deleted.\n", b->number);
1498 if (b->related_breakpoint)
1499 b->related_breakpoint->disposition = del_at_next_stop;
1500 b->disposition = del_at_next_stop;
1501 /* We've already printed what needs to be printed. */
1502 bs->print_it = print_it_done;
1506 else if (DECR_PC_AFTER_BREAK != 0 || must_shift_inst_regs)
1507 real_breakpoint = 1;
1509 if (b->frame && b->frame != (get_current_frame ())->frame)
1513 int value_is_zero = 0;
1517 /* Need to select the frame, with all that implies
1518 so that the conditions will have the right context. */
1519 select_frame (get_current_frame (), 0);
1521 = catch_errors (breakpoint_cond_eval, (char *)(b->cond),
1522 "Error in testing breakpoint condition:\n",
1524 /* FIXME-someday, should give breakpoint # */
1527 if (b->cond && value_is_zero)
1531 else if (b->ignore_count > 0)
1538 /* We will stop here */
1539 if (b->disposition == disable)
1540 b->enable = disabled;
1541 bs->commands = b->commands;
1544 if (bs->commands && STREQ ("silent", bs->commands->line))
1546 bs->commands = bs->commands->next;
1551 /* Print nothing for this entry if we dont stop or if we dont print. */
1552 if (bs->stop == 0 || bs->print == 0)
1553 bs->print_it = print_it_noop;
1556 bs->next = NULL; /* Terminate the chain */
1557 bs = root_bs->next; /* Re-grab the head of the chain */
1559 if ((DECR_PC_AFTER_BREAK != 0 || must_shift_inst_regs) && bs)
1561 if (real_breakpoint)
1564 #if defined (SHIFT_INST_REGS)
1566 #else /* No SHIFT_INST_REGS. */
1568 #endif /* No SHIFT_INST_REGS. */
1572 /* The value of a hardware watchpoint hasn't changed, but the
1573 intermediate memory locations we are watching may have. */
1574 if (bs && ! bs->stop &&
1575 (bs->breakpoint_at->type == bp_hardware_watchpoint ||
1576 bs->breakpoint_at->type == bp_read_watchpoint ||
1577 bs->breakpoint_at->type == bp_access_watchpoint))
1579 remove_breakpoints ();
1580 insert_breakpoints ();
1585 /* Tell what to do about this bpstat. */
1590 /* Classify each bpstat as one of the following. */
1592 /* This bpstat element has no effect on the main_action. */
1595 /* There was a watchpoint, stop but don't print. */
1598 /* There was a watchpoint, stop and print. */
1601 /* There was a breakpoint but we're not stopping. */
1604 /* There was a breakpoint, stop but don't print. */
1607 /* There was a breakpoint, stop and print. */
1610 /* We hit the longjmp breakpoint. */
1613 /* We hit the longjmp_resume breakpoint. */
1616 /* We hit the step_resume breakpoint. */
1619 /* We hit the through_sigtramp breakpoint. */
1622 /* We hit the shared library event breakpoint. */
1625 /* This is just used to count how many enums there are. */
1629 /* Here is the table which drives this routine. So that we can
1630 format it pretty, we define some abbreviations for the
1631 enum bpstat_what codes. */
1632 #define kc BPSTAT_WHAT_KEEP_CHECKING
1633 #define ss BPSTAT_WHAT_STOP_SILENT
1634 #define sn BPSTAT_WHAT_STOP_NOISY
1635 #define sgl BPSTAT_WHAT_SINGLE
1636 #define slr BPSTAT_WHAT_SET_LONGJMP_RESUME
1637 #define clr BPSTAT_WHAT_CLEAR_LONGJMP_RESUME
1638 #define clrs BPSTAT_WHAT_CLEAR_LONGJMP_RESUME_SINGLE
1639 #define sr BPSTAT_WHAT_STEP_RESUME
1640 #define ts BPSTAT_WHAT_THROUGH_SIGTRAMP
1641 #define shl BPSTAT_WHAT_CHECK_SHLIBS
1643 /* "Can't happen." Might want to print an error message.
1644 abort() is not out of the question, but chances are GDB is just
1645 a bit confused, not unusable. */
1646 #define err BPSTAT_WHAT_STOP_NOISY
1648 /* Given an old action and a class, come up with a new action. */
1649 /* One interesting property of this table is that wp_silent is the same
1650 as bp_silent and wp_noisy is the same as bp_noisy. That is because
1651 after stopping, the check for whether to step over a breakpoint
1652 (BPSTAT_WHAT_SINGLE type stuff) is handled in proceed() without
1653 reference to how we stopped. We retain separate wp_silent and bp_silent
1654 codes in case we want to change that someday. */
1656 /* step_resume entries: a step resume breakpoint overrides another
1657 breakpoint of signal handling (see comment in wait_for_inferior
1658 at first IN_SIGTRAMP where we set the step_resume breakpoint). */
1659 /* We handle the through_sigtramp_breakpoint the same way; having both
1660 one of those and a step_resume_breakpoint is probably very rare (?). */
1662 static const enum bpstat_what_main_action
1663 table[(int)class_last][(int)BPSTAT_WHAT_LAST] =
1666 /* kc ss sn sgl slr clr clrs sr ts shl
1668 /*no_effect*/ {kc, ss, sn, sgl, slr, clr, clrs, sr, ts, shl},
1669 /*wp_silent*/ {ss, ss, sn, ss, ss, ss, ss, sr, ts, shl},
1670 /*wp_noisy*/ {sn, sn, sn, sn, sn, sn, sn, sr, ts, shl},
1671 /*bp_nostop*/ {sgl, ss, sn, sgl, slr, clrs, clrs, sr, ts, shl},
1672 /*bp_silent*/ {ss, ss, sn, ss, ss, ss, ss, sr, ts, shl},
1673 /*bp_noisy*/ {sn, sn, sn, sn, sn, sn, sn, sr, ts, shl},
1674 /*long_jump*/ {slr, ss, sn, slr, err, err, err, sr, ts, shl},
1675 /*long_resume*/ {clr, ss, sn, clrs, err, err, err, sr, ts, shl},
1676 /*step_resume*/ {sr, sr, sr, sr, sr, sr, sr, sr, ts, shl},
1677 /*through_sig*/ {ts, ts, ts, ts, ts, ts, ts, ts, ts, shl},
1678 /*shlib*/ {shl, shl, shl, shl, shl, shl, shl, shl, ts, shl}
1691 enum bpstat_what_main_action current_action = BPSTAT_WHAT_KEEP_CHECKING;
1692 struct bpstat_what retval;
1694 retval.call_dummy = 0;
1695 for (; bs != NULL; bs = bs->next)
1697 enum class bs_class = no_effect;
1698 if (bs->breakpoint_at == NULL)
1699 /* I suspect this can happen if it was a momentary breakpoint
1700 which has since been deleted. */
1702 switch (bs->breakpoint_at->type)
1705 case bp_hardware_breakpoint:
1711 bs_class = bp_noisy;
1713 bs_class = bp_silent;
1716 bs_class = bp_nostop;
1719 case bp_hardware_watchpoint:
1720 case bp_read_watchpoint:
1721 case bp_access_watchpoint:
1725 bs_class = wp_noisy;
1727 bs_class = wp_silent;
1730 /* There was a watchpoint, but we're not stopping. This requires
1731 no further action. */
1732 bs_class = no_effect;
1735 bs_class = long_jump;
1737 case bp_longjmp_resume:
1738 bs_class = long_resume;
1740 case bp_step_resume:
1743 bs_class = step_resume;
1746 /* It is for the wrong frame. */
1747 bs_class = bp_nostop;
1749 case bp_through_sigtramp:
1750 bs_class = through_sig;
1752 case bp_watchpoint_scope:
1753 bs_class = bp_nostop;
1755 case bp_shlib_event:
1756 bs_class = shlib_event;
1759 /* Make sure the action is stop (silent or noisy), so infrun.c
1760 pops the dummy frame. */
1761 bs_class = bp_silent;
1762 retval.call_dummy = 1;
1765 current_action = table[(int)bs_class][(int)current_action];
1767 retval.main_action = current_action;
1771 /* Nonzero if we should step constantly (e.g. watchpoints on machines
1772 without hardware support). This isn't related to a specific bpstat,
1773 just to things like whether watchpoints are set. */
1776 bpstat_should_step ()
1778 struct breakpoint *b;
1780 if (b->enable == enabled && b->type == bp_watchpoint)
1785 /* Print information on breakpoint number BNUM, or -1 if all.
1786 If WATCHPOINTS is zero, process only breakpoints; if WATCHPOINTS
1787 is nonzero, process only watchpoints. */
1790 breakpoint_1 (bnum, allflag)
1794 register struct breakpoint *b;
1795 register struct command_line *l;
1796 register struct symbol *sym;
1797 CORE_ADDR last_addr = (CORE_ADDR)-1;
1798 int found_a_breakpoint = 0;
1799 static char *bptypes[] = {"breakpoint", "hw breakpoint",
1800 "until", "finish", "watchpoint",
1801 "hw watchpoint", "read watchpoint",
1802 "acc watchpoint", "longjmp",
1803 "longjmp resume", "step resume",
1805 "watchpoint scope", "call dummy",
1807 static char *bpdisps[] = {"del", "dstp", "dis", "keep"};
1808 static char bpenables[] = "nyn";
1809 char wrap_indent[80];
1813 || bnum == b->number)
1815 /* We only print out user settable breakpoints unless the allflag is set. */
1817 && b->type != bp_breakpoint
1818 && b->type != bp_hardware_breakpoint
1819 && b->type != bp_watchpoint
1820 && b->type != bp_read_watchpoint
1821 && b->type != bp_access_watchpoint
1822 && b->type != bp_hardware_watchpoint)
1825 if (!found_a_breakpoint++)
1827 annotate_breakpoints_headers ();
1830 printf_filtered ("Num ");
1832 printf_filtered ("Type ");
1834 printf_filtered ("Disp ");
1836 printf_filtered ("Enb ");
1840 printf_filtered ("Address ");
1843 printf_filtered ("What\n");
1845 annotate_breakpoints_table ();
1850 printf_filtered ("%-3d ", b->number);
1852 printf_filtered ("%-14s ", bptypes[(int)b->type]);
1854 printf_filtered ("%-4s ", bpdisps[(int)b->disposition]);
1856 printf_filtered ("%-3c ", bpenables[(int)b->enable]);
1858 strcpy (wrap_indent, " ");
1860 strcat (wrap_indent, " ");
1864 case bp_hardware_watchpoint:
1865 case bp_read_watchpoint:
1866 case bp_access_watchpoint:
1867 /* Field 4, the address, is omitted (which makes the columns
1868 not line up too nicely with the headers, but the effect
1869 is relatively readable). */
1871 print_expression (b->exp, gdb_stdout);
1875 case bp_hardware_breakpoint:
1879 case bp_longjmp_resume:
1880 case bp_step_resume:
1881 case bp_through_sigtramp:
1882 case bp_watchpoint_scope:
1884 case bp_shlib_event:
1888 /* FIXME-32x64: need a print_address_numeric with
1892 local_hex_string_custom
1893 ((unsigned long) b->address, "08l"));
1898 last_addr = b->address;
1901 sym = find_pc_sect_function (b->address, b->section);
1904 fputs_filtered ("in ", gdb_stdout);
1905 fputs_filtered (SYMBOL_SOURCE_NAME (sym), gdb_stdout);
1906 wrap_here (wrap_indent);
1907 fputs_filtered (" at ", gdb_stdout);
1909 fputs_filtered (b->source_file, gdb_stdout);
1910 printf_filtered (":%d", b->line_number);
1913 print_address_symbolic (b->address, gdb_stdout, demangle, " ");
1917 printf_filtered ("\n");
1923 printf_filtered ("\tstop only in stack frame at ");
1924 print_address_numeric (b->frame, 1, gdb_stdout);
1925 printf_filtered ("\n");
1932 printf_filtered ("\tstop only if ");
1933 print_expression (b->cond, gdb_stdout);
1934 printf_filtered ("\n");
1937 if (b->thread != -1)
1939 /* FIXME should make an annotation for this */
1940 printf_filtered ("\tstop only in thread %d\n", b->thread);
1943 if (show_breakpoint_hit_counts && b->hit_count)
1945 /* FIXME should make an annotation for this */
1947 printf_filtered ("\tbreakpoint already hit %d time%s\n",
1948 b->hit_count, (b->hit_count == 1 ? "" : "s"));
1951 if (b->ignore_count)
1955 printf_filtered ("\tignore next %d hits\n", b->ignore_count);
1958 if ((l = b->commands))
1964 print_command_line (l, 4);
1970 if (!found_a_breakpoint)
1973 printf_filtered ("No breakpoints or watchpoints.\n");
1975 printf_filtered ("No breakpoint or watchpoint number %d.\n", bnum);
1978 /* Compare against (CORE_ADDR)-1 in case some compiler decides
1979 that a comparison of an unsigned with -1 is always false. */
1980 if (last_addr != (CORE_ADDR)-1)
1981 set_next_address (last_addr);
1983 annotate_breakpoints_table_end ();
1988 breakpoints_info (bnum_exp, from_tty)
1995 bnum = parse_and_eval_address (bnum_exp);
1997 breakpoint_1 (bnum, 0);
2000 #if MAINTENANCE_CMDS
2004 maintenance_info_breakpoints (bnum_exp, from_tty)
2011 bnum = parse_and_eval_address (bnum_exp);
2013 breakpoint_1 (bnum, 1);
2018 /* Print a message describing any breakpoints set at PC. */
2021 describe_other_breakpoints (pc, section)
2025 register int others = 0;
2026 register struct breakpoint *b;
2029 if (b->address == pc)
2030 if (overlay_debugging == 0 ||
2031 b->section == section)
2035 printf_filtered ("Note: breakpoint%s ", (others > 1) ? "s" : "");
2037 if (b->address == pc)
2038 if (overlay_debugging == 0 ||
2039 b->section == section)
2045 ((b->enable == disabled || b->enable == shlib_disabled)
2046 ? " (disabled)" : ""),
2047 (others > 1) ? "," : ((others == 1) ? " and" : ""));
2049 printf_filtered ("also set at pc ");
2050 print_address_numeric (pc, 1, gdb_stdout);
2051 printf_filtered (".\n");
2055 /* Set the default place to put a breakpoint
2056 for the `break' command with no arguments. */
2059 set_default_breakpoint (valid, addr, symtab, line)
2062 struct symtab *symtab;
2065 default_breakpoint_valid = valid;
2066 default_breakpoint_address = addr;
2067 default_breakpoint_symtab = symtab;
2068 default_breakpoint_line = line;
2071 /* Rescan breakpoints at address ADDRESS,
2072 marking the first one as "first" and any others as "duplicates".
2073 This is so that the bpt instruction is only inserted once. */
2076 check_duplicates (address, section)
2080 register struct breakpoint *b;
2081 register int count = 0;
2083 if (address == 0) /* Watchpoints are uninteresting */
2087 if (b->enable != disabled
2088 && b->enable != shlib_disabled
2089 && b->address == address
2090 && (overlay_debugging == 0 || b->section == section))
2093 b->duplicate = count > 1;
2097 /* Low level routine to set a breakpoint.
2098 Takes as args the three things that every breakpoint must have.
2099 Returns the breakpoint object so caller can set other things.
2100 Does not set the breakpoint number!
2101 Does not print anything.
2103 ==> This routine should not be called if there is a chance of later
2104 error(); otherwise it leaves a bogus breakpoint on the chain. Validate
2105 your arguments BEFORE calling this routine! */
2107 static struct breakpoint *
2108 set_raw_breakpoint (sal)
2109 struct symtab_and_line sal;
2111 register struct breakpoint *b, *b1;
2113 b = (struct breakpoint *) xmalloc (sizeof (struct breakpoint));
2114 memset (b, 0, sizeof (*b));
2115 b->address = sal.pc;
2116 if (sal.symtab == NULL)
2117 b->source_file = NULL;
2119 b->source_file = savestring (sal.symtab->filename,
2120 strlen (sal.symtab->filename));
2121 b->section = sal.section;
2122 b->language = current_language->la_language;
2123 b->input_radix = input_radix;
2125 b->line_number = sal.line;
2126 b->enable = enabled;
2129 b->ignore_count = 0;
2133 /* Add this breakpoint to the end of the chain
2134 so that a list of breakpoints will come out in order
2135 of increasing numbers. */
2137 b1 = breakpoint_chain;
2139 breakpoint_chain = b;
2147 check_duplicates (sal.pc, sal.section);
2148 breakpoints_changed ();
2153 #ifdef GET_LONGJMP_TARGET
2156 create_longjmp_breakpoint (func_name)
2159 struct symtab_and_line sal;
2160 struct breakpoint *b;
2162 INIT_SAL (&sal); /* initialize to zeroes */
2163 if (func_name != NULL)
2165 struct minimal_symbol *m;
2167 m = lookup_minimal_symbol_text (func_name, NULL, (struct objfile *)NULL);
2169 sal.pc = SYMBOL_VALUE_ADDRESS (m);
2173 sal.section = find_pc_overlay (sal.pc);
2174 b = set_raw_breakpoint (sal);
2177 b->type = func_name != NULL ? bp_longjmp : bp_longjmp_resume;
2178 b->disposition = donttouch;
2179 b->enable = disabled;
2182 b->addr_string = strsave(func_name);
2183 b->number = internal_breakpoint_number--;
2186 #endif /* #ifdef GET_LONGJMP_TARGET */
2188 /* Call this routine when stepping and nexting to enable a breakpoint if we do
2189 a longjmp(). When we hit that breakpoint, call
2190 set_longjmp_resume_breakpoint() to figure out where we are going. */
2193 enable_longjmp_breakpoint()
2195 register struct breakpoint *b;
2198 if (b->type == bp_longjmp)
2200 b->enable = enabled;
2201 check_duplicates (b->address, b->section);
2206 disable_longjmp_breakpoint()
2208 register struct breakpoint *b;
2211 if ( b->type == bp_longjmp
2212 || b->type == bp_longjmp_resume)
2214 b->enable = disabled;
2215 check_duplicates (b->address, b->section);
2221 remove_solib_event_breakpoints ()
2223 register struct breakpoint *b, *temp;
2225 ALL_BREAKPOINTS_SAFE (b, temp)
2226 if (b->type == bp_shlib_event)
2227 delete_breakpoint (b);
2231 create_solib_event_breakpoint (address)
2234 struct breakpoint *b;
2235 struct symtab_and_line sal;
2237 INIT_SAL (&sal); /* initialize to zeroes */
2239 sal.section = find_pc_overlay (sal.pc);
2240 b = set_raw_breakpoint (sal);
2241 b->number = internal_breakpoint_number--;
2242 b->disposition = donttouch;
2243 b->type = bp_shlib_event;
2246 /* Try to reenable any breakpoints in shared libraries. */
2248 re_enable_breakpoints_in_shlibs ()
2250 struct breakpoint *b;
2253 if (b->enable == shlib_disabled)
2257 /* Do not reenable the breakpoint if the shared library
2258 is still not mapped in. */
2259 if (target_read_memory (b->address, buf, 1) == 0)
2260 b->enable = enabled;
2267 hw_breakpoint_used_count()
2269 register struct breakpoint *b;
2274 if (b->type == bp_hardware_breakpoint && b->enable == enabled)
2282 hw_watchpoint_used_count(type, other_type_used)
2284 int *other_type_used;
2286 register struct breakpoint *b;
2289 *other_type_used = 0;
2292 if (b->enable == enabled)
2294 if (b->type == type) i++;
2295 else if ((b->type == bp_hardware_watchpoint ||
2296 b->type == bp_read_watchpoint ||
2297 b->type == bp_access_watchpoint)
2298 && b->enable == enabled)
2299 *other_type_used = 1;
2305 /* Call this after hitting the longjmp() breakpoint. Use this to set a new
2306 breakpoint at the target of the jmp_buf.
2308 FIXME - This ought to be done by setting a temporary breakpoint that gets
2309 deleted automatically...
2313 set_longjmp_resume_breakpoint(pc, frame)
2315 struct frame_info *frame;
2317 register struct breakpoint *b;
2320 if (b->type == bp_longjmp_resume)
2323 b->enable = enabled;
2325 b->frame = frame->frame;
2328 check_duplicates (b->address, b->section);
2333 /* Set a breakpoint that will evaporate an end of command
2334 at address specified by SAL.
2335 Restrict it to frame FRAME if FRAME is nonzero. */
2338 set_momentary_breakpoint (sal, frame, type)
2339 struct symtab_and_line sal;
2340 struct frame_info *frame;
2343 register struct breakpoint *b;
2344 b = set_raw_breakpoint (sal);
2346 b->enable = enabled;
2347 b->disposition = donttouch;
2348 b->frame = (frame ? frame->frame : 0);
2350 /* If we're debugging a multi-threaded program, then we
2351 want momentary breakpoints to be active in only a
2352 single thread of control. */
2353 if (in_thread_list (inferior_pid))
2354 b->thread = pid_to_thread_id (inferior_pid);
2360 /* Tell the user we have just set a breakpoint B. */
2364 struct breakpoint *b;
2368 /* FIXME: This is misplaced; mention() is called by things (like hitting a
2369 watchpoint) other than breakpoint creation. It should be possible to
2370 clean this up and at the same time replace the random calls to
2371 breakpoint_changed with this hook, as has already been done for
2372 delete_breakpoint_hook and so on. */
2373 if (create_breakpoint_hook)
2374 create_breakpoint_hook (b);
2379 printf_filtered ("Watchpoint %d: ", b->number);
2380 print_expression (b->exp, gdb_stdout);
2382 case bp_hardware_watchpoint:
2383 printf_filtered ("Hardware watchpoint %d: ", b->number);
2384 print_expression (b->exp, gdb_stdout);
2386 case bp_read_watchpoint:
2387 printf_filtered ("Hardware read watchpoint %d: ", b->number);
2388 print_expression (b->exp, gdb_stdout);
2390 case bp_access_watchpoint:
2391 printf_filtered ("Hardware access(read/write) watchpoint %d: ",b->number);
2392 print_expression (b->exp, gdb_stdout);
2395 printf_filtered ("Breakpoint %d", b->number);
2398 case bp_hardware_breakpoint:
2399 printf_filtered ("Hardware assisted breakpoint %d", b->number);
2405 case bp_longjmp_resume:
2406 case bp_step_resume:
2407 case bp_through_sigtramp:
2409 case bp_watchpoint_scope:
2410 case bp_shlib_event:
2415 if (addressprint || b->source_file == NULL)
2417 printf_filtered (" at ");
2418 print_address_numeric (b->address, 1, gdb_stdout);
2421 printf_filtered (": file %s, line %d.",
2422 b->source_file, b->line_number);
2424 printf_filtered ("\n");
2428 /* Set a breakpoint according to ARG (function, linenum or *address)
2429 flag: first bit : 0 non-temporary, 1 temporary.
2430 second bit : 0 normal breakpoint, 1 hardware breakpoint. */
2433 break_command_1 (arg, flag, from_tty)
2437 int tempflag, hardwareflag;
2438 struct symtabs_and_lines sals;
2439 struct symtab_and_line sal;
2440 register struct expression *cond = 0;
2441 register struct breakpoint *b;
2443 /* Pointers in arg to the start, and one past the end, of the condition. */
2444 char *cond_start = NULL;
2445 char *cond_end = NULL;
2446 /* Pointers in arg to the start, and one past the end,
2447 of the address part. */
2448 char *addr_start = NULL;
2449 char *addr_end = NULL;
2450 struct cleanup *old_chain;
2451 struct cleanup *canonical_strings_chain = NULL;
2452 char **canonical = (char **)NULL;
2456 hardwareflag = flag & BP_HARDWAREFLAG;
2457 tempflag = flag & BP_TEMPFLAG;
2462 INIT_SAL (&sal); /* initialize to zeroes */
2464 /* If no arg given, or if first arg is 'if ', use the default breakpoint. */
2466 if (!arg || (arg[0] == 'i' && arg[1] == 'f'
2467 && (arg[2] == ' ' || arg[2] == '\t')))
2469 if (default_breakpoint_valid)
2471 sals.sals = (struct symtab_and_line *)
2472 xmalloc (sizeof (struct symtab_and_line));
2473 sal.pc = default_breakpoint_address;
2474 sal.line = default_breakpoint_line;
2475 sal.symtab = default_breakpoint_symtab;
2476 sal.section = find_pc_overlay (sal.pc);
2481 error ("No default breakpoint address now.");
2487 /* Force almost all breakpoints to be in terms of the
2488 current_source_symtab (which is decode_line_1's default). This
2489 should produce the results we want almost all of the time while
2490 leaving default_breakpoint_* alone. */
2491 if (default_breakpoint_valid
2492 && (!current_source_symtab
2493 || (arg && (*arg == '+' || *arg == '-'))))
2494 sals = decode_line_1 (&arg, 1, default_breakpoint_symtab,
2495 default_breakpoint_line, &canonical);
2497 sals = decode_line_1 (&arg, 1, (struct symtab *)NULL, 0, &canonical);
2505 /* Make sure that all storage allocated in decode_line_1 gets freed in case
2506 the following `for' loop errors out. */
2507 old_chain = make_cleanup (free, sals.sals);
2508 if (canonical != (char **)NULL)
2510 make_cleanup (free, canonical);
2511 canonical_strings_chain = make_cleanup (null_cleanup, 0);
2512 for (i = 0; i < sals.nelts; i++)
2514 if (canonical[i] != NULL)
2515 make_cleanup (free, canonical[i]);
2519 thread = -1; /* No specific thread yet */
2521 /* Resolve all line numbers to PC's, and verify that conditions
2522 can be parsed, before setting any breakpoints. */
2523 for (i = 0; i < sals.nelts; i++)
2525 char *tok, *end_tok;
2528 resolve_sal_pc (&sals.sals[i]);
2534 while (*tok == ' ' || *tok == '\t')
2539 while (*end_tok != ' ' && *end_tok != '\t' && *end_tok != '\000')
2542 toklen = end_tok - tok;
2544 if (toklen >= 1 && strncmp (tok, "if", toklen) == 0)
2546 tok = cond_start = end_tok + 1;
2547 cond = parse_exp_1 (&tok, block_for_pc (sals.sals[i].pc), 0);
2550 else if (toklen >= 1 && strncmp (tok, "thread", toklen) == 0)
2556 thread = strtol (tok, &tok, 0);
2558 error ("Junk after thread keyword.");
2559 if (!valid_thread_id (thread))
2560 error ("Unknown thread %d\n", thread);
2563 error ("Junk at end of arguments.");
2568 int i, target_resources_ok;
2570 i = hw_breakpoint_used_count ();
2571 target_resources_ok = TARGET_CAN_USE_HARDWARE_WATCHPOINT (
2572 bp_hardware_breakpoint, i + sals.nelts, 0);
2573 if (target_resources_ok == 0)
2574 error ("No hardware breakpoint support in the target.");
2575 else if (target_resources_ok < 0)
2576 error ("Hardware breakpoints used exceeds limit.");
2579 /* Remove the canonical strings from the cleanup, they are needed below. */
2580 if (canonical != (char **)NULL)
2581 discard_cleanups (canonical_strings_chain);
2583 /* Now set all the breakpoints. */
2584 for (i = 0; i < sals.nelts; i++)
2589 describe_other_breakpoints (sal.pc, sal.section);
2591 b = set_raw_breakpoint (sal);
2592 set_breakpoint_count (breakpoint_count + 1);
2593 b->number = breakpoint_count;
2594 b->type = hardwareflag ? bp_hardware_breakpoint : bp_breakpoint;
2598 /* If a canonical line spec is needed use that instead of the
2600 if (canonical != (char **)NULL && canonical[i] != NULL)
2601 b->addr_string = canonical[i];
2602 else if (addr_start)
2603 b->addr_string = savestring (addr_start, addr_end - addr_start);
2605 b->cond_string = savestring (cond_start, cond_end - cond_start);
2607 b->enable = enabled;
2608 b->disposition = tempflag ? del : donttouch;
2614 printf_filtered ("Multiple breakpoints were set.\n");
2615 printf_filtered ("Use the \"delete\" command to delete unwanted breakpoints.\n");
2617 do_cleanups (old_chain);
2620 /* Helper function for break_command_1 and disassemble_command. */
2623 resolve_sal_pc (sal)
2624 struct symtab_and_line *sal;
2628 if (sal->pc == 0 && sal->symtab != NULL)
2630 pc = find_line_pc (sal->symtab, sal->line);
2632 error ("No line %d in file \"%s\".",
2633 sal->line, sal->symtab->filename);
2637 if (sal->section == 0 && sal->symtab != NULL)
2639 struct blockvector *bv;
2644 bv = blockvector_for_pc_sect (sal->pc, 0, &index, sal->symtab);
2645 b = BLOCKVECTOR_BLOCK (bv, index);
2646 sym = block_function (b);
2649 fixup_symbol_section (sym, sal->symtab->objfile);
2650 sal->section = SYMBOL_BFD_SECTION (block_function (b));
2656 break_command (arg, from_tty)
2660 break_command_1 (arg, 0, from_tty);
2664 tbreak_command (arg, from_tty)
2668 break_command_1 (arg, BP_TEMPFLAG, from_tty);
2672 hbreak_command (arg, from_tty)
2676 break_command_1 (arg, BP_HARDWAREFLAG, from_tty);
2680 thbreak_command (arg, from_tty)
2684 break_command_1 (arg, (BP_TEMPFLAG | BP_HARDWAREFLAG), from_tty);
2688 /* accessflag: 0: watch write, 1: watch read, 2: watch access(read or write)
2691 watch_command_1 (arg, accessflag, from_tty)
2696 struct breakpoint *b;
2697 struct symtab_and_line sal;
2698 struct expression *exp;
2699 struct block *exp_valid_block;
2700 struct value *val, *mark;
2701 struct frame_info *frame;
2702 struct frame_info *prev_frame = NULL;
2703 char *exp_start = NULL;
2704 char *exp_end = NULL;
2705 char *tok, *end_tok;
2707 char *cond_start = NULL;
2708 char *cond_end = NULL;
2709 struct expression *cond = NULL;
2710 int i, other_type_used, target_resources_ok = 0;
2711 enum bptype bp_type;
2714 INIT_SAL (&sal); /* initialize to zeroes */
2716 /* Parse arguments. */
2717 innermost_block = NULL;
2719 exp = parse_exp_1 (&arg, 0, 0);
2721 exp_valid_block = innermost_block;
2722 mark = value_mark ();
2723 val = evaluate_expression (exp);
2724 release_value (val);
2725 if (VALUE_LAZY (val))
2726 value_fetch_lazy (val);
2729 while (*tok == ' ' || *tok == '\t')
2733 while (*end_tok != ' ' && *end_tok != '\t' && *end_tok != '\000')
2736 toklen = end_tok - tok;
2737 if (toklen >= 1 && strncmp (tok, "if", toklen) == 0)
2739 tok = cond_start = end_tok + 1;
2740 cond = parse_exp_1 (&tok, 0, 0);
2744 error("Junk at end of command.");
2746 if (accessflag == 1) bp_type = bp_read_watchpoint;
2747 else if (accessflag == 2) bp_type = bp_access_watchpoint;
2748 else bp_type = bp_hardware_watchpoint;
2750 mem_cnt = can_use_hardware_watchpoint (val);
2751 if (mem_cnt == 0 && bp_type != bp_hardware_watchpoint)
2752 error ("Expression cannot be implemented with read/access watchpoint.");
2754 i = hw_watchpoint_used_count (bp_type, &other_type_used);
2755 target_resources_ok = TARGET_CAN_USE_HARDWARE_WATCHPOINT(
2756 bp_type, i + mem_cnt, other_type_used);
2757 if (target_resources_ok == 0 && bp_type != bp_hardware_watchpoint)
2758 error ("Target does not have this type of hardware watchpoint support.");
2759 if (target_resources_ok < 0 && bp_type != bp_hardware_watchpoint)
2760 error ("Target resources have been allocated for other types of watchpoints.");
2763 /* Now set up the breakpoint. */
2764 b = set_raw_breakpoint (sal);
2765 set_breakpoint_count (breakpoint_count + 1);
2766 b->number = breakpoint_count;
2767 b->disposition = donttouch;
2769 b->exp_valid_block = exp_valid_block;
2770 b->exp_string = savestring (exp_start, exp_end - exp_start);
2774 b->cond_string = savestring (cond_start, cond_end - cond_start);
2778 frame = block_innermost_frame (exp_valid_block);
2781 prev_frame = get_prev_frame (frame);
2782 b->watchpoint_frame = frame->frame;
2785 b->watchpoint_frame = (CORE_ADDR)0;
2787 if (mem_cnt && target_resources_ok > 0)
2790 b->type = bp_watchpoint;
2792 /* If the expression is "local", then set up a "watchpoint scope"
2793 breakpoint at the point where we've left the scope of the watchpoint
2795 if (innermost_block)
2799 struct breakpoint *scope_breakpoint;
2800 struct symtab_and_line scope_sal;
2802 INIT_SAL (&scope_sal); /* initialize to zeroes */
2803 scope_sal.pc = get_frame_pc (prev_frame);
2804 scope_sal.section = find_pc_overlay (scope_sal.pc);
2806 scope_breakpoint = set_raw_breakpoint (scope_sal);
2807 set_breakpoint_count (breakpoint_count + 1);
2808 scope_breakpoint->number = breakpoint_count;
2810 scope_breakpoint->type = bp_watchpoint_scope;
2811 scope_breakpoint->enable = enabled;
2813 /* Automatically delete the breakpoint when it hits. */
2814 scope_breakpoint->disposition = del;
2816 /* Only break in the proper frame (help with recursion). */
2817 scope_breakpoint->frame = prev_frame->frame;
2819 /* Set the address at which we will stop. */
2820 scope_breakpoint->address = get_frame_pc (prev_frame);
2822 /* The scope breakpoint is related to the watchpoint. We
2823 will need to act on them together. */
2824 b->related_breakpoint = scope_breakpoint;
2827 value_free_to_mark (mark);
2831 /* Return count of locations need to be watched and can be handled
2832 in hardware. If the watchpoint can not be handled
2833 in hardware return zero. */
2836 can_use_hardware_watchpoint (v)
2839 int found_memory_cnt = 0;
2841 /* Make sure all the intermediate values are in memory. Also make sure
2842 we found at least one memory expression. Guards against watch 0x12345,
2843 which is meaningless, but could cause errors if one tries to insert a
2844 hardware watchpoint for the constant expression. */
2845 for ( ; v; v = v->next)
2847 if (v->lval == lval_memory)
2849 if (TYPE_LENGTH (VALUE_TYPE (v)) <= REGISTER_SIZE)
2852 else if (v->lval != not_lval && v->modifiable == 0)
2856 /* The expression itself looks suitable for using a hardware
2857 watchpoint, but give the target machine a chance to reject it. */
2858 return found_memory_cnt;
2861 static void watch_command (arg, from_tty)
2865 watch_command_1 (arg, 0, from_tty);
2868 static void rwatch_command (arg, from_tty)
2872 watch_command_1 (arg, 1, from_tty);
2875 static void awatch_command (arg, from_tty)
2879 watch_command_1 (arg, 2, from_tty);
2883 /* Helper routine for the until_command routine in infcmd.c. Here
2884 because it uses the mechanisms of breakpoints. */
2888 until_break_command (arg, from_tty)
2892 struct symtabs_and_lines sals;
2893 struct symtab_and_line sal;
2894 struct frame_info *prev_frame = get_prev_frame (selected_frame);
2895 struct breakpoint *breakpoint;
2896 struct cleanup *old_chain;
2898 clear_proceed_status ();
2900 /* Set a breakpoint where the user wants it and at return from
2903 if (default_breakpoint_valid)
2904 sals = decode_line_1 (&arg, 1, default_breakpoint_symtab,
2905 default_breakpoint_line, (char ***)NULL);
2907 sals = decode_line_1 (&arg, 1, (struct symtab *)NULL, 0, (char ***)NULL);
2909 if (sals.nelts != 1)
2910 error ("Couldn't get information on specified line.");
2913 free ((PTR)sals.sals); /* malloc'd, so freed */
2916 error ("Junk at end of arguments.");
2918 resolve_sal_pc (&sal);
2920 breakpoint = set_momentary_breakpoint (sal, selected_frame, bp_until);
2922 old_chain = make_cleanup(delete_breakpoint, breakpoint);
2924 /* Keep within the current frame */
2928 sal = find_pc_line (prev_frame->pc, 0);
2929 sal.pc = prev_frame->pc;
2930 breakpoint = set_momentary_breakpoint (sal, prev_frame, bp_until);
2931 make_cleanup(delete_breakpoint, breakpoint);
2934 proceed (-1, TARGET_SIGNAL_DEFAULT, 0);
2935 do_cleanups(old_chain);
2939 /* These aren't used; I don't konw what they were for. */
2940 /* Set a breakpoint at the catch clause for NAME. */
2942 catch_breakpoint (name)
2948 disable_catch_breakpoint ()
2953 delete_catch_breakpoint ()
2958 enable_catch_breakpoint ()
2965 struct sal_chain *next;
2966 struct symtab_and_line sal;
2970 /* This isn't used; I don't know what it was for. */
2971 /* For each catch clause identified in ARGS, run FUNCTION
2972 with that clause as an argument. */
2973 static struct symtabs_and_lines
2974 map_catch_names (args, function)
2978 register char *p = args;
2980 struct symtabs_and_lines sals;
2982 struct sal_chain *sal_chain = 0;
2986 error_no_arg ("one or more catch names");
2994 /* Don't swallow conditional part. */
2995 if (p1[0] == 'i' && p1[1] == 'f'
2996 && (p1[2] == ' ' || p1[2] == '\t'))
3002 while (isalnum (*p1) || *p1 == '_' || *p1 == '$')
3006 if (*p1 && *p1 != ' ' && *p1 != '\t')
3007 error ("Arguments must be catch names.");
3013 struct sal_chain *next = (struct sal_chain *)
3014 alloca (sizeof (struct sal_chain));
3015 next->next = sal_chain;
3016 next->sal = get_catch_sal (p);
3021 printf_unfiltered ("No catch clause for exception %s.\n", p);
3026 while (*p == ' ' || *p == '\t') p++;
3031 /* This shares a lot of code with `print_frame_label_vars' from stack.c. */
3033 static struct symtabs_and_lines
3034 get_catch_sals (this_level_only)
3035 int this_level_only;
3037 register struct blockvector *bl;
3038 register struct block *block;
3039 int index, have_default = 0;
3041 struct symtabs_and_lines sals;
3042 struct sal_chain *sal_chain = 0;
3043 char *blocks_searched;
3045 /* Not sure whether an error message is always the correct response,
3046 but it's better than a core dump. */
3047 if (selected_frame == NULL)
3048 error ("No selected frame.");
3049 block = get_frame_block (selected_frame);
3050 pc = selected_frame->pc;
3056 error ("No symbol table info available.\n");
3058 bl = blockvector_for_pc (BLOCK_END (block) - 4, &index);
3059 blocks_searched = (char *) alloca (BLOCKVECTOR_NBLOCKS (bl) * sizeof (char));
3060 memset (blocks_searched, 0, BLOCKVECTOR_NBLOCKS (bl) * sizeof (char));
3064 CORE_ADDR end = BLOCK_END (block) - 4;
3067 if (bl != blockvector_for_pc (end, &index))
3068 error ("blockvector blotch");
3069 if (BLOCKVECTOR_BLOCK (bl, index) != block)
3070 error ("blockvector botch");
3071 last_index = BLOCKVECTOR_NBLOCKS (bl);
3074 /* Don't print out blocks that have gone by. */
3075 while (index < last_index
3076 && BLOCK_END (BLOCKVECTOR_BLOCK (bl, index)) < pc)
3079 while (index < last_index
3080 && BLOCK_END (BLOCKVECTOR_BLOCK (bl, index)) < end)
3082 if (blocks_searched[index] == 0)
3084 struct block *b = BLOCKVECTOR_BLOCK (bl, index);
3087 register struct symbol *sym;
3089 nsyms = BLOCK_NSYMS (b);
3091 for (i = 0; i < nsyms; i++)
3093 sym = BLOCK_SYM (b, i);
3094 if (STREQ (SYMBOL_NAME (sym), "default"))
3100 if (SYMBOL_CLASS (sym) == LOC_LABEL)
3102 struct sal_chain *next = (struct sal_chain *)
3103 alloca (sizeof (struct sal_chain));
3104 next->next = sal_chain;
3105 next->sal = find_pc_line (SYMBOL_VALUE_ADDRESS (sym), 0);
3109 blocks_searched[index] = 1;
3115 if (sal_chain && this_level_only)
3118 /* After handling the function's top-level block, stop.
3119 Don't continue to its superblock, the block of
3120 per-file symbols. */
3121 if (BLOCK_FUNCTION (block))
3123 block = BLOCK_SUPERBLOCK (block);
3128 struct sal_chain *tmp_chain;
3130 /* Count the number of entries. */
3131 for (index = 0, tmp_chain = sal_chain; tmp_chain;
3132 tmp_chain = tmp_chain->next)
3136 sals.sals = (struct symtab_and_line *)
3137 xmalloc (index * sizeof (struct symtab_and_line));
3138 for (index = 0; sal_chain; sal_chain = sal_chain->next, index++)
3139 sals.sals[index] = sal_chain->sal;
3145 /* Commands to deal with catching exceptions. */
3148 catch_command_1 (arg, tempflag, from_tty)
3153 /* First, translate ARG into something we can deal with in terms
3156 struct symtabs_and_lines sals;
3157 struct symtab_and_line sal;
3158 register struct expression *cond = 0;
3159 register struct breakpoint *b;
3163 INIT_SAL (&sal); /* initialize to zeroes */
3165 /* If no arg given, or if first arg is 'if ', all active catch clauses
3166 are breakpointed. */
3168 if (!arg || (arg[0] == 'i' && arg[1] == 'f'
3169 && (arg[2] == ' ' || arg[2] == '\t')))
3171 /* Grab all active catch clauses. */
3172 sals = get_catch_sals (0);
3176 /* Grab selected catch clauses. */
3177 error ("catch NAME not implemented");
3179 /* This isn't used; I don't know what it was for. */
3180 sals = map_catch_names (arg, catch_breakpoint);
3188 for (i = 0; i < sals.nelts; i++)
3190 resolve_sal_pc (&sals.sals[i]);
3194 if (arg[0] == 'i' && arg[1] == 'f'
3195 && (arg[2] == ' ' || arg[2] == '\t'))
3196 cond = parse_exp_1 ((arg += 2, &arg),
3197 block_for_pc (sals.sals[i].pc), 0);
3199 error ("Junk at end of arguments.");
3204 for (i = 0; i < sals.nelts; i++)
3209 describe_other_breakpoints (sal.pc, sal.section);
3211 b = set_raw_breakpoint (sal);
3212 set_breakpoint_count (breakpoint_count + 1);
3213 b->number = breakpoint_count;
3214 b->type = bp_breakpoint;
3216 b->enable = enabled;
3217 b->disposition = tempflag ? del : donttouch;
3224 printf_unfiltered ("Multiple breakpoints were set.\n");
3225 printf_unfiltered ("Use the \"delete\" command to delete unwanted breakpoints.\n");
3227 free ((PTR)sals.sals);
3230 /* Used by the gui, could be made a worker for other things. */
3233 set_breakpoint_sal (sal)
3234 struct symtab_and_line sal;
3236 struct breakpoint *b;
3237 b = set_raw_breakpoint (sal);
3238 set_breakpoint_count (breakpoint_count + 1);
3239 b->number = breakpoint_count;
3240 b->type = bp_breakpoint;
3247 /* These aren't used; I don't know what they were for. */
3248 /* Disable breakpoints on all catch clauses described in ARGS. */
3250 disable_catch (args)
3253 /* Map the disable command to catch clauses described in ARGS. */
3256 /* Enable breakpoints on all catch clauses described in ARGS. */
3261 /* Map the disable command to catch clauses described in ARGS. */
3264 /* Delete breakpoints on all catch clauses in the active scope. */
3269 /* Map the delete command to catch clauses described in ARGS. */
3274 catch_command (arg, from_tty)
3278 catch_command_1 (arg, 0, from_tty);
3282 clear_command (arg, from_tty)
3286 register struct breakpoint *b, *b1;
3287 struct symtabs_and_lines sals;
3288 struct symtab_and_line sal;
3289 register struct breakpoint *found;
3294 sals = decode_line_spec (arg, 1);
3298 sals.sals = (struct symtab_and_line *)
3299 xmalloc (sizeof (struct symtab_and_line));
3300 INIT_SAL (&sal); /* initialize to zeroes */
3301 sal.line = default_breakpoint_line;
3302 sal.symtab = default_breakpoint_symtab;
3303 if (sal.symtab == 0)
3304 error ("No source file specified.");
3310 for (i = 0; i < sals.nelts; i++)
3312 /* If exact pc given, clear bpts at that pc.
3313 But if sal.pc is zero, clear all bpts on specified line. */
3315 found = (struct breakpoint *) 0;
3317 while (breakpoint_chain
3319 ? (breakpoint_chain->address == sal.pc &&
3320 (overlay_debugging == 0 ||
3321 breakpoint_chain->section == sal.section))
3322 : (breakpoint_chain->source_file != NULL
3323 && sal.symtab != NULL
3324 && STREQ (breakpoint_chain->source_file,
3325 sal.symtab->filename)
3326 && breakpoint_chain->line_number == sal.line)))
3328 b1 = breakpoint_chain;
3329 breakpoint_chain = b1->next;
3336 && b->next->type != bp_watchpoint
3337 && b->next->type != bp_hardware_watchpoint
3338 && b->next->type != bp_read_watchpoint
3339 && b->next->type != bp_access_watchpoint
3341 ? (b->next->address == sal.pc &&
3342 (overlay_debugging == 0 ||
3343 b->next->section == sal.section))
3344 : (b->next->source_file != NULL
3345 && sal.symtab != NULL
3346 && STREQ (b->next->source_file, sal.symtab->filename)
3347 && b->next->line_number == sal.line)))
3358 error ("No breakpoint at %s.", arg);
3360 error ("No breakpoint at this line.");
3363 if (found->next) from_tty = 1; /* Always report if deleted more than one */
3364 if (from_tty) printf_unfiltered ("Deleted breakpoint%s ", found->next ? "s" : "");
3365 breakpoints_changed ();
3368 if (from_tty) printf_unfiltered ("%d ", found->number);
3370 delete_breakpoint (found);
3373 if (from_tty) putchar_unfiltered ('\n');
3375 free ((PTR)sals.sals);
3378 /* Delete breakpoint in BS if they are `delete' breakpoints and
3379 all breakpoints that are marked for deletion, whether hit or not.
3380 This is called after any breakpoint is hit, or after errors. */
3383 breakpoint_auto_delete (bs)
3386 struct breakpoint *b, *temp;
3388 for (; bs; bs = bs->next)
3389 if (bs->breakpoint_at && bs->breakpoint_at->disposition == del
3391 delete_breakpoint (bs->breakpoint_at);
3393 ALL_BREAKPOINTS_SAFE (b, temp)
3395 if (b->disposition == del_at_next_stop)
3396 delete_breakpoint (b);
3400 /* Delete a breakpoint and clean up all traces of it in the data structures. */
3403 delete_breakpoint (bpt)
3404 struct breakpoint *bpt;
3406 register struct breakpoint *b;
3409 if (delete_breakpoint_hook)
3410 delete_breakpoint_hook (bpt);
3413 remove_breakpoint (bpt);
3415 if (breakpoint_chain == bpt)
3416 breakpoint_chain = bpt->next;
3421 b->next = bpt->next;
3425 check_duplicates (bpt->address, bpt->section);
3426 /* If this breakpoint was inserted, and there is another breakpoint
3427 at the same address, we need to insert the other breakpoint. */
3429 && bpt->type != bp_hardware_watchpoint
3430 && bpt->type != bp_read_watchpoint
3431 && bpt->type != bp_access_watchpoint)
3434 if (b->address == bpt->address
3435 && b->section == bpt->section
3437 && b->enable != disabled
3438 && b->enable != shlib_disabled)
3441 val = target_insert_breakpoint (b->address, b->shadow_contents);
3444 target_terminal_ours_for_output ();
3445 fprintf_unfiltered (gdb_stderr, "Cannot insert breakpoint %d:\n", b->number);
3446 memory_error (val, b->address); /* which bombs us out */
3453 free_command_lines (&bpt->commands);
3456 if (bpt->cond_string != NULL)
3457 free (bpt->cond_string);
3458 if (bpt->addr_string != NULL)
3459 free (bpt->addr_string);
3460 if (bpt->exp != NULL)
3462 if (bpt->exp_string != NULL)
3463 free (bpt->exp_string);
3464 if (bpt->val != NULL)
3465 value_free (bpt->val);
3466 if (bpt->source_file != NULL)
3467 free (bpt->source_file);
3469 /* Be sure no bpstat's are pointing at it after it's been freed. */
3470 /* FIXME, how can we find all bpstat's?
3471 We just check stop_bpstat for now. */
3472 for (bs = stop_bpstat; bs; bs = bs->next)
3473 if (bs->breakpoint_at == bpt)
3474 bs->breakpoint_at = NULL;
3479 delete_command (arg, from_tty)
3483 struct breakpoint *b, *temp;
3487 /* Ask user only if there are some breakpoints to delete. */
3489 || (breakpoint_chain && query ("Delete all breakpoints? ")))
3491 /* No arg; clear all breakpoints. */
3492 ALL_BREAKPOINTS_SAFE(b, temp)
3493 /* do not delete call-dummy breakpoint unles explicitly named! */
3494 if (b->type != bp_call_dummy)
3495 delete_breakpoint (b);
3499 map_breakpoint_numbers (arg, delete_breakpoint);
3502 /* Reset a breakpoint given it's struct breakpoint * BINT.
3503 The value we return ends up being the return value from catch_errors.
3504 Unused in this case. */
3507 breakpoint_re_set_one (bint)
3510 struct breakpoint *b = (struct breakpoint *)bint; /* get past catch_errs */
3513 struct symtabs_and_lines sals;
3515 enum enable save_enable;
3520 case bp_hardware_breakpoint:
3521 if (b->addr_string == NULL)
3523 /* Anything without a string can't be re-set. */
3524 delete_breakpoint (b);
3527 /* In case we have a problem, disable this breakpoint. We'll restore
3528 its status if we succeed. */
3529 save_enable = b->enable;
3530 b->enable = disabled;
3532 set_language (b->language);
3533 input_radix = b->input_radix;
3535 sals = decode_line_1 (&s, 1, (struct symtab *)NULL, 0, (char ***)NULL);
3536 for (i = 0; i < sals.nelts; i++)
3538 resolve_sal_pc (&sals.sals[i]);
3540 /* Reparse conditions, they might contain references to the
3542 if (b->cond_string != NULL)
3546 free ((PTR)b->cond);
3547 b->cond = parse_exp_1 (&s, block_for_pc (sals.sals[i].pc), 0);
3550 /* We need to re-set the breakpoint if the address changes...*/
3551 if (b->address != sals.sals[i].pc
3552 /* ...or new and old breakpoints both have source files, and
3553 the source file name or the line number changes... */
3554 || (b->source_file != NULL
3555 && sals.sals[i].symtab != NULL
3556 && (!STREQ (b->source_file, sals.sals[i].symtab->filename)
3557 || b->line_number != sals.sals[i].line)
3559 /* ...or we switch between having a source file and not having
3561 || ((b->source_file == NULL) != (sals.sals[i].symtab == NULL))
3564 if (b->source_file != NULL)
3565 free (b->source_file);
3566 if (sals.sals[i].symtab == NULL)
3567 b->source_file = NULL;
3570 savestring (sals.sals[i].symtab->filename,
3571 strlen (sals.sals[i].symtab->filename));
3572 b->line_number = sals.sals[i].line;
3573 b->address = sals.sals[i].pc;
3574 check_duplicates (b->address, b->section);
3578 /* Might be better to do this just once per breakpoint_re_set,
3579 rather than once for every breakpoint. */
3580 breakpoints_changed ();
3582 b->section = sals.sals[i].section;
3583 b->enable = save_enable; /* Restore it, this worked. */
3585 free ((PTR)sals.sals);
3589 case bp_hardware_watchpoint:
3590 case bp_read_watchpoint:
3591 case bp_access_watchpoint:
3592 innermost_block = NULL;
3593 /* The issue arises of what context to evaluate this in. The same
3594 one as when it was set, but what does that mean when symbols have
3595 been re-read? We could save the filename and functionname, but
3596 if the context is more local than that, the best we could do would
3597 be something like how many levels deep and which index at that
3598 particular level, but that's going to be less stable than filenames
3599 or functionnames. */
3600 /* So for now, just use a global context. */
3603 b->exp = parse_expression (b->exp_string);
3604 b->exp_valid_block = innermost_block;
3605 mark = value_mark ();
3607 value_free (b->val);
3608 b->val = evaluate_expression (b->exp);
3609 release_value (b->val);
3610 if (VALUE_LAZY (b->val))
3611 value_fetch_lazy (b->val);
3613 if (b->cond_string != NULL)
3617 free ((PTR)b->cond);
3618 b->cond = parse_exp_1 (&s, (struct block *)0, 0);
3620 if (b->enable == enabled)
3622 value_free_to_mark (mark);
3626 printf_filtered ("Deleting unknown breakpoint type %d\n", b->type);
3628 /* Delete longjmp breakpoints, they will be reset later by
3629 breakpoint_re_set. */
3631 case bp_longjmp_resume:
3632 delete_breakpoint (b);
3635 /* This breakpoint is special, it's set up when the inferior
3636 starts and we really don't want to touch it. */
3637 case bp_shlib_event:
3639 /* Keep temporary breakpoints, which can be encountered when we step
3640 over a dlopen call and SOLIB_ADD is resetting the breakpoints.
3641 Otherwise these should have been blown away via the cleanup chain
3642 or by breakpoint_init_inferior when we rerun the executable. */
3645 case bp_watchpoint_scope:
3647 case bp_step_resume:
3654 /* Re-set all breakpoints after symbols have been re-loaded. */
3656 breakpoint_re_set ()
3658 struct breakpoint *b, *temp;
3659 enum language save_language;
3660 int save_input_radix;
3661 static char message1[] = "Error in re-setting breakpoint %d:\n";
3662 char message[sizeof (message1) + 30 /* slop */];
3664 save_language = current_language->la_language;
3665 save_input_radix = input_radix;
3666 ALL_BREAKPOINTS_SAFE (b, temp)
3668 sprintf (message, message1, b->number); /* Format possible error msg */
3669 catch_errors (breakpoint_re_set_one, (char *) b, message,
3672 set_language (save_language);
3673 input_radix = save_input_radix;
3675 #ifdef GET_LONGJMP_TARGET
3676 create_longjmp_breakpoint ("longjmp");
3677 create_longjmp_breakpoint ("_longjmp");
3678 create_longjmp_breakpoint ("siglongjmp");
3679 create_longjmp_breakpoint ("_siglongjmp");
3680 create_longjmp_breakpoint (NULL);
3684 /* Took this out (temporarily at least), since it produces an extra
3685 blank line at startup. This messes up the gdbtests. -PB */
3686 /* Blank line to finish off all those mention() messages we just printed. */
3687 printf_filtered ("\n");
3691 /* Set ignore-count of breakpoint number BPTNUM to COUNT.
3692 If from_tty is nonzero, it prints a message to that effect,
3693 which ends with a period (no newline). */
3696 set_ignore_count (bptnum, count, from_tty)
3697 int bptnum, count, from_tty;
3699 register struct breakpoint *b;
3705 if (b->number == bptnum)
3707 b->ignore_count = count;
3710 else if (count == 0)
3711 printf_filtered ("Will stop next time breakpoint %d is reached.",
3713 else if (count == 1)
3714 printf_filtered ("Will ignore next crossing of breakpoint %d.",
3717 printf_filtered ("Will ignore next %d crossings of breakpoint %d.",
3719 breakpoints_changed ();
3723 error ("No breakpoint number %d.", bptnum);
3726 /* Clear the ignore counts of all breakpoints. */
3728 breakpoint_clear_ignore_counts ()
3730 struct breakpoint *b;
3733 b->ignore_count = 0;
3736 /* Command to set ignore-count of breakpoint N to COUNT. */
3739 ignore_command (args, from_tty)
3747 error_no_arg ("a breakpoint number");
3749 num = get_number (&p);
3752 error ("Second argument (specified ignore-count) is missing.");
3754 set_ignore_count (num,
3755 longest_to_int (value_as_long (parse_and_eval (p))),
3757 printf_filtered ("\n");
3758 breakpoints_changed ();
3761 /* Call FUNCTION on each of the breakpoints
3762 whose numbers are given in ARGS. */
3765 map_breakpoint_numbers (args, function)
3767 void (*function) PARAMS ((struct breakpoint *));
3769 register char *p = args;
3772 register struct breakpoint *b;
3775 error_no_arg ("one or more breakpoint numbers");
3781 num = get_number (&p1);
3784 if (b->number == num)
3786 struct breakpoint *related_breakpoint = b->related_breakpoint;
3788 if (related_breakpoint)
3789 function (related_breakpoint);
3792 printf_unfiltered ("No breakpoint number %d.\n", num);
3799 disable_breakpoint (bpt)
3800 struct breakpoint *bpt;
3802 /* Never disable a watchpoint scope breakpoint; we want to
3803 hit them when we leave scope so we can delete both the
3804 watchpoint and its scope breakpoint at that time. */
3805 if (bpt->type == bp_watchpoint_scope)
3808 bpt->enable = disabled;
3810 check_duplicates (bpt->address, bpt->section);
3812 if (modify_breakpoint_hook)
3813 modify_breakpoint_hook (bpt);
3818 disable_command (args, from_tty)
3822 register struct breakpoint *bpt;
3824 ALL_BREAKPOINTS (bpt)
3828 case bp_hardware_breakpoint:
3830 case bp_hardware_watchpoint:
3831 case bp_read_watchpoint:
3832 case bp_access_watchpoint:
3833 disable_breakpoint (bpt);
3838 map_breakpoint_numbers (args, disable_breakpoint);
3842 do_enable_breakpoint (bpt, disposition)
3843 struct breakpoint *bpt;
3844 enum bpdisp disposition;
3846 struct frame_info *save_selected_frame = NULL;
3847 int save_selected_frame_level = -1;
3848 int target_resources_ok, other_type_used;
3851 if (bpt->type == bp_hardware_breakpoint)
3854 i = hw_breakpoint_used_count();
3855 target_resources_ok = TARGET_CAN_USE_HARDWARE_WATCHPOINT(
3856 bp_hardware_breakpoint, i+1, 0);
3857 if (target_resources_ok == 0)
3858 error ("No hardware breakpoint support in the target.");
3859 else if (target_resources_ok < 0)
3860 error ("Hardware breakpoints used exceeds limit.");
3863 bpt->enable = enabled;
3864 bpt->disposition = disposition;
3865 check_duplicates (bpt->address, bpt->section);
3866 breakpoints_changed ();
3868 if (bpt->type == bp_watchpoint || bpt->type == bp_hardware_watchpoint ||
3869 bpt->type == bp_read_watchpoint || bpt->type == bp_access_watchpoint)
3871 if (bpt->exp_valid_block != NULL)
3873 struct frame_info *fr =
3874 find_frame_addr_in_frame_chain (bpt->watchpoint_frame);
3878 Cannot enable watchpoint %d because the block in which its expression\n\
3879 is valid is not currently in scope.\n", bpt->number);
3880 bpt->enable = disabled;
3884 save_selected_frame = selected_frame;
3885 save_selected_frame_level = selected_frame_level;
3886 select_frame (fr, -1);
3889 value_free (bpt->val);
3890 mark = value_mark ();
3891 bpt->val = evaluate_expression (bpt->exp);
3892 release_value (bpt->val);
3893 if (VALUE_LAZY (bpt->val))
3894 value_fetch_lazy (bpt->val);
3896 if (bpt->type == bp_hardware_watchpoint ||
3897 bpt->type == bp_read_watchpoint ||
3898 bpt->type == bp_access_watchpoint)
3900 int i = hw_watchpoint_used_count (bpt->type, &other_type_used);
3901 int mem_cnt = can_use_hardware_watchpoint (bpt->val);
3903 target_resources_ok = TARGET_CAN_USE_HARDWARE_WATCHPOINT(
3904 bpt->type, i + mem_cnt, other_type_used);
3905 /* we can consider of type is bp_hardware_watchpoint, convert to
3906 bp_watchpoint in the following condition */
3907 if (target_resources_ok < 0)
3910 Cannot enable watchpoint %d because target watch resources\n\
3911 have been allocated for other watchpoints.\n", bpt->number);
3912 bpt->enable = disabled;
3913 value_free_to_mark (mark);
3918 if (save_selected_frame_level >= 0)
3919 select_frame (save_selected_frame, save_selected_frame_level);
3920 value_free_to_mark (mark);
3922 if (modify_breakpoint_hook)
3923 modify_breakpoint_hook (bpt);
3927 enable_breakpoint (bpt)
3928 struct breakpoint *bpt;
3930 do_enable_breakpoint (bpt, donttouch);
3933 /* The enable command enables the specified breakpoints (or all defined
3934 breakpoints) so they once again become (or continue to be) effective
3935 in stopping the inferior. */
3939 enable_command (args, from_tty)
3943 register struct breakpoint *bpt;
3945 ALL_BREAKPOINTS (bpt)
3949 case bp_hardware_breakpoint:
3951 case bp_hardware_watchpoint:
3952 case bp_read_watchpoint:
3953 case bp_access_watchpoint:
3954 enable_breakpoint (bpt);
3959 map_breakpoint_numbers (args, enable_breakpoint);
3963 enable_once_breakpoint (bpt)
3964 struct breakpoint *bpt;
3966 do_enable_breakpoint (bpt, disable);
3971 enable_once_command (args, from_tty)
3975 map_breakpoint_numbers (args, enable_once_breakpoint);
3979 enable_delete_breakpoint (bpt)
3980 struct breakpoint *bpt;
3982 do_enable_breakpoint (bpt, del);
3987 enable_delete_command (args, from_tty)
3991 map_breakpoint_numbers (args, enable_delete_breakpoint);
3994 /* Use default_breakpoint_'s, or nothing if they aren't valid. */
3996 struct symtabs_and_lines
3997 decode_line_spec_1 (string, funfirstline)
4001 struct symtabs_and_lines sals;
4003 error ("Empty line specification.");
4004 if (default_breakpoint_valid)
4005 sals = decode_line_1 (&string, funfirstline,
4006 default_breakpoint_symtab, default_breakpoint_line,
4009 sals = decode_line_1 (&string, funfirstline,
4010 (struct symtab *)NULL, 0, (char ***)NULL);
4012 error ("Junk at end of line specification: %s", string);
4017 _initialize_breakpoint ()
4019 breakpoint_chain = 0;
4020 /* Don't bother to call set_breakpoint_count. $bpnum isn't useful
4021 before a breakpoint is set. */
4022 breakpoint_count = 0;
4024 add_com ("ignore", class_breakpoint, ignore_command,
4025 "Set ignore-count of breakpoint number N to COUNT.\n\
4026 Usage is `ignore N COUNT'.");
4028 add_com ("commands", class_breakpoint, commands_command,
4029 "Set commands to be executed when a breakpoint is hit.\n\
4030 Give breakpoint number as argument after \"commands\".\n\
4031 With no argument, the targeted breakpoint is the last one set.\n\
4032 The commands themselves follow starting on the next line.\n\
4033 Type a line containing \"end\" to indicate the end of them.\n\
4034 Give \"silent\" as the first line to make the breakpoint silent;\n\
4035 then no output is printed when it is hit, except what the commands print.");
4037 add_com ("condition", class_breakpoint, condition_command,
4038 "Specify breakpoint number N to break only if COND is true.\n\
4039 Usage is `condition N COND', where N is an integer and COND is an\n\
4040 expression to be evaluated whenever breakpoint N is reached. ");
4042 add_com ("tbreak", class_breakpoint, tbreak_command,
4043 "Set a temporary breakpoint. Args like \"break\" command.\n\
4044 Like \"break\" except the breakpoint is only temporary,\n\
4045 so it will be deleted when hit. Equivalent to \"break\" followed\n\
4046 by using \"enable delete\" on the breakpoint number.");
4048 add_com ("hbreak", class_breakpoint, hbreak_command,
4049 "Set a hardware assisted breakpoint. Args like \"break\" command.\n\
4050 Like \"break\" except the breakpoint requires hardware support,\n\
4051 some target hardware may not have this support.");
4053 add_com ("thbreak", class_breakpoint, thbreak_command,
4054 "Set a temporary hardware assisted breakpoint. Args like \"break\" command.\n\
4055 Like \"hbreak\" except the breakpoint is only temporary,\n\
4056 so it will be deleted when hit.");
4058 add_prefix_cmd ("enable", class_breakpoint, enable_command,
4059 "Enable some breakpoints.\n\
4060 Give breakpoint numbers (separated by spaces) as arguments.\n\
4061 With no subcommand, breakpoints are enabled until you command otherwise.\n\
4062 This is used to cancel the effect of the \"disable\" command.\n\
4063 With a subcommand you can enable temporarily.",
4064 &enablelist, "enable ", 1, &cmdlist);
4066 add_abbrev_prefix_cmd ("breakpoints", class_breakpoint, enable_command,
4067 "Enable some breakpoints.\n\
4068 Give breakpoint numbers (separated by spaces) as arguments.\n\
4069 This is used to cancel the effect of the \"disable\" command.\n\
4070 May be abbreviated to simply \"enable\".\n",
4071 &enablebreaklist, "enable breakpoints ", 1, &enablelist);
4073 add_cmd ("once", no_class, enable_once_command,
4074 "Enable breakpoints for one hit. Give breakpoint numbers.\n\
4075 If a breakpoint is hit while enabled in this fashion, it becomes disabled.",
4078 add_cmd ("delete", no_class, enable_delete_command,
4079 "Enable breakpoints and delete when hit. Give breakpoint numbers.\n\
4080 If a breakpoint is hit while enabled in this fashion, it is deleted.",
4083 add_cmd ("delete", no_class, enable_delete_command,
4084 "Enable breakpoints and delete when hit. Give breakpoint numbers.\n\
4085 If a breakpoint is hit while enabled in this fashion, it is deleted.",
4088 add_cmd ("once", no_class, enable_once_command,
4089 "Enable breakpoints for one hit. Give breakpoint numbers.\n\
4090 If a breakpoint is hit while enabled in this fashion, it becomes disabled.",
4093 add_prefix_cmd ("disable", class_breakpoint, disable_command,
4094 "Disable some breakpoints.\n\
4095 Arguments are breakpoint numbers with spaces in between.\n\
4096 To disable all breakpoints, give no argument.\n\
4097 A disabled breakpoint is not forgotten, but has no effect until reenabled.",
4098 &disablelist, "disable ", 1, &cmdlist);
4099 add_com_alias ("dis", "disable", class_breakpoint, 1);
4100 add_com_alias ("disa", "disable", class_breakpoint, 1);
4102 add_cmd ("breakpoints", class_alias, disable_command,
4103 "Disable some breakpoints.\n\
4104 Arguments are breakpoint numbers with spaces in between.\n\
4105 To disable all breakpoints, give no argument.\n\
4106 A disabled breakpoint is not forgotten, but has no effect until reenabled.\n\
4107 This command may be abbreviated \"disable\".",
4110 add_prefix_cmd ("delete", class_breakpoint, delete_command,
4111 "Delete some breakpoints or auto-display expressions.\n\
4112 Arguments are breakpoint numbers with spaces in between.\n\
4113 To delete all breakpoints, give no argument.\n\
4115 Also a prefix command for deletion of other GDB objects.\n\
4116 The \"unset\" command is also an alias for \"delete\".",
4117 &deletelist, "delete ", 1, &cmdlist);
4118 add_com_alias ("d", "delete", class_breakpoint, 1);
4120 add_cmd ("breakpoints", class_alias, delete_command,
4121 "Delete some breakpoints or auto-display expressions.\n\
4122 Arguments are breakpoint numbers with spaces in between.\n\
4123 To delete all breakpoints, give no argument.\n\
4124 This command may be abbreviated \"delete\".",
4127 add_com ("clear", class_breakpoint, clear_command,
4128 concat ("Clear breakpoint at specified line or function.\n\
4129 Argument may be line number, function name, or \"*\" and an address.\n\
4130 If line number is specified, all breakpoints in that line are cleared.\n\
4131 If function is specified, breakpoints at beginning of function are cleared.\n\
4132 If an address is specified, breakpoints at that address are cleared.\n\n",
4133 "With no argument, clears all breakpoints in the line that the selected frame\n\
4136 See also the \"delete\" command which clears breakpoints by number.", NULL));
4138 add_com ("break", class_breakpoint, break_command,
4139 concat ("Set breakpoint at specified line or function.\n\
4140 Argument may be line number, function name, or \"*\" and an address.\n\
4141 If line number is specified, break at start of code for that line.\n\
4142 If function is specified, break at start of code for that function.\n\
4143 If an address is specified, break at that exact address.\n",
4144 "With no arg, uses current execution address of selected stack frame.\n\
4145 This is useful for breaking on return to a stack frame.\n\
4147 Multiple breakpoints at one place are permitted, and useful if conditional.\n\
4149 Do \"help breakpoints\" for info on other commands dealing with breakpoints.", NULL));
4150 add_com_alias ("b", "break", class_run, 1);
4151 add_com_alias ("br", "break", class_run, 1);
4152 add_com_alias ("bre", "break", class_run, 1);
4153 add_com_alias ("brea", "break", class_run, 1);
4155 add_info ("breakpoints", breakpoints_info,
4156 concat ("Status of user-settable breakpoints, or breakpoint number NUMBER.\n\
4157 The \"Type\" column indicates one of:\n\
4158 \tbreakpoint - normal breakpoint\n\
4159 \twatchpoint - watchpoint\n\
4160 The \"Disp\" column contains one of \"keep\", \"del\", or \"dis\" to indicate\n\
4161 the disposition of the breakpoint after it gets hit. \"dis\" means that the\n\
4162 breakpoint will be disabled. The \"Address\" and \"What\" columns indicate the\n\
4163 address and file/line number respectively.\n\n",
4164 "Convenience variable \"$_\" and default examine address for \"x\"\n\
4165 are set to the address of the last breakpoint listed.\n\n\
4166 Convenience variable \"$bpnum\" contains the number of the last\n\
4167 breakpoint set.", NULL));
4169 #if MAINTENANCE_CMDS
4171 add_cmd ("breakpoints", class_maintenance, maintenance_info_breakpoints,
4172 concat ("Status of all breakpoints, or breakpoint number NUMBER.\n\
4173 The \"Type\" column indicates one of:\n\
4174 \tbreakpoint - normal breakpoint\n\
4175 \twatchpoint - watchpoint\n\
4176 \tlongjmp - internal breakpoint used to step through longjmp()\n\
4177 \tlongjmp resume - internal breakpoint at the target of longjmp()\n\
4178 \tuntil - internal breakpoint used by the \"until\" command\n\
4179 \tfinish - internal breakpoint used by the \"finish\" command\n",
4180 "The \"Disp\" column contains one of \"keep\", \"del\", or \"dis\" to indicate\n\
4181 the disposition of the breakpoint after it gets hit. \"dis\" means that the\n\
4182 breakpoint will be disabled. The \"Address\" and \"What\" columns indicate the\n\
4183 address and file/line number respectively.\n\n",
4184 "Convenience variable \"$_\" and default examine address for \"x\"\n\
4185 are set to the address of the last breakpoint listed.\n\n\
4186 Convenience variable \"$bpnum\" contains the number of the last\n\
4187 breakpoint set.", NULL),
4188 &maintenanceinfolist);
4190 #endif /* MAINTENANCE_CMDS */
4192 add_com ("catch", class_breakpoint, catch_command,
4193 "Set breakpoints to catch exceptions that are raised.\n\
4194 Argument may be a single exception to catch, multiple exceptions\n\
4195 to catch, or the default exception \"default\". If no arguments\n\
4196 are given, breakpoints are set at all exception handlers catch clauses\n\
4197 within the current scope.\n\
4199 A condition specified for the catch applies to all breakpoints set\n\
4200 with this command\n\
4202 Do \"help breakpoints\" for info on other commands dealing with breakpoints.");
4204 add_com ("watch", class_breakpoint, watch_command,
4205 "Set a watchpoint for an expression.\n\
4206 A watchpoint stops execution of your program whenever the value of\n\
4207 an expression changes.");
4209 add_com ("rwatch", class_breakpoint, rwatch_command,
4210 "Set a read watchpoint for an expression.\n\
4211 A watchpoint stops execution of your program whenever the value of\n\
4212 an expression is read.");
4214 add_com ("awatch", class_breakpoint, awatch_command,
4215 "Set a watchpoint for an expression.\n\
4216 A watchpoint stops execution of your program whenever the value of\n\
4217 an expression is either read or written.");
4219 add_info ("watchpoints", breakpoints_info,
4220 "Synonym for ``info breakpoints''.");