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
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"
54 #include "exceptions.h"
56 #include "gdb-events.h"
58 /* Prototypes for local functions. */
60 static void until_break_command_continuation (struct continuation_arg *arg);
62 static void catch_command_1 (char *, int, int);
64 static void enable_delete_command (char *, int);
66 static void enable_delete_breakpoint (struct breakpoint *);
68 static void enable_once_command (char *, int);
70 static void enable_once_breakpoint (struct breakpoint *);
72 static void disable_command (char *, int);
74 static void enable_command (char *, int);
76 static void map_breakpoint_numbers (char *, void (*)(struct breakpoint *));
78 static void ignore_command (char *, int);
80 static int breakpoint_re_set_one (void *);
82 static void clear_command (char *, int);
84 static void catch_command (char *, int);
86 static void watch_command (char *, int);
88 static int can_use_hardware_watchpoint (struct value *);
90 static int break_command_1 (char *, int, int, struct breakpoint *);
92 static void mention (struct breakpoint *);
94 struct breakpoint *set_raw_breakpoint (struct symtab_and_line, enum bptype);
96 static void check_duplicates (struct breakpoint *);
98 static void breakpoint_adjustment_warning (CORE_ADDR, CORE_ADDR, int, int);
100 static CORE_ADDR adjust_breakpoint_address (CORE_ADDR bpaddr,
103 static void describe_other_breakpoints (CORE_ADDR, asection *);
105 static void breakpoints_info (char *, int);
107 static void breakpoint_1 (int, int);
109 static bpstat bpstat_alloc (struct breakpoint *, bpstat);
111 static int breakpoint_cond_eval (void *);
113 static void cleanup_executing_breakpoints (void *);
115 static void commands_command (char *, int);
117 static void condition_command (char *, int);
119 static int get_number_trailer (char **, int);
121 static int do_captured_parse_breakpoint (struct ui_out *, void *);
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;
209 /* If AUTO_BOOLEAN_FALSE, gdb will not attempt to create pending breakpoints.
210 If AUTO_BOOLEAN_TRUE, gdb will automatically create pending breakpoints
211 for unrecognized breakpoint locations.
212 If AUTO_BOOLEAN_AUTO, gdb will query when breakpoints are unrecognized. */
213 static enum auto_boolean pending_break_support;
215 void _initialize_breakpoint (void);
217 extern int addressprint; /* Print machine addresses? */
219 /* Are we executing breakpoint commands? */
220 static int executing_breakpoint_commands;
222 /* Are overlay event breakpoints enabled? */
223 static int overlay_events_enabled;
225 /* Walk the following statement or block through all breakpoints.
226 ALL_BREAKPOINTS_SAFE does so even if the statment deletes the current
229 #define ALL_BREAKPOINTS(B) for (B = breakpoint_chain; B; B = B->next)
231 #define ALL_BREAKPOINTS_SAFE(B,TMP) \
232 for (B = breakpoint_chain; \
233 B ? (TMP=B->next, 1): 0; \
236 /* Similar iterators for the low-level breakpoints. */
238 #define ALL_BP_LOCATIONS(B) for (B = bp_location_chain; B; B = B->next)
240 #define ALL_BP_LOCATIONS_SAFE(B,TMP) \
241 for (B = bp_location_chain; \
242 B ? (TMP=B->next, 1): 0; \
245 /* True if breakpoint hit counts should be displayed in breakpoint info. */
247 int show_breakpoint_hit_counts = 1;
249 /* Chains of all breakpoints defined. */
251 struct breakpoint *breakpoint_chain;
253 struct bp_location *bp_location_chain;
255 /* Number of last breakpoint made. */
257 int breakpoint_count;
259 /* Pointer to current exception event record */
260 static struct exception_event_record *current_exception_event;
262 /* Indicator of whether exception catchpoints should be nuked between
263 runs of a program. */
264 int deprecated_exception_catchpoints_are_fragile = 0;
266 /* Indicator of when exception catchpoints set-up should be
267 reinitialized -- e.g. when program is re-run. */
268 int deprecated_exception_support_initialized = 0;
270 /* This function returns a pointer to the string representation of the
271 pathname of the dynamically-linked library that has just been
274 This function must be used only when SOLIB_HAVE_LOAD_EVENT is TRUE,
275 or undefined results are guaranteed.
277 This string's contents are only valid immediately after the
278 inferior has stopped in the dynamic linker hook, and becomes
279 invalid as soon as the inferior is continued. Clients should make
280 a copy of this string if they wish to continue the inferior and
281 then access the string. */
283 #ifndef SOLIB_LOADED_LIBRARY_PATHNAME
284 #define SOLIB_LOADED_LIBRARY_PATHNAME(pid) ""
287 /* This function returns a pointer to the string representation of the
288 pathname of the dynamically-linked library that has just been
291 This function must be used only when SOLIB_HAVE_UNLOAD_EVENT is
292 TRUE, or undefined results are guaranteed.
294 This string's contents are only valid immediately after the
295 inferior has stopped in the dynamic linker hook, and becomes
296 invalid as soon as the inferior is continued. Clients should make
297 a copy of this string if they wish to continue the inferior and
298 then access the string. */
300 #ifndef SOLIB_UNLOADED_LIBRARY_PATHNAME
301 #define SOLIB_UNLOADED_LIBRARY_PATHNAME(pid) ""
304 /* This function is called by the "catch load" command. It allows the
305 debugger to be notified by the dynamic linker when a specified
306 library file (or any library file, if filename is NULL) is loaded. */
308 #ifndef SOLIB_CREATE_CATCH_LOAD_HOOK
309 #define SOLIB_CREATE_CATCH_LOAD_HOOK(pid,tempflag,filename,cond_string) \
310 error ("catch of library loads not yet implemented on this platform")
313 /* This function is called by the "catch unload" command. It allows
314 the debugger to be notified by the dynamic linker when a specified
315 library file (or any library file, if filename is NULL) is
318 #ifndef SOLIB_CREATE_CATCH_UNLOAD_HOOK
319 #define SOLIB_CREATE_CATCH_UNLOAD_HOOK(pid,tempflag,filename,cond_string) \
320 error ("catch of library unloads not yet implemented on this platform")
323 /* Return whether a breakpoint is an active enabled breakpoint. */
325 breakpoint_enabled (struct breakpoint *b)
327 return (b->enable_state == bp_enabled && !b->pending);
330 /* Set breakpoint count to NUM. */
333 set_breakpoint_count (int num)
335 breakpoint_count = num;
336 set_internalvar (lookup_internalvar ("bpnum"),
337 value_from_longest (builtin_type_int, (LONGEST) num));
340 /* Used in run_command to zero the hit count when a new run starts. */
343 clear_breakpoint_hit_counts (void)
345 struct breakpoint *b;
351 /* Default address, symtab and line to put a breakpoint at
352 for "break" command with no arg.
353 if default_breakpoint_valid is zero, the other three are
354 not valid, and "break" with no arg is an error.
356 This set by print_stack_frame, which calls set_default_breakpoint. */
358 int default_breakpoint_valid;
359 CORE_ADDR default_breakpoint_address;
360 struct symtab *default_breakpoint_symtab;
361 int default_breakpoint_line;
363 /* *PP is a string denoting a breakpoint. Get the number of the breakpoint.
364 Advance *PP after the string and any trailing whitespace.
366 Currently the string can either be a number or "$" followed by the name
367 of a convenience variable. Making it an expression wouldn't work well
368 for map_breakpoint_numbers (e.g. "4 + 5 + 6").
370 TRAILER is a character which can be found after the number; most
371 commonly this is `-'. If you don't want a trailer, use \0. */
373 get_number_trailer (char **pp, int trailer)
375 int retval = 0; /* default */
379 /* Empty line means refer to the last breakpoint. */
380 return breakpoint_count;
383 /* Make a copy of the name, so we can null-terminate it
384 to pass to lookup_internalvar(). */
389 while (isalnum (*p) || *p == '_')
391 varname = (char *) alloca (p - start + 1);
392 strncpy (varname, start, p - start);
393 varname[p - start] = '\0';
394 val = value_of_internalvar (lookup_internalvar (varname));
395 if (TYPE_CODE (value_type (val)) == TYPE_CODE_INT)
396 retval = (int) value_as_long (val);
399 printf_filtered ("Convenience variable must have integer value.\n");
407 while (*p >= '0' && *p <= '9')
410 /* There is no number here. (e.g. "cond a == b"). */
412 /* Skip non-numeric token */
413 while (*p && !isspace((int) *p))
415 /* Return zero, which caller must interpret as error. */
421 if (!(isspace (*p) || *p == '\0' || *p == trailer))
423 /* Trailing junk: return 0 and let caller print error msg. */
424 while (!(isspace (*p) || *p == '\0' || *p == trailer))
435 /* Like get_number_trailer, but don't allow a trailer. */
437 get_number (char **pp)
439 return get_number_trailer (pp, '\0');
442 /* Parse a number or a range.
443 * A number will be of the form handled by get_number.
444 * A range will be of the form <number1> - <number2>, and
445 * will represent all the integers between number1 and number2,
448 * While processing a range, this fuction is called iteratively;
449 * At each call it will return the next value in the range.
451 * At the beginning of parsing a range, the char pointer PP will
452 * be advanced past <number1> and left pointing at the '-' token.
453 * Subsequent calls will not advance the pointer until the range
454 * is completed. The call that completes the range will advance
455 * pointer PP past <number2>.
459 get_number_or_range (char **pp)
461 static int last_retval, end_value;
462 static char *end_ptr;
463 static int in_range = 0;
467 /* Default case: pp is pointing either to a solo number,
468 or to the first number of a range. */
469 last_retval = get_number_trailer (pp, '-');
474 /* This is the start of a range (<number1> - <number2>).
475 Skip the '-', parse and remember the second number,
476 and also remember the end of the final token. */
480 while (isspace ((int) *end_ptr))
481 end_ptr++; /* skip white space */
482 end_value = get_number (temp);
483 if (end_value < last_retval)
485 error ("inverted range");
487 else if (end_value == last_retval)
489 /* degenerate range (number1 == number2). Advance the
490 token pointer so that the range will be treated as a
499 error ("negative value");
502 /* pp points to the '-' that betokens a range. All
503 number-parsing has already been done. Return the next
504 integer value (one greater than the saved previous value).
505 Do not advance the token pointer 'pp' until the end of range
508 if (++last_retval == end_value)
510 /* End of range reached; advance token pointer. */
520 /* condition N EXP -- set break condition of breakpoint N to EXP. */
523 condition_command (char *arg, int from_tty)
525 struct breakpoint *b;
530 error_no_arg ("breakpoint number");
533 bnum = get_number (&p);
535 error ("Bad breakpoint argument: '%s'", arg);
538 if (b->number == bnum)
545 if (b->cond_string != NULL)
546 xfree (b->cond_string);
551 b->cond_string = NULL;
553 printf_filtered ("Breakpoint %d now unconditional.\n", bnum);
558 /* I don't know if it matters whether this is the string the user
559 typed in or the decompiled expression. */
560 b->cond_string = savestring (arg, strlen (arg));
563 b->cond = parse_exp_1 (&arg, block_for_pc (b->loc->address), 0);
565 error ("Junk at end of expression");
568 breakpoints_changed ();
569 breakpoint_modify_event (b->number);
573 error ("No breakpoint number %d.", bnum);
577 commands_command (char *arg, int from_tty)
579 struct breakpoint *b;
582 struct command_line *l;
584 /* If we allowed this, we would have problems with when to
585 free the storage, if we change the commands currently
588 if (executing_breakpoint_commands)
589 error ("Can't use the \"commands\" command among a breakpoint's commands.");
592 bnum = get_number (&p);
595 error ("Unexpected extra arguments following breakpoint number.");
598 if (b->number == bnum)
600 char *tmpbuf = xstrprintf ("Type commands for when breakpoint %d is hit, one per line.",
602 struct cleanup *cleanups = make_cleanup (xfree, tmpbuf);
603 l = read_command_lines (tmpbuf, from_tty);
604 do_cleanups (cleanups);
605 free_command_lines (&b->commands);
607 breakpoints_changed ();
608 breakpoint_modify_event (b->number);
611 error ("No breakpoint number %d.", bnum);
614 /* Like target_read_memory() but if breakpoints are inserted, return
615 the shadow contents instead of the breakpoints themselves.
617 Read "memory data" from whatever target or inferior we have.
618 Returns zero if successful, errno value if not. EIO is used
619 for address out of bounds. If breakpoints are inserted, returns
620 shadow contents, not the breakpoints themselves. From breakpoint.c. */
623 deprecated_read_memory_nobpt (CORE_ADDR memaddr, char *myaddr, unsigned len)
626 struct bp_location *b;
627 CORE_ADDR bp_addr = 0;
630 if (BREAKPOINT_FROM_PC (&bp_addr, &bp_size) == NULL)
631 /* No breakpoints on this machine. */
632 return target_read_memory (memaddr, myaddr, len);
636 if (b->owner->type == bp_none)
637 warning ("reading through apparently deleted breakpoint #%d?",
640 if (b->loc_type != bp_loc_software_breakpoint)
644 /* Addresses and length of the part of the breakpoint that
646 /* XXXX The m68k, sh and h8300 have different local and remote
647 breakpoint values. BREAKPOINT_FROM_PC still manages to
648 correctly determine the breakpoints memory address and size
649 for these targets. */
650 bp_addr = b->address;
652 if (BREAKPOINT_FROM_PC (&bp_addr, &bp_size) == NULL)
657 if (bp_addr + bp_size <= memaddr)
658 /* The breakpoint is entirely before the chunk of memory we
661 if (bp_addr >= memaddr + len)
662 /* The breakpoint is entirely after the chunk of memory we are
665 /* Copy the breakpoint from the shadow contents, and recurse for
666 the things before and after. */
668 /* Offset within shadow_contents. */
671 if (bp_addr < memaddr)
673 /* Only copy the second part of the breakpoint. */
674 bp_size -= memaddr - bp_addr;
675 bptoffset = memaddr - bp_addr;
679 if (bp_addr + bp_size > memaddr + len)
681 /* Only copy the first part of the breakpoint. */
682 bp_size -= (bp_addr + bp_size) - (memaddr + len);
685 memcpy (myaddr + bp_addr - memaddr,
686 b->shadow_contents + bptoffset, bp_size);
688 if (bp_addr > memaddr)
690 /* Copy the section of memory before the breakpoint. */
691 status = deprecated_read_memory_nobpt (memaddr, myaddr, bp_addr - memaddr);
696 if (bp_addr + bp_size < memaddr + len)
698 /* Copy the section of memory after the breakpoint. */
699 status = deprecated_read_memory_nobpt (bp_addr + bp_size,
700 myaddr + bp_addr + bp_size - memaddr,
701 memaddr + len - (bp_addr + bp_size));
708 /* Nothing overlaps. Just call read_memory_noerr. */
709 return target_read_memory (memaddr, myaddr, len);
713 /* A wrapper function for inserting catchpoints. */
715 insert_catchpoint (struct ui_out *uo, void *args)
717 struct breakpoint *b = (struct breakpoint *) args;
723 val = target_insert_fork_catchpoint (PIDGET (inferior_ptid));
726 val = target_insert_vfork_catchpoint (PIDGET (inferior_ptid));
729 val = target_insert_exec_catchpoint (PIDGET (inferior_ptid));
732 internal_error (__FILE__, __LINE__, "unknown breakpoint type");
737 throw_reason (RETURN_ERROR);
742 /* Helper routine: free the value chain for a breakpoint (watchpoint). */
744 static void free_valchain (struct bp_location *b)
749 /* Free the saved value chain. We will construct a new one
750 the next time the watchpoint is inserted. */
751 for (v = b->owner->val_chain; v; v = n)
756 b->owner->val_chain = NULL;
759 /* Insert a low-level "breakpoint" of some type. BPT is the breakpoint.
760 Any error messages are printed to TMP_ERROR_STREAM; and DISABLED_BREAKS,
761 PROCESS_WARNING, and HW_BREAKPOINT_ERROR are used to report problems.
763 NOTE drow/2003-09-09: This routine could be broken down to an object-style
764 method for each breakpoint or catchpoint type. */
766 insert_bp_location (struct bp_location *bpt,
767 struct ui_file *tmp_error_stream,
768 int *disabled_breaks, int *process_warning,
769 int *hw_breakpoint_error)
773 /* Permanent breakpoints cannot be inserted or removed. Disabled
774 breakpoints should not be inserted. */
775 if (!breakpoint_enabled (bpt->owner))
778 if (bpt->inserted || bpt->duplicate)
781 if (bpt->loc_type == bp_loc_software_breakpoint
782 || bpt->loc_type == bp_loc_hardware_breakpoint)
784 /* First check to see if we have to handle an overlay. */
785 if (overlay_debugging == ovly_off
786 || bpt->section == NULL
787 || !(section_is_overlay (bpt->section)))
789 /* No overlay handling: just set the breakpoint. */
791 if (bpt->loc_type == bp_loc_hardware_breakpoint)
792 val = target_insert_hw_breakpoint (bpt->address,
793 bpt->shadow_contents);
795 val = target_insert_breakpoint (bpt->address,
796 bpt->shadow_contents);
800 /* This breakpoint is in an overlay section.
801 Shall we set a breakpoint at the LMA? */
802 if (!overlay_events_enabled)
804 /* Yes -- overlay event support is not active,
805 so we must try to set a breakpoint at the LMA.
806 This will not work for a hardware breakpoint. */
807 if (bpt->loc_type == bp_loc_hardware_breakpoint)
808 warning ("hardware breakpoint %d not supported in overlay!\n",
812 CORE_ADDR addr = overlay_unmapped_address (bpt->address,
814 /* Set a software (trap) breakpoint at the LMA. */
815 val = target_insert_breakpoint (addr, bpt->shadow_contents);
817 fprintf_unfiltered (tmp_error_stream,
818 "Overlay breakpoint %d failed: in ROM?",
822 /* Shall we set a breakpoint at the VMA? */
823 if (section_is_mapped (bpt->section))
825 /* Yes. This overlay section is mapped into memory. */
826 if (bpt->loc_type == bp_loc_hardware_breakpoint)
827 val = target_insert_hw_breakpoint (bpt->address,
828 bpt->shadow_contents);
830 val = target_insert_breakpoint (bpt->address,
831 bpt->shadow_contents);
835 /* No. This breakpoint will not be inserted.
836 No error, but do not mark the bp as 'inserted'. */
843 /* Can't set the breakpoint. */
844 #if defined (DISABLE_UNSETTABLE_BREAK)
845 if (DISABLE_UNSETTABLE_BREAK (bpt->address))
847 /* See also: disable_breakpoints_in_shlibs. */
849 bpt->owner->enable_state = bp_shlib_disabled;
850 if (!*disabled_breaks)
852 fprintf_unfiltered (tmp_error_stream,
853 "Cannot insert breakpoint %d.\n",
855 fprintf_unfiltered (tmp_error_stream,
856 "Temporarily disabling shared library breakpoints:\n");
858 *disabled_breaks = 1;
859 fprintf_unfiltered (tmp_error_stream,
860 "breakpoint #%d\n", bpt->owner->number);
865 #ifdef ONE_PROCESS_WRITETEXT
866 *process_warning = 1;
868 if (bpt->loc_type == bp_loc_hardware_breakpoint)
870 *hw_breakpoint_error = 1;
871 fprintf_unfiltered (tmp_error_stream,
872 "Cannot insert hardware breakpoint %d.\n",
877 fprintf_unfiltered (tmp_error_stream,
878 "Cannot insert breakpoint %d.\n",
880 fprintf_filtered (tmp_error_stream,
881 "Error accessing memory address ");
882 print_address_numeric (bpt->address, 1, tmp_error_stream);
883 fprintf_filtered (tmp_error_stream, ": %s.\n",
884 safe_strerror (val));
895 else if (bpt->loc_type == bp_loc_hardware_watchpoint
896 /* NOTE drow/2003-09-08: This state only exists for removing
897 watchpoints. It's not clear that it's necessary... */
898 && bpt->owner->disposition != disp_del_at_next_stop)
900 /* FIXME drow/2003-09-08: This code sets multiple hardware watchpoints
901 based on the expression. Ideally this should happen at a higher level,
902 and there should be one bp_location for each computed address we
903 must watch. As soon as a many-to-one mapping is available I'll
906 int within_current_scope;
907 struct value *mark = value_mark ();
909 struct frame_id saved_frame_id;
911 /* Save the current frame's ID so we can restore it after
912 evaluating the watchpoint expression on its own frame. */
913 /* FIXME drow/2003-09-09: It would be nice if evaluate_expression
914 took a frame parameter, so that we didn't have to change the
916 saved_frame_id = get_frame_id (deprecated_selected_frame);
918 /* Determine if the watchpoint is within scope. */
919 if (bpt->owner->exp_valid_block == NULL)
920 within_current_scope = 1;
923 struct frame_info *fi;
924 fi = frame_find_by_id (bpt->owner->watchpoint_frame);
925 within_current_scope = (fi != NULL);
926 if (within_current_scope)
930 if (within_current_scope)
934 /* Evaluate the expression and cut the chain of values
935 produced off from the value chain.
937 Make sure the value returned isn't lazy; we use
938 laziness to determine what memory GDB actually needed
939 in order to compute the value of the expression. */
940 v = evaluate_expression (bpt->owner->exp);
942 value_release_to_mark (mark);
944 bpt->owner->val_chain = v;
947 /* Look at each value on the value chain. */
948 for (; v; v = v->next)
950 /* If it's a memory location, and GDB actually needed
951 its contents to evaluate the expression, then we
953 if (VALUE_LVAL (v) == lval_memory
956 struct type *vtype = check_typedef (value_type (v));
958 /* We only watch structs and arrays if user asked
959 for it explicitly, never if they just happen to
960 appear in the middle of some value chain. */
961 if (v == bpt->owner->val_chain
962 || (TYPE_CODE (vtype) != TYPE_CODE_STRUCT
963 && TYPE_CODE (vtype) != TYPE_CODE_ARRAY))
968 addr = VALUE_ADDRESS (v) + value_offset (v);
969 len = TYPE_LENGTH (value_type (v));
971 if (bpt->owner->type == bp_read_watchpoint)
973 else if (bpt->owner->type == bp_access_watchpoint)
976 val = target_insert_watchpoint (addr, len, type);
979 /* Don't exit the loop, try to insert
980 every value on the value chain. That's
981 because we will be removing all the
982 watches below, and removing a
983 watchpoint we didn't insert could have
991 /* Failure to insert a watchpoint on any memory value in the
992 value chain brings us here. */
995 remove_breakpoint (bpt, mark_uninserted);
996 *hw_breakpoint_error = 1;
997 fprintf_unfiltered (tmp_error_stream,
998 "Could not insert hardware watchpoint %d.\n",
1005 printf_filtered ("Hardware watchpoint %d deleted ", bpt->owner->number);
1006 printf_filtered ("because the program has left the block \n");
1007 printf_filtered ("in which its expression is valid.\n");
1008 if (bpt->owner->related_breakpoint)
1009 bpt->owner->related_breakpoint->disposition = disp_del_at_next_stop;
1010 bpt->owner->disposition = disp_del_at_next_stop;
1013 /* Restore the selected frame. */
1014 select_frame (frame_find_by_id (saved_frame_id));
1019 else if (ep_is_exception_catchpoint (bpt->owner))
1021 /* FIXME drow/2003-09-09: This code sets both a catchpoint and a
1022 breakpoint. Once again, it would be better if this was represented
1023 as two bp_locations. */
1025 /* If we get here, we must have a callback mechanism for exception
1026 events -- with g++ style embedded label support, we insert
1027 ordinary breakpoints and not catchpoints. */
1028 val = target_insert_breakpoint (bpt->address, bpt->shadow_contents);
1031 /* Couldn't set breakpoint for some reason */
1032 fprintf_unfiltered (tmp_error_stream,
1033 "Cannot insert catchpoint %d; disabling it.\n",
1034 bpt->owner->number);
1035 fprintf_filtered (tmp_error_stream,
1036 "Error accessing memory address ");
1037 print_address_numeric (bpt->address, 1, tmp_error_stream);
1038 fprintf_filtered (tmp_error_stream, ": %s.\n",
1039 safe_strerror (val));
1040 bpt->owner->enable_state = bp_disabled;
1044 /* Bp set, now make sure callbacks are enabled */
1045 /* Format possible error msg */
1046 char *message = xstrprintf ("Error inserting catchpoint %d:\n",
1047 bpt->owner->number);
1048 struct cleanup *cleanups = make_cleanup (xfree, message);
1050 args_for_catchpoint_enable args;
1051 args.kind = bpt->owner->type == bp_catch_catch ?
1052 EX_EVENT_CATCH : EX_EVENT_THROW;
1054 val = catch_errors (cover_target_enable_exception_callback,
1055 &args, message, RETURN_MASK_ALL);
1056 do_cleanups (cleanups);
1057 if (val != 0 && val != -1)
1060 /* Check if something went wrong; val == 0 can be ignored */
1063 /* something went wrong */
1064 fprintf_unfiltered (tmp_error_stream,
1065 "Cannot insert catchpoint %d; disabling it.\n",
1066 bpt->owner->number);
1067 bpt->owner->enable_state = bp_disabled;
1074 else if (bpt->owner->type == bp_catch_fork
1075 || bpt->owner->type == bp_catch_vfork
1076 || bpt->owner->type == bp_catch_exec)
1078 char *prefix = xstrprintf ("warning: inserting catchpoint %d: ",
1079 bpt->owner->number);
1080 struct cleanup *cleanups = make_cleanup (xfree, prefix);
1081 val = catch_exceptions (uiout, insert_catchpoint, bpt->owner, prefix,
1083 do_cleanups (cleanups);
1085 bpt->owner->enable_state = bp_disabled;
1089 /* We've already printed an error message if there was a problem
1090 inserting this catchpoint, and we've disabled the catchpoint,
1091 so just return success. */
1098 /* insert_breakpoints is used when starting or continuing the program.
1099 remove_breakpoints is used when the program stops.
1100 Both return zero if successful,
1101 or an `errno' value if could not write the inferior. */
1104 insert_breakpoints (void)
1106 struct bp_location *b, *temp;
1107 int return_val = 0; /* return success code. */
1109 int disabled_breaks = 0;
1110 int hw_breakpoint_error = 0;
1111 int process_warning = 0;
1113 struct ui_file *tmp_error_stream = mem_fileopen ();
1114 make_cleanup_ui_file_delete (tmp_error_stream);
1116 /* Explicitly mark the warning -- this will only be printed if
1117 there was an error. */
1118 fprintf_unfiltered (tmp_error_stream, "Warning:\n");
1120 ALL_BP_LOCATIONS_SAFE (b, temp)
1122 /* Permanent breakpoints cannot be inserted or removed. Disabled
1123 breakpoints should not be inserted. */
1124 if (!breakpoint_enabled (b->owner))
1127 /* FIXME drow/2003-10-07: This code should be pushed elsewhere when
1128 hardware watchpoints are split into multiple loc breakpoints. */
1129 if ((b->loc_type == bp_loc_hardware_watchpoint
1130 || b->owner->type == bp_watchpoint) && !b->owner->val)
1133 val = evaluate_expression (b->owner->exp);
1134 release_value (val);
1135 if (VALUE_LAZY (val))
1136 value_fetch_lazy (val);
1137 b->owner->val = val;
1140 val = insert_bp_location (b, tmp_error_stream,
1141 &disabled_breaks, &process_warning,
1142 &hw_breakpoint_error);
1149 /* If a hardware breakpoint or watchpoint was inserted, add a
1150 message about possibly exhausted resources. */
1151 if (hw_breakpoint_error)
1153 fprintf_unfiltered (tmp_error_stream,
1154 "Could not insert hardware breakpoints:\n\
1155 You may have requested too many hardware breakpoints/watchpoints.\n");
1157 #ifdef ONE_PROCESS_WRITETEXT
1158 if (process_warning)
1159 fprintf_unfiltered (tmp_error_stream,
1160 "The same program may be running in another process.");
1162 target_terminal_ours_for_output ();
1163 error_stream (tmp_error_stream);
1169 remove_breakpoints (void)
1171 struct bp_location *b;
1174 ALL_BP_LOCATIONS (b)
1178 val = remove_breakpoint (b, mark_uninserted);
1187 remove_hw_watchpoints (void)
1189 struct bp_location *b;
1192 ALL_BP_LOCATIONS (b)
1194 if (b->inserted && b->loc_type == bp_loc_hardware_watchpoint)
1196 val = remove_breakpoint (b, mark_uninserted);
1205 reattach_breakpoints (int pid)
1207 struct bp_location *b;
1209 struct cleanup *old_chain = save_inferior_ptid ();
1211 /* Set inferior_ptid; remove_breakpoint uses this global. */
1212 inferior_ptid = pid_to_ptid (pid);
1213 ALL_BP_LOCATIONS (b)
1217 remove_breakpoint (b, mark_inserted);
1218 if (b->loc_type == bp_loc_hardware_breakpoint)
1219 val = target_insert_hw_breakpoint (b->address, b->shadow_contents);
1221 val = target_insert_breakpoint (b->address, b->shadow_contents);
1222 /* FIXME drow/2003-10-07: This doesn't handle any other kinds of
1223 breakpoints. It's wrong for watchpoints, for example. */
1226 do_cleanups (old_chain);
1231 do_cleanups (old_chain);
1236 update_breakpoints_after_exec (void)
1238 struct breakpoint *b;
1239 struct breakpoint *temp;
1241 /* Doing this first prevents the badness of having delete_breakpoint()
1242 write a breakpoint's current "shadow contents" to lift the bp. That
1243 shadow is NOT valid after an exec()! */
1244 mark_breakpoints_out ();
1246 ALL_BREAKPOINTS_SAFE (b, temp)
1248 /* Solib breakpoints must be explicitly reset after an exec(). */
1249 if (b->type == bp_shlib_event)
1251 delete_breakpoint (b);
1255 /* Thread event breakpoints must be set anew after an exec(),
1256 as must overlay event breakpoints. */
1257 if (b->type == bp_thread_event || b->type == bp_overlay_event)
1259 delete_breakpoint (b);
1263 /* Step-resume breakpoints are meaningless after an exec(). */
1264 if (b->type == bp_step_resume)
1266 delete_breakpoint (b);
1270 /* Ditto the sigtramp handler breakpoints. */
1271 if (b->type == bp_through_sigtramp)
1273 delete_breakpoint (b);
1277 /* Ditto the exception-handling catchpoints. */
1278 if ((b->type == bp_catch_catch) || (b->type == bp_catch_throw))
1280 delete_breakpoint (b);
1284 /* Don't delete an exec catchpoint, because else the inferior
1285 won't stop when it ought!
1287 Similarly, we probably ought to keep vfork catchpoints, 'cause
1288 on this target, we may not be able to stop when the vfork is
1289 seen, but only when the subsequent exec is seen. (And because
1290 deleting fork catchpoints here but not vfork catchpoints will
1291 seem mysterious to users, keep those too.)
1293 ??rehrauer: Let's hope that merely clearing out this catchpoint's
1294 target address field, if any, is sufficient to have it be reset
1295 automagically. Certainly on HP-UX that's true.
1297 Jim Blandy <jimb@redhat.com>: Actually, zero is a perfectly
1298 valid code address on some platforms (like the mn10300
1299 simulators). We shouldn't assign any special interpretation to
1300 a breakpoint with a zero address. And in fact, GDB doesn't ---
1301 I can't see what that comment above is talking about. As far
1302 as I can tell, setting the address of a
1303 bp_catch_exec/bp_catch_vfork/bp_catch_fork breakpoint to zero
1304 is meaningless, since those are implemented with HP-UX kernel
1305 hackery, not by storing breakpoint instructions somewhere. */
1306 if ((b->type == bp_catch_exec) ||
1307 (b->type == bp_catch_vfork) ||
1308 (b->type == bp_catch_fork))
1310 b->loc->address = (CORE_ADDR) NULL;
1314 /* bp_finish is a special case. The only way we ought to be able
1315 to see one of these when an exec() has happened, is if the user
1316 caught a vfork, and then said "finish". Ordinarily a finish just
1317 carries them to the call-site of the current callee, by setting
1318 a temporary bp there and resuming. But in this case, the finish
1319 will carry them entirely through the vfork & exec.
1321 We don't want to allow a bp_finish to remain inserted now. But
1322 we can't safely delete it, 'cause finish_command has a handle to
1323 the bp on a bpstat, and will later want to delete it. There's a
1324 chance (and I've seen it happen) that if we delete the bp_finish
1325 here, that its storage will get reused by the time finish_command
1326 gets 'round to deleting the "use to be a bp_finish" breakpoint.
1327 We really must allow finish_command to delete a bp_finish.
1329 In the absense of a general solution for the "how do we know
1330 it's safe to delete something others may have handles to?"
1331 problem, what we'll do here is just uninsert the bp_finish, and
1332 let finish_command delete it.
1334 (We know the bp_finish is "doomed" in the sense that it's
1335 momentary, and will be deleted as soon as finish_command sees
1336 the inferior stopped. So it doesn't matter that the bp's
1337 address is probably bogus in the new a.out, unlike e.g., the
1338 solib breakpoints.) */
1340 if (b->type == bp_finish)
1345 /* Without a symbolic address, we have little hope of the
1346 pre-exec() address meaning the same thing in the post-exec()
1348 if (b->addr_string == NULL)
1350 delete_breakpoint (b);
1354 /* If this breakpoint has survived the above battery of checks, then
1355 it must have a symbolic address. Be sure that it gets reevaluated
1356 to a target address, rather than reusing the old evaluation.
1358 Jim Blandy <jimb@redhat.com>: As explained above in the comment
1359 for bp_catch_exec and friends, I'm pretty sure this is entirely
1360 unnecessary. A call to breakpoint_re_set_one always recomputes
1361 the breakpoint's address from scratch, or deletes it if it can't.
1362 So I think this assignment could be deleted without effect. */
1363 b->loc->address = (CORE_ADDR) NULL;
1365 /* FIXME what about longjmp breakpoints? Re-create them here? */
1366 create_overlay_event_breakpoint ("_ovly_debug_event");
1370 detach_breakpoints (int pid)
1372 struct bp_location *b;
1374 struct cleanup *old_chain = save_inferior_ptid ();
1376 if (pid == PIDGET (inferior_ptid))
1377 error ("Cannot detach breakpoints of inferior_ptid");
1379 /* Set inferior_ptid; remove_breakpoint uses this global. */
1380 inferior_ptid = pid_to_ptid (pid);
1381 ALL_BP_LOCATIONS (b)
1385 val = remove_breakpoint (b, mark_inserted);
1388 do_cleanups (old_chain);
1393 do_cleanups (old_chain);
1398 remove_breakpoint (struct bp_location *b, insertion_state_t is)
1402 if (b->owner->enable_state == bp_permanent)
1403 /* Permanent breakpoints cannot be inserted or removed. */
1406 if (b->owner->type == bp_none)
1407 warning ("attempted to remove apparently deleted breakpoint #%d?",
1410 if (b->loc_type == bp_loc_software_breakpoint
1411 || b->loc_type == bp_loc_hardware_breakpoint)
1413 /* "Normal" instruction breakpoint: either the standard
1414 trap-instruction bp (bp_breakpoint), or a
1415 bp_hardware_breakpoint. */
1417 /* First check to see if we have to handle an overlay. */
1418 if (overlay_debugging == ovly_off
1419 || b->section == NULL
1420 || !(section_is_overlay (b->section)))
1422 /* No overlay handling: just remove the breakpoint. */
1424 if (b->loc_type == bp_loc_hardware_breakpoint)
1425 val = target_remove_hw_breakpoint (b->address,
1426 b->shadow_contents);
1428 val = target_remove_breakpoint (b->address, b->shadow_contents);
1432 /* This breakpoint is in an overlay section.
1433 Did we set a breakpoint at the LMA? */
1434 if (!overlay_events_enabled)
1436 /* Yes -- overlay event support is not active, so we
1437 should have set a breakpoint at the LMA. Remove it.
1439 CORE_ADDR addr = overlay_unmapped_address (b->address,
1441 /* Ignore any failures: if the LMA is in ROM, we will
1442 have already warned when we failed to insert it. */
1443 if (b->loc_type == bp_loc_hardware_breakpoint)
1444 target_remove_hw_breakpoint (addr, b->shadow_contents);
1446 target_remove_breakpoint (addr, b->shadow_contents);
1448 /* Did we set a breakpoint at the VMA?
1449 If so, we will have marked the breakpoint 'inserted'. */
1452 /* Yes -- remove it. Previously we did not bother to
1453 remove the breakpoint if the section had been
1454 unmapped, but let's not rely on that being safe. We
1455 don't know what the overlay manager might do. */
1456 if (b->loc_type == bp_loc_hardware_breakpoint)
1457 val = target_remove_hw_breakpoint (b->address,
1458 b->shadow_contents);
1460 val = target_remove_breakpoint (b->address,
1461 b->shadow_contents);
1465 /* No -- not inserted, so no need to remove. No error. */
1471 b->inserted = (is == mark_inserted);
1473 else if (b->loc_type == bp_loc_hardware_watchpoint
1474 && breakpoint_enabled (b->owner)
1480 b->inserted = (is == mark_inserted);
1481 /* Walk down the saved value chain. */
1482 for (v = b->owner->val_chain; v; v = v->next)
1484 /* For each memory reference remove the watchpoint
1486 if (VALUE_LVAL (v) == lval_memory
1487 && ! VALUE_LAZY (v))
1489 struct type *vtype = check_typedef (value_type (v));
1491 if (v == b->owner->val_chain
1492 || (TYPE_CODE (vtype) != TYPE_CODE_STRUCT
1493 && TYPE_CODE (vtype) != TYPE_CODE_ARRAY))
1498 addr = VALUE_ADDRESS (v) + value_offset (v);
1499 len = TYPE_LENGTH (value_type (v));
1501 if (b->owner->type == bp_read_watchpoint)
1503 else if (b->owner->type == bp_access_watchpoint)
1506 val = target_remove_watchpoint (addr, len, type);
1513 /* Failure to remove any of the hardware watchpoints comes here. */
1514 if ((is == mark_uninserted) && (b->inserted))
1515 warning ("Could not remove hardware watchpoint %d.",
1518 else if ((b->owner->type == bp_catch_fork ||
1519 b->owner->type == bp_catch_vfork ||
1520 b->owner->type == bp_catch_exec)
1521 && breakpoint_enabled (b->owner)
1525 switch (b->owner->type)
1528 val = target_remove_fork_catchpoint (PIDGET (inferior_ptid));
1530 case bp_catch_vfork:
1531 val = target_remove_vfork_catchpoint (PIDGET (inferior_ptid));
1534 val = target_remove_exec_catchpoint (PIDGET (inferior_ptid));
1537 warning ("Internal error, %s line %d.", __FILE__, __LINE__);
1542 b->inserted = (is == mark_inserted);
1544 else if ((b->owner->type == bp_catch_catch ||
1545 b->owner->type == bp_catch_throw)
1546 && breakpoint_enabled (b->owner)
1550 val = target_remove_breakpoint (b->address, b->shadow_contents);
1553 b->inserted = (is == mark_inserted);
1555 else if (ep_is_exception_catchpoint (b->owner)
1556 && b->inserted /* sometimes previous insert doesn't happen */
1557 && breakpoint_enabled (b->owner)
1561 val = target_remove_breakpoint (b->address, b->shadow_contents);
1565 b->inserted = (is == mark_inserted);
1571 /* Clear the "inserted" flag in all breakpoints. */
1574 mark_breakpoints_out (void)
1576 struct bp_location *bpt;
1578 ALL_BP_LOCATIONS (bpt)
1582 /* Clear the "inserted" flag in all breakpoints and delete any
1583 breakpoints which should go away between runs of the program.
1585 Plus other such housekeeping that has to be done for breakpoints
1588 Note: this function gets called at the end of a run (by
1589 generic_mourn_inferior) and when a run begins (by
1590 init_wait_for_inferior). */
1595 breakpoint_init_inferior (enum inf_context context)
1597 struct breakpoint *b, *temp;
1598 struct bp_location *bpt;
1599 static int warning_needed = 0;
1601 ALL_BP_LOCATIONS (bpt)
1604 ALL_BREAKPOINTS_SAFE (b, temp)
1609 case bp_watchpoint_scope:
1611 /* If the call dummy breakpoint is at the entry point it will
1612 cause problems when the inferior is rerun, so we better
1615 Also get rid of scope breakpoints. */
1616 delete_breakpoint (b);
1620 case bp_hardware_watchpoint:
1621 case bp_read_watchpoint:
1622 case bp_access_watchpoint:
1624 /* Likewise for watchpoints on local expressions. */
1625 if (b->exp_valid_block != NULL)
1626 delete_breakpoint (b);
1627 if (context == inf_starting)
1629 /* Reset val field to force reread of starting value
1630 in insert_breakpoints. */
1632 value_free (b->val);
1637 /* Likewise for exception catchpoints in dynamic-linked
1638 executables where required */
1639 if (ep_is_exception_catchpoint (b)
1640 && deprecated_exception_catchpoints_are_fragile)
1643 delete_breakpoint (b);
1649 if (deprecated_exception_catchpoints_are_fragile)
1650 deprecated_exception_support_initialized = 0;
1652 /* Don't issue the warning unless it's really needed... */
1653 if (warning_needed && (context != inf_exited))
1655 warning ("Exception catchpoints from last run were deleted.");
1656 warning ("You must reinsert them explicitly.");
1661 /* breakpoint_here_p (PC) returns non-zero if an enabled breakpoint
1662 exists at PC. It returns ordinary_breakpoint_here if it's an
1663 ordinary breakpoint, or permanent_breakpoint_here if it's a
1664 permanent breakpoint.
1665 - When continuing from a location with an ordinary breakpoint, we
1666 actually single step once before calling insert_breakpoints.
1667 - When continuing from a localion with a permanent breakpoint, we
1668 need to use the `SKIP_PERMANENT_BREAKPOINT' macro, provided by
1669 the target, to advance the PC past the breakpoint. */
1671 enum breakpoint_here
1672 breakpoint_here_p (CORE_ADDR pc)
1674 struct bp_location *bpt;
1675 int any_breakpoint_here = 0;
1677 ALL_BP_LOCATIONS (bpt)
1679 if (bpt->loc_type != bp_loc_software_breakpoint
1680 && bpt->loc_type != bp_loc_hardware_breakpoint)
1683 if ((breakpoint_enabled (bpt->owner)
1684 || bpt->owner->enable_state == bp_permanent)
1685 && bpt->address == pc) /* bp is enabled and matches pc */
1687 if (overlay_debugging
1688 && section_is_overlay (bpt->section)
1689 && !section_is_mapped (bpt->section))
1690 continue; /* unmapped overlay -- can't be a match */
1691 else if (bpt->owner->enable_state == bp_permanent)
1692 return permanent_breakpoint_here;
1694 any_breakpoint_here = 1;
1698 return any_breakpoint_here ? ordinary_breakpoint_here : 0;
1702 /* breakpoint_inserted_here_p (PC) is just like breakpoint_here_p(),
1703 but it only returns true if there is actually a breakpoint inserted
1707 breakpoint_inserted_here_p (CORE_ADDR pc)
1709 struct bp_location *bpt;
1711 ALL_BP_LOCATIONS (bpt)
1713 if (bpt->loc_type != bp_loc_software_breakpoint
1714 && bpt->loc_type != bp_loc_hardware_breakpoint)
1718 && bpt->address == pc) /* bp is inserted and matches pc */
1720 if (overlay_debugging
1721 && section_is_overlay (bpt->section)
1722 && !section_is_mapped (bpt->section))
1723 continue; /* unmapped overlay -- can't be a match */
1732 /* This function returns non-zero iff there is a software breakpoint
1736 software_breakpoint_inserted_here_p (CORE_ADDR pc)
1738 struct bp_location *bpt;
1739 int any_breakpoint_here = 0;
1741 ALL_BP_LOCATIONS (bpt)
1743 if (bpt->loc_type != bp_loc_software_breakpoint)
1746 if ((breakpoint_enabled (bpt->owner)
1747 || bpt->owner->enable_state == bp_permanent)
1749 && bpt->address == pc) /* bp is enabled and matches pc */
1751 if (overlay_debugging
1752 && section_is_overlay (bpt->section)
1753 && !section_is_mapped (bpt->section))
1754 continue; /* unmapped overlay -- can't be a match */
1763 /* breakpoint_thread_match (PC, PTID) returns true if the breakpoint at
1764 PC is valid for process/thread PTID. */
1767 breakpoint_thread_match (CORE_ADDR pc, ptid_t ptid)
1769 struct bp_location *bpt;
1772 thread = pid_to_thread_id (ptid);
1774 ALL_BP_LOCATIONS (bpt)
1776 if (bpt->loc_type != bp_loc_software_breakpoint
1777 && bpt->loc_type != bp_loc_hardware_breakpoint)
1780 if ((breakpoint_enabled (bpt->owner)
1781 || bpt->owner->enable_state == bp_permanent)
1782 && bpt->address == pc
1783 && (bpt->owner->thread == -1 || bpt->owner->thread == thread))
1785 if (overlay_debugging
1786 && section_is_overlay (bpt->section)
1787 && !section_is_mapped (bpt->section))
1788 continue; /* unmapped overlay -- can't be a match */
1798 /* bpstat stuff. External routines' interfaces are documented
1802 ep_is_catchpoint (struct breakpoint *ep)
1805 (ep->type == bp_catch_load)
1806 || (ep->type == bp_catch_unload)
1807 || (ep->type == bp_catch_fork)
1808 || (ep->type == bp_catch_vfork)
1809 || (ep->type == bp_catch_exec)
1810 || (ep->type == bp_catch_catch)
1811 || (ep->type == bp_catch_throw);
1813 /* ??rehrauer: Add more kinds here, as are implemented... */
1817 ep_is_shlib_catchpoint (struct breakpoint *ep)
1820 (ep->type == bp_catch_load)
1821 || (ep->type == bp_catch_unload);
1825 ep_is_exception_catchpoint (struct breakpoint *ep)
1828 (ep->type == bp_catch_catch)
1829 || (ep->type == bp_catch_throw);
1832 /* Clear a bpstat so that it says we are not at any breakpoint.
1833 Also free any storage that is part of a bpstat. */
1836 bpstat_clear (bpstat *bsp)
1847 if (p->old_val != NULL)
1848 value_free (p->old_val);
1849 free_command_lines (&p->commands);
1856 /* Return a copy of a bpstat. Like "bs1 = bs2" but all storage that
1857 is part of the bpstat is copied as well. */
1860 bpstat_copy (bpstat bs)
1864 bpstat retval = NULL;
1869 for (; bs != NULL; bs = bs->next)
1871 tmp = (bpstat) xmalloc (sizeof (*tmp));
1872 memcpy (tmp, bs, sizeof (*tmp));
1873 if (bs->commands != NULL)
1874 tmp->commands = copy_command_lines (bs->commands);
1875 if (bs->old_val != NULL)
1876 tmp->old_val = value_copy (bs->old_val);
1879 /* This is the first thing in the chain. */
1889 /* Find the bpstat associated with this breakpoint */
1892 bpstat_find_breakpoint (bpstat bsp, struct breakpoint *breakpoint)
1897 for (; bsp != NULL; bsp = bsp->next)
1899 if (bsp->breakpoint_at == breakpoint)
1905 /* Find a step_resume breakpoint associated with this bpstat.
1906 (If there are multiple step_resume bp's on the list, this function
1907 will arbitrarily pick one.)
1909 It is an error to use this function if BPSTAT doesn't contain a
1910 step_resume breakpoint.
1912 See wait_for_inferior's use of this function. */
1914 bpstat_find_step_resume_breakpoint (bpstat bsp)
1919 error ("Internal error (bpstat_find_step_resume_breakpoint)");
1921 current_thread = pid_to_thread_id (inferior_ptid);
1923 for (; bsp != NULL; bsp = bsp->next)
1925 if ((bsp->breakpoint_at != NULL) &&
1926 (bsp->breakpoint_at->type == bp_step_resume) &&
1927 (bsp->breakpoint_at->thread == current_thread ||
1928 bsp->breakpoint_at->thread == -1))
1929 return bsp->breakpoint_at;
1932 error ("Internal error (no step_resume breakpoint found)");
1936 /* Return the breakpoint number of the first breakpoint we are stopped
1937 at. *BSP upon return is a bpstat which points to the remaining
1938 breakpoints stopped at (but which is not guaranteed to be good for
1939 anything but further calls to bpstat_num).
1940 Return 0 if passed a bpstat which does not indicate any breakpoints. */
1943 bpstat_num (bpstat *bsp)
1945 struct breakpoint *b;
1948 return 0; /* No more breakpoint values */
1951 b = (*bsp)->breakpoint_at;
1952 *bsp = (*bsp)->next;
1954 return -1; /* breakpoint that's been deleted since */
1956 return b->number; /* We have its number */
1960 /* Modify BS so that the actions will not be performed. */
1963 bpstat_clear_actions (bpstat bs)
1965 for (; bs != NULL; bs = bs->next)
1967 free_command_lines (&bs->commands);
1968 if (bs->old_val != NULL)
1970 value_free (bs->old_val);
1976 /* Stub for cleaning up our state if we error-out of a breakpoint command */
1978 cleanup_executing_breakpoints (void *ignore)
1980 executing_breakpoint_commands = 0;
1983 /* Execute all the commands associated with all the breakpoints at this
1984 location. Any of these commands could cause the process to proceed
1985 beyond this point, etc. We look out for such changes by checking
1986 the global "breakpoint_proceeded" after each command. */
1989 bpstat_do_actions (bpstat *bsp)
1992 struct cleanup *old_chain;
1994 /* Avoid endless recursion if a `source' command is contained
1996 if (executing_breakpoint_commands)
1999 executing_breakpoint_commands = 1;
2000 old_chain = make_cleanup (cleanup_executing_breakpoints, 0);
2003 /* Note that (as of this writing), our callers all appear to
2004 be passing us the address of global stop_bpstat. And, if
2005 our calls to execute_control_command cause the inferior to
2006 proceed, that global (and hence, *bsp) will change.
2008 We must be careful to not touch *bsp unless the inferior
2009 has not proceeded. */
2011 /* This pointer will iterate over the list of bpstat's. */
2014 breakpoint_proceeded = 0;
2015 for (; bs != NULL; bs = bs->next)
2017 struct command_line *cmd;
2018 struct cleanup *this_cmd_tree_chain;
2020 /* Take ownership of the BSP's command tree, if it has one.
2022 The command tree could legitimately contain commands like
2023 'step' and 'next', which call clear_proceed_status, which
2024 frees stop_bpstat's command tree. To make sure this doesn't
2025 free the tree we're executing out from under us, we need to
2026 take ownership of the tree ourselves. Since a given bpstat's
2027 commands are only executed once, we don't need to copy it; we
2028 can clear the pointer in the bpstat, and make sure we free
2029 the tree when we're done. */
2032 this_cmd_tree_chain = make_cleanup_free_command_lines (&cmd);
2036 execute_control_command (cmd);
2038 if (breakpoint_proceeded)
2044 /* We can free this command tree now. */
2045 do_cleanups (this_cmd_tree_chain);
2047 if (breakpoint_proceeded)
2048 /* The inferior is proceeded by the command; bomb out now.
2049 The bpstat chain has been blown away by wait_for_inferior.
2050 But since execution has stopped again, there is a new bpstat
2051 to look at, so start over. */
2054 do_cleanups (old_chain);
2057 /* This is the normal print function for a bpstat. In the future,
2058 much of this logic could (should?) be moved to bpstat_stop_status,
2059 by having it set different print_it values.
2061 Current scheme: When we stop, bpstat_print() is called. It loops
2062 through the bpstat list of things causing this stop, calling the
2063 print_bp_stop_message function on each one. The behavior of the
2064 print_bp_stop_message function depends on the print_it field of
2065 bpstat. If such field so indicates, call this function here.
2067 Return values from this routine (ultimately used by bpstat_print()
2068 and normal_stop() to decide what to do):
2069 PRINT_NOTHING: Means we already printed all we needed to print,
2070 don't print anything else.
2071 PRINT_SRC_ONLY: Means we printed something, and we do *not* desire
2072 that something to be followed by a location.
2073 PRINT_SCR_AND_LOC: Means we printed something, and we *do* desire
2074 that something to be followed by a location.
2075 PRINT_UNKNOWN: Means we printed nothing or we need to do some more
2078 static enum print_stop_action
2079 print_it_typical (bpstat bs)
2081 struct cleanup *old_chain, *ui_out_chain;
2082 struct ui_stream *stb;
2083 stb = ui_out_stream_new (uiout);
2084 old_chain = make_cleanup_ui_out_stream_delete (stb);
2085 /* bs->breakpoint_at can be NULL if it was a momentary breakpoint
2086 which has since been deleted. */
2087 if (bs->breakpoint_at == NULL)
2088 return PRINT_UNKNOWN;
2090 switch (bs->breakpoint_at->type)
2093 case bp_hardware_breakpoint:
2094 if (bs->breakpoint_at->loc->address != bs->breakpoint_at->loc->requested_address)
2095 breakpoint_adjustment_warning (bs->breakpoint_at->loc->requested_address,
2096 bs->breakpoint_at->loc->address,
2097 bs->breakpoint_at->number, 1);
2098 annotate_breakpoint (bs->breakpoint_at->number);
2099 ui_out_text (uiout, "\nBreakpoint ");
2100 if (ui_out_is_mi_like_p (uiout))
2101 ui_out_field_string (uiout, "reason", "breakpoint-hit");
2102 ui_out_field_int (uiout, "bkptno", bs->breakpoint_at->number);
2103 ui_out_text (uiout, ", ");
2104 return PRINT_SRC_AND_LOC;
2107 case bp_shlib_event:
2108 /* Did we stop because the user set the stop_on_solib_events
2109 variable? (If so, we report this as a generic, "Stopped due
2110 to shlib event" message.) */
2111 printf_filtered ("Stopped due to shared library event\n");
2112 return PRINT_NOTHING;
2115 case bp_thread_event:
2116 /* Not sure how we will get here.
2117 GDB should not stop for these breakpoints. */
2118 printf_filtered ("Thread Event Breakpoint: gdb should not stop!\n");
2119 return PRINT_NOTHING;
2122 case bp_overlay_event:
2123 /* By analogy with the thread event, GDB should not stop for these. */
2124 printf_filtered ("Overlay Event Breakpoint: gdb should not stop!\n");
2125 return PRINT_NOTHING;
2129 annotate_catchpoint (bs->breakpoint_at->number);
2130 printf_filtered ("\nCatchpoint %d (", bs->breakpoint_at->number);
2131 printf_filtered ("loaded");
2132 printf_filtered (" %s), ", bs->breakpoint_at->triggered_dll_pathname);
2133 return PRINT_SRC_AND_LOC;
2136 case bp_catch_unload:
2137 annotate_catchpoint (bs->breakpoint_at->number);
2138 printf_filtered ("\nCatchpoint %d (", bs->breakpoint_at->number);
2139 printf_filtered ("unloaded");
2140 printf_filtered (" %s), ", bs->breakpoint_at->triggered_dll_pathname);
2141 return PRINT_SRC_AND_LOC;
2145 annotate_catchpoint (bs->breakpoint_at->number);
2146 printf_filtered ("\nCatchpoint %d (", bs->breakpoint_at->number);
2147 printf_filtered ("forked");
2148 printf_filtered (" process %d), ",
2149 bs->breakpoint_at->forked_inferior_pid);
2150 return PRINT_SRC_AND_LOC;
2153 case bp_catch_vfork:
2154 annotate_catchpoint (bs->breakpoint_at->number);
2155 printf_filtered ("\nCatchpoint %d (", bs->breakpoint_at->number);
2156 printf_filtered ("vforked");
2157 printf_filtered (" process %d), ",
2158 bs->breakpoint_at->forked_inferior_pid);
2159 return PRINT_SRC_AND_LOC;
2163 annotate_catchpoint (bs->breakpoint_at->number);
2164 printf_filtered ("\nCatchpoint %d (exec'd %s), ",
2165 bs->breakpoint_at->number,
2166 bs->breakpoint_at->exec_pathname);
2167 return PRINT_SRC_AND_LOC;
2170 case bp_catch_catch:
2171 if (current_exception_event &&
2172 (CURRENT_EXCEPTION_KIND == EX_EVENT_CATCH))
2174 annotate_catchpoint (bs->breakpoint_at->number);
2175 printf_filtered ("\nCatchpoint %d (exception caught), ",
2176 bs->breakpoint_at->number);
2177 printf_filtered ("throw location ");
2178 if (CURRENT_EXCEPTION_THROW_PC && CURRENT_EXCEPTION_THROW_LINE)
2179 printf_filtered ("%s:%d",
2180 CURRENT_EXCEPTION_THROW_FILE,
2181 CURRENT_EXCEPTION_THROW_LINE);
2183 printf_filtered ("unknown");
2185 printf_filtered (", catch location ");
2186 if (CURRENT_EXCEPTION_CATCH_PC && CURRENT_EXCEPTION_CATCH_LINE)
2187 printf_filtered ("%s:%d",
2188 CURRENT_EXCEPTION_CATCH_FILE,
2189 CURRENT_EXCEPTION_CATCH_LINE);
2191 printf_filtered ("unknown");
2193 printf_filtered ("\n");
2194 /* don't bother to print location frame info */
2195 return PRINT_SRC_ONLY;
2199 /* really throw, some other bpstat will handle it */
2200 return PRINT_UNKNOWN;
2204 case bp_catch_throw:
2205 if (current_exception_event &&
2206 (CURRENT_EXCEPTION_KIND == EX_EVENT_THROW))
2208 annotate_catchpoint (bs->breakpoint_at->number);
2209 printf_filtered ("\nCatchpoint %d (exception thrown), ",
2210 bs->breakpoint_at->number);
2211 printf_filtered ("throw location ");
2212 if (CURRENT_EXCEPTION_THROW_PC && CURRENT_EXCEPTION_THROW_LINE)
2213 printf_filtered ("%s:%d",
2214 CURRENT_EXCEPTION_THROW_FILE,
2215 CURRENT_EXCEPTION_THROW_LINE);
2217 printf_filtered ("unknown");
2219 printf_filtered (", catch location ");
2220 if (CURRENT_EXCEPTION_CATCH_PC && CURRENT_EXCEPTION_CATCH_LINE)
2221 printf_filtered ("%s:%d",
2222 CURRENT_EXCEPTION_CATCH_FILE,
2223 CURRENT_EXCEPTION_CATCH_LINE);
2225 printf_filtered ("unknown");
2227 printf_filtered ("\n");
2228 /* don't bother to print location frame info */
2229 return PRINT_SRC_ONLY;
2233 /* really catch, some other bpstat will handle it */
2234 return PRINT_UNKNOWN;
2239 case bp_hardware_watchpoint:
2240 if (bs->old_val != NULL)
2242 annotate_watchpoint (bs->breakpoint_at->number);
2243 if (ui_out_is_mi_like_p (uiout))
2244 ui_out_field_string (uiout, "reason", "watchpoint-trigger");
2245 mention (bs->breakpoint_at);
2246 ui_out_chain = make_cleanup_ui_out_tuple_begin_end (uiout, "value");
2247 ui_out_text (uiout, "\nOld value = ");
2248 value_print (bs->old_val, stb->stream, 0, Val_pretty_default);
2249 ui_out_field_stream (uiout, "old", stb);
2250 ui_out_text (uiout, "\nNew value = ");
2251 value_print (bs->breakpoint_at->val, stb->stream, 0, Val_pretty_default);
2252 ui_out_field_stream (uiout, "new", stb);
2253 do_cleanups (ui_out_chain);
2254 ui_out_text (uiout, "\n");
2255 value_free (bs->old_val);
2258 /* More than one watchpoint may have been triggered. */
2259 return PRINT_UNKNOWN;
2262 case bp_read_watchpoint:
2263 if (ui_out_is_mi_like_p (uiout))
2264 ui_out_field_string (uiout, "reason", "read-watchpoint-trigger");
2265 mention (bs->breakpoint_at);
2266 ui_out_chain = make_cleanup_ui_out_tuple_begin_end (uiout, "value");
2267 ui_out_text (uiout, "\nValue = ");
2268 value_print (bs->breakpoint_at->val, stb->stream, 0, Val_pretty_default);
2269 ui_out_field_stream (uiout, "value", stb);
2270 do_cleanups (ui_out_chain);
2271 ui_out_text (uiout, "\n");
2272 return PRINT_UNKNOWN;
2275 case bp_access_watchpoint:
2276 if (bs->old_val != NULL)
2278 annotate_watchpoint (bs->breakpoint_at->number);
2279 if (ui_out_is_mi_like_p (uiout))
2280 ui_out_field_string (uiout, "reason", "access-watchpoint-trigger");
2281 mention (bs->breakpoint_at);
2282 ui_out_chain = make_cleanup_ui_out_tuple_begin_end (uiout, "value");
2283 ui_out_text (uiout, "\nOld value = ");
2284 value_print (bs->old_val, stb->stream, 0, Val_pretty_default);
2285 ui_out_field_stream (uiout, "old", stb);
2286 value_free (bs->old_val);
2288 ui_out_text (uiout, "\nNew value = ");
2292 mention (bs->breakpoint_at);
2293 if (ui_out_is_mi_like_p (uiout))
2294 ui_out_field_string (uiout, "reason", "access-watchpoint-trigger");
2295 ui_out_chain = make_cleanup_ui_out_tuple_begin_end (uiout, "value");
2296 ui_out_text (uiout, "\nValue = ");
2298 value_print (bs->breakpoint_at->val, stb->stream, 0,Val_pretty_default);
2299 ui_out_field_stream (uiout, "new", stb);
2300 do_cleanups (ui_out_chain);
2301 ui_out_text (uiout, "\n");
2302 return PRINT_UNKNOWN;
2305 /* Fall through, we don't deal with these types of breakpoints
2309 if (ui_out_is_mi_like_p (uiout))
2310 ui_out_field_string (uiout, "reason", "function-finished");
2311 return PRINT_UNKNOWN;
2315 if (ui_out_is_mi_like_p (uiout))
2316 ui_out_field_string (uiout, "reason", "location-reached");
2317 return PRINT_UNKNOWN;
2322 case bp_longjmp_resume:
2323 case bp_step_resume:
2324 case bp_through_sigtramp:
2325 case bp_watchpoint_scope:
2328 return PRINT_UNKNOWN;
2332 /* Generic routine for printing messages indicating why we
2333 stopped. The behavior of this function depends on the value
2334 'print_it' in the bpstat structure. Under some circumstances we
2335 may decide not to print anything here and delegate the task to
2338 static enum print_stop_action
2339 print_bp_stop_message (bpstat bs)
2341 switch (bs->print_it)
2344 /* Nothing should be printed for this bpstat entry. */
2345 return PRINT_UNKNOWN;
2349 /* We still want to print the frame, but we already printed the
2350 relevant messages. */
2351 return PRINT_SRC_AND_LOC;
2354 case print_it_normal:
2355 /* Normal case. Call the breakpoint's print_it method, or
2356 print_it_typical. */
2357 if (bs->breakpoint_at != NULL && bs->breakpoint_at->ops != NULL
2358 && bs->breakpoint_at->ops->print_it != NULL)
2359 return bs->breakpoint_at->ops->print_it (bs->breakpoint_at);
2361 return print_it_typical (bs);
2365 internal_error (__FILE__, __LINE__,
2366 "print_bp_stop_message: unrecognized enum value");
2371 /* Print a message indicating what happened. This is called from
2372 normal_stop(). The input to this routine is the head of the bpstat
2373 list - a list of the eventpoints that caused this stop. This
2374 routine calls the generic print routine for printing a message
2375 about reasons for stopping. This will print (for example) the
2376 "Breakpoint n," part of the output. The return value of this
2379 PRINT_UNKNOWN: Means we printed nothing
2380 PRINT_SRC_AND_LOC: Means we printed something, and expect subsequent
2381 code to print the location. An example is
2382 "Breakpoint 1, " which should be followed by
2384 PRINT_SRC_ONLY: Means we printed something, but there is no need
2385 to also print the location part of the message.
2386 An example is the catch/throw messages, which
2387 don't require a location appended to the end.
2388 PRINT_NOTHING: We have done some printing and we don't need any
2389 further info to be printed.*/
2391 enum print_stop_action
2392 bpstat_print (bpstat bs)
2396 /* Maybe another breakpoint in the chain caused us to stop.
2397 (Currently all watchpoints go on the bpstat whether hit or not.
2398 That probably could (should) be changed, provided care is taken
2399 with respect to bpstat_explains_signal). */
2400 for (; bs; bs = bs->next)
2402 val = print_bp_stop_message (bs);
2403 if (val == PRINT_SRC_ONLY
2404 || val == PRINT_SRC_AND_LOC
2405 || val == PRINT_NOTHING)
2409 /* We reached the end of the chain, or we got a null BS to start
2410 with and nothing was printed. */
2411 return PRINT_UNKNOWN;
2414 /* Evaluate the expression EXP and return 1 if value is zero.
2415 This is used inside a catch_errors to evaluate the breakpoint condition.
2416 The argument is a "struct expression *" that has been cast to char * to
2417 make it pass through catch_errors. */
2420 breakpoint_cond_eval (void *exp)
2422 struct value *mark = value_mark ();
2423 int i = !value_true (evaluate_expression ((struct expression *) exp));
2424 value_free_to_mark (mark);
2428 /* Allocate a new bpstat and chain it to the current one. */
2431 bpstat_alloc (struct breakpoint *b, bpstat cbs /* Current "bs" value */ )
2435 bs = (bpstat) xmalloc (sizeof (*bs));
2437 bs->breakpoint_at = b;
2438 /* If the condition is false, etc., don't do the commands. */
2439 bs->commands = NULL;
2441 bs->print_it = print_it_normal;
2445 /* Possible return values for watchpoint_check (this can't be an enum
2446 because of check_errors). */
2447 /* The watchpoint has been deleted. */
2448 #define WP_DELETED 1
2449 /* The value has changed. */
2450 #define WP_VALUE_CHANGED 2
2451 /* The value has not changed. */
2452 #define WP_VALUE_NOT_CHANGED 3
2454 #define BP_TEMPFLAG 1
2455 #define BP_HARDWAREFLAG 2
2457 /* Check watchpoint condition. */
2460 watchpoint_check (void *p)
2462 bpstat bs = (bpstat) p;
2463 struct breakpoint *b;
2464 struct frame_info *fr;
2465 int within_current_scope;
2467 b = bs->breakpoint_at;
2469 if (b->exp_valid_block == NULL)
2470 within_current_scope = 1;
2473 /* There is no current frame at this moment. If we're going to have
2474 any chance of handling watchpoints on local variables, we'll need
2475 the frame chain (so we can determine if we're in scope). */
2476 reinit_frame_cache ();
2477 fr = frame_find_by_id (b->watchpoint_frame);
2478 within_current_scope = (fr != NULL);
2479 /* in_function_epilogue_p() returns a non-zero value if we're still
2480 in the function but the stack frame has already been invalidated.
2481 Since we can't rely on the values of local variables after the
2482 stack has been destroyed, we are treating the watchpoint in that
2483 state as `not changed' without further checking.
2485 vinschen/2003-09-04: The former implementation left out the case
2486 that the watchpoint frame couldn't be found by frame_find_by_id()
2487 because the current PC is currently in an epilogue. Calling
2488 gdbarch_in_function_epilogue_p() also when fr == NULL fixes that. */
2489 if ((!within_current_scope || fr == get_current_frame ())
2490 && gdbarch_in_function_epilogue_p (current_gdbarch, read_pc ()))
2491 return WP_VALUE_NOT_CHANGED;
2492 if (fr && within_current_scope)
2493 /* If we end up stopping, the current frame will get selected
2494 in normal_stop. So this call to select_frame won't affect
2499 if (within_current_scope)
2501 /* We use value_{,free_to_}mark because it could be a
2502 *long* time before we return to the command level and
2503 call free_all_values. We can't call free_all_values because
2504 we might be in the middle of evaluating a function call. */
2506 struct value *mark = value_mark ();
2507 struct value *new_val = evaluate_expression (bs->breakpoint_at->exp);
2508 if (!value_equal (b->val, new_val))
2510 release_value (new_val);
2511 value_free_to_mark (mark);
2512 bs->old_val = b->val;
2514 /* We will stop here */
2515 return WP_VALUE_CHANGED;
2519 /* Nothing changed, don't do anything. */
2520 value_free_to_mark (mark);
2521 /* We won't stop here */
2522 return WP_VALUE_NOT_CHANGED;
2527 /* This seems like the only logical thing to do because
2528 if we temporarily ignored the watchpoint, then when
2529 we reenter the block in which it is valid it contains
2530 garbage (in the case of a function, it may have two
2531 garbage values, one before and one after the prologue).
2532 So we can't even detect the first assignment to it and
2533 watch after that (since the garbage may or may not equal
2534 the first value assigned). */
2535 /* We print all the stop information in print_it_typical(), but
2536 in this case, by the time we call print_it_typical() this bp
2537 will be deleted already. So we have no choice but print the
2538 information here. */
2539 if (ui_out_is_mi_like_p (uiout))
2540 ui_out_field_string (uiout, "reason", "watchpoint-scope");
2541 ui_out_text (uiout, "\nWatchpoint ");
2542 ui_out_field_int (uiout, "wpnum", bs->breakpoint_at->number);
2543 ui_out_text (uiout, " deleted because the program has left the block in\n\
2544 which its expression is valid.\n");
2546 if (b->related_breakpoint)
2547 b->related_breakpoint->disposition = disp_del_at_next_stop;
2548 b->disposition = disp_del_at_next_stop;
2554 /* Get a bpstat associated with having just stopped at address
2555 BP_ADDR in thread PTID. STOPPED_BY_WATCHPOINT is 1 if the
2556 target thinks we stopped due to a hardware watchpoint, 0 if we
2557 know we did not trigger a hardware watchpoint, and -1 if we do not know. */
2559 /* Determine whether we stopped at a breakpoint, etc, or whether we
2560 don't understand this stop. Result is a chain of bpstat's such that:
2562 if we don't understand the stop, the result is a null pointer.
2564 if we understand why we stopped, the result is not null.
2566 Each element of the chain refers to a particular breakpoint or
2567 watchpoint at which we have stopped. (We may have stopped for
2568 several reasons concurrently.)
2570 Each element of the chain has valid next, breakpoint_at,
2571 commands, FIXME??? fields. */
2574 bpstat_stop_status (CORE_ADDR bp_addr, ptid_t ptid, int stopped_by_watchpoint)
2576 struct breakpoint *b, *temp;
2577 /* True if we've hit a breakpoint (as opposed to a watchpoint). */
2578 int real_breakpoint = 0;
2579 /* Root of the chain of bpstat's */
2580 struct bpstats root_bs[1];
2581 /* Pointer to the last thing in the chain currently. */
2582 bpstat bs = root_bs;
2583 int thread_id = pid_to_thread_id (ptid);
2585 ALL_BREAKPOINTS_SAFE (b, temp)
2587 if (!breakpoint_enabled (b) && b->enable_state != bp_permanent)
2590 if (b->type != bp_watchpoint
2591 && b->type != bp_hardware_watchpoint
2592 && b->type != bp_read_watchpoint
2593 && b->type != bp_access_watchpoint
2594 && b->type != bp_hardware_breakpoint
2595 && b->type != bp_catch_fork
2596 && b->type != bp_catch_vfork
2597 && b->type != bp_catch_exec
2598 && b->type != bp_catch_catch
2599 && b->type != bp_catch_throw) /* a non-watchpoint bp */
2601 if (b->loc->address != bp_addr) /* address doesn't match */
2603 if (overlay_debugging /* unmapped overlay section */
2604 && section_is_overlay (b->loc->section)
2605 && !section_is_mapped (b->loc->section))
2609 /* Continuable hardware watchpoints are treated as non-existent if the
2610 reason we stopped wasn't a hardware watchpoint (we didn't stop on
2611 some data address). Otherwise gdb won't stop on a break instruction
2612 in the code (not from a breakpoint) when a hardware watchpoint has
2615 if ((b->type == bp_hardware_watchpoint
2616 || b->type == bp_read_watchpoint
2617 || b->type == bp_access_watchpoint)
2618 && !stopped_by_watchpoint)
2621 if (b->type == bp_hardware_breakpoint)
2623 if (b->loc->address != bp_addr)
2625 if (overlay_debugging /* unmapped overlay section */
2626 && section_is_overlay (b->loc->section)
2627 && !section_is_mapped (b->loc->section))
2631 /* Is this a catchpoint of a load or unload? If so, did we
2632 get a load or unload of the specified library? If not,
2634 if ((b->type == bp_catch_load)
2635 #if defined(SOLIB_HAVE_LOAD_EVENT)
2636 && (!SOLIB_HAVE_LOAD_EVENT (PIDGET (inferior_ptid))
2637 || ((b->dll_pathname != NULL)
2638 && (strcmp (b->dll_pathname,
2639 SOLIB_LOADED_LIBRARY_PATHNAME (
2640 PIDGET (inferior_ptid)))
2646 if ((b->type == bp_catch_unload)
2647 #if defined(SOLIB_HAVE_UNLOAD_EVENT)
2648 && (!SOLIB_HAVE_UNLOAD_EVENT (PIDGET (inferior_ptid))
2649 || ((b->dll_pathname != NULL)
2650 && (strcmp (b->dll_pathname,
2651 SOLIB_UNLOADED_LIBRARY_PATHNAME (
2652 PIDGET (inferior_ptid)))
2658 if ((b->type == bp_catch_fork)
2659 && !inferior_has_forked (PIDGET (inferior_ptid),
2660 &b->forked_inferior_pid))
2663 if ((b->type == bp_catch_vfork)
2664 && !inferior_has_vforked (PIDGET (inferior_ptid),
2665 &b->forked_inferior_pid))
2668 if ((b->type == bp_catch_exec)
2669 && !inferior_has_execd (PIDGET (inferior_ptid), &b->exec_pathname))
2672 if (ep_is_exception_catchpoint (b) &&
2673 !(current_exception_event = target_get_current_exception_event ()))
2676 /* Come here if it's a watchpoint, or if the break address matches */
2678 bs = bpstat_alloc (b, bs); /* Alloc a bpstat to explain stop */
2680 /* Watchpoints may change this, if not found to have triggered. */
2684 if (b->type == bp_watchpoint ||
2685 b->type == bp_hardware_watchpoint)
2687 char *message = xstrprintf ("Error evaluating expression for watchpoint %d\n",
2689 struct cleanup *cleanups = make_cleanup (xfree, message);
2690 int e = catch_errors (watchpoint_check, bs, message,
2692 do_cleanups (cleanups);
2696 /* We've already printed what needs to be printed. */
2697 /* Actually this is superfluous, because by the time we
2698 call print_it_typical() the wp will be already deleted,
2699 and the function will return immediately. */
2700 bs->print_it = print_it_done;
2703 case WP_VALUE_CHANGED:
2707 case WP_VALUE_NOT_CHANGED:
2709 bs->print_it = print_it_noop;
2716 /* Error from catch_errors. */
2717 printf_filtered ("Watchpoint %d deleted.\n", b->number);
2718 if (b->related_breakpoint)
2719 b->related_breakpoint->disposition = disp_del_at_next_stop;
2720 b->disposition = disp_del_at_next_stop;
2721 /* We've already printed what needs to be printed. */
2722 bs->print_it = print_it_done;
2728 else if (b->type == bp_read_watchpoint ||
2729 b->type == bp_access_watchpoint)
2735 if (!target_stopped_data_address (¤t_target, &addr))
2737 for (v = b->val_chain; v; v = v->next)
2739 if (VALUE_LVAL (v) == lval_memory
2740 && ! VALUE_LAZY (v))
2742 struct type *vtype = check_typedef (value_type (v));
2744 if (v == b->val_chain
2745 || (TYPE_CODE (vtype) != TYPE_CODE_STRUCT
2746 && TYPE_CODE (vtype) != TYPE_CODE_ARRAY))
2750 vaddr = VALUE_ADDRESS (v) + value_offset (v);
2751 /* Exact match not required. Within range is
2753 if (addr >= vaddr &&
2754 addr < vaddr + TYPE_LENGTH (value_type (v)))
2761 char *message = xstrprintf ("Error evaluating expression for watchpoint %d\n",
2763 struct cleanup *cleanups = make_cleanup (xfree, message);
2764 int e = catch_errors (watchpoint_check, bs, message,
2766 do_cleanups (cleanups);
2770 /* We've already printed what needs to be printed. */
2771 bs->print_it = print_it_done;
2774 case WP_VALUE_CHANGED:
2775 if (b->type == bp_read_watchpoint)
2777 /* Don't stop: read watchpoints shouldn't fire if
2778 the value has changed. This is for targets
2779 which cannot set read-only watchpoints. */
2780 bs->print_it = print_it_noop;
2786 case WP_VALUE_NOT_CHANGED:
2793 /* Error from catch_errors. */
2794 printf_filtered ("Watchpoint %d deleted.\n", b->number);
2795 if (b->related_breakpoint)
2796 b->related_breakpoint->disposition = disp_del_at_next_stop;
2797 b->disposition = disp_del_at_next_stop;
2798 /* We've already printed what needs to be printed. */
2799 bs->print_it = print_it_done;
2803 else /* found == 0 */
2805 /* This is a case where some watchpoint(s) triggered,
2806 but not at the address of this watchpoint (FOUND
2807 was left zero). So don't print anything for this
2809 bs->print_it = print_it_noop;
2816 /* By definition, an encountered breakpoint is a triggered
2820 real_breakpoint = 1;
2823 if (frame_id_p (b->frame_id)
2824 && !frame_id_eq (b->frame_id, get_frame_id (get_current_frame ())))
2828 int value_is_zero = 0;
2832 /* Need to select the frame, with all that implies
2833 so that the conditions will have the right context. */
2834 select_frame (get_current_frame ());
2836 = catch_errors (breakpoint_cond_eval, (b->cond),
2837 "Error in testing breakpoint condition:\n",
2839 /* FIXME-someday, should give breakpoint # */
2842 if (b->cond && value_is_zero)
2845 /* Don't consider this a hit. */
2848 else if (b->thread != -1 && b->thread != thread_id)
2851 /* Don't consider this a hit. */
2854 else if (b->ignore_count > 0)
2857 annotate_ignore_count_change ();
2862 /* We will stop here */
2863 if (b->disposition == disp_disable)
2864 b->enable_state = bp_disabled;
2867 bs->commands = b->commands;
2869 (strcmp ("silent", bs->commands->line) == 0
2870 || (xdb_commands && strcmp ("Q", bs->commands->line) == 0)))
2872 bs->commands = bs->commands->next;
2875 bs->commands = copy_command_lines (bs->commands);
2878 /* Print nothing for this entry if we dont stop or if we dont print. */
2879 if (bs->stop == 0 || bs->print == 0)
2880 bs->print_it = print_it_noop;
2883 bs->next = NULL; /* Terminate the chain */
2884 bs = root_bs->next; /* Re-grab the head of the chain */
2886 /* The value of a hardware watchpoint hasn't changed, but the
2887 intermediate memory locations we are watching may have. */
2888 if (bs && !bs->stop &&
2889 (bs->breakpoint_at->type == bp_hardware_watchpoint ||
2890 bs->breakpoint_at->type == bp_read_watchpoint ||
2891 bs->breakpoint_at->type == bp_access_watchpoint))
2893 remove_breakpoints ();
2894 insert_breakpoints ();
2899 /* Tell what to do about this bpstat. */
2901 bpstat_what (bpstat bs)
2903 /* Classify each bpstat as one of the following. */
2906 /* This bpstat element has no effect on the main_action. */
2909 /* There was a watchpoint, stop but don't print. */
2912 /* There was a watchpoint, stop and print. */
2915 /* There was a breakpoint but we're not stopping. */
2918 /* There was a breakpoint, stop but don't print. */
2921 /* There was a breakpoint, stop and print. */
2924 /* We hit the longjmp breakpoint. */
2927 /* We hit the longjmp_resume breakpoint. */
2930 /* We hit the step_resume breakpoint. */
2933 /* We hit the through_sigtramp breakpoint. */
2936 /* We hit the shared library event breakpoint. */
2939 /* We caught a shared library event. */
2942 /* This is just used to count how many enums there are. */
2946 /* Here is the table which drives this routine. So that we can
2947 format it pretty, we define some abbreviations for the
2948 enum bpstat_what codes. */
2949 #define kc BPSTAT_WHAT_KEEP_CHECKING
2950 #define ss BPSTAT_WHAT_STOP_SILENT
2951 #define sn BPSTAT_WHAT_STOP_NOISY
2952 #define sgl BPSTAT_WHAT_SINGLE
2953 #define slr BPSTAT_WHAT_SET_LONGJMP_RESUME
2954 #define clr BPSTAT_WHAT_CLEAR_LONGJMP_RESUME
2955 #define clrs BPSTAT_WHAT_CLEAR_LONGJMP_RESUME_SINGLE
2956 #define sr BPSTAT_WHAT_STEP_RESUME
2957 #define ts BPSTAT_WHAT_THROUGH_SIGTRAMP
2958 #define shl BPSTAT_WHAT_CHECK_SHLIBS
2959 #define shlr BPSTAT_WHAT_CHECK_SHLIBS_RESUME_FROM_HOOK
2961 /* "Can't happen." Might want to print an error message.
2962 abort() is not out of the question, but chances are GDB is just
2963 a bit confused, not unusable. */
2964 #define err BPSTAT_WHAT_STOP_NOISY
2966 /* Given an old action and a class, come up with a new action. */
2967 /* One interesting property of this table is that wp_silent is the same
2968 as bp_silent and wp_noisy is the same as bp_noisy. That is because
2969 after stopping, the check for whether to step over a breakpoint
2970 (BPSTAT_WHAT_SINGLE type stuff) is handled in proceed() without
2971 reference to how we stopped. We retain separate wp_silent and
2972 bp_silent codes in case we want to change that someday.
2974 Another possibly interesting property of this table is that
2975 there's a partial ordering, priority-like, of the actions. Once
2976 you've decided that some action is appropriate, you'll never go
2977 back and decide something of a lower priority is better. The
2980 kc < clr sgl shl shlr slr sn sr ss ts
2981 sgl < clrs shl shlr slr sn sr ss ts
2982 slr < err shl shlr sn sr ss ts
2983 clr < clrs err shl shlr sn sr ss ts
2984 clrs < err shl shlr sn sr ss ts
2985 ss < shl shlr sn sr ts
2992 What I think this means is that we don't need a damned table
2993 here. If you just put the rows and columns in the right order,
2994 it'd look awfully regular. We could simply walk the bpstat list
2995 and choose the highest priority action we find, with a little
2996 logic to handle the 'err' cases, and the CLEAR_LONGJMP_RESUME/
2997 CLEAR_LONGJMP_RESUME_SINGLE distinction (which breakpoint.h says
2998 is messy anyway). */
3000 /* step_resume entries: a step resume breakpoint overrides another
3001 breakpoint of signal handling (see comment in wait_for_inferior
3002 at where we set the step_resume breakpoint). */
3003 /* We handle the through_sigtramp_breakpoint the same way; having both
3004 one of those and a step_resume_breakpoint is probably very rare (?). */
3006 static const enum bpstat_what_main_action
3007 table[(int) class_last][(int) BPSTAT_WHAT_LAST] =
3010 /* kc ss sn sgl slr clr clrs sr ts shl shlr
3013 {kc, ss, sn, sgl, slr, clr, clrs, sr, ts, shl, shlr},
3015 {ss, ss, sn, ss, ss, ss, ss, sr, ts, shl, shlr},
3017 {sn, sn, sn, sn, sn, sn, sn, sr, ts, shl, shlr},
3019 {sgl, ss, sn, sgl, slr, clrs, clrs, sr, ts, shl, shlr},
3021 {ss, ss, sn, ss, ss, ss, ss, sr, ts, shl, shlr},
3023 {sn, sn, sn, sn, sn, sn, sn, sr, ts, shl, shlr},
3025 {slr, ss, sn, slr, slr, err, err, sr, ts, shl, shlr},
3027 {clr, ss, sn, clrs, err, err, err, sr, ts, shl, shlr},
3029 {sr, sr, sr, sr, sr, sr, sr, sr, ts, shl, shlr},
3031 {ts, ts, ts, ts, ts, ts, ts, ts, ts, shl, shlr},
3033 {shl, shl, shl, shl, shl, shl, shl, shl, ts, shl, shlr},
3035 {shlr, shlr, shlr, shlr, shlr, shlr, shlr, shlr, ts, shlr, shlr}
3050 enum bpstat_what_main_action current_action = BPSTAT_WHAT_KEEP_CHECKING;
3051 struct bpstat_what retval;
3053 retval.call_dummy = 0;
3054 for (; bs != NULL; bs = bs->next)
3056 enum class bs_class = no_effect;
3057 if (bs->breakpoint_at == NULL)
3058 /* I suspect this can happen if it was a momentary breakpoint
3059 which has since been deleted. */
3061 switch (bs->breakpoint_at->type)
3067 case bp_hardware_breakpoint:
3073 bs_class = bp_noisy;
3075 bs_class = bp_silent;
3078 bs_class = bp_nostop;
3081 case bp_hardware_watchpoint:
3082 case bp_read_watchpoint:
3083 case bp_access_watchpoint:
3087 bs_class = wp_noisy;
3089 bs_class = wp_silent;
3092 /* There was a watchpoint, but we're not stopping.
3093 This requires no further action. */
3094 bs_class = no_effect;
3097 bs_class = long_jump;
3099 case bp_longjmp_resume:
3100 bs_class = long_resume;
3102 case bp_step_resume:
3105 bs_class = step_resume;
3108 /* It is for the wrong frame. */
3109 bs_class = bp_nostop;
3111 case bp_through_sigtramp:
3112 bs_class = through_sig;
3114 case bp_watchpoint_scope:
3115 bs_class = bp_nostop;
3117 case bp_shlib_event:
3118 bs_class = shlib_event;
3120 case bp_thread_event:
3121 case bp_overlay_event:
3122 bs_class = bp_nostop;
3125 case bp_catch_unload:
3126 /* Only if this catchpoint triggered should we cause the
3127 step-out-of-dld behaviour. Otherwise, we ignore this
3130 bs_class = catch_shlib_event;
3132 bs_class = no_effect;
3135 case bp_catch_vfork:
3140 bs_class = bp_noisy;
3142 bs_class = bp_silent;
3145 /* There was a catchpoint, but we're not stopping.
3146 This requires no further action. */
3147 bs_class = no_effect;
3149 case bp_catch_catch:
3150 if (!bs->stop || CURRENT_EXCEPTION_KIND != EX_EVENT_CATCH)
3151 bs_class = bp_nostop;
3153 bs_class = bs->print ? bp_noisy : bp_silent;
3155 case bp_catch_throw:
3156 if (!bs->stop || CURRENT_EXCEPTION_KIND != EX_EVENT_THROW)
3157 bs_class = bp_nostop;
3159 bs_class = bs->print ? bp_noisy : bp_silent;
3162 /* Make sure the action is stop (silent or noisy),
3163 so infrun.c pops the dummy frame. */
3164 bs_class = bp_silent;
3165 retval.call_dummy = 1;
3168 current_action = table[(int) bs_class][(int) current_action];
3170 retval.main_action = current_action;
3174 /* Nonzero if we should step constantly (e.g. watchpoints on machines
3175 without hardware support). This isn't related to a specific bpstat,
3176 just to things like whether watchpoints are set. */
3179 bpstat_should_step (void)
3181 struct breakpoint *b;
3183 if (breakpoint_enabled (b) && b->type == bp_watchpoint)
3188 /* Nonzero if there are enabled hardware watchpoints. */
3190 bpstat_have_active_hw_watchpoints (void)
3192 struct bp_location *bpt;
3193 ALL_BP_LOCATIONS (bpt)
3194 if (breakpoint_enabled (bpt->owner)
3196 && bpt->loc_type == bp_loc_hardware_watchpoint)
3202 /* Given a bpstat that records zero or more triggered eventpoints, this
3203 function returns another bpstat which contains only the catchpoints
3204 on that first list, if any. */
3206 bpstat_get_triggered_catchpoints (bpstat ep_list, bpstat *cp_list)
3208 struct bpstats root_bs[1];
3209 bpstat bs = root_bs;
3210 struct breakpoint *ep;
3213 bpstat_clear (cp_list);
3214 root_bs->next = NULL;
3216 for (; ep_list != NULL; ep_list = ep_list->next)
3218 /* Is this eventpoint a catchpoint? If not, ignore it. */
3219 ep = ep_list->breakpoint_at;
3222 if ((ep->type != bp_catch_load) &&
3223 (ep->type != bp_catch_unload) &&
3224 (ep->type != bp_catch_catch) &&
3225 (ep->type != bp_catch_throw))
3226 /* pai: (temp) ADD fork/vfork here!! */
3229 /* Yes; add it to the list. */
3230 bs = bpstat_alloc (ep, bs);
3235 #if defined(SOLIB_ADD)
3236 /* Also, for each triggered catchpoint, tag it with the name of
3237 the library that caused this trigger. (We copy the name now,
3238 because it's only guaranteed to be available NOW, when the
3239 catchpoint triggers. Clients who may wish to know the name
3240 later must get it from the catchpoint itself.) */
3241 if (ep->triggered_dll_pathname != NULL)
3242 xfree (ep->triggered_dll_pathname);
3243 if (ep->type == bp_catch_load)
3244 dll_pathname = SOLIB_LOADED_LIBRARY_PATHNAME (
3245 PIDGET (inferior_ptid));
3247 dll_pathname = SOLIB_UNLOADED_LIBRARY_PATHNAME (
3248 PIDGET (inferior_ptid));
3250 dll_pathname = NULL;
3254 ep->triggered_dll_pathname = (char *)
3255 xmalloc (strlen (dll_pathname) + 1);
3256 strcpy (ep->triggered_dll_pathname, dll_pathname);
3259 ep->triggered_dll_pathname = NULL;
3265 /* Print B to gdb_stdout. */
3267 print_one_breakpoint (struct breakpoint *b,
3268 CORE_ADDR *last_addr)
3270 struct command_line *l;
3272 struct ep_type_description
3277 static struct ep_type_description bptypes[] =
3279 {bp_none, "?deleted?"},
3280 {bp_breakpoint, "breakpoint"},
3281 {bp_hardware_breakpoint, "hw breakpoint"},
3282 {bp_until, "until"},
3283 {bp_finish, "finish"},
3284 {bp_watchpoint, "watchpoint"},
3285 {bp_hardware_watchpoint, "hw watchpoint"},
3286 {bp_read_watchpoint, "read watchpoint"},
3287 {bp_access_watchpoint, "acc watchpoint"},
3288 {bp_longjmp, "longjmp"},
3289 {bp_longjmp_resume, "longjmp resume"},
3290 {bp_step_resume, "step resume"},
3291 {bp_through_sigtramp, "sigtramp"},
3292 {bp_watchpoint_scope, "watchpoint scope"},
3293 {bp_call_dummy, "call dummy"},
3294 {bp_shlib_event, "shlib events"},
3295 {bp_thread_event, "thread events"},
3296 {bp_overlay_event, "overlay events"},
3297 {bp_catch_load, "catch load"},
3298 {bp_catch_unload, "catch unload"},
3299 {bp_catch_fork, "catch fork"},
3300 {bp_catch_vfork, "catch vfork"},
3301 {bp_catch_exec, "catch exec"},
3302 {bp_catch_catch, "catch catch"},
3303 {bp_catch_throw, "catch throw"}
3306 static char *bpdisps[] =
3307 {"del", "dstp", "dis", "keep"};
3308 static char bpenables[] = "nynny";
3309 char wrap_indent[80];
3310 struct ui_stream *stb = ui_out_stream_new (uiout);
3311 struct cleanup *old_chain = make_cleanup_ui_out_stream_delete (stb);
3312 struct cleanup *bkpt_chain;
3315 bkpt_chain = make_cleanup_ui_out_tuple_begin_end (uiout, "bkpt");
3319 ui_out_field_int (uiout, "number", b->number);
3323 if (((int) b->type > (sizeof (bptypes) / sizeof (bptypes[0])))
3324 || ((int) b->type != bptypes[(int) b->type].type))
3325 internal_error (__FILE__, __LINE__,
3326 "bptypes table does not describe type #%d.",
3328 ui_out_field_string (uiout, "type", bptypes[(int) b->type].description);
3332 ui_out_field_string (uiout, "disp", bpdisps[(int) b->disposition]);
3336 ui_out_field_fmt (uiout, "enabled", "%c", bpenables[(int) b->enable_state]);
3337 ui_out_spaces (uiout, 2);
3340 strcpy (wrap_indent, " ");
3343 if (TARGET_ADDR_BIT <= 32)
3344 strcat (wrap_indent, " ");
3346 strcat (wrap_indent, " ");
3349 if (b->ops != NULL && b->ops->print_one != NULL)
3350 b->ops->print_one (b, last_addr);
3355 internal_error (__FILE__, __LINE__,
3356 "print_one_breakpoint: bp_none encountered\n");
3360 case bp_hardware_watchpoint:
3361 case bp_read_watchpoint:
3362 case bp_access_watchpoint:
3363 /* Field 4, the address, is omitted (which makes the columns
3364 not line up too nicely with the headers, but the effect
3365 is relatively readable). */
3367 ui_out_field_skip (uiout, "addr");
3369 print_expression (b->exp, stb->stream);
3370 ui_out_field_stream (uiout, "what", stb);
3374 case bp_catch_unload:
3375 /* Field 4, the address, is omitted (which makes the columns
3376 not line up too nicely with the headers, but the effect
3377 is relatively readable). */
3379 ui_out_field_skip (uiout, "addr");
3381 if (b->dll_pathname == NULL)
3383 ui_out_field_string (uiout, "what", "<any library>");
3384 ui_out_spaces (uiout, 1);
3388 ui_out_text (uiout, "library \"");
3389 ui_out_field_string (uiout, "what", b->dll_pathname);
3390 ui_out_text (uiout, "\" ");
3395 case bp_catch_vfork:
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->forked_inferior_pid != 0)
3404 ui_out_text (uiout, "process ");
3405 ui_out_field_int (uiout, "what", b->forked_inferior_pid);
3406 ui_out_spaces (uiout, 1);
3410 /* Field 4, the address, is omitted (which makes the columns
3411 not line up too nicely with the headers, but the effect
3412 is relatively readable). */
3414 ui_out_field_skip (uiout, "addr");
3416 if (b->exec_pathname != NULL)
3418 ui_out_text (uiout, "program \"");
3419 ui_out_field_string (uiout, "what", b->exec_pathname);
3420 ui_out_text (uiout, "\" ");
3424 case bp_catch_catch:
3425 /* Field 4, the address, is omitted (which makes the columns
3426 not line up too nicely with the headers, but the effect
3427 is relatively readable). */
3429 ui_out_field_skip (uiout, "addr");
3431 ui_out_field_string (uiout, "what", "exception catch");
3432 ui_out_spaces (uiout, 1);
3435 case bp_catch_throw:
3436 /* Field 4, the address, is omitted (which makes the columns
3437 not line up too nicely with the headers, but the effect
3438 is relatively readable). */
3440 ui_out_field_skip (uiout, "addr");
3442 ui_out_field_string (uiout, "what", "exception throw");
3443 ui_out_spaces (uiout, 1);
3447 case bp_hardware_breakpoint:
3451 case bp_longjmp_resume:
3452 case bp_step_resume:
3453 case bp_through_sigtramp:
3454 case bp_watchpoint_scope:
3456 case bp_shlib_event:
3457 case bp_thread_event:
3458 case bp_overlay_event:
3463 ui_out_field_string (uiout, "addr", "<PENDING>");
3465 ui_out_field_core_addr (uiout, "addr", b->loc->address);
3468 *last_addr = b->loc->address;
3471 sym = find_pc_sect_function (b->loc->address, b->loc->section);
3474 ui_out_text (uiout, "in ");
3475 ui_out_field_string (uiout, "func",
3476 SYMBOL_PRINT_NAME (sym));
3477 ui_out_wrap_hint (uiout, wrap_indent);
3478 ui_out_text (uiout, " at ");
3480 ui_out_field_string (uiout, "file", b->source_file);
3481 ui_out_text (uiout, ":");
3482 ui_out_field_int (uiout, "line", b->line_number);
3484 else if (b->pending)
3486 ui_out_field_string (uiout, "pending", b->addr_string);
3490 print_address_symbolic (b->loc->address, stb->stream, demangle, "");
3491 ui_out_field_stream (uiout, "at", stb);
3496 if (b->thread != -1)
3498 /* FIXME: This seems to be redundant and lost here; see the
3499 "stop only in" line a little further down. */
3500 ui_out_text (uiout, " thread ");
3501 ui_out_field_int (uiout, "thread", b->thread);
3504 ui_out_text (uiout, "\n");
3506 if (frame_id_p (b->frame_id))
3509 ui_out_text (uiout, "\tstop only in stack frame at ");
3510 /* FIXME: cagney/2002-12-01: Shouldn't be poeking around inside
3512 ui_out_field_core_addr (uiout, "frame", b->frame_id.stack_addr);
3513 ui_out_text (uiout, "\n");
3519 ui_out_text (uiout, "\tstop only if ");
3520 print_expression (b->cond, stb->stream);
3521 ui_out_field_stream (uiout, "cond", stb);
3522 ui_out_text (uiout, "\n");
3525 if (b->pending && b->cond_string)
3528 ui_out_text (uiout, "\tstop only if ");
3529 ui_out_field_string (uiout, "cond", b->cond_string);
3530 ui_out_text (uiout, "\n");
3533 if (b->thread != -1)
3535 /* FIXME should make an annotation for this */
3536 ui_out_text (uiout, "\tstop only in thread ");
3537 ui_out_field_int (uiout, "thread", b->thread);
3538 ui_out_text (uiout, "\n");
3541 if (show_breakpoint_hit_counts && b->hit_count)
3543 /* FIXME should make an annotation for this */
3544 if (ep_is_catchpoint (b))
3545 ui_out_text (uiout, "\tcatchpoint");
3547 ui_out_text (uiout, "\tbreakpoint");
3548 ui_out_text (uiout, " already hit ");
3549 ui_out_field_int (uiout, "times", b->hit_count);
3550 if (b->hit_count == 1)
3551 ui_out_text (uiout, " time\n");
3553 ui_out_text (uiout, " times\n");
3556 /* Output the count also if it is zero, but only if this is
3557 mi. FIXME: Should have a better test for this. */
3558 if (ui_out_is_mi_like_p (uiout))
3559 if (show_breakpoint_hit_counts && b->hit_count == 0)
3560 ui_out_field_int (uiout, "times", b->hit_count);
3562 if (b->ignore_count)
3565 ui_out_text (uiout, "\tignore next ");
3566 ui_out_field_int (uiout, "ignore", b->ignore_count);
3567 ui_out_text (uiout, " hits\n");
3570 if ((l = b->commands))
3572 struct cleanup *script_chain;
3575 script_chain = make_cleanup_ui_out_tuple_begin_end (uiout, "script");
3576 print_command_lines (uiout, l, 4);
3577 do_cleanups (script_chain);
3579 do_cleanups (bkpt_chain);
3580 do_cleanups (old_chain);
3583 struct captured_breakpoint_query_args
3589 do_captured_breakpoint_query (struct ui_out *uiout, void *data)
3591 struct captured_breakpoint_query_args *args = data;
3592 struct breakpoint *b;
3593 CORE_ADDR dummy_addr = 0;
3596 if (args->bnum == b->number)
3598 print_one_breakpoint (b, &dummy_addr);
3606 gdb_breakpoint_query (struct ui_out *uiout, int bnum)
3608 struct captured_breakpoint_query_args args;
3610 /* For the moment we don't trust print_one_breakpoint() to not throw
3612 return catch_exceptions (uiout, do_captured_breakpoint_query, &args,
3613 NULL, RETURN_MASK_ALL);
3616 /* Return non-zero if B is user settable (breakpoints, watchpoints,
3617 catchpoints, et.al.). */
3620 user_settable_breakpoint (const struct breakpoint *b)
3622 return (b->type == bp_breakpoint
3623 || b->type == bp_catch_load
3624 || b->type == bp_catch_unload
3625 || b->type == bp_catch_fork
3626 || b->type == bp_catch_vfork
3627 || b->type == bp_catch_exec
3628 || b->type == bp_catch_catch
3629 || b->type == bp_catch_throw
3630 || b->type == bp_hardware_breakpoint
3631 || b->type == bp_watchpoint
3632 || b->type == bp_read_watchpoint
3633 || b->type == bp_access_watchpoint
3634 || b->type == bp_hardware_watchpoint);
3637 /* Print information on user settable breakpoint (watchpoint, etc)
3638 number BNUM. If BNUM is -1 print all user settable breakpoints.
3639 If ALLFLAG is non-zero, include non- user settable breakpoints. */
3642 breakpoint_1 (int bnum, int allflag)
3644 struct breakpoint *b;
3645 CORE_ADDR last_addr = (CORE_ADDR) -1;
3646 int nr_printable_breakpoints;
3647 struct cleanup *bkpttbl_chain;
3649 /* Compute the number of rows in the table. */
3650 nr_printable_breakpoints = 0;
3653 || bnum == b->number)
3655 if (allflag || user_settable_breakpoint (b))
3656 nr_printable_breakpoints++;
3661 = make_cleanup_ui_out_table_begin_end (uiout, 6, nr_printable_breakpoints,
3665 = make_cleanup_ui_out_table_begin_end (uiout, 5, nr_printable_breakpoints,
3668 if (nr_printable_breakpoints > 0)
3669 annotate_breakpoints_headers ();
3670 if (nr_printable_breakpoints > 0)
3672 ui_out_table_header (uiout, 3, ui_left, "number", "Num"); /* 1 */
3673 if (nr_printable_breakpoints > 0)
3675 ui_out_table_header (uiout, 14, ui_left, "type", "Type"); /* 2 */
3676 if (nr_printable_breakpoints > 0)
3678 ui_out_table_header (uiout, 4, ui_left, "disp", "Disp"); /* 3 */
3679 if (nr_printable_breakpoints > 0)
3681 ui_out_table_header (uiout, 3, ui_left, "enabled", "Enb"); /* 4 */
3684 if (nr_printable_breakpoints > 0)
3686 if (TARGET_ADDR_BIT <= 32)
3687 ui_out_table_header (uiout, 10, ui_left, "addr", "Address");/* 5 */
3689 ui_out_table_header (uiout, 18, ui_left, "addr", "Address");/* 5 */
3691 if (nr_printable_breakpoints > 0)
3693 ui_out_table_header (uiout, 40, ui_noalign, "what", "What"); /* 6 */
3694 ui_out_table_body (uiout);
3695 if (nr_printable_breakpoints > 0)
3696 annotate_breakpoints_table ();
3700 || bnum == b->number)
3702 /* We only print out user settable breakpoints unless the
3704 if (allflag || user_settable_breakpoint (b))
3705 print_one_breakpoint (b, &last_addr);
3708 do_cleanups (bkpttbl_chain);
3710 if (nr_printable_breakpoints == 0)
3713 ui_out_message (uiout, 0, "No breakpoints or watchpoints.\n");
3715 ui_out_message (uiout, 0, "No breakpoint or watchpoint number %d.\n",
3720 /* Compare against (CORE_ADDR)-1 in case some compiler decides
3721 that a comparison of an unsigned with -1 is always false. */
3722 if (last_addr != (CORE_ADDR) -1)
3723 set_next_address (last_addr);
3726 /* FIXME? Should this be moved up so that it is only called when
3727 there have been breakpoints? */
3728 annotate_breakpoints_table_end ();
3732 breakpoints_info (char *bnum_exp, int from_tty)
3737 bnum = parse_and_eval_long (bnum_exp);
3739 breakpoint_1 (bnum, 0);
3743 maintenance_info_breakpoints (char *bnum_exp, int from_tty)
3748 bnum = parse_and_eval_long (bnum_exp);
3750 breakpoint_1 (bnum, 1);
3753 /* Print a message describing any breakpoints set at PC. */
3756 describe_other_breakpoints (CORE_ADDR pc, asection *section)
3759 struct breakpoint *b;
3762 if (b->loc->address == pc) /* address match / overlay match */
3763 if (!b->pending && (!overlay_debugging || b->loc->section == section))
3767 printf_filtered ("Note: breakpoint%s ", (others > 1) ? "s" : "");
3769 if (b->loc->address == pc) /* address match / overlay match */
3770 if (!b->pending && (!overlay_debugging || b->loc->section == section))
3773 printf_filtered ("%d%s%s ",
3775 ((b->enable_state == bp_disabled ||
3776 b->enable_state == bp_shlib_disabled ||
3777 b->enable_state == bp_call_disabled)
3779 : b->enable_state == bp_permanent
3783 : ((others == 1) ? " and" : ""));
3785 printf_filtered ("also set at pc ");
3786 print_address_numeric (pc, 1, gdb_stdout);
3787 printf_filtered (".\n");
3791 /* Set the default place to put a breakpoint
3792 for the `break' command with no arguments. */
3795 set_default_breakpoint (int valid, CORE_ADDR addr, struct symtab *symtab,
3798 default_breakpoint_valid = valid;
3799 default_breakpoint_address = addr;
3800 default_breakpoint_symtab = symtab;
3801 default_breakpoint_line = line;
3804 /* Return true iff it is meaningful to use the address member of
3805 BPT. For some breakpoint types, the address member is irrelevant
3806 and it makes no sense to attempt to compare it to other addresses
3807 (or use it for any other purpose either).
3809 More specifically, each of the following breakpoint types will always
3810 have a zero valued address and we don't want check_duplicates() to mark
3811 breakpoints of any of these types to be a duplicate of an actual
3812 breakpoint at address zero:
3815 bp_hardware_watchpoint
3817 bp_access_watchpoint
3824 breakpoint_address_is_meaningful (struct breakpoint *bpt)
3826 enum bptype type = bpt->type;
3828 return (type != bp_watchpoint
3829 && type != bp_hardware_watchpoint
3830 && type != bp_read_watchpoint
3831 && type != bp_access_watchpoint
3832 && type != bp_catch_exec
3833 && type != bp_longjmp_resume
3834 && type != bp_catch_fork
3835 && type != bp_catch_vfork);
3838 /* Rescan breakpoints at the same address and section as BPT,
3839 marking the first one as "first" and any others as "duplicates".
3840 This is so that the bpt instruction is only inserted once.
3841 If we have a permanent breakpoint at the same place as BPT, make
3842 that one the official one, and the rest as duplicates. */
3845 check_duplicates (struct breakpoint *bpt)
3847 struct bp_location *b;
3849 struct bp_location *perm_bp = 0;
3850 CORE_ADDR address = bpt->loc->address;
3851 asection *section = bpt->loc->section;
3853 if (! breakpoint_address_is_meaningful (bpt))
3856 ALL_BP_LOCATIONS (b)
3857 if (b->owner->enable_state != bp_disabled
3858 && b->owner->enable_state != bp_shlib_disabled
3859 && !b->owner->pending
3860 && b->owner->enable_state != bp_call_disabled
3861 && b->address == address /* address / overlay match */
3862 && (!overlay_debugging || b->section == section)
3863 && breakpoint_address_is_meaningful (b->owner))
3865 /* Have we found a permanent breakpoint? */
3866 if (b->owner->enable_state == bp_permanent)
3873 b->duplicate = count > 1;
3876 /* If we found a permanent breakpoint at this address, go over the
3877 list again and declare all the other breakpoints there to be the
3881 perm_bp->duplicate = 0;
3883 /* Permanent breakpoint should always be inserted. */
3884 if (! perm_bp->inserted)
3885 internal_error (__FILE__, __LINE__,
3886 "allegedly permanent breakpoint is not "
3887 "actually inserted");
3889 ALL_BP_LOCATIONS (b)
3892 if (b->owner->enable_state != bp_disabled
3893 && b->owner->enable_state != bp_shlib_disabled
3894 && !b->owner->pending
3895 && b->owner->enable_state != bp_call_disabled
3896 && b->address == address /* address / overlay match */
3897 && (!overlay_debugging || b->section == section)
3898 && breakpoint_address_is_meaningful (b->owner))
3901 internal_error (__FILE__, __LINE__,
3902 "another breakpoint was inserted on top of "
3903 "a permanent breakpoint");
3912 breakpoint_adjustment_warning (CORE_ADDR from_addr, CORE_ADDR to_addr,
3913 int bnum, int have_bnum)
3918 strcpy (astr1, hex_string_custom ((unsigned long) from_addr, 8));
3919 strcpy (astr2, hex_string_custom ((unsigned long) to_addr, 8));
3921 warning ("Breakpoint %d address previously adjusted from %s to %s.",
3922 bnum, astr1, astr2);
3924 warning ("Breakpoint address adjusted from %s to %s.", astr1, astr2);
3927 /* Adjust a breakpoint's address to account for architectural constraints
3928 on breakpoint placement. Return the adjusted address. Note: Very
3929 few targets require this kind of adjustment. For most targets,
3930 this function is simply the identity function. */
3933 adjust_breakpoint_address (CORE_ADDR bpaddr, enum bptype bptype)
3935 if (!gdbarch_adjust_breakpoint_address_p (current_gdbarch))
3937 /* Very few targets need any kind of breakpoint adjustment. */
3940 else if (bptype == bp_watchpoint
3941 || bptype == bp_hardware_watchpoint
3942 || bptype == bp_read_watchpoint
3943 || bptype == bp_access_watchpoint
3944 || bptype == bp_catch_fork
3945 || bptype == bp_catch_vfork
3946 || bptype == bp_catch_exec)
3948 /* Watchpoints and the various bp_catch_* eventpoints should not
3949 have their addresses modified. */
3954 CORE_ADDR adjusted_bpaddr;
3956 /* Some targets have architectural constraints on the placement
3957 of breakpoint instructions. Obtain the adjusted address. */
3958 adjusted_bpaddr = gdbarch_adjust_breakpoint_address (current_gdbarch,
3961 /* An adjusted breakpoint address can significantly alter
3962 a user's expectations. Print a warning if an adjustment
3964 if (adjusted_bpaddr != bpaddr)
3965 breakpoint_adjustment_warning (bpaddr, adjusted_bpaddr, 0, 0);
3967 return adjusted_bpaddr;
3971 /* Allocate a struct bp_location. */
3973 static struct bp_location *
3974 allocate_bp_location (struct breakpoint *bpt, enum bptype bp_type)
3976 struct bp_location *loc, *loc_p;
3978 loc = xmalloc (sizeof (struct bp_location));
3979 memset (loc, 0, sizeof (*loc));
3989 case bp_longjmp_resume:
3990 case bp_step_resume:
3991 case bp_through_sigtramp:
3992 case bp_watchpoint_scope:
3994 case bp_shlib_event:
3995 case bp_thread_event:
3996 case bp_overlay_event:
3998 case bp_catch_unload:
3999 loc->loc_type = bp_loc_software_breakpoint;
4001 case bp_hardware_breakpoint:
4002 loc->loc_type = bp_loc_hardware_breakpoint;
4004 case bp_hardware_watchpoint:
4005 case bp_read_watchpoint:
4006 case bp_access_watchpoint:
4007 loc->loc_type = bp_loc_hardware_watchpoint;
4011 case bp_catch_vfork:
4013 case bp_catch_catch:
4014 case bp_catch_throw:
4015 loc->loc_type = bp_loc_other;
4018 internal_error (__FILE__, __LINE__, "unknown breakpoint type");
4021 /* Add this breakpoint to the end of the chain. */
4023 loc_p = bp_location_chain;
4025 bp_location_chain = loc;
4029 loc_p = loc_p->next;
4036 /* set_raw_breakpoint() is a low level routine for allocating and
4037 partially initializing a breakpoint of type BPTYPE. The newly
4038 created breakpoint's address, section, source file name, and line
4039 number are provided by SAL. The newly created and partially
4040 initialized breakpoint is added to the breakpoint chain and
4041 is also returned as the value of this function.
4043 It is expected that the caller will complete the initialization of
4044 the newly created breakpoint struct as well as output any status
4045 information regarding the creation of a new breakpoint. In
4046 particular, set_raw_breakpoint() does NOT set the breakpoint
4047 number! Care should be taken to not allow an error() to occur
4048 prior to completing the initialization of the breakpoint. If this
4049 should happen, a bogus breakpoint will be left on the chain. */
4052 set_raw_breakpoint (struct symtab_and_line sal, enum bptype bptype)
4054 struct breakpoint *b, *b1;
4056 b = (struct breakpoint *) xmalloc (sizeof (struct breakpoint));
4057 memset (b, 0, sizeof (*b));
4058 b->loc = allocate_bp_location (b, bptype);
4059 b->loc->requested_address = sal.pc;
4060 b->loc->address = adjust_breakpoint_address (b->loc->requested_address,
4062 if (sal.symtab == NULL)
4063 b->source_file = NULL;
4065 b->source_file = savestring (sal.symtab->filename,
4066 strlen (sal.symtab->filename));
4067 b->loc->section = sal.section;
4069 b->language = current_language->la_language;
4070 b->input_radix = input_radix;
4072 b->line_number = sal.line;
4073 b->enable_state = bp_enabled;
4076 b->ignore_count = 0;
4078 b->frame_id = null_frame_id;
4079 b->dll_pathname = NULL;
4080 b->triggered_dll_pathname = NULL;
4081 b->forked_inferior_pid = 0;
4082 b->exec_pathname = NULL;
4086 /* Add this breakpoint to the end of the chain
4087 so that a list of breakpoints will come out in order
4088 of increasing numbers. */
4090 b1 = breakpoint_chain;
4092 breakpoint_chain = b;
4100 check_duplicates (b);
4101 breakpoints_changed ();
4107 /* Note that the breakpoint object B describes a permanent breakpoint
4108 instruction, hard-wired into the inferior's code. */
4110 make_breakpoint_permanent (struct breakpoint *b)
4112 b->enable_state = bp_permanent;
4114 /* By definition, permanent breakpoints are already present in the code. */
4115 b->loc->inserted = 1;
4118 static struct breakpoint *
4119 create_internal_breakpoint (CORE_ADDR address, enum bptype type)
4121 static int internal_breakpoint_number = -1;
4122 struct symtab_and_line sal;
4123 struct breakpoint *b;
4125 init_sal (&sal); /* initialize to zeroes */
4128 sal.section = find_pc_overlay (sal.pc);
4130 b = set_raw_breakpoint (sal, type);
4131 b->number = internal_breakpoint_number--;
4132 b->disposition = disp_donttouch;
4139 create_longjmp_breakpoint (char *func_name)
4141 struct breakpoint *b;
4142 struct minimal_symbol *m;
4144 if (func_name == NULL)
4145 b = create_internal_breakpoint (0, bp_longjmp_resume);
4148 if ((m = lookup_minimal_symbol_text (func_name, NULL)) == NULL)
4151 b = create_internal_breakpoint (SYMBOL_VALUE_ADDRESS (m), bp_longjmp);
4154 b->enable_state = bp_disabled;
4157 b->addr_string = xstrdup (func_name);
4160 /* Call this routine when stepping and nexting to enable a breakpoint
4161 if we do a longjmp(). When we hit that breakpoint, call
4162 set_longjmp_resume_breakpoint() to figure out where we are going. */
4165 enable_longjmp_breakpoint (void)
4167 struct breakpoint *b;
4170 if (b->type == bp_longjmp)
4172 b->enable_state = bp_enabled;
4173 check_duplicates (b);
4178 disable_longjmp_breakpoint (void)
4180 struct breakpoint *b;
4183 if (b->type == bp_longjmp
4184 || b->type == bp_longjmp_resume)
4186 b->enable_state = bp_disabled;
4187 check_duplicates (b);
4192 create_overlay_event_breakpoint (char *func_name)
4194 struct breakpoint *b;
4195 struct minimal_symbol *m;
4197 if ((m = lookup_minimal_symbol_text (func_name, NULL)) == NULL)
4200 b = create_internal_breakpoint (SYMBOL_VALUE_ADDRESS (m),
4202 b->addr_string = xstrdup (func_name);
4204 if (overlay_debugging == ovly_auto)
4206 b->enable_state = bp_enabled;
4207 overlay_events_enabled = 1;
4211 b->enable_state = bp_disabled;
4212 overlay_events_enabled = 0;
4217 enable_overlay_breakpoints (void)
4219 struct breakpoint *b;
4222 if (b->type == bp_overlay_event)
4224 b->enable_state = bp_enabled;
4225 check_duplicates (b);
4226 overlay_events_enabled = 1;
4231 disable_overlay_breakpoints (void)
4233 struct breakpoint *b;
4236 if (b->type == bp_overlay_event)
4238 b->enable_state = bp_disabled;
4239 check_duplicates (b);
4240 overlay_events_enabled = 0;
4245 create_thread_event_breakpoint (CORE_ADDR address)
4247 struct breakpoint *b;
4249 b = create_internal_breakpoint (address, bp_thread_event);
4251 b->enable_state = bp_enabled;
4252 /* addr_string has to be used or breakpoint_re_set will delete me. */
4253 b->addr_string = xstrprintf ("*0x%s", paddr (b->loc->address));
4259 remove_thread_event_breakpoints (void)
4261 struct breakpoint *b, *temp;
4263 ALL_BREAKPOINTS_SAFE (b, temp)
4264 if (b->type == bp_thread_event)
4265 delete_breakpoint (b);
4268 struct captured_parse_breakpoint_args
4271 struct symtabs_and_lines *sals_p;
4272 char ***addr_string_p;
4276 struct lang_and_radix
4282 /* Cleanup helper routine to restore the current language and
4285 do_restore_lang_radix_cleanup (void *old)
4287 struct lang_and_radix *p = old;
4288 set_language (p->lang);
4289 input_radix = p->radix;
4292 /* Try and resolve a pending breakpoint. */
4294 resolve_pending_breakpoint (struct breakpoint *b)
4296 /* Try and reparse the breakpoint in case the shared library
4298 struct symtabs_and_lines sals;
4299 struct symtab_and_line pending_sal;
4300 char **cond_string = (char **) NULL;
4301 char *copy_arg = b->addr_string;
4306 struct ui_file *old_gdb_stderr;
4307 struct lang_and_radix old_lr;
4308 struct cleanup *old_chain;
4310 /* Set language, input-radix, then reissue breakpoint command.
4311 Ensure the language and input-radix are restored afterwards. */
4312 old_lr.lang = current_language->la_language;
4313 old_lr.radix = input_radix;
4314 old_chain = make_cleanup (do_restore_lang_radix_cleanup, &old_lr);
4316 set_language (b->language);
4317 input_radix = b->input_radix;
4318 rc = break_command_1 (b->addr_string, b->flag, b->from_tty, b);
4320 if (rc == GDB_RC_OK)
4321 /* Pending breakpoint has been resolved. */
4322 printf_filtered ("Pending breakpoint \"%s\" resolved\n", b->addr_string);
4324 do_cleanups (old_chain);
4330 remove_solib_event_breakpoints (void)
4332 struct breakpoint *b, *temp;
4334 ALL_BREAKPOINTS_SAFE (b, temp)
4335 if (b->type == bp_shlib_event)
4336 delete_breakpoint (b);
4340 create_solib_event_breakpoint (CORE_ADDR address)
4342 struct breakpoint *b;
4344 b = create_internal_breakpoint (address, bp_shlib_event);
4348 /* Disable any breakpoints that are on code in shared libraries. Only
4349 apply to enabled breakpoints, disabled ones can just stay disabled. */
4352 disable_breakpoints_in_shlibs (int silent)
4354 struct breakpoint *b;
4355 int disabled_shlib_breaks = 0;
4357 /* See also: insert_breakpoints, under DISABLE_UNSETTABLE_BREAK. */
4360 #if defined (PC_SOLIB)
4361 if (((b->type == bp_breakpoint) ||
4362 (b->type == bp_hardware_breakpoint)) &&
4363 breakpoint_enabled (b) &&
4364 !b->loc->duplicate &&
4365 PC_SOLIB (b->loc->address))
4367 b->enable_state = bp_shlib_disabled;
4370 if (!disabled_shlib_breaks)
4372 target_terminal_ours_for_output ();
4373 warning ("Temporarily disabling shared library breakpoints:");
4375 disabled_shlib_breaks = 1;
4376 warning ("breakpoint #%d ", b->number);
4383 /* Disable any breakpoints that are in in an unloaded shared library. Only
4384 apply to enabled breakpoints, disabled ones can just stay disabled. */
4387 disable_breakpoints_in_unloaded_shlib (struct so_list *solib)
4389 struct breakpoint *b;
4390 int disabled_shlib_breaks = 0;
4392 #if defined (PC_SOLIB)
4393 /* See also: insert_breakpoints, under DISABLE_UNSETTABLE_BREAK. */
4396 if ((b->loc->loc_type == bp_loc_hardware_breakpoint
4397 || b->loc->loc_type == bp_loc_software_breakpoint)
4398 && breakpoint_enabled (b)
4399 && !b->loc->duplicate)
4401 char *so_name = PC_SOLIB (b->loc->address);
4403 && !strcmp (so_name, solib->so_name))
4405 b->enable_state = bp_shlib_disabled;
4406 /* At this point, we cannot rely on remove_breakpoint
4407 succeeding so we must mark the breakpoint as not inserted
4408 to prevent future errors occurring in remove_breakpoints. */
4409 b->loc->inserted = 0;
4410 if (!disabled_shlib_breaks)
4412 target_terminal_ours_for_output ();
4413 warning ("Temporarily disabling breakpoints for unloaded shared library \"%s\"",
4416 disabled_shlib_breaks = 1;
4423 /* Try to reenable any breakpoints in shared libraries. */
4425 re_enable_breakpoints_in_shlibs (void)
4427 struct breakpoint *b, *tmp;
4429 ALL_BREAKPOINTS_SAFE (b, tmp)
4431 if (b->enable_state == bp_shlib_disabled)
4435 /* Do not reenable the breakpoint if the shared library
4436 is still not mapped in. */
4437 lib = PC_SOLIB (b->loc->address);
4438 if (lib != NULL && target_read_memory (b->loc->address, buf, 1) == 0)
4439 b->enable_state = bp_enabled;
4441 else if (b->pending && (b->enable_state == bp_enabled))
4443 if (resolve_pending_breakpoint (b) == GDB_RC_OK)
4444 delete_breakpoint (b);
4452 solib_load_unload_1 (char *hookname, int tempflag, char *dll_pathname,
4453 char *cond_string, enum bptype bp_kind)
4455 struct breakpoint *b;
4456 struct symtabs_and_lines sals;
4457 struct cleanup *old_chain;
4458 struct cleanup *canonical_strings_chain = NULL;
4459 char *addr_start = hookname;
4460 char *addr_end = NULL;
4461 char **canonical = (char **) NULL;
4462 int thread = -1; /* All threads. */
4464 /* Set a breakpoint on the specified hook. */
4465 sals = decode_line_1 (&hookname, 1, (struct symtab *) NULL, 0, &canonical, NULL);
4466 addr_end = hookname;
4468 if (sals.nelts == 0)
4470 warning ("Unable to set a breakpoint on dynamic linker callback.");
4471 warning ("Suggest linking with /opt/langtools/lib/end.o.");
4472 warning ("GDB will be unable to track shl_load/shl_unload calls");
4475 if (sals.nelts != 1)
4477 warning ("Unable to set unique breakpoint on dynamic linker callback.");
4478 warning ("GDB will be unable to track shl_load/shl_unload calls");
4482 /* Make sure that all storage allocated in decode_line_1 gets freed
4483 in case the following errors out. */
4484 old_chain = make_cleanup (xfree, sals.sals);
4485 if (canonical != (char **) NULL)
4487 make_cleanup (xfree, canonical);
4488 canonical_strings_chain = make_cleanup (null_cleanup, 0);
4489 if (canonical[0] != NULL)
4490 make_cleanup (xfree, canonical[0]);
4493 resolve_sal_pc (&sals.sals[0]);
4495 /* Remove the canonical strings from the cleanup, they are needed below. */
4496 if (canonical != (char **) NULL)
4497 discard_cleanups (canonical_strings_chain);
4499 b = set_raw_breakpoint (sals.sals[0], bp_kind);
4500 set_breakpoint_count (breakpoint_count + 1);
4501 b->number = breakpoint_count;
4503 b->cond_string = (cond_string == NULL) ?
4504 NULL : savestring (cond_string, strlen (cond_string));
4507 if (canonical != (char **) NULL && canonical[0] != NULL)
4508 b->addr_string = canonical[0];
4509 else if (addr_start)
4510 b->addr_string = savestring (addr_start, addr_end - addr_start);
4512 b->enable_state = bp_enabled;
4513 b->disposition = tempflag ? disp_del : disp_donttouch;
4515 if (dll_pathname == NULL)
4516 b->dll_pathname = NULL;
4519 b->dll_pathname = (char *) xmalloc (strlen (dll_pathname) + 1);
4520 strcpy (b->dll_pathname, dll_pathname);
4524 do_cleanups (old_chain);
4528 create_solib_load_event_breakpoint (char *hookname, int tempflag,
4529 char *dll_pathname, char *cond_string)
4531 solib_load_unload_1 (hookname, tempflag, dll_pathname,
4532 cond_string, bp_catch_load);
4536 create_solib_unload_event_breakpoint (char *hookname, int tempflag,
4537 char *dll_pathname, char *cond_string)
4539 solib_load_unload_1 (hookname,tempflag, dll_pathname,
4540 cond_string, bp_catch_unload);
4544 create_fork_vfork_event_catchpoint (int tempflag, char *cond_string,
4545 enum bptype bp_kind)
4547 struct symtab_and_line sal;
4548 struct breakpoint *b;
4549 int thread = -1; /* All threads. */
4556 b = set_raw_breakpoint (sal, bp_kind);
4557 set_breakpoint_count (breakpoint_count + 1);
4558 b->number = breakpoint_count;
4560 b->cond_string = (cond_string == NULL) ?
4561 NULL : savestring (cond_string, strlen (cond_string));
4563 b->addr_string = NULL;
4564 b->enable_state = bp_enabled;
4565 b->disposition = tempflag ? disp_del : disp_donttouch;
4566 b->forked_inferior_pid = 0;
4572 create_fork_event_catchpoint (int tempflag, char *cond_string)
4574 create_fork_vfork_event_catchpoint (tempflag, cond_string, bp_catch_fork);
4578 create_vfork_event_catchpoint (int tempflag, char *cond_string)
4580 create_fork_vfork_event_catchpoint (tempflag, cond_string, bp_catch_vfork);
4584 create_exec_event_catchpoint (int tempflag, char *cond_string)
4586 struct symtab_and_line sal;
4587 struct breakpoint *b;
4588 int thread = -1; /* All threads. */
4595 b = set_raw_breakpoint (sal, bp_catch_exec);
4596 set_breakpoint_count (breakpoint_count + 1);
4597 b->number = breakpoint_count;
4599 b->cond_string = (cond_string == NULL) ?
4600 NULL : savestring (cond_string, strlen (cond_string));
4602 b->addr_string = NULL;
4603 b->enable_state = bp_enabled;
4604 b->disposition = tempflag ? disp_del : disp_donttouch;
4610 hw_breakpoint_used_count (void)
4612 struct breakpoint *b;
4617 if (b->type == bp_hardware_breakpoint && b->enable_state == bp_enabled)
4625 hw_watchpoint_used_count (enum bptype type, int *other_type_used)
4627 struct breakpoint *b;
4630 *other_type_used = 0;
4633 if (breakpoint_enabled (b))
4635 if (b->type == type)
4637 else if ((b->type == bp_hardware_watchpoint ||
4638 b->type == bp_read_watchpoint ||
4639 b->type == bp_access_watchpoint))
4640 *other_type_used = 1;
4646 /* Call this after hitting the longjmp() breakpoint. Use this to set
4647 a new breakpoint at the target of the jmp_buf.
4649 FIXME - This ought to be done by setting a temporary breakpoint
4650 that gets deleted automatically... */
4653 set_longjmp_resume_breakpoint (CORE_ADDR pc, struct frame_id frame_id)
4655 struct breakpoint *b;
4658 if (b->type == bp_longjmp_resume)
4660 b->loc->requested_address = pc;
4661 b->loc->address = adjust_breakpoint_address (b->loc->requested_address,
4663 b->enable_state = bp_enabled;
4664 b->frame_id = frame_id;
4665 check_duplicates (b);
4671 disable_watchpoints_before_interactive_call_start (void)
4673 struct breakpoint *b;
4677 if (((b->type == bp_watchpoint)
4678 || (b->type == bp_hardware_watchpoint)
4679 || (b->type == bp_read_watchpoint)
4680 || (b->type == bp_access_watchpoint)
4681 || ep_is_exception_catchpoint (b))
4682 && breakpoint_enabled (b))
4684 b->enable_state = bp_call_disabled;
4685 check_duplicates (b);
4691 enable_watchpoints_after_interactive_call_stop (void)
4693 struct breakpoint *b;
4697 if (((b->type == bp_watchpoint)
4698 || (b->type == bp_hardware_watchpoint)
4699 || (b->type == bp_read_watchpoint)
4700 || (b->type == bp_access_watchpoint)
4701 || ep_is_exception_catchpoint (b))
4702 && (b->enable_state == bp_call_disabled))
4704 b->enable_state = bp_enabled;
4705 check_duplicates (b);
4711 /* Set a breakpoint that will evaporate an end of command
4712 at address specified by SAL.
4713 Restrict it to frame FRAME if FRAME is nonzero. */
4716 set_momentary_breakpoint (struct symtab_and_line sal, struct frame_id frame_id,
4719 struct breakpoint *b;
4720 b = set_raw_breakpoint (sal, type);
4721 b->enable_state = bp_enabled;
4722 b->disposition = disp_donttouch;
4723 b->frame_id = frame_id;
4725 /* If we're debugging a multi-threaded program, then we
4726 want momentary breakpoints to be active in only a
4727 single thread of control. */
4728 if (in_thread_list (inferior_ptid))
4729 b->thread = pid_to_thread_id (inferior_ptid);
4735 /* Tell the user we have just set a breakpoint B. */
4738 mention (struct breakpoint *b)
4741 struct cleanup *old_chain, *ui_out_chain;
4742 struct ui_stream *stb;
4744 stb = ui_out_stream_new (uiout);
4745 old_chain = make_cleanup_ui_out_stream_delete (stb);
4747 /* FIXME: This is misplaced; mention() is called by things (like
4748 hitting a watchpoint) other than breakpoint creation. It should
4749 be possible to clean this up and at the same time replace the
4750 random calls to breakpoint_changed with this hook, as has already
4751 been done for deprecated_delete_breakpoint_hook and so on. */
4752 if (deprecated_create_breakpoint_hook)
4753 deprecated_create_breakpoint_hook (b);
4754 breakpoint_create_event (b->number);
4756 if (b->ops != NULL && b->ops->print_mention != NULL)
4757 b->ops->print_mention (b);
4762 printf_filtered ("(apparently deleted?) Eventpoint %d: ", b->number);
4765 ui_out_text (uiout, "Watchpoint ");
4766 ui_out_chain = make_cleanup_ui_out_tuple_begin_end (uiout, "wpt");
4767 ui_out_field_int (uiout, "number", b->number);
4768 ui_out_text (uiout, ": ");
4769 print_expression (b->exp, stb->stream);
4770 ui_out_field_stream (uiout, "exp", stb);
4771 do_cleanups (ui_out_chain);
4773 case bp_hardware_watchpoint:
4774 ui_out_text (uiout, "Hardware watchpoint ");
4775 ui_out_chain = make_cleanup_ui_out_tuple_begin_end (uiout, "wpt");
4776 ui_out_field_int (uiout, "number", b->number);
4777 ui_out_text (uiout, ": ");
4778 print_expression (b->exp, stb->stream);
4779 ui_out_field_stream (uiout, "exp", stb);
4780 do_cleanups (ui_out_chain);
4782 case bp_read_watchpoint:
4783 ui_out_text (uiout, "Hardware read watchpoint ");
4784 ui_out_chain = make_cleanup_ui_out_tuple_begin_end (uiout, "hw-rwpt");
4785 ui_out_field_int (uiout, "number", b->number);
4786 ui_out_text (uiout, ": ");
4787 print_expression (b->exp, stb->stream);
4788 ui_out_field_stream (uiout, "exp", stb);
4789 do_cleanups (ui_out_chain);
4791 case bp_access_watchpoint:
4792 ui_out_text (uiout, "Hardware access (read/write) watchpoint ");
4793 ui_out_chain = make_cleanup_ui_out_tuple_begin_end (uiout, "hw-awpt");
4794 ui_out_field_int (uiout, "number", b->number);
4795 ui_out_text (uiout, ": ");
4796 print_expression (b->exp, stb->stream);
4797 ui_out_field_stream (uiout, "exp", stb);
4798 do_cleanups (ui_out_chain);
4801 if (ui_out_is_mi_like_p (uiout))
4806 printf_filtered ("Breakpoint %d", b->number);
4809 case bp_hardware_breakpoint:
4810 if (ui_out_is_mi_like_p (uiout))
4815 printf_filtered ("Hardware assisted breakpoint %d", b->number);
4819 case bp_catch_unload:
4820 printf_filtered ("Catchpoint %d (%s %s)",
4822 (b->type == bp_catch_load) ? "load" : "unload",
4823 (b->dll_pathname != NULL) ?
4824 b->dll_pathname : "<any library>");
4827 case bp_catch_vfork:
4828 printf_filtered ("Catchpoint %d (%s)",
4830 (b->type == bp_catch_fork) ? "fork" : "vfork");
4833 printf_filtered ("Catchpoint %d (exec)",
4836 case bp_catch_catch:
4837 case bp_catch_throw:
4838 printf_filtered ("Catchpoint %d (%s)",
4840 (b->type == bp_catch_catch) ? "catch" : "throw");
4846 case bp_longjmp_resume:
4847 case bp_step_resume:
4848 case bp_through_sigtramp:
4850 case bp_watchpoint_scope:
4851 case bp_shlib_event:
4852 case bp_thread_event:
4853 case bp_overlay_event:
4861 printf_filtered (" (%s) pending.", b->addr_string);
4865 if (addressprint || b->source_file == NULL)
4867 printf_filtered (" at ");
4868 print_address_numeric (b->loc->address, 1, gdb_stdout);
4871 printf_filtered (": file %s, line %d.",
4872 b->source_file, b->line_number);
4875 do_cleanups (old_chain);
4876 if (ui_out_is_mi_like_p (uiout))
4878 printf_filtered ("\n");
4882 /* Add SALS.nelts breakpoints to the breakpoint table. For each
4883 SALS.sal[i] breakpoint, include the corresponding ADDR_STRING[i],
4884 COND[i] and COND_STRING[i] values.
4886 The parameter PENDING_BP points to a pending breakpoint that is
4887 the basis of the breakpoints currently being created. The pending
4888 breakpoint may contain a separate condition string or commands
4889 that were added after the initial pending breakpoint was created.
4891 NOTE: If the function succeeds, the caller is expected to cleanup
4892 the arrays ADDR_STRING, COND_STRING, COND and SALS (but not the
4893 array contents). If the function fails (error() is called), the
4894 caller is expected to cleanups both the ADDR_STRING, COND_STRING,
4895 COND and SALS arrays and each of those arrays contents. */
4898 create_breakpoints (struct symtabs_and_lines sals, char **addr_string,
4899 struct expression **cond, char **cond_string,
4900 enum bptype type, enum bpdisp disposition,
4901 int thread, int ignore_count, int from_tty,
4902 struct breakpoint *pending_bp)
4904 if (type == bp_hardware_breakpoint)
4906 int i = hw_breakpoint_used_count ();
4907 int target_resources_ok =
4908 TARGET_CAN_USE_HARDWARE_WATCHPOINT (bp_hardware_breakpoint,
4910 if (target_resources_ok == 0)
4911 error ("No hardware breakpoint support in the target.");
4912 else if (target_resources_ok < 0)
4913 error ("Hardware breakpoints used exceeds limit.");
4916 /* Now set all the breakpoints. */
4919 for (i = 0; i < sals.nelts; i++)
4921 struct breakpoint *b;
4922 struct symtab_and_line sal = sals.sals[i];
4925 describe_other_breakpoints (sal.pc, sal.section);
4927 b = set_raw_breakpoint (sal, type);
4928 set_breakpoint_count (breakpoint_count + 1);
4929 b->number = breakpoint_count;
4933 b->addr_string = addr_string[i];
4935 /* addr_string has to be used or breakpoint_re_set will delete
4937 b->addr_string = xstrprintf ("*0x%s", paddr (b->loc->address));
4938 b->cond_string = cond_string[i];
4939 b->ignore_count = ignore_count;
4940 b->enable_state = bp_enabled;
4941 b->disposition = disposition;
4942 /* If resolving a pending breakpoint, a check must be made to see if
4943 the user has specified a new condition or commands for the
4944 breakpoint. A new condition will override any condition that was
4945 initially specified with the initial breakpoint command. */
4949 if (pending_bp->cond_string)
4951 arg = pending_bp->cond_string;
4952 b->cond_string = savestring (arg, strlen (arg));
4953 b->cond = parse_exp_1 (&arg, block_for_pc (b->loc->address), 0);
4955 error ("Junk at end of pending breakpoint condition expression");
4957 /* If there are commands associated with the breakpoint, they should
4959 if (pending_bp->commands)
4960 b->commands = copy_command_lines (pending_bp->commands);
4962 /* We have to copy over the ignore_count and thread as well. */
4963 b->ignore_count = pending_bp->ignore_count;
4964 b->thread = pending_bp->thread;
4971 /* Parse ARG which is assumed to be a SAL specification possibly
4972 followed by conditionals. On return, SALS contains an array of SAL
4973 addresses found. ADDR_STRING contains a vector of (canonical)
4974 address strings. ARG points to the end of the SAL. */
4977 parse_breakpoint_sals (char **address,
4978 struct symtabs_and_lines *sals,
4979 char ***addr_string,
4982 char *addr_start = *address;
4983 *addr_string = NULL;
4984 /* If no arg given, or if first arg is 'if ', use the default
4986 if ((*address) == NULL
4987 || (strncmp ((*address), "if", 2) == 0 && isspace ((*address)[2])))
4989 if (default_breakpoint_valid)
4991 struct symtab_and_line sal;
4992 init_sal (&sal); /* initialize to zeroes */
4993 sals->sals = (struct symtab_and_line *)
4994 xmalloc (sizeof (struct symtab_and_line));
4995 sal.pc = default_breakpoint_address;
4996 sal.line = default_breakpoint_line;
4997 sal.symtab = default_breakpoint_symtab;
4998 sal.section = find_pc_overlay (sal.pc);
4999 sals->sals[0] = sal;
5003 error ("No default breakpoint address now.");
5007 /* Force almost all breakpoints to be in terms of the
5008 current_source_symtab (which is decode_line_1's default). This
5009 should produce the results we want almost all of the time while
5010 leaving default_breakpoint_* alone.
5011 ObjC: However, don't match an Objective-C method name which
5012 may have a '+' or '-' succeeded by a '[' */
5014 struct symtab_and_line cursal = get_current_source_symtab_and_line ();
5016 if (default_breakpoint_valid
5018 || ((strchr ("+-", (*address)[0]) != NULL)
5019 && ((*address)[1] != '['))))
5020 *sals = decode_line_1 (address, 1, default_breakpoint_symtab,
5021 default_breakpoint_line, addr_string,
5024 *sals = decode_line_1 (address, 1, (struct symtab *) NULL, 0,
5025 addr_string, not_found_ptr);
5027 /* For any SAL that didn't have a canonical string, fill one in. */
5028 if (sals->nelts > 0 && *addr_string == NULL)
5029 *addr_string = xcalloc (sals->nelts, sizeof (char **));
5030 if (addr_start != (*address))
5033 for (i = 0; i < sals->nelts; i++)
5035 /* Add the string if not present. */
5036 if ((*addr_string)[i] == NULL)
5037 (*addr_string)[i] = savestring (addr_start, (*address) - addr_start);
5043 /* Convert each SAL into a real PC. Verify that the PC can be
5044 inserted as a breakpoint. If it can't throw an error. */
5047 breakpoint_sals_to_pc (struct symtabs_and_lines *sals,
5051 for (i = 0; i < sals->nelts; i++)
5053 resolve_sal_pc (&sals->sals[i]);
5055 /* It's possible for the PC to be nonzero, but still an illegal
5056 value on some targets.
5058 For example, on HP-UX if you start gdb, and before running the
5059 inferior you try to set a breakpoint on a shared library function
5060 "foo" where the inferior doesn't call "foo" directly but does
5061 pass its address to another function call, then we do find a
5062 minimal symbol for the "foo", but it's address is invalid.
5063 (Appears to be an index into a table that the loader sets up
5064 when the inferior is run.)
5066 Give the target a chance to bless sals.sals[i].pc before we
5067 try to make a breakpoint for it. */
5068 #ifdef DEPRECATED_PC_REQUIRES_RUN_BEFORE_USE
5069 if (DEPRECATED_PC_REQUIRES_RUN_BEFORE_USE (sals->sals[i].pc))
5071 if (address == NULL)
5072 error ("Cannot break without a running program.");
5074 error ("Cannot break on %s without a running program.",
5082 do_captured_parse_breakpoint (struct ui_out *ui, void *data)
5084 struct captured_parse_breakpoint_args *args = data;
5086 parse_breakpoint_sals (args->arg_p, args->sals_p, args->addr_string_p,
5087 args->not_found_ptr);
5092 /* Set a breakpoint according to ARG (function, linenum or *address)
5093 flag: first bit : 0 non-temporary, 1 temporary.
5094 second bit : 0 normal breakpoint, 1 hardware breakpoint.
5096 PENDING_BP is non-NULL when this function is being called to resolve
5097 a pending breakpoint. */
5100 break_command_1 (char *arg, int flag, int from_tty, struct breakpoint *pending_bp)
5102 int tempflag, hardwareflag;
5103 struct symtabs_and_lines sals;
5104 struct expression **cond = 0;
5105 struct symtab_and_line pending_sal;
5106 char **cond_string = (char **) NULL;
5109 char *addr_start = arg;
5111 struct cleanup *old_chain;
5112 struct cleanup *breakpoint_chain = NULL;
5113 struct captured_parse_breakpoint_args parse_args;
5117 int ignore_count = 0;
5120 hardwareflag = flag & BP_HARDWAREFLAG;
5121 tempflag = flag & BP_TEMPFLAG;
5127 parse_args.arg_p = &arg;
5128 parse_args.sals_p = &sals;
5129 parse_args.addr_string_p = &addr_string;
5130 parse_args.not_found_ptr = ¬_found;
5132 rc = catch_exceptions_with_msg (uiout, do_captured_parse_breakpoint,
5133 &parse_args, NULL, &err_msg,
5136 /* If caller is interested in rc value from parse, set value. */
5138 if (rc != GDB_RC_OK)
5140 /* Check for file or function not found. */
5143 /* If called to resolve pending breakpoint, just return error code. */
5150 error_output_message (NULL, err_msg);
5153 /* If pending breakpoint support is turned off, throw error. */
5155 if (pending_break_support == AUTO_BOOLEAN_FALSE)
5156 throw_reason (RETURN_ERROR);
5158 /* If pending breakpoint support is auto query and the user selects
5159 no, then simply return the error code. */
5160 if (pending_break_support == AUTO_BOOLEAN_AUTO &&
5161 !nquery ("Make breakpoint pending on future shared library load? "))
5164 /* At this point, either the user was queried about setting a
5165 pending breakpoint and selected yes, or pending breakpoint
5166 behavior is on and thus a pending breakpoint is defaulted
5167 on behalf of the user. */
5168 copy_arg = xstrdup (addr_start);
5169 addr_string = ©_arg;
5171 sals.sals = &pending_sal;
5181 else if (!sals.nelts)
5184 /* Create a chain of things that always need to be cleaned up. */
5185 old_chain = make_cleanup (null_cleanup, 0);
5189 /* Make sure that all storage allocated to SALS gets freed. */
5190 make_cleanup (xfree, sals.sals);
5192 /* Cleanup the addr_string array but not its contents. */
5193 make_cleanup (xfree, addr_string);
5196 /* Allocate space for all the cond expressions. */
5197 cond = xcalloc (sals.nelts, sizeof (struct expression *));
5198 make_cleanup (xfree, cond);
5200 /* Allocate space for all the cond strings. */
5201 cond_string = xcalloc (sals.nelts, sizeof (char **));
5202 make_cleanup (xfree, cond_string);
5204 /* ----------------------------- SNIP -----------------------------
5205 Anything added to the cleanup chain beyond this point is assumed
5206 to be part of a breakpoint. If the breakpoint create succeeds
5207 then the memory is not reclaimed. */
5208 breakpoint_chain = make_cleanup (null_cleanup, 0);
5210 /* Mark the contents of the addr_string for cleanup. These go on
5211 the breakpoint_chain and only occure if the breakpoint create
5213 for (i = 0; i < sals.nelts; i++)
5215 if (addr_string[i] != NULL)
5216 make_cleanup (xfree, addr_string[i]);
5219 /* Resolve all line numbers to PC's and verify that the addresses
5220 are ok for the target. */
5222 breakpoint_sals_to_pc (&sals, addr_start);
5224 /* Verify that condition can be parsed, before setting any
5225 breakpoints. Allocate a separate condition expression for each
5227 thread = -1; /* No specific thread yet */
5230 for (i = 0; i < sals.nelts; i++)
5237 char *cond_start = NULL;
5238 char *cond_end = NULL;
5239 while (*tok == ' ' || *tok == '\t')
5244 while (*end_tok != ' ' && *end_tok != '\t' && *end_tok != '\000')
5247 toklen = end_tok - tok;
5249 if (toklen >= 1 && strncmp (tok, "if", toklen) == 0)
5251 tok = cond_start = end_tok + 1;
5252 cond[i] = parse_exp_1 (&tok, block_for_pc (sals.sals[i].pc),
5254 make_cleanup (xfree, cond[i]);
5256 cond_string[i] = savestring (cond_start,
5257 cond_end - cond_start);
5258 make_cleanup (xfree, cond_string[i]);
5260 else if (toklen >= 1 && strncmp (tok, "thread", toklen) == 0)
5266 thread = strtol (tok, &tok, 0);
5268 error ("Junk after thread keyword.");
5269 if (!valid_thread_id (thread))
5270 error ("Unknown thread %d\n", thread);
5273 error ("Junk at end of arguments.");
5276 create_breakpoints (sals, addr_string, cond, cond_string,
5277 hardwareflag ? bp_hardware_breakpoint
5279 tempflag ? disp_del : disp_donttouch,
5280 thread, ignore_count, from_tty,
5285 struct symtab_and_line sal;
5286 struct breakpoint *b;
5291 make_cleanup (xfree, copy_arg);
5293 b = set_raw_breakpoint (sal, hardwareflag ? bp_hardware_breakpoint
5295 set_breakpoint_count (breakpoint_count + 1);
5296 b->number = breakpoint_count;
5299 b->addr_string = *addr_string;
5300 b->cond_string = *cond_string;
5301 b->ignore_count = ignore_count;
5303 b->disposition = tempflag ? disp_del : disp_donttouch;
5304 b->from_tty = from_tty;
5311 warning ("Multiple breakpoints were set.");
5312 warning ("Use the \"delete\" command to delete unwanted breakpoints.");
5314 /* That's it. Discard the cleanups for data inserted into the
5316 discard_cleanups (breakpoint_chain);
5317 /* But cleanup everything else. */
5318 do_cleanups (old_chain);
5323 /* Set a breakpoint of TYPE/DISPOSITION according to ARG (function,
5324 linenum or *address) with COND and IGNORE_COUNT. */
5326 struct captured_breakpoint_args
5337 do_captured_breakpoint (void *data)
5339 struct captured_breakpoint_args *args = data;
5340 struct symtabs_and_lines sals;
5341 struct expression **cond;
5342 struct cleanup *old_chain;
5343 struct cleanup *breakpoint_chain = NULL;
5350 /* Parse the source and lines spec. Delay check that the expression
5351 didn't contain trailing garbage until after cleanups are in
5355 address_end = args->address;
5357 parse_breakpoint_sals (&address_end, &sals, &addr_string, 0);
5362 /* Create a chain of things at always need to be cleaned up. */
5363 old_chain = make_cleanup (null_cleanup, 0);
5365 /* Always have a addr_string array, even if it is empty. */
5366 make_cleanup (xfree, addr_string);
5368 /* Make sure that all storage allocated to SALS gets freed. */
5369 make_cleanup (xfree, sals.sals);
5371 /* Allocate space for all the cond expressions. */
5372 cond = xcalloc (sals.nelts, sizeof (struct expression *));
5373 make_cleanup (xfree, cond);
5375 /* Allocate space for all the cond strings. */
5376 cond_string = xcalloc (sals.nelts, sizeof (char **));
5377 make_cleanup (xfree, cond_string);
5379 /* ----------------------------- SNIP -----------------------------
5380 Anything added to the cleanup chain beyond this point is assumed
5381 to be part of a breakpoint. If the breakpoint create goes
5382 through then that memory is not cleaned up. */
5383 breakpoint_chain = make_cleanup (null_cleanup, 0);
5385 /* Mark the contents of the addr_string for cleanup. These go on
5386 the breakpoint_chain and only occure if the breakpoint create
5388 for (i = 0; i < sals.nelts; i++)
5390 if (addr_string[i] != NULL)
5391 make_cleanup (xfree, addr_string[i]);
5394 /* Wait until now before checking for garbage at the end of the
5395 address. That way cleanups can take care of freeing any
5397 if (*address_end != '\0')
5398 error ("Garbage %s following breakpoint address", address_end);
5400 /* Resolve all line numbers to PC's. */
5401 breakpoint_sals_to_pc (&sals, args->address);
5403 /* Verify that conditions can be parsed, before setting any
5405 for (i = 0; i < sals.nelts; i++)
5407 if (args->condition != NULL)
5409 char *tok = args->condition;
5410 cond[i] = parse_exp_1 (&tok, block_for_pc (sals.sals[i].pc), 0);
5412 error ("Garbage %s follows condition", tok);
5413 make_cleanup (xfree, cond[i]);
5414 cond_string[i] = xstrdup (args->condition);
5418 create_breakpoints (sals, addr_string, cond, cond_string,
5419 args->hardwareflag ? bp_hardware_breakpoint : bp_breakpoint,
5420 args->tempflag ? disp_del : disp_donttouch,
5421 args->thread, args->ignore_count, 0/*from-tty*/,
5422 NULL/*pending_bp*/);
5424 /* That's it. Discard the cleanups for data inserted into the
5426 discard_cleanups (breakpoint_chain);
5427 /* But cleanup everything else. */
5428 do_cleanups (old_chain);
5433 gdb_breakpoint (char *address, char *condition,
5434 int hardwareflag, int tempflag,
5435 int thread, int ignore_count)
5437 struct captured_breakpoint_args args;
5438 args.address = address;
5439 args.condition = condition;
5440 args.hardwareflag = hardwareflag;
5441 args.tempflag = tempflag;
5442 args.thread = thread;
5443 args.ignore_count = ignore_count;
5444 return catch_errors (do_captured_breakpoint, &args,
5445 NULL, RETURN_MASK_ALL);
5449 /* Helper function for break_command_1 and disassemble_command. */
5452 resolve_sal_pc (struct symtab_and_line *sal)
5456 if (sal->pc == 0 && sal->symtab != NULL)
5458 if (!find_line_pc (sal->symtab, sal->line, &pc))
5459 error ("No line %d in file \"%s\".",
5460 sal->line, sal->symtab->filename);
5464 if (sal->section == 0 && sal->symtab != NULL)
5466 struct blockvector *bv;
5471 bv = blockvector_for_pc_sect (sal->pc, 0, &index, sal->symtab);
5474 b = BLOCKVECTOR_BLOCK (bv, index);
5475 sym = block_function (b);
5478 fixup_symbol_section (sym, sal->symtab->objfile);
5479 sal->section = SYMBOL_BFD_SECTION (sym);
5483 /* It really is worthwhile to have the section, so we'll just
5484 have to look harder. This case can be executed if we have
5485 line numbers but no functions (as can happen in assembly
5488 struct minimal_symbol *msym;
5490 msym = lookup_minimal_symbol_by_pc (sal->pc);
5492 sal->section = SYMBOL_BFD_SECTION (msym);
5499 break_command (char *arg, int from_tty)
5501 break_command_1 (arg, 0, from_tty, NULL);
5505 tbreak_command (char *arg, int from_tty)
5507 break_command_1 (arg, BP_TEMPFLAG, from_tty, NULL);
5511 hbreak_command (char *arg, int from_tty)
5513 break_command_1 (arg, BP_HARDWAREFLAG, from_tty, NULL);
5517 thbreak_command (char *arg, int from_tty)
5519 break_command_1 (arg, (BP_TEMPFLAG | BP_HARDWAREFLAG), from_tty, NULL);
5523 stop_command (char *arg, int from_tty)
5525 printf_filtered ("Specify the type of breakpoint to set.\n\
5526 Usage: stop in <function | address>\n\
5531 stopin_command (char *arg, int from_tty)
5535 if (arg == (char *) NULL)
5537 else if (*arg != '*')
5542 /* look for a ':'. If this is a line number specification, then
5543 say it is bad, otherwise, it should be an address or
5544 function/method name */
5545 while (*argptr && !hasColon)
5547 hasColon = (*argptr == ':');
5552 badInput = (*argptr != ':'); /* Not a class::method */
5554 badInput = isdigit (*arg); /* a simple line number */
5558 printf_filtered ("Usage: stop in <function | address>\n");
5560 break_command_1 (arg, 0, from_tty, NULL);
5564 stopat_command (char *arg, int from_tty)
5568 if (arg == (char *) NULL || *arg == '*') /* no line number */
5575 /* look for a ':'. If there is a '::' then get out, otherwise
5576 it is probably a line number. */
5577 while (*argptr && !hasColon)
5579 hasColon = (*argptr == ':');
5584 badInput = (*argptr == ':'); /* we have class::method */
5586 badInput = !isdigit (*arg); /* not a line number */
5590 printf_filtered ("Usage: stop at <line>\n");
5592 break_command_1 (arg, 0, from_tty, NULL);
5595 /* accessflag: hw_write: watch write,
5596 hw_read: watch read,
5597 hw_access: watch access (read or write) */
5599 watch_command_1 (char *arg, int accessflag, int from_tty)
5601 struct breakpoint *b;
5602 struct symtab_and_line sal;
5603 struct expression *exp;
5604 struct block *exp_valid_block;
5605 struct value *val, *mark;
5606 struct frame_info *frame;
5607 struct frame_info *prev_frame = NULL;
5608 char *exp_start = NULL;
5609 char *exp_end = NULL;
5610 char *tok, *end_tok;
5612 char *cond_start = NULL;
5613 char *cond_end = NULL;
5614 struct expression *cond = NULL;
5615 int i, other_type_used, target_resources_ok = 0;
5616 enum bptype bp_type;
5619 init_sal (&sal); /* initialize to zeroes */
5621 /* Parse arguments. */
5622 innermost_block = NULL;
5624 exp = parse_exp_1 (&arg, 0, 0);
5626 exp_valid_block = innermost_block;
5627 mark = value_mark ();
5628 val = evaluate_expression (exp);
5629 release_value (val);
5630 if (VALUE_LAZY (val))
5631 value_fetch_lazy (val);
5634 while (*tok == ' ' || *tok == '\t')
5638 while (*end_tok != ' ' && *end_tok != '\t' && *end_tok != '\000')
5641 toklen = end_tok - tok;
5642 if (toklen >= 1 && strncmp (tok, "if", toklen) == 0)
5644 tok = cond_start = end_tok + 1;
5645 cond = parse_exp_1 (&tok, 0, 0);
5649 error ("Junk at end of command.");
5651 if (accessflag == hw_read)
5652 bp_type = bp_read_watchpoint;
5653 else if (accessflag == hw_access)
5654 bp_type = bp_access_watchpoint;
5656 bp_type = bp_hardware_watchpoint;
5658 mem_cnt = can_use_hardware_watchpoint (val);
5659 if (mem_cnt == 0 && bp_type != bp_hardware_watchpoint)
5660 error ("Expression cannot be implemented with read/access watchpoint.");
5663 i = hw_watchpoint_used_count (bp_type, &other_type_used);
5664 target_resources_ok =
5665 TARGET_CAN_USE_HARDWARE_WATCHPOINT (bp_type, i + mem_cnt,
5667 if (target_resources_ok == 0 && bp_type != bp_hardware_watchpoint)
5668 error ("Target does not support this type of hardware watchpoint.");
5670 if (target_resources_ok < 0 && bp_type != bp_hardware_watchpoint)
5671 error ("Target can only support one kind of HW watchpoint at a time.");
5674 #if defined(HPUXHPPA)
5675 /* On HP-UX if you set a h/w
5676 watchpoint before the "run" command, the inferior dies with a e.g.,
5677 SIGILL once you start it. I initially believed this was due to a
5678 bad interaction between page protection traps and the initial
5679 startup sequence by the dynamic linker.
5681 However, I tried avoiding that by having HP-UX's implementation of
5682 TARGET_CAN_USE_HW_WATCHPOINT return FALSE if there was no inferior_ptid
5683 yet, which forced slow watches before a "run" or "attach", and it
5684 still fails somewhere in the startup code.
5686 Until I figure out what's happening, I'm disallowing watches altogether
5687 before the "run" or "attach" command. We'll tell the user they must
5688 set watches after getting the program started. */
5689 if (!target_has_execution)
5691 warning ("can't do that without a running program; try \"break main\", \"run\" first");
5694 #endif /* HPUXHPPA */
5696 /* Change the type of breakpoint to an ordinary watchpoint if a hardware
5697 watchpoint could not be set. */
5698 if (!mem_cnt || target_resources_ok <= 0)
5699 bp_type = bp_watchpoint;
5701 /* Now set up the breakpoint. */
5702 b = set_raw_breakpoint (sal, bp_type);
5703 set_breakpoint_count (breakpoint_count + 1);
5704 b->number = breakpoint_count;
5705 b->disposition = disp_donttouch;
5707 b->exp_valid_block = exp_valid_block;
5708 b->exp_string = savestring (exp_start, exp_end - exp_start);
5712 b->cond_string = savestring (cond_start, cond_end - cond_start);
5716 frame = block_innermost_frame (exp_valid_block);
5719 prev_frame = get_prev_frame (frame);
5720 b->watchpoint_frame = get_frame_id (frame);
5724 memset (&b->watchpoint_frame, 0, sizeof (b->watchpoint_frame));
5727 /* If the expression is "local", then set up a "watchpoint scope"
5728 breakpoint at the point where we've left the scope of the watchpoint
5730 if (innermost_block)
5734 struct breakpoint *scope_breakpoint;
5735 scope_breakpoint = create_internal_breakpoint (get_frame_pc (prev_frame),
5736 bp_watchpoint_scope);
5738 scope_breakpoint->enable_state = bp_enabled;
5740 /* Automatically delete the breakpoint when it hits. */
5741 scope_breakpoint->disposition = disp_del;
5743 /* Only break in the proper frame (help with recursion). */
5744 scope_breakpoint->frame_id = get_frame_id (prev_frame);
5746 /* Set the address at which we will stop. */
5747 scope_breakpoint->loc->requested_address
5748 = get_frame_pc (prev_frame);
5749 scope_breakpoint->loc->address
5750 = adjust_breakpoint_address (scope_breakpoint->loc->requested_address,
5751 scope_breakpoint->type);
5753 /* The scope breakpoint is related to the watchpoint. We
5754 will need to act on them together. */
5755 b->related_breakpoint = scope_breakpoint;
5758 value_free_to_mark (mark);
5762 /* Return count of locations need to be watched and can be handled
5763 in hardware. If the watchpoint can not be handled
5764 in hardware return zero. */
5766 #if !defined(TARGET_REGION_OK_FOR_HW_WATCHPOINT)
5767 #define TARGET_REGION_OK_FOR_HW_WATCHPOINT(ADDR,LEN) \
5768 (TARGET_REGION_SIZE_OK_FOR_HW_WATCHPOINT(LEN))
5772 can_use_hardware_watchpoint (struct value *v)
5774 int found_memory_cnt = 0;
5775 struct value *head = v;
5777 /* Did the user specifically forbid us to use hardware watchpoints? */
5778 if (!can_use_hw_watchpoints)
5781 /* Make sure that the value of the expression depends only upon
5782 memory contents, and values computed from them within GDB. If we
5783 find any register references or function calls, we can't use a
5784 hardware watchpoint.
5786 The idea here is that evaluating an expression generates a series
5787 of values, one holding the value of every subexpression. (The
5788 expression a*b+c has five subexpressions: a, b, a*b, c, and
5789 a*b+c.) GDB's values hold almost enough information to establish
5790 the criteria given above --- they identify memory lvalues,
5791 register lvalues, computed values, etcetera. So we can evaluate
5792 the expression, and then scan the chain of values that leaves
5793 behind to decide whether we can detect any possible change to the
5794 expression's final value using only hardware watchpoints.
5796 However, I don't think that the values returned by inferior
5797 function calls are special in any way. So this function may not
5798 notice that an expression involving an inferior function call
5799 can't be watched with hardware watchpoints. FIXME. */
5800 for (; v; v = v->next)
5802 if (VALUE_LVAL (v) == lval_memory)
5805 /* A lazy memory lvalue is one that GDB never needed to fetch;
5806 we either just used its address (e.g., `a' in `a.b') or
5807 we never needed it at all (e.g., `a' in `a,b'). */
5811 /* Ahh, memory we actually used! Check if we can cover
5812 it with hardware watchpoints. */
5813 struct type *vtype = check_typedef (value_type (v));
5815 /* We only watch structs and arrays if user asked for it
5816 explicitly, never if they just happen to appear in a
5817 middle of some value chain. */
5819 || (TYPE_CODE (vtype) != TYPE_CODE_STRUCT
5820 && TYPE_CODE (vtype) != TYPE_CODE_ARRAY))
5822 CORE_ADDR vaddr = VALUE_ADDRESS (v) + value_offset (v);
5823 int len = TYPE_LENGTH (value_type (v));
5825 if (!TARGET_REGION_OK_FOR_HW_WATCHPOINT (vaddr, len))
5832 else if (v->lval != not_lval && v->modifiable == 0)
5833 return 0; /* ??? What does this represent? */
5834 else if (v->lval == lval_register)
5835 return 0; /* cannot watch a register with a HW watchpoint */
5838 /* The expression itself looks suitable for using a hardware
5839 watchpoint, but give the target machine a chance to reject it. */
5840 return found_memory_cnt;
5844 watch_command_wrapper (char *arg, int from_tty)
5846 watch_command (arg, from_tty);
5850 watch_command (char *arg, int from_tty)
5852 watch_command_1 (arg, hw_write, from_tty);
5856 rwatch_command_wrapper (char *arg, int from_tty)
5858 rwatch_command (arg, from_tty);
5862 rwatch_command (char *arg, int from_tty)
5864 watch_command_1 (arg, hw_read, from_tty);
5868 awatch_command_wrapper (char *arg, int from_tty)
5870 awatch_command (arg, from_tty);
5874 awatch_command (char *arg, int from_tty)
5876 watch_command_1 (arg, hw_access, from_tty);
5880 /* Helper routines for the until_command routine in infcmd.c. Here
5881 because it uses the mechanisms of breakpoints. */
5883 /* This function is called by fetch_inferior_event via the
5884 cmd_continuation pointer, to complete the until command. It takes
5885 care of cleaning up the temporary breakpoints set up by the until
5888 until_break_command_continuation (struct continuation_arg *arg)
5890 struct cleanup *cleanups;
5892 cleanups = (struct cleanup *) arg->data.pointer;
5893 do_exec_cleanups (cleanups);
5897 until_break_command (char *arg, int from_tty, int anywhere)
5899 struct symtabs_and_lines sals;
5900 struct symtab_and_line sal;
5901 struct frame_info *prev_frame = get_prev_frame (deprecated_selected_frame);
5902 struct breakpoint *breakpoint;
5903 struct cleanup *old_chain;
5904 struct continuation_arg *arg1;
5907 clear_proceed_status ();
5909 /* Set a breakpoint where the user wants it and at return from
5912 if (default_breakpoint_valid)
5913 sals = decode_line_1 (&arg, 1, default_breakpoint_symtab,
5914 default_breakpoint_line, (char ***) NULL, NULL);
5916 sals = decode_line_1 (&arg, 1, (struct symtab *) NULL,
5917 0, (char ***) NULL, NULL);
5919 if (sals.nelts != 1)
5920 error ("Couldn't get information on specified line.");
5923 xfree (sals.sals); /* malloc'd, so freed */
5926 error ("Junk at end of arguments.");
5928 resolve_sal_pc (&sal);
5931 /* If the user told us to continue until a specified location,
5932 we don't specify a frame at which we need to stop. */
5933 breakpoint = set_momentary_breakpoint (sal, null_frame_id, bp_until);
5935 /* Otherwise, specify the current frame, because we want to stop only
5936 at the very same frame. */
5937 breakpoint = set_momentary_breakpoint (sal,
5938 get_frame_id (deprecated_selected_frame),
5941 if (!target_can_async_p ())
5942 old_chain = make_cleanup_delete_breakpoint (breakpoint);
5944 old_chain = make_exec_cleanup_delete_breakpoint (breakpoint);
5946 /* If we are running asynchronously, and the target supports async
5947 execution, we are not waiting for the target to stop, in the call
5948 tp proceed, below. This means that we cannot delete the
5949 brekpoints until the target has actually stopped. The only place
5950 where we get a chance to do that is in fetch_inferior_event, so
5951 we must set things up for that. */
5953 if (target_can_async_p ())
5955 /* In this case the arg for the continuation is just the point
5956 in the exec_cleanups chain from where to start doing
5957 cleanups, because all the continuation does is the cleanups in
5958 the exec_cleanup_chain. */
5960 (struct continuation_arg *) xmalloc (sizeof (struct continuation_arg));
5962 arg1->data.pointer = old_chain;
5964 add_continuation (until_break_command_continuation, arg1);
5967 /* Keep within the current frame, or in frames called by the current
5971 sal = find_pc_line (get_frame_pc (prev_frame), 0);
5972 sal.pc = get_frame_pc (prev_frame);
5973 breakpoint = set_momentary_breakpoint (sal, get_frame_id (prev_frame),
5975 if (!target_can_async_p ())
5976 make_cleanup_delete_breakpoint (breakpoint);
5978 make_exec_cleanup_delete_breakpoint (breakpoint);
5981 proceed (-1, TARGET_SIGNAL_DEFAULT, 0);
5982 /* Do the cleanups now, anly if we are not running asynchronously,
5983 of if we are, but the target is still synchronous. */
5984 if (!target_can_async_p ())
5985 do_cleanups (old_chain);
5989 ep_skip_leading_whitespace (char **s)
5991 if ((s == NULL) || (*s == NULL))
5993 while (isspace (**s))
5997 /* This function examines a string, and attempts to find a token
5998 that might be an event name in the leading characters. If a
5999 possible match is found, a pointer to the last character of
6000 the token is returned. Else, NULL is returned. */
6003 ep_find_event_name_end (char *arg)
6006 char *event_name_end = NULL;
6008 /* If we could depend upon the presense of strrpbrk, we'd use that... */
6012 /* We break out of the loop when we find a token delimiter.
6013 Basically, we're looking for alphanumerics and underscores;
6014 anything else delimites the token. */
6017 if (!isalnum (*s) && (*s != '_'))
6023 return event_name_end;
6027 /* This function attempts to parse an optional "if <cond>" clause
6028 from the arg string. If one is not found, it returns NULL.
6030 Else, it returns a pointer to the condition string. (It does not
6031 attempt to evaluate the string against a particular block.) And,
6032 it updates arg to point to the first character following the parsed
6033 if clause in the arg string. */
6036 ep_parse_optional_if_clause (char **arg)
6040 if (((*arg)[0] != 'i') || ((*arg)[1] != 'f') || !isspace ((*arg)[2]))
6043 /* Skip the "if" keyword. */
6046 /* Skip any extra leading whitespace, and record the start of the
6047 condition string. */
6048 ep_skip_leading_whitespace (arg);
6051 /* Assume that the condition occupies the remainder of the arg string. */
6052 (*arg) += strlen (cond_string);
6057 /* This function attempts to parse an optional filename from the arg
6058 string. If one is not found, it returns NULL.
6060 Else, it returns a pointer to the parsed filename. (This function
6061 makes no attempt to verify that a file of that name exists, or is
6062 accessible.) And, it updates arg to point to the first character
6063 following the parsed filename in the arg string.
6065 Note that clients needing to preserve the returned filename for
6066 future access should copy it to their own buffers. */
6068 ep_parse_optional_filename (char **arg)
6070 static char filename[1024];
6075 if ((*arg_p == '\0') || isspace (*arg_p))
6093 /* Commands to deal with catching events, such as signals, exceptions,
6094 process start/exit, etc. */
6098 catch_fork, catch_vfork
6103 catch_fork_command_1 (catch_fork_kind fork_kind, char *arg, int tempflag,
6106 char *cond_string = NULL;
6108 ep_skip_leading_whitespace (&arg);
6110 /* The allowed syntax is:
6112 catch [v]fork if <cond>
6114 First, check if there's an if clause. */
6115 cond_string = ep_parse_optional_if_clause (&arg);
6117 if ((*arg != '\0') && !isspace (*arg))
6118 error ("Junk at end of arguments.");
6120 /* If this target supports it, create a fork or vfork catchpoint
6121 and enable reporting of such events. */
6125 create_fork_event_catchpoint (tempflag, cond_string);
6128 create_vfork_event_catchpoint (tempflag, cond_string);
6131 error ("unsupported or unknown fork kind; cannot catch it");
6137 catch_exec_command_1 (char *arg, int tempflag, int from_tty)
6139 char *cond_string = NULL;
6141 ep_skip_leading_whitespace (&arg);
6143 /* The allowed syntax is:
6145 catch exec if <cond>
6147 First, check if there's an if clause. */
6148 cond_string = ep_parse_optional_if_clause (&arg);
6150 if ((*arg != '\0') && !isspace (*arg))
6151 error ("Junk at end of arguments.");
6153 /* If this target supports it, create an exec catchpoint
6154 and enable reporting of such events. */
6155 create_exec_event_catchpoint (tempflag, cond_string);
6159 catch_load_command_1 (char *arg, int tempflag, int from_tty)
6161 char *dll_pathname = NULL;
6162 char *cond_string = NULL;
6164 ep_skip_leading_whitespace (&arg);
6166 /* The allowed syntax is:
6168 catch load if <cond>
6169 catch load <filename>
6170 catch load <filename> if <cond>
6172 The user is not allowed to specify the <filename> after an
6175 We'll ignore the pathological case of a file named "if".
6177 First, check if there's an if clause. If so, then there
6178 cannot be a filename. */
6179 cond_string = ep_parse_optional_if_clause (&arg);
6181 /* If there was an if clause, then there cannot be a filename.
6182 Else, there might be a filename and an if clause. */
6183 if (cond_string == NULL)
6185 dll_pathname = ep_parse_optional_filename (&arg);
6186 ep_skip_leading_whitespace (&arg);
6187 cond_string = ep_parse_optional_if_clause (&arg);
6190 if ((*arg != '\0') && !isspace (*arg))
6191 error ("Junk at end of arguments.");
6193 /* Create a load breakpoint that only triggers when a load of
6194 the specified dll (or any dll, if no pathname was specified)
6196 SOLIB_CREATE_CATCH_LOAD_HOOK (PIDGET (inferior_ptid), tempflag,
6197 dll_pathname, cond_string);
6201 catch_unload_command_1 (char *arg, int tempflag, int from_tty)
6203 char *dll_pathname = NULL;
6204 char *cond_string = NULL;
6206 ep_skip_leading_whitespace (&arg);
6208 /* The allowed syntax is:
6210 catch unload if <cond>
6211 catch unload <filename>
6212 catch unload <filename> if <cond>
6214 The user is not allowed to specify the <filename> after an
6217 We'll ignore the pathological case of a file named "if".
6219 First, check if there's an if clause. If so, then there
6220 cannot be a filename. */
6221 cond_string = ep_parse_optional_if_clause (&arg);
6223 /* If there was an if clause, then there cannot be a filename.
6224 Else, there might be a filename and an if clause. */
6225 if (cond_string == NULL)
6227 dll_pathname = ep_parse_optional_filename (&arg);
6228 ep_skip_leading_whitespace (&arg);
6229 cond_string = ep_parse_optional_if_clause (&arg);
6232 if ((*arg != '\0') && !isspace (*arg))
6233 error ("Junk at end of arguments.");
6235 /* Create an unload breakpoint that only triggers when an unload of
6236 the specified dll (or any dll, if no pathname was specified)
6238 SOLIB_CREATE_CATCH_UNLOAD_HOOK (PIDGET (inferior_ptid), tempflag,
6239 dll_pathname, cond_string);
6242 /* Commands to deal with catching exceptions. */
6244 /* Set a breakpoint at the specified callback routine for an
6245 exception event callback */
6248 create_exception_catchpoint (int tempflag, char *cond_string,
6249 enum exception_event_kind ex_event,
6250 struct symtab_and_line *sal)
6252 struct breakpoint *b;
6253 int thread = -1; /* All threads. */
6256 if (!sal) /* no exception support? */
6261 case EX_EVENT_THROW:
6262 bptype = bp_catch_throw;
6264 case EX_EVENT_CATCH:
6265 bptype = bp_catch_catch;
6267 default: /* error condition */
6268 error ("Internal error -- invalid catchpoint kind");
6271 b = set_raw_breakpoint (*sal, bptype);
6272 set_breakpoint_count (breakpoint_count + 1);
6273 b->number = breakpoint_count;
6275 b->cond_string = (cond_string == NULL) ?
6276 NULL : savestring (cond_string, strlen (cond_string));
6278 b->addr_string = NULL;
6279 b->enable_state = bp_enabled;
6280 b->disposition = tempflag ? disp_del : disp_donttouch;
6284 static enum print_stop_action
6285 print_exception_catchpoint (struct breakpoint *b)
6287 annotate_catchpoint (b->number);
6289 if (strstr (b->addr_string, "throw") != NULL)
6290 printf_filtered ("\nCatchpoint %d (exception thrown)\n",
6293 printf_filtered ("\nCatchpoint %d (exception caught)\n",
6296 return PRINT_SRC_AND_LOC;
6300 print_one_exception_catchpoint (struct breakpoint *b, CORE_ADDR *last_addr)
6305 ui_out_field_core_addr (uiout, "addr", b->loc->address);
6308 *last_addr = b->loc->address;
6309 if (strstr (b->addr_string, "throw") != NULL)
6310 ui_out_field_string (uiout, "what", "exception throw");
6312 ui_out_field_string (uiout, "what", "exception catch");
6316 print_mention_exception_catchpoint (struct breakpoint *b)
6318 if (strstr (b->addr_string, "throw") != NULL)
6319 printf_filtered ("Catchpoint %d (throw)", b->number);
6321 printf_filtered ("Catchpoint %d (catch)", b->number);
6324 static struct breakpoint_ops gnu_v3_exception_catchpoint_ops = {
6325 print_exception_catchpoint,
6326 print_one_exception_catchpoint,
6327 print_mention_exception_catchpoint
6331 handle_gnu_v3_exceptions (int tempflag, char *cond_string,
6332 enum exception_event_kind ex_event, int from_tty)
6334 char *trigger_func_name, *nameptr;
6335 struct symtabs_and_lines sals;
6336 struct breakpoint *b;
6338 if (ex_event == EX_EVENT_CATCH)
6339 trigger_func_name = xstrdup ("__cxa_begin_catch");
6341 trigger_func_name = xstrdup ("__cxa_throw");
6343 nameptr = trigger_func_name;
6344 sals = decode_line_1 (&nameptr, 1, NULL, 0, NULL, NULL);
6345 if (sals.nelts == 0)
6347 xfree (trigger_func_name);
6351 b = set_raw_breakpoint (sals.sals[0], bp_breakpoint);
6352 set_breakpoint_count (breakpoint_count + 1);
6353 b->number = breakpoint_count;
6355 b->cond_string = (cond_string == NULL) ?
6356 NULL : savestring (cond_string, strlen (cond_string));
6358 b->addr_string = trigger_func_name;
6359 b->enable_state = bp_enabled;
6360 b->disposition = tempflag ? disp_del : disp_donttouch;
6361 b->ops = &gnu_v3_exception_catchpoint_ops;
6368 /* Deal with "catch catch" and "catch throw" commands */
6371 catch_exception_command_1 (enum exception_event_kind ex_event, char *arg,
6372 int tempflag, int from_tty)
6374 char *cond_string = NULL;
6375 struct symtab_and_line *sal = NULL;
6377 ep_skip_leading_whitespace (&arg);
6379 cond_string = ep_parse_optional_if_clause (&arg);
6381 if ((*arg != '\0') && !isspace (*arg))
6382 error ("Junk at end of arguments.");
6384 if ((ex_event != EX_EVENT_THROW) &&
6385 (ex_event != EX_EVENT_CATCH))
6386 error ("Unsupported or unknown exception event; cannot catch it");
6388 if (handle_gnu_v3_exceptions (tempflag, cond_string, ex_event, from_tty))
6391 /* See if we can find a callback routine */
6392 sal = target_enable_exception_callback (ex_event, 1);
6396 /* We have callbacks from the runtime system for exceptions.
6397 Set a breakpoint on the sal found, if no errors */
6398 if (sal != (struct symtab_and_line *) -1)
6399 create_exception_catchpoint (tempflag, cond_string, ex_event, sal);
6401 return; /* something went wrong with setting up callbacks */
6404 warning ("Unsupported with this platform/compiler combination.");
6407 /* Cover routine to allow wrapping target_enable_exception_catchpoints
6408 inside a catch_errors */
6411 cover_target_enable_exception_callback (void *arg)
6413 args_for_catchpoint_enable *args = arg;
6414 struct symtab_and_line *sal;
6415 sal = target_enable_exception_callback (args->kind, args->enable_p);
6418 else if (sal == (struct symtab_and_line *) -1)
6421 return 1; /*is valid */
6425 catch_command_1 (char *arg, int tempflag, int from_tty)
6428 /* The first argument may be an event name, such as "start" or "load".
6429 If so, then handle it as such. If it doesn't match an event name,
6430 then attempt to interpret it as an exception name. (This latter is
6431 the v4.16-and-earlier GDB meaning of the "catch" command.)
6433 First, try to find the bounds of what might be an event name. */
6434 char *arg1_start = arg;
6438 if (arg1_start == NULL)
6440 /* Old behaviour was to use pre-v-4.16 syntax */
6441 /* catch_throw_command_1 (arg1_start, tempflag, from_tty); */
6443 /* Now, this is not allowed */
6444 error ("Catch requires an event name.");
6447 arg1_end = ep_find_event_name_end (arg1_start);
6448 if (arg1_end == NULL)
6449 error ("catch requires an event");
6450 arg1_length = arg1_end + 1 - arg1_start;
6452 /* Try to match what we found against known event names. */
6453 if (strncmp (arg1_start, "signal", arg1_length) == 0)
6455 error ("Catch of signal not yet implemented");
6457 else if (strncmp (arg1_start, "catch", arg1_length) == 0)
6459 catch_exception_command_1 (EX_EVENT_CATCH, arg1_end + 1,
6460 tempflag, from_tty);
6462 else if (strncmp (arg1_start, "throw", arg1_length) == 0)
6464 catch_exception_command_1 (EX_EVENT_THROW, arg1_end + 1,
6465 tempflag, from_tty);
6467 else if (strncmp (arg1_start, "thread_start", arg1_length) == 0)
6469 error ("Catch of thread_start not yet implemented");
6471 else if (strncmp (arg1_start, "thread_exit", arg1_length) == 0)
6473 error ("Catch of thread_exit not yet implemented");
6475 else if (strncmp (arg1_start, "thread_join", arg1_length) == 0)
6477 error ("Catch of thread_join not yet implemented");
6479 else if (strncmp (arg1_start, "start", arg1_length) == 0)
6481 error ("Catch of start not yet implemented");
6483 else if (strncmp (arg1_start, "exit", arg1_length) == 0)
6485 error ("Catch of exit not yet implemented");
6487 else if (strncmp (arg1_start, "fork", arg1_length) == 0)
6489 catch_fork_command_1 (catch_fork, arg1_end + 1, tempflag, from_tty);
6491 else if (strncmp (arg1_start, "vfork", arg1_length) == 0)
6493 catch_fork_command_1 (catch_vfork, arg1_end + 1, tempflag, from_tty);
6495 else if (strncmp (arg1_start, "exec", arg1_length) == 0)
6497 catch_exec_command_1 (arg1_end + 1, tempflag, from_tty);
6499 else if (strncmp (arg1_start, "load", arg1_length) == 0)
6501 catch_load_command_1 (arg1_end + 1, tempflag, from_tty);
6503 else if (strncmp (arg1_start, "unload", arg1_length) == 0)
6505 catch_unload_command_1 (arg1_end + 1, tempflag, from_tty);
6507 else if (strncmp (arg1_start, "stop", arg1_length) == 0)
6509 error ("Catch of stop not yet implemented");
6512 /* This doesn't appear to be an event name */
6516 /* Pre-v.4.16 behaviour was to treat the argument
6517 as the name of an exception */
6518 /* catch_throw_command_1 (arg1_start, tempflag, from_tty); */
6519 /* Now this is not allowed */
6520 error ("Unknown event kind specified for catch");
6525 /* Used by the gui, could be made a worker for other things. */
6528 set_breakpoint_sal (struct symtab_and_line sal)
6530 struct breakpoint *b;
6531 b = set_raw_breakpoint (sal, bp_breakpoint);
6532 set_breakpoint_count (breakpoint_count + 1);
6533 b->number = breakpoint_count;
6540 catch_command (char *arg, int from_tty)
6542 catch_command_1 (arg, 0, from_tty);
6547 tcatch_command (char *arg, int from_tty)
6549 catch_command_1 (arg, 1, from_tty);
6552 /* Delete breakpoints by address or line. */
6555 clear_command (char *arg, int from_tty)
6557 struct breakpoint *b, *tmp, *prev, *found;
6559 struct symtabs_and_lines sals;
6560 struct symtab_and_line sal;
6565 sals = decode_line_spec (arg, 1);
6570 sals.sals = (struct symtab_and_line *)
6571 xmalloc (sizeof (struct symtab_and_line));
6572 make_cleanup (xfree, sals.sals);
6573 init_sal (&sal); /* initialize to zeroes */
6574 sal.line = default_breakpoint_line;
6575 sal.symtab = default_breakpoint_symtab;
6576 sal.pc = default_breakpoint_address;
6577 if (sal.symtab == 0)
6578 error ("No source file specified.");
6586 /* For each line spec given, delete bps which correspond
6587 to it. Do it in two passes, solely to preserve the current
6588 behavior that from_tty is forced true if we delete more than
6592 for (i = 0; i < sals.nelts; i++)
6594 /* If exact pc given, clear bpts at that pc.
6595 If line given (pc == 0), clear all bpts on specified line.
6596 If defaulting, clear all bpts on default line
6599 defaulting sal.pc != 0 tests to do
6604 1 0 <can't happen> */
6609 /* Find all matching breakpoints, remove them from the
6610 breakpoint chain, and add them to the 'found' chain. */
6611 ALL_BREAKPOINTS_SAFE (b, tmp)
6613 /* Are we going to delete b? */
6614 if (b->type != bp_none
6615 && b->type != bp_watchpoint
6616 && b->type != bp_hardware_watchpoint
6617 && b->type != bp_read_watchpoint
6618 && b->type != bp_access_watchpoint
6619 /* Not if b is a watchpoint of any sort... */
6620 && (((sal.pc && (b->loc->address == sal.pc))
6621 && (!section_is_overlay (b->loc->section)
6622 || b->loc->section == sal.section))
6623 /* Yes, if sal.pc matches b (modulo overlays). */
6624 || ((default_match || (0 == sal.pc))
6625 && b->source_file != NULL
6626 && sal.symtab != NULL
6627 && strcmp (b->source_file, sal.symtab->filename) == 0
6628 && b->line_number == sal.line)))
6629 /* Yes, if sal source file and line matches b. */
6631 /* Remove it from breakpoint_chain... */
6632 if (b == breakpoint_chain)
6634 /* b is at the head of the list */
6635 breakpoint_chain = b->next;
6639 prev->next = b->next;
6641 /* And add it to 'found' chain. */
6647 /* Keep b, and keep a pointer to it. */
6652 /* Now go thru the 'found' chain and delete them. */
6656 error ("No breakpoint at %s.", arg);
6658 error ("No breakpoint at this line.");
6662 from_tty = 1; /* Always report if deleted more than one */
6664 printf_unfiltered ("Deleted breakpoint%s ", found->next ? "s" : "");
6665 breakpoints_changed ();
6669 printf_unfiltered ("%d ", found->number);
6671 delete_breakpoint (found);
6675 putchar_unfiltered ('\n');
6678 /* Delete breakpoint in BS if they are `delete' breakpoints and
6679 all breakpoints that are marked for deletion, whether hit or not.
6680 This is called after any breakpoint is hit, or after errors. */
6683 breakpoint_auto_delete (bpstat bs)
6685 struct breakpoint *b, *temp;
6687 for (; bs; bs = bs->next)
6688 if (bs->breakpoint_at && bs->breakpoint_at->disposition == disp_del
6690 delete_breakpoint (bs->breakpoint_at);
6692 ALL_BREAKPOINTS_SAFE (b, temp)
6694 if (b->disposition == disp_del_at_next_stop)
6695 delete_breakpoint (b);
6699 /* Delete a breakpoint and clean up all traces of it in the data
6703 delete_breakpoint (struct breakpoint *bpt)
6705 struct breakpoint *b;
6707 struct bp_location *loc;
6710 error ("Internal error (attempted to delete a NULL breakpoint)");
6713 /* Has this bp already been deleted? This can happen because multiple
6714 lists can hold pointers to bp's. bpstat lists are especial culprits.
6716 One example of this happening is a watchpoint's scope bp. When the
6717 scope bp triggers, we notice that the watchpoint is out of scope, and
6718 delete it. We also delete its scope bp. But the scope bp is marked
6719 "auto-deleting", and is already on a bpstat. That bpstat is then
6720 checked for auto-deleting bp's, which are deleted.
6722 A real solution to this problem might involve reference counts in bp's,
6723 and/or giving them pointers back to their referencing bpstat's, and
6724 teaching delete_breakpoint to only free a bp's storage when no more
6725 references were extent. A cheaper bandaid was chosen. */
6726 if (bpt->type == bp_none)
6729 if (deprecated_delete_breakpoint_hook)
6730 deprecated_delete_breakpoint_hook (bpt);
6731 breakpoint_delete_event (bpt->number);
6733 if (bpt->loc->inserted)
6734 remove_breakpoint (bpt->loc, mark_inserted);
6736 free_valchain (bpt->loc);
6738 if (breakpoint_chain == bpt)
6739 breakpoint_chain = bpt->next;
6741 if (bp_location_chain == bpt->loc)
6742 bp_location_chain = bpt->loc->next;
6744 /* If we have callback-style exception catchpoints, don't go through
6745 the adjustments to the C++ runtime library etc. if the inferior
6746 isn't actually running. target_enable_exception_callback for a
6747 null target ops vector gives an undesirable error message, so we
6748 check here and avoid it. Since currently (1997-09-17) only HP-UX aCC's
6749 exceptions are supported in this way, it's OK for now. FIXME */
6750 if (ep_is_exception_catchpoint (bpt) && target_has_execution)
6752 /* Format possible error msg */
6753 char *message = xstrprintf ("Error in deleting catchpoint %d:\n",
6755 struct cleanup *cleanups = make_cleanup (xfree, message);
6756 args_for_catchpoint_enable args;
6757 args.kind = bpt->type == bp_catch_catch ?
6758 EX_EVENT_CATCH : EX_EVENT_THROW;
6760 catch_errors (cover_target_enable_exception_callback, &args,
6761 message, RETURN_MASK_ALL);
6762 do_cleanups (cleanups);
6769 b->next = bpt->next;
6773 ALL_BP_LOCATIONS (loc)
6774 if (loc->next == bpt->loc)
6776 loc->next = bpt->loc->next;
6780 check_duplicates (bpt);
6781 /* If this breakpoint was inserted, and there is another breakpoint
6782 at the same address, we need to insert the other breakpoint. */
6783 if (bpt->loc->inserted
6784 && bpt->type != bp_hardware_watchpoint
6785 && bpt->type != bp_read_watchpoint
6786 && bpt->type != bp_access_watchpoint
6787 && bpt->type != bp_catch_fork
6788 && bpt->type != bp_catch_vfork
6789 && bpt->type != bp_catch_exec)
6792 if (b->loc->address == bpt->loc->address
6793 && b->loc->section == bpt->loc->section
6794 && !b->loc->duplicate
6795 && b->enable_state != bp_disabled
6796 && b->enable_state != bp_shlib_disabled
6798 && b->enable_state != bp_call_disabled)
6802 /* We should never reach this point if there is a permanent
6803 breakpoint at the same address as the one being deleted.
6804 If there is a permanent breakpoint somewhere, it should
6805 always be the only one inserted. */
6806 if (b->enable_state == bp_permanent)
6807 internal_error (__FILE__, __LINE__,
6808 "another breakpoint was inserted on top of "
6809 "a permanent breakpoint");
6811 if (b->type == bp_hardware_breakpoint)
6812 val = target_insert_hw_breakpoint (b->loc->address, b->loc->shadow_contents);
6814 val = target_insert_breakpoint (b->loc->address, b->loc->shadow_contents);
6816 /* If there was an error in the insert, print a message, then stop execution. */
6819 struct ui_file *tmp_error_stream = mem_fileopen ();
6820 make_cleanup_ui_file_delete (tmp_error_stream);
6823 if (b->type == bp_hardware_breakpoint)
6825 fprintf_unfiltered (tmp_error_stream,
6826 "Cannot insert hardware breakpoint %d.\n"
6827 "You may have requested too many hardware breakpoints.\n",
6832 fprintf_unfiltered (tmp_error_stream, "Cannot insert breakpoint %d.\n", b->number);
6833 fprintf_filtered (tmp_error_stream, "Error accessing memory address ");
6834 print_address_numeric (b->loc->address, 1, tmp_error_stream);
6835 fprintf_filtered (tmp_error_stream, ": %s.\n",
6836 safe_strerror (val));
6839 fprintf_unfiltered (tmp_error_stream,"The same program may be running in another process.");
6840 target_terminal_ours_for_output ();
6841 error_stream(tmp_error_stream);
6844 b->loc->inserted = 1;
6848 free_command_lines (&bpt->commands);
6851 if (bpt->cond_string != NULL)
6852 xfree (bpt->cond_string);
6853 if (bpt->addr_string != NULL)
6854 xfree (bpt->addr_string);
6855 if (bpt->exp != NULL)
6857 if (bpt->exp_string != NULL)
6858 xfree (bpt->exp_string);
6859 if (bpt->val != NULL)
6860 value_free (bpt->val);
6861 if (bpt->source_file != NULL)
6862 xfree (bpt->source_file);
6863 if (bpt->dll_pathname != NULL)
6864 xfree (bpt->dll_pathname);
6865 if (bpt->triggered_dll_pathname != NULL)
6866 xfree (bpt->triggered_dll_pathname);
6867 if (bpt->exec_pathname != NULL)
6868 xfree (bpt->exec_pathname);
6870 /* Be sure no bpstat's are pointing at it after it's been freed. */
6871 /* FIXME, how can we find all bpstat's?
6872 We just check stop_bpstat for now. */
6873 for (bs = stop_bpstat; bs; bs = bs->next)
6874 if (bs->breakpoint_at == bpt)
6876 bs->breakpoint_at = NULL;
6878 /* bs->commands will be freed later. */
6880 /* On the chance that someone will soon try again to delete this same
6881 bp, we mark it as deleted before freeing its storage. */
6882 bpt->type = bp_none;
6889 do_delete_breakpoint_cleanup (void *b)
6891 delete_breakpoint (b);
6895 make_cleanup_delete_breakpoint (struct breakpoint *b)
6897 return make_cleanup (do_delete_breakpoint_cleanup, b);
6901 make_exec_cleanup_delete_breakpoint (struct breakpoint *b)
6903 return make_exec_cleanup (do_delete_breakpoint_cleanup, b);
6907 delete_command (char *arg, int from_tty)
6909 struct breakpoint *b, *temp;
6915 int breaks_to_delete = 0;
6917 /* Delete all breakpoints if no argument.
6918 Do not delete internal or call-dummy breakpoints, these
6919 have to be deleted with an explicit breakpoint number argument. */
6922 if (b->type != bp_call_dummy &&
6923 b->type != bp_shlib_event &&
6924 b->type != bp_thread_event &&
6925 b->type != bp_overlay_event &&
6927 breaks_to_delete = 1;
6930 /* Ask user only if there are some breakpoints to delete. */
6932 || (breaks_to_delete && query ("Delete all breakpoints? ")))
6934 ALL_BREAKPOINTS_SAFE (b, temp)
6936 if (b->type != bp_call_dummy &&
6937 b->type != bp_shlib_event &&
6938 b->type != bp_thread_event &&
6939 b->type != bp_overlay_event &&
6941 delete_breakpoint (b);
6946 map_breakpoint_numbers (arg, delete_breakpoint);
6949 /* Reset a breakpoint given it's struct breakpoint * BINT.
6950 The value we return ends up being the return value from catch_errors.
6951 Unused in this case. */
6954 breakpoint_re_set_one (void *bint)
6956 /* get past catch_errs */
6957 struct breakpoint *b = (struct breakpoint *) bint;
6961 int *not_found_ptr = NULL;
6962 struct symtabs_and_lines sals;
6964 enum enable_state save_enable;
6969 warning ("attempted to reset apparently deleted breakpoint #%d?",
6973 case bp_hardware_breakpoint:
6975 case bp_catch_unload:
6976 if (b->addr_string == NULL)
6978 /* Anything without a string can't be re-set. */
6979 delete_breakpoint (b);
6982 /* HACK: cagney/2001-11-11: kettenis/2001-11-11: MarkK wrote:
6984 ``And a hack it is, although Apple's Darwin version of GDB
6985 contains an almost identical hack to implement a "future
6986 break" command. It seems to work in many real world cases,
6987 but it is easy to come up with a test case where the patch
6988 doesn't help at all.''
6990 ``It seems that the way GDB implements breakpoints - in -
6991 shared - libraries was designed for a.out shared library
6992 systems (SunOS 4) where shared libraries were loaded at a
6993 fixed address in memory. Since ELF shared libraries can (and
6994 will) be loaded at any address in memory, things break.
6995 Fixing this is not trivial. Therefore, I'm not sure whether
6996 we should add this hack to the branch only. I cannot
6997 guarantee that things will be fixed on the trunk in the near
7000 In case we have a problem, disable this breakpoint. We'll
7001 restore its status if we succeed. Don't disable a
7002 shlib_disabled breakpoint though. There's a fair chance we
7003 can't re-set it if the shared library it's in hasn't been
7009 save_enable = b->enable_state;
7010 if (b->enable_state != bp_shlib_disabled)
7011 b->enable_state = bp_disabled;
7013 /* If resetting a shlib-disabled breakpoint, we don't want to
7014 see an error message if it is not found since we will expect
7015 this to occur until the shared library is finally reloaded.
7016 We accomplish this by giving decode_line_1 a pointer to use
7017 for silent notification that the symbol is not found. */
7018 not_found_ptr = ¬_found;
7020 set_language (b->language);
7021 input_radix = b->input_radix;
7023 sals = decode_line_1 (&s, 1, (struct symtab *) NULL, 0, (char ***) NULL,
7025 for (i = 0; i < sals.nelts; i++)
7027 resolve_sal_pc (&sals.sals[i]);
7029 /* Reparse conditions, they might contain references to the
7031 if (b->cond_string != NULL)
7037 /* Avoid re-freeing b->exp if an error during the call
7041 b->cond = parse_exp_1 (&s, block_for_pc (sals.sals[i].pc), 0);
7044 /* We need to re-set the breakpoint if the address changes... */
7045 if (b->loc->address != sals.sals[i].pc
7046 /* ...or new and old breakpoints both have source files, and
7047 the source file name or the line number changes... */
7048 || (b->source_file != NULL
7049 && sals.sals[i].symtab != NULL
7050 && (strcmp (b->source_file, sals.sals[i].symtab->filename) != 0
7051 || b->line_number != sals.sals[i].line)
7053 /* ...or we switch between having a source file and not having
7055 || ((b->source_file == NULL) != (sals.sals[i].symtab == NULL))
7058 if (b->source_file != NULL)
7059 xfree (b->source_file);
7060 if (sals.sals[i].symtab == NULL)
7061 b->source_file = NULL;
7064 savestring (sals.sals[i].symtab->filename,
7065 strlen (sals.sals[i].symtab->filename));
7066 b->line_number = sals.sals[i].line;
7067 b->loc->requested_address = sals.sals[i].pc;
7069 = adjust_breakpoint_address (b->loc->requested_address,
7072 /* Used to check for duplicates here, but that can
7073 cause trouble, as it doesn't check for disabled
7078 /* Might be better to do this just once per breakpoint_re_set,
7079 rather than once for every breakpoint. */
7080 breakpoints_changed ();
7082 b->loc->section = sals.sals[i].section;
7083 b->enable_state = save_enable; /* Restore it, this worked. */
7086 /* Now that this is re-enabled, check_duplicates
7088 check_duplicates (b);
7095 case bp_hardware_watchpoint:
7096 case bp_read_watchpoint:
7097 case bp_access_watchpoint:
7098 innermost_block = NULL;
7099 /* The issue arises of what context to evaluate this in. The
7100 same one as when it was set, but what does that mean when
7101 symbols have been re-read? We could save the filename and
7102 functionname, but if the context is more local than that, the
7103 best we could do would be something like how many levels deep
7104 and which index at that particular level, but that's going to
7105 be less stable than filenames or function names. */
7107 /* So for now, just use a global context. */
7111 /* Avoid re-freeing b->exp if an error during the call to
7112 parse_expression. */
7115 b->exp = parse_expression (b->exp_string);
7116 b->exp_valid_block = innermost_block;
7117 mark = value_mark ();
7120 value_free (b->val);
7121 /* Avoid re-freeing b->val if an error during the call to
7122 evaluate_expression. */
7125 b->val = evaluate_expression (b->exp);
7126 release_value (b->val);
7127 if (VALUE_LAZY (b->val) && breakpoint_enabled (b))
7128 value_fetch_lazy (b->val);
7130 if (b->cond_string != NULL)
7136 /* Avoid re-freeing b->exp if an error during the call
7140 b->cond = parse_exp_1 (&s, (struct block *) 0, 0);
7142 if (breakpoint_enabled (b))
7144 value_free_to_mark (mark);
7146 case bp_catch_catch:
7147 case bp_catch_throw:
7149 /* We needn't really do anything to reset these, since the mask
7150 that requests them is unaffected by e.g., new libraries being
7153 case bp_catch_vfork:
7158 printf_filtered ("Deleting unknown breakpoint type %d\n", b->type);
7160 /* Delete longjmp and overlay event breakpoints; they will be
7161 reset later by breakpoint_re_set. */
7163 case bp_longjmp_resume:
7164 case bp_overlay_event:
7165 delete_breakpoint (b);
7168 /* This breakpoint is special, it's set up when the inferior
7169 starts and we really don't want to touch it. */
7170 case bp_shlib_event:
7172 /* Like bp_shlib_event, this breakpoint type is special.
7173 Once it is set up, we do not want to touch it. */
7174 case bp_thread_event:
7176 /* Keep temporary breakpoints, which can be encountered when we step
7177 over a dlopen call and SOLIB_ADD is resetting the breakpoints.
7178 Otherwise these should have been blown away via the cleanup chain
7179 or by breakpoint_init_inferior when we rerun the executable. */
7182 case bp_watchpoint_scope:
7184 case bp_step_resume:
7191 /* Re-set all breakpoints after symbols have been re-loaded. */
7193 breakpoint_re_set (void)
7195 struct breakpoint *b, *temp;
7196 enum language save_language;
7197 int save_input_radix;
7199 save_language = current_language->la_language;
7200 save_input_radix = input_radix;
7201 ALL_BREAKPOINTS_SAFE (b, temp)
7203 /* Format possible error msg */
7204 char *message = xstrprintf ("Error in re-setting breakpoint %d:\n",
7206 struct cleanup *cleanups = make_cleanup (xfree, message);
7207 catch_errors (breakpoint_re_set_one, b, message, RETURN_MASK_ALL);
7208 do_cleanups (cleanups);
7210 set_language (save_language);
7211 input_radix = save_input_radix;
7213 if (GET_LONGJMP_TARGET_P ())
7215 create_longjmp_breakpoint ("longjmp");
7216 create_longjmp_breakpoint ("_longjmp");
7217 create_longjmp_breakpoint ("siglongjmp");
7218 create_longjmp_breakpoint ("_siglongjmp");
7219 create_longjmp_breakpoint (NULL);
7222 create_overlay_event_breakpoint ("_ovly_debug_event");
7225 /* Reset the thread number of this breakpoint:
7227 - If the breakpoint is for all threads, leave it as-is.
7228 - Else, reset it to the current thread for inferior_ptid. */
7230 breakpoint_re_set_thread (struct breakpoint *b)
7232 if (b->thread != -1)
7234 if (in_thread_list (inferior_ptid))
7235 b->thread = pid_to_thread_id (inferior_ptid);
7239 /* Set ignore-count of breakpoint number BPTNUM to COUNT.
7240 If from_tty is nonzero, it prints a message to that effect,
7241 which ends with a period (no newline). */
7244 set_ignore_count (int bptnum, int count, int from_tty)
7246 struct breakpoint *b;
7252 if (b->number == bptnum)
7254 b->ignore_count = count;
7258 printf_filtered ("Will stop next time breakpoint %d is reached.",
7260 else if (count == 1)
7261 printf_filtered ("Will ignore next crossing of breakpoint %d.",
7264 printf_filtered ("Will ignore next %d crossings of breakpoint %d.",
7267 breakpoints_changed ();
7268 breakpoint_modify_event (b->number);
7272 error ("No breakpoint number %d.", bptnum);
7275 /* Clear the ignore counts of all breakpoints. */
7277 breakpoint_clear_ignore_counts (void)
7279 struct breakpoint *b;
7282 b->ignore_count = 0;
7285 /* Command to set ignore-count of breakpoint N to COUNT. */
7288 ignore_command (char *args, int from_tty)
7294 error_no_arg ("a breakpoint number");
7296 num = get_number (&p);
7298 error ("bad breakpoint number: '%s'", args);
7300 error ("Second argument (specified ignore-count) is missing.");
7302 set_ignore_count (num,
7303 longest_to_int (value_as_long (parse_and_eval (p))),
7306 printf_filtered ("\n");
7309 /* Call FUNCTION on each of the breakpoints
7310 whose numbers are given in ARGS. */
7313 map_breakpoint_numbers (char *args, void (*function) (struct breakpoint *))
7318 struct breakpoint *b, *tmp;
7322 error_no_arg ("one or more breakpoint numbers");
7329 num = get_number_or_range (&p1);
7332 warning ("bad breakpoint number at or near '%s'", p);
7336 ALL_BREAKPOINTS_SAFE (b, tmp)
7337 if (b->number == num)
7339 struct breakpoint *related_breakpoint = b->related_breakpoint;
7342 if (related_breakpoint)
7343 function (related_breakpoint);
7347 printf_unfiltered ("No breakpoint number %d.\n", num);
7353 /* Set ignore-count of breakpoint number BPTNUM to COUNT.
7354 If from_tty is nonzero, it prints a message to that effect,
7355 which ends with a period (no newline). */
7358 disable_breakpoint (struct breakpoint *bpt)
7360 /* Never disable a watchpoint scope breakpoint; we want to
7361 hit them when we leave scope so we can delete both the
7362 watchpoint and its scope breakpoint at that time. */
7363 if (bpt->type == bp_watchpoint_scope)
7366 /* You can't disable permanent breakpoints. */
7367 if (bpt->enable_state == bp_permanent)
7370 bpt->enable_state = bp_disabled;
7372 check_duplicates (bpt);
7374 if (deprecated_modify_breakpoint_hook)
7375 deprecated_modify_breakpoint_hook (bpt);
7376 breakpoint_modify_event (bpt->number);
7380 disable_command (char *args, int from_tty)
7382 struct breakpoint *bpt;
7384 ALL_BREAKPOINTS (bpt)
7388 warning ("attempted to disable apparently deleted breakpoint #%d?",
7393 case bp_catch_unload:
7395 case bp_catch_vfork:
7397 case bp_catch_catch:
7398 case bp_catch_throw:
7399 case bp_hardware_breakpoint:
7401 case bp_hardware_watchpoint:
7402 case bp_read_watchpoint:
7403 case bp_access_watchpoint:
7404 disable_breakpoint (bpt);
7409 map_breakpoint_numbers (args, disable_breakpoint);
7413 do_enable_breakpoint (struct breakpoint *bpt, enum bpdisp disposition)
7415 int target_resources_ok, other_type_used;
7418 if (bpt->type == bp_hardware_breakpoint)
7421 i = hw_breakpoint_used_count ();
7422 target_resources_ok =
7423 TARGET_CAN_USE_HARDWARE_WATCHPOINT (bp_hardware_breakpoint,
7425 if (target_resources_ok == 0)
7426 error ("No hardware breakpoint support in the target.");
7427 else if (target_resources_ok < 0)
7428 error ("Hardware breakpoints used exceeds limit.");
7433 if (bpt->enable_state != bp_enabled)
7435 /* When enabling a pending breakpoint, we need to check if the breakpoint
7436 is resolvable since shared libraries could have been loaded
7437 after the breakpoint was disabled. */
7438 breakpoints_changed ();
7439 if (resolve_pending_breakpoint (bpt) == GDB_RC_OK)
7441 delete_breakpoint (bpt);
7444 bpt->enable_state = bp_enabled;
7445 bpt->disposition = disposition;
7448 else /* Not a pending breakpoint. */
7450 if (bpt->enable_state != bp_permanent)
7451 bpt->enable_state = bp_enabled;
7452 bpt->disposition = disposition;
7453 check_duplicates (bpt);
7454 breakpoints_changed ();
7456 if (bpt->type == bp_watchpoint ||
7457 bpt->type == bp_hardware_watchpoint ||
7458 bpt->type == bp_read_watchpoint ||
7459 bpt->type == bp_access_watchpoint)
7461 struct frame_id saved_frame_id;
7463 saved_frame_id = get_frame_id (get_selected_frame (NULL));
7464 if (bpt->exp_valid_block != NULL)
7466 struct frame_info *fr =
7467 fr = frame_find_by_id (bpt->watchpoint_frame);
7471 Cannot enable watchpoint %d because the block in which its expression\n\
7472 is valid is not currently in scope.\n", bpt->number);
7473 bpt->enable_state = bp_disabled;
7479 value_free (bpt->val);
7480 mark = value_mark ();
7481 bpt->val = evaluate_expression (bpt->exp);
7482 release_value (bpt->val);
7483 if (VALUE_LAZY (bpt->val))
7484 value_fetch_lazy (bpt->val);
7486 if (bpt->type == bp_hardware_watchpoint ||
7487 bpt->type == bp_read_watchpoint ||
7488 bpt->type == bp_access_watchpoint)
7490 int i = hw_watchpoint_used_count (bpt->type, &other_type_used);
7491 int mem_cnt = can_use_hardware_watchpoint (bpt->val);
7493 /* Hack around 'unused var' error for some targets here */
7495 target_resources_ok = TARGET_CAN_USE_HARDWARE_WATCHPOINT (
7496 bpt->type, i + mem_cnt, other_type_used);
7497 /* we can consider of type is bp_hardware_watchpoint, convert to
7498 bp_watchpoint in the following condition */
7499 if (target_resources_ok < 0)
7502 Cannot enable watchpoint %d because target watch resources\n\
7503 have been allocated for other watchpoints.\n", bpt->number);
7504 bpt->enable_state = bp_disabled;
7505 value_free_to_mark (mark);
7510 select_frame (frame_find_by_id (saved_frame_id));
7511 value_free_to_mark (mark);
7515 if (deprecated_modify_breakpoint_hook)
7516 deprecated_modify_breakpoint_hook (bpt);
7517 breakpoint_modify_event (bpt->number);
7521 enable_breakpoint (struct breakpoint *bpt)
7523 do_enable_breakpoint (bpt, bpt->disposition);
7526 /* The enable command enables the specified breakpoints (or all defined
7527 breakpoints) so they once again become (or continue to be) effective
7528 in stopping the inferior. */
7531 enable_command (char *args, int from_tty)
7533 struct breakpoint *bpt;
7535 ALL_BREAKPOINTS (bpt)
7539 warning ("attempted to enable apparently deleted breakpoint #%d?",
7544 case bp_catch_unload:
7546 case bp_catch_vfork:
7548 case bp_catch_catch:
7549 case bp_catch_throw:
7550 case bp_hardware_breakpoint:
7552 case bp_hardware_watchpoint:
7553 case bp_read_watchpoint:
7554 case bp_access_watchpoint:
7555 enable_breakpoint (bpt);
7560 map_breakpoint_numbers (args, enable_breakpoint);
7564 enable_once_breakpoint (struct breakpoint *bpt)
7566 do_enable_breakpoint (bpt, disp_disable);
7570 enable_once_command (char *args, int from_tty)
7572 map_breakpoint_numbers (args, enable_once_breakpoint);
7576 enable_delete_breakpoint (struct breakpoint *bpt)
7578 do_enable_breakpoint (bpt, disp_del);
7582 enable_delete_command (char *args, int from_tty)
7584 map_breakpoint_numbers (args, enable_delete_breakpoint);
7588 set_breakpoint_cmd (char *args, int from_tty)
7593 show_breakpoint_cmd (char *args, int from_tty)
7597 /* Use default_breakpoint_'s, or nothing if they aren't valid. */
7599 struct symtabs_and_lines
7600 decode_line_spec_1 (char *string, int funfirstline)
7602 struct symtabs_and_lines sals;
7604 error ("Empty line specification.");
7605 if (default_breakpoint_valid)
7606 sals = decode_line_1 (&string, funfirstline,
7607 default_breakpoint_symtab,
7608 default_breakpoint_line,
7609 (char ***) NULL, NULL);
7611 sals = decode_line_1 (&string, funfirstline,
7612 (struct symtab *) NULL, 0, (char ***) NULL, NULL);
7614 error ("Junk at end of line specification: %s", string);
7619 _initialize_breakpoint (void)
7621 static struct cmd_list_element *breakpoint_set_cmdlist;
7622 static struct cmd_list_element *breakpoint_show_cmdlist;
7623 struct cmd_list_element *c;
7626 observer_attach_solib_unloaded (disable_breakpoints_in_unloaded_shlib);
7629 breakpoint_chain = 0;
7630 /* Don't bother to call set_breakpoint_count. $bpnum isn't useful
7631 before a breakpoint is set. */
7632 breakpoint_count = 0;
7634 add_com ("ignore", class_breakpoint, ignore_command,
7635 "Set ignore-count of breakpoint number N to COUNT.\n\
7636 Usage is `ignore N COUNT'.");
7638 add_com_alias ("bc", "ignore", class_breakpoint, 1);
7640 add_com ("commands", class_breakpoint, commands_command,
7641 "Set commands to be executed when a breakpoint is hit.\n\
7642 Give breakpoint number as argument after \"commands\".\n\
7643 With no argument, the targeted breakpoint is the last one set.\n\
7644 The commands themselves follow starting on the next line.\n\
7645 Type a line containing \"end\" to indicate the end of them.\n\
7646 Give \"silent\" as the first line to make the breakpoint silent;\n\
7647 then no output is printed when it is hit, except what the commands print.");
7649 add_com ("condition", class_breakpoint, condition_command,
7650 "Specify breakpoint number N to break only if COND is true.\n\
7651 Usage is `condition N COND', where N is an integer and COND is an\n\
7652 expression to be evaluated whenever breakpoint N is reached.");
7654 c = add_com ("tbreak", class_breakpoint, tbreak_command,
7655 "Set a temporary breakpoint. Args like \"break\" command.\n\
7656 Like \"break\" except the breakpoint is only temporary,\n\
7657 so it will be deleted when hit. Equivalent to \"break\" followed\n\
7658 by using \"enable delete\" on the breakpoint number.");
7659 set_cmd_completer (c, location_completer);
7661 c = add_com ("hbreak", class_breakpoint, hbreak_command,
7662 "Set a hardware assisted breakpoint. Args like \"break\" command.\n\
7663 Like \"break\" except the breakpoint requires hardware support,\n\
7664 some target hardware may not have this support.");
7665 set_cmd_completer (c, location_completer);
7667 c = add_com ("thbreak", class_breakpoint, thbreak_command,
7668 "Set a temporary hardware assisted breakpoint. Args like \"break\" command.\n\
7669 Like \"hbreak\" except the breakpoint is only temporary,\n\
7670 so it will be deleted when hit.");
7671 set_cmd_completer (c, location_completer);
7673 add_prefix_cmd ("enable", class_breakpoint, enable_command,
7674 "Enable some breakpoints.\n\
7675 Give breakpoint numbers (separated by spaces) as arguments.\n\
7676 With no subcommand, breakpoints are enabled until you command otherwise.\n\
7677 This is used to cancel the effect of the \"disable\" command.\n\
7678 With a subcommand you can enable temporarily.",
7679 &enablelist, "enable ", 1, &cmdlist);
7681 add_com ("ab", class_breakpoint, enable_command,
7682 "Enable some breakpoints.\n\
7683 Give breakpoint numbers (separated by spaces) as arguments.\n\
7684 With no subcommand, breakpoints are enabled until you command otherwise.\n\
7685 This is used to cancel the effect of the \"disable\" command.\n\
7686 With a subcommand you can enable temporarily.");
7688 add_com_alias ("en", "enable", class_breakpoint, 1);
7690 add_abbrev_prefix_cmd ("breakpoints", class_breakpoint, enable_command,
7691 "Enable some breakpoints.\n\
7692 Give breakpoint numbers (separated by spaces) as arguments.\n\
7693 This is used to cancel the effect of the \"disable\" command.\n\
7694 May be abbreviated to simply \"enable\".\n",
7695 &enablebreaklist, "enable breakpoints ", 1, &enablelist);
7697 add_cmd ("once", no_class, enable_once_command,
7698 "Enable breakpoints for one hit. Give breakpoint numbers.\n\
7699 If a breakpoint is hit while enabled in this fashion, it becomes disabled.",
7702 add_cmd ("delete", no_class, enable_delete_command,
7703 "Enable breakpoints and delete when hit. Give breakpoint numbers.\n\
7704 If a breakpoint is hit while enabled in this fashion, it is deleted.",
7707 add_cmd ("delete", no_class, enable_delete_command,
7708 "Enable breakpoints and delete when hit. Give breakpoint numbers.\n\
7709 If a breakpoint is hit while enabled in this fashion, it is deleted.",
7712 add_cmd ("once", no_class, enable_once_command,
7713 "Enable breakpoints for one hit. Give breakpoint numbers.\n\
7714 If a breakpoint is hit while enabled in this fashion, it becomes disabled.",
7717 add_prefix_cmd ("disable", class_breakpoint, disable_command,
7718 "Disable some breakpoints.\n\
7719 Arguments are breakpoint numbers with spaces in between.\n\
7720 To disable all breakpoints, give no argument.\n\
7721 A disabled breakpoint is not forgotten, but has no effect until reenabled.",
7722 &disablelist, "disable ", 1, &cmdlist);
7723 add_com_alias ("dis", "disable", class_breakpoint, 1);
7724 add_com_alias ("disa", "disable", class_breakpoint, 1);
7726 add_com ("sb", class_breakpoint, disable_command,
7727 "Disable some breakpoints.\n\
7728 Arguments are breakpoint numbers with spaces in between.\n\
7729 To disable all breakpoints, give no argument.\n\
7730 A disabled breakpoint is not forgotten, but has no effect until reenabled.");
7732 add_cmd ("breakpoints", class_alias, disable_command,
7733 "Disable some breakpoints.\n\
7734 Arguments are breakpoint numbers with spaces in between.\n\
7735 To disable all breakpoints, give no argument.\n\
7736 A disabled breakpoint is not forgotten, but has no effect until reenabled.\n\
7737 This command may be abbreviated \"disable\".",
7740 add_prefix_cmd ("delete", class_breakpoint, delete_command,
7741 "Delete some breakpoints or auto-display expressions.\n\
7742 Arguments are breakpoint numbers with spaces in between.\n\
7743 To delete all breakpoints, give no argument.\n\
7745 Also a prefix command for deletion of other GDB objects.\n\
7746 The \"unset\" command is also an alias for \"delete\".",
7747 &deletelist, "delete ", 1, &cmdlist);
7748 add_com_alias ("d", "delete", class_breakpoint, 1);
7750 add_com ("db", class_breakpoint, delete_command,
7751 "Delete some breakpoints.\n\
7752 Arguments are breakpoint numbers with spaces in between.\n\
7753 To delete all breakpoints, give no argument.\n");
7755 add_cmd ("breakpoints", class_alias, delete_command,
7756 "Delete some breakpoints or auto-display expressions.\n\
7757 Arguments are breakpoint numbers with spaces in between.\n\
7758 To delete all breakpoints, give no argument.\n\
7759 This command may be abbreviated \"delete\".",
7762 add_com ("clear", class_breakpoint, clear_command,
7763 concat ("Clear breakpoint at specified line or function.\n\
7764 Argument may be line number, function name, or \"*\" and an address.\n\
7765 If line number is specified, all breakpoints in that line are cleared.\n\
7766 If function is specified, breakpoints at beginning of function are cleared.\n\
7767 If an address is specified, breakpoints at that address are cleared.\n\n",
7768 "With no argument, clears all breakpoints in the line that the selected frame\n\
7771 See also the \"delete\" command which clears breakpoints by number.", NULL));
7773 c = add_com ("break", class_breakpoint, break_command,
7774 concat ("Set breakpoint at specified line or function.\n\
7775 Argument may be line number, function name, or \"*\" and an address.\n\
7776 If line number is specified, break at start of code for that line.\n\
7777 If function is specified, break at start of code for that function.\n\
7778 If an address is specified, break at that exact address.\n",
7779 "With no arg, uses current execution address of selected stack frame.\n\
7780 This is useful for breaking on return to a stack frame.\n\
7782 Multiple breakpoints at one place are permitted, and useful if conditional.\n\
7784 Do \"help breakpoints\" for info on other commands dealing with breakpoints.", NULL));
7785 set_cmd_completer (c, location_completer);
7787 add_com_alias ("b", "break", class_run, 1);
7788 add_com_alias ("br", "break", class_run, 1);
7789 add_com_alias ("bre", "break", class_run, 1);
7790 add_com_alias ("brea", "break", class_run, 1);
7794 add_com_alias ("ba", "break", class_breakpoint, 1);
7795 add_com_alias ("bu", "ubreak", class_breakpoint, 1);
7800 add_abbrev_prefix_cmd ("stop", class_breakpoint, stop_command,
7801 "Break in function/address or break at a line in the current file.",
7802 &stoplist, "stop ", 1, &cmdlist);
7803 add_cmd ("in", class_breakpoint, stopin_command,
7804 "Break in function or address.\n", &stoplist);
7805 add_cmd ("at", class_breakpoint, stopat_command,
7806 "Break at a line in the current file.\n", &stoplist);
7807 add_com ("status", class_info, breakpoints_info,
7808 concat ("Status of user-settable breakpoints, or breakpoint number NUMBER.\n\
7809 The \"Type\" column indicates one of:\n\
7810 \tbreakpoint - normal breakpoint\n\
7811 \twatchpoint - watchpoint\n\
7812 The \"Disp\" column contains one of \"keep\", \"del\", or \"dis\" to indicate\n\
7813 the disposition of the breakpoint after it gets hit. \"dis\" means that the\n\
7814 breakpoint will be disabled. The \"Address\" and \"What\" columns indicate the\n\
7815 address and file/line number respectively.\n\n",
7816 "Convenience variable \"$_\" and default examine address for \"x\"\n\
7817 are set to the address of the last breakpoint listed.\n\n\
7818 Convenience variable \"$bpnum\" contains the number of the last\n\
7819 breakpoint set.", NULL));
7822 add_info ("breakpoints", breakpoints_info,
7823 concat ("Status of user-settable breakpoints, or breakpoint number NUMBER.\n\
7824 The \"Type\" column indicates one of:\n\
7825 \tbreakpoint - normal breakpoint\n\
7826 \twatchpoint - watchpoint\n\
7827 The \"Disp\" column contains one of \"keep\", \"del\", or \"dis\" to indicate\n\
7828 the disposition of the breakpoint after it gets hit. \"dis\" means that the\n\
7829 breakpoint will be disabled. The \"Address\" and \"What\" columns indicate the\n\
7830 address and file/line number respectively.\n\n",
7831 "Convenience variable \"$_\" and default examine address for \"x\"\n\
7832 are set to the address of the last breakpoint listed.\n\n\
7833 Convenience variable \"$bpnum\" contains the number of the last\n\
7834 breakpoint set.", NULL));
7837 add_com ("lb", class_breakpoint, breakpoints_info,
7838 concat ("Status of user-settable breakpoints, or breakpoint number NUMBER.\n\
7839 The \"Type\" column indicates one of:\n\
7840 \tbreakpoint - normal breakpoint\n\
7841 \twatchpoint - watchpoint\n\
7842 The \"Disp\" column contains one of \"keep\", \"del\", or \"dis\" to indicate\n\
7843 the disposition of the breakpoint after it gets hit. \"dis\" means that the\n\
7844 breakpoint will be disabled. The \"Address\" and \"What\" columns indicate the\n\
7845 address and file/line number respectively.\n\n",
7846 "Convenience variable \"$_\" and default examine address for \"x\"\n\
7847 are set to the address of the last breakpoint listed.\n\n\
7848 Convenience variable \"$bpnum\" contains the number of the last\n\
7849 breakpoint set.", NULL));
7851 add_cmd ("breakpoints", class_maintenance, maintenance_info_breakpoints,
7852 concat ("Status of all breakpoints, or breakpoint number NUMBER.\n\
7853 The \"Type\" column indicates one of:\n\
7854 \tbreakpoint - normal breakpoint\n\
7855 \twatchpoint - watchpoint\n\
7856 \tlongjmp - internal breakpoint used to step through longjmp()\n\
7857 \tlongjmp resume - internal breakpoint at the target of longjmp()\n\
7858 \tuntil - internal breakpoint used by the \"until\" command\n\
7859 \tfinish - internal breakpoint used by the \"finish\" command\n",
7860 "The \"Disp\" column contains one of \"keep\", \"del\", or \"dis\" to indicate\n\
7861 the disposition of the breakpoint after it gets hit. \"dis\" means that the\n\
7862 breakpoint will be disabled. The \"Address\" and \"What\" columns indicate the\n\
7863 address and file/line number respectively.\n\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\
7867 breakpoint set.", NULL),
7868 &maintenanceinfolist);
7870 add_com ("catch", class_breakpoint, catch_command,
7871 "Set catchpoints to catch events.\n\
7872 Raised signals may be caught:\n\
7873 \tcatch signal - all signals\n\
7874 \tcatch signal <signame> - a particular signal\n\
7875 Raised exceptions may be caught:\n\
7876 \tcatch throw - all exceptions, when thrown\n\
7877 \tcatch throw <exceptname> - a particular exception, when thrown\n\
7878 \tcatch catch - all exceptions, when caught\n\
7879 \tcatch catch <exceptname> - a particular exception, when caught\n\
7880 Thread or process events may be caught:\n\
7881 \tcatch thread_start - any threads, just after creation\n\
7882 \tcatch thread_exit - any threads, just before expiration\n\
7883 \tcatch thread_join - any threads, just after joins\n\
7884 Process events may be caught:\n\
7885 \tcatch start - any processes, just after creation\n\
7886 \tcatch exit - any processes, just before expiration\n\
7887 \tcatch fork - calls to fork()\n\
7888 \tcatch vfork - calls to vfork()\n\
7889 \tcatch exec - calls to exec()\n\
7890 Dynamically-linked library events may be caught:\n\
7891 \tcatch load - loads of any library\n\
7892 \tcatch load <libname> - loads of a particular library\n\
7893 \tcatch unload - unloads of any library\n\
7894 \tcatch unload <libname> - unloads of a particular library\n\
7895 The act of your program's execution stopping may also be caught:\n\
7897 C++ exceptions may be caught:\n\
7898 \tcatch throw - all exceptions, when thrown\n\
7899 \tcatch catch - all exceptions, when caught\n\
7901 Do \"help set follow-fork-mode\" for info on debugging your program\n\
7902 after a fork or vfork is caught.\n\n\
7903 Do \"help breakpoints\" for info on other commands dealing with breakpoints.");
7905 add_com ("tcatch", class_breakpoint, tcatch_command,
7906 "Set temporary catchpoints to catch events.\n\
7907 Args like \"catch\" command.\n\
7908 Like \"catch\" except the catchpoint is only temporary,\n\
7909 so it will be deleted when hit. Equivalent to \"catch\" followed\n\
7910 by using \"enable delete\" on the catchpoint number.");
7912 c = add_com ("watch", class_breakpoint, watch_command,
7913 "Set a watchpoint for an expression.\n\
7914 A watchpoint stops execution of your program whenever the value of\n\
7915 an expression changes.");
7916 set_cmd_completer (c, location_completer);
7918 c = add_com ("rwatch", class_breakpoint, rwatch_command,
7919 "Set a read watchpoint for an expression.\n\
7920 A watchpoint stops execution of your program whenever the value of\n\
7921 an expression is read.");
7922 set_cmd_completer (c, location_completer);
7924 c = add_com ("awatch", class_breakpoint, awatch_command,
7925 "Set a watchpoint for an expression.\n\
7926 A watchpoint stops execution of your program whenever the value of\n\
7927 an expression is either read or written.");
7928 set_cmd_completer (c, location_completer);
7930 add_info ("watchpoints", breakpoints_info,
7931 "Synonym for ``info breakpoints''.");
7934 c = add_set_cmd ("can-use-hw-watchpoints", class_support, var_zinteger,
7935 (char *) &can_use_hw_watchpoints,
7936 "Set debugger's willingness to use watchpoint hardware.\n\
7937 If zero, gdb will not use hardware for new watchpoints, even if\n\
7938 such is available. (However, any hardware watchpoints that were\n\
7939 created before setting this to nonzero, will continue to use watchpoint\n\
7942 deprecated_add_show_from_set (c, &showlist);
7944 can_use_hw_watchpoints = 1;
7946 add_prefix_cmd ("breakpoint", class_maintenance, set_breakpoint_cmd, "\
7947 Breakpoint specific settings\n\
7948 Configure various breakpoint-specific variables such as\n\
7949 pending breakpoint behavior",
7950 &breakpoint_set_cmdlist, "set breakpoint ",
7951 0/*allow-unknown*/, &setlist);
7952 add_prefix_cmd ("breakpoint", class_maintenance, show_breakpoint_cmd, "\
7953 Breakpoint specific settings\n\
7954 Configure various breakpoint-specific variables such as\n\
7955 pending breakpoint behavior",
7956 &breakpoint_show_cmdlist, "show breakpoint ",
7957 0/*allow-unknown*/, &showlist);
7959 add_setshow_auto_boolean_cmd ("pending", no_class, &pending_break_support, "\
7960 Set debugger's behavior regarding pending breakpoints.", "\
7961 Show debugger's behavior regarding pending breakpoints.", "\
7962 If on, an unrecognized breakpoint location will cause gdb to create a\n\
7963 pending breakpoint. If off, an unrecognized breakpoint location results in\n\
7964 an error. If auto, an unrecognized breakpoint location results in a\n\
7965 user-query to see if a pending breakpoint should be created.", "\
7966 Debugger's behavior regarding pending breakpoints is %s.",
7968 &breakpoint_set_cmdlist,
7969 &breakpoint_show_cmdlist);
7971 pending_break_support = AUTO_BOOLEAN_AUTO;