1 /* Everything about breakpoints, for GDB.
3 Copyright 1986, 1987, 1988, 1989, 1990, 1991, 1992, 1993, 1994,
4 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005
5 Free Software Foundation, Inc.
7 This file is part of GDB.
9 This program is free software; you can redistribute it and/or modify
10 it under the terms of the GNU General Public License as published by
11 the Free Software Foundation; either version 2 of the License, or
12 (at your option) any later version.
14 This program is distributed in the hope that it will be useful,
15 but WITHOUT ANY WARRANTY; without even the implied warranty of
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 GNU General Public License for more details.
19 You should have received a copy of the GNU General Public License
20 along with this program; if not, write to the Free Software
21 Foundation, Inc., 59 Temple Place - Suite 330,
22 Boston, MA 02111-1307, USA. */
28 #include "breakpoint.h"
30 #include "expression.h"
36 #include "gdbthread.h"
39 #include "gdb_string.h"
46 #include "completer.h"
49 #include "cli/cli-script.h"
50 #include "gdb_assert.h"
55 #include "exceptions.h"
57 #include "gdb-events.h"
58 #include "mi/mi-common.h"
60 /* Prototypes for local functions. */
62 static void until_break_command_continuation (struct continuation_arg *arg);
64 static void catch_command_1 (char *, int, int);
66 static void enable_delete_command (char *, int);
68 static void enable_delete_breakpoint (struct breakpoint *);
70 static void enable_once_command (char *, int);
72 static void enable_once_breakpoint (struct breakpoint *);
74 static void disable_command (char *, int);
76 static void enable_command (char *, int);
78 static void map_breakpoint_numbers (char *, void (*)(struct breakpoint *));
80 static void ignore_command (char *, int);
82 static int breakpoint_re_set_one (void *);
84 static void clear_command (char *, int);
86 static void catch_command (char *, int);
88 static void watch_command (char *, int);
90 static int can_use_hardware_watchpoint (struct value *);
92 static int break_command_1 (char *, int, int, struct breakpoint *);
94 static void mention (struct breakpoint *);
96 struct breakpoint *set_raw_breakpoint (struct symtab_and_line, enum bptype);
98 static void check_duplicates (struct breakpoint *);
100 static void breakpoint_adjustment_warning (CORE_ADDR, CORE_ADDR, int, int);
102 static CORE_ADDR adjust_breakpoint_address (CORE_ADDR bpaddr,
105 static void describe_other_breakpoints (CORE_ADDR, asection *);
107 static void breakpoints_info (char *, int);
109 static void breakpoint_1 (int, int);
111 static bpstat bpstat_alloc (struct breakpoint *, bpstat);
113 static int breakpoint_cond_eval (void *);
115 static void cleanup_executing_breakpoints (void *);
117 static void commands_command (char *, int);
119 static void condition_command (char *, int);
121 static int get_number_trailer (char **, int);
123 void set_breakpoint_count (int);
132 static int remove_breakpoint (struct bp_location *, insertion_state_t);
134 static enum print_stop_action print_it_typical (bpstat);
136 static enum print_stop_action print_bp_stop_message (bpstat bs);
140 enum exception_event_kind kind;
143 args_for_catchpoint_enable;
145 static int watchpoint_check (void *);
147 static int cover_target_enable_exception_callback (void *);
149 static void maintenance_info_breakpoints (char *, int);
151 static void create_longjmp_breakpoint (char *);
153 static void create_overlay_event_breakpoint (char *);
155 static int hw_breakpoint_used_count (void);
157 static int hw_watchpoint_used_count (enum bptype, int *);
159 static void hbreak_command (char *, int);
161 static void thbreak_command (char *, int);
163 static void watch_command_1 (char *, int, int);
165 static void rwatch_command (char *, int);
167 static void awatch_command (char *, int);
169 static void do_enable_breakpoint (struct breakpoint *, enum bpdisp);
171 static void solib_load_unload_1 (char *hookname,
174 char *cond_string, enum bptype bp_kind);
176 static void create_fork_vfork_event_catchpoint (int tempflag,
178 enum bptype bp_kind);
180 static void stop_command (char *arg, int from_tty);
182 static void stopin_command (char *arg, int from_tty);
184 static void stopat_command (char *arg, int from_tty);
186 static char *ep_find_event_name_end (char *arg);
188 static char *ep_parse_optional_if_clause (char **arg);
190 static char *ep_parse_optional_filename (char **arg);
192 static void create_exception_catchpoint (int tempflag, char *cond_string,
193 enum exception_event_kind ex_event,
194 struct symtab_and_line *sal);
196 static void catch_exception_command_1 (enum exception_event_kind ex_event,
197 char *arg, int tempflag, int from_tty);
199 static void tcatch_command (char *arg, int from_tty);
201 static void ep_skip_leading_whitespace (char **s);
203 /* Prototypes for exported functions. */
205 /* If FALSE, gdb will not use hardware support for watchpoints, even
206 if such is available. */
207 static int can_use_hw_watchpoints;
210 show_can_use_hw_watchpoints (struct ui_file *file, int from_tty,
211 struct cmd_list_element *c,
214 fprintf_filtered (file, _("\
215 Debugger's willingness to use watchpoint hardware is %s.\n"),
219 /* If AUTO_BOOLEAN_FALSE, gdb will not attempt to create pending breakpoints.
220 If AUTO_BOOLEAN_TRUE, gdb will automatically create pending breakpoints
221 for unrecognized breakpoint locations.
222 If AUTO_BOOLEAN_AUTO, gdb will query when breakpoints are unrecognized. */
223 static enum auto_boolean pending_break_support;
225 show_pending_break_support (struct ui_file *file, int from_tty,
226 struct cmd_list_element *c,
229 fprintf_filtered (file, _("\
230 Debugger's behavior regarding pending breakpoints is %s.\n"),
234 void _initialize_breakpoint (void);
236 extern int addressprint; /* Print machine addresses? */
238 /* Are we executing breakpoint commands? */
239 static int executing_breakpoint_commands;
241 /* Are overlay event breakpoints enabled? */
242 static int overlay_events_enabled;
244 /* Walk the following statement or block through all breakpoints.
245 ALL_BREAKPOINTS_SAFE does so even if the statment deletes the current
248 #define ALL_BREAKPOINTS(B) for (B = breakpoint_chain; B; B = B->next)
250 #define ALL_BREAKPOINTS_SAFE(B,TMP) \
251 for (B = breakpoint_chain; \
252 B ? (TMP=B->next, 1): 0; \
255 /* Similar iterators for the low-level breakpoints. */
257 #define ALL_BP_LOCATIONS(B) for (B = bp_location_chain; B; B = B->next)
259 #define ALL_BP_LOCATIONS_SAFE(B,TMP) \
260 for (B = bp_location_chain; \
261 B ? (TMP=B->next, 1): 0; \
264 /* True if breakpoint hit counts should be displayed in breakpoint info. */
266 int show_breakpoint_hit_counts = 1;
268 /* Chains of all breakpoints defined. */
270 struct breakpoint *breakpoint_chain;
272 struct bp_location *bp_location_chain;
274 /* Number of last breakpoint made. */
276 int breakpoint_count;
278 /* Pointer to current exception event record */
279 static struct exception_event_record *current_exception_event;
281 /* Indicator of whether exception catchpoints should be nuked between
282 runs of a program. */
283 int deprecated_exception_catchpoints_are_fragile = 0;
285 /* Indicator of when exception catchpoints set-up should be
286 reinitialized -- e.g. when program is re-run. */
287 int deprecated_exception_support_initialized = 0;
289 /* This function returns a pointer to the string representation of the
290 pathname of the dynamically-linked library that has just been
293 This function must be used only when SOLIB_HAVE_LOAD_EVENT is TRUE,
294 or undefined results are guaranteed.
296 This string's contents are only valid immediately after the
297 inferior has stopped in the dynamic linker hook, and becomes
298 invalid as soon as the inferior is continued. Clients should make
299 a copy of this string if they wish to continue the inferior and
300 then access the string. */
302 #ifndef SOLIB_LOADED_LIBRARY_PATHNAME
303 #define SOLIB_LOADED_LIBRARY_PATHNAME(pid) ""
306 /* This function returns a pointer to the string representation of the
307 pathname of the dynamically-linked library that has just been
310 This function must be used only when SOLIB_HAVE_UNLOAD_EVENT is
311 TRUE, or undefined results are guaranteed.
313 This string's contents are only valid immediately after the
314 inferior has stopped in the dynamic linker hook, and becomes
315 invalid as soon as the inferior is continued. Clients should make
316 a copy of this string if they wish to continue the inferior and
317 then access the string. */
319 #ifndef SOLIB_UNLOADED_LIBRARY_PATHNAME
320 #define SOLIB_UNLOADED_LIBRARY_PATHNAME(pid) ""
323 /* This function is called by the "catch load" command. It allows the
324 debugger to be notified by the dynamic linker when a specified
325 library file (or any library file, if filename is NULL) is loaded. */
327 #ifndef SOLIB_CREATE_CATCH_LOAD_HOOK
328 #define SOLIB_CREATE_CATCH_LOAD_HOOK(pid,tempflag,filename,cond_string) \
329 error (_("catch of library loads not yet implemented on this platform"))
332 /* This function is called by the "catch unload" command. It allows
333 the debugger to be notified by the dynamic linker when a specified
334 library file (or any library file, if filename is NULL) is
337 #ifndef SOLIB_CREATE_CATCH_UNLOAD_HOOK
338 #define SOLIB_CREATE_CATCH_UNLOAD_HOOK(pid, tempflag, filename, cond_string) \
339 error (_("catch of library unloads not yet implemented on this platform"))
342 /* Return whether a breakpoint is an active enabled breakpoint. */
344 breakpoint_enabled (struct breakpoint *b)
346 return (b->enable_state == bp_enabled && !b->pending);
349 /* Set breakpoint count to NUM. */
352 set_breakpoint_count (int num)
354 breakpoint_count = num;
355 set_internalvar (lookup_internalvar ("bpnum"),
356 value_from_longest (builtin_type_int, (LONGEST) num));
359 /* Used in run_command to zero the hit count when a new run starts. */
362 clear_breakpoint_hit_counts (void)
364 struct breakpoint *b;
370 /* Default address, symtab and line to put a breakpoint at
371 for "break" command with no arg.
372 if default_breakpoint_valid is zero, the other three are
373 not valid, and "break" with no arg is an error.
375 This set by print_stack_frame, which calls set_default_breakpoint. */
377 int default_breakpoint_valid;
378 CORE_ADDR default_breakpoint_address;
379 struct symtab *default_breakpoint_symtab;
380 int default_breakpoint_line;
382 /* *PP is a string denoting a breakpoint. Get the number of the breakpoint.
383 Advance *PP after the string and any trailing whitespace.
385 Currently the string can either be a number or "$" followed by the name
386 of a convenience variable. Making it an expression wouldn't work well
387 for map_breakpoint_numbers (e.g. "4 + 5 + 6").
389 TRAILER is a character which can be found after the number; most
390 commonly this is `-'. If you don't want a trailer, use \0. */
392 get_number_trailer (char **pp, int trailer)
394 int retval = 0; /* default */
398 /* Empty line means refer to the last breakpoint. */
399 return breakpoint_count;
402 /* Make a copy of the name, so we can null-terminate it
403 to pass to lookup_internalvar(). */
408 while (isalnum (*p) || *p == '_')
410 varname = (char *) alloca (p - start + 1);
411 strncpy (varname, start, p - start);
412 varname[p - start] = '\0';
413 val = value_of_internalvar (lookup_internalvar (varname));
414 if (TYPE_CODE (value_type (val)) == TYPE_CODE_INT)
415 retval = (int) value_as_long (val);
418 printf_filtered (_("Convenience variable must have integer value.\n"));
426 while (*p >= '0' && *p <= '9')
429 /* There is no number here. (e.g. "cond a == b"). */
431 /* Skip non-numeric token */
432 while (*p && !isspace((int) *p))
434 /* Return zero, which caller must interpret as error. */
440 if (!(isspace (*p) || *p == '\0' || *p == trailer))
442 /* Trailing junk: return 0 and let caller print error msg. */
443 while (!(isspace (*p) || *p == '\0' || *p == trailer))
454 /* Like get_number_trailer, but don't allow a trailer. */
456 get_number (char **pp)
458 return get_number_trailer (pp, '\0');
461 /* Parse a number or a range.
462 * A number will be of the form handled by get_number.
463 * A range will be of the form <number1> - <number2>, and
464 * will represent all the integers between number1 and number2,
467 * While processing a range, this fuction is called iteratively;
468 * At each call it will return the next value in the range.
470 * At the beginning of parsing a range, the char pointer PP will
471 * be advanced past <number1> and left pointing at the '-' token.
472 * Subsequent calls will not advance the pointer until the range
473 * is completed. The call that completes the range will advance
474 * pointer PP past <number2>.
478 get_number_or_range (char **pp)
480 static int last_retval, end_value;
481 static char *end_ptr;
482 static int in_range = 0;
486 /* Default case: pp is pointing either to a solo number,
487 or to the first number of a range. */
488 last_retval = get_number_trailer (pp, '-');
493 /* This is the start of a range (<number1> - <number2>).
494 Skip the '-', parse and remember the second number,
495 and also remember the end of the final token. */
499 while (isspace ((int) *end_ptr))
500 end_ptr++; /* skip white space */
501 end_value = get_number (temp);
502 if (end_value < last_retval)
504 error (_("inverted range"));
506 else if (end_value == last_retval)
508 /* degenerate range (number1 == number2). Advance the
509 token pointer so that the range will be treated as a
518 error (_("negative value"));
521 /* pp points to the '-' that betokens a range. All
522 number-parsing has already been done. Return the next
523 integer value (one greater than the saved previous value).
524 Do not advance the token pointer 'pp' until the end of range
527 if (++last_retval == end_value)
529 /* End of range reached; advance token pointer. */
539 /* condition N EXP -- set break condition of breakpoint N to EXP. */
542 condition_command (char *arg, int from_tty)
544 struct breakpoint *b;
549 error_no_arg (_("breakpoint number"));
552 bnum = get_number (&p);
554 error (_("Bad breakpoint argument: '%s'"), arg);
557 if (b->number == bnum)
564 if (b->cond_string != NULL)
565 xfree (b->cond_string);
570 b->cond_string = NULL;
572 printf_filtered (_("Breakpoint %d now unconditional.\n"), bnum);
577 /* I don't know if it matters whether this is the string the user
578 typed in or the decompiled expression. */
579 b->cond_string = savestring (arg, strlen (arg));
582 b->cond = parse_exp_1 (&arg, block_for_pc (b->loc->address), 0);
584 error (_("Junk at end of expression"));
587 breakpoints_changed ();
588 breakpoint_modify_event (b->number);
592 error (_("No breakpoint number %d."), bnum);
596 commands_command (char *arg, int from_tty)
598 struct breakpoint *b;
601 struct command_line *l;
603 /* If we allowed this, we would have problems with when to
604 free the storage, if we change the commands currently
607 if (executing_breakpoint_commands)
608 error (_("Can't use the \"commands\" command among a breakpoint's commands."));
611 bnum = get_number (&p);
614 error (_("Unexpected extra arguments following breakpoint number."));
617 if (b->number == bnum)
619 char *tmpbuf = xstrprintf ("Type commands for when breakpoint %d is hit, one per line.",
621 struct cleanup *cleanups = make_cleanup (xfree, tmpbuf);
622 l = read_command_lines (tmpbuf, from_tty);
623 do_cleanups (cleanups);
624 free_command_lines (&b->commands);
626 breakpoints_changed ();
627 breakpoint_modify_event (b->number);
630 error (_("No breakpoint number %d."), bnum);
633 /* Like target_read_memory() but if breakpoints are inserted, return
634 the shadow contents instead of the breakpoints themselves.
636 Read "memory data" from whatever target or inferior we have.
637 Returns zero if successful, errno value if not. EIO is used
638 for address out of bounds. If breakpoints are inserted, returns
639 shadow contents, not the breakpoints themselves. From breakpoint.c. */
642 deprecated_read_memory_nobpt (CORE_ADDR memaddr, gdb_byte *myaddr,
646 struct bp_location *b;
647 CORE_ADDR bp_addr = 0;
650 if (BREAKPOINT_FROM_PC (&bp_addr, &bp_size) == NULL)
651 /* No breakpoints on this machine. */
652 return target_read_memory (memaddr, myaddr, len);
656 if (b->owner->type == bp_none)
657 warning (_("reading through apparently deleted breakpoint #%d?"),
660 if (b->loc_type != bp_loc_software_breakpoint)
664 /* Addresses and length of the part of the breakpoint that
666 /* XXXX The m68k, sh and h8300 have different local and remote
667 breakpoint values. BREAKPOINT_FROM_PC still manages to
668 correctly determine the breakpoints memory address and size
669 for these targets. */
670 bp_addr = b->address;
672 if (BREAKPOINT_FROM_PC (&bp_addr, &bp_size) == NULL)
677 if (bp_addr + bp_size <= memaddr)
678 /* The breakpoint is entirely before the chunk of memory we
681 if (bp_addr >= memaddr + len)
682 /* The breakpoint is entirely after the chunk of memory we are
685 /* Copy the breakpoint from the shadow contents, and recurse for
686 the things before and after. */
688 /* Offset within shadow_contents. */
691 if (bp_addr < memaddr)
693 /* Only copy the second part of the breakpoint. */
694 bp_size -= memaddr - bp_addr;
695 bptoffset = memaddr - bp_addr;
699 if (bp_addr + bp_size > memaddr + len)
701 /* Only copy the first part of the breakpoint. */
702 bp_size -= (bp_addr + bp_size) - (memaddr + len);
705 memcpy (myaddr + bp_addr - memaddr,
706 b->shadow_contents + bptoffset, bp_size);
708 if (bp_addr > memaddr)
710 /* Copy the section of memory before the breakpoint. */
711 status = deprecated_read_memory_nobpt (memaddr, myaddr, bp_addr - memaddr);
716 if (bp_addr + bp_size < memaddr + len)
718 /* Copy the section of memory after the breakpoint. */
719 status = deprecated_read_memory_nobpt (bp_addr + bp_size,
720 myaddr + bp_addr + bp_size - memaddr,
721 memaddr + len - (bp_addr + bp_size));
728 /* Nothing overlaps. Just call read_memory_noerr. */
729 return target_read_memory (memaddr, myaddr, len);
733 /* A wrapper function for inserting catchpoints. */
735 insert_catchpoint (struct ui_out *uo, void *args)
737 struct breakpoint *b = (struct breakpoint *) args;
743 target_insert_fork_catchpoint (PIDGET (inferior_ptid));
746 target_insert_vfork_catchpoint (PIDGET (inferior_ptid));
749 target_insert_exec_catchpoint (PIDGET (inferior_ptid));
752 internal_error (__FILE__, __LINE__, _("unknown breakpoint type"));
757 /* Helper routine: free the value chain for a breakpoint (watchpoint). */
759 static void free_valchain (struct bp_location *b)
764 /* Free the saved value chain. We will construct a new one
765 the next time the watchpoint is inserted. */
766 for (v = b->owner->val_chain; v; v = n)
771 b->owner->val_chain = NULL;
774 /* Insert a low-level "breakpoint" of some type. BPT is the breakpoint.
775 Any error messages are printed to TMP_ERROR_STREAM; and DISABLED_BREAKS,
776 PROCESS_WARNING, and HW_BREAKPOINT_ERROR are used to report problems.
778 NOTE drow/2003-09-09: This routine could be broken down to an object-style
779 method for each breakpoint or catchpoint type. */
781 insert_bp_location (struct bp_location *bpt,
782 struct ui_file *tmp_error_stream,
783 int *disabled_breaks, int *process_warning,
784 int *hw_breakpoint_error)
788 /* Permanent breakpoints cannot be inserted or removed. Disabled
789 breakpoints should not be inserted. */
790 if (!breakpoint_enabled (bpt->owner))
793 if (bpt->inserted || bpt->duplicate)
796 if (bpt->loc_type == bp_loc_software_breakpoint
797 || bpt->loc_type == bp_loc_hardware_breakpoint)
799 /* First check to see if we have to handle an overlay. */
800 if (overlay_debugging == ovly_off
801 || bpt->section == NULL
802 || !(section_is_overlay (bpt->section)))
804 /* No overlay handling: just set the breakpoint. */
806 if (bpt->loc_type == bp_loc_hardware_breakpoint)
807 val = target_insert_hw_breakpoint (bpt->address,
808 bpt->shadow_contents);
810 val = target_insert_breakpoint (bpt->address,
811 bpt->shadow_contents);
815 /* This breakpoint is in an overlay section.
816 Shall we set a breakpoint at the LMA? */
817 if (!overlay_events_enabled)
819 /* Yes -- overlay event support is not active,
820 so we must try to set a breakpoint at the LMA.
821 This will not work for a hardware breakpoint. */
822 if (bpt->loc_type == bp_loc_hardware_breakpoint)
823 warning (_("hardware breakpoint %d not supported in overlay!"),
827 CORE_ADDR addr = overlay_unmapped_address (bpt->address,
829 /* Set a software (trap) breakpoint at the LMA. */
830 val = target_insert_breakpoint (addr, bpt->shadow_contents);
832 fprintf_unfiltered (tmp_error_stream,
833 "Overlay breakpoint %d failed: in ROM?",
837 /* Shall we set a breakpoint at the VMA? */
838 if (section_is_mapped (bpt->section))
840 /* Yes. This overlay section is mapped into memory. */
841 if (bpt->loc_type == bp_loc_hardware_breakpoint)
842 val = target_insert_hw_breakpoint (bpt->address,
843 bpt->shadow_contents);
845 val = target_insert_breakpoint (bpt->address,
846 bpt->shadow_contents);
850 /* No. This breakpoint will not be inserted.
851 No error, but do not mark the bp as 'inserted'. */
858 /* Can't set the breakpoint. */
860 #if defined (DISABLE_UNSETTABLE_BREAK)
861 DISABLE_UNSETTABLE_BREAK (bpt->address)
863 solib_address (bpt->address)
867 /* See also: disable_breakpoints_in_shlibs. */
869 bpt->owner->enable_state = bp_shlib_disabled;
870 if (!*disabled_breaks)
872 fprintf_unfiltered (tmp_error_stream,
873 "Cannot insert breakpoint %d.\n",
875 fprintf_unfiltered (tmp_error_stream,
876 "Temporarily disabling shared library breakpoints:\n");
878 *disabled_breaks = 1;
879 fprintf_unfiltered (tmp_error_stream,
880 "breakpoint #%d\n", bpt->owner->number);
884 #ifdef ONE_PROCESS_WRITETEXT
885 *process_warning = 1;
887 if (bpt->loc_type == bp_loc_hardware_breakpoint)
889 *hw_breakpoint_error = 1;
890 fprintf_unfiltered (tmp_error_stream,
891 "Cannot insert hardware breakpoint %d.\n",
896 fprintf_unfiltered (tmp_error_stream,
897 "Cannot insert breakpoint %d.\n",
899 fprintf_filtered (tmp_error_stream,
900 "Error accessing memory address ");
901 deprecated_print_address_numeric (bpt->address, 1, tmp_error_stream);
902 fprintf_filtered (tmp_error_stream, ": %s.\n",
903 safe_strerror (val));
914 else if (bpt->loc_type == bp_loc_hardware_watchpoint
915 /* NOTE drow/2003-09-08: This state only exists for removing
916 watchpoints. It's not clear that it's necessary... */
917 && bpt->owner->disposition != disp_del_at_next_stop)
919 /* FIXME drow/2003-09-08: This code sets multiple hardware watchpoints
920 based on the expression. Ideally this should happen at a higher level,
921 and there should be one bp_location for each computed address we
922 must watch. As soon as a many-to-one mapping is available I'll
925 int within_current_scope;
926 struct value *mark = value_mark ();
928 struct frame_id saved_frame_id;
930 /* Save the current frame's ID so we can restore it after
931 evaluating the watchpoint expression on its own frame. */
932 /* FIXME drow/2003-09-09: It would be nice if evaluate_expression
933 took a frame parameter, so that we didn't have to change the
935 saved_frame_id = get_frame_id (deprecated_selected_frame);
937 /* Determine if the watchpoint is within scope. */
938 if (bpt->owner->exp_valid_block == NULL)
939 within_current_scope = 1;
942 struct frame_info *fi;
943 fi = frame_find_by_id (bpt->owner->watchpoint_frame);
944 within_current_scope = (fi != NULL);
945 if (within_current_scope)
949 if (within_current_scope)
953 /* Evaluate the expression and cut the chain of values
954 produced off from the value chain.
956 Make sure the value returned isn't lazy; we use
957 laziness to determine what memory GDB actually needed
958 in order to compute the value of the expression. */
959 v = evaluate_expression (bpt->owner->exp);
961 value_release_to_mark (mark);
963 bpt->owner->val_chain = v;
966 /* Look at each value on the value chain. */
967 for (; v; v = value_next (v))
969 /* If it's a memory location, and GDB actually needed
970 its contents to evaluate the expression, then we
972 if (VALUE_LVAL (v) == lval_memory
975 struct type *vtype = check_typedef (value_type (v));
977 /* We only watch structs and arrays if user asked
978 for it explicitly, never if they just happen to
979 appear in the middle of some value chain. */
980 if (v == bpt->owner->val_chain
981 || (TYPE_CODE (vtype) != TYPE_CODE_STRUCT
982 && TYPE_CODE (vtype) != TYPE_CODE_ARRAY))
987 addr = VALUE_ADDRESS (v) + value_offset (v);
988 len = TYPE_LENGTH (value_type (v));
990 if (bpt->owner->type == bp_read_watchpoint)
992 else if (bpt->owner->type == bp_access_watchpoint)
995 val = target_insert_watchpoint (addr, len, type);
998 /* Don't exit the loop, try to insert
999 every value on the value chain. That's
1000 because we will be removing all the
1001 watches below, and removing a
1002 watchpoint we didn't insert could have
1010 /* Failure to insert a watchpoint on any memory value in the
1011 value chain brings us here. */
1014 remove_breakpoint (bpt, mark_uninserted);
1015 *hw_breakpoint_error = 1;
1016 fprintf_unfiltered (tmp_error_stream,
1017 "Could not insert hardware watchpoint %d.\n",
1018 bpt->owner->number);
1024 printf_filtered (_("\
1025 Hardware watchpoint %d deleted because the program has left the block \n\
1026 in which its expression is valid.\n"),
1027 bpt->owner->number);
1028 if (bpt->owner->related_breakpoint)
1029 bpt->owner->related_breakpoint->disposition = disp_del_at_next_stop;
1030 bpt->owner->disposition = disp_del_at_next_stop;
1033 /* Restore the selected frame. */
1034 select_frame (frame_find_by_id (saved_frame_id));
1039 else if (ep_is_exception_catchpoint (bpt->owner))
1041 /* FIXME drow/2003-09-09: This code sets both a catchpoint and a
1042 breakpoint. Once again, it would be better if this was represented
1043 as two bp_locations. */
1045 /* If we get here, we must have a callback mechanism for exception
1046 events -- with g++ style embedded label support, we insert
1047 ordinary breakpoints and not catchpoints. */
1048 val = target_insert_breakpoint (bpt->address, bpt->shadow_contents);
1051 /* Couldn't set breakpoint for some reason */
1052 fprintf_unfiltered (tmp_error_stream,
1053 "Cannot insert catchpoint %d; disabling it.\n",
1054 bpt->owner->number);
1055 fprintf_filtered (tmp_error_stream,
1056 "Error accessing memory address ");
1057 deprecated_print_address_numeric (bpt->address, 1, tmp_error_stream);
1058 fprintf_filtered (tmp_error_stream, ": %s.\n",
1059 safe_strerror (val));
1060 bpt->owner->enable_state = bp_disabled;
1064 /* Bp set, now make sure callbacks are enabled */
1065 /* Format possible error msg */
1066 char *message = xstrprintf ("Error inserting catchpoint %d:\n",
1067 bpt->owner->number);
1068 struct cleanup *cleanups = make_cleanup (xfree, message);
1070 args_for_catchpoint_enable args;
1071 args.kind = bpt->owner->type == bp_catch_catch ?
1072 EX_EVENT_CATCH : EX_EVENT_THROW;
1074 val = catch_errors (cover_target_enable_exception_callback,
1075 &args, message, RETURN_MASK_ALL);
1076 do_cleanups (cleanups);
1077 if (val != 0 && val != -1)
1080 /* Check if something went wrong; val == 0 can be ignored */
1083 /* something went wrong */
1084 fprintf_unfiltered (tmp_error_stream,
1085 "Cannot insert catchpoint %d; disabling it.\n",
1086 bpt->owner->number);
1087 bpt->owner->enable_state = bp_disabled;
1094 else if (bpt->owner->type == bp_catch_fork
1095 || bpt->owner->type == bp_catch_vfork
1096 || bpt->owner->type == bp_catch_exec)
1098 struct gdb_exception e = catch_exception (uiout, insert_catchpoint,
1099 bpt->owner, RETURN_MASK_ERROR);
1100 exception_fprintf (gdb_stderr, e, "warning: inserting catchpoint %d: ",
1101 bpt->owner->number);
1103 bpt->owner->enable_state = bp_disabled;
1107 /* We've already printed an error message if there was a problem
1108 inserting this catchpoint, and we've disabled the catchpoint,
1109 so just return success. */
1116 /* insert_breakpoints is used when starting or continuing the program.
1117 remove_breakpoints is used when the program stops.
1118 Both return zero if successful,
1119 or an `errno' value if could not write the inferior. */
1122 insert_breakpoints (void)
1124 struct bp_location *b, *temp;
1125 int return_val = 0; /* return success code. */
1127 int disabled_breaks = 0;
1128 int hw_breakpoint_error = 0;
1129 int process_warning = 0;
1131 struct ui_file *tmp_error_stream = mem_fileopen ();
1132 make_cleanup_ui_file_delete (tmp_error_stream);
1134 /* Explicitly mark the warning -- this will only be printed if
1135 there was an error. */
1136 fprintf_unfiltered (tmp_error_stream, "Warning:\n");
1138 ALL_BP_LOCATIONS_SAFE (b, temp)
1140 /* Permanent breakpoints cannot be inserted or removed. Disabled
1141 breakpoints should not be inserted. */
1142 if (!breakpoint_enabled (b->owner))
1145 /* FIXME drow/2003-10-07: This code should be pushed elsewhere when
1146 hardware watchpoints are split into multiple loc breakpoints. */
1147 if ((b->loc_type == bp_loc_hardware_watchpoint
1148 || b->owner->type == bp_watchpoint) && !b->owner->val)
1151 val = evaluate_expression (b->owner->exp);
1152 release_value (val);
1153 if (value_lazy (val))
1154 value_fetch_lazy (val);
1155 b->owner->val = val;
1158 val = insert_bp_location (b, tmp_error_stream,
1159 &disabled_breaks, &process_warning,
1160 &hw_breakpoint_error);
1167 /* If a hardware breakpoint or watchpoint was inserted, add a
1168 message about possibly exhausted resources. */
1169 if (hw_breakpoint_error)
1171 fprintf_unfiltered (tmp_error_stream,
1172 "Could not insert hardware breakpoints:\n\
1173 You may have requested too many hardware breakpoints/watchpoints.\n");
1175 #ifdef ONE_PROCESS_WRITETEXT
1176 if (process_warning)
1177 fprintf_unfiltered (tmp_error_stream,
1178 "The same program may be running in another process.");
1180 target_terminal_ours_for_output ();
1181 error_stream (tmp_error_stream);
1187 remove_breakpoints (void)
1189 struct bp_location *b;
1192 ALL_BP_LOCATIONS (b)
1196 val = remove_breakpoint (b, mark_uninserted);
1205 remove_hw_watchpoints (void)
1207 struct bp_location *b;
1210 ALL_BP_LOCATIONS (b)
1212 if (b->inserted && b->loc_type == bp_loc_hardware_watchpoint)
1214 val = remove_breakpoint (b, mark_uninserted);
1223 reattach_breakpoints (int pid)
1225 struct bp_location *b;
1227 struct cleanup *old_chain = save_inferior_ptid ();
1229 /* Set inferior_ptid; remove_breakpoint uses this global. */
1230 inferior_ptid = pid_to_ptid (pid);
1231 ALL_BP_LOCATIONS (b)
1235 remove_breakpoint (b, mark_inserted);
1236 if (b->loc_type == bp_loc_hardware_breakpoint)
1237 val = target_insert_hw_breakpoint (b->address, b->shadow_contents);
1239 val = target_insert_breakpoint (b->address, b->shadow_contents);
1240 /* FIXME drow/2003-10-07: This doesn't handle any other kinds of
1241 breakpoints. It's wrong for watchpoints, for example. */
1244 do_cleanups (old_chain);
1249 do_cleanups (old_chain);
1254 update_breakpoints_after_exec (void)
1256 struct breakpoint *b;
1257 struct breakpoint *temp;
1259 /* Doing this first prevents the badness of having delete_breakpoint()
1260 write a breakpoint's current "shadow contents" to lift the bp. That
1261 shadow is NOT valid after an exec()! */
1262 mark_breakpoints_out ();
1264 ALL_BREAKPOINTS_SAFE (b, temp)
1266 /* Solib breakpoints must be explicitly reset after an exec(). */
1267 if (b->type == bp_shlib_event)
1269 delete_breakpoint (b);
1273 /* Thread event breakpoints must be set anew after an exec(),
1274 as must overlay event breakpoints. */
1275 if (b->type == bp_thread_event || b->type == bp_overlay_event)
1277 delete_breakpoint (b);
1281 /* Step-resume breakpoints are meaningless after an exec(). */
1282 if (b->type == bp_step_resume)
1284 delete_breakpoint (b);
1288 /* Ditto the sigtramp handler breakpoints. */
1289 if (b->type == bp_through_sigtramp)
1291 delete_breakpoint (b);
1295 /* Ditto the exception-handling catchpoints. */
1296 if ((b->type == bp_catch_catch) || (b->type == bp_catch_throw))
1298 delete_breakpoint (b);
1302 /* Don't delete an exec catchpoint, because else the inferior
1303 won't stop when it ought!
1305 Similarly, we probably ought to keep vfork catchpoints, 'cause
1306 on this target, we may not be able to stop when the vfork is
1307 seen, but only when the subsequent exec is seen. (And because
1308 deleting fork catchpoints here but not vfork catchpoints will
1309 seem mysterious to users, keep those too.)
1311 ??rehrauer: Let's hope that merely clearing out this catchpoint's
1312 target address field, if any, is sufficient to have it be reset
1313 automagically. Certainly on HP-UX that's true.
1315 Jim Blandy <jimb@redhat.com>: Actually, zero is a perfectly
1316 valid code address on some platforms (like the mn10300
1317 simulators). We shouldn't assign any special interpretation to
1318 a breakpoint with a zero address. And in fact, GDB doesn't ---
1319 I can't see what that comment above is talking about. As far
1320 as I can tell, setting the address of a
1321 bp_catch_exec/bp_catch_vfork/bp_catch_fork breakpoint to zero
1322 is meaningless, since those are implemented with HP-UX kernel
1323 hackery, not by storing breakpoint instructions somewhere. */
1324 if ((b->type == bp_catch_exec) ||
1325 (b->type == bp_catch_vfork) ||
1326 (b->type == bp_catch_fork))
1328 b->loc->address = (CORE_ADDR) NULL;
1332 /* bp_finish is a special case. The only way we ought to be able
1333 to see one of these when an exec() has happened, is if the user
1334 caught a vfork, and then said "finish". Ordinarily a finish just
1335 carries them to the call-site of the current callee, by setting
1336 a temporary bp there and resuming. But in this case, the finish
1337 will carry them entirely through the vfork & exec.
1339 We don't want to allow a bp_finish to remain inserted now. But
1340 we can't safely delete it, 'cause finish_command has a handle to
1341 the bp on a bpstat, and will later want to delete it. There's a
1342 chance (and I've seen it happen) that if we delete the bp_finish
1343 here, that its storage will get reused by the time finish_command
1344 gets 'round to deleting the "use to be a bp_finish" breakpoint.
1345 We really must allow finish_command to delete a bp_finish.
1347 In the absense of a general solution for the "how do we know
1348 it's safe to delete something others may have handles to?"
1349 problem, what we'll do here is just uninsert the bp_finish, and
1350 let finish_command delete it.
1352 (We know the bp_finish is "doomed" in the sense that it's
1353 momentary, and will be deleted as soon as finish_command sees
1354 the inferior stopped. So it doesn't matter that the bp's
1355 address is probably bogus in the new a.out, unlike e.g., the
1356 solib breakpoints.) */
1358 if (b->type == bp_finish)
1363 /* Without a symbolic address, we have little hope of the
1364 pre-exec() address meaning the same thing in the post-exec()
1366 if (b->addr_string == NULL)
1368 delete_breakpoint (b);
1372 /* If this breakpoint has survived the above battery of checks, then
1373 it must have a symbolic address. Be sure that it gets reevaluated
1374 to a target address, rather than reusing the old evaluation.
1376 Jim Blandy <jimb@redhat.com>: As explained above in the comment
1377 for bp_catch_exec and friends, I'm pretty sure this is entirely
1378 unnecessary. A call to breakpoint_re_set_one always recomputes
1379 the breakpoint's address from scratch, or deletes it if it can't.
1380 So I think this assignment could be deleted without effect. */
1381 b->loc->address = (CORE_ADDR) NULL;
1383 /* FIXME what about longjmp breakpoints? Re-create them here? */
1384 create_overlay_event_breakpoint ("_ovly_debug_event");
1388 detach_breakpoints (int pid)
1390 struct bp_location *b;
1392 struct cleanup *old_chain = save_inferior_ptid ();
1394 if (pid == PIDGET (inferior_ptid))
1395 error (_("Cannot detach breakpoints of inferior_ptid"));
1397 /* Set inferior_ptid; remove_breakpoint uses this global. */
1398 inferior_ptid = pid_to_ptid (pid);
1399 ALL_BP_LOCATIONS (b)
1403 val = remove_breakpoint (b, mark_inserted);
1406 do_cleanups (old_chain);
1411 do_cleanups (old_chain);
1416 remove_breakpoint (struct bp_location *b, insertion_state_t is)
1420 if (b->owner->enable_state == bp_permanent)
1421 /* Permanent breakpoints cannot be inserted or removed. */
1424 if (b->owner->type == bp_none)
1425 warning (_("attempted to remove apparently deleted breakpoint #%d?"),
1428 if (b->loc_type == bp_loc_software_breakpoint
1429 || b->loc_type == bp_loc_hardware_breakpoint)
1431 /* "Normal" instruction breakpoint: either the standard
1432 trap-instruction bp (bp_breakpoint), or a
1433 bp_hardware_breakpoint. */
1435 /* First check to see if we have to handle an overlay. */
1436 if (overlay_debugging == ovly_off
1437 || b->section == NULL
1438 || !(section_is_overlay (b->section)))
1440 /* No overlay handling: just remove the breakpoint. */
1442 if (b->loc_type == bp_loc_hardware_breakpoint)
1443 val = target_remove_hw_breakpoint (b->address,
1444 b->shadow_contents);
1446 val = target_remove_breakpoint (b->address, b->shadow_contents);
1450 /* This breakpoint is in an overlay section.
1451 Did we set a breakpoint at the LMA? */
1452 if (!overlay_events_enabled)
1454 /* Yes -- overlay event support is not active, so we
1455 should have set a breakpoint at the LMA. Remove it.
1457 CORE_ADDR addr = overlay_unmapped_address (b->address,
1459 /* Ignore any failures: if the LMA is in ROM, we will
1460 have already warned when we failed to insert it. */
1461 if (b->loc_type == bp_loc_hardware_breakpoint)
1462 target_remove_hw_breakpoint (addr, b->shadow_contents);
1464 target_remove_breakpoint (addr, b->shadow_contents);
1466 /* Did we set a breakpoint at the VMA?
1467 If so, we will have marked the breakpoint 'inserted'. */
1470 /* Yes -- remove it. Previously we did not bother to
1471 remove the breakpoint if the section had been
1472 unmapped, but let's not rely on that being safe. We
1473 don't know what the overlay manager might do. */
1474 if (b->loc_type == bp_loc_hardware_breakpoint)
1475 val = target_remove_hw_breakpoint (b->address,
1476 b->shadow_contents);
1478 val = target_remove_breakpoint (b->address,
1479 b->shadow_contents);
1483 /* No -- not inserted, so no need to remove. No error. */
1489 b->inserted = (is == mark_inserted);
1491 else if (b->loc_type == bp_loc_hardware_watchpoint
1492 && breakpoint_enabled (b->owner)
1498 b->inserted = (is == mark_inserted);
1499 /* Walk down the saved value chain. */
1500 for (v = b->owner->val_chain; v; v = value_next (v))
1502 /* For each memory reference remove the watchpoint
1504 if (VALUE_LVAL (v) == lval_memory
1505 && ! value_lazy (v))
1507 struct type *vtype = check_typedef (value_type (v));
1509 if (v == b->owner->val_chain
1510 || (TYPE_CODE (vtype) != TYPE_CODE_STRUCT
1511 && TYPE_CODE (vtype) != TYPE_CODE_ARRAY))
1516 addr = VALUE_ADDRESS (v) + value_offset (v);
1517 len = TYPE_LENGTH (value_type (v));
1519 if (b->owner->type == bp_read_watchpoint)
1521 else if (b->owner->type == bp_access_watchpoint)
1524 val = target_remove_watchpoint (addr, len, type);
1531 /* Failure to remove any of the hardware watchpoints comes here. */
1532 if ((is == mark_uninserted) && (b->inserted))
1533 warning (_("Could not remove hardware watchpoint %d."),
1536 else if ((b->owner->type == bp_catch_fork ||
1537 b->owner->type == bp_catch_vfork ||
1538 b->owner->type == bp_catch_exec)
1539 && breakpoint_enabled (b->owner)
1543 switch (b->owner->type)
1546 val = target_remove_fork_catchpoint (PIDGET (inferior_ptid));
1548 case bp_catch_vfork:
1549 val = target_remove_vfork_catchpoint (PIDGET (inferior_ptid));
1552 val = target_remove_exec_catchpoint (PIDGET (inferior_ptid));
1555 warning (_("Internal error, %s line %d."), __FILE__, __LINE__);
1560 b->inserted = (is == mark_inserted);
1562 else if ((b->owner->type == bp_catch_catch ||
1563 b->owner->type == bp_catch_throw)
1564 && breakpoint_enabled (b->owner)
1568 val = target_remove_breakpoint (b->address, b->shadow_contents);
1571 b->inserted = (is == mark_inserted);
1573 else if (ep_is_exception_catchpoint (b->owner)
1574 && b->inserted /* sometimes previous insert doesn't happen */
1575 && breakpoint_enabled (b->owner)
1579 val = target_remove_breakpoint (b->address, b->shadow_contents);
1583 b->inserted = (is == mark_inserted);
1589 /* Clear the "inserted" flag in all breakpoints. */
1592 mark_breakpoints_out (void)
1594 struct bp_location *bpt;
1596 ALL_BP_LOCATIONS (bpt)
1600 /* Clear the "inserted" flag in all breakpoints and delete any
1601 breakpoints which should go away between runs of the program.
1603 Plus other such housekeeping that has to be done for breakpoints
1606 Note: this function gets called at the end of a run (by
1607 generic_mourn_inferior) and when a run begins (by
1608 init_wait_for_inferior). */
1613 breakpoint_init_inferior (enum inf_context context)
1615 struct breakpoint *b, *temp;
1616 struct bp_location *bpt;
1617 static int warning_needed = 0;
1619 ALL_BP_LOCATIONS (bpt)
1622 ALL_BREAKPOINTS_SAFE (b, temp)
1627 case bp_watchpoint_scope:
1629 /* If the call dummy breakpoint is at the entry point it will
1630 cause problems when the inferior is rerun, so we better
1633 Also get rid of scope breakpoints. */
1634 delete_breakpoint (b);
1638 case bp_hardware_watchpoint:
1639 case bp_read_watchpoint:
1640 case bp_access_watchpoint:
1642 /* Likewise for watchpoints on local expressions. */
1643 if (b->exp_valid_block != NULL)
1644 delete_breakpoint (b);
1645 if (context == inf_starting)
1647 /* Reset val field to force reread of starting value
1648 in insert_breakpoints. */
1650 value_free (b->val);
1655 /* Likewise for exception catchpoints in dynamic-linked
1656 executables where required */
1657 if (ep_is_exception_catchpoint (b)
1658 && deprecated_exception_catchpoints_are_fragile)
1661 delete_breakpoint (b);
1667 if (deprecated_exception_catchpoints_are_fragile)
1668 deprecated_exception_support_initialized = 0;
1670 /* Don't issue the warning unless it's really needed... */
1671 if (warning_needed && (context != inf_exited))
1673 warning (_("Exception catchpoints from last run were deleted.\n"
1674 "You must reinsert them explicitly."));
1679 /* breakpoint_here_p (PC) returns non-zero if an enabled breakpoint
1680 exists at PC. It returns ordinary_breakpoint_here if it's an
1681 ordinary breakpoint, or permanent_breakpoint_here if it's a
1682 permanent breakpoint.
1683 - When continuing from a location with an ordinary breakpoint, we
1684 actually single step once before calling insert_breakpoints.
1685 - When continuing from a localion with a permanent breakpoint, we
1686 need to use the `SKIP_PERMANENT_BREAKPOINT' macro, provided by
1687 the target, to advance the PC past the breakpoint. */
1689 enum breakpoint_here
1690 breakpoint_here_p (CORE_ADDR pc)
1692 struct bp_location *bpt;
1693 int any_breakpoint_here = 0;
1695 ALL_BP_LOCATIONS (bpt)
1697 if (bpt->loc_type != bp_loc_software_breakpoint
1698 && bpt->loc_type != bp_loc_hardware_breakpoint)
1701 if ((breakpoint_enabled (bpt->owner)
1702 || bpt->owner->enable_state == bp_permanent)
1703 && bpt->address == pc) /* bp is enabled and matches pc */
1705 if (overlay_debugging
1706 && section_is_overlay (bpt->section)
1707 && !section_is_mapped (bpt->section))
1708 continue; /* unmapped overlay -- can't be a match */
1709 else if (bpt->owner->enable_state == bp_permanent)
1710 return permanent_breakpoint_here;
1712 any_breakpoint_here = 1;
1716 return any_breakpoint_here ? ordinary_breakpoint_here : 0;
1720 /* breakpoint_inserted_here_p (PC) is just like breakpoint_here_p(),
1721 but it only returns true if there is actually a breakpoint inserted
1725 breakpoint_inserted_here_p (CORE_ADDR pc)
1727 struct bp_location *bpt;
1729 ALL_BP_LOCATIONS (bpt)
1731 if (bpt->loc_type != bp_loc_software_breakpoint
1732 && bpt->loc_type != bp_loc_hardware_breakpoint)
1736 && bpt->address == pc) /* bp is inserted and matches pc */
1738 if (overlay_debugging
1739 && section_is_overlay (bpt->section)
1740 && !section_is_mapped (bpt->section))
1741 continue; /* unmapped overlay -- can't be a match */
1750 /* This function returns non-zero iff there is a software breakpoint
1754 software_breakpoint_inserted_here_p (CORE_ADDR pc)
1756 struct bp_location *bpt;
1757 int any_breakpoint_here = 0;
1759 ALL_BP_LOCATIONS (bpt)
1761 if (bpt->loc_type != bp_loc_software_breakpoint)
1764 if ((breakpoint_enabled (bpt->owner)
1765 || bpt->owner->enable_state == bp_permanent)
1767 && bpt->address == pc) /* bp is enabled and matches pc */
1769 if (overlay_debugging
1770 && section_is_overlay (bpt->section)
1771 && !section_is_mapped (bpt->section))
1772 continue; /* unmapped overlay -- can't be a match */
1781 /* breakpoint_thread_match (PC, PTID) returns true if the breakpoint at
1782 PC is valid for process/thread PTID. */
1785 breakpoint_thread_match (CORE_ADDR pc, ptid_t ptid)
1787 struct bp_location *bpt;
1790 thread = pid_to_thread_id (ptid);
1792 ALL_BP_LOCATIONS (bpt)
1794 if (bpt->loc_type != bp_loc_software_breakpoint
1795 && bpt->loc_type != bp_loc_hardware_breakpoint)
1798 if ((breakpoint_enabled (bpt->owner)
1799 || bpt->owner->enable_state == bp_permanent)
1800 && bpt->address == pc
1801 && (bpt->owner->thread == -1 || bpt->owner->thread == thread))
1803 if (overlay_debugging
1804 && section_is_overlay (bpt->section)
1805 && !section_is_mapped (bpt->section))
1806 continue; /* unmapped overlay -- can't be a match */
1816 /* bpstat stuff. External routines' interfaces are documented
1820 ep_is_catchpoint (struct breakpoint *ep)
1823 (ep->type == bp_catch_load)
1824 || (ep->type == bp_catch_unload)
1825 || (ep->type == bp_catch_fork)
1826 || (ep->type == bp_catch_vfork)
1827 || (ep->type == bp_catch_exec)
1828 || (ep->type == bp_catch_catch)
1829 || (ep->type == bp_catch_throw);
1831 /* ??rehrauer: Add more kinds here, as are implemented... */
1835 ep_is_shlib_catchpoint (struct breakpoint *ep)
1838 (ep->type == bp_catch_load)
1839 || (ep->type == bp_catch_unload);
1843 ep_is_exception_catchpoint (struct breakpoint *ep)
1846 (ep->type == bp_catch_catch)
1847 || (ep->type == bp_catch_throw);
1850 /* Clear a bpstat so that it says we are not at any breakpoint.
1851 Also free any storage that is part of a bpstat. */
1854 bpstat_clear (bpstat *bsp)
1865 if (p->old_val != NULL)
1866 value_free (p->old_val);
1867 free_command_lines (&p->commands);
1874 /* Return a copy of a bpstat. Like "bs1 = bs2" but all storage that
1875 is part of the bpstat is copied as well. */
1878 bpstat_copy (bpstat bs)
1882 bpstat retval = NULL;
1887 for (; bs != NULL; bs = bs->next)
1889 tmp = (bpstat) xmalloc (sizeof (*tmp));
1890 memcpy (tmp, bs, sizeof (*tmp));
1891 if (bs->commands != NULL)
1892 tmp->commands = copy_command_lines (bs->commands);
1893 if (bs->old_val != NULL)
1894 tmp->old_val = value_copy (bs->old_val);
1897 /* This is the first thing in the chain. */
1907 /* Find the bpstat associated with this breakpoint */
1910 bpstat_find_breakpoint (bpstat bsp, struct breakpoint *breakpoint)
1915 for (; bsp != NULL; bsp = bsp->next)
1917 if (bsp->breakpoint_at == breakpoint)
1923 /* Find a step_resume breakpoint associated with this bpstat.
1924 (If there are multiple step_resume bp's on the list, this function
1925 will arbitrarily pick one.)
1927 It is an error to use this function if BPSTAT doesn't contain a
1928 step_resume breakpoint.
1930 See wait_for_inferior's use of this function. */
1932 bpstat_find_step_resume_breakpoint (bpstat bsp)
1936 gdb_assert (bsp != NULL);
1938 current_thread = pid_to_thread_id (inferior_ptid);
1940 for (; bsp != NULL; bsp = bsp->next)
1942 if ((bsp->breakpoint_at != NULL) &&
1943 (bsp->breakpoint_at->type == bp_step_resume) &&
1944 (bsp->breakpoint_at->thread == current_thread ||
1945 bsp->breakpoint_at->thread == -1))
1946 return bsp->breakpoint_at;
1949 internal_error (__FILE__, __LINE__, _("No step_resume breakpoint found."));
1953 /* Return the breakpoint number of the first breakpoint we are stopped
1954 at. *BSP upon return is a bpstat which points to the remaining
1955 breakpoints stopped at (but which is not guaranteed to be good for
1956 anything but further calls to bpstat_num).
1957 Return 0 if passed a bpstat which does not indicate any breakpoints. */
1960 bpstat_num (bpstat *bsp)
1962 struct breakpoint *b;
1965 return 0; /* No more breakpoint values */
1968 b = (*bsp)->breakpoint_at;
1969 *bsp = (*bsp)->next;
1971 return -1; /* breakpoint that's been deleted since */
1973 return b->number; /* We have its number */
1977 /* Modify BS so that the actions will not be performed. */
1980 bpstat_clear_actions (bpstat bs)
1982 for (; bs != NULL; bs = bs->next)
1984 free_command_lines (&bs->commands);
1985 if (bs->old_val != NULL)
1987 value_free (bs->old_val);
1993 /* Stub for cleaning up our state if we error-out of a breakpoint command */
1995 cleanup_executing_breakpoints (void *ignore)
1997 executing_breakpoint_commands = 0;
2000 /* Execute all the commands associated with all the breakpoints at this
2001 location. Any of these commands could cause the process to proceed
2002 beyond this point, etc. We look out for such changes by checking
2003 the global "breakpoint_proceeded" after each command. */
2006 bpstat_do_actions (bpstat *bsp)
2009 struct cleanup *old_chain;
2011 /* Avoid endless recursion if a `source' command is contained
2013 if (executing_breakpoint_commands)
2016 executing_breakpoint_commands = 1;
2017 old_chain = make_cleanup (cleanup_executing_breakpoints, 0);
2020 /* Note that (as of this writing), our callers all appear to
2021 be passing us the address of global stop_bpstat. And, if
2022 our calls to execute_control_command cause the inferior to
2023 proceed, that global (and hence, *bsp) will change.
2025 We must be careful to not touch *bsp unless the inferior
2026 has not proceeded. */
2028 /* This pointer will iterate over the list of bpstat's. */
2031 breakpoint_proceeded = 0;
2032 for (; bs != NULL; bs = bs->next)
2034 struct command_line *cmd;
2035 struct cleanup *this_cmd_tree_chain;
2037 /* Take ownership of the BSP's command tree, if it has one.
2039 The command tree could legitimately contain commands like
2040 'step' and 'next', which call clear_proceed_status, which
2041 frees stop_bpstat's command tree. To make sure this doesn't
2042 free the tree we're executing out from under us, we need to
2043 take ownership of the tree ourselves. Since a given bpstat's
2044 commands are only executed once, we don't need to copy it; we
2045 can clear the pointer in the bpstat, and make sure we free
2046 the tree when we're done. */
2049 this_cmd_tree_chain = make_cleanup_free_command_lines (&cmd);
2053 execute_control_command (cmd);
2055 if (breakpoint_proceeded)
2061 /* We can free this command tree now. */
2062 do_cleanups (this_cmd_tree_chain);
2064 if (breakpoint_proceeded)
2065 /* The inferior is proceeded by the command; bomb out now.
2066 The bpstat chain has been blown away by wait_for_inferior.
2067 But since execution has stopped again, there is a new bpstat
2068 to look at, so start over. */
2071 do_cleanups (old_chain);
2074 /* This is the normal print function for a bpstat. In the future,
2075 much of this logic could (should?) be moved to bpstat_stop_status,
2076 by having it set different print_it values.
2078 Current scheme: When we stop, bpstat_print() is called. It loops
2079 through the bpstat list of things causing this stop, calling the
2080 print_bp_stop_message function on each one. The behavior of the
2081 print_bp_stop_message function depends on the print_it field of
2082 bpstat. If such field so indicates, call this function here.
2084 Return values from this routine (ultimately used by bpstat_print()
2085 and normal_stop() to decide what to do):
2086 PRINT_NOTHING: Means we already printed all we needed to print,
2087 don't print anything else.
2088 PRINT_SRC_ONLY: Means we printed something, and we do *not* desire
2089 that something to be followed by a location.
2090 PRINT_SCR_AND_LOC: Means we printed something, and we *do* desire
2091 that something to be followed by a location.
2092 PRINT_UNKNOWN: Means we printed nothing or we need to do some more
2095 static enum print_stop_action
2096 print_it_typical (bpstat bs)
2098 struct cleanup *old_chain, *ui_out_chain;
2099 struct ui_stream *stb;
2100 stb = ui_out_stream_new (uiout);
2101 old_chain = make_cleanup_ui_out_stream_delete (stb);
2102 /* bs->breakpoint_at can be NULL if it was a momentary breakpoint
2103 which has since been deleted. */
2104 if (bs->breakpoint_at == NULL)
2105 return PRINT_UNKNOWN;
2107 switch (bs->breakpoint_at->type)
2110 case bp_hardware_breakpoint:
2111 if (bs->breakpoint_at->loc->address != bs->breakpoint_at->loc->requested_address)
2112 breakpoint_adjustment_warning (bs->breakpoint_at->loc->requested_address,
2113 bs->breakpoint_at->loc->address,
2114 bs->breakpoint_at->number, 1);
2115 annotate_breakpoint (bs->breakpoint_at->number);
2116 ui_out_text (uiout, "\nBreakpoint ");
2117 if (ui_out_is_mi_like_p (uiout))
2118 ui_out_field_string (uiout, "reason",
2119 async_reason_lookup (EXEC_ASYNC_BREAKPOINT_HIT));
2120 ui_out_field_int (uiout, "bkptno", bs->breakpoint_at->number);
2121 ui_out_text (uiout, ", ");
2122 return PRINT_SRC_AND_LOC;
2125 case bp_shlib_event:
2126 /* Did we stop because the user set the stop_on_solib_events
2127 variable? (If so, we report this as a generic, "Stopped due
2128 to shlib event" message.) */
2129 printf_filtered (_("Stopped due to shared library event\n"));
2130 return PRINT_NOTHING;
2133 case bp_thread_event:
2134 /* Not sure how we will get here.
2135 GDB should not stop for these breakpoints. */
2136 printf_filtered (_("Thread Event Breakpoint: gdb should not stop!\n"));
2137 return PRINT_NOTHING;
2140 case bp_overlay_event:
2141 /* By analogy with the thread event, GDB should not stop for these. */
2142 printf_filtered (_("Overlay Event Breakpoint: gdb should not stop!\n"));
2143 return PRINT_NOTHING;
2147 annotate_catchpoint (bs->breakpoint_at->number);
2148 printf_filtered (_("\nCatchpoint %d (loaded %s), "),
2149 bs->breakpoint_at->number,
2150 bs->breakpoint_at->triggered_dll_pathname);
2151 return PRINT_SRC_AND_LOC;
2154 case bp_catch_unload:
2155 annotate_catchpoint (bs->breakpoint_at->number);
2156 printf_filtered (_("\nCatchpoint %d (unloaded %s), "),
2157 bs->breakpoint_at->number,
2158 bs->breakpoint_at->triggered_dll_pathname);
2159 return PRINT_SRC_AND_LOC;
2163 annotate_catchpoint (bs->breakpoint_at->number);
2164 printf_filtered (_("\nCatchpoint %d (forked process %d), "),
2165 bs->breakpoint_at->number,
2166 bs->breakpoint_at->forked_inferior_pid);
2167 return PRINT_SRC_AND_LOC;
2170 case bp_catch_vfork:
2171 annotate_catchpoint (bs->breakpoint_at->number);
2172 printf_filtered (_("\nCatchpoint %d (vforked process %d), "),
2173 bs->breakpoint_at->number,
2174 bs->breakpoint_at->forked_inferior_pid);
2175 return PRINT_SRC_AND_LOC;
2179 annotate_catchpoint (bs->breakpoint_at->number);
2180 printf_filtered (_("\nCatchpoint %d (exec'd %s), "),
2181 bs->breakpoint_at->number,
2182 bs->breakpoint_at->exec_pathname);
2183 return PRINT_SRC_AND_LOC;
2186 case bp_catch_catch:
2187 if (current_exception_event &&
2188 (CURRENT_EXCEPTION_KIND == EX_EVENT_CATCH))
2190 annotate_catchpoint (bs->breakpoint_at->number);
2191 printf_filtered (_("\nCatchpoint %d (exception caught), "),
2192 bs->breakpoint_at->number);
2193 if (CURRENT_EXCEPTION_THROW_PC && CURRENT_EXCEPTION_THROW_LINE)
2194 printf_filtered (_("throw location %s:%d, "),
2195 CURRENT_EXCEPTION_THROW_FILE,
2196 CURRENT_EXCEPTION_THROW_LINE);
2198 printf_filtered (_("throw location unknown, "));
2200 if (CURRENT_EXCEPTION_CATCH_PC && CURRENT_EXCEPTION_CATCH_LINE)
2201 printf_filtered (_("catch location %s:%d\n"),
2202 CURRENT_EXCEPTION_CATCH_FILE,
2203 CURRENT_EXCEPTION_CATCH_LINE);
2205 printf_filtered (_("catch location unknown\n"));
2207 /* don't bother to print location frame info */
2208 return PRINT_SRC_ONLY;
2212 /* really throw, some other bpstat will handle it */
2213 return PRINT_UNKNOWN;
2217 case bp_catch_throw:
2218 if (current_exception_event &&
2219 (CURRENT_EXCEPTION_KIND == EX_EVENT_THROW))
2221 annotate_catchpoint (bs->breakpoint_at->number);
2222 printf_filtered (_("\nCatchpoint %d (exception thrown), "),
2223 bs->breakpoint_at->number);
2224 if (CURRENT_EXCEPTION_THROW_PC && CURRENT_EXCEPTION_THROW_LINE)
2225 printf_filtered (_("throw location %s:%d, "),
2226 CURRENT_EXCEPTION_THROW_FILE,
2227 CURRENT_EXCEPTION_THROW_LINE);
2229 printf_filtered (_("throw location unknown, "));
2231 if (CURRENT_EXCEPTION_CATCH_PC && CURRENT_EXCEPTION_CATCH_LINE)
2232 printf_filtered (_("catch location %s:%d\n"),
2233 CURRENT_EXCEPTION_CATCH_FILE,
2234 CURRENT_EXCEPTION_CATCH_LINE);
2236 printf_filtered (_("catch location unknown\n"));
2238 /* don't bother to print location frame info */
2239 return PRINT_SRC_ONLY;
2243 /* really catch, some other bpstat will handle it */
2244 return PRINT_UNKNOWN;
2249 case bp_hardware_watchpoint:
2250 if (bs->old_val != NULL)
2252 annotate_watchpoint (bs->breakpoint_at->number);
2253 if (ui_out_is_mi_like_p (uiout))
2256 async_reason_lookup (EXEC_ASYNC_WATCHPOINT_TRIGGER));
2257 mention (bs->breakpoint_at);
2258 ui_out_chain = make_cleanup_ui_out_tuple_begin_end (uiout, "value");
2259 ui_out_text (uiout, "\nOld value = ");
2260 value_print (bs->old_val, stb->stream, 0, Val_pretty_default);
2261 ui_out_field_stream (uiout, "old", stb);
2262 ui_out_text (uiout, "\nNew value = ");
2263 value_print (bs->breakpoint_at->val, stb->stream, 0, Val_pretty_default);
2264 ui_out_field_stream (uiout, "new", stb);
2265 do_cleanups (ui_out_chain);
2266 ui_out_text (uiout, "\n");
2267 value_free (bs->old_val);
2270 /* More than one watchpoint may have been triggered. */
2271 return PRINT_UNKNOWN;
2274 case bp_read_watchpoint:
2275 if (ui_out_is_mi_like_p (uiout))
2278 async_reason_lookup (EXEC_ASYNC_READ_WATCHPOINT_TRIGGER));
2279 mention (bs->breakpoint_at);
2280 ui_out_chain = make_cleanup_ui_out_tuple_begin_end (uiout, "value");
2281 ui_out_text (uiout, "\nValue = ");
2282 value_print (bs->breakpoint_at->val, stb->stream, 0, Val_pretty_default);
2283 ui_out_field_stream (uiout, "value", stb);
2284 do_cleanups (ui_out_chain);
2285 ui_out_text (uiout, "\n");
2286 return PRINT_UNKNOWN;
2289 case bp_access_watchpoint:
2290 if (bs->old_val != NULL)
2292 annotate_watchpoint (bs->breakpoint_at->number);
2293 if (ui_out_is_mi_like_p (uiout))
2296 async_reason_lookup (EXEC_ASYNC_ACCESS_WATCHPOINT_TRIGGER));
2297 mention (bs->breakpoint_at);
2298 ui_out_chain = make_cleanup_ui_out_tuple_begin_end (uiout, "value");
2299 ui_out_text (uiout, "\nOld value = ");
2300 value_print (bs->old_val, stb->stream, 0, Val_pretty_default);
2301 ui_out_field_stream (uiout, "old", stb);
2302 value_free (bs->old_val);
2304 ui_out_text (uiout, "\nNew value = ");
2308 mention (bs->breakpoint_at);
2309 if (ui_out_is_mi_like_p (uiout))
2312 async_reason_lookup (EXEC_ASYNC_ACCESS_WATCHPOINT_TRIGGER));
2313 ui_out_chain = make_cleanup_ui_out_tuple_begin_end (uiout, "value");
2314 ui_out_text (uiout, "\nValue = ");
2316 value_print (bs->breakpoint_at->val, stb->stream, 0,Val_pretty_default);
2317 ui_out_field_stream (uiout, "new", stb);
2318 do_cleanups (ui_out_chain);
2319 ui_out_text (uiout, "\n");
2320 return PRINT_UNKNOWN;
2323 /* Fall through, we don't deal with these types of breakpoints
2327 if (ui_out_is_mi_like_p (uiout))
2330 async_reason_lookup (EXEC_ASYNC_FUNCTION_FINISHED));
2331 return PRINT_UNKNOWN;
2335 if (ui_out_is_mi_like_p (uiout))
2336 ui_out_field_string (uiout, "reason", "location-reached");
2337 return PRINT_UNKNOWN;
2342 case bp_longjmp_resume:
2343 case bp_step_resume:
2344 case bp_through_sigtramp:
2345 case bp_watchpoint_scope:
2348 return PRINT_UNKNOWN;
2352 /* Generic routine for printing messages indicating why we
2353 stopped. The behavior of this function depends on the value
2354 'print_it' in the bpstat structure. Under some circumstances we
2355 may decide not to print anything here and delegate the task to
2358 static enum print_stop_action
2359 print_bp_stop_message (bpstat bs)
2361 switch (bs->print_it)
2364 /* Nothing should be printed for this bpstat entry. */
2365 return PRINT_UNKNOWN;
2369 /* We still want to print the frame, but we already printed the
2370 relevant messages. */
2371 return PRINT_SRC_AND_LOC;
2374 case print_it_normal:
2375 /* Normal case. Call the breakpoint's print_it method, or
2376 print_it_typical. */
2377 if (bs->breakpoint_at != NULL && bs->breakpoint_at->ops != NULL
2378 && bs->breakpoint_at->ops->print_it != NULL)
2379 return bs->breakpoint_at->ops->print_it (bs->breakpoint_at);
2381 return print_it_typical (bs);
2385 internal_error (__FILE__, __LINE__,
2386 _("print_bp_stop_message: unrecognized enum value"));
2391 /* Print a message indicating what happened. This is called from
2392 normal_stop(). The input to this routine is the head of the bpstat
2393 list - a list of the eventpoints that caused this stop. This
2394 routine calls the generic print routine for printing a message
2395 about reasons for stopping. This will print (for example) the
2396 "Breakpoint n," part of the output. The return value of this
2399 PRINT_UNKNOWN: Means we printed nothing
2400 PRINT_SRC_AND_LOC: Means we printed something, and expect subsequent
2401 code to print the location. An example is
2402 "Breakpoint 1, " which should be followed by
2404 PRINT_SRC_ONLY: Means we printed something, but there is no need
2405 to also print the location part of the message.
2406 An example is the catch/throw messages, which
2407 don't require a location appended to the end.
2408 PRINT_NOTHING: We have done some printing and we don't need any
2409 further info to be printed.*/
2411 enum print_stop_action
2412 bpstat_print (bpstat bs)
2416 /* Maybe another breakpoint in the chain caused us to stop.
2417 (Currently all watchpoints go on the bpstat whether hit or not.
2418 That probably could (should) be changed, provided care is taken
2419 with respect to bpstat_explains_signal). */
2420 for (; bs; bs = bs->next)
2422 val = print_bp_stop_message (bs);
2423 if (val == PRINT_SRC_ONLY
2424 || val == PRINT_SRC_AND_LOC
2425 || val == PRINT_NOTHING)
2429 /* We reached the end of the chain, or we got a null BS to start
2430 with and nothing was printed. */
2431 return PRINT_UNKNOWN;
2434 /* Evaluate the expression EXP and return 1 if value is zero.
2435 This is used inside a catch_errors to evaluate the breakpoint condition.
2436 The argument is a "struct expression *" that has been cast to char * to
2437 make it pass through catch_errors. */
2440 breakpoint_cond_eval (void *exp)
2442 struct value *mark = value_mark ();
2443 int i = !value_true (evaluate_expression ((struct expression *) exp));
2444 value_free_to_mark (mark);
2448 /* Allocate a new bpstat and chain it to the current one. */
2451 bpstat_alloc (struct breakpoint *b, bpstat cbs /* Current "bs" value */ )
2455 bs = (bpstat) xmalloc (sizeof (*bs));
2457 bs->breakpoint_at = b;
2458 /* If the condition is false, etc., don't do the commands. */
2459 bs->commands = NULL;
2461 bs->print_it = print_it_normal;
2465 /* Possible return values for watchpoint_check (this can't be an enum
2466 because of check_errors). */
2467 /* The watchpoint has been deleted. */
2468 #define WP_DELETED 1
2469 /* The value has changed. */
2470 #define WP_VALUE_CHANGED 2
2471 /* The value has not changed. */
2472 #define WP_VALUE_NOT_CHANGED 3
2474 #define BP_TEMPFLAG 1
2475 #define BP_HARDWAREFLAG 2
2477 /* Check watchpoint condition. */
2480 watchpoint_check (void *p)
2482 bpstat bs = (bpstat) p;
2483 struct breakpoint *b;
2484 struct frame_info *fr;
2485 int within_current_scope;
2487 b = bs->breakpoint_at;
2489 if (b->exp_valid_block == NULL)
2490 within_current_scope = 1;
2493 /* There is no current frame at this moment. If we're going to have
2494 any chance of handling watchpoints on local variables, we'll need
2495 the frame chain (so we can determine if we're in scope). */
2496 reinit_frame_cache ();
2497 fr = frame_find_by_id (b->watchpoint_frame);
2498 within_current_scope = (fr != NULL);
2499 /* in_function_epilogue_p() returns a non-zero value if we're still
2500 in the function but the stack frame has already been invalidated.
2501 Since we can't rely on the values of local variables after the
2502 stack has been destroyed, we are treating the watchpoint in that
2503 state as `not changed' without further checking.
2505 vinschen/2003-09-04: The former implementation left out the case
2506 that the watchpoint frame couldn't be found by frame_find_by_id()
2507 because the current PC is currently in an epilogue. Calling
2508 gdbarch_in_function_epilogue_p() also when fr == NULL fixes that. */
2509 if ((!within_current_scope || fr == get_current_frame ())
2510 && gdbarch_in_function_epilogue_p (current_gdbarch, read_pc ()))
2511 return WP_VALUE_NOT_CHANGED;
2512 if (fr && within_current_scope)
2513 /* If we end up stopping, the current frame will get selected
2514 in normal_stop. So this call to select_frame won't affect
2519 if (within_current_scope)
2521 /* We use value_{,free_to_}mark because it could be a
2522 *long* time before we return to the command level and
2523 call free_all_values. We can't call free_all_values because
2524 we might be in the middle of evaluating a function call. */
2526 struct value *mark = value_mark ();
2527 struct value *new_val = evaluate_expression (bs->breakpoint_at->exp);
2528 if (!value_equal (b->val, new_val))
2530 release_value (new_val);
2531 value_free_to_mark (mark);
2532 bs->old_val = b->val;
2534 /* We will stop here */
2535 return WP_VALUE_CHANGED;
2539 /* Nothing changed, don't do anything. */
2540 value_free_to_mark (mark);
2541 /* We won't stop here */
2542 return WP_VALUE_NOT_CHANGED;
2547 /* This seems like the only logical thing to do because
2548 if we temporarily ignored the watchpoint, then when
2549 we reenter the block in which it is valid it contains
2550 garbage (in the case of a function, it may have two
2551 garbage values, one before and one after the prologue).
2552 So we can't even detect the first assignment to it and
2553 watch after that (since the garbage may or may not equal
2554 the first value assigned). */
2555 /* We print all the stop information in print_it_typical(), but
2556 in this case, by the time we call print_it_typical() this bp
2557 will be deleted already. So we have no choice but print the
2558 information here. */
2559 if (ui_out_is_mi_like_p (uiout))
2561 (uiout, "reason", async_reason_lookup (EXEC_ASYNC_WATCHPOINT_SCOPE));
2562 ui_out_text (uiout, "\nWatchpoint ");
2563 ui_out_field_int (uiout, "wpnum", bs->breakpoint_at->number);
2564 ui_out_text (uiout, " deleted because the program has left the block in\n\
2565 which its expression is valid.\n");
2567 if (b->related_breakpoint)
2568 b->related_breakpoint->disposition = disp_del_at_next_stop;
2569 b->disposition = disp_del_at_next_stop;
2575 /* Get a bpstat associated with having just stopped at address
2576 BP_ADDR in thread PTID. STOPPED_BY_WATCHPOINT is 1 if the
2577 target thinks we stopped due to a hardware watchpoint, 0 if we
2578 know we did not trigger a hardware watchpoint, and -1 if we do not know. */
2580 /* Determine whether we stopped at a breakpoint, etc, or whether we
2581 don't understand this stop. Result is a chain of bpstat's such that:
2583 if we don't understand the stop, the result is a null pointer.
2585 if we understand why we stopped, the result is not null.
2587 Each element of the chain refers to a particular breakpoint or
2588 watchpoint at which we have stopped. (We may have stopped for
2589 several reasons concurrently.)
2591 Each element of the chain has valid next, breakpoint_at,
2592 commands, FIXME??? fields. */
2595 bpstat_stop_status (CORE_ADDR bp_addr, ptid_t ptid, int stopped_by_watchpoint)
2597 struct breakpoint *b, *temp;
2598 /* True if we've hit a breakpoint (as opposed to a watchpoint). */
2599 int real_breakpoint = 0;
2600 /* Root of the chain of bpstat's */
2601 struct bpstats root_bs[1];
2602 /* Pointer to the last thing in the chain currently. */
2603 bpstat bs = root_bs;
2604 int thread_id = pid_to_thread_id (ptid);
2606 ALL_BREAKPOINTS_SAFE (b, temp)
2608 if (!breakpoint_enabled (b) && b->enable_state != bp_permanent)
2611 if (b->type != bp_watchpoint
2612 && b->type != bp_hardware_watchpoint
2613 && b->type != bp_read_watchpoint
2614 && b->type != bp_access_watchpoint
2615 && b->type != bp_hardware_breakpoint
2616 && b->type != bp_catch_fork
2617 && b->type != bp_catch_vfork
2618 && b->type != bp_catch_exec
2619 && b->type != bp_catch_catch
2620 && b->type != bp_catch_throw) /* a non-watchpoint bp */
2622 if (b->loc->address != bp_addr) /* address doesn't match */
2624 if (overlay_debugging /* unmapped overlay section */
2625 && section_is_overlay (b->loc->section)
2626 && !section_is_mapped (b->loc->section))
2630 /* Continuable hardware watchpoints are treated as non-existent if the
2631 reason we stopped wasn't a hardware watchpoint (we didn't stop on
2632 some data address). Otherwise gdb won't stop on a break instruction
2633 in the code (not from a breakpoint) when a hardware watchpoint has
2636 if ((b->type == bp_hardware_watchpoint
2637 || b->type == bp_read_watchpoint
2638 || b->type == bp_access_watchpoint)
2639 && !stopped_by_watchpoint)
2642 if (b->type == bp_hardware_breakpoint)
2644 if (b->loc->address != bp_addr)
2646 if (overlay_debugging /* unmapped overlay section */
2647 && section_is_overlay (b->loc->section)
2648 && !section_is_mapped (b->loc->section))
2652 /* Is this a catchpoint of a load or unload? If so, did we
2653 get a load or unload of the specified library? If not,
2655 if ((b->type == bp_catch_load)
2656 #if defined(SOLIB_HAVE_LOAD_EVENT)
2657 && (!SOLIB_HAVE_LOAD_EVENT (PIDGET (inferior_ptid))
2658 || ((b->dll_pathname != NULL)
2659 && (strcmp (b->dll_pathname,
2660 SOLIB_LOADED_LIBRARY_PATHNAME (
2661 PIDGET (inferior_ptid)))
2667 if ((b->type == bp_catch_unload)
2668 #if defined(SOLIB_HAVE_UNLOAD_EVENT)
2669 && (!SOLIB_HAVE_UNLOAD_EVENT (PIDGET (inferior_ptid))
2670 || ((b->dll_pathname != NULL)
2671 && (strcmp (b->dll_pathname,
2672 SOLIB_UNLOADED_LIBRARY_PATHNAME (
2673 PIDGET (inferior_ptid)))
2679 if ((b->type == bp_catch_fork)
2680 && !inferior_has_forked (PIDGET (inferior_ptid),
2681 &b->forked_inferior_pid))
2684 if ((b->type == bp_catch_vfork)
2685 && !inferior_has_vforked (PIDGET (inferior_ptid),
2686 &b->forked_inferior_pid))
2689 if ((b->type == bp_catch_exec)
2690 && !inferior_has_execd (PIDGET (inferior_ptid), &b->exec_pathname))
2693 if (ep_is_exception_catchpoint (b) &&
2694 !(current_exception_event = target_get_current_exception_event ()))
2697 /* Come here if it's a watchpoint, or if the break address matches */
2699 bs = bpstat_alloc (b, bs); /* Alloc a bpstat to explain stop */
2701 /* Watchpoints may change this, if not found to have triggered. */
2705 if (b->type == bp_watchpoint ||
2706 b->type == bp_hardware_watchpoint)
2708 char *message = xstrprintf ("Error evaluating expression for watchpoint %d\n",
2710 struct cleanup *cleanups = make_cleanup (xfree, message);
2711 int e = catch_errors (watchpoint_check, bs, message,
2713 do_cleanups (cleanups);
2717 /* We've already printed what needs to be printed. */
2718 /* Actually this is superfluous, because by the time we
2719 call print_it_typical() the wp will be already deleted,
2720 and the function will return immediately. */
2721 bs->print_it = print_it_done;
2724 case WP_VALUE_CHANGED:
2728 case WP_VALUE_NOT_CHANGED:
2730 bs->print_it = print_it_noop;
2737 /* Error from catch_errors. */
2738 printf_filtered (_("Watchpoint %d deleted.\n"), b->number);
2739 if (b->related_breakpoint)
2740 b->related_breakpoint->disposition = disp_del_at_next_stop;
2741 b->disposition = disp_del_at_next_stop;
2742 /* We've already printed what needs to be printed. */
2743 bs->print_it = print_it_done;
2749 else if (b->type == bp_read_watchpoint ||
2750 b->type == bp_access_watchpoint)
2756 if (!target_stopped_data_address (¤t_target, &addr))
2758 for (v = b->val_chain; v; v = value_next (v))
2760 if (VALUE_LVAL (v) == lval_memory
2761 && ! value_lazy (v))
2763 struct type *vtype = check_typedef (value_type (v));
2765 if (v == b->val_chain
2766 || (TYPE_CODE (vtype) != TYPE_CODE_STRUCT
2767 && TYPE_CODE (vtype) != TYPE_CODE_ARRAY))
2771 vaddr = VALUE_ADDRESS (v) + value_offset (v);
2772 /* Exact match not required. Within range is
2774 if (addr >= vaddr &&
2775 addr < vaddr + TYPE_LENGTH (value_type (v)))
2782 char *message = xstrprintf ("Error evaluating expression for watchpoint %d\n",
2784 struct cleanup *cleanups = make_cleanup (xfree, message);
2785 int e = catch_errors (watchpoint_check, bs, message,
2787 do_cleanups (cleanups);
2791 /* We've already printed what needs to be printed. */
2792 bs->print_it = print_it_done;
2795 case WP_VALUE_CHANGED:
2796 if (b->type == bp_read_watchpoint)
2798 /* Don't stop: read watchpoints shouldn't fire if
2799 the value has changed. This is for targets
2800 which cannot set read-only watchpoints. */
2801 bs->print_it = print_it_noop;
2807 case WP_VALUE_NOT_CHANGED:
2814 /* Error from catch_errors. */
2815 printf_filtered (_("Watchpoint %d deleted.\n"), b->number);
2816 if (b->related_breakpoint)
2817 b->related_breakpoint->disposition = disp_del_at_next_stop;
2818 b->disposition = disp_del_at_next_stop;
2819 /* We've already printed what needs to be printed. */
2820 bs->print_it = print_it_done;
2824 else /* found == 0 */
2826 /* This is a case where some watchpoint(s) triggered,
2827 but not at the address of this watchpoint (FOUND
2828 was left zero). So don't print anything for this
2830 bs->print_it = print_it_noop;
2837 /* By definition, an encountered breakpoint is a triggered
2841 real_breakpoint = 1;
2844 if (frame_id_p (b->frame_id)
2845 && !frame_id_eq (b->frame_id, get_frame_id (get_current_frame ())))
2849 int value_is_zero = 0;
2853 /* Need to select the frame, with all that implies
2854 so that the conditions will have the right context. */
2855 select_frame (get_current_frame ());
2857 = catch_errors (breakpoint_cond_eval, (b->cond),
2858 "Error in testing breakpoint condition:\n",
2860 /* FIXME-someday, should give breakpoint # */
2863 if (b->cond && value_is_zero)
2866 /* Don't consider this a hit. */
2869 else if (b->thread != -1 && b->thread != thread_id)
2872 /* Don't consider this a hit. */
2875 else if (b->ignore_count > 0)
2878 annotate_ignore_count_change ();
2883 /* We will stop here */
2884 if (b->disposition == disp_disable)
2885 b->enable_state = bp_disabled;
2888 bs->commands = b->commands;
2890 (strcmp ("silent", bs->commands->line) == 0
2891 || (xdb_commands && strcmp ("Q", bs->commands->line) == 0)))
2893 bs->commands = bs->commands->next;
2896 bs->commands = copy_command_lines (bs->commands);
2899 /* Print nothing for this entry if we dont stop or if we dont print. */
2900 if (bs->stop == 0 || bs->print == 0)
2901 bs->print_it = print_it_noop;
2904 bs->next = NULL; /* Terminate the chain */
2905 bs = root_bs->next; /* Re-grab the head of the chain */
2907 /* The value of a hardware watchpoint hasn't changed, but the
2908 intermediate memory locations we are watching may have. */
2909 if (bs && !bs->stop &&
2910 (bs->breakpoint_at->type == bp_hardware_watchpoint ||
2911 bs->breakpoint_at->type == bp_read_watchpoint ||
2912 bs->breakpoint_at->type == bp_access_watchpoint))
2914 remove_breakpoints ();
2915 insert_breakpoints ();
2920 /* Tell what to do about this bpstat. */
2922 bpstat_what (bpstat bs)
2924 /* Classify each bpstat as one of the following. */
2927 /* This bpstat element has no effect on the main_action. */
2930 /* There was a watchpoint, stop but don't print. */
2933 /* There was a watchpoint, stop and print. */
2936 /* There was a breakpoint but we're not stopping. */
2939 /* There was a breakpoint, stop but don't print. */
2942 /* There was a breakpoint, stop and print. */
2945 /* We hit the longjmp breakpoint. */
2948 /* We hit the longjmp_resume breakpoint. */
2951 /* We hit the step_resume breakpoint. */
2954 /* We hit the through_sigtramp breakpoint. */
2957 /* We hit the shared library event breakpoint. */
2960 /* We caught a shared library event. */
2963 /* This is just used to count how many enums there are. */
2967 /* Here is the table which drives this routine. So that we can
2968 format it pretty, we define some abbreviations for the
2969 enum bpstat_what codes. */
2970 #define kc BPSTAT_WHAT_KEEP_CHECKING
2971 #define ss BPSTAT_WHAT_STOP_SILENT
2972 #define sn BPSTAT_WHAT_STOP_NOISY
2973 #define sgl BPSTAT_WHAT_SINGLE
2974 #define slr BPSTAT_WHAT_SET_LONGJMP_RESUME
2975 #define clr BPSTAT_WHAT_CLEAR_LONGJMP_RESUME
2976 #define clrs BPSTAT_WHAT_CLEAR_LONGJMP_RESUME_SINGLE
2977 #define sr BPSTAT_WHAT_STEP_RESUME
2978 #define ts BPSTAT_WHAT_THROUGH_SIGTRAMP
2979 #define shl BPSTAT_WHAT_CHECK_SHLIBS
2980 #define shlr BPSTAT_WHAT_CHECK_SHLIBS_RESUME_FROM_HOOK
2982 /* "Can't happen." Might want to print an error message.
2983 abort() is not out of the question, but chances are GDB is just
2984 a bit confused, not unusable. */
2985 #define err BPSTAT_WHAT_STOP_NOISY
2987 /* Given an old action and a class, come up with a new action. */
2988 /* One interesting property of this table is that wp_silent is the same
2989 as bp_silent and wp_noisy is the same as bp_noisy. That is because
2990 after stopping, the check for whether to step over a breakpoint
2991 (BPSTAT_WHAT_SINGLE type stuff) is handled in proceed() without
2992 reference to how we stopped. We retain separate wp_silent and
2993 bp_silent codes in case we want to change that someday.
2995 Another possibly interesting property of this table is that
2996 there's a partial ordering, priority-like, of the actions. Once
2997 you've decided that some action is appropriate, you'll never go
2998 back and decide something of a lower priority is better. The
3001 kc < clr sgl shl shlr slr sn sr ss ts
3002 sgl < clrs shl shlr slr sn sr ss ts
3003 slr < err shl shlr sn sr ss ts
3004 clr < clrs err shl shlr sn sr ss ts
3005 clrs < err shl shlr sn sr ss ts
3006 ss < shl shlr sn sr ts
3013 What I think this means is that we don't need a damned table
3014 here. If you just put the rows and columns in the right order,
3015 it'd look awfully regular. We could simply walk the bpstat list
3016 and choose the highest priority action we find, with a little
3017 logic to handle the 'err' cases, and the CLEAR_LONGJMP_RESUME/
3018 CLEAR_LONGJMP_RESUME_SINGLE distinction (which breakpoint.h says
3019 is messy anyway). */
3021 /* step_resume entries: a step resume breakpoint overrides another
3022 breakpoint of signal handling (see comment in wait_for_inferior
3023 at where we set the step_resume breakpoint). */
3024 /* We handle the through_sigtramp_breakpoint the same way; having both
3025 one of those and a step_resume_breakpoint is probably very rare (?). */
3027 static const enum bpstat_what_main_action
3028 table[(int) class_last][(int) BPSTAT_WHAT_LAST] =
3031 /* kc ss sn sgl slr clr clrs sr ts shl shlr
3034 {kc, ss, sn, sgl, slr, clr, clrs, sr, ts, shl, shlr},
3036 {ss, ss, sn, ss, ss, ss, ss, sr, ts, shl, shlr},
3038 {sn, sn, sn, sn, sn, sn, sn, sr, ts, shl, shlr},
3040 {sgl, ss, sn, sgl, slr, clrs, clrs, sr, ts, shl, shlr},
3042 {ss, ss, sn, ss, ss, ss, ss, sr, ts, shl, shlr},
3044 {sn, sn, sn, sn, sn, sn, sn, sr, ts, shl, shlr},
3046 {slr, ss, sn, slr, slr, err, err, sr, ts, shl, shlr},
3048 {clr, ss, sn, clrs, err, err, err, sr, ts, shl, shlr},
3050 {sr, sr, sr, sr, sr, sr, sr, sr, ts, shl, shlr},
3052 {ts, ts, ts, ts, ts, ts, ts, ts, ts, shl, shlr},
3054 {shl, shl, shl, shl, shl, shl, shl, shl, ts, shl, shlr},
3056 {shlr, shlr, shlr, shlr, shlr, shlr, shlr, shlr, ts, shlr, shlr}
3071 enum bpstat_what_main_action current_action = BPSTAT_WHAT_KEEP_CHECKING;
3072 struct bpstat_what retval;
3074 retval.call_dummy = 0;
3075 for (; bs != NULL; bs = bs->next)
3077 enum class bs_class = no_effect;
3078 if (bs->breakpoint_at == NULL)
3079 /* I suspect this can happen if it was a momentary breakpoint
3080 which has since been deleted. */
3082 switch (bs->breakpoint_at->type)
3088 case bp_hardware_breakpoint:
3094 bs_class = bp_noisy;
3096 bs_class = bp_silent;
3099 bs_class = bp_nostop;
3102 case bp_hardware_watchpoint:
3103 case bp_read_watchpoint:
3104 case bp_access_watchpoint:
3108 bs_class = wp_noisy;
3110 bs_class = wp_silent;
3113 /* There was a watchpoint, but we're not stopping.
3114 This requires no further action. */
3115 bs_class = no_effect;
3118 bs_class = long_jump;
3120 case bp_longjmp_resume:
3121 bs_class = long_resume;
3123 case bp_step_resume:
3126 bs_class = step_resume;
3129 /* It is for the wrong frame. */
3130 bs_class = bp_nostop;
3132 case bp_through_sigtramp:
3133 bs_class = through_sig;
3135 case bp_watchpoint_scope:
3136 bs_class = bp_nostop;
3138 case bp_shlib_event:
3139 bs_class = shlib_event;
3141 case bp_thread_event:
3142 case bp_overlay_event:
3143 bs_class = bp_nostop;
3146 case bp_catch_unload:
3147 /* Only if this catchpoint triggered should we cause the
3148 step-out-of-dld behaviour. Otherwise, we ignore this
3151 bs_class = catch_shlib_event;
3153 bs_class = no_effect;
3156 case bp_catch_vfork:
3161 bs_class = bp_noisy;
3163 bs_class = bp_silent;
3166 /* There was a catchpoint, but we're not stopping.
3167 This requires no further action. */
3168 bs_class = no_effect;
3170 case bp_catch_catch:
3171 if (!bs->stop || CURRENT_EXCEPTION_KIND != EX_EVENT_CATCH)
3172 bs_class = bp_nostop;
3174 bs_class = bs->print ? bp_noisy : bp_silent;
3176 case bp_catch_throw:
3177 if (!bs->stop || CURRENT_EXCEPTION_KIND != EX_EVENT_THROW)
3178 bs_class = bp_nostop;
3180 bs_class = bs->print ? bp_noisy : bp_silent;
3183 /* Make sure the action is stop (silent or noisy),
3184 so infrun.c pops the dummy frame. */
3185 bs_class = bp_silent;
3186 retval.call_dummy = 1;
3189 current_action = table[(int) bs_class][(int) current_action];
3191 retval.main_action = current_action;
3195 /* Nonzero if we should step constantly (e.g. watchpoints on machines
3196 without hardware support). This isn't related to a specific bpstat,
3197 just to things like whether watchpoints are set. */
3200 bpstat_should_step (void)
3202 struct breakpoint *b;
3204 if (breakpoint_enabled (b) && b->type == bp_watchpoint)
3209 /* Nonzero if there are enabled hardware watchpoints. */
3211 bpstat_have_active_hw_watchpoints (void)
3213 struct bp_location *bpt;
3214 ALL_BP_LOCATIONS (bpt)
3215 if (breakpoint_enabled (bpt->owner)
3217 && bpt->loc_type == bp_loc_hardware_watchpoint)
3223 /* Given a bpstat that records zero or more triggered eventpoints, this
3224 function returns another bpstat which contains only the catchpoints
3225 on that first list, if any. */
3227 bpstat_get_triggered_catchpoints (bpstat ep_list, bpstat *cp_list)
3229 struct bpstats root_bs[1];
3230 bpstat bs = root_bs;
3231 struct breakpoint *ep;
3234 bpstat_clear (cp_list);
3235 root_bs->next = NULL;
3237 for (; ep_list != NULL; ep_list = ep_list->next)
3239 /* Is this eventpoint a catchpoint? If not, ignore it. */
3240 ep = ep_list->breakpoint_at;
3243 if ((ep->type != bp_catch_load) &&
3244 (ep->type != bp_catch_unload) &&
3245 (ep->type != bp_catch_catch) &&
3246 (ep->type != bp_catch_throw))
3247 /* pai: (temp) ADD fork/vfork here!! */
3250 /* Yes; add it to the list. */
3251 bs = bpstat_alloc (ep, bs);
3256 #if defined(SOLIB_ADD)
3257 /* Also, for each triggered catchpoint, tag it with the name of
3258 the library that caused this trigger. (We copy the name now,
3259 because it's only guaranteed to be available NOW, when the
3260 catchpoint triggers. Clients who may wish to know the name
3261 later must get it from the catchpoint itself.) */
3262 if (ep->triggered_dll_pathname != NULL)
3263 xfree (ep->triggered_dll_pathname);
3264 if (ep->type == bp_catch_load)
3265 dll_pathname = SOLIB_LOADED_LIBRARY_PATHNAME (
3266 PIDGET (inferior_ptid));
3268 dll_pathname = SOLIB_UNLOADED_LIBRARY_PATHNAME (
3269 PIDGET (inferior_ptid));
3271 dll_pathname = NULL;
3275 ep->triggered_dll_pathname = (char *)
3276 xmalloc (strlen (dll_pathname) + 1);
3277 strcpy (ep->triggered_dll_pathname, dll_pathname);
3280 ep->triggered_dll_pathname = NULL;
3286 /* Print B to gdb_stdout. */
3288 print_one_breakpoint (struct breakpoint *b,
3289 CORE_ADDR *last_addr)
3291 struct command_line *l;
3293 struct ep_type_description
3298 static struct ep_type_description bptypes[] =
3300 {bp_none, "?deleted?"},
3301 {bp_breakpoint, "breakpoint"},
3302 {bp_hardware_breakpoint, "hw breakpoint"},
3303 {bp_until, "until"},
3304 {bp_finish, "finish"},
3305 {bp_watchpoint, "watchpoint"},
3306 {bp_hardware_watchpoint, "hw watchpoint"},
3307 {bp_read_watchpoint, "read watchpoint"},
3308 {bp_access_watchpoint, "acc watchpoint"},
3309 {bp_longjmp, "longjmp"},
3310 {bp_longjmp_resume, "longjmp resume"},
3311 {bp_step_resume, "step resume"},
3312 {bp_through_sigtramp, "sigtramp"},
3313 {bp_watchpoint_scope, "watchpoint scope"},
3314 {bp_call_dummy, "call dummy"},
3315 {bp_shlib_event, "shlib events"},
3316 {bp_thread_event, "thread events"},
3317 {bp_overlay_event, "overlay events"},
3318 {bp_catch_load, "catch load"},
3319 {bp_catch_unload, "catch unload"},
3320 {bp_catch_fork, "catch fork"},
3321 {bp_catch_vfork, "catch vfork"},
3322 {bp_catch_exec, "catch exec"},
3323 {bp_catch_catch, "catch catch"},
3324 {bp_catch_throw, "catch throw"}
3327 static char *bpdisps[] =
3328 {"del", "dstp", "dis", "keep"};
3329 static char bpenables[] = "nynny";
3330 char wrap_indent[80];
3331 struct ui_stream *stb = ui_out_stream_new (uiout);
3332 struct cleanup *old_chain = make_cleanup_ui_out_stream_delete (stb);
3333 struct cleanup *bkpt_chain;
3336 bkpt_chain = make_cleanup_ui_out_tuple_begin_end (uiout, "bkpt");
3340 ui_out_field_int (uiout, "number", b->number);
3344 if (((int) b->type > (sizeof (bptypes) / sizeof (bptypes[0])))
3345 || ((int) b->type != bptypes[(int) b->type].type))
3346 internal_error (__FILE__, __LINE__,
3347 _("bptypes table does not describe type #%d."),
3349 ui_out_field_string (uiout, "type", bptypes[(int) b->type].description);
3353 ui_out_field_string (uiout, "disp", bpdisps[(int) b->disposition]);
3357 ui_out_field_fmt (uiout, "enabled", "%c", bpenables[(int) b->enable_state]);
3358 ui_out_spaces (uiout, 2);
3361 strcpy (wrap_indent, " ");
3364 if (TARGET_ADDR_BIT <= 32)
3365 strcat (wrap_indent, " ");
3367 strcat (wrap_indent, " ");
3370 if (b->ops != NULL && b->ops->print_one != NULL)
3371 b->ops->print_one (b, last_addr);
3376 internal_error (__FILE__, __LINE__,
3377 _("print_one_breakpoint: bp_none encountered\n"));
3381 case bp_hardware_watchpoint:
3382 case bp_read_watchpoint:
3383 case bp_access_watchpoint:
3384 /* Field 4, the address, is omitted (which makes the columns
3385 not line up too nicely with the headers, but the effect
3386 is relatively readable). */
3388 ui_out_field_skip (uiout, "addr");
3390 print_expression (b->exp, stb->stream);
3391 ui_out_field_stream (uiout, "what", stb);
3395 case bp_catch_unload:
3396 /* Field 4, the address, is omitted (which makes the columns
3397 not line up too nicely with the headers, but the effect
3398 is relatively readable). */
3400 ui_out_field_skip (uiout, "addr");
3402 if (b->dll_pathname == NULL)
3404 ui_out_field_string (uiout, "what", "<any library>");
3405 ui_out_spaces (uiout, 1);
3409 ui_out_text (uiout, "library \"");
3410 ui_out_field_string (uiout, "what", b->dll_pathname);
3411 ui_out_text (uiout, "\" ");
3416 case bp_catch_vfork:
3417 /* Field 4, the address, is omitted (which makes the columns
3418 not line up too nicely with the headers, but the effect
3419 is relatively readable). */
3421 ui_out_field_skip (uiout, "addr");
3423 if (b->forked_inferior_pid != 0)
3425 ui_out_text (uiout, "process ");
3426 ui_out_field_int (uiout, "what", b->forked_inferior_pid);
3427 ui_out_spaces (uiout, 1);
3431 /* Field 4, the address, is omitted (which makes the columns
3432 not line up too nicely with the headers, but the effect
3433 is relatively readable). */
3435 ui_out_field_skip (uiout, "addr");
3437 if (b->exec_pathname != NULL)
3439 ui_out_text (uiout, "program \"");
3440 ui_out_field_string (uiout, "what", b->exec_pathname);
3441 ui_out_text (uiout, "\" ");
3445 case bp_catch_catch:
3446 /* Field 4, the address, is omitted (which makes the columns
3447 not line up too nicely with the headers, but the effect
3448 is relatively readable). */
3450 ui_out_field_skip (uiout, "addr");
3452 ui_out_field_string (uiout, "what", "exception catch");
3453 ui_out_spaces (uiout, 1);
3456 case bp_catch_throw:
3457 /* Field 4, the address, is omitted (which makes the columns
3458 not line up too nicely with the headers, but the effect
3459 is relatively readable). */
3461 ui_out_field_skip (uiout, "addr");
3463 ui_out_field_string (uiout, "what", "exception throw");
3464 ui_out_spaces (uiout, 1);
3468 case bp_hardware_breakpoint:
3472 case bp_longjmp_resume:
3473 case bp_step_resume:
3474 case bp_through_sigtramp:
3475 case bp_watchpoint_scope:
3477 case bp_shlib_event:
3478 case bp_thread_event:
3479 case bp_overlay_event:
3484 ui_out_field_string (uiout, "addr", "<PENDING>");
3486 ui_out_field_core_addr (uiout, "addr", b->loc->address);
3489 *last_addr = b->loc->address;
3492 sym = find_pc_sect_function (b->loc->address, b->loc->section);
3495 ui_out_text (uiout, "in ");
3496 ui_out_field_string (uiout, "func",
3497 SYMBOL_PRINT_NAME (sym));
3498 ui_out_wrap_hint (uiout, wrap_indent);
3499 ui_out_text (uiout, " at ");
3501 ui_out_field_string (uiout, "file", b->source_file);
3502 ui_out_text (uiout, ":");
3503 ui_out_field_int (uiout, "line", b->line_number);
3505 else if (b->pending)
3507 ui_out_field_string (uiout, "pending", b->addr_string);
3511 print_address_symbolic (b->loc->address, stb->stream, demangle, "");
3512 ui_out_field_stream (uiout, "at", stb);
3517 if (b->thread != -1)
3519 /* FIXME: This seems to be redundant and lost here; see the
3520 "stop only in" line a little further down. */
3521 ui_out_text (uiout, " thread ");
3522 ui_out_field_int (uiout, "thread", b->thread);
3525 ui_out_text (uiout, "\n");
3527 if (frame_id_p (b->frame_id))
3530 ui_out_text (uiout, "\tstop only in stack frame at ");
3531 /* FIXME: cagney/2002-12-01: Shouldn't be poeking around inside
3533 ui_out_field_core_addr (uiout, "frame", b->frame_id.stack_addr);
3534 ui_out_text (uiout, "\n");
3540 ui_out_text (uiout, "\tstop only if ");
3541 print_expression (b->cond, stb->stream);
3542 ui_out_field_stream (uiout, "cond", stb);
3543 ui_out_text (uiout, "\n");
3546 if (b->pending && b->cond_string)
3549 ui_out_text (uiout, "\tstop only if ");
3550 ui_out_field_string (uiout, "cond", b->cond_string);
3551 ui_out_text (uiout, "\n");
3554 if (b->thread != -1)
3556 /* FIXME should make an annotation for this */
3557 ui_out_text (uiout, "\tstop only in thread ");
3558 ui_out_field_int (uiout, "thread", b->thread);
3559 ui_out_text (uiout, "\n");
3562 if (show_breakpoint_hit_counts && b->hit_count)
3564 /* FIXME should make an annotation for this */
3565 if (ep_is_catchpoint (b))
3566 ui_out_text (uiout, "\tcatchpoint");
3568 ui_out_text (uiout, "\tbreakpoint");
3569 ui_out_text (uiout, " already hit ");
3570 ui_out_field_int (uiout, "times", b->hit_count);
3571 if (b->hit_count == 1)
3572 ui_out_text (uiout, " time\n");
3574 ui_out_text (uiout, " times\n");
3577 /* Output the count also if it is zero, but only if this is
3578 mi. FIXME: Should have a better test for this. */
3579 if (ui_out_is_mi_like_p (uiout))
3580 if (show_breakpoint_hit_counts && b->hit_count == 0)
3581 ui_out_field_int (uiout, "times", b->hit_count);
3583 if (b->ignore_count)
3586 ui_out_text (uiout, "\tignore next ");
3587 ui_out_field_int (uiout, "ignore", b->ignore_count);
3588 ui_out_text (uiout, " hits\n");
3591 if ((l = b->commands))
3593 struct cleanup *script_chain;
3596 script_chain = make_cleanup_ui_out_tuple_begin_end (uiout, "script");
3597 print_command_lines (uiout, l, 4);
3598 do_cleanups (script_chain);
3600 do_cleanups (bkpt_chain);
3601 do_cleanups (old_chain);
3604 struct captured_breakpoint_query_args
3610 do_captured_breakpoint_query (struct ui_out *uiout, void *data)
3612 struct captured_breakpoint_query_args *args = data;
3613 struct breakpoint *b;
3614 CORE_ADDR dummy_addr = 0;
3617 if (args->bnum == b->number)
3619 print_one_breakpoint (b, &dummy_addr);
3627 gdb_breakpoint_query (struct ui_out *uiout, int bnum, char **error_message)
3629 struct captured_breakpoint_query_args args;
3631 /* For the moment we don't trust print_one_breakpoint() to not throw
3633 return catch_exceptions_with_msg (uiout, do_captured_breakpoint_query, &args,
3634 error_message, RETURN_MASK_ALL);
3637 /* Return non-zero if B is user settable (breakpoints, watchpoints,
3638 catchpoints, et.al.). */
3641 user_settable_breakpoint (const struct breakpoint *b)
3643 return (b->type == bp_breakpoint
3644 || b->type == bp_catch_load
3645 || b->type == bp_catch_unload
3646 || b->type == bp_catch_fork
3647 || b->type == bp_catch_vfork
3648 || b->type == bp_catch_exec
3649 || b->type == bp_catch_catch
3650 || b->type == bp_catch_throw
3651 || b->type == bp_hardware_breakpoint
3652 || b->type == bp_watchpoint
3653 || b->type == bp_read_watchpoint
3654 || b->type == bp_access_watchpoint
3655 || b->type == bp_hardware_watchpoint);
3658 /* Print information on user settable breakpoint (watchpoint, etc)
3659 number BNUM. If BNUM is -1 print all user settable breakpoints.
3660 If ALLFLAG is non-zero, include non- user settable breakpoints. */
3663 breakpoint_1 (int bnum, int allflag)
3665 struct breakpoint *b;
3666 CORE_ADDR last_addr = (CORE_ADDR) -1;
3667 int nr_printable_breakpoints;
3668 struct cleanup *bkpttbl_chain;
3670 /* Compute the number of rows in the table. */
3671 nr_printable_breakpoints = 0;
3674 || bnum == b->number)
3676 if (allflag || user_settable_breakpoint (b))
3677 nr_printable_breakpoints++;
3682 = make_cleanup_ui_out_table_begin_end (uiout, 6, nr_printable_breakpoints,
3686 = make_cleanup_ui_out_table_begin_end (uiout, 5, nr_printable_breakpoints,
3689 if (nr_printable_breakpoints > 0)
3690 annotate_breakpoints_headers ();
3691 if (nr_printable_breakpoints > 0)
3693 ui_out_table_header (uiout, 3, ui_left, "number", "Num"); /* 1 */
3694 if (nr_printable_breakpoints > 0)
3696 ui_out_table_header (uiout, 14, ui_left, "type", "Type"); /* 2 */
3697 if (nr_printable_breakpoints > 0)
3699 ui_out_table_header (uiout, 4, ui_left, "disp", "Disp"); /* 3 */
3700 if (nr_printable_breakpoints > 0)
3702 ui_out_table_header (uiout, 3, ui_left, "enabled", "Enb"); /* 4 */
3705 if (nr_printable_breakpoints > 0)
3707 if (TARGET_ADDR_BIT <= 32)
3708 ui_out_table_header (uiout, 10, ui_left, "addr", "Address");/* 5 */
3710 ui_out_table_header (uiout, 18, ui_left, "addr", "Address");/* 5 */
3712 if (nr_printable_breakpoints > 0)
3714 ui_out_table_header (uiout, 40, ui_noalign, "what", "What"); /* 6 */
3715 ui_out_table_body (uiout);
3716 if (nr_printable_breakpoints > 0)
3717 annotate_breakpoints_table ();
3721 || bnum == b->number)
3723 /* We only print out user settable breakpoints unless the
3725 if (allflag || user_settable_breakpoint (b))
3726 print_one_breakpoint (b, &last_addr);
3729 do_cleanups (bkpttbl_chain);
3731 if (nr_printable_breakpoints == 0)
3734 ui_out_message (uiout, 0, "No breakpoints or watchpoints.\n");
3736 ui_out_message (uiout, 0, "No breakpoint or watchpoint number %d.\n",
3741 /* Compare against (CORE_ADDR)-1 in case some compiler decides
3742 that a comparison of an unsigned with -1 is always false. */
3743 if (last_addr != (CORE_ADDR) -1)
3744 set_next_address (last_addr);
3747 /* FIXME? Should this be moved up so that it is only called when
3748 there have been breakpoints? */
3749 annotate_breakpoints_table_end ();
3753 breakpoints_info (char *bnum_exp, int from_tty)
3758 bnum = parse_and_eval_long (bnum_exp);
3760 breakpoint_1 (bnum, 0);
3764 maintenance_info_breakpoints (char *bnum_exp, int from_tty)
3769 bnum = parse_and_eval_long (bnum_exp);
3771 breakpoint_1 (bnum, 1);
3774 /* Print a message describing any breakpoints set at PC. */
3777 describe_other_breakpoints (CORE_ADDR pc, asection *section)
3780 struct breakpoint *b;
3783 if (b->loc->address == pc) /* address match / overlay match */
3784 if (!b->pending && (!overlay_debugging || b->loc->section == section))
3789 printf_filtered (_("Note: breakpoint "));
3790 else /* if (others == ???) */
3791 printf_filtered (_("Note: breakpoints "));
3793 if (b->loc->address == pc) /* address match / overlay match */
3794 if (!b->pending && (!overlay_debugging || b->loc->section == section))
3797 printf_filtered ("%d%s%s ",
3799 ((b->enable_state == bp_disabled ||
3800 b->enable_state == bp_shlib_disabled ||
3801 b->enable_state == bp_call_disabled)
3803 : b->enable_state == bp_permanent
3807 : ((others == 1) ? " and" : ""));
3809 printf_filtered (_("also set at pc "));
3810 deprecated_print_address_numeric (pc, 1, gdb_stdout);
3811 printf_filtered (".\n");
3815 /* Set the default place to put a breakpoint
3816 for the `break' command with no arguments. */
3819 set_default_breakpoint (int valid, CORE_ADDR addr, struct symtab *symtab,
3822 default_breakpoint_valid = valid;
3823 default_breakpoint_address = addr;
3824 default_breakpoint_symtab = symtab;
3825 default_breakpoint_line = line;
3828 /* Return true iff it is meaningful to use the address member of
3829 BPT. For some breakpoint types, the address member is irrelevant
3830 and it makes no sense to attempt to compare it to other addresses
3831 (or use it for any other purpose either).
3833 More specifically, each of the following breakpoint types will always
3834 have a zero valued address and we don't want check_duplicates() to mark
3835 breakpoints of any of these types to be a duplicate of an actual
3836 breakpoint at address zero:
3839 bp_hardware_watchpoint
3841 bp_access_watchpoint
3848 breakpoint_address_is_meaningful (struct breakpoint *bpt)
3850 enum bptype type = bpt->type;
3852 return (type != bp_watchpoint
3853 && type != bp_hardware_watchpoint
3854 && type != bp_read_watchpoint
3855 && type != bp_access_watchpoint
3856 && type != bp_catch_exec
3857 && type != bp_longjmp_resume
3858 && type != bp_catch_fork
3859 && type != bp_catch_vfork);
3862 /* Rescan breakpoints at the same address and section as BPT,
3863 marking the first one as "first" and any others as "duplicates".
3864 This is so that the bpt instruction is only inserted once.
3865 If we have a permanent breakpoint at the same place as BPT, make
3866 that one the official one, and the rest as duplicates. */
3869 check_duplicates (struct breakpoint *bpt)
3871 struct bp_location *b;
3873 struct bp_location *perm_bp = 0;
3874 CORE_ADDR address = bpt->loc->address;
3875 asection *section = bpt->loc->section;
3877 if (! breakpoint_address_is_meaningful (bpt))
3880 ALL_BP_LOCATIONS (b)
3881 if (b->owner->enable_state != bp_disabled
3882 && b->owner->enable_state != bp_shlib_disabled
3883 && !b->owner->pending
3884 && b->owner->enable_state != bp_call_disabled
3885 && b->address == address /* address / overlay match */
3886 && (!overlay_debugging || b->section == section)
3887 && breakpoint_address_is_meaningful (b->owner))
3889 /* Have we found a permanent breakpoint? */
3890 if (b->owner->enable_state == bp_permanent)
3897 b->duplicate = count > 1;
3900 /* If we found a permanent breakpoint at this address, go over the
3901 list again and declare all the other breakpoints there to be the
3905 perm_bp->duplicate = 0;
3907 /* Permanent breakpoint should always be inserted. */
3908 if (! perm_bp->inserted)
3909 internal_error (__FILE__, __LINE__,
3910 _("allegedly permanent breakpoint is not "
3911 "actually inserted"));
3913 ALL_BP_LOCATIONS (b)
3916 if (b->owner->enable_state != bp_disabled
3917 && b->owner->enable_state != bp_shlib_disabled
3918 && !b->owner->pending
3919 && b->owner->enable_state != bp_call_disabled
3920 && b->address == address /* address / overlay match */
3921 && (!overlay_debugging || b->section == section)
3922 && breakpoint_address_is_meaningful (b->owner))
3925 internal_error (__FILE__, __LINE__,
3926 _("another breakpoint was inserted on top of "
3927 "a permanent breakpoint"));
3936 breakpoint_adjustment_warning (CORE_ADDR from_addr, CORE_ADDR to_addr,
3937 int bnum, int have_bnum)
3942 strcpy (astr1, hex_string_custom ((unsigned long) from_addr, 8));
3943 strcpy (astr2, hex_string_custom ((unsigned long) to_addr, 8));
3945 warning (_("Breakpoint %d address previously adjusted from %s to %s."),
3946 bnum, astr1, astr2);
3948 warning (_("Breakpoint address adjusted from %s to %s."), astr1, astr2);
3951 /* Adjust a breakpoint's address to account for architectural constraints
3952 on breakpoint placement. Return the adjusted address. Note: Very
3953 few targets require this kind of adjustment. For most targets,
3954 this function is simply the identity function. */
3957 adjust_breakpoint_address (CORE_ADDR bpaddr, enum bptype bptype)
3959 if (!gdbarch_adjust_breakpoint_address_p (current_gdbarch))
3961 /* Very few targets need any kind of breakpoint adjustment. */
3964 else if (bptype == bp_watchpoint
3965 || bptype == bp_hardware_watchpoint
3966 || bptype == bp_read_watchpoint
3967 || bptype == bp_access_watchpoint
3968 || bptype == bp_catch_fork
3969 || bptype == bp_catch_vfork
3970 || bptype == bp_catch_exec)
3972 /* Watchpoints and the various bp_catch_* eventpoints should not
3973 have their addresses modified. */
3978 CORE_ADDR adjusted_bpaddr;
3980 /* Some targets have architectural constraints on the placement
3981 of breakpoint instructions. Obtain the adjusted address. */
3982 adjusted_bpaddr = gdbarch_adjust_breakpoint_address (current_gdbarch,
3985 /* An adjusted breakpoint address can significantly alter
3986 a user's expectations. Print a warning if an adjustment
3988 if (adjusted_bpaddr != bpaddr)
3989 breakpoint_adjustment_warning (bpaddr, adjusted_bpaddr, 0, 0);
3991 return adjusted_bpaddr;
3995 /* Allocate a struct bp_location. */
3997 static struct bp_location *
3998 allocate_bp_location (struct breakpoint *bpt, enum bptype bp_type)
4000 struct bp_location *loc, *loc_p;
4002 loc = xmalloc (sizeof (struct bp_location));
4003 memset (loc, 0, sizeof (*loc));
4013 case bp_longjmp_resume:
4014 case bp_step_resume:
4015 case bp_through_sigtramp:
4016 case bp_watchpoint_scope:
4018 case bp_shlib_event:
4019 case bp_thread_event:
4020 case bp_overlay_event:
4022 case bp_catch_unload:
4023 loc->loc_type = bp_loc_software_breakpoint;
4025 case bp_hardware_breakpoint:
4026 loc->loc_type = bp_loc_hardware_breakpoint;
4028 case bp_hardware_watchpoint:
4029 case bp_read_watchpoint:
4030 case bp_access_watchpoint:
4031 loc->loc_type = bp_loc_hardware_watchpoint;
4035 case bp_catch_vfork:
4037 case bp_catch_catch:
4038 case bp_catch_throw:
4039 loc->loc_type = bp_loc_other;
4042 internal_error (__FILE__, __LINE__, _("unknown breakpoint type"));
4045 /* Add this breakpoint to the end of the chain. */
4047 loc_p = bp_location_chain;
4049 bp_location_chain = loc;
4053 loc_p = loc_p->next;
4060 /* set_raw_breakpoint() is a low level routine for allocating and
4061 partially initializing a breakpoint of type BPTYPE. The newly
4062 created breakpoint's address, section, source file name, and line
4063 number are provided by SAL. The newly created and partially
4064 initialized breakpoint is added to the breakpoint chain and
4065 is also returned as the value of this function.
4067 It is expected that the caller will complete the initialization of
4068 the newly created breakpoint struct as well as output any status
4069 information regarding the creation of a new breakpoint. In
4070 particular, set_raw_breakpoint() does NOT set the breakpoint
4071 number! Care should be taken to not allow an error() to occur
4072 prior to completing the initialization of the breakpoint. If this
4073 should happen, a bogus breakpoint will be left on the chain. */
4076 set_raw_breakpoint (struct symtab_and_line sal, enum bptype bptype)
4078 struct breakpoint *b, *b1;
4080 b = (struct breakpoint *) xmalloc (sizeof (struct breakpoint));
4081 memset (b, 0, sizeof (*b));
4082 b->loc = allocate_bp_location (b, bptype);
4083 b->loc->requested_address = sal.pc;
4084 b->loc->address = adjust_breakpoint_address (b->loc->requested_address,
4086 if (sal.symtab == NULL)
4087 b->source_file = NULL;
4089 b->source_file = savestring (sal.symtab->filename,
4090 strlen (sal.symtab->filename));
4091 b->loc->section = sal.section;
4093 b->language = current_language->la_language;
4094 b->input_radix = input_radix;
4096 b->line_number = sal.line;
4097 b->enable_state = bp_enabled;
4100 b->ignore_count = 0;
4102 b->frame_id = null_frame_id;
4103 b->dll_pathname = NULL;
4104 b->triggered_dll_pathname = NULL;
4105 b->forked_inferior_pid = 0;
4106 b->exec_pathname = NULL;
4110 /* Add this breakpoint to the end of the chain
4111 so that a list of breakpoints will come out in order
4112 of increasing numbers. */
4114 b1 = breakpoint_chain;
4116 breakpoint_chain = b;
4124 check_duplicates (b);
4125 breakpoints_changed ();
4131 /* Note that the breakpoint object B describes a permanent breakpoint
4132 instruction, hard-wired into the inferior's code. */
4134 make_breakpoint_permanent (struct breakpoint *b)
4136 b->enable_state = bp_permanent;
4138 /* By definition, permanent breakpoints are already present in the code. */
4139 b->loc->inserted = 1;
4142 static struct breakpoint *
4143 create_internal_breakpoint (CORE_ADDR address, enum bptype type)
4145 static int internal_breakpoint_number = -1;
4146 struct symtab_and_line sal;
4147 struct breakpoint *b;
4149 init_sal (&sal); /* initialize to zeroes */
4152 sal.section = find_pc_overlay (sal.pc);
4154 b = set_raw_breakpoint (sal, type);
4155 b->number = internal_breakpoint_number--;
4156 b->disposition = disp_donttouch;
4163 create_longjmp_breakpoint (char *func_name)
4165 struct breakpoint *b;
4166 struct minimal_symbol *m;
4168 if (func_name == NULL)
4169 b = create_internal_breakpoint (0, bp_longjmp_resume);
4172 if ((m = lookup_minimal_symbol_text (func_name, NULL)) == NULL)
4175 b = create_internal_breakpoint (SYMBOL_VALUE_ADDRESS (m), bp_longjmp);
4178 b->enable_state = bp_disabled;
4181 b->addr_string = xstrdup (func_name);
4184 /* Call this routine when stepping and nexting to enable a breakpoint
4185 if we do a longjmp(). When we hit that breakpoint, call
4186 set_longjmp_resume_breakpoint() to figure out where we are going. */
4189 enable_longjmp_breakpoint (void)
4191 struct breakpoint *b;
4194 if (b->type == bp_longjmp)
4196 b->enable_state = bp_enabled;
4197 check_duplicates (b);
4202 disable_longjmp_breakpoint (void)
4204 struct breakpoint *b;
4207 if (b->type == bp_longjmp
4208 || b->type == bp_longjmp_resume)
4210 b->enable_state = bp_disabled;
4211 check_duplicates (b);
4216 create_overlay_event_breakpoint (char *func_name)
4218 struct breakpoint *b;
4219 struct minimal_symbol *m;
4221 if ((m = lookup_minimal_symbol_text (func_name, NULL)) == NULL)
4224 b = create_internal_breakpoint (SYMBOL_VALUE_ADDRESS (m),
4226 b->addr_string = xstrdup (func_name);
4228 if (overlay_debugging == ovly_auto)
4230 b->enable_state = bp_enabled;
4231 overlay_events_enabled = 1;
4235 b->enable_state = bp_disabled;
4236 overlay_events_enabled = 0;
4241 enable_overlay_breakpoints (void)
4243 struct breakpoint *b;
4246 if (b->type == bp_overlay_event)
4248 b->enable_state = bp_enabled;
4249 check_duplicates (b);
4250 overlay_events_enabled = 1;
4255 disable_overlay_breakpoints (void)
4257 struct breakpoint *b;
4260 if (b->type == bp_overlay_event)
4262 b->enable_state = bp_disabled;
4263 check_duplicates (b);
4264 overlay_events_enabled = 0;
4269 create_thread_event_breakpoint (CORE_ADDR address)
4271 struct breakpoint *b;
4273 b = create_internal_breakpoint (address, bp_thread_event);
4275 b->enable_state = bp_enabled;
4276 /* addr_string has to be used or breakpoint_re_set will delete me. */
4277 b->addr_string = xstrprintf ("*0x%s", paddr (b->loc->address));
4283 remove_thread_event_breakpoints (void)
4285 struct breakpoint *b, *temp;
4287 ALL_BREAKPOINTS_SAFE (b, temp)
4288 if (b->type == bp_thread_event)
4289 delete_breakpoint (b);
4292 struct captured_parse_breakpoint_args
4295 struct symtabs_and_lines *sals_p;
4296 char ***addr_string_p;
4300 struct lang_and_radix
4306 /* Cleanup helper routine to restore the current language and
4309 do_restore_lang_radix_cleanup (void *old)
4311 struct lang_and_radix *p = old;
4312 set_language (p->lang);
4313 input_radix = p->radix;
4316 /* Try and resolve a pending breakpoint. */
4318 resolve_pending_breakpoint (struct breakpoint *b)
4320 /* Try and reparse the breakpoint in case the shared library
4322 struct symtabs_and_lines sals;
4323 struct symtab_and_line pending_sal;
4324 char **cond_string = (char **) NULL;
4325 char *copy_arg = b->addr_string;
4330 struct ui_file *old_gdb_stderr;
4331 struct lang_and_radix old_lr;
4332 struct cleanup *old_chain;
4334 /* Set language, input-radix, then reissue breakpoint command.
4335 Ensure the language and input-radix are restored afterwards. */
4336 old_lr.lang = current_language->la_language;
4337 old_lr.radix = input_radix;
4338 old_chain = make_cleanup (do_restore_lang_radix_cleanup, &old_lr);
4340 set_language (b->language);
4341 input_radix = b->input_radix;
4342 rc = break_command_1 (b->addr_string, b->flag, b->from_tty, b);
4344 if (rc == GDB_RC_OK)
4345 /* Pending breakpoint has been resolved. */
4346 printf_filtered (_("Pending breakpoint \"%s\" resolved\n"), b->addr_string);
4348 do_cleanups (old_chain);
4353 remove_solib_event_breakpoints (void)
4355 struct breakpoint *b, *temp;
4357 ALL_BREAKPOINTS_SAFE (b, temp)
4358 if (b->type == bp_shlib_event)
4359 delete_breakpoint (b);
4363 create_solib_event_breakpoint (CORE_ADDR address)
4365 struct breakpoint *b;
4367 b = create_internal_breakpoint (address, bp_shlib_event);
4371 /* Disable any breakpoints that are on code in shared libraries. Only
4372 apply to enabled breakpoints, disabled ones can just stay disabled. */
4375 disable_breakpoints_in_shlibs (int silent)
4377 struct breakpoint *b;
4378 int disabled_shlib_breaks = 0;
4380 /* See also: insert_breakpoints, under DISABLE_UNSETTABLE_BREAK. */
4383 if (((b->type == bp_breakpoint) || (b->type == bp_hardware_breakpoint))
4384 && breakpoint_enabled (b) && !b->loc->duplicate
4386 && PC_SOLIB (b->loc->address)
4388 && solib_address (b->loc->address)
4392 b->enable_state = bp_shlib_disabled;
4395 if (!disabled_shlib_breaks)
4397 target_terminal_ours_for_output ();
4398 warning (_("Temporarily disabling shared library breakpoints:"));
4400 disabled_shlib_breaks = 1;
4401 warning (_("breakpoint #%d "), b->number);
4407 /* Disable any breakpoints that are in in an unloaded shared library. Only
4408 apply to enabled breakpoints, disabled ones can just stay disabled. */
4411 disable_breakpoints_in_unloaded_shlib (struct so_list *solib)
4413 struct breakpoint *b;
4414 int disabled_shlib_breaks = 0;
4416 /* See also: insert_breakpoints, under DISABLE_UNSETTABLE_BREAK. */
4419 if ((b->loc->loc_type == bp_loc_hardware_breakpoint
4420 || b->loc->loc_type == bp_loc_software_breakpoint)
4421 && breakpoint_enabled (b) && !b->loc->duplicate)
4424 char *so_name = PC_SOLIB (b->loc->address);
4426 char *so_name = solib_address (b->loc->address);
4428 if (so_name && !strcmp (so_name, solib->so_name))
4430 b->enable_state = bp_shlib_disabled;
4431 /* At this point, we cannot rely on remove_breakpoint
4432 succeeding so we must mark the breakpoint as not inserted
4433 to prevent future errors occurring in remove_breakpoints. */
4434 b->loc->inserted = 0;
4435 if (!disabled_shlib_breaks)
4437 target_terminal_ours_for_output ();
4438 warning (_("Temporarily disabling breakpoints for unloaded shared library \"%s\""),
4441 disabled_shlib_breaks = 1;
4447 /* Try to reenable any breakpoints in shared libraries. */
4449 re_enable_breakpoints_in_shlibs (void)
4451 struct breakpoint *b, *tmp;
4453 ALL_BREAKPOINTS_SAFE (b, tmp)
4455 if (b->enable_state == bp_shlib_disabled)
4460 /* Do not reenable the breakpoint if the shared library is
4461 still not mapped in. */
4463 lib = PC_SOLIB (b->loc->address);
4465 lib = solib_address (b->loc->address);
4467 if (lib != NULL && target_read_memory (b->loc->address, buf, 1) == 0)
4468 b->enable_state = bp_enabled;
4470 else if (b->pending && (b->enable_state == bp_enabled))
4472 if (resolve_pending_breakpoint (b) == GDB_RC_OK)
4473 delete_breakpoint (b);
4479 solib_load_unload_1 (char *hookname, int tempflag, char *dll_pathname,
4480 char *cond_string, enum bptype bp_kind)
4482 struct breakpoint *b;
4483 struct symtabs_and_lines sals;
4484 struct cleanup *old_chain;
4485 struct cleanup *canonical_strings_chain = NULL;
4486 char *addr_start = hookname;
4487 char *addr_end = NULL;
4488 char **canonical = (char **) NULL;
4489 int thread = -1; /* All threads. */
4491 /* Set a breakpoint on the specified hook. */
4492 sals = decode_line_1 (&hookname, 1, (struct symtab *) NULL,
4493 0, &canonical, NULL);
4494 addr_end = hookname;
4496 if (sals.nelts == 0)
4498 warning (_("Unable to set a breakpoint on dynamic linker callback.\n"
4499 "Suggest linking with /opt/langtools/lib/end.o.\n"
4500 "GDB will be unable to track shl_load/shl_unload calls."));
4503 if (sals.nelts != 1)
4505 warning (_("Unable to set unique breakpoint on dynamic linker callback.\n"
4506 "GDB will be unable to track shl_load/shl_unload calls."));
4510 /* Make sure that all storage allocated in decode_line_1 gets freed
4511 in case the following errors out. */
4512 old_chain = make_cleanup (xfree, sals.sals);
4513 if (canonical != (char **) NULL)
4515 make_cleanup (xfree, canonical);
4516 canonical_strings_chain = make_cleanup (null_cleanup, 0);
4517 if (canonical[0] != NULL)
4518 make_cleanup (xfree, canonical[0]);
4521 resolve_sal_pc (&sals.sals[0]);
4523 /* Remove the canonical strings from the cleanup, they are needed below. */
4524 if (canonical != (char **) NULL)
4525 discard_cleanups (canonical_strings_chain);
4527 b = set_raw_breakpoint (sals.sals[0], bp_kind);
4528 set_breakpoint_count (breakpoint_count + 1);
4529 b->number = breakpoint_count;
4531 b->cond_string = (cond_string == NULL) ?
4532 NULL : savestring (cond_string, strlen (cond_string));
4535 if (canonical != (char **) NULL && canonical[0] != NULL)
4536 b->addr_string = canonical[0];
4537 else if (addr_start)
4538 b->addr_string = savestring (addr_start, addr_end - addr_start);
4540 b->enable_state = bp_enabled;
4541 b->disposition = tempflag ? disp_del : disp_donttouch;
4543 if (dll_pathname == NULL)
4544 b->dll_pathname = NULL;
4547 b->dll_pathname = (char *) xmalloc (strlen (dll_pathname) + 1);
4548 strcpy (b->dll_pathname, dll_pathname);
4552 do_cleanups (old_chain);
4556 create_solib_load_event_breakpoint (char *hookname, int tempflag,
4557 char *dll_pathname, char *cond_string)
4559 solib_load_unload_1 (hookname, tempflag, dll_pathname,
4560 cond_string, bp_catch_load);
4564 create_solib_unload_event_breakpoint (char *hookname, int tempflag,
4565 char *dll_pathname, char *cond_string)
4567 solib_load_unload_1 (hookname, tempflag, dll_pathname,
4568 cond_string, bp_catch_unload);
4572 create_fork_vfork_event_catchpoint (int tempflag, char *cond_string,
4573 enum bptype bp_kind)
4575 struct symtab_and_line sal;
4576 struct breakpoint *b;
4577 int thread = -1; /* All threads. */
4584 b = set_raw_breakpoint (sal, bp_kind);
4585 set_breakpoint_count (breakpoint_count + 1);
4586 b->number = breakpoint_count;
4588 b->cond_string = (cond_string == NULL) ?
4589 NULL : savestring (cond_string, strlen (cond_string));
4591 b->addr_string = NULL;
4592 b->enable_state = bp_enabled;
4593 b->disposition = tempflag ? disp_del : disp_donttouch;
4594 b->forked_inferior_pid = 0;
4600 create_fork_event_catchpoint (int tempflag, char *cond_string)
4602 create_fork_vfork_event_catchpoint (tempflag, cond_string, bp_catch_fork);
4606 create_vfork_event_catchpoint (int tempflag, char *cond_string)
4608 create_fork_vfork_event_catchpoint (tempflag, cond_string, bp_catch_vfork);
4612 create_exec_event_catchpoint (int tempflag, char *cond_string)
4614 struct symtab_and_line sal;
4615 struct breakpoint *b;
4616 int thread = -1; /* All threads. */
4623 b = set_raw_breakpoint (sal, bp_catch_exec);
4624 set_breakpoint_count (breakpoint_count + 1);
4625 b->number = breakpoint_count;
4627 b->cond_string = (cond_string == NULL) ?
4628 NULL : savestring (cond_string, strlen (cond_string));
4630 b->addr_string = NULL;
4631 b->enable_state = bp_enabled;
4632 b->disposition = tempflag ? disp_del : disp_donttouch;
4638 hw_breakpoint_used_count (void)
4640 struct breakpoint *b;
4645 if (b->type == bp_hardware_breakpoint && b->enable_state == bp_enabled)
4653 hw_watchpoint_used_count (enum bptype type, int *other_type_used)
4655 struct breakpoint *b;
4658 *other_type_used = 0;
4661 if (breakpoint_enabled (b))
4663 if (b->type == type)
4665 else if ((b->type == bp_hardware_watchpoint ||
4666 b->type == bp_read_watchpoint ||
4667 b->type == bp_access_watchpoint))
4668 *other_type_used = 1;
4674 /* Call this after hitting the longjmp() breakpoint. Use this to set
4675 a new breakpoint at the target of the jmp_buf.
4677 FIXME - This ought to be done by setting a temporary breakpoint
4678 that gets deleted automatically... */
4681 set_longjmp_resume_breakpoint (CORE_ADDR pc, struct frame_id frame_id)
4683 struct breakpoint *b;
4686 if (b->type == bp_longjmp_resume)
4688 b->loc->requested_address = pc;
4689 b->loc->address = adjust_breakpoint_address (b->loc->requested_address,
4691 b->enable_state = bp_enabled;
4692 b->frame_id = frame_id;
4693 check_duplicates (b);
4699 disable_watchpoints_before_interactive_call_start (void)
4701 struct breakpoint *b;
4705 if (((b->type == bp_watchpoint)
4706 || (b->type == bp_hardware_watchpoint)
4707 || (b->type == bp_read_watchpoint)
4708 || (b->type == bp_access_watchpoint)
4709 || ep_is_exception_catchpoint (b))
4710 && breakpoint_enabled (b))
4712 b->enable_state = bp_call_disabled;
4713 check_duplicates (b);
4719 enable_watchpoints_after_interactive_call_stop (void)
4721 struct breakpoint *b;
4725 if (((b->type == bp_watchpoint)
4726 || (b->type == bp_hardware_watchpoint)
4727 || (b->type == bp_read_watchpoint)
4728 || (b->type == bp_access_watchpoint)
4729 || ep_is_exception_catchpoint (b))
4730 && (b->enable_state == bp_call_disabled))
4732 b->enable_state = bp_enabled;
4733 check_duplicates (b);
4739 /* Set a breakpoint that will evaporate an end of command
4740 at address specified by SAL.
4741 Restrict it to frame FRAME if FRAME is nonzero. */
4744 set_momentary_breakpoint (struct symtab_and_line sal, struct frame_id frame_id,
4747 struct breakpoint *b;
4748 b = set_raw_breakpoint (sal, type);
4749 b->enable_state = bp_enabled;
4750 b->disposition = disp_donttouch;
4751 b->frame_id = frame_id;
4753 /* If we're debugging a multi-threaded program, then we
4754 want momentary breakpoints to be active in only a
4755 single thread of control. */
4756 if (in_thread_list (inferior_ptid))
4757 b->thread = pid_to_thread_id (inferior_ptid);
4763 /* Tell the user we have just set a breakpoint B. */
4766 mention (struct breakpoint *b)
4769 struct cleanup *old_chain, *ui_out_chain;
4770 struct ui_stream *stb;
4772 stb = ui_out_stream_new (uiout);
4773 old_chain = make_cleanup_ui_out_stream_delete (stb);
4775 /* FIXME: This is misplaced; mention() is called by things (like
4776 hitting a watchpoint) other than breakpoint creation. It should
4777 be possible to clean this up and at the same time replace the
4778 random calls to breakpoint_changed with this hook, as has already
4779 been done for deprecated_delete_breakpoint_hook and so on. */
4780 if (deprecated_create_breakpoint_hook)
4781 deprecated_create_breakpoint_hook (b);
4782 breakpoint_create_event (b->number);
4784 if (b->ops != NULL && b->ops->print_mention != NULL)
4785 b->ops->print_mention (b);
4790 printf_filtered (_("(apparently deleted?) Eventpoint %d: "), b->number);
4793 ui_out_text (uiout, "Watchpoint ");
4794 ui_out_chain = make_cleanup_ui_out_tuple_begin_end (uiout, "wpt");
4795 ui_out_field_int (uiout, "number", b->number);
4796 ui_out_text (uiout, ": ");
4797 print_expression (b->exp, stb->stream);
4798 ui_out_field_stream (uiout, "exp", stb);
4799 do_cleanups (ui_out_chain);
4801 case bp_hardware_watchpoint:
4802 ui_out_text (uiout, "Hardware watchpoint ");
4803 ui_out_chain = make_cleanup_ui_out_tuple_begin_end (uiout, "wpt");
4804 ui_out_field_int (uiout, "number", b->number);
4805 ui_out_text (uiout, ": ");
4806 print_expression (b->exp, stb->stream);
4807 ui_out_field_stream (uiout, "exp", stb);
4808 do_cleanups (ui_out_chain);
4810 case bp_read_watchpoint:
4811 ui_out_text (uiout, "Hardware read watchpoint ");
4812 ui_out_chain = make_cleanup_ui_out_tuple_begin_end (uiout, "hw-rwpt");
4813 ui_out_field_int (uiout, "number", b->number);
4814 ui_out_text (uiout, ": ");
4815 print_expression (b->exp, stb->stream);
4816 ui_out_field_stream (uiout, "exp", stb);
4817 do_cleanups (ui_out_chain);
4819 case bp_access_watchpoint:
4820 ui_out_text (uiout, "Hardware access (read/write) watchpoint ");
4821 ui_out_chain = make_cleanup_ui_out_tuple_begin_end (uiout, "hw-awpt");
4822 ui_out_field_int (uiout, "number", b->number);
4823 ui_out_text (uiout, ": ");
4824 print_expression (b->exp, stb->stream);
4825 ui_out_field_stream (uiout, "exp", stb);
4826 do_cleanups (ui_out_chain);
4829 if (ui_out_is_mi_like_p (uiout))
4834 printf_filtered (_("Breakpoint %d"), b->number);
4837 case bp_hardware_breakpoint:
4838 if (ui_out_is_mi_like_p (uiout))
4843 printf_filtered (_("Hardware assisted breakpoint %d"), b->number);
4847 case bp_catch_unload:
4848 printf_filtered (_("Catchpoint %d (%s %s)"),
4850 (b->type == bp_catch_load) ? "load" : "unload",
4851 (b->dll_pathname != NULL) ?
4852 b->dll_pathname : "<any library>");
4855 case bp_catch_vfork:
4856 printf_filtered (_("Catchpoint %d (%s)"),
4858 (b->type == bp_catch_fork) ? "fork" : "vfork");
4861 printf_filtered (_("Catchpoint %d (exec)"),
4864 case bp_catch_catch:
4865 case bp_catch_throw:
4866 printf_filtered (_("Catchpoint %d (%s)"),
4868 (b->type == bp_catch_catch) ? "catch" : "throw");
4874 case bp_longjmp_resume:
4875 case bp_step_resume:
4876 case bp_through_sigtramp:
4878 case bp_watchpoint_scope:
4879 case bp_shlib_event:
4880 case bp_thread_event:
4881 case bp_overlay_event:
4887 /* i18n: cagney/2005-02-11: Below needs to be merged into a
4891 printf_filtered (_(" (%s) pending."), b->addr_string);
4895 if (addressprint || b->source_file == NULL)
4897 printf_filtered (" at ");
4898 deprecated_print_address_numeric (b->loc->address, 1, gdb_stdout);
4901 printf_filtered (": file %s, line %d.",
4902 b->source_file, b->line_number);
4905 do_cleanups (old_chain);
4906 if (ui_out_is_mi_like_p (uiout))
4908 printf_filtered ("\n");
4912 /* Add SALS.nelts breakpoints to the breakpoint table. For each
4913 SALS.sal[i] breakpoint, include the corresponding ADDR_STRING[i],
4914 COND[i] and COND_STRING[i] values.
4916 The parameter PENDING_BP points to a pending breakpoint that is
4917 the basis of the breakpoints currently being created. The pending
4918 breakpoint may contain a separate condition string or commands
4919 that were added after the initial pending breakpoint was created.
4921 NOTE: If the function succeeds, the caller is expected to cleanup
4922 the arrays ADDR_STRING, COND_STRING, COND and SALS (but not the
4923 array contents). If the function fails (error() is called), the
4924 caller is expected to cleanups both the ADDR_STRING, COND_STRING,
4925 COND and SALS arrays and each of those arrays contents. */
4928 create_breakpoints (struct symtabs_and_lines sals, char **addr_string,
4929 struct expression **cond, char **cond_string,
4930 enum bptype type, enum bpdisp disposition,
4931 int thread, int ignore_count, int from_tty,
4932 struct breakpoint *pending_bp)
4934 if (type == bp_hardware_breakpoint)
4936 int i = hw_breakpoint_used_count ();
4937 int target_resources_ok =
4938 TARGET_CAN_USE_HARDWARE_WATCHPOINT (bp_hardware_breakpoint,
4940 if (target_resources_ok == 0)
4941 error (_("No hardware breakpoint support in the target."));
4942 else if (target_resources_ok < 0)
4943 error (_("Hardware breakpoints used exceeds limit."));
4946 /* Now set all the breakpoints. */
4949 for (i = 0; i < sals.nelts; i++)
4951 struct breakpoint *b;
4952 struct symtab_and_line sal = sals.sals[i];
4955 describe_other_breakpoints (sal.pc, sal.section);
4957 b = set_raw_breakpoint (sal, type);
4958 set_breakpoint_count (breakpoint_count + 1);
4959 b->number = breakpoint_count;
4963 b->addr_string = addr_string[i];
4965 /* addr_string has to be used or breakpoint_re_set will delete
4967 b->addr_string = xstrprintf ("*0x%s", paddr (b->loc->address));
4968 b->cond_string = cond_string[i];
4969 b->ignore_count = ignore_count;
4970 b->enable_state = bp_enabled;
4971 b->disposition = disposition;
4972 /* If resolving a pending breakpoint, a check must be made to see if
4973 the user has specified a new condition or commands for the
4974 breakpoint. A new condition will override any condition that was
4975 initially specified with the initial breakpoint command. */
4979 if (pending_bp->cond_string)
4981 arg = pending_bp->cond_string;
4982 b->cond_string = savestring (arg, strlen (arg));
4983 b->cond = parse_exp_1 (&arg, block_for_pc (b->loc->address), 0);
4985 error (_("Junk at end of pending breakpoint condition expression"));
4987 /* If there are commands associated with the breakpoint, they should
4989 if (pending_bp->commands)
4990 b->commands = copy_command_lines (pending_bp->commands);
4992 /* We have to copy over the ignore_count and thread as well. */
4993 b->ignore_count = pending_bp->ignore_count;
4994 b->thread = pending_bp->thread;
5001 /* Parse ARG which is assumed to be a SAL specification possibly
5002 followed by conditionals. On return, SALS contains an array of SAL
5003 addresses found. ADDR_STRING contains a vector of (canonical)
5004 address strings. ARG points to the end of the SAL. */
5007 parse_breakpoint_sals (char **address,
5008 struct symtabs_and_lines *sals,
5009 char ***addr_string,
5012 char *addr_start = *address;
5013 *addr_string = NULL;
5014 /* If no arg given, or if first arg is 'if ', use the default
5016 if ((*address) == NULL
5017 || (strncmp ((*address), "if", 2) == 0 && isspace ((*address)[2])))
5019 if (default_breakpoint_valid)
5021 struct symtab_and_line sal;
5022 init_sal (&sal); /* initialize to zeroes */
5023 sals->sals = (struct symtab_and_line *)
5024 xmalloc (sizeof (struct symtab_and_line));
5025 sal.pc = default_breakpoint_address;
5026 sal.line = default_breakpoint_line;
5027 sal.symtab = default_breakpoint_symtab;
5028 sal.section = find_pc_overlay (sal.pc);
5029 sals->sals[0] = sal;
5033 error (_("No default breakpoint address now."));
5037 /* Force almost all breakpoints to be in terms of the
5038 current_source_symtab (which is decode_line_1's default). This
5039 should produce the results we want almost all of the time while
5040 leaving default_breakpoint_* alone.
5041 ObjC: However, don't match an Objective-C method name which
5042 may have a '+' or '-' succeeded by a '[' */
5044 struct symtab_and_line cursal = get_current_source_symtab_and_line ();
5046 if (default_breakpoint_valid
5048 || ((strchr ("+-", (*address)[0]) != NULL)
5049 && ((*address)[1] != '['))))
5050 *sals = decode_line_1 (address, 1, default_breakpoint_symtab,
5051 default_breakpoint_line, addr_string,
5054 *sals = decode_line_1 (address, 1, (struct symtab *) NULL, 0,
5055 addr_string, not_found_ptr);
5057 /* For any SAL that didn't have a canonical string, fill one in. */
5058 if (sals->nelts > 0 && *addr_string == NULL)
5059 *addr_string = xcalloc (sals->nelts, sizeof (char **));
5060 if (addr_start != (*address))
5063 for (i = 0; i < sals->nelts; i++)
5065 /* Add the string if not present. */
5066 if ((*addr_string)[i] == NULL)
5067 (*addr_string)[i] = savestring (addr_start, (*address) - addr_start);
5073 /* Convert each SAL into a real PC. Verify that the PC can be
5074 inserted as a breakpoint. If it can't throw an error. */
5077 breakpoint_sals_to_pc (struct symtabs_and_lines *sals,
5081 for (i = 0; i < sals->nelts; i++)
5083 resolve_sal_pc (&sals->sals[i]);
5085 /* It's possible for the PC to be nonzero, but still an illegal
5086 value on some targets.
5088 For example, on HP-UX if you start gdb, and before running the
5089 inferior you try to set a breakpoint on a shared library function
5090 "foo" where the inferior doesn't call "foo" directly but does
5091 pass its address to another function call, then we do find a
5092 minimal symbol for the "foo", but it's address is invalid.
5093 (Appears to be an index into a table that the loader sets up
5094 when the inferior is run.)
5096 Give the target a chance to bless sals.sals[i].pc before we
5097 try to make a breakpoint for it. */
5098 #ifdef DEPRECATED_PC_REQUIRES_RUN_BEFORE_USE
5099 if (DEPRECATED_PC_REQUIRES_RUN_BEFORE_USE (sals->sals[i].pc))
5101 if (address == NULL)
5102 error (_("Cannot break without a running program."));
5104 error (_("Cannot break on %s without a running program."),
5112 do_captured_parse_breakpoint (struct ui_out *ui, void *data)
5114 struct captured_parse_breakpoint_args *args = data;
5116 parse_breakpoint_sals (args->arg_p, args->sals_p, args->addr_string_p,
5117 args->not_found_ptr);
5120 /* Set a breakpoint according to ARG (function, linenum or *address)
5121 flag: first bit : 0 non-temporary, 1 temporary.
5122 second bit : 0 normal breakpoint, 1 hardware breakpoint.
5124 PENDING_BP is non-NULL when this function is being called to resolve
5125 a pending breakpoint. */
5128 break_command_1 (char *arg, int flag, int from_tty, struct breakpoint *pending_bp)
5130 struct gdb_exception e;
5131 int tempflag, hardwareflag;
5132 struct symtabs_and_lines sals;
5133 struct expression **cond = 0;
5134 struct symtab_and_line pending_sal;
5135 char **cond_string = (char **) NULL;
5138 char *addr_start = arg;
5140 struct cleanup *old_chain;
5141 struct cleanup *breakpoint_chain = NULL;
5142 struct captured_parse_breakpoint_args parse_args;
5146 int ignore_count = 0;
5149 hardwareflag = flag & BP_HARDWAREFLAG;
5150 tempflag = flag & BP_TEMPFLAG;
5156 parse_args.arg_p = &arg;
5157 parse_args.sals_p = &sals;
5158 parse_args.addr_string_p = &addr_string;
5159 parse_args.not_found_ptr = ¬_found;
5161 e = catch_exception (uiout, do_captured_parse_breakpoint,
5162 &parse_args, RETURN_MASK_ALL);
5164 /* If caller is interested in rc value from parse, set value. */
5168 exception_print (gdb_stderr, e);
5173 case NOT_FOUND_ERROR:
5174 /* If called to resolve pending breakpoint, just return
5179 exception_print (gdb_stderr, e);
5181 /* If pending breakpoint support is turned off, throw
5184 if (pending_break_support == AUTO_BOOLEAN_FALSE)
5185 deprecated_throw_reason (RETURN_ERROR);
5187 /* If pending breakpoint support is auto query and the user
5188 selects no, then simply return the error code. */
5189 if (pending_break_support == AUTO_BOOLEAN_AUTO &&
5190 !nquery ("Make breakpoint pending on future shared library load? "))
5193 /* At this point, either the user was queried about setting
5194 a pending breakpoint and selected yes, or pending
5195 breakpoint behavior is on and thus a pending breakpoint
5196 is defaulted on behalf of the user. */
5197 copy_arg = xstrdup (addr_start);
5198 addr_string = ©_arg;
5200 sals.sals = &pending_sal;
5205 exception_print (gdb_stderr, e);
5213 /* Create a chain of things that always need to be cleaned up. */
5214 old_chain = make_cleanup (null_cleanup, 0);
5218 /* Make sure that all storage allocated to SALS gets freed. */
5219 make_cleanup (xfree, sals.sals);
5221 /* Cleanup the addr_string array but not its contents. */
5222 make_cleanup (xfree, addr_string);
5225 /* Allocate space for all the cond expressions. */
5226 cond = xcalloc (sals.nelts, sizeof (struct expression *));
5227 make_cleanup (xfree, cond);
5229 /* Allocate space for all the cond strings. */
5230 cond_string = xcalloc (sals.nelts, sizeof (char **));
5231 make_cleanup (xfree, cond_string);
5233 /* ----------------------------- SNIP -----------------------------
5234 Anything added to the cleanup chain beyond this point is assumed
5235 to be part of a breakpoint. If the breakpoint create succeeds
5236 then the memory is not reclaimed. */
5237 breakpoint_chain = make_cleanup (null_cleanup, 0);
5239 /* Mark the contents of the addr_string for cleanup. These go on
5240 the breakpoint_chain and only occure if the breakpoint create
5242 for (i = 0; i < sals.nelts; i++)
5244 if (addr_string[i] != NULL)
5245 make_cleanup (xfree, addr_string[i]);
5248 /* Resolve all line numbers to PC's and verify that the addresses
5249 are ok for the target. */
5251 breakpoint_sals_to_pc (&sals, addr_start);
5253 /* Verify that condition can be parsed, before setting any
5254 breakpoints. Allocate a separate condition expression for each
5256 thread = -1; /* No specific thread yet */
5259 for (i = 0; i < sals.nelts; i++)
5266 char *cond_start = NULL;
5267 char *cond_end = NULL;
5268 while (*tok == ' ' || *tok == '\t')
5273 while (*end_tok != ' ' && *end_tok != '\t' && *end_tok != '\000')
5276 toklen = end_tok - tok;
5278 if (toklen >= 1 && strncmp (tok, "if", toklen) == 0)
5280 tok = cond_start = end_tok + 1;
5281 cond[i] = parse_exp_1 (&tok, block_for_pc (sals.sals[i].pc),
5283 make_cleanup (xfree, cond[i]);
5285 cond_string[i] = savestring (cond_start,
5286 cond_end - cond_start);
5287 make_cleanup (xfree, cond_string[i]);
5289 else if (toklen >= 1 && strncmp (tok, "thread", toklen) == 0)
5295 thread = strtol (tok, &tok, 0);
5297 error (_("Junk after thread keyword."));
5298 if (!valid_thread_id (thread))
5299 error (_("Unknown thread %d."), thread);
5302 error (_("Junk at end of arguments."));
5305 create_breakpoints (sals, addr_string, cond, cond_string,
5306 hardwareflag ? bp_hardware_breakpoint
5308 tempflag ? disp_del : disp_donttouch,
5309 thread, ignore_count, from_tty,
5314 struct symtab_and_line sal;
5315 struct breakpoint *b;
5320 make_cleanup (xfree, copy_arg);
5322 b = set_raw_breakpoint (sal, hardwareflag ? bp_hardware_breakpoint
5324 set_breakpoint_count (breakpoint_count + 1);
5325 b->number = breakpoint_count;
5328 b->addr_string = *addr_string;
5329 b->cond_string = *cond_string;
5330 b->ignore_count = ignore_count;
5332 b->disposition = tempflag ? disp_del : disp_donttouch;
5333 b->from_tty = from_tty;
5339 warning (_("Multiple breakpoints were set.\n"
5340 "Use the \"delete\" command to delete unwanted breakpoints."));
5341 /* That's it. Discard the cleanups for data inserted into the
5343 discard_cleanups (breakpoint_chain);
5344 /* But cleanup everything else. */
5345 do_cleanups (old_chain);
5350 /* Set a breakpoint of TYPE/DISPOSITION according to ARG (function,
5351 linenum or *address) with COND and IGNORE_COUNT. */
5353 struct captured_breakpoint_args
5364 do_captured_breakpoint (struct ui_out *uiout, void *data)
5366 struct captured_breakpoint_args *args = data;
5367 struct symtabs_and_lines sals;
5368 struct expression **cond;
5369 struct cleanup *old_chain;
5370 struct cleanup *breakpoint_chain = NULL;
5377 /* Parse the source and lines spec. Delay check that the expression
5378 didn't contain trailing garbage until after cleanups are in
5382 address_end = args->address;
5384 parse_breakpoint_sals (&address_end, &sals, &addr_string, 0);
5389 /* Create a chain of things at always need to be cleaned up. */
5390 old_chain = make_cleanup (null_cleanup, 0);
5392 /* Always have a addr_string array, even if it is empty. */
5393 make_cleanup (xfree, addr_string);
5395 /* Make sure that all storage allocated to SALS gets freed. */
5396 make_cleanup (xfree, sals.sals);
5398 /* Allocate space for all the cond expressions. */
5399 cond = xcalloc (sals.nelts, sizeof (struct expression *));
5400 make_cleanup (xfree, cond);
5402 /* Allocate space for all the cond strings. */
5403 cond_string = xcalloc (sals.nelts, sizeof (char **));
5404 make_cleanup (xfree, cond_string);
5406 /* ----------------------------- SNIP -----------------------------
5407 Anything added to the cleanup chain beyond this point is assumed
5408 to be part of a breakpoint. If the breakpoint create goes
5409 through then that memory is not cleaned up. */
5410 breakpoint_chain = make_cleanup (null_cleanup, 0);
5412 /* Mark the contents of the addr_string for cleanup. These go on
5413 the breakpoint_chain and only occure if the breakpoint create
5415 for (i = 0; i < sals.nelts; i++)
5417 if (addr_string[i] != NULL)
5418 make_cleanup (xfree, addr_string[i]);
5421 /* Wait until now before checking for garbage at the end of the
5422 address. That way cleanups can take care of freeing any
5424 if (*address_end != '\0')
5425 error (_("Garbage %s following breakpoint address"), address_end);
5427 /* Resolve all line numbers to PC's. */
5428 breakpoint_sals_to_pc (&sals, args->address);
5430 /* Verify that conditions can be parsed, before setting any
5432 for (i = 0; i < sals.nelts; i++)
5434 if (args->condition != NULL)
5436 char *tok = args->condition;
5437 cond[i] = parse_exp_1 (&tok, block_for_pc (sals.sals[i].pc), 0);
5439 error (_("Garbage %s follows condition"), tok);
5440 make_cleanup (xfree, cond[i]);
5441 cond_string[i] = xstrdup (args->condition);
5445 create_breakpoints (sals, addr_string, cond, cond_string,
5446 args->hardwareflag ? bp_hardware_breakpoint : bp_breakpoint,
5447 args->tempflag ? disp_del : disp_donttouch,
5448 args->thread, args->ignore_count, 0/*from-tty*/,
5449 NULL/*pending_bp*/);
5451 /* That's it. Discard the cleanups for data inserted into the
5453 discard_cleanups (breakpoint_chain);
5454 /* But cleanup everything else. */
5455 do_cleanups (old_chain);
5460 gdb_breakpoint (char *address, char *condition,
5461 int hardwareflag, int tempflag,
5462 int thread, int ignore_count,
5463 char **error_message)
5465 struct captured_breakpoint_args args;
5466 args.address = address;
5467 args.condition = condition;
5468 args.hardwareflag = hardwareflag;
5469 args.tempflag = tempflag;
5470 args.thread = thread;
5471 args.ignore_count = ignore_count;
5472 return catch_exceptions_with_msg (uiout, do_captured_breakpoint, &args,
5473 error_message, RETURN_MASK_ALL);
5477 /* Helper function for break_command_1 and disassemble_command. */
5480 resolve_sal_pc (struct symtab_and_line *sal)
5484 if (sal->pc == 0 && sal->symtab != NULL)
5486 if (!find_line_pc (sal->symtab, sal->line, &pc))
5487 error (_("No line %d in file \"%s\"."),
5488 sal->line, sal->symtab->filename);
5492 if (sal->section == 0 && sal->symtab != NULL)
5494 struct blockvector *bv;
5499 bv = blockvector_for_pc_sect (sal->pc, 0, &index, sal->symtab);
5502 b = BLOCKVECTOR_BLOCK (bv, index);
5503 sym = block_function (b);
5506 fixup_symbol_section (sym, sal->symtab->objfile);
5507 sal->section = SYMBOL_BFD_SECTION (sym);
5511 /* It really is worthwhile to have the section, so we'll just
5512 have to look harder. This case can be executed if we have
5513 line numbers but no functions (as can happen in assembly
5516 struct minimal_symbol *msym;
5518 msym = lookup_minimal_symbol_by_pc (sal->pc);
5520 sal->section = SYMBOL_BFD_SECTION (msym);
5527 break_command (char *arg, int from_tty)
5529 break_command_1 (arg, 0, from_tty, NULL);
5533 tbreak_command (char *arg, int from_tty)
5535 break_command_1 (arg, BP_TEMPFLAG, from_tty, NULL);
5539 hbreak_command (char *arg, int from_tty)
5541 break_command_1 (arg, BP_HARDWAREFLAG, from_tty, NULL);
5545 thbreak_command (char *arg, int from_tty)
5547 break_command_1 (arg, (BP_TEMPFLAG | BP_HARDWAREFLAG), from_tty, NULL);
5551 stop_command (char *arg, int from_tty)
5553 printf_filtered (_("Specify the type of breakpoint to set.\n\
5554 Usage: stop in <function | address>\n\
5555 stop at <line>\n"));
5559 stopin_command (char *arg, int from_tty)
5563 if (arg == (char *) NULL)
5565 else if (*arg != '*')
5570 /* look for a ':'. If this is a line number specification, then
5571 say it is bad, otherwise, it should be an address or
5572 function/method name */
5573 while (*argptr && !hasColon)
5575 hasColon = (*argptr == ':');
5580 badInput = (*argptr != ':'); /* Not a class::method */
5582 badInput = isdigit (*arg); /* a simple line number */
5586 printf_filtered (_("Usage: stop in <function | address>\n"));
5588 break_command_1 (arg, 0, from_tty, NULL);
5592 stopat_command (char *arg, int from_tty)
5596 if (arg == (char *) NULL || *arg == '*') /* no line number */
5603 /* look for a ':'. If there is a '::' then get out, otherwise
5604 it is probably a line number. */
5605 while (*argptr && !hasColon)
5607 hasColon = (*argptr == ':');
5612 badInput = (*argptr == ':'); /* we have class::method */
5614 badInput = !isdigit (*arg); /* not a line number */
5618 printf_filtered (_("Usage: stop at <line>\n"));
5620 break_command_1 (arg, 0, from_tty, NULL);
5623 /* accessflag: hw_write: watch write,
5624 hw_read: watch read,
5625 hw_access: watch access (read or write) */
5627 watch_command_1 (char *arg, int accessflag, int from_tty)
5629 struct breakpoint *b;
5630 struct symtab_and_line sal;
5631 struct expression *exp;
5632 struct block *exp_valid_block;
5633 struct value *val, *mark;
5634 struct frame_info *frame;
5635 struct frame_info *prev_frame = NULL;
5636 char *exp_start = NULL;
5637 char *exp_end = NULL;
5638 char *tok, *end_tok;
5640 char *cond_start = NULL;
5641 char *cond_end = NULL;
5642 struct expression *cond = NULL;
5643 int i, other_type_used, target_resources_ok = 0;
5644 enum bptype bp_type;
5647 init_sal (&sal); /* initialize to zeroes */
5649 /* Parse arguments. */
5650 innermost_block = NULL;
5652 exp = parse_exp_1 (&arg, 0, 0);
5654 exp_valid_block = innermost_block;
5655 mark = value_mark ();
5656 val = evaluate_expression (exp);
5657 release_value (val);
5658 if (value_lazy (val))
5659 value_fetch_lazy (val);
5662 while (*tok == ' ' || *tok == '\t')
5666 while (*end_tok != ' ' && *end_tok != '\t' && *end_tok != '\000')
5669 toklen = end_tok - tok;
5670 if (toklen >= 1 && strncmp (tok, "if", toklen) == 0)
5672 tok = cond_start = end_tok + 1;
5673 cond = parse_exp_1 (&tok, 0, 0);
5677 error (_("Junk at end of command."));
5679 if (accessflag == hw_read)
5680 bp_type = bp_read_watchpoint;
5681 else if (accessflag == hw_access)
5682 bp_type = bp_access_watchpoint;
5684 bp_type = bp_hardware_watchpoint;
5686 mem_cnt = can_use_hardware_watchpoint (val);
5687 if (mem_cnt == 0 && bp_type != bp_hardware_watchpoint)
5688 error (_("Expression cannot be implemented with read/access watchpoint."));
5691 i = hw_watchpoint_used_count (bp_type, &other_type_used);
5692 target_resources_ok =
5693 TARGET_CAN_USE_HARDWARE_WATCHPOINT (bp_type, i + mem_cnt,
5695 if (target_resources_ok == 0 && bp_type != bp_hardware_watchpoint)
5696 error (_("Target does not support this type of hardware watchpoint."));
5698 if (target_resources_ok < 0 && bp_type != bp_hardware_watchpoint)
5699 error (_("Target can only support one kind of HW watchpoint at a time."));
5702 #if defined(HPUXHPPA)
5703 /* On HP-UX if you set a h/w
5704 watchpoint before the "run" command, the inferior dies with a e.g.,
5705 SIGILL once you start it. I initially believed this was due to a
5706 bad interaction between page protection traps and the initial
5707 startup sequence by the dynamic linker.
5709 However, I tried avoiding that by having HP-UX's implementation of
5710 TARGET_CAN_USE_HW_WATCHPOINT return FALSE if there was no inferior_ptid
5711 yet, which forced slow watches before a "run" or "attach", and it
5712 still fails somewhere in the startup code.
5714 Until I figure out what's happening, I'm disallowing watches altogether
5715 before the "run" or "attach" command. We'll tell the user they must
5716 set watches after getting the program started. */
5717 if (!target_has_execution)
5719 warning (_("can't do that without a running program; try \"break main\"), \"run\" first");
5722 #endif /* HPUXHPPA */
5724 /* Change the type of breakpoint to an ordinary watchpoint if a hardware
5725 watchpoint could not be set. */
5726 if (!mem_cnt || target_resources_ok <= 0)
5727 bp_type = bp_watchpoint;
5729 /* Now set up the breakpoint. */
5730 b = set_raw_breakpoint (sal, bp_type);
5731 set_breakpoint_count (breakpoint_count + 1);
5732 b->number = breakpoint_count;
5733 b->disposition = disp_donttouch;
5735 b->exp_valid_block = exp_valid_block;
5736 b->exp_string = savestring (exp_start, exp_end - exp_start);
5740 b->cond_string = savestring (cond_start, cond_end - cond_start);
5744 frame = block_innermost_frame (exp_valid_block);
5747 prev_frame = get_prev_frame (frame);
5748 b->watchpoint_frame = get_frame_id (frame);
5752 memset (&b->watchpoint_frame, 0, sizeof (b->watchpoint_frame));
5755 /* If the expression is "local", then set up a "watchpoint scope"
5756 breakpoint at the point where we've left the scope of the watchpoint
5758 if (innermost_block)
5762 struct breakpoint *scope_breakpoint;
5763 scope_breakpoint = create_internal_breakpoint (get_frame_pc (prev_frame),
5764 bp_watchpoint_scope);
5766 scope_breakpoint->enable_state = bp_enabled;
5768 /* Automatically delete the breakpoint when it hits. */
5769 scope_breakpoint->disposition = disp_del;
5771 /* Only break in the proper frame (help with recursion). */
5772 scope_breakpoint->frame_id = get_frame_id (prev_frame);
5774 /* Set the address at which we will stop. */
5775 scope_breakpoint->loc->requested_address
5776 = get_frame_pc (prev_frame);
5777 scope_breakpoint->loc->address
5778 = adjust_breakpoint_address (scope_breakpoint->loc->requested_address,
5779 scope_breakpoint->type);
5781 /* The scope breakpoint is related to the watchpoint. We
5782 will need to act on them together. */
5783 b->related_breakpoint = scope_breakpoint;
5786 value_free_to_mark (mark);
5790 /* Return count of locations need to be watched and can be handled
5791 in hardware. If the watchpoint can not be handled
5792 in hardware return zero. */
5794 #if !defined(TARGET_REGION_OK_FOR_HW_WATCHPOINT)
5795 #define TARGET_REGION_OK_FOR_HW_WATCHPOINT(ADDR,LEN) \
5796 (TARGET_REGION_SIZE_OK_FOR_HW_WATCHPOINT(LEN))
5800 can_use_hardware_watchpoint (struct value *v)
5802 int found_memory_cnt = 0;
5803 struct value *head = v;
5805 /* Did the user specifically forbid us to use hardware watchpoints? */
5806 if (!can_use_hw_watchpoints)
5809 /* Make sure that the value of the expression depends only upon
5810 memory contents, and values computed from them within GDB. If we
5811 find any register references or function calls, we can't use a
5812 hardware watchpoint.
5814 The idea here is that evaluating an expression generates a series
5815 of values, one holding the value of every subexpression. (The
5816 expression a*b+c has five subexpressions: a, b, a*b, c, and
5817 a*b+c.) GDB's values hold almost enough information to establish
5818 the criteria given above --- they identify memory lvalues,
5819 register lvalues, computed values, etcetera. So we can evaluate
5820 the expression, and then scan the chain of values that leaves
5821 behind to decide whether we can detect any possible change to the
5822 expression's final value using only hardware watchpoints.
5824 However, I don't think that the values returned by inferior
5825 function calls are special in any way. So this function may not
5826 notice that an expression involving an inferior function call
5827 can't be watched with hardware watchpoints. FIXME. */
5828 for (; v; v = value_next (v))
5830 if (VALUE_LVAL (v) == lval_memory)
5833 /* A lazy memory lvalue is one that GDB never needed to fetch;
5834 we either just used its address (e.g., `a' in `a.b') or
5835 we never needed it at all (e.g., `a' in `a,b'). */
5839 /* Ahh, memory we actually used! Check if we can cover
5840 it with hardware watchpoints. */
5841 struct type *vtype = check_typedef (value_type (v));
5843 /* We only watch structs and arrays if user asked for it
5844 explicitly, never if they just happen to appear in a
5845 middle of some value chain. */
5847 || (TYPE_CODE (vtype) != TYPE_CODE_STRUCT
5848 && TYPE_CODE (vtype) != TYPE_CODE_ARRAY))
5850 CORE_ADDR vaddr = VALUE_ADDRESS (v) + value_offset (v);
5851 int len = TYPE_LENGTH (value_type (v));
5853 if (!TARGET_REGION_OK_FOR_HW_WATCHPOINT (vaddr, len))
5860 else if (VALUE_LVAL (v) != not_lval
5861 && deprecated_value_modifiable (v) == 0)
5862 return 0; /* ??? What does this represent? */
5863 else if (VALUE_LVAL (v) == lval_register)
5864 return 0; /* cannot watch a register with a HW watchpoint */
5867 /* The expression itself looks suitable for using a hardware
5868 watchpoint, but give the target machine a chance to reject it. */
5869 return found_memory_cnt;
5873 watch_command_wrapper (char *arg, int from_tty)
5875 watch_command (arg, from_tty);
5879 watch_command (char *arg, int from_tty)
5881 watch_command_1 (arg, hw_write, from_tty);
5885 rwatch_command_wrapper (char *arg, int from_tty)
5887 rwatch_command (arg, from_tty);
5891 rwatch_command (char *arg, int from_tty)
5893 watch_command_1 (arg, hw_read, from_tty);
5897 awatch_command_wrapper (char *arg, int from_tty)
5899 awatch_command (arg, from_tty);
5903 awatch_command (char *arg, int from_tty)
5905 watch_command_1 (arg, hw_access, from_tty);
5909 /* Helper routines for the until_command routine in infcmd.c. Here
5910 because it uses the mechanisms of breakpoints. */
5912 /* This function is called by fetch_inferior_event via the
5913 cmd_continuation pointer, to complete the until command. It takes
5914 care of cleaning up the temporary breakpoints set up by the until
5917 until_break_command_continuation (struct continuation_arg *arg)
5919 struct cleanup *cleanups;
5921 cleanups = (struct cleanup *) arg->data.pointer;
5922 do_exec_cleanups (cleanups);
5926 until_break_command (char *arg, int from_tty, int anywhere)
5928 struct symtabs_and_lines sals;
5929 struct symtab_and_line sal;
5930 struct frame_info *prev_frame = get_prev_frame (deprecated_selected_frame);
5931 struct breakpoint *breakpoint;
5932 struct cleanup *old_chain;
5933 struct continuation_arg *arg1;
5936 clear_proceed_status ();
5938 /* Set a breakpoint where the user wants it and at return from
5941 if (default_breakpoint_valid)
5942 sals = decode_line_1 (&arg, 1, default_breakpoint_symtab,
5943 default_breakpoint_line, (char ***) NULL, NULL);
5945 sals = decode_line_1 (&arg, 1, (struct symtab *) NULL,
5946 0, (char ***) NULL, NULL);
5948 if (sals.nelts != 1)
5949 error (_("Couldn't get information on specified line."));
5952 xfree (sals.sals); /* malloc'd, so freed */
5955 error (_("Junk at end of arguments."));
5957 resolve_sal_pc (&sal);
5960 /* If the user told us to continue until a specified location,
5961 we don't specify a frame at which we need to stop. */
5962 breakpoint = set_momentary_breakpoint (sal, null_frame_id, bp_until);
5964 /* Otherwise, specify the current frame, because we want to stop only
5965 at the very same frame. */
5966 breakpoint = set_momentary_breakpoint (sal,
5967 get_frame_id (deprecated_selected_frame),
5970 if (!target_can_async_p ())
5971 old_chain = make_cleanup_delete_breakpoint (breakpoint);
5973 old_chain = make_exec_cleanup_delete_breakpoint (breakpoint);
5975 /* If we are running asynchronously, and the target supports async
5976 execution, we are not waiting for the target to stop, in the call
5977 tp proceed, below. This means that we cannot delete the
5978 brekpoints until the target has actually stopped. The only place
5979 where we get a chance to do that is in fetch_inferior_event, so
5980 we must set things up for that. */
5982 if (target_can_async_p ())
5984 /* In this case the arg for the continuation is just the point
5985 in the exec_cleanups chain from where to start doing
5986 cleanups, because all the continuation does is the cleanups in
5987 the exec_cleanup_chain. */
5989 (struct continuation_arg *) xmalloc (sizeof (struct continuation_arg));
5991 arg1->data.pointer = old_chain;
5993 add_continuation (until_break_command_continuation, arg1);
5996 /* Keep within the current frame, or in frames called by the current
6000 sal = find_pc_line (get_frame_pc (prev_frame), 0);
6001 sal.pc = get_frame_pc (prev_frame);
6002 breakpoint = set_momentary_breakpoint (sal, get_frame_id (prev_frame),
6004 if (!target_can_async_p ())
6005 make_cleanup_delete_breakpoint (breakpoint);
6007 make_exec_cleanup_delete_breakpoint (breakpoint);
6010 proceed (-1, TARGET_SIGNAL_DEFAULT, 0);
6011 /* Do the cleanups now, anly if we are not running asynchronously,
6012 of if we are, but the target is still synchronous. */
6013 if (!target_can_async_p ())
6014 do_cleanups (old_chain);
6018 ep_skip_leading_whitespace (char **s)
6020 if ((s == NULL) || (*s == NULL))
6022 while (isspace (**s))
6026 /* This function examines a string, and attempts to find a token
6027 that might be an event name in the leading characters. If a
6028 possible match is found, a pointer to the last character of
6029 the token is returned. Else, NULL is returned. */
6032 ep_find_event_name_end (char *arg)
6035 char *event_name_end = NULL;
6037 /* If we could depend upon the presense of strrpbrk, we'd use that... */
6041 /* We break out of the loop when we find a token delimiter.
6042 Basically, we're looking for alphanumerics and underscores;
6043 anything else delimites the token. */
6046 if (!isalnum (*s) && (*s != '_'))
6052 return event_name_end;
6056 /* This function attempts to parse an optional "if <cond>" clause
6057 from the arg string. If one is not found, it returns NULL.
6059 Else, it returns a pointer to the condition string. (It does not
6060 attempt to evaluate the string against a particular block.) And,
6061 it updates arg to point to the first character following the parsed
6062 if clause in the arg string. */
6065 ep_parse_optional_if_clause (char **arg)
6069 if (((*arg)[0] != 'i') || ((*arg)[1] != 'f') || !isspace ((*arg)[2]))
6072 /* Skip the "if" keyword. */
6075 /* Skip any extra leading whitespace, and record the start of the
6076 condition string. */
6077 ep_skip_leading_whitespace (arg);
6080 /* Assume that the condition occupies the remainder of the arg string. */
6081 (*arg) += strlen (cond_string);
6086 /* This function attempts to parse an optional filename from the arg
6087 string. If one is not found, it returns NULL.
6089 Else, it returns a pointer to the parsed filename. (This function
6090 makes no attempt to verify that a file of that name exists, or is
6091 accessible.) And, it updates arg to point to the first character
6092 following the parsed filename in the arg string.
6094 Note that clients needing to preserve the returned filename for
6095 future access should copy it to their own buffers. */
6097 ep_parse_optional_filename (char **arg)
6099 static char filename[1024];
6104 if ((*arg_p == '\0') || isspace (*arg_p))
6122 /* Commands to deal with catching events, such as signals, exceptions,
6123 process start/exit, etc. */
6127 catch_fork, catch_vfork
6132 catch_fork_command_1 (catch_fork_kind fork_kind, char *arg, int tempflag,
6135 char *cond_string = NULL;
6137 ep_skip_leading_whitespace (&arg);
6139 /* The allowed syntax is:
6141 catch [v]fork if <cond>
6143 First, check if there's an if clause. */
6144 cond_string = ep_parse_optional_if_clause (&arg);
6146 if ((*arg != '\0') && !isspace (*arg))
6147 error (_("Junk at end of arguments."));
6149 /* If this target supports it, create a fork or vfork catchpoint
6150 and enable reporting of such events. */
6154 create_fork_event_catchpoint (tempflag, cond_string);
6157 create_vfork_event_catchpoint (tempflag, cond_string);
6160 error (_("unsupported or unknown fork kind; cannot catch it"));
6166 catch_exec_command_1 (char *arg, int tempflag, int from_tty)
6168 char *cond_string = NULL;
6170 ep_skip_leading_whitespace (&arg);
6172 /* The allowed syntax is:
6174 catch exec if <cond>
6176 First, check if there's an if clause. */
6177 cond_string = ep_parse_optional_if_clause (&arg);
6179 if ((*arg != '\0') && !isspace (*arg))
6180 error (_("Junk at end of arguments."));
6182 /* If this target supports it, create an exec catchpoint
6183 and enable reporting of such events. */
6184 create_exec_event_catchpoint (tempflag, cond_string);
6188 catch_load_command_1 (char *arg, int tempflag, int from_tty)
6190 char *dll_pathname = NULL;
6191 char *cond_string = NULL;
6193 ep_skip_leading_whitespace (&arg);
6195 /* The allowed syntax is:
6197 catch load if <cond>
6198 catch load <filename>
6199 catch load <filename> if <cond>
6201 The user is not allowed to specify the <filename> after an
6204 We'll ignore the pathological case of a file named "if".
6206 First, check if there's an if clause. If so, then there
6207 cannot be a filename. */
6208 cond_string = ep_parse_optional_if_clause (&arg);
6210 /* If there was an if clause, then there cannot be a filename.
6211 Else, there might be a filename and an if clause. */
6212 if (cond_string == NULL)
6214 dll_pathname = ep_parse_optional_filename (&arg);
6215 ep_skip_leading_whitespace (&arg);
6216 cond_string = ep_parse_optional_if_clause (&arg);
6219 if ((*arg != '\0') && !isspace (*arg))
6220 error (_("Junk at end of arguments."));
6222 /* Create a load breakpoint that only triggers when a load of
6223 the specified dll (or any dll, if no pathname was specified)
6225 SOLIB_CREATE_CATCH_LOAD_HOOK (PIDGET (inferior_ptid), tempflag,
6226 dll_pathname, cond_string);
6230 catch_unload_command_1 (char *arg, int tempflag, int from_tty)
6232 char *dll_pathname = NULL;
6233 char *cond_string = NULL;
6235 ep_skip_leading_whitespace (&arg);
6237 /* The allowed syntax is:
6239 catch unload if <cond>
6240 catch unload <filename>
6241 catch unload <filename> if <cond>
6243 The user is not allowed to specify the <filename> after an
6246 We'll ignore the pathological case of a file named "if".
6248 First, check if there's an if clause. If so, then there
6249 cannot be a filename. */
6250 cond_string = ep_parse_optional_if_clause (&arg);
6252 /* If there was an if clause, then there cannot be a filename.
6253 Else, there might be a filename and an if clause. */
6254 if (cond_string == NULL)
6256 dll_pathname = ep_parse_optional_filename (&arg);
6257 ep_skip_leading_whitespace (&arg);
6258 cond_string = ep_parse_optional_if_clause (&arg);
6261 if ((*arg != '\0') && !isspace (*arg))
6262 error (_("Junk at end of arguments."));
6264 /* Create an unload breakpoint that only triggers when an unload of
6265 the specified dll (or any dll, if no pathname was specified)
6267 SOLIB_CREATE_CATCH_UNLOAD_HOOK (PIDGET (inferior_ptid), tempflag,
6268 dll_pathname, cond_string);
6271 /* Commands to deal with catching exceptions. */
6273 /* Set a breakpoint at the specified callback routine for an
6274 exception event callback */
6277 create_exception_catchpoint (int tempflag, char *cond_string,
6278 enum exception_event_kind ex_event,
6279 struct symtab_and_line *sal)
6281 struct breakpoint *b;
6282 int thread = -1; /* All threads. */
6285 if (!sal) /* no exception support? */
6290 case EX_EVENT_THROW:
6291 bptype = bp_catch_throw;
6293 case EX_EVENT_CATCH:
6294 bptype = bp_catch_catch;
6296 default: /* error condition */
6297 error (_("Internal error -- invalid catchpoint kind"));
6300 b = set_raw_breakpoint (*sal, bptype);
6301 set_breakpoint_count (breakpoint_count + 1);
6302 b->number = breakpoint_count;
6304 b->cond_string = (cond_string == NULL) ?
6305 NULL : savestring (cond_string, strlen (cond_string));
6307 b->addr_string = NULL;
6308 b->enable_state = bp_enabled;
6309 b->disposition = tempflag ? disp_del : disp_donttouch;
6313 static enum print_stop_action
6314 print_exception_catchpoint (struct breakpoint *b)
6316 annotate_catchpoint (b->number);
6318 if (strstr (b->addr_string, "throw") != NULL)
6319 printf_filtered (_("\nCatchpoint %d (exception thrown)\n"),
6322 printf_filtered (_("\nCatchpoint %d (exception caught)\n"),
6325 return PRINT_SRC_AND_LOC;
6329 print_one_exception_catchpoint (struct breakpoint *b, CORE_ADDR *last_addr)
6334 ui_out_field_core_addr (uiout, "addr", b->loc->address);
6337 *last_addr = b->loc->address;
6338 if (strstr (b->addr_string, "throw") != NULL)
6339 ui_out_field_string (uiout, "what", "exception throw");
6341 ui_out_field_string (uiout, "what", "exception catch");
6345 print_mention_exception_catchpoint (struct breakpoint *b)
6347 if (strstr (b->addr_string, "throw") != NULL)
6348 printf_filtered (_("Catchpoint %d (throw)"), b->number);
6350 printf_filtered (_("Catchpoint %d (catch)"), b->number);
6353 static struct breakpoint_ops gnu_v3_exception_catchpoint_ops = {
6354 print_exception_catchpoint,
6355 print_one_exception_catchpoint,
6356 print_mention_exception_catchpoint
6360 handle_gnu_v3_exceptions (int tempflag, char *cond_string,
6361 enum exception_event_kind ex_event, int from_tty)
6363 char *trigger_func_name, *nameptr;
6364 struct symtabs_and_lines sals;
6365 struct breakpoint *b;
6367 if (ex_event == EX_EVENT_CATCH)
6368 trigger_func_name = xstrdup ("__cxa_begin_catch");
6370 trigger_func_name = xstrdup ("__cxa_throw");
6372 nameptr = trigger_func_name;
6373 sals = decode_line_1 (&nameptr, 1, NULL, 0, NULL, NULL);
6374 if (sals.nelts == 0)
6376 xfree (trigger_func_name);
6380 b = set_raw_breakpoint (sals.sals[0], bp_breakpoint);
6381 set_breakpoint_count (breakpoint_count + 1);
6382 b->number = breakpoint_count;
6384 b->cond_string = (cond_string == NULL) ?
6385 NULL : savestring (cond_string, strlen (cond_string));
6387 b->addr_string = trigger_func_name;
6388 b->enable_state = bp_enabled;
6389 b->disposition = tempflag ? disp_del : disp_donttouch;
6390 b->ops = &gnu_v3_exception_catchpoint_ops;
6397 /* Deal with "catch catch" and "catch throw" commands */
6400 catch_exception_command_1 (enum exception_event_kind ex_event, char *arg,
6401 int tempflag, int from_tty)
6403 char *cond_string = NULL;
6404 struct symtab_and_line *sal = NULL;
6406 ep_skip_leading_whitespace (&arg);
6408 cond_string = ep_parse_optional_if_clause (&arg);
6410 if ((*arg != '\0') && !isspace (*arg))
6411 error (_("Junk at end of arguments."));
6413 if ((ex_event != EX_EVENT_THROW) &&
6414 (ex_event != EX_EVENT_CATCH))
6415 error (_("Unsupported or unknown exception event; cannot catch it"));
6417 if (handle_gnu_v3_exceptions (tempflag, cond_string, ex_event, from_tty))
6420 /* See if we can find a callback routine */
6421 sal = target_enable_exception_callback (ex_event, 1);
6425 /* We have callbacks from the runtime system for exceptions.
6426 Set a breakpoint on the sal found, if no errors */
6427 if (sal != (struct symtab_and_line *) -1)
6428 create_exception_catchpoint (tempflag, cond_string, ex_event, sal);
6430 return; /* something went wrong with setting up callbacks */
6433 warning (_("Unsupported with this platform/compiler combination."));
6436 /* Cover routine to allow wrapping target_enable_exception_catchpoints
6437 inside a catch_errors */
6440 cover_target_enable_exception_callback (void *arg)
6442 args_for_catchpoint_enable *args = arg;
6443 struct symtab_and_line *sal;
6444 sal = target_enable_exception_callback (args->kind, args->enable_p);
6447 else if (sal == (struct symtab_and_line *) -1)
6450 return 1; /*is valid */
6454 catch_command_1 (char *arg, int tempflag, int from_tty)
6457 /* The first argument may be an event name, such as "start" or "load".
6458 If so, then handle it as such. If it doesn't match an event name,
6459 then attempt to interpret it as an exception name. (This latter is
6460 the v4.16-and-earlier GDB meaning of the "catch" command.)
6462 First, try to find the bounds of what might be an event name. */
6463 char *arg1_start = arg;
6467 if (arg1_start == NULL)
6469 /* Old behaviour was to use pre-v-4.16 syntax */
6470 /* catch_throw_command_1 (arg1_start, tempflag, from_tty); */
6472 /* Now, this is not allowed */
6473 error (_("Catch requires an event name."));
6476 arg1_end = ep_find_event_name_end (arg1_start);
6477 if (arg1_end == NULL)
6478 error (_("catch requires an event"));
6479 arg1_length = arg1_end + 1 - arg1_start;
6481 /* Try to match what we found against known event names. */
6482 if (strncmp (arg1_start, "signal", arg1_length) == 0)
6484 error (_("Catch of signal not yet implemented"));
6486 else if (strncmp (arg1_start, "catch", arg1_length) == 0)
6488 catch_exception_command_1 (EX_EVENT_CATCH, arg1_end + 1,
6489 tempflag, from_tty);
6491 else if (strncmp (arg1_start, "throw", arg1_length) == 0)
6493 catch_exception_command_1 (EX_EVENT_THROW, arg1_end + 1,
6494 tempflag, from_tty);
6496 else if (strncmp (arg1_start, "thread_start", arg1_length) == 0)
6498 error (_("Catch of thread_start not yet implemented"));
6500 else if (strncmp (arg1_start, "thread_exit", arg1_length) == 0)
6502 error (_("Catch of thread_exit not yet implemented"));
6504 else if (strncmp (arg1_start, "thread_join", arg1_length) == 0)
6506 error (_("Catch of thread_join not yet implemented"));
6508 else if (strncmp (arg1_start, "start", arg1_length) == 0)
6510 error (_("Catch of start not yet implemented"));
6512 else if (strncmp (arg1_start, "exit", arg1_length) == 0)
6514 error (_("Catch of exit not yet implemented"));
6516 else if (strncmp (arg1_start, "fork", arg1_length) == 0)
6518 catch_fork_command_1 (catch_fork, arg1_end + 1, tempflag, from_tty);
6520 else if (strncmp (arg1_start, "vfork", arg1_length) == 0)
6522 catch_fork_command_1 (catch_vfork, arg1_end + 1, tempflag, from_tty);
6524 else if (strncmp (arg1_start, "exec", arg1_length) == 0)
6526 catch_exec_command_1 (arg1_end + 1, tempflag, from_tty);
6528 else if (strncmp (arg1_start, "load", arg1_length) == 0)
6530 catch_load_command_1 (arg1_end + 1, tempflag, from_tty);
6532 else if (strncmp (arg1_start, "unload", arg1_length) == 0)
6534 catch_unload_command_1 (arg1_end + 1, tempflag, from_tty);
6536 else if (strncmp (arg1_start, "stop", arg1_length) == 0)
6538 error (_("Catch of stop not yet implemented"));
6541 /* This doesn't appear to be an event name */
6545 /* Pre-v.4.16 behaviour was to treat the argument
6546 as the name of an exception */
6547 /* catch_throw_command_1 (arg1_start, tempflag, from_tty); */
6548 /* Now this is not allowed */
6549 error (_("Unknown event kind specified for catch"));
6554 /* Used by the gui, could be made a worker for other things. */
6557 set_breakpoint_sal (struct symtab_and_line sal)
6559 struct breakpoint *b;
6560 b = set_raw_breakpoint (sal, bp_breakpoint);
6561 set_breakpoint_count (breakpoint_count + 1);
6562 b->number = breakpoint_count;
6569 catch_command (char *arg, int from_tty)
6571 catch_command_1 (arg, 0, from_tty);
6576 tcatch_command (char *arg, int from_tty)
6578 catch_command_1 (arg, 1, from_tty);
6581 /* Delete breakpoints by address or line. */
6584 clear_command (char *arg, int from_tty)
6586 struct breakpoint *b, *tmp, *prev, *found;
6588 struct symtabs_and_lines sals;
6589 struct symtab_and_line sal;
6594 sals = decode_line_spec (arg, 1);
6599 sals.sals = (struct symtab_and_line *)
6600 xmalloc (sizeof (struct symtab_and_line));
6601 make_cleanup (xfree, sals.sals);
6602 init_sal (&sal); /* initialize to zeroes */
6603 sal.line = default_breakpoint_line;
6604 sal.symtab = default_breakpoint_symtab;
6605 sal.pc = default_breakpoint_address;
6606 if (sal.symtab == 0)
6607 error (_("No source file specified."));
6615 /* For each line spec given, delete bps which correspond
6616 to it. Do it in two passes, solely to preserve the current
6617 behavior that from_tty is forced true if we delete more than
6621 for (i = 0; i < sals.nelts; i++)
6623 /* If exact pc given, clear bpts at that pc.
6624 If line given (pc == 0), clear all bpts on specified line.
6625 If defaulting, clear all bpts on default line
6628 defaulting sal.pc != 0 tests to do
6633 1 0 <can't happen> */
6638 /* Find all matching breakpoints, remove them from the
6639 breakpoint chain, and add them to the 'found' chain. */
6640 ALL_BREAKPOINTS_SAFE (b, tmp)
6642 /* Are we going to delete b? */
6643 if (b->type != bp_none
6644 && b->type != bp_watchpoint
6645 && b->type != bp_hardware_watchpoint
6646 && b->type != bp_read_watchpoint
6647 && b->type != bp_access_watchpoint
6648 /* Not if b is a watchpoint of any sort... */
6649 && (((sal.pc && (b->loc->address == sal.pc))
6650 && (!section_is_overlay (b->loc->section)
6651 || b->loc->section == sal.section))
6652 /* Yes, if sal.pc matches b (modulo overlays). */
6653 || ((default_match || (0 == sal.pc))
6654 && b->source_file != NULL
6655 && sal.symtab != NULL
6656 && strcmp (b->source_file, sal.symtab->filename) == 0
6657 && b->line_number == sal.line)))
6658 /* Yes, if sal source file and line matches b. */
6660 /* Remove it from breakpoint_chain... */
6661 if (b == breakpoint_chain)
6663 /* b is at the head of the list */
6664 breakpoint_chain = b->next;
6668 prev->next = b->next;
6670 /* And add it to 'found' chain. */
6676 /* Keep b, and keep a pointer to it. */
6681 /* Now go thru the 'found' chain and delete them. */
6685 error (_("No breakpoint at %s."), arg);
6687 error (_("No breakpoint at this line."));
6691 from_tty = 1; /* Always report if deleted more than one */
6695 printf_unfiltered (_("Deleted breakpoint "));
6697 printf_unfiltered (_("Deleted breakpoints "));
6699 breakpoints_changed ();
6703 printf_unfiltered ("%d ", found->number);
6705 delete_breakpoint (found);
6709 putchar_unfiltered ('\n');
6712 /* Delete breakpoint in BS if they are `delete' breakpoints and
6713 all breakpoints that are marked for deletion, whether hit or not.
6714 This is called after any breakpoint is hit, or after errors. */
6717 breakpoint_auto_delete (bpstat bs)
6719 struct breakpoint *b, *temp;
6721 for (; bs; bs = bs->next)
6722 if (bs->breakpoint_at && bs->breakpoint_at->disposition == disp_del
6724 delete_breakpoint (bs->breakpoint_at);
6726 ALL_BREAKPOINTS_SAFE (b, temp)
6728 if (b->disposition == disp_del_at_next_stop)
6729 delete_breakpoint (b);
6733 /* Delete a breakpoint and clean up all traces of it in the data
6737 delete_breakpoint (struct breakpoint *bpt)
6739 struct breakpoint *b;
6741 struct bp_location *loc;
6743 gdb_assert (bpt != NULL);
6745 /* Has this bp already been deleted? This can happen because multiple
6746 lists can hold pointers to bp's. bpstat lists are especial culprits.
6748 One example of this happening is a watchpoint's scope bp. When the
6749 scope bp triggers, we notice that the watchpoint is out of scope, and
6750 delete it. We also delete its scope bp. But the scope bp is marked
6751 "auto-deleting", and is already on a bpstat. That bpstat is then
6752 checked for auto-deleting bp's, which are deleted.
6754 A real solution to this problem might involve reference counts in bp's,
6755 and/or giving them pointers back to their referencing bpstat's, and
6756 teaching delete_breakpoint to only free a bp's storage when no more
6757 references were extent. A cheaper bandaid was chosen. */
6758 if (bpt->type == bp_none)
6761 if (deprecated_delete_breakpoint_hook)
6762 deprecated_delete_breakpoint_hook (bpt);
6763 breakpoint_delete_event (bpt->number);
6765 if (bpt->loc->inserted)
6766 remove_breakpoint (bpt->loc, mark_inserted);
6768 free_valchain (bpt->loc);
6770 if (breakpoint_chain == bpt)
6771 breakpoint_chain = bpt->next;
6773 if (bp_location_chain == bpt->loc)
6774 bp_location_chain = bpt->loc->next;
6776 /* If we have callback-style exception catchpoints, don't go through
6777 the adjustments to the C++ runtime library etc. if the inferior
6778 isn't actually running. target_enable_exception_callback for a
6779 null target ops vector gives an undesirable error message, so we
6780 check here and avoid it. Since currently (1997-09-17) only HP-UX aCC's
6781 exceptions are supported in this way, it's OK for now. FIXME */
6782 if (ep_is_exception_catchpoint (bpt) && target_has_execution)
6784 /* Format possible error msg */
6785 char *message = xstrprintf ("Error in deleting catchpoint %d:\n",
6787 struct cleanup *cleanups = make_cleanup (xfree, message);
6788 args_for_catchpoint_enable args;
6789 args.kind = bpt->type == bp_catch_catch ?
6790 EX_EVENT_CATCH : EX_EVENT_THROW;
6792 catch_errors (cover_target_enable_exception_callback, &args,
6793 message, RETURN_MASK_ALL);
6794 do_cleanups (cleanups);
6801 b->next = bpt->next;
6805 ALL_BP_LOCATIONS (loc)
6806 if (loc->next == bpt->loc)
6808 loc->next = bpt->loc->next;
6812 check_duplicates (bpt);
6813 /* If this breakpoint was inserted, and there is another breakpoint
6814 at the same address, we need to insert the other breakpoint. */
6815 if (bpt->loc->inserted
6816 && bpt->type != bp_hardware_watchpoint
6817 && bpt->type != bp_read_watchpoint
6818 && bpt->type != bp_access_watchpoint
6819 && bpt->type != bp_catch_fork
6820 && bpt->type != bp_catch_vfork
6821 && bpt->type != bp_catch_exec)
6824 if (b->loc->address == bpt->loc->address
6825 && b->loc->section == bpt->loc->section
6826 && !b->loc->duplicate
6827 && b->enable_state != bp_disabled
6828 && b->enable_state != bp_shlib_disabled
6830 && b->enable_state != bp_call_disabled)
6834 /* We should never reach this point if there is a permanent
6835 breakpoint at the same address as the one being deleted.
6836 If there is a permanent breakpoint somewhere, it should
6837 always be the only one inserted. */
6838 if (b->enable_state == bp_permanent)
6839 internal_error (__FILE__, __LINE__,
6840 _("another breakpoint was inserted on top of "
6841 "a permanent breakpoint"));
6843 if (b->type == bp_hardware_breakpoint)
6844 val = target_insert_hw_breakpoint (b->loc->address, b->loc->shadow_contents);
6846 val = target_insert_breakpoint (b->loc->address, b->loc->shadow_contents);
6848 /* If there was an error in the insert, print a message, then stop execution. */
6851 struct ui_file *tmp_error_stream = mem_fileopen ();
6852 make_cleanup_ui_file_delete (tmp_error_stream);
6855 if (b->type == bp_hardware_breakpoint)
6857 fprintf_unfiltered (tmp_error_stream,
6858 "Cannot insert hardware breakpoint %d.\n"
6859 "You may have requested too many hardware breakpoints.\n",
6864 fprintf_unfiltered (tmp_error_stream, "Cannot insert breakpoint %d.\n", b->number);
6865 fprintf_filtered (tmp_error_stream, "Error accessing memory address ");
6866 deprecated_print_address_numeric (b->loc->address, 1, tmp_error_stream);
6867 fprintf_filtered (tmp_error_stream, ": %s.\n",
6868 safe_strerror (val));
6871 fprintf_unfiltered (tmp_error_stream,"The same program may be running in another process.");
6872 target_terminal_ours_for_output ();
6873 error_stream(tmp_error_stream);
6876 b->loc->inserted = 1;
6880 free_command_lines (&bpt->commands);
6883 if (bpt->cond_string != NULL)
6884 xfree (bpt->cond_string);
6885 if (bpt->addr_string != NULL)
6886 xfree (bpt->addr_string);
6887 if (bpt->exp != NULL)
6889 if (bpt->exp_string != NULL)
6890 xfree (bpt->exp_string);
6891 if (bpt->val != NULL)
6892 value_free (bpt->val);
6893 if (bpt->source_file != NULL)
6894 xfree (bpt->source_file);
6895 if (bpt->dll_pathname != NULL)
6896 xfree (bpt->dll_pathname);
6897 if (bpt->triggered_dll_pathname != NULL)
6898 xfree (bpt->triggered_dll_pathname);
6899 if (bpt->exec_pathname != NULL)
6900 xfree (bpt->exec_pathname);
6902 /* Be sure no bpstat's are pointing at it after it's been freed. */
6903 /* FIXME, how can we find all bpstat's?
6904 We just check stop_bpstat for now. */
6905 for (bs = stop_bpstat; bs; bs = bs->next)
6906 if (bs->breakpoint_at == bpt)
6908 bs->breakpoint_at = NULL;
6910 /* bs->commands will be freed later. */
6912 /* On the chance that someone will soon try again to delete this same
6913 bp, we mark it as deleted before freeing its storage. */
6914 bpt->type = bp_none;
6921 do_delete_breakpoint_cleanup (void *b)
6923 delete_breakpoint (b);
6927 make_cleanup_delete_breakpoint (struct breakpoint *b)
6929 return make_cleanup (do_delete_breakpoint_cleanup, b);
6933 make_exec_cleanup_delete_breakpoint (struct breakpoint *b)
6935 return make_exec_cleanup (do_delete_breakpoint_cleanup, b);
6939 delete_command (char *arg, int from_tty)
6941 struct breakpoint *b, *temp;
6947 int breaks_to_delete = 0;
6949 /* Delete all breakpoints if no argument.
6950 Do not delete internal or call-dummy breakpoints, these
6951 have to be deleted with an explicit breakpoint number argument. */
6954 if (b->type != bp_call_dummy &&
6955 b->type != bp_shlib_event &&
6956 b->type != bp_thread_event &&
6957 b->type != bp_overlay_event &&
6959 breaks_to_delete = 1;
6962 /* Ask user only if there are some breakpoints to delete. */
6964 || (breaks_to_delete && query (_("Delete all breakpoints? "))))
6966 ALL_BREAKPOINTS_SAFE (b, temp)
6968 if (b->type != bp_call_dummy &&
6969 b->type != bp_shlib_event &&
6970 b->type != bp_thread_event &&
6971 b->type != bp_overlay_event &&
6973 delete_breakpoint (b);
6978 map_breakpoint_numbers (arg, delete_breakpoint);
6981 /* Reset a breakpoint given it's struct breakpoint * BINT.
6982 The value we return ends up being the return value from catch_errors.
6983 Unused in this case. */
6986 breakpoint_re_set_one (void *bint)
6988 /* get past catch_errs */
6989 struct breakpoint *b = (struct breakpoint *) bint;
6993 int *not_found_ptr = NULL;
6994 struct symtabs_and_lines sals;
6996 enum enable_state save_enable;
7001 warning (_("attempted to reset apparently deleted breakpoint #%d?"),
7005 case bp_hardware_breakpoint:
7007 case bp_catch_unload:
7008 if (b->addr_string == NULL)
7010 /* Anything without a string can't be re-set. */
7011 delete_breakpoint (b);
7014 /* HACK: cagney/2001-11-11: kettenis/2001-11-11: MarkK wrote:
7016 ``And a hack it is, although Apple's Darwin version of GDB
7017 contains an almost identical hack to implement a "future
7018 break" command. It seems to work in many real world cases,
7019 but it is easy to come up with a test case where the patch
7020 doesn't help at all.''
7022 ``It seems that the way GDB implements breakpoints - in -
7023 shared - libraries was designed for a.out shared library
7024 systems (SunOS 4) where shared libraries were loaded at a
7025 fixed address in memory. Since ELF shared libraries can (and
7026 will) be loaded at any address in memory, things break.
7027 Fixing this is not trivial. Therefore, I'm not sure whether
7028 we should add this hack to the branch only. I cannot
7029 guarantee that things will be fixed on the trunk in the near
7032 In case we have a problem, disable this breakpoint. We'll
7033 restore its status if we succeed. Don't disable a
7034 shlib_disabled breakpoint though. There's a fair chance we
7035 can't re-set it if the shared library it's in hasn't been
7041 save_enable = b->enable_state;
7042 if (b->enable_state != bp_shlib_disabled)
7043 b->enable_state = bp_disabled;
7045 /* If resetting a shlib-disabled breakpoint, we don't want to
7046 see an error message if it is not found since we will expect
7047 this to occur until the shared library is finally reloaded.
7048 We accomplish this by giving decode_line_1 a pointer to use
7049 for silent notification that the symbol is not found. */
7050 not_found_ptr = ¬_found;
7052 set_language (b->language);
7053 input_radix = b->input_radix;
7055 sals = decode_line_1 (&s, 1, (struct symtab *) NULL, 0, (char ***) NULL,
7057 for (i = 0; i < sals.nelts; i++)
7059 resolve_sal_pc (&sals.sals[i]);
7061 /* Reparse conditions, they might contain references to the
7063 if (b->cond_string != NULL)
7069 /* Avoid re-freeing b->exp if an error during the call
7073 b->cond = parse_exp_1 (&s, block_for_pc (sals.sals[i].pc), 0);
7076 /* We need to re-set the breakpoint if the address changes... */
7077 if (b->loc->address != sals.sals[i].pc
7078 /* ...or new and old breakpoints both have source files, and
7079 the source file name or the line number changes... */
7080 || (b->source_file != NULL
7081 && sals.sals[i].symtab != NULL
7082 && (strcmp (b->source_file, sals.sals[i].symtab->filename) != 0
7083 || b->line_number != sals.sals[i].line)
7085 /* ...or we switch between having a source file and not having
7087 || ((b->source_file == NULL) != (sals.sals[i].symtab == NULL))
7090 if (b->source_file != NULL)
7091 xfree (b->source_file);
7092 if (sals.sals[i].symtab == NULL)
7093 b->source_file = NULL;
7096 savestring (sals.sals[i].symtab->filename,
7097 strlen (sals.sals[i].symtab->filename));
7098 b->line_number = sals.sals[i].line;
7099 b->loc->requested_address = sals.sals[i].pc;
7101 = adjust_breakpoint_address (b->loc->requested_address,
7104 /* Used to check for duplicates here, but that can
7105 cause trouble, as it doesn't check for disabled
7110 /* Might be better to do this just once per breakpoint_re_set,
7111 rather than once for every breakpoint. */
7112 breakpoints_changed ();
7114 b->loc->section = sals.sals[i].section;
7115 b->enable_state = save_enable; /* Restore it, this worked. */
7118 /* Now that this is re-enabled, check_duplicates
7120 check_duplicates (b);
7127 case bp_hardware_watchpoint:
7128 case bp_read_watchpoint:
7129 case bp_access_watchpoint:
7130 innermost_block = NULL;
7131 /* The issue arises of what context to evaluate this in. The
7132 same one as when it was set, but what does that mean when
7133 symbols have been re-read? We could save the filename and
7134 functionname, but if the context is more local than that, the
7135 best we could do would be something like how many levels deep
7136 and which index at that particular level, but that's going to
7137 be less stable than filenames or function names. */
7139 /* So for now, just use a global context. */
7143 /* Avoid re-freeing b->exp if an error during the call to
7144 parse_expression. */
7147 b->exp = parse_expression (b->exp_string);
7148 b->exp_valid_block = innermost_block;
7149 mark = value_mark ();
7152 value_free (b->val);
7153 /* Avoid re-freeing b->val if an error during the call to
7154 evaluate_expression. */
7157 b->val = evaluate_expression (b->exp);
7158 release_value (b->val);
7159 if (value_lazy (b->val) && breakpoint_enabled (b))
7160 value_fetch_lazy (b->val);
7162 if (b->cond_string != NULL)
7168 /* Avoid re-freeing b->exp if an error during the call
7172 b->cond = parse_exp_1 (&s, (struct block *) 0, 0);
7174 if (breakpoint_enabled (b))
7176 value_free_to_mark (mark);
7178 case bp_catch_catch:
7179 case bp_catch_throw:
7181 /* We needn't really do anything to reset these, since the mask
7182 that requests them is unaffected by e.g., new libraries being
7185 case bp_catch_vfork:
7190 printf_filtered (_("Deleting unknown breakpoint type %d\n"), b->type);
7192 /* Delete longjmp and overlay event breakpoints; they will be
7193 reset later by breakpoint_re_set. */
7195 case bp_longjmp_resume:
7196 case bp_overlay_event:
7197 delete_breakpoint (b);
7200 /* This breakpoint is special, it's set up when the inferior
7201 starts and we really don't want to touch it. */
7202 case bp_shlib_event:
7204 /* Like bp_shlib_event, this breakpoint type is special.
7205 Once it is set up, we do not want to touch it. */
7206 case bp_thread_event:
7208 /* Keep temporary breakpoints, which can be encountered when we step
7209 over a dlopen call and SOLIB_ADD is resetting the breakpoints.
7210 Otherwise these should have been blown away via the cleanup chain
7211 or by breakpoint_init_inferior when we rerun the executable. */
7214 case bp_watchpoint_scope:
7216 case bp_step_resume:
7223 /* Re-set all breakpoints after symbols have been re-loaded. */
7225 breakpoint_re_set (void)
7227 struct breakpoint *b, *temp;
7228 enum language save_language;
7229 int save_input_radix;
7231 save_language = current_language->la_language;
7232 save_input_radix = input_radix;
7233 ALL_BREAKPOINTS_SAFE (b, temp)
7235 /* Format possible error msg */
7236 char *message = xstrprintf ("Error in re-setting breakpoint %d:\n",
7238 struct cleanup *cleanups = make_cleanup (xfree, message);
7239 catch_errors (breakpoint_re_set_one, b, message, RETURN_MASK_ALL);
7240 do_cleanups (cleanups);
7242 set_language (save_language);
7243 input_radix = save_input_radix;
7245 if (GET_LONGJMP_TARGET_P ())
7247 create_longjmp_breakpoint ("longjmp");
7248 create_longjmp_breakpoint ("_longjmp");
7249 create_longjmp_breakpoint ("siglongjmp");
7250 create_longjmp_breakpoint ("_siglongjmp");
7251 create_longjmp_breakpoint (NULL);
7254 create_overlay_event_breakpoint ("_ovly_debug_event");
7257 /* Reset the thread number of this breakpoint:
7259 - If the breakpoint is for all threads, leave it as-is.
7260 - Else, reset it to the current thread for inferior_ptid. */
7262 breakpoint_re_set_thread (struct breakpoint *b)
7264 if (b->thread != -1)
7266 if (in_thread_list (inferior_ptid))
7267 b->thread = pid_to_thread_id (inferior_ptid);
7271 /* Set ignore-count of breakpoint number BPTNUM to COUNT.
7272 If from_tty is nonzero, it prints a message to that effect,
7273 which ends with a period (no newline). */
7276 set_ignore_count (int bptnum, int count, int from_tty)
7278 struct breakpoint *b;
7284 if (b->number == bptnum)
7286 b->ignore_count = count;
7290 printf_filtered (_("Will stop next time breakpoint %d is reached."),
7292 else if (count == 1)
7293 printf_filtered (_("Will ignore next crossing of breakpoint %d."),
7296 printf_filtered (_("Will ignore next %d crossings of breakpoint %d."),
7299 breakpoints_changed ();
7300 breakpoint_modify_event (b->number);
7304 error (_("No breakpoint number %d."), bptnum);
7307 /* Clear the ignore counts of all breakpoints. */
7309 breakpoint_clear_ignore_counts (void)
7311 struct breakpoint *b;
7314 b->ignore_count = 0;
7317 /* Command to set ignore-count of breakpoint N to COUNT. */
7320 ignore_command (char *args, int from_tty)
7326 error_no_arg (_("a breakpoint number"));
7328 num = get_number (&p);
7330 error (_("bad breakpoint number: '%s'"), args);
7332 error (_("Second argument (specified ignore-count) is missing."));
7334 set_ignore_count (num,
7335 longest_to_int (value_as_long (parse_and_eval (p))),
7338 printf_filtered ("\n");
7341 /* Call FUNCTION on each of the breakpoints
7342 whose numbers are given in ARGS. */
7345 map_breakpoint_numbers (char *args, void (*function) (struct breakpoint *))
7350 struct breakpoint *b, *tmp;
7354 error_no_arg (_("one or more breakpoint numbers"));
7361 num = get_number_or_range (&p1);
7364 warning (_("bad breakpoint number at or near '%s'"), p);
7368 ALL_BREAKPOINTS_SAFE (b, tmp)
7369 if (b->number == num)
7371 struct breakpoint *related_breakpoint = b->related_breakpoint;
7374 if (related_breakpoint)
7375 function (related_breakpoint);
7379 printf_unfiltered (_("No breakpoint number %d.\n"), num);
7385 /* Set ignore-count of breakpoint number BPTNUM to COUNT.
7386 If from_tty is nonzero, it prints a message to that effect,
7387 which ends with a period (no newline). */
7390 disable_breakpoint (struct breakpoint *bpt)
7392 /* Never disable a watchpoint scope breakpoint; we want to
7393 hit them when we leave scope so we can delete both the
7394 watchpoint and its scope breakpoint at that time. */
7395 if (bpt->type == bp_watchpoint_scope)
7398 /* You can't disable permanent breakpoints. */
7399 if (bpt->enable_state == bp_permanent)
7402 bpt->enable_state = bp_disabled;
7404 check_duplicates (bpt);
7406 if (deprecated_modify_breakpoint_hook)
7407 deprecated_modify_breakpoint_hook (bpt);
7408 breakpoint_modify_event (bpt->number);
7412 disable_command (char *args, int from_tty)
7414 struct breakpoint *bpt;
7416 ALL_BREAKPOINTS (bpt)
7420 warning (_("attempted to disable apparently deleted breakpoint #%d?"),
7425 case bp_catch_unload:
7427 case bp_catch_vfork:
7429 case bp_catch_catch:
7430 case bp_catch_throw:
7431 case bp_hardware_breakpoint:
7433 case bp_hardware_watchpoint:
7434 case bp_read_watchpoint:
7435 case bp_access_watchpoint:
7436 disable_breakpoint (bpt);
7441 map_breakpoint_numbers (args, disable_breakpoint);
7445 do_enable_breakpoint (struct breakpoint *bpt, enum bpdisp disposition)
7447 int target_resources_ok, other_type_used;
7450 if (bpt->type == bp_hardware_breakpoint)
7453 i = hw_breakpoint_used_count ();
7454 target_resources_ok =
7455 TARGET_CAN_USE_HARDWARE_WATCHPOINT (bp_hardware_breakpoint,
7457 if (target_resources_ok == 0)
7458 error (_("No hardware breakpoint support in the target."));
7459 else if (target_resources_ok < 0)
7460 error (_("Hardware breakpoints used exceeds limit."));
7465 if (bpt->enable_state != bp_enabled)
7467 /* When enabling a pending breakpoint, we need to check if the breakpoint
7468 is resolvable since shared libraries could have been loaded
7469 after the breakpoint was disabled. */
7470 breakpoints_changed ();
7471 if (resolve_pending_breakpoint (bpt) == GDB_RC_OK)
7473 delete_breakpoint (bpt);
7476 bpt->enable_state = bp_enabled;
7477 bpt->disposition = disposition;
7480 else /* Not a pending breakpoint. */
7482 if (bpt->enable_state != bp_permanent)
7483 bpt->enable_state = bp_enabled;
7484 bpt->disposition = disposition;
7485 check_duplicates (bpt);
7486 breakpoints_changed ();
7488 if (bpt->type == bp_watchpoint ||
7489 bpt->type == bp_hardware_watchpoint ||
7490 bpt->type == bp_read_watchpoint ||
7491 bpt->type == bp_access_watchpoint)
7493 struct frame_id saved_frame_id;
7495 saved_frame_id = get_frame_id (get_selected_frame (NULL));
7496 if (bpt->exp_valid_block != NULL)
7498 struct frame_info *fr =
7499 fr = frame_find_by_id (bpt->watchpoint_frame);
7502 printf_filtered (_("\
7503 Cannot enable watchpoint %d because the block in which its expression\n\
7504 is valid is not currently in scope.\n"), bpt->number);
7505 bpt->enable_state = bp_disabled;
7511 value_free (bpt->val);
7512 mark = value_mark ();
7513 bpt->val = evaluate_expression (bpt->exp);
7514 release_value (bpt->val);
7515 if (value_lazy (bpt->val))
7516 value_fetch_lazy (bpt->val);
7518 if (bpt->type == bp_hardware_watchpoint ||
7519 bpt->type == bp_read_watchpoint ||
7520 bpt->type == bp_access_watchpoint)
7522 int i = hw_watchpoint_used_count (bpt->type, &other_type_used);
7523 int mem_cnt = can_use_hardware_watchpoint (bpt->val);
7525 /* Hack around 'unused var' error for some targets here */
7527 target_resources_ok = TARGET_CAN_USE_HARDWARE_WATCHPOINT (
7528 bpt->type, i + mem_cnt, other_type_used);
7529 /* we can consider of type is bp_hardware_watchpoint, convert to
7530 bp_watchpoint in the following condition */
7531 if (target_resources_ok < 0)
7533 printf_filtered (_("\
7534 Cannot enable watchpoint %d because target watch resources\n\
7535 have been allocated for other watchpoints.\n"), bpt->number);
7536 bpt->enable_state = bp_disabled;
7537 value_free_to_mark (mark);
7542 select_frame (frame_find_by_id (saved_frame_id));
7543 value_free_to_mark (mark);
7547 if (deprecated_modify_breakpoint_hook)
7548 deprecated_modify_breakpoint_hook (bpt);
7549 breakpoint_modify_event (bpt->number);
7553 enable_breakpoint (struct breakpoint *bpt)
7555 do_enable_breakpoint (bpt, bpt->disposition);
7558 /* The enable command enables the specified breakpoints (or all defined
7559 breakpoints) so they once again become (or continue to be) effective
7560 in stopping the inferior. */
7563 enable_command (char *args, int from_tty)
7565 struct breakpoint *bpt;
7567 ALL_BREAKPOINTS (bpt)
7571 warning (_("attempted to enable apparently deleted breakpoint #%d?"),
7576 case bp_catch_unload:
7578 case bp_catch_vfork:
7580 case bp_catch_catch:
7581 case bp_catch_throw:
7582 case bp_hardware_breakpoint:
7584 case bp_hardware_watchpoint:
7585 case bp_read_watchpoint:
7586 case bp_access_watchpoint:
7587 enable_breakpoint (bpt);
7592 map_breakpoint_numbers (args, enable_breakpoint);
7596 enable_once_breakpoint (struct breakpoint *bpt)
7598 do_enable_breakpoint (bpt, disp_disable);
7602 enable_once_command (char *args, int from_tty)
7604 map_breakpoint_numbers (args, enable_once_breakpoint);
7608 enable_delete_breakpoint (struct breakpoint *bpt)
7610 do_enable_breakpoint (bpt, disp_del);
7614 enable_delete_command (char *args, int from_tty)
7616 map_breakpoint_numbers (args, enable_delete_breakpoint);
7620 set_breakpoint_cmd (char *args, int from_tty)
7625 show_breakpoint_cmd (char *args, int from_tty)
7629 /* Use default_breakpoint_'s, or nothing if they aren't valid. */
7631 struct symtabs_and_lines
7632 decode_line_spec_1 (char *string, int funfirstline)
7634 struct symtabs_and_lines sals;
7636 error (_("Empty line specification."));
7637 if (default_breakpoint_valid)
7638 sals = decode_line_1 (&string, funfirstline,
7639 default_breakpoint_symtab,
7640 default_breakpoint_line,
7641 (char ***) NULL, NULL);
7643 sals = decode_line_1 (&string, funfirstline,
7644 (struct symtab *) NULL, 0, (char ***) NULL, NULL);
7646 error (_("Junk at end of line specification: %s"), string);
7651 _initialize_breakpoint (void)
7653 static struct cmd_list_element *breakpoint_set_cmdlist;
7654 static struct cmd_list_element *breakpoint_show_cmdlist;
7655 struct cmd_list_element *c;
7657 observer_attach_solib_unloaded (disable_breakpoints_in_unloaded_shlib);
7659 breakpoint_chain = 0;
7660 /* Don't bother to call set_breakpoint_count. $bpnum isn't useful
7661 before a breakpoint is set. */
7662 breakpoint_count = 0;
7664 add_com ("ignore", class_breakpoint, ignore_command, _("\
7665 Set ignore-count of breakpoint number N to COUNT.\n\
7666 Usage is `ignore N COUNT'."));
7668 add_com_alias ("bc", "ignore", class_breakpoint, 1);
7670 add_com ("commands", class_breakpoint, commands_command, _("\
7671 Set commands to be executed when a breakpoint is hit.\n\
7672 Give breakpoint number as argument after \"commands\".\n\
7673 With no argument, the targeted breakpoint is the last one set.\n\
7674 The commands themselves follow starting on the next line.\n\
7675 Type a line containing \"end\" to indicate the end of them.\n\
7676 Give \"silent\" as the first line to make the breakpoint silent;\n\
7677 then no output is printed when it is hit, except what the commands print."));
7679 add_com ("condition", class_breakpoint, condition_command, _("\
7680 Specify breakpoint number N to break only if COND is true.\n\
7681 Usage is `condition N COND', where N is an integer and COND is an\n\
7682 expression to be evaluated whenever breakpoint N is reached."));
7684 c = add_com ("tbreak", class_breakpoint, tbreak_command, _("\
7685 Set a temporary breakpoint. Args like \"break\" command.\n\
7686 Like \"break\" except the breakpoint is only temporary,\n\
7687 so it will be deleted when hit. Equivalent to \"break\" followed\n\
7688 by using \"enable delete\" on the breakpoint number."));
7689 set_cmd_completer (c, location_completer);
7691 c = add_com ("hbreak", class_breakpoint, hbreak_command, _("\
7692 Set a hardware assisted breakpoint. Args like \"break\" command.\n\
7693 Like \"break\" except the breakpoint requires hardware support,\n\
7694 some target hardware may not have this support."));
7695 set_cmd_completer (c, location_completer);
7697 c = add_com ("thbreak", class_breakpoint, thbreak_command, _("\
7698 Set a temporary hardware assisted breakpoint. Args like \"break\" command.\n\
7699 Like \"hbreak\" except the breakpoint is only temporary,\n\
7700 so it will be deleted when hit."));
7701 set_cmd_completer (c, location_completer);
7703 add_prefix_cmd ("enable", class_breakpoint, enable_command, _("\
7704 Enable some breakpoints.\n\
7705 Give breakpoint numbers (separated by spaces) as arguments.\n\
7706 With no subcommand, breakpoints are enabled until you command otherwise.\n\
7707 This is used to cancel the effect of the \"disable\" command.\n\
7708 With a subcommand you can enable temporarily."),
7709 &enablelist, "enable ", 1, &cmdlist);
7711 add_com ("ab", class_breakpoint, enable_command, _("\
7712 Enable some breakpoints.\n\
7713 Give breakpoint numbers (separated by spaces) as arguments.\n\
7714 With no subcommand, breakpoints are enabled until you command otherwise.\n\
7715 This is used to cancel the effect of the \"disable\" command.\n\
7716 With a subcommand you can enable temporarily."));
7718 add_com_alias ("en", "enable", class_breakpoint, 1);
7720 add_abbrev_prefix_cmd ("breakpoints", class_breakpoint, enable_command, _("\
7721 Enable some breakpoints.\n\
7722 Give breakpoint numbers (separated by spaces) as arguments.\n\
7723 This is used to cancel the effect of the \"disable\" command.\n\
7724 May be abbreviated to simply \"enable\".\n"),
7725 &enablebreaklist, "enable breakpoints ", 1, &enablelist);
7727 add_cmd ("once", no_class, enable_once_command, _("\
7728 Enable breakpoints for one hit. Give breakpoint numbers.\n\
7729 If a breakpoint is hit while enabled in this fashion, it becomes disabled."),
7732 add_cmd ("delete", no_class, enable_delete_command, _("\
7733 Enable breakpoints and delete when hit. Give breakpoint numbers.\n\
7734 If a breakpoint is hit while enabled in this fashion, it is deleted."),
7737 add_cmd ("delete", no_class, enable_delete_command, _("\
7738 Enable breakpoints and delete when hit. Give breakpoint numbers.\n\
7739 If a breakpoint is hit while enabled in this fashion, it is deleted."),
7742 add_cmd ("once", no_class, enable_once_command, _("\
7743 Enable breakpoints for one hit. Give breakpoint numbers.\n\
7744 If a breakpoint is hit while enabled in this fashion, it becomes disabled."),
7747 add_prefix_cmd ("disable", class_breakpoint, disable_command, _("\
7748 Disable some breakpoints.\n\
7749 Arguments are breakpoint numbers with spaces in between.\n\
7750 To disable all breakpoints, give no argument.\n\
7751 A disabled breakpoint is not forgotten, but has no effect until reenabled."),
7752 &disablelist, "disable ", 1, &cmdlist);
7753 add_com_alias ("dis", "disable", class_breakpoint, 1);
7754 add_com_alias ("disa", "disable", class_breakpoint, 1);
7756 add_com ("sb", class_breakpoint, disable_command, _("\
7757 Disable some breakpoints.\n\
7758 Arguments are breakpoint numbers with spaces in between.\n\
7759 To disable all breakpoints, give no argument.\n\
7760 A disabled breakpoint is not forgotten, but has no effect until reenabled."));
7762 add_cmd ("breakpoints", class_alias, disable_command, _("\
7763 Disable some breakpoints.\n\
7764 Arguments are breakpoint numbers with spaces in between.\n\
7765 To disable all breakpoints, give no argument.\n\
7766 A disabled breakpoint is not forgotten, but has no effect until reenabled.\n\
7767 This command may be abbreviated \"disable\"."),
7770 add_prefix_cmd ("delete", class_breakpoint, delete_command, _("\
7771 Delete some breakpoints or auto-display expressions.\n\
7772 Arguments are breakpoint numbers with spaces in between.\n\
7773 To delete all breakpoints, give no argument.\n\
7775 Also a prefix command for deletion of other GDB objects.\n\
7776 The \"unset\" command is also an alias for \"delete\"."),
7777 &deletelist, "delete ", 1, &cmdlist);
7778 add_com_alias ("d", "delete", class_breakpoint, 1);
7780 add_com ("db", class_breakpoint, delete_command, _("\
7781 Delete some breakpoints.\n\
7782 Arguments are breakpoint numbers with spaces in between.\n\
7783 To delete all breakpoints, give no argument.\n"));
7785 add_cmd ("breakpoints", class_alias, delete_command, _("\
7786 Delete some breakpoints or auto-display expressions.\n\
7787 Arguments are breakpoint numbers with spaces in between.\n\
7788 To delete all breakpoints, give no argument.\n\
7789 This command may be abbreviated \"delete\"."),
7792 add_com ("clear", class_breakpoint, clear_command, _("\
7793 Clear breakpoint at specified line or function.\n\
7794 Argument may be line number, function name, or \"*\" and an address.\n\
7795 If line number is specified, all breakpoints in that line are cleared.\n\
7796 If function is specified, breakpoints at beginning of function are cleared.\n\
7797 If an address is specified, breakpoints at that address are cleared.\n\
7799 With no argument, clears all breakpoints in the line that the selected frame\n\
7802 See also the \"delete\" command which clears breakpoints by number."));
7804 c = add_com ("break", class_breakpoint, break_command, _("\
7805 Set breakpoint at specified line or function.\n\
7806 Argument may be line number, function name, or \"*\" and an address.\n\
7807 If line number is specified, break at start of code for that line.\n\
7808 If function is specified, break at start of code for that function.\n\
7809 If an address is specified, break at that exact address.\n\
7810 With no arg, uses current execution address of selected stack frame.\n\
7811 This is useful for breaking on return to a stack frame.\n\
7813 Multiple breakpoints at one place are permitted, and useful if conditional.\n\
7815 Do \"help breakpoints\" for info on other commands dealing with breakpoints."));
7816 set_cmd_completer (c, location_completer);
7818 add_com_alias ("b", "break", class_run, 1);
7819 add_com_alias ("br", "break", class_run, 1);
7820 add_com_alias ("bre", "break", class_run, 1);
7821 add_com_alias ("brea", "break", class_run, 1);
7825 add_com_alias ("ba", "break", class_breakpoint, 1);
7826 add_com_alias ("bu", "ubreak", class_breakpoint, 1);
7831 add_abbrev_prefix_cmd ("stop", class_breakpoint, stop_command, _("\
7832 Break in function/address or break at a line in the current file."),
7833 &stoplist, "stop ", 1, &cmdlist);
7834 add_cmd ("in", class_breakpoint, stopin_command,
7835 _("Break in function or address."), &stoplist);
7836 add_cmd ("at", class_breakpoint, stopat_command,
7837 _("Break at a line in the current file."), &stoplist);
7838 add_com ("status", class_info, breakpoints_info, _("\
7839 Status of user-settable breakpoints, or breakpoint number NUMBER.\n\
7840 The \"Type\" column indicates one of:\n\
7841 \tbreakpoint - normal breakpoint\n\
7842 \twatchpoint - watchpoint\n\
7843 The \"Disp\" column contains one of \"keep\", \"del\", or \"dis\" to indicate\n\
7844 the disposition of the breakpoint after it gets hit. \"dis\" means that the\n\
7845 breakpoint will be disabled. The \"Address\" and \"What\" columns indicate the\n\
7846 address and file/line number respectively.\n\
7848 Convenience variable \"$_\" and default examine address for \"x\"\n\
7849 are set to the address of the last breakpoint listed.\n\n\
7850 Convenience variable \"$bpnum\" contains the number of the last\n\
7854 add_info ("breakpoints", breakpoints_info, _("\
7855 Status of user-settable breakpoints, or breakpoint number NUMBER.\n\
7856 The \"Type\" column indicates one of:\n\
7857 \tbreakpoint - normal breakpoint\n\
7858 \twatchpoint - watchpoint\n\
7859 The \"Disp\" column contains one of \"keep\", \"del\", or \"dis\" to indicate\n\
7860 the disposition of the breakpoint after it gets hit. \"dis\" means that the\n\
7861 breakpoint will be disabled. The \"Address\" and \"What\" columns indicate the\n\
7862 address and file/line number respectively.\n\
7864 Convenience variable \"$_\" and default examine address for \"x\"\n\
7865 are set to the address of the last breakpoint listed.\n\n\
7866 Convenience variable \"$bpnum\" contains the number of the last\n\
7870 add_com ("lb", class_breakpoint, breakpoints_info, _("\
7871 Status of user-settable breakpoints, or breakpoint number NUMBER.\n\
7872 The \"Type\" column indicates one of:\n\
7873 \tbreakpoint - normal breakpoint\n\
7874 \twatchpoint - watchpoint\n\
7875 The \"Disp\" column contains one of \"keep\", \"del\", or \"dis\" to indicate\n\
7876 the disposition of the breakpoint after it gets hit. \"dis\" means that the\n\
7877 breakpoint will be disabled. The \"Address\" and \"What\" columns indicate the\n\
7878 address and file/line number respectively.\n\
7880 Convenience variable \"$_\" and default examine address for \"x\"\n\
7881 are set to the address of the last breakpoint listed.\n\n\
7882 Convenience variable \"$bpnum\" contains the number of the last\n\
7885 add_cmd ("breakpoints", class_maintenance, maintenance_info_breakpoints, _("\
7886 Status of all breakpoints, or breakpoint number NUMBER.\n\
7887 The \"Type\" column indicates one of:\n\
7888 \tbreakpoint - normal breakpoint\n\
7889 \twatchpoint - watchpoint\n\
7890 \tlongjmp - internal breakpoint used to step through longjmp()\n\
7891 \tlongjmp resume - internal breakpoint at the target of longjmp()\n\
7892 \tuntil - internal breakpoint used by the \"until\" command\n\
7893 \tfinish - internal breakpoint used by the \"finish\" command\n\
7894 The \"Disp\" column contains one of \"keep\", \"del\", or \"dis\" to indicate\n\
7895 the disposition of the breakpoint after it gets hit. \"dis\" means that the\n\
7896 breakpoint will be disabled. The \"Address\" and \"What\" columns indicate the\n\
7897 address and file/line number respectively.\n\
7899 Convenience variable \"$_\" and default examine address for \"x\"\n\
7900 are set to the address of the last breakpoint listed.\n\
7902 Convenience variable \"$bpnum\" contains the number of the last\n\
7904 &maintenanceinfolist);
7906 add_com ("catch", class_breakpoint, catch_command, _("\
7907 Set catchpoints to catch events.\n\
7908 Raised signals may be caught:\n\
7909 \tcatch signal - all signals\n\
7910 \tcatch signal <signame> - a particular signal\n\
7911 Raised exceptions may be caught:\n\
7912 \tcatch throw - all exceptions, when thrown\n\
7913 \tcatch throw <exceptname> - a particular exception, when thrown\n\
7914 \tcatch catch - all exceptions, when caught\n\
7915 \tcatch catch <exceptname> - a particular exception, when caught\n\
7916 Thread or process events may be caught:\n\
7917 \tcatch thread_start - any threads, just after creation\n\
7918 \tcatch thread_exit - any threads, just before expiration\n\
7919 \tcatch thread_join - any threads, just after joins\n\
7920 Process events may be caught:\n\
7921 \tcatch start - any processes, just after creation\n\
7922 \tcatch exit - any processes, just before expiration\n\
7923 \tcatch fork - calls to fork()\n\
7924 \tcatch vfork - calls to vfork()\n\
7925 \tcatch exec - calls to exec()\n\
7926 Dynamically-linked library events may be caught:\n\
7927 \tcatch load - loads of any library\n\
7928 \tcatch load <libname> - loads of a particular library\n\
7929 \tcatch unload - unloads of any library\n\
7930 \tcatch unload <libname> - unloads of a particular library\n\
7931 The act of your program's execution stopping may also be caught:\n\
7933 C++ exceptions may be caught:\n\
7934 \tcatch throw - all exceptions, when thrown\n\
7935 \tcatch catch - all exceptions, when caught\n\
7937 Do \"help set follow-fork-mode\" for info on debugging your program\n\
7938 after a fork or vfork is caught.\n\n\
7939 Do \"help breakpoints\" for info on other commands dealing with breakpoints."));
7941 add_com ("tcatch", class_breakpoint, tcatch_command, _("\
7942 Set temporary catchpoints to catch events.\n\
7943 Args like \"catch\" command.\n\
7944 Like \"catch\" except the catchpoint is only temporary,\n\
7945 so it will be deleted when hit. Equivalent to \"catch\" followed\n\
7946 by using \"enable delete\" on the catchpoint number."));
7948 c = add_com ("watch", class_breakpoint, watch_command, _("\
7949 Set a watchpoint for an expression.\n\
7950 A watchpoint stops execution of your program whenever the value of\n\
7951 an expression changes."));
7952 set_cmd_completer (c, location_completer);
7954 c = add_com ("rwatch", class_breakpoint, rwatch_command, _("\
7955 Set a read watchpoint for an expression.\n\
7956 A watchpoint stops execution of your program whenever the value of\n\
7957 an expression is read."));
7958 set_cmd_completer (c, location_completer);
7960 c = add_com ("awatch", class_breakpoint, awatch_command, _("\
7961 Set a watchpoint for an expression.\n\
7962 A watchpoint stops execution of your program whenever the value of\n\
7963 an expression is either read or written."));
7964 set_cmd_completer (c, location_completer);
7966 add_info ("watchpoints", breakpoints_info,
7967 _("Synonym for ``info breakpoints''."));
7970 /* XXX: cagney/2005-02-23: This should be a boolean, and should
7971 respond to changes - contrary to the description. */
7972 add_setshow_zinteger_cmd ("can-use-hw-watchpoints", class_support,
7973 &can_use_hw_watchpoints, _("\
7974 Set debugger's willingness to use watchpoint hardware."), _("\
7975 Show debugger's willingness to use watchpoint hardware."), _("\
7976 If zero, gdb will not use hardware for new watchpoints, even if\n\
7977 such is available. (However, any hardware watchpoints that were\n\
7978 created before setting this to nonzero, will continue to use watchpoint\n\
7981 show_can_use_hw_watchpoints,
7982 &setlist, &showlist);
7984 can_use_hw_watchpoints = 1;
7986 add_prefix_cmd ("breakpoint", class_maintenance, set_breakpoint_cmd, _("\
7987 Breakpoint specific settings\n\
7988 Configure various breakpoint-specific variables such as\n\
7989 pending breakpoint behavior"),
7990 &breakpoint_set_cmdlist, "set breakpoint ",
7991 0/*allow-unknown*/, &setlist);
7992 add_prefix_cmd ("breakpoint", class_maintenance, show_breakpoint_cmd, _("\
7993 Breakpoint specific settings\n\
7994 Configure various breakpoint-specific variables such as\n\
7995 pending breakpoint behavior"),
7996 &breakpoint_show_cmdlist, "show breakpoint ",
7997 0/*allow-unknown*/, &showlist);
7999 add_setshow_auto_boolean_cmd ("pending", no_class,
8000 &pending_break_support, _("\
8001 Set debugger's behavior regarding pending breakpoints."), _("\
8002 Show debugger's behavior regarding pending breakpoints."), _("\
8003 If on, an unrecognized breakpoint location will cause gdb to create a\n\
8004 pending breakpoint. If off, an unrecognized breakpoint location results in\n\
8005 an error. If auto, an unrecognized breakpoint location results in a\n\
8006 user-query to see if a pending breakpoint should be created."),
8008 show_pending_break_support,
8009 &breakpoint_set_cmdlist,
8010 &breakpoint_show_cmdlist);
8012 pending_break_support = AUTO_BOOLEAN_AUTO;