* breakpoint.c (breakpoint_1): Support bp_call_dummy.
[external/binutils.git] / gdb / breakpoint.c
1 /* Everything about breakpoints, for GDB.
2    Copyright 1986, 1987, 1989, 1990, 1991, 1992 Free Software Foundation, Inc.
3
4 This file is part of GDB.
5
6 This program is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 2 of the License, or
9 (at your option) any later version.
10
11 This program is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14 GNU General Public License for more details.
15
16 You should have received a copy of the GNU General Public License
17 along with this program; if not, write to the Free Software
18 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.  */
19
20 #include "defs.h"
21 #include <ctype.h>
22 #include "symtab.h"
23 #include "frame.h"
24 #include "breakpoint.h"
25 #include "gdbtypes.h"
26 #include "expression.h"
27 #include "gdbcore.h"
28 #include "gdbcmd.h"
29 #include "value.h"
30 #include "ctype.h"
31 #include "command.h"
32 #include "inferior.h"
33 #include "target.h"
34 #include "language.h"
35 #include <string.h>
36 #include "demangle.h"
37
38 /* local function prototypes */
39
40 static void
41 catch_command_1 PARAMS ((char *, int, int));
42
43 static void
44 enable_delete_command PARAMS ((char *, int));
45
46 static void
47 enable_delete_breakpoint PARAMS ((struct breakpoint *));
48
49 static void
50 enable_once_command PARAMS ((char *, int));
51
52 static void
53 enable_once_breakpoint PARAMS ((struct breakpoint *));
54
55 static void
56 disable_command PARAMS ((char *, int));
57
58 static void
59 disable_breakpoint PARAMS ((struct breakpoint *));
60
61 static void
62 enable_command PARAMS ((char *, int));
63
64 static void
65 enable_breakpoint PARAMS ((struct breakpoint *));
66
67 static void
68 map_breakpoint_numbers PARAMS ((char *, void (*)(struct breakpoint *)));
69
70 static void
71 ignore_command PARAMS ((char *, int));
72
73 static int
74 breakpoint_re_set_one PARAMS ((char *));
75
76 static void
77 delete_command PARAMS ((char *, int));
78
79 static void
80 clear_command PARAMS ((char *, int));
81
82 static void
83 catch_command PARAMS ((char *, int));
84
85 static struct symtabs_and_lines
86 get_catch_sals PARAMS ((int));
87
88 static void
89 watch_command PARAMS ((char *, int));
90
91 static void
92 tbreak_command PARAMS ((char *, int));
93
94 static void
95 break_command_1 PARAMS ((char *, int, int));
96
97 static void
98 mention PARAMS ((struct breakpoint *));
99
100 static struct breakpoint *
101 set_raw_breakpoint PARAMS ((struct symtab_and_line));
102
103 static void
104 check_duplicates PARAMS ((CORE_ADDR));
105
106 static void
107 describe_other_breakpoints PARAMS ((CORE_ADDR));
108
109 static void
110 breakpoints_info PARAMS ((char *, int));
111
112 static void
113 breakpoint_1 PARAMS ((int, int));
114
115 static bpstat
116 bpstat_alloc PARAMS ((struct breakpoint *, bpstat));
117
118 static int
119 breakpoint_cond_eval PARAMS ((char *));
120
121 static void
122 cleanup_executing_breakpoints PARAMS ((int));
123
124 static void
125 commands_command PARAMS ((char *, int));
126
127 static void
128 condition_command PARAMS ((char *, int));
129
130 static int
131 get_number PARAMS ((char **));
132
133 static void
134 set_breakpoint_count PARAMS ((int));
135
136
137 extern int addressprint;                /* Print machine addresses? */
138 extern int demangle;                    /* Print de-mangled symbol names? */
139
140 /* Are we executing breakpoint commands?  */
141 static int executing_breakpoint_commands;
142
143 /* Walk the following statement or block through all breakpoints.
144    ALL_BREAKPOINTS_SAFE does so even if the statment deletes the current
145    breakpoint.  */
146
147 #define ALL_BREAKPOINTS(b)  for (b = breakpoint_chain; b; b = b->next)
148
149 #define ALL_BREAKPOINTS_SAFE(b,tmp)     \
150         for (b = breakpoint_chain;      \
151              b? (tmp=b->next, 1): 0;    \
152              b = tmp)
153
154 /* Chain of all breakpoints defined.  */
155
156 struct breakpoint *breakpoint_chain;
157
158 /* Number of last breakpoint made.  */
159
160 static int breakpoint_count;
161
162 /* Set breakpoint count to NUM.  */
163 static void
164 set_breakpoint_count (num)
165      int num;
166 {
167   breakpoint_count = num;
168   set_internalvar (lookup_internalvar ("bpnum"),
169                    value_from_longest (builtin_type_int, (LONGEST) num));
170 }
171
172 /* Default address, symtab and line to put a breakpoint at
173    for "break" command with no arg.
174    if default_breakpoint_valid is zero, the other three are
175    not valid, and "break" with no arg is an error.
176
177    This set by print_stack_frame, which calls set_default_breakpoint.  */
178
179 int default_breakpoint_valid;
180 CORE_ADDR default_breakpoint_address;
181 struct symtab *default_breakpoint_symtab;
182 int default_breakpoint_line;
183
184 /* Flag indicating extra verbosity for xgdb.  */
185 extern int xgdb_verbose;
186 \f
187 /* *PP is a string denoting a breakpoint.  Get the number of the breakpoint.
188    Advance *PP after the string and any trailing whitespace.
189
190    Currently the string can either be a number or "$" followed by the name
191    of a convenience variable.  Making it an expression wouldn't work well
192    for map_breakpoint_numbers (e.g. "4 + 5 + 6").  */
193 static int
194 get_number (pp)
195      char **pp;
196 {
197   int retval;
198   char *p = *pp;
199
200   if (p == NULL)
201     /* Empty line means refer to the last breakpoint.  */
202     return breakpoint_count;
203   else if (*p == '$')
204     {
205       /* Make a copy of the name, so we can null-terminate it
206          to pass to lookup_internalvar().  */
207       char *varname;
208       char *start = ++p;
209       value val;
210
211       while (isalnum (*p) || *p == '_')
212         p++;
213       varname = (char *) alloca (p - start + 1);
214       strncpy (varname, start, p - start);
215       varname[p - start] = '\0';
216       val = value_of_internalvar (lookup_internalvar (varname));
217       if (TYPE_CODE (VALUE_TYPE (val)) != TYPE_CODE_INT)
218         error (
219 "Convenience variables used to specify breakpoints must have integer values."
220                );
221       retval = (int) value_as_long (val);
222     }
223   else
224     {
225       if (*p == '-')
226         ++p;
227       while (*p >= '0' && *p <= '9')
228         ++p;
229       if (p == *pp)
230         /* There is no number here.  (e.g. "cond a == b").  */
231         error_no_arg ("breakpoint number");
232       retval = atoi (*pp);
233     }
234   if (!(isspace (*p) || *p == '\0'))
235     error ("breakpoint number expected");
236   while (isspace (*p))
237     p++;
238   *pp = p;
239   return retval;
240 }
241 \f
242 /* condition N EXP -- set break condition of breakpoint N to EXP.  */
243
244 static void
245 condition_command (arg, from_tty)
246      char *arg;
247      int from_tty;
248 {
249   register struct breakpoint *b;
250   char *p;
251   register int bnum;
252
253   if (arg == 0)
254     error_no_arg ("breakpoint number");
255
256   p = arg;
257   bnum = get_number (&p);
258
259   ALL_BREAKPOINTS (b)
260     if (b->number == bnum)
261       {
262         if (b->cond)
263           {
264             free ((PTR)b->cond);
265             b->cond = 0;
266           }
267         if (b->cond_string != NULL)
268           free ((PTR)b->cond_string);
269
270         if (*p == 0)
271           {
272             b->cond = 0;
273             b->cond_string = NULL;
274             if (from_tty)
275               printf_filtered ("Breakpoint %d now unconditional.\n", bnum);
276           }
277         else
278           {
279             arg = p;
280             /* I don't know if it matters whether this is the string the user
281                typed in or the decompiled expression.  */
282             b->cond_string = savestring (arg, strlen (arg));
283             b->cond = parse_exp_1 (&arg, block_for_pc (b->address), 0);
284             if (*arg)
285               error ("Junk at end of expression");
286           }
287         return;
288       }
289
290   error ("No breakpoint number %d.", bnum);
291 }
292
293 /* ARGSUSED */
294 static void
295 commands_command (arg, from_tty)
296      char *arg;
297      int from_tty;
298 {
299   register struct breakpoint *b;
300   char *p;
301   register int bnum;
302   struct command_line *l;
303
304   /* If we allowed this, we would have problems with when to
305      free the storage, if we change the commands currently
306      being read from.  */
307
308   if (executing_breakpoint_commands)
309     error ("Can't use the \"commands\" command among a breakpoint's commands.");
310
311   p = arg;
312   bnum = get_number (&p);
313   if (p && *p)
314     error ("Unexpected extra arguments following breakpoint number.");
315       
316   ALL_BREAKPOINTS (b)
317     if (b->number == bnum)
318       {
319         if (from_tty && input_from_terminal_p ())
320           printf_filtered ("Type commands for when breakpoint %d is hit, one per line.\n\
321 End with a line saying just \"end\".\n", bnum);
322         l = read_command_lines ();
323         free_command_lines (&b->commands);
324         b->commands = l;
325         return;
326       }
327   error ("No breakpoint number %d.", bnum);
328 }
329 \f
330 extern int memory_breakpoint_size; /* from mem-break.c */
331
332 /* Like target_read_memory() but if breakpoints are inserted, return
333    the shadow contents instead of the breakpoints themselves.
334
335    Read "memory data" from whatever target or inferior we have. 
336    Returns zero if successful, errno value if not.  EIO is used
337    for address out of bounds.  If breakpoints are inserted, returns
338    shadow contents, not the breakpoints themselves.  From breakpoint.c.  */
339
340 int
341 read_memory_nobpt (memaddr, myaddr, len)
342      CORE_ADDR memaddr;
343      char *myaddr;
344      unsigned len;
345 {
346   int status;
347   struct breakpoint *b;
348
349   if (memory_breakpoint_size < 0)
350     /* No breakpoints on this machine.  FIXME: This should be
351        dependent on the debugging target.  Probably want
352        target_insert_breakpoint to return a size, saying how many
353        bytes of the shadow contents are used, or perhaps have
354        something like target_xfer_shadow.  */
355     return target_read_memory (memaddr, myaddr, len);
356   
357   ALL_BREAKPOINTS (b)
358     {
359       if (b->type == bp_watchpoint || !b->inserted)
360         continue;
361       else if (b->address + memory_breakpoint_size <= memaddr)
362         /* The breakpoint is entirely before the chunk of memory
363            we are reading.  */
364         continue;
365       else if (b->address >= memaddr + len)
366         /* The breakpoint is entirely after the chunk of memory we
367            are reading.  */
368         continue;
369       else
370         {
371           /* Copy the breakpoint from the shadow contents, and recurse
372              for the things before and after.  */
373           
374           /* Addresses and length of the part of the breakpoint that
375              we need to copy.  */
376           CORE_ADDR membpt = b->address;
377           unsigned int bptlen = memory_breakpoint_size;
378           /* Offset within shadow_contents.  */
379           int bptoffset = 0;
380           
381           if (membpt < memaddr)
382             {
383               /* Only copy the second part of the breakpoint.  */
384               bptlen -= memaddr - membpt;
385               bptoffset = memaddr - membpt;
386               membpt = memaddr;
387             }
388
389           if (membpt + bptlen > memaddr + len)
390             {
391               /* Only copy the first part of the breakpoint.  */
392               bptlen -= (membpt + bptlen) - (memaddr + len);
393             }
394
395           memcpy (myaddr + membpt - memaddr, 
396                   b->shadow_contents + bptoffset, bptlen);
397
398           if (membpt > memaddr)
399             {
400               /* Copy the section of memory before the breakpoint.  */
401               status = read_memory_nobpt (memaddr, myaddr, membpt - memaddr);
402               if (status != 0)
403                 return status;
404             }
405
406           if (membpt + bptlen < memaddr + len)
407             {
408               /* Copy the section of memory after the breakpoint.  */
409               status = read_memory_nobpt
410                 (membpt + bptlen,
411                  myaddr + membpt + bptlen - memaddr,
412                  memaddr + len - (membpt + bptlen));
413               if (status != 0)
414                 return status;
415             }
416           return 0;
417         }
418     }
419   /* Nothing overlaps.  Just call read_memory_noerr.  */
420   return target_read_memory (memaddr, myaddr, len);
421 }
422 \f
423 /* insert_breakpoints is used when starting or continuing the program.
424    remove_breakpoints is used when the program stops.
425    Both return zero if successful,
426    or an `errno' value if could not write the inferior.  */
427
428 int
429 insert_breakpoints ()
430 {
431   register struct breakpoint *b;
432   int val = 0;
433   int disabled_breaks = 0;
434
435   ALL_BREAKPOINTS (b)
436     if (b->type != bp_watchpoint
437         && b->enable != disabled
438         && ! b->inserted
439         && ! b->duplicate)
440       {
441         val = target_insert_breakpoint(b->address, b->shadow_contents);
442         if (val)
443           {
444             /* Can't set the breakpoint.  */
445 #if defined (DISABLE_UNSETTABLE_BREAK)
446             if (DISABLE_UNSETTABLE_BREAK (b->address))
447               {
448                 val = 0;
449                 b->enable = disabled;
450                 if (!disabled_breaks)
451                   {
452                     fprintf (stderr,
453                          "Cannot insert breakpoint %d:\n", b->number);
454                     printf_filtered ("Disabling shared library breakpoints:\n");
455                   }
456                 disabled_breaks = 1;
457                 printf_filtered ("%d ", b->number);
458               }
459             else
460 #endif
461               {
462                 fprintf (stderr, "Cannot insert breakpoint %d:\n", b->number);
463 #ifdef ONE_PROCESS_WRITETEXT
464                 fprintf (stderr,
465                   "The same program may be running in another process.\n");
466 #endif
467                 memory_error (val, b->address); /* which bombs us out */
468               }
469           }
470         else
471           b->inserted = 1;
472       }
473   if (disabled_breaks)
474     printf_filtered ("\n");
475   return val;
476 }
477
478 int
479 remove_breakpoints ()
480 {
481   register struct breakpoint *b;
482   int val;
483
484 #ifdef BREAKPOINT_DEBUG
485   printf ("Removing breakpoints.\n");
486 #endif /* BREAKPOINT_DEBUG */
487
488   ALL_BREAKPOINTS (b)
489     if (b->type != bp_watchpoint && b->inserted)
490       {
491         val = target_remove_breakpoint(b->address, b->shadow_contents);
492         if (val)
493           return val;
494         b->inserted = 0;
495 #ifdef BREAKPOINT_DEBUG
496         printf ("Removed breakpoint at %s",
497                 local_hex_string(b->address));
498         printf (", shadow %s",
499                 local_hex_string(b->shadow_contents[0]));
500         printf (", %s.\n",
501                 local_hex_string(b->shadow_contents[1]));
502 #endif /* BREAKPOINT_DEBUG */
503       }
504
505   return 0;
506 }
507
508 /* Clear the "inserted" flag in all breakpoints.
509    This is done when the inferior is loaded.  */
510
511 void
512 mark_breakpoints_out ()
513 {
514   register struct breakpoint *b;
515
516   ALL_BREAKPOINTS (b)
517     b->inserted = 0;
518 }
519
520 /* breakpoint_here_p (PC) returns 1 if an enabled breakpoint exists at PC.
521    When continuing from a location with a breakpoint,
522    we actually single step once before calling insert_breakpoints.  */
523
524 int
525 breakpoint_here_p (pc)
526      CORE_ADDR pc;
527 {
528   register struct breakpoint *b;
529
530   ALL_BREAKPOINTS (b)
531     if (b->enable != disabled && b->address == pc)
532       return 1;
533
534   return 0;
535 }
536 \f
537 /* bpstat stuff.  External routines' interfaces are documented
538    in breakpoint.h.  */
539
540 /* Clear a bpstat so that it says we are not at any breakpoint.
541    Also free any storage that is part of a bpstat.  */
542
543 void
544 bpstat_clear (bsp)
545      bpstat *bsp;
546 {
547   bpstat p;
548   bpstat q;
549
550   if (bsp == 0)
551     return;
552   p = *bsp;
553   while (p != NULL)
554     {
555       q = p->next;
556       if (p->old_val != NULL)
557         value_free (p->old_val);
558       free ((PTR)p);
559       p = q;
560     }
561   *bsp = NULL;
562 }
563
564 /* Return a copy of a bpstat.  Like "bs1 = bs2" but all storage that
565    is part of the bpstat is copied as well.  */
566
567 bpstat
568 bpstat_copy (bs)
569      bpstat bs;
570 {
571   bpstat p = NULL;
572   bpstat tmp;
573   bpstat retval = NULL;
574
575   if (bs == NULL)
576     return bs;
577
578   for (; bs != NULL; bs = bs->next)
579     {
580       tmp = (bpstat) xmalloc (sizeof (*tmp));
581       memcpy (tmp, bs, sizeof (*tmp));
582       if (p == NULL)
583         /* This is the first thing in the chain.  */
584         retval = tmp;
585       else
586         p->next = tmp;
587       p = tmp;
588     }
589   p->next = NULL;
590   return retval;
591 }
592
593 /* Find the bpstat associated with this breakpoint */
594
595 bpstat
596 bpstat_find_breakpoint(bsp, breakpoint)
597      bpstat bsp;
598      struct breakpoint *breakpoint;
599 {
600   if (bsp == NULL) return NULL;
601
602   for (;bsp != NULL; bsp = bsp->next) {
603     if (bsp->breakpoint_at == breakpoint) return bsp;
604   }
605   return NULL;
606 }
607
608 /* Return the breakpoint number of the first breakpoint we are stopped
609    at.  *BSP upon return is a bpstat which points to the remaining
610    breakpoints stopped at (but which is not guaranteed to be good for
611    anything but further calls to bpstat_num).
612    Return 0 if passed a bpstat which does not indicate any breakpoints.  */
613
614 int
615 bpstat_num (bsp)
616      bpstat *bsp;
617 {
618   struct breakpoint *b;
619
620   if ((*bsp) == NULL)
621     return 0;                   /* No more breakpoint values */
622   else
623     {
624       b = (*bsp)->breakpoint_at;
625       *bsp = (*bsp)->next;
626       if (b == NULL)
627         return -1;              /* breakpoint that's been deleted since */
628       else
629         return b->number;       /* We have its number */
630     }
631 }
632
633 /* Modify BS so that the actions will not be performed.  */
634
635 void
636 bpstat_clear_actions (bs)
637      bpstat bs;
638 {
639   for (; bs != NULL; bs = bs->next)
640     {
641       bs->commands = NULL;
642       if (bs->old_val != NULL)
643         {
644           value_free (bs->old_val);
645           bs->old_val = NULL;
646         }
647     }
648 }
649
650 /* Stub for cleaning up our state if we error-out of a breakpoint command */
651 /* ARGSUSED */
652 static void
653 cleanup_executing_breakpoints (ignore)
654      int ignore;
655 {
656   executing_breakpoint_commands = 0;
657 }
658
659 /* Execute all the commands associated with all the breakpoints at this
660    location.  Any of these commands could cause the process to proceed
661    beyond this point, etc.  We look out for such changes by checking
662    the global "breakpoint_proceeded" after each command.  */
663
664 void
665 bpstat_do_actions (bsp)
666      bpstat *bsp;
667 {
668   bpstat bs;
669   struct cleanup *old_chain;
670
671   executing_breakpoint_commands = 1;
672   old_chain = make_cleanup (cleanup_executing_breakpoints, 0);
673
674 top:
675   bs = *bsp;
676
677   breakpoint_proceeded = 0;
678   for (; bs != NULL; bs = bs->next)
679     {
680       while (bs->commands)
681         {
682           char *line = bs->commands->line;
683           bs->commands = bs->commands->next;
684           execute_command (line, 0);
685           /* If the inferior is proceeded by the command, bomb out now.
686              The bpstat chain has been blown away by wait_for_inferior.
687              But since execution has stopped again, there is a new bpstat
688              to look at, so start over.  */
689           if (breakpoint_proceeded)
690             goto top;
691         }
692     }
693
694   executing_breakpoint_commands = 0;
695   discard_cleanups (old_chain);
696 }
697
698 /* This is the normal print_it function for a bpstat.  In the future,
699    much of this logic could (should?) be moved to bpstat_stop_status,
700    by having it set different print_it functions.  */
701
702 static int
703 print_it_normal (bs)
704      bpstat bs;
705 {
706   /* bs->breakpoint_at can be NULL if it was a momentary breakpoint
707      which has since been deleted.  */
708   if (bs->breakpoint_at == NULL
709       || (bs->breakpoint_at->type != bp_breakpoint
710           && bs->breakpoint_at->type != bp_watchpoint))
711     return 0;
712
713   if (bs->breakpoint_at->type == bp_breakpoint)
714     {
715       /* I think the user probably only wants to see one breakpoint
716          number, not all of them.  */
717       printf_filtered ("\nBreakpoint %d, ", bs->breakpoint_at->number);
718       return 0;
719     }
720       
721   if (bs->old_val != NULL)
722     {
723       printf_filtered ("\nWatchpoint %d, ", bs->breakpoint_at->number);
724       print_expression (bs->breakpoint_at->exp, stdout);
725       printf_filtered ("\nOld value = ");
726       value_print (bs->old_val, stdout, 0, Val_pretty_default);
727       printf_filtered ("\nNew value = ");
728       value_print (bs->breakpoint_at->val, stdout, 0,
729                    Val_pretty_default);
730       printf_filtered ("\n");
731       value_free (bs->old_val);
732       bs->old_val = NULL;
733       return 0;
734     }
735   /* We can't deal with it.  Maybe another member of the bpstat chain can.  */
736   return -1;
737 }
738
739 /* Print a message indicating what happened.  Returns nonzero to
740    say that only the source line should be printed after this (zero
741    return means print the frame as well as the source line).  */
742 /* Currently we always return zero.  */
743 int
744 bpstat_print (bs)
745      bpstat bs;
746 {
747   int val;
748   
749   if (bs == NULL)
750     return 0;
751
752   val = (*bs->print_it) (bs);
753   if (val >= 0)
754     return val;
755   
756   /* Maybe another breakpoint in the chain caused us to stop.
757      (Currently all watchpoints go on the bpstat whether hit or
758      not.  That probably could (should) be changed, provided care is taken
759      with respect to bpstat_explains_signal).  */
760   if (bs->next)
761     return bpstat_print (bs->next);
762
763   /* We reached the end of the chain without printing anything.  */
764   return 0;
765 }
766
767 /* Evaluate the expression EXP and return 1 if value is zero.
768    This is used inside a catch_errors to evaluate the breakpoint condition. 
769    The argument is a "struct expression *" that has been cast to char * to 
770    make it pass through catch_errors.  */
771
772 static int
773 breakpoint_cond_eval (exp)
774      char *exp;
775 {
776   return !value_true (evaluate_expression ((struct expression *)exp));
777 }
778
779 /* Allocate a new bpstat and chain it to the current one.  */
780
781 static bpstat
782 bpstat_alloc (b, cbs)
783      register struct breakpoint *b;
784      bpstat cbs;                        /* Current "bs" value */
785 {
786   bpstat bs;
787
788   bs = (bpstat) xmalloc (sizeof (*bs));
789   cbs->next = bs;
790   bs->breakpoint_at = b;
791   /* If the condition is false, etc., don't do the commands.  */
792   bs->commands = NULL;
793   bs->old_val = NULL;
794   bs->print_it = print_it_normal;
795   return bs;
796 }
797 \f
798 /* Return the frame which we can use to evaluate the expression
799    whose valid block is valid_block, or NULL if not in scope.
800
801    This whole concept is probably not the way to do things (it is incredibly
802    slow being the main reason, not to mention fragile (e.g. the sparc
803    frame pointer being fetched as 0 bug causes it to stop)).  Instead,
804    introduce a version of "struct frame" which survives over calls to the
805    inferior, but which is better than FRAME_ADDR in the sense that it lets
806    us evaluate expressions relative to that frame (on some machines, it
807    can just be a FRAME_ADDR).  Save one of those instead of (or in addition
808    to) the exp_valid_block, and then use it to evaluate the watchpoint
809    expression, with no need to do all this backtracing every time.
810
811    Or better yet, what if it just copied the struct frame and its next
812    frame?  Off the top of my head, I would think that would work
813    because things like (a29k) rsize and msize, or (sparc) bottom just
814    depend on the frame, and aren't going to be different just because
815    the inferior has done something.  Trying to recalculate them
816    strikes me as a lot of work, possibly even impossible.  Saving the
817    next frame is needed at least on a29k, where get_saved_register
818    uses fi->next->saved_msp.  For figuring out whether that frame is
819    still on the stack, I guess this needs to be machine-specific (e.g.
820    a29k) but I think
821
822       read_fp () INNER_THAN watchpoint_frame->frame
823
824    would generally work.
825
826    Of course the scope of the expression could be less than a whole
827    function; perhaps if the innermost frame is the one which the
828    watchpoint is relative to (another machine-specific thing, usually
829
830       FRAMELESS_FUNCTION_INVOCATION (get_current_frame(), fromleaf)
831       read_fp () == wp_frame->frame
832       && !fromleaf
833
834    ), *then* it could do a
835
836       contained_in (get_current_block (), wp->exp_valid_block).
837
838       */
839
840 FRAME
841 within_scope (valid_block)
842      struct block *valid_block;
843 {
844   FRAME fr = get_current_frame ();
845   struct frame_info *fi = get_frame_info (fr);
846   CORE_ADDR func_start;
847
848   /* If caller_pc_valid is true, we are stepping through
849      a function prologue, which is bounded by callee_func_start
850      (inclusive) and callee_prologue_end (exclusive).
851      caller_pc is the pc of the caller.
852
853      Yes, this is hairy.  */
854   static int caller_pc_valid = 0;
855   static CORE_ADDR caller_pc;
856   static CORE_ADDR callee_func_start;
857   static CORE_ADDR callee_prologue_end;
858   
859   find_pc_partial_function (fi->pc, (PTR)NULL, &func_start, (CORE_ADDR *)NULL);
860   func_start += FUNCTION_START_OFFSET;
861   if (fi->pc == func_start)
862     {
863       /* We just called a function.  The only other case I
864          can think of where the pc would equal the pc of the
865          start of a function is a frameless function (i.e.
866          no prologue) where we branch back to the start
867          of the function.  In that case, SKIP_PROLOGUE won't
868          find one, and we'll clear caller_pc_valid a few lines
869          down.  */
870       caller_pc_valid = 1;
871       caller_pc = SAVED_PC_AFTER_CALL (fr);
872       callee_func_start = func_start;
873       SKIP_PROLOGUE (func_start);
874       callee_prologue_end = func_start;
875     }
876   if (caller_pc_valid)
877     {
878       if (fi->pc < callee_func_start
879           || fi->pc >= callee_prologue_end)
880         caller_pc_valid = 0;
881     }
882           
883   if (contained_in (block_for_pc (caller_pc_valid
884                                   ? caller_pc
885                                   : fi->pc),
886                     valid_block))
887     {
888       return fr;
889     }
890   fr = get_prev_frame (fr);
891           
892   /* If any active frame is in the exp_valid_block, then it's
893      OK.  Note that this might not be the same invocation of
894      the exp_valid_block that we were watching a little while
895      ago, or the same one as when the watchpoint was set (e.g.
896      we are watching a local variable in a recursive function.
897      When we return from a recursive invocation, then we are
898      suddenly watching a different instance of the variable).
899
900      At least for now I am going to consider this a feature.  */
901   for (; fr != NULL; fr = get_prev_frame (fr))
902     {
903       fi = get_frame_info (fr);
904       if (contained_in (block_for_pc (fi->pc),
905                         valid_block))
906         {
907           return fr;
908         }
909     }
910   return NULL;
911 }
912
913 /* Possible return values for watchpoint_check (this can't be an enum
914    because of check_errors).  */
915 /* The watchpoint has been disabled.  */
916 #define WP_DISABLED 1
917 /* The value has changed.  */
918 #define WP_VALUE_CHANGED 2
919 /* The value has not changed.  */
920 #define WP_VALUE_NOT_CHANGED 3
921
922 /* Check watchpoint condition.  */
923 static int
924 watchpoint_check (p)
925      char *p;
926 {
927   bpstat bs = (bpstat) p;
928   FRAME fr;
929
930   int within_current_scope;
931   if (bs->breakpoint_at->exp_valid_block == NULL)
932     within_current_scope = 1;
933   else
934     {
935       fr = within_scope (bs->breakpoint_at->exp_valid_block);
936       within_current_scope = fr != NULL;
937       if (within_current_scope)
938         /* If we end up stopping, the current frame will get selected
939            in normal_stop.  So this call to select_frame won't affect
940            the user.  */
941         select_frame (fr, -1);
942     }
943       
944   if (within_current_scope)
945     {
946       /* We use value_{,free_to_}mark because it could be a
947          *long* time before we return to the command level and
948          call free_all_values.  */
949       /* But couldn't we just call free_all_values instead?  */
950
951       value mark = value_mark ();
952       value new_val = evaluate_expression (bs->breakpoint_at->exp);
953       if (!value_equal (bs->breakpoint_at->val, new_val))
954         {
955           release_value (new_val);
956           value_free_to_mark (mark);
957           bs->old_val = bs->breakpoint_at->val;
958           bs->breakpoint_at->val = new_val;
959           /* We will stop here */
960           return WP_VALUE_CHANGED;
961         }
962       else
963         {
964           /* Nothing changed, don't do anything.  */
965           value_free_to_mark (mark);
966           /* We won't stop here */
967           return WP_VALUE_NOT_CHANGED;
968         }
969     }
970   else
971     {
972       /* This seems like the only logical thing to do because
973          if we temporarily ignored the watchpoint, then when
974          we reenter the block in which it is valid it contains
975          garbage (in the case of a function, it may have two
976          garbage values, one before and one after the prologue).
977          So we can't even detect the first assignment to it and
978          watch after that (since the garbage may or may not equal
979          the first value assigned).  */
980       bs->breakpoint_at->enable = disabled;
981       printf_filtered ("\
982 Watchpoint %d disabled because the program has left the block in\n\
983 which its expression is valid.\n", bs->breakpoint_at->number);
984       return WP_DISABLED;
985     }
986 }
987
988 /* This is used when everything which needs to be printed has
989    already been printed.  But we still want to print the frame.  */
990 static int
991 print_it_done (bs)
992      bpstat bs;
993 {
994   return 0;
995 }
996
997 /* This is used when nothing should be printed for this bpstat entry.  */
998
999 static int
1000 print_it_noop (bs)
1001      bpstat bs;
1002 {
1003   return -1;
1004 }
1005
1006 /* Determine whether we stopped at a breakpoint, etc, or whether we
1007    don't understand this stop.  Result is a chain of bpstat's such that:
1008
1009         if we don't understand the stop, the result is a null pointer.
1010
1011         if we understand why we stopped, the result is not null, and
1012         the first element of the chain contains summary "stop" and
1013         "print" flags for the whole chain.
1014
1015         Each element of the chain refers to a particular breakpoint or
1016         watchpoint at which we have stopped.  (We may have stopped for
1017         several reasons concurrently.)
1018
1019         Each element of the chain has valid next, breakpoint_at,
1020         commands, FIXME??? fields.
1021
1022  */
1023
1024         
1025 bpstat
1026 bpstat_stop_status (pc, frame_address)
1027      CORE_ADDR *pc;
1028      FRAME_ADDR frame_address;
1029 {
1030   register struct breakpoint *b;
1031   CORE_ADDR bp_addr;
1032 #if DECR_PC_AFTER_BREAK != 0 || defined (SHIFT_INST_REGS)
1033   /* True if we've hit a breakpoint (as opposed to a watchpoint).  */
1034   int real_breakpoint = 0;
1035 #endif
1036   /* Root of the chain of bpstat's */
1037   struct bpstat root_bs[1];
1038   /* Pointer to the last thing in the chain currently.  */
1039   bpstat bs = root_bs;
1040
1041   /* Get the address where the breakpoint would have been.  */
1042   bp_addr = *pc - DECR_PC_AFTER_BREAK;
1043
1044   ALL_BREAKPOINTS (b)
1045     {
1046       if (b->enable == disabled)
1047         continue;
1048
1049       if (b->type != bp_watchpoint && b->address != bp_addr)
1050         continue;
1051
1052       /* Come here if it's a watchpoint, or if the break address matches */
1053
1054       bs = bpstat_alloc (b, bs);        /* Alloc a bpstat to explain stop */
1055
1056       bs->stop = 1;
1057       bs->print = 1;
1058
1059       if (b->type == bp_watchpoint)
1060         {
1061           static char message1[] =
1062             "Error evaluating expression for watchpoint %d\n";
1063           char message[sizeof (message1) + 30 /* slop */];
1064           sprintf (message, message1, b->number);
1065           switch (catch_errors (watchpoint_check, (char *) bs, message,
1066                                 RETURN_MASK_ALL))
1067             {
1068             case WP_DISABLED:
1069               /* We've already printed what needs to be printed.  */
1070               bs->print_it = print_it_done;
1071               /* Stop.  */
1072               break;
1073             case WP_VALUE_CHANGED:
1074               /* Stop.  */
1075               break;
1076             case WP_VALUE_NOT_CHANGED:
1077               /* Don't stop.  */
1078               bs->print_it = print_it_noop;
1079               bs->stop = 0;
1080               continue;
1081             default:
1082               /* Can't happen.  */
1083               /* FALLTHROUGH */
1084             case 0:
1085               /* Error from catch_errors.  */
1086               b->enable = disabled;
1087               printf_filtered ("Watchpoint %d disabled.\n", b->number);
1088               /* We've already printed what needs to be printed.  */
1089               bs->print_it = print_it_done;
1090               /* Stop.  */
1091               break;
1092             }
1093         }
1094 #if DECR_PC_AFTER_BREAK != 0 || defined (SHIFT_INST_REGS)
1095       else
1096         real_breakpoint = 1;
1097 #endif
1098
1099       if (b->frame && b->frame != frame_address)
1100         bs->stop = 0;
1101       else
1102         {
1103           int value_is_zero = 0;
1104
1105           if (b->cond)
1106             {
1107               /* Need to select the frame, with all that implies
1108                  so that the conditions will have the right context.  */
1109               select_frame (get_current_frame (), 0);
1110               value_is_zero
1111                 = catch_errors (breakpoint_cond_eval, (char *)(b->cond),
1112                                 "Error in testing breakpoint condition:\n",
1113                                 RETURN_MASK_ALL);
1114                                 /* FIXME-someday, should give breakpoint # */
1115               free_all_values ();
1116             }
1117           if (b->cond && value_is_zero)
1118             {
1119               bs->stop = 0;
1120             }
1121           else if (b->ignore_count > 0)
1122             {
1123               b->ignore_count--;
1124               bs->stop = 0;
1125             }
1126           else
1127             {
1128               /* We will stop here */
1129               if (b->disposition == disable)
1130                 b->enable = disabled;
1131               bs->commands = b->commands;
1132               if (b->silent)
1133                 bs->print = 0;
1134               if (bs->commands && STREQ ("silent", bs->commands->line))
1135                 {
1136                   bs->commands = bs->commands->next;
1137                   bs->print = 0;
1138                 }
1139             }
1140         }
1141       /* Print nothing for this entry if we dont stop or if we dont print.  */
1142       if (bs->stop == 0 || bs->print == 0)
1143         bs->print_it = print_it_noop;
1144     }
1145
1146   bs->next = NULL;              /* Terminate the chain */
1147   bs = root_bs->next;           /* Re-grab the head of the chain */
1148 #if DECR_PC_AFTER_BREAK != 0 || defined (SHIFT_INST_REGS)
1149   if (bs)
1150     {
1151       if (real_breakpoint)
1152         {
1153           *pc = bp_addr;
1154 #if defined (SHIFT_INST_REGS)
1155           {
1156             CORE_ADDR pc = read_register (PC_REGNUM);
1157             CORE_ADDR npc = read_register (NPC_REGNUM);
1158             if (pc != npc)
1159               {
1160                 write_register (NNPC_REGNUM, npc);
1161                 write_register (NPC_REGNUM, pc);
1162               }
1163           }
1164 #else /* No SHIFT_INST_REGS.  */
1165           write_pc (bp_addr);
1166 #endif /* No SHIFT_INST_REGS.  */
1167         }
1168     }
1169 #endif /* DECR_PC_AFTER_BREAK != 0.  */
1170   return bs;
1171 }
1172 \f
1173 /* Tell what to do about this bpstat.  */
1174 struct bpstat_what
1175 bpstat_what (bs)
1176      bpstat bs;
1177 {
1178   /* Classify each bpstat as one of the following.  */
1179   enum class {
1180     /* This bpstat element has no effect on the main_action.  */
1181     no_effect = 0,
1182
1183     /* There was a watchpoint, stop but don't print.  */
1184     wp_silent,
1185
1186     /* There was a watchpoint, stop and print.  */
1187     wp_noisy,
1188
1189     /* There was a breakpoint but we're not stopping.  */
1190     bp_nostop,
1191
1192     /* There was a breakpoint, stop but don't print.  */
1193     bp_silent,
1194
1195     /* There was a breakpoint, stop and print.  */
1196     bp_noisy,
1197
1198     /* We hit the longjmp breakpoint.  */
1199     long_jump,
1200
1201     /* We hit the longjmp_resume breakpoint.  */
1202     long_resume,
1203
1204     /* This is just used to count how many enums there are.  */
1205     class_last
1206     };
1207
1208   /* Here is the table which drives this routine.  So that we can
1209      format it pretty, we define some abbreviations for the
1210      enum bpstat_what codes.  */
1211 #define keep_c BPSTAT_WHAT_KEEP_CHECKING
1212 #define stop_s BPSTAT_WHAT_STOP_SILENT
1213 #define stop_n BPSTAT_WHAT_STOP_NOISY
1214 #define single BPSTAT_WHAT_SINGLE
1215 #define setlr BPSTAT_WHAT_SET_LONGJMP_RESUME
1216 #define clrlr BPSTAT_WHAT_CLEAR_LONGJMP_RESUME
1217 #define clrlrs BPSTAT_WHAT_CLEAR_LONGJMP_RESUME_SINGLE
1218 /* "Can't happen."  Might want to print an error message.
1219    abort() is not out of the question, but chances are GDB is just
1220    a bit confused, not unusable.  */
1221 #define err BPSTAT_WHAT_STOP_NOISY
1222
1223   /* Given an old action and a class, come up with a new action.  */
1224   /* One interesting property of this table is that wp_silent is the same
1225      as bp_silent and wp_noisy is the same as bp_noisy.  That is because
1226      after stopping, the check for whether to step over a breakpoint
1227      (BPSTAT_WHAT_SINGLE type stuff) is handled in proceed() without
1228      reference to how we stopped.  We retain separate wp_silent and bp_silent
1229      codes in case we want to change that someday.  */
1230   static const enum bpstat_what_main_action
1231     table[(int)class_last][(int)BPSTAT_WHAT_LAST] =
1232       {
1233         /*                              old action */
1234         /*       keep_c  stop_s  stop_n  single  setlr   clrlr   clrlrs */
1235
1236 /*no_effect*/   {keep_c, stop_s, stop_n, single, setlr , clrlr , clrlrs},
1237 /*wp_silent*/   {stop_s, stop_s, stop_n, stop_s, stop_s, stop_s, stop_s},
1238 /*wp_noisy*/    {stop_n, stop_n, stop_n, stop_n, stop_n, stop_n, stop_n},
1239 /*bp_nostop*/   {single, stop_s, stop_n, single, setlr , clrlrs, clrlrs},
1240 /*bp_silent*/   {stop_s, stop_s, stop_n, stop_s, stop_s, stop_s, stop_s},
1241 /*bp_noisy*/    {stop_n, stop_n, stop_n, stop_n, stop_n, stop_n, stop_n},
1242 /*long_jump*/   {setlr , stop_s, stop_n, setlr , err   , err   , err   },
1243 /*long_resume*/ {clrlr , stop_s, stop_n, clrlrs, err   , err   , err   }
1244               };
1245 #undef keep_c
1246 #undef stop_s
1247 #undef stop_n
1248 #undef single
1249 #undef setlr
1250 #undef clrlr
1251 #undef clrlrs
1252 #undef err
1253   enum bpstat_what_main_action current_action = BPSTAT_WHAT_KEEP_CHECKING;
1254   struct bpstat_what retval;
1255
1256   for (; bs != NULL; bs = bs->next)
1257     {
1258       enum class bs_class = no_effect;
1259       if (bs->breakpoint_at == NULL)
1260         /* I suspect this can happen if it was a momentary breakpoint
1261            which has since been deleted.  */
1262         continue;
1263       switch (bs->breakpoint_at->type)
1264         {
1265         case bp_breakpoint:
1266         case bp_until:
1267         case bp_finish:
1268           if (bs->stop)
1269             {
1270               if (bs->print)
1271                 bs_class = bp_noisy;
1272               else
1273                 bs_class = bp_silent;
1274             }
1275           else
1276             bs_class = bp_nostop;
1277           break;
1278         case bp_watchpoint:
1279           if (bs->stop)
1280             {
1281               if (bs->print)
1282                 bs_class = wp_noisy;
1283               else
1284                 bs_class = wp_silent;
1285             }
1286           else
1287             /* There was a watchpoint, but we're not stopping.  This requires
1288                no further action.  */
1289             bs_class = no_effect;
1290           break;
1291         case bp_longjmp:
1292           bs_class = long_jump;
1293           break;
1294         case bp_longjmp_resume:
1295           bs_class = long_resume;
1296           break;
1297         case bp_step_resume:
1298 #if 0
1299           /* Need to temporarily disable this until we can fix the bug
1300              with nexting over a breakpoint with ->stop clear causing
1301              an infinite loop.  For now, treat the breakpoint as having
1302              been hit even if the frame is wrong.  */
1303           if (bs->stop)
1304             {
1305 #endif
1306               retval.step_resume = 1;
1307               /* We don't handle this via the main_action.  */
1308               bs_class = no_effect;
1309 #if 0
1310             }
1311           else
1312             /* It is for the wrong frame.  */
1313             bs_class = bp_nostop;
1314 #endif
1315           break;
1316         case bp_call_dummy:
1317           /* Make sure the action is stop (silent or noisy), so infrun.c
1318              pops the dummy frame.  */
1319           bs_class = bp_silent;
1320           retval.call_dummy = 1;
1321           break;
1322         }
1323       current_action = table[(int)bs_class][(int)current_action];
1324     }
1325   retval.main_action = current_action;
1326   return retval;
1327 }
1328
1329 /* Nonzero if we should step constantly (e.g. watchpoints on machines
1330    without hardware support).  This isn't related to a specific bpstat,
1331    just to things like whether watchpoints are set.  */
1332
1333 int 
1334 bpstat_should_step ()
1335 {
1336   struct breakpoint *b;
1337   ALL_BREAKPOINTS (b)
1338     if (b->enable == enabled && b->type == bp_watchpoint)
1339       return 1;
1340   return 0;
1341 }
1342 \f
1343 /* Print information on breakpoint number BNUM, or -1 if all.
1344    If WATCHPOINTS is zero, process only breakpoints; if WATCHPOINTS
1345    is nonzero, process only watchpoints.  */
1346
1347 static void
1348 breakpoint_1 (bnum, allflag)
1349      int bnum;
1350      int allflag;
1351 {
1352   register struct breakpoint *b;
1353   register struct command_line *l;
1354   register struct symbol *sym;
1355   CORE_ADDR last_addr = (CORE_ADDR)-1;
1356   int found_a_breakpoint = 0;
1357   static char *bptypes[] = {"breakpoint", "until", "finish", "watchpoint",
1358                               "longjmp", "longjmp resume", "step resume",
1359                               "call dummy" };
1360   static char *bpdisps[] = {"del", "dis", "keep"};
1361   static char bpenables[] = "ny";
1362   char wrap_indent[80];
1363
1364   ALL_BREAKPOINTS (b)
1365     if (bnum == -1
1366         || bnum == b->number)
1367       {
1368 /*  We only print out user settable breakpoints unless the allflag is set. */
1369         if (!allflag
1370             && b->type != bp_breakpoint
1371             && b->type != bp_watchpoint)
1372           continue;
1373
1374         if (!found_a_breakpoint++)
1375           printf_filtered ("Num Type           Disp Enb %sWhat\n",
1376                            addressprint ? "Address    " : "");
1377
1378         printf_filtered ("%-3d %-14s %-4s %-3c ",
1379                          b->number,
1380                          bptypes[(int)b->type],
1381                          bpdisps[(int)b->disposition],
1382                          bpenables[(int)b->enable]);
1383         strcpy (wrap_indent, "                           ");
1384         if (addressprint)
1385           strcat (wrap_indent, "           ");
1386         switch (b->type)
1387           {
1388           case bp_watchpoint:
1389             print_expression (b->exp, stdout);
1390             break;
1391
1392           case bp_breakpoint:
1393           case bp_until:
1394           case bp_finish:
1395           case bp_longjmp:
1396           case bp_longjmp_resume:
1397           case bp_step_resume:
1398           case bp_call_dummy:
1399             if (addressprint)
1400               printf_filtered ("%s ", local_hex_string_custom(b->address, "08"));
1401
1402             last_addr = b->address;
1403             if (b->source_file)
1404               {
1405                 sym = find_pc_function (b->address);
1406                 if (sym)
1407                   {
1408                     fputs_filtered ("in ", stdout);
1409                     fputs_filtered (SYMBOL_SOURCE_NAME (sym), stdout);
1410                     wrap_here (wrap_indent);
1411                     fputs_filtered (" at ", stdout);
1412                   }
1413                 fputs_filtered (b->source_file, stdout);
1414                 printf_filtered (":%d", b->line_number);
1415               }
1416             else
1417               print_address_symbolic (b->address, stdout, demangle, " ");
1418             break;
1419           }
1420
1421         printf_filtered ("\n");
1422
1423         if (b->frame)
1424           printf_filtered ("\tstop only in stack frame at %s\n",
1425                            local_hex_string(b->frame));
1426         if (b->cond)
1427           {
1428             printf_filtered ("\tstop only if ");
1429             print_expression (b->cond, stdout);
1430             printf_filtered ("\n");
1431           }
1432         if (b->ignore_count)
1433           printf_filtered ("\tignore next %d hits\n", b->ignore_count);
1434         if ((l = b->commands))
1435           while (l)
1436             {
1437               fputs_filtered ("\t", stdout);
1438               fputs_filtered (l->line, stdout);
1439               fputs_filtered ("\n", stdout);
1440               l = l->next;
1441             }
1442       }
1443
1444   if (!found_a_breakpoint)
1445     {
1446       if (bnum == -1)
1447         printf_filtered ("No breakpoints or watchpoints.\n");
1448       else
1449         printf_filtered ("No breakpoint or watchpoint number %d.\n", bnum);
1450     }
1451   else
1452     /* Compare against (CORE_ADDR)-1 in case some compiler decides
1453        that a comparison of an unsigned with -1 is always false.  */
1454     if (last_addr != (CORE_ADDR)-1)
1455       set_next_address (last_addr);
1456 }
1457
1458 /* ARGSUSED */
1459 static void
1460 breakpoints_info (bnum_exp, from_tty)
1461      char *bnum_exp;
1462      int from_tty;
1463 {
1464   int bnum = -1;
1465
1466   if (bnum_exp)
1467     bnum = parse_and_eval_address (bnum_exp);
1468
1469   breakpoint_1 (bnum, 0);
1470 }
1471
1472 #if MAINTENANCE_CMDS
1473
1474 /* ARGSUSED */
1475 static void
1476 maintenance_info_breakpoints (bnum_exp, from_tty)
1477      char *bnum_exp;
1478      int from_tty;
1479 {
1480   int bnum = -1;
1481
1482   if (bnum_exp)
1483     bnum = parse_and_eval_address (bnum_exp);
1484
1485   breakpoint_1 (bnum, 1);
1486 }
1487
1488 #endif
1489
1490 /* Print a message describing any breakpoints set at PC.  */
1491
1492 static void
1493 describe_other_breakpoints (pc)
1494      register CORE_ADDR pc;
1495 {
1496   register int others = 0;
1497   register struct breakpoint *b;
1498
1499   ALL_BREAKPOINTS (b)
1500     if (b->address == pc)
1501       others++;
1502   if (others > 0)
1503     {
1504       printf ("Note: breakpoint%s ", (others > 1) ? "s" : "");
1505       ALL_BREAKPOINTS (b)
1506         if (b->address == pc)
1507           {
1508             others--;
1509             printf ("%d%s%s ",
1510                     b->number,
1511                     (b->enable == disabled) ? " (disabled)" : "",
1512                     (others > 1) ? "," : ((others == 1) ? " and" : ""));
1513           }
1514       printf ("also set at pc %s.\n", local_hex_string(pc));
1515     }
1516 }
1517 \f
1518 /* Set the default place to put a breakpoint
1519    for the `break' command with no arguments.  */
1520
1521 void
1522 set_default_breakpoint (valid, addr, symtab, line)
1523      int valid;
1524      CORE_ADDR addr;
1525      struct symtab *symtab;
1526      int line;
1527 {
1528   default_breakpoint_valid = valid;
1529   default_breakpoint_address = addr;
1530   default_breakpoint_symtab = symtab;
1531   default_breakpoint_line = line;
1532 }
1533
1534 /* Rescan breakpoints at address ADDRESS,
1535    marking the first one as "first" and any others as "duplicates".
1536    This is so that the bpt instruction is only inserted once.  */
1537
1538 static void
1539 check_duplicates (address)
1540      CORE_ADDR address;
1541 {
1542   register struct breakpoint *b;
1543   register int count = 0;
1544
1545   if (address == 0)             /* Watchpoints are uninteresting */
1546     return;
1547
1548   ALL_BREAKPOINTS (b)
1549     if (b->enable != disabled && b->address == address)
1550       {
1551         count++;
1552         b->duplicate = count > 1;
1553       }
1554 }
1555
1556 /* Low level routine to set a breakpoint.
1557    Takes as args the three things that every breakpoint must have.
1558    Returns the breakpoint object so caller can set other things.
1559    Does not set the breakpoint number!
1560    Does not print anything.
1561
1562    ==> This routine should not be called if there is a chance of later
1563    error(); otherwise it leaves a bogus breakpoint on the chain.  Validate
1564    your arguments BEFORE calling this routine!  */
1565
1566 static struct breakpoint *
1567 set_raw_breakpoint (sal)
1568      struct symtab_and_line sal;
1569 {
1570   register struct breakpoint *b, *b1;
1571
1572   b = (struct breakpoint *) xmalloc (sizeof (struct breakpoint));
1573   memset (b, 0, sizeof (*b));
1574   b->address = sal.pc;
1575   if (sal.symtab == NULL)
1576     b->source_file = NULL;
1577   else
1578     b->source_file = savestring (sal.symtab->filename,
1579                                  strlen (sal.symtab->filename));
1580   b->line_number = sal.line;
1581   b->enable = enabled;
1582   b->next = 0;
1583   b->silent = 0;
1584   b->ignore_count = 0;
1585   b->commands = NULL;
1586   b->frame = 0;
1587
1588   /* Add this breakpoint to the end of the chain
1589      so that a list of breakpoints will come out in order
1590      of increasing numbers.  */
1591
1592   b1 = breakpoint_chain;
1593   if (b1 == 0)
1594     breakpoint_chain = b;
1595   else
1596     {
1597       while (b1->next)
1598         b1 = b1->next;
1599       b1->next = b;
1600     }
1601
1602   check_duplicates (sal.pc);
1603
1604   return b;
1605 }
1606
1607 static void
1608 create_longjmp_breakpoint(func_name)
1609      char *func_name;
1610 {
1611   struct symtab_and_line sal;
1612   struct breakpoint *b;
1613   static int internal_breakpoint_number = -1;
1614
1615   if (func_name != NULL)
1616     {
1617       struct minimal_symbol *m;
1618
1619       m = lookup_minimal_symbol(func_name, (struct objfile *)NULL);
1620       if (m)
1621         sal.pc = SYMBOL_VALUE_ADDRESS (m);
1622       else
1623         return;
1624     }
1625   else
1626     sal.pc = 0;
1627
1628   sal.symtab = NULL;
1629   sal.line = 0;
1630
1631   b = set_raw_breakpoint(sal);
1632   if (!b) return;
1633
1634   b->type = func_name != NULL ? bp_longjmp : bp_longjmp_resume;
1635   b->disposition = donttouch;
1636   b->enable = disabled;
1637   b->silent = 1;
1638   if (func_name)
1639     b->addr_string = strsave(func_name);
1640   b->number = internal_breakpoint_number--;
1641 }
1642
1643 /* Call this routine when stepping and nexting to enable a breakpoint if we do
1644    a longjmp().  When we hit that breakpoint, call
1645    set_longjmp_resume_breakpoint() to figure out where we are going. */
1646
1647 void
1648 enable_longjmp_breakpoint()
1649 {
1650   register struct breakpoint *b;
1651
1652   ALL_BREAKPOINTS (b)
1653     if (b->type == bp_longjmp)
1654       {
1655         b->enable = enabled;
1656         check_duplicates (b->address);
1657       }
1658 }
1659
1660 void
1661 disable_longjmp_breakpoint()
1662 {
1663   register struct breakpoint *b;
1664
1665   ALL_BREAKPOINTS (b)
1666     if (   b->type == bp_longjmp
1667         || b->type == bp_longjmp_resume)
1668       {
1669         b->enable = disabled;
1670         check_duplicates (b->address);
1671       }
1672 }
1673
1674 /* Call this after hitting the longjmp() breakpoint.  Use this to set a new
1675    breakpoint at the target of the jmp_buf.
1676
1677    FIXME - This ought to be done by setting a temporary breakpoint that gets
1678    deleted automatically...
1679 */
1680
1681 void
1682 set_longjmp_resume_breakpoint(pc, frame)
1683      CORE_ADDR pc;
1684      FRAME frame;
1685 {
1686   register struct breakpoint *b;
1687
1688   ALL_BREAKPOINTS (b)
1689     if (b->type == bp_longjmp_resume)
1690       {
1691         b->address = pc;
1692         b->enable = enabled;
1693         if (frame != NULL)
1694           b->frame = FRAME_FP(frame);
1695         else
1696           b->frame = 0;
1697         check_duplicates (b->address);
1698         return;
1699       }
1700 }
1701
1702 /* Set a breakpoint that will evaporate an end of command
1703    at address specified by SAL.
1704    Restrict it to frame FRAME if FRAME is nonzero.  */
1705
1706 struct breakpoint *
1707 set_momentary_breakpoint (sal, frame, type)
1708      struct symtab_and_line sal;
1709      FRAME frame;
1710      enum bptype type;
1711 {
1712   register struct breakpoint *b;
1713   b = set_raw_breakpoint (sal);
1714   b->type = type;
1715   b->enable = enabled;
1716   b->disposition = donttouch;
1717   b->frame = (frame ? FRAME_FP (frame) : 0);
1718   return b;
1719 }
1720
1721 #if 0
1722 void
1723 clear_momentary_breakpoints ()
1724 {
1725   register struct breakpoint *b;
1726   ALL_BREAKPOINTS (b)
1727     if (b->disposition == delete)
1728       {
1729         delete_breakpoint (b);
1730         break;
1731       }
1732 }
1733 #endif
1734 \f
1735 /* Tell the user we have just set a breakpoint B.  */
1736 static void
1737 mention (b)
1738      struct breakpoint *b;
1739 {
1740   switch (b->type)
1741     {
1742     case bp_watchpoint:
1743       printf_filtered ("Watchpoint %d: ", b->number);
1744       print_expression (b->exp, stdout);
1745       break;
1746     case bp_breakpoint:
1747       printf_filtered ("Breakpoint %d at %s", b->number,
1748                        local_hex_string(b->address));
1749       if (b->source_file)
1750         printf_filtered (": file %s, line %d.",
1751                          b->source_file, b->line_number);
1752       break;
1753     case bp_until:
1754     case bp_finish:
1755     case bp_longjmp:
1756     case bp_longjmp_resume:
1757     case bp_step_resume:
1758       break;
1759     }
1760   printf_filtered ("\n");
1761 }
1762
1763 #if 0
1764 /* Nobody calls this currently. */
1765 /* Set a breakpoint from a symtab and line.
1766    If TEMPFLAG is nonzero, it is a temporary breakpoint.
1767    ADDR_STRING is a malloc'd string holding the name of where we are
1768    setting the breakpoint.  This is used later to re-set it after the
1769    program is relinked and symbols are reloaded.
1770    Print the same confirmation messages that the breakpoint command prints.  */
1771
1772 void
1773 set_breakpoint (s, line, tempflag, addr_string)
1774      struct symtab *s;
1775      int line;
1776      int tempflag;
1777      char *addr_string;
1778 {
1779   register struct breakpoint *b;
1780   struct symtab_and_line sal;
1781   
1782   sal.symtab = s;
1783   sal.line = line;
1784   sal.pc = 0;
1785   resolve_sal_pc (&sal);                        /* Might error out */
1786   describe_other_breakpoints (sal.pc);
1787
1788   b = set_raw_breakpoint (sal);
1789   set_breakpoint_count (breakpoint_count + 1);
1790   b->number = breakpoint_count;
1791   b->type = bp_breakpoint;
1792   b->cond = 0;
1793   b->addr_string = addr_string;
1794   b->enable = enabled;
1795   b->disposition = tempflag ? delete : donttouch;
1796
1797   mention (b);
1798 }
1799 #endif /* 0 */
1800 \f
1801 /* Set a breakpoint according to ARG (function, linenum or *address)
1802    and make it temporary if TEMPFLAG is nonzero. */
1803
1804 static void
1805 break_command_1 (arg, tempflag, from_tty)
1806      char *arg;
1807      int tempflag, from_tty;
1808 {
1809   struct symtabs_and_lines sals;
1810   struct symtab_and_line sal;
1811   register struct expression *cond = 0;
1812   register struct breakpoint *b;
1813
1814   /* Pointers in arg to the start, and one past the end, of the condition.  */
1815   char *cond_start = NULL;
1816   char *cond_end = NULL;
1817   /* Pointers in arg to the start, and one past the end,
1818      of the address part.  */
1819   char *addr_start = NULL;
1820   char *addr_end = NULL;
1821   struct cleanup *old_chain;
1822   struct cleanup *canonical_strings_chain = NULL;
1823   char **canonical = (char **)NULL;
1824   
1825   int i;
1826
1827   sals.sals = NULL;
1828   sals.nelts = 0;
1829
1830   sal.line = sal.pc = sal.end = 0;
1831   sal.symtab = 0;
1832
1833   /* If no arg given, or if first arg is 'if ', use the default breakpoint. */
1834
1835   if (!arg || (arg[0] == 'i' && arg[1] == 'f' 
1836                && (arg[2] == ' ' || arg[2] == '\t')))
1837     {
1838       if (default_breakpoint_valid)
1839         {
1840           sals.sals = (struct symtab_and_line *) 
1841             xmalloc (sizeof (struct symtab_and_line));
1842           sal.pc = default_breakpoint_address;
1843           sal.line = default_breakpoint_line;
1844           sal.symtab = default_breakpoint_symtab;
1845           sals.sals[0] = sal;
1846           sals.nelts = 1;
1847         }
1848       else
1849         error ("No default breakpoint address now.");
1850     }
1851   else
1852     {
1853       addr_start = arg;
1854
1855       /* Force almost all breakpoints to be in terms of the
1856          current_source_symtab (which is decode_line_1's default).  This
1857          should produce the results we want almost all of the time while
1858          leaving default_breakpoint_* alone.  */
1859       if (default_breakpoint_valid
1860           && (!current_source_symtab
1861               || (arg && (*arg == '+' || *arg == '-'))))
1862         sals = decode_line_1 (&arg, 1, default_breakpoint_symtab,
1863                               default_breakpoint_line, &canonical);
1864       else
1865         sals = decode_line_1 (&arg, 1, (struct symtab *)NULL, 0, &canonical);
1866
1867       addr_end = arg;
1868     }
1869   
1870   if (! sals.nelts) 
1871     return;
1872
1873   /* Make sure that all storage allocated in decode_line_1 gets freed in case
1874      the following `for' loop errors out.  */
1875   old_chain = make_cleanup (free, sals.sals);
1876   if (canonical != (char **)NULL)
1877     {
1878       make_cleanup (free, canonical);
1879       canonical_strings_chain = make_cleanup (null_cleanup, 0);
1880       for (i = 0; i < sals.nelts; i++)
1881         {
1882           if (canonical[i] != NULL)
1883             make_cleanup (free, canonical[i]);
1884         }
1885     }
1886
1887   /* Resolve all line numbers to PC's, and verify that conditions
1888      can be parsed, before setting any breakpoints.  */
1889   for (i = 0; i < sals.nelts; i++)
1890     {
1891       resolve_sal_pc (&sals.sals[i]);
1892       
1893       while (arg && *arg)
1894         {
1895           if (arg[0] == 'i' && arg[1] == 'f'
1896               && (arg[2] == ' ' || arg[2] == '\t'))
1897             {
1898               arg += 2;
1899               cond_start = arg;
1900               cond = parse_exp_1 (&arg, block_for_pc (sals.sals[i].pc), 0);
1901               cond_end = arg;
1902             }
1903           else
1904             error ("Junk at end of arguments.");
1905         }
1906     }
1907
1908   /* Remove the canonical strings from the cleanup, they are needed below.  */
1909   if (canonical != (char **)NULL)
1910     discard_cleanups (canonical_strings_chain);
1911
1912   /* Now set all the breakpoints.  */
1913   for (i = 0; i < sals.nelts; i++)
1914     {
1915       sal = sals.sals[i];
1916
1917       if (from_tty)
1918         describe_other_breakpoints (sal.pc);
1919
1920       b = set_raw_breakpoint (sal);
1921       set_breakpoint_count (breakpoint_count + 1);
1922       b->number = breakpoint_count;
1923       b->type = bp_breakpoint;
1924       b->cond = cond;
1925
1926       /* If a canonical line spec is needed use that instead of the
1927          command string.  */
1928       if (canonical != (char **)NULL && canonical[i] != NULL)
1929         b->addr_string = canonical[i];
1930       else if (addr_start)
1931         b->addr_string = savestring (addr_start, addr_end - addr_start);
1932       if (cond_start)
1933         b->cond_string = savestring (cond_start, cond_end - cond_start);
1934                                      
1935       b->enable = enabled;
1936       b->disposition = tempflag ? delete : donttouch;
1937
1938       mention (b);
1939     }
1940
1941   if (sals.nelts > 1)
1942     {
1943       printf ("Multiple breakpoints were set.\n");
1944       printf ("Use the \"delete\" command to delete unwanted breakpoints.\n");
1945     }
1946   do_cleanups (old_chain);
1947 }
1948
1949 /* Helper function for break_command_1 and disassemble_command.  */
1950
1951 void
1952 resolve_sal_pc (sal)
1953      struct symtab_and_line *sal;
1954 {
1955   CORE_ADDR pc;
1956
1957   if (sal->pc == 0 && sal->symtab != 0)
1958     {
1959       pc = find_line_pc (sal->symtab, sal->line);
1960       if (pc == 0)
1961         error ("No line %d in file \"%s\".",
1962                sal->line, sal->symtab->filename);
1963       sal->pc = pc;
1964     }
1965 }
1966
1967 void
1968 break_command (arg, from_tty)
1969      char *arg;
1970      int from_tty;
1971 {
1972   break_command_1 (arg, 0, from_tty);
1973 }
1974
1975 static void
1976 tbreak_command (arg, from_tty)
1977      char *arg;
1978      int from_tty;
1979 {
1980   break_command_1 (arg, 1, from_tty);
1981 }
1982
1983 /* ARGSUSED */
1984 static void
1985 watch_command (arg, from_tty)
1986      char *arg;
1987      int from_tty;
1988 {
1989   struct breakpoint *b;
1990   struct symtab_and_line sal;
1991   struct expression *exp;
1992   struct block *exp_valid_block;
1993   struct value *val;
1994
1995   sal.pc = 0;
1996   sal.symtab = NULL;
1997   sal.line = 0;
1998   
1999   /* Parse arguments.  */
2000   innermost_block = NULL;
2001   exp = parse_expression (arg);
2002   exp_valid_block = innermost_block;
2003   val = evaluate_expression (exp);
2004   release_value (val);
2005   if (VALUE_LAZY (val))
2006     value_fetch_lazy (val);
2007
2008   /* Now set up the breakpoint.  */
2009   b = set_raw_breakpoint (sal);
2010   set_breakpoint_count (breakpoint_count + 1);
2011   b->number = breakpoint_count;
2012   b->type = bp_watchpoint;
2013   b->disposition = donttouch;
2014   b->exp = exp;
2015   b->exp_valid_block = exp_valid_block;
2016   b->val = val;
2017   b->cond = 0;
2018   b->cond_string = NULL;
2019   b->exp_string = savestring (arg, strlen (arg));
2020   mention (b);
2021 }
2022 \f
2023 /*
2024  * Helper routine for the until_command routine in infcmd.c.  Here
2025  * because it uses the mechanisms of breakpoints.
2026  */
2027 /* ARGSUSED */
2028 void
2029 until_break_command (arg, from_tty)
2030      char *arg;
2031      int from_tty;
2032 {
2033   struct symtabs_and_lines sals;
2034   struct symtab_and_line sal;
2035   FRAME prev_frame = get_prev_frame (selected_frame);
2036   struct breakpoint *breakpoint;
2037   struct cleanup *old_chain;
2038
2039   clear_proceed_status ();
2040
2041   /* Set a breakpoint where the user wants it and at return from
2042      this function */
2043   
2044   if (default_breakpoint_valid)
2045     sals = decode_line_1 (&arg, 1, default_breakpoint_symtab,
2046                           default_breakpoint_line, (char ***)NULL);
2047   else
2048     sals = decode_line_1 (&arg, 1, (struct symtab *)NULL, 0, (char ***)NULL);
2049   
2050   if (sals.nelts != 1)
2051     error ("Couldn't get information on specified line.");
2052   
2053   sal = sals.sals[0];
2054   free ((PTR)sals.sals);                /* malloc'd, so freed */
2055   
2056   if (*arg)
2057     error ("Junk at end of arguments.");
2058   
2059   resolve_sal_pc (&sal);
2060   
2061   breakpoint = set_momentary_breakpoint (sal, selected_frame, bp_until);
2062   
2063   old_chain = make_cleanup(delete_breakpoint, breakpoint);
2064
2065   /* Keep within the current frame */
2066   
2067   if (prev_frame)
2068     {
2069       struct frame_info *fi;
2070       
2071       fi = get_frame_info (prev_frame);
2072       sal = find_pc_line (fi->pc, 0);
2073       sal.pc = fi->pc;
2074       breakpoint = set_momentary_breakpoint (sal, prev_frame, bp_until);
2075       make_cleanup(delete_breakpoint, breakpoint);
2076     }
2077   
2078   proceed (-1, -1, 0);
2079   do_cleanups(old_chain);
2080 }
2081 \f
2082 #if 0
2083 /* These aren't used; I don't konw what they were for.  */
2084 /* Set a breakpoint at the catch clause for NAME.  */
2085 static int
2086 catch_breakpoint (name)
2087      char *name;
2088 {
2089 }
2090
2091 static int
2092 disable_catch_breakpoint ()
2093 {
2094 }
2095
2096 static int
2097 delete_catch_breakpoint ()
2098 {
2099 }
2100
2101 static int
2102 enable_catch_breakpoint ()
2103 {
2104 }
2105 #endif /* 0 */
2106
2107 struct sal_chain
2108 {
2109   struct sal_chain *next;
2110   struct symtab_and_line sal;
2111 };
2112
2113 #if 0
2114 /* This isn't used; I don't know what it was for.  */
2115 /* For each catch clause identified in ARGS, run FUNCTION
2116    with that clause as an argument.  */
2117 static struct symtabs_and_lines
2118 map_catch_names (args, function)
2119      char *args;
2120      int (*function)();
2121 {
2122   register char *p = args;
2123   register char *p1;
2124   struct symtabs_and_lines sals;
2125 #if 0
2126   struct sal_chain *sal_chain = 0;
2127 #endif
2128
2129   if (p == 0)
2130     error_no_arg ("one or more catch names");
2131
2132   sals.nelts = 0;
2133   sals.sals = NULL;
2134
2135   while (*p)
2136     {
2137       p1 = p;
2138       /* Don't swallow conditional part.  */
2139       if (p1[0] == 'i' && p1[1] == 'f'
2140           && (p1[2] == ' ' || p1[2] == '\t'))
2141         break;
2142
2143       if (isalpha (*p1))
2144         {
2145           p1++;
2146           while (isalnum (*p1) || *p1 == '_' || *p1 == '$')
2147             p1++;
2148         }
2149
2150       if (*p1 && *p1 != ' ' && *p1 != '\t')
2151         error ("Arguments must be catch names.");
2152
2153       *p1 = 0;
2154 #if 0
2155       if (function (p))
2156         {
2157           struct sal_chain *next
2158             = (struct sal_chain *)alloca (sizeof (struct sal_chain));
2159           next->next = sal_chain;
2160           next->sal = get_catch_sal (p);
2161           sal_chain = next;
2162           goto win;
2163         }
2164 #endif
2165       printf ("No catch clause for exception %s.\n", p);
2166 #if 0
2167     win:
2168 #endif
2169       p = p1;
2170       while (*p == ' ' || *p == '\t') p++;
2171     }
2172 }
2173 #endif /* 0 */
2174
2175 /* This shares a lot of code with `print_frame_label_vars' from stack.c.  */
2176
2177 static struct symtabs_and_lines
2178 get_catch_sals (this_level_only)
2179      int this_level_only;
2180 {
2181   register struct blockvector *bl;
2182   register struct block *block;
2183   int index, have_default = 0;
2184   struct frame_info *fi;
2185   CORE_ADDR pc;
2186   struct symtabs_and_lines sals;
2187   struct sal_chain *sal_chain = 0;
2188   char *blocks_searched;
2189
2190   /* Not sure whether an error message is always the correct response,
2191      but it's better than a core dump.  */
2192   if (selected_frame == NULL)
2193     error ("No selected frame.");
2194   block = get_frame_block (selected_frame);
2195   fi = get_frame_info (selected_frame);
2196   pc = fi->pc;
2197
2198   sals.nelts = 0;
2199   sals.sals = NULL;
2200
2201   if (block == 0)
2202     error ("No symbol table info available.\n");
2203
2204   bl = blockvector_for_pc (BLOCK_END (block) - 4, &index);
2205   blocks_searched = (char *) alloca (BLOCKVECTOR_NBLOCKS (bl) * sizeof (char));
2206   memset (blocks_searched, 0, BLOCKVECTOR_NBLOCKS (bl) * sizeof (char));
2207
2208   while (block != 0)
2209     {
2210       CORE_ADDR end = BLOCK_END (block) - 4;
2211       int last_index;
2212
2213       if (bl != blockvector_for_pc (end, &index))
2214         error ("blockvector blotch");
2215       if (BLOCKVECTOR_BLOCK (bl, index) != block)
2216         error ("blockvector botch");
2217       last_index = BLOCKVECTOR_NBLOCKS (bl);
2218       index += 1;
2219
2220       /* Don't print out blocks that have gone by.  */
2221       while (index < last_index
2222              && BLOCK_END (BLOCKVECTOR_BLOCK (bl, index)) < pc)
2223         index++;
2224
2225       while (index < last_index
2226              && BLOCK_END (BLOCKVECTOR_BLOCK (bl, index)) < end)
2227         {
2228           if (blocks_searched[index] == 0)
2229             {
2230               struct block *b = BLOCKVECTOR_BLOCK (bl, index);
2231               int nsyms;
2232               register int i;
2233               register struct symbol *sym;
2234
2235               nsyms = BLOCK_NSYMS (b);
2236
2237               for (i = 0; i < nsyms; i++)
2238                 {
2239                   sym = BLOCK_SYM (b, i);
2240                   if (STREQ (SYMBOL_NAME (sym), "default"))
2241                     {
2242                       if (have_default)
2243                         continue;
2244                       have_default = 1;
2245                     }
2246                   if (SYMBOL_CLASS (sym) == LOC_LABEL)
2247                     {
2248                       struct sal_chain *next = (struct sal_chain *)
2249                         alloca (sizeof (struct sal_chain));
2250                       next->next = sal_chain;
2251                       next->sal = find_pc_line (SYMBOL_VALUE_ADDRESS (sym), 0);
2252                       sal_chain = next;
2253                     }
2254                 }
2255               blocks_searched[index] = 1;
2256             }
2257           index++;
2258         }
2259       if (have_default)
2260         break;
2261       if (sal_chain && this_level_only)
2262         break;
2263
2264       /* After handling the function's top-level block, stop.
2265          Don't continue to its superblock, the block of
2266          per-file symbols.  */
2267       if (BLOCK_FUNCTION (block))
2268         break;
2269       block = BLOCK_SUPERBLOCK (block);
2270     }
2271
2272   if (sal_chain)
2273     {
2274       struct sal_chain *tmp_chain;
2275
2276       /* Count the number of entries.  */
2277       for (index = 0, tmp_chain = sal_chain; tmp_chain;
2278            tmp_chain = tmp_chain->next)
2279         index++;
2280
2281       sals.nelts = index;
2282       sals.sals = (struct symtab_and_line *)
2283         xmalloc (index * sizeof (struct symtab_and_line));
2284       for (index = 0; sal_chain; sal_chain = sal_chain->next, index++)
2285         sals.sals[index] = sal_chain->sal;
2286     }
2287
2288   return sals;
2289 }
2290
2291 /* Commands to deal with catching exceptions.  */
2292
2293 static void
2294 catch_command_1 (arg, tempflag, from_tty)
2295      char *arg;
2296      int tempflag;
2297      int from_tty;
2298 {
2299   /* First, translate ARG into something we can deal with in terms
2300      of breakpoints.  */
2301
2302   struct symtabs_and_lines sals;
2303   struct symtab_and_line sal;
2304   register struct expression *cond = 0;
2305   register struct breakpoint *b;
2306   char *save_arg;
2307   int i;
2308
2309   sal.line = sal.pc = sal.end = 0;
2310   sal.symtab = 0;
2311
2312   /* If no arg given, or if first arg is 'if ', all active catch clauses
2313      are breakpointed. */
2314
2315   if (!arg || (arg[0] == 'i' && arg[1] == 'f' 
2316                && (arg[2] == ' ' || arg[2] == '\t')))
2317     {
2318       /* Grab all active catch clauses.  */
2319       sals = get_catch_sals (0);
2320     }
2321   else
2322     {
2323       /* Grab selected catch clauses.  */
2324       error ("catch NAME not implemented");
2325 #if 0
2326       /* This isn't used; I don't know what it was for.  */
2327       sals = map_catch_names (arg, catch_breakpoint);
2328 #endif
2329     }
2330
2331   if (! sals.nelts) 
2332     return;
2333
2334   save_arg = arg;
2335   for (i = 0; i < sals.nelts; i++)
2336     {
2337       resolve_sal_pc (&sals.sals[i]);
2338       
2339       while (arg && *arg)
2340         {
2341           if (arg[0] == 'i' && arg[1] == 'f'
2342               && (arg[2] == ' ' || arg[2] == '\t'))
2343             cond = parse_exp_1 ((arg += 2, &arg), 
2344                                 block_for_pc (sals.sals[i].pc), 0);
2345           else
2346             error ("Junk at end of arguments.");
2347         }
2348       arg = save_arg;
2349     }
2350
2351   for (i = 0; i < sals.nelts; i++)
2352     {
2353       sal = sals.sals[i];
2354
2355       if (from_tty)
2356         describe_other_breakpoints (sal.pc);
2357
2358       b = set_raw_breakpoint (sal);
2359       set_breakpoint_count (breakpoint_count + 1);
2360       b->number = breakpoint_count;
2361       b->type = bp_breakpoint;
2362       b->cond = cond;
2363       b->enable = enabled;
2364       b->disposition = tempflag ? delete : donttouch;
2365
2366       mention (b);
2367     }
2368
2369   if (sals.nelts > 1)
2370     {
2371       printf ("Multiple breakpoints were set.\n");
2372       printf ("Use the \"delete\" command to delete unwanted breakpoints.\n");
2373     }
2374   free ((PTR)sals.sals);
2375 }
2376
2377 #if 0
2378 /* These aren't used; I don't know what they were for.  */
2379 /* Disable breakpoints on all catch clauses described in ARGS.  */
2380 static void
2381 disable_catch (args)
2382      char *args;
2383 {
2384   /* Map the disable command to catch clauses described in ARGS.  */
2385 }
2386
2387 /* Enable breakpoints on all catch clauses described in ARGS.  */
2388 static void
2389 enable_catch (args)
2390      char *args;
2391 {
2392   /* Map the disable command to catch clauses described in ARGS.  */
2393 }
2394
2395 /* Delete breakpoints on all catch clauses in the active scope.  */
2396 static void
2397 delete_catch (args)
2398      char *args;
2399 {
2400   /* Map the delete command to catch clauses described in ARGS.  */
2401 }
2402 #endif /* 0 */
2403
2404 static void
2405 catch_command (arg, from_tty)
2406      char *arg;
2407      int from_tty;
2408 {
2409   catch_command_1 (arg, 0, from_tty);
2410 }
2411 \f
2412 static void
2413 clear_command (arg, from_tty)
2414      char *arg;
2415      int from_tty;
2416 {
2417   register struct breakpoint *b, *b1;
2418   struct symtabs_and_lines sals;
2419   struct symtab_and_line sal;
2420   register struct breakpoint *found;
2421   int i;
2422
2423   if (arg)
2424     {
2425       sals = decode_line_spec (arg, 1);
2426     }
2427   else
2428     {
2429       sals.sals = (struct symtab_and_line *) xmalloc (sizeof (struct symtab_and_line));
2430       sal.line = default_breakpoint_line;
2431       sal.symtab = default_breakpoint_symtab;
2432       sal.pc = 0;
2433       if (sal.symtab == 0)
2434         error ("No source file specified.");
2435
2436       sals.sals[0] = sal;
2437       sals.nelts = 1;
2438     }
2439
2440   for (i = 0; i < sals.nelts; i++)
2441     {
2442       /* If exact pc given, clear bpts at that pc.
2443          But if sal.pc is zero, clear all bpts on specified line.  */
2444       sal = sals.sals[i];
2445       found = (struct breakpoint *) 0;
2446       while (breakpoint_chain
2447              && (sal.pc
2448                  ? breakpoint_chain->address == sal.pc
2449                  : (breakpoint_chain->source_file != NULL
2450                     && sal.symtab != NULL
2451                     && STREQ (breakpoint_chain->source_file,
2452                               sal.symtab->filename)
2453                     && breakpoint_chain->line_number == sal.line)))
2454         {
2455           b1 = breakpoint_chain;
2456           breakpoint_chain = b1->next;
2457           b1->next = found;
2458           found = b1;
2459         }
2460
2461       ALL_BREAKPOINTS (b)
2462         while (b->next
2463                && b->next->type != bp_watchpoint
2464                && (sal.pc
2465                    ? b->next->address == sal.pc
2466                    : (b->next->source_file != NULL
2467                       && sal.symtab != NULL
2468                       && STREQ (b->next->source_file, sal.symtab->filename)
2469                       && b->next->line_number == sal.line)))
2470           {
2471             b1 = b->next;
2472             b->next = b1->next;
2473             b1->next = found;
2474             found = b1;
2475           }
2476
2477       if (found == 0)
2478         {
2479           if (arg)
2480             error ("No breakpoint at %s.", arg);
2481           else
2482             error ("No breakpoint at this line.");
2483         }
2484
2485       if (found->next) from_tty = 1; /* Always report if deleted more than one */
2486       if (from_tty) printf ("Deleted breakpoint%s ", found->next ? "s" : "");
2487       while (found)
2488         {
2489           if (from_tty) printf ("%d ", found->number);
2490           b1 = found->next;
2491           delete_breakpoint (found);
2492           found = b1;
2493         }
2494       if (from_tty) putchar ('\n');
2495     }
2496   free ((PTR)sals.sals);
2497 }
2498 \f
2499 /* Delete breakpoint in BS if they are `delete' breakpoints.
2500    This is called after any breakpoint is hit, or after errors.  */
2501
2502 void
2503 breakpoint_auto_delete (bs)
2504      bpstat bs;
2505 {
2506   for (; bs; bs = bs->next)
2507     if (bs->breakpoint_at && bs->breakpoint_at->disposition == delete)
2508       delete_breakpoint (bs->breakpoint_at);
2509 }
2510
2511 /* Delete a breakpoint and clean up all traces of it in the data structures. */
2512
2513 void
2514 delete_breakpoint (bpt)
2515      struct breakpoint *bpt;
2516 {
2517   register struct breakpoint *b;
2518   register bpstat bs;
2519
2520   if (bpt->inserted)
2521     target_remove_breakpoint(bpt->address, bpt->shadow_contents);
2522
2523   if (breakpoint_chain == bpt)
2524     breakpoint_chain = bpt->next;
2525
2526   ALL_BREAKPOINTS (b)
2527     if (b->next == bpt)
2528       {
2529         b->next = bpt->next;
2530         break;
2531       }
2532
2533   check_duplicates (bpt->address);
2534   /* If this breakpoint was inserted, and there is another breakpoint
2535      at the same address, we need to insert the other breakpoint.  */
2536   if (bpt->inserted)
2537     {
2538       ALL_BREAKPOINTS (b)
2539         if (b->address == bpt->address && !b->duplicate)
2540           {
2541             int val;
2542             val = target_insert_breakpoint (b->address, b->shadow_contents);
2543             if (val != 0)
2544               {
2545                 fprintf (stderr, "Cannot insert breakpoint %d:\n", b->number);
2546                 memory_error (val, b->address); /* which bombs us out */
2547               }
2548             else
2549               b->inserted = 1;
2550           }
2551     }
2552
2553   free_command_lines (&bpt->commands);
2554   if (bpt->cond)
2555     free (bpt->cond);
2556   if (bpt->cond_string != NULL)
2557     free (bpt->cond_string);
2558   if (bpt->addr_string != NULL)
2559     free (bpt->addr_string);
2560   if (bpt->exp_string != NULL)
2561     free (bpt->exp_string);
2562   if (bpt->source_file != NULL)
2563     free (bpt->source_file);
2564
2565   if (xgdb_verbose && bpt->type == bp_breakpoint)
2566     printf ("breakpoint #%d deleted\n", bpt->number);
2567
2568   /* Be sure no bpstat's are pointing at it after it's been freed.  */
2569   /* FIXME, how can we find all bpstat's?  We just check stop_bpstat for now. */
2570   for (bs = stop_bpstat; bs; bs = bs->next)
2571     if (bs->breakpoint_at == bpt)
2572       bs->breakpoint_at = NULL;
2573   free ((PTR)bpt);
2574 }
2575
2576 static void
2577 delete_command (arg, from_tty)
2578      char *arg;
2579      int from_tty;
2580 {
2581
2582   if (arg == 0)
2583     {
2584       /* Ask user only if there are some breakpoints to delete.  */
2585       if (!from_tty
2586           || (breakpoint_chain && query ("Delete all breakpoints? ", 0, 0)))
2587         {
2588           /* No arg; clear all breakpoints.  */
2589           while (breakpoint_chain)
2590             delete_breakpoint (breakpoint_chain);
2591         }
2592     }
2593   else
2594     map_breakpoint_numbers (arg, delete_breakpoint);
2595 }
2596
2597 /* Reset a breakpoint given it's struct breakpoint * BINT.
2598    The value we return ends up being the return value from catch_errors.
2599    Unused in this case.  */
2600
2601 static int
2602 breakpoint_re_set_one (bint)
2603      char *bint;
2604 {
2605   struct breakpoint *b = (struct breakpoint *)bint;  /* get past catch_errs */
2606   int i;
2607   struct symtabs_and_lines sals;
2608   char *s;
2609   enum enable save_enable;
2610
2611   switch (b->type)
2612     {
2613     case bp_breakpoint:
2614       if (b->addr_string == NULL)
2615         {
2616           /* Anything without a string can't be re-set. */
2617           delete_breakpoint (b);
2618           return 0;
2619         }
2620       /* In case we have a problem, disable this breakpoint.  We'll restore
2621          its status if we succeed.  */
2622       save_enable = b->enable;
2623       b->enable = disabled;
2624
2625       s = b->addr_string;
2626       sals = decode_line_1 (&s, 1, (struct symtab *)NULL, 0, (char ***)NULL);
2627       for (i = 0; i < sals.nelts; i++)
2628         {
2629           resolve_sal_pc (&sals.sals[i]);
2630
2631           /* Reparse conditions, they might contain references to the
2632              old symtab.  */
2633           if (b->cond_string != NULL)
2634             {
2635               s = b->cond_string;
2636               if (b->cond)
2637                 free ((PTR)b->cond);
2638               b->cond = parse_exp_1 (&s, block_for_pc (sals.sals[i].pc), 0);
2639             }
2640
2641           /* We need to re-set the breakpoint if the address changes...*/
2642           if (b->address != sals.sals[i].pc
2643               /* ...or new and old breakpoints both have source files, and
2644                  the source file name or the line number changes...  */
2645               || (b->source_file != NULL
2646                   && sals.sals[i].symtab != NULL
2647                   && (!STREQ (b->source_file, sals.sals[i].symtab->filename)
2648                       || b->line_number != sals.sals[i].line)
2649                   )
2650               /* ...or we switch between having a source file and not having
2651                  one.  */
2652               || ((b->source_file == NULL) != (sals.sals[i].symtab == NULL))
2653               )
2654             {
2655               if (b->source_file != NULL)
2656                 free (b->source_file);
2657               if (sals.sals[i].symtab == NULL)
2658                 b->source_file = NULL;
2659               else
2660                 b->source_file =
2661                   savestring (sals.sals[i].symtab->filename,
2662                               strlen (sals.sals[i].symtab->filename));
2663               b->line_number = sals.sals[i].line;
2664               b->address = sals.sals[i].pc;
2665           
2666               check_duplicates (b->address);
2667
2668               mention (b);
2669             }
2670           b->enable = save_enable;      /* Restore it, this worked. */
2671         }
2672       free ((PTR)sals.sals);
2673       break;
2674
2675     case bp_watchpoint:
2676       innermost_block = NULL;
2677       /* The issue arises of what context to evaluate this in.  The same
2678          one as when it was set, but what does that mean when symbols have
2679          been re-read?  We could save the filename and functionname, but
2680          if the context is more local than that, the best we could do would
2681          be something like how many levels deep and which index at that
2682          particular level, but that's going to be less stable than filenames
2683          or functionnames.  */
2684       /* So for now, just use a global context.  */
2685       b->exp = parse_expression (b->exp_string);
2686       b->exp_valid_block = innermost_block;
2687       b->val = evaluate_expression (b->exp);
2688       release_value (b->val);
2689       if (VALUE_LAZY (b->val))
2690         value_fetch_lazy (b->val);
2691
2692       if (b->cond_string != NULL)
2693         {
2694           s = b->cond_string;
2695           b->cond = parse_exp_1 (&s, (struct block *)0, 0);
2696         }
2697       if (b->enable == enabled)
2698         mention (b);
2699       break;
2700
2701     default:
2702       printf_filtered ("Deleting unknown breakpoint type %d\n", b->type);
2703       /* fall through */
2704     case bp_until:
2705     case bp_finish:
2706     case bp_longjmp:
2707     case bp_longjmp_resume:
2708       delete_breakpoint (b);
2709       break;
2710     }
2711
2712   return 0;
2713 }
2714
2715 /* Re-set all breakpoints after symbols have been re-loaded.  */
2716 void
2717 breakpoint_re_set ()
2718 {
2719   struct breakpoint *b, *temp;
2720   static char message1[] = "Error in re-setting breakpoint %d:\n";
2721   char message[sizeof (message1) + 30 /* slop */];
2722   
2723   ALL_BREAKPOINTS_SAFE (b, temp)
2724     {
2725       sprintf (message, message1, b->number);   /* Format possible error msg */
2726       catch_errors (breakpoint_re_set_one, (char *) b, message,
2727                     RETURN_MASK_ALL);
2728     }
2729
2730   create_longjmp_breakpoint("longjmp");
2731   create_longjmp_breakpoint("_longjmp");
2732   create_longjmp_breakpoint("siglongjmp");
2733   create_longjmp_breakpoint(NULL);
2734
2735 #if 0
2736   /* Took this out (temporaliy at least), since it produces an extra 
2737      blank line at startup. This messes up the gdbtests. -PB */
2738   /* Blank line to finish off all those mention() messages we just printed.  */
2739   printf_filtered ("\n");
2740 #endif
2741 }
2742 \f
2743 /* Set ignore-count of breakpoint number BPTNUM to COUNT.
2744    If from_tty is nonzero, it prints a message to that effect,
2745    which ends with a period (no newline).  */
2746
2747 void
2748 set_ignore_count (bptnum, count, from_tty)
2749      int bptnum, count, from_tty;
2750 {
2751   register struct breakpoint *b;
2752
2753   if (count < 0)
2754     count = 0;
2755
2756   ALL_BREAKPOINTS (b)
2757     if (b->number == bptnum)
2758       {
2759         b->ignore_count = count;
2760         if (!from_tty)
2761           return;
2762         else if (count == 0)
2763           printf_filtered ("Will stop next time breakpoint %d is reached.",
2764                            bptnum);
2765         else if (count == 1)
2766           printf_filtered ("Will ignore next crossing of breakpoint %d.",
2767                            bptnum);
2768         else
2769           printf_filtered ("Will ignore next %d crossings of breakpoint %d.",
2770                   count, bptnum);
2771         return;
2772       }
2773
2774   error ("No breakpoint number %d.", bptnum);
2775 }
2776
2777 /* Clear the ignore counts of all breakpoints.  */
2778 void
2779 breakpoint_clear_ignore_counts ()
2780 {
2781   struct breakpoint *b;
2782
2783   ALL_BREAKPOINTS (b)
2784     b->ignore_count = 0;
2785 }
2786
2787 /* Command to set ignore-count of breakpoint N to COUNT.  */
2788
2789 static void
2790 ignore_command (args, from_tty)
2791      char *args;
2792      int from_tty;
2793 {
2794   char *p = args;
2795   register int num;
2796
2797   if (p == 0)
2798     error_no_arg ("a breakpoint number");
2799   
2800   num = get_number (&p);
2801
2802   if (*p == 0)
2803     error ("Second argument (specified ignore-count) is missing.");
2804
2805   set_ignore_count (num,
2806                     longest_to_int (value_as_long (parse_and_eval (p))),
2807                     from_tty);
2808   printf_filtered ("\n");
2809 }
2810 \f
2811 /* Call FUNCTION on each of the breakpoints
2812    whose numbers are given in ARGS.  */
2813
2814 static void
2815 map_breakpoint_numbers (args, function)
2816      char *args;
2817      void (*function) PARAMS ((struct breakpoint *));
2818 {
2819   register char *p = args;
2820   char *p1;
2821   register int num;
2822   register struct breakpoint *b;
2823
2824   if (p == 0)
2825     error_no_arg ("one or more breakpoint numbers");
2826
2827   while (*p)
2828     {
2829       p1 = p;
2830       
2831       num = get_number (&p1);
2832
2833       ALL_BREAKPOINTS (b)
2834         if (b->number == num)
2835           {
2836             function (b);
2837             goto win;
2838           }
2839       printf ("No breakpoint number %d.\n", num);
2840     win:
2841       p = p1;
2842     }
2843 }
2844
2845 static void
2846 enable_breakpoint (bpt)
2847      struct breakpoint *bpt;
2848 {
2849   FRAME save_selected_frame = NULL;
2850   int save_selected_frame_level = -1;
2851   
2852   bpt->enable = enabled;
2853
2854   if (xgdb_verbose && bpt->type == bp_breakpoint)
2855     printf ("breakpoint #%d enabled\n", bpt->number);
2856
2857   check_duplicates (bpt->address);
2858   if (bpt->type == bp_watchpoint)
2859     {
2860       if (bpt->exp_valid_block != NULL)
2861         {
2862           FRAME fr = within_scope (bpt->exp_valid_block);
2863           if (fr == NULL)
2864             {
2865               printf_filtered ("\
2866 Cannot enable watchpoint %d because the block in which its expression\n\
2867 is valid is not currently in scope.\n", bpt->number);
2868               bpt->enable = disabled;
2869               return;
2870             }
2871           save_selected_frame = selected_frame;
2872           save_selected_frame_level = selected_frame_level;
2873           select_frame (fr, -1);
2874         }
2875
2876       value_free (bpt->val);
2877
2878       bpt->val = evaluate_expression (bpt->exp);
2879       release_value (bpt->val);
2880       if (VALUE_LAZY (bpt->val))
2881         value_fetch_lazy (bpt->val);
2882
2883       if (save_selected_frame_level >= 0)
2884         select_frame (save_selected_frame, save_selected_frame_level);
2885     }
2886 }
2887
2888 /* ARGSUSED */
2889 static void
2890 enable_command (args, from_tty)
2891      char *args;
2892      int from_tty;
2893 {
2894   struct breakpoint *bpt;
2895   if (args == 0)
2896     ALL_BREAKPOINTS (bpt)
2897       switch (bpt->type)
2898         {
2899         case bp_breakpoint:
2900         case bp_watchpoint:
2901           enable_breakpoint (bpt);
2902         default:
2903           continue;
2904         }
2905   else
2906     map_breakpoint_numbers (args, enable_breakpoint);
2907 }
2908
2909 static void
2910 disable_breakpoint (bpt)
2911      struct breakpoint *bpt;
2912 {
2913   bpt->enable = disabled;
2914
2915   if (xgdb_verbose && bpt->type == bp_breakpoint)
2916     printf_filtered ("breakpoint #%d disabled\n", bpt->number);
2917
2918   check_duplicates (bpt->address);
2919 }
2920
2921 /* ARGSUSED */
2922 static void
2923 disable_command (args, from_tty)
2924      char *args;
2925      int from_tty;
2926 {
2927   register struct breakpoint *bpt;
2928   if (args == 0)
2929     ALL_BREAKPOINTS (bpt)
2930       switch (bpt->type)
2931         {
2932         case bp_breakpoint:
2933         case bp_watchpoint:
2934           disable_breakpoint (bpt);
2935         default:
2936           continue;
2937         }
2938   else
2939     map_breakpoint_numbers (args, disable_breakpoint);
2940 }
2941
2942 static void
2943 enable_once_breakpoint (bpt)
2944      struct breakpoint *bpt;
2945 {
2946   bpt->enable = enabled;
2947   bpt->disposition = disable;
2948
2949   check_duplicates (bpt->address);
2950 }
2951
2952 /* ARGSUSED */
2953 static void
2954 enable_once_command (args, from_tty)
2955      char *args;
2956      int from_tty;
2957 {
2958   map_breakpoint_numbers (args, enable_once_breakpoint);
2959 }
2960
2961 static void
2962 enable_delete_breakpoint (bpt)
2963      struct breakpoint *bpt;
2964 {
2965   bpt->enable = enabled;
2966   bpt->disposition = delete;
2967
2968   check_duplicates (bpt->address);
2969 }
2970
2971 /* ARGSUSED */
2972 static void
2973 enable_delete_command (args, from_tty)
2974      char *args;
2975      int from_tty;
2976 {
2977   map_breakpoint_numbers (args, enable_delete_breakpoint);
2978 }
2979 \f
2980 /*
2981  * Use default_breakpoint_'s, or nothing if they aren't valid.
2982  */
2983 struct symtabs_and_lines
2984 decode_line_spec_1 (string, funfirstline)
2985      char *string;
2986      int funfirstline;
2987 {
2988   struct symtabs_and_lines sals;
2989   if (string == 0)
2990     error ("Empty line specification.");
2991   if (default_breakpoint_valid)
2992     sals = decode_line_1 (&string, funfirstline,
2993                           default_breakpoint_symtab, default_breakpoint_line,
2994                           (char ***)NULL);
2995   else
2996     sals = decode_line_1 (&string, funfirstline,
2997                           (struct symtab *)NULL, 0, (char ***)NULL);
2998   if (*string)
2999     error ("Junk at end of line specification: %s", string);
3000   return sals;
3001 }
3002 \f
3003 void
3004 _initialize_breakpoint ()
3005 {
3006   breakpoint_chain = 0;
3007   /* Don't bother to call set_breakpoint_count.  $bpnum isn't useful
3008      before a breakpoint is set.  */
3009   breakpoint_count = 0;
3010
3011   add_com ("ignore", class_breakpoint, ignore_command,
3012            "Set ignore-count of breakpoint number N to COUNT.");
3013
3014   add_com ("commands", class_breakpoint, commands_command,
3015            "Set commands to be executed when a breakpoint is hit.\n\
3016 Give breakpoint number as argument after \"commands\".\n\
3017 With no argument, the targeted breakpoint is the last one set.\n\
3018 The commands themselves follow starting on the next line.\n\
3019 Type a line containing \"end\" to indicate the end of them.\n\
3020 Give \"silent\" as the first line to make the breakpoint silent;\n\
3021 then no output is printed when it is hit, except what the commands print.");
3022
3023   add_com ("condition", class_breakpoint, condition_command,
3024            "Specify breakpoint number N to break only if COND is true.\n\
3025 N is an integer; COND is an expression to be evaluated whenever\n\
3026 breakpoint N is reached.  ");
3027
3028   add_com ("tbreak", class_breakpoint, tbreak_command,
3029            "Set a temporary breakpoint.  Args like \"break\" command.\n\
3030 Like \"break\" except the breakpoint is only enabled temporarily,\n\
3031 so it will be disabled when hit.  Equivalent to \"break\" followed\n\
3032 by using \"enable once\" on the breakpoint number.");
3033
3034   add_prefix_cmd ("enable", class_breakpoint, enable_command,
3035                   "Enable some breakpoints.\n\
3036 Give breakpoint numbers (separated by spaces) as arguments.\n\
3037 With no subcommand, breakpoints are enabled until you command otherwise.\n\
3038 This is used to cancel the effect of the \"disable\" command.\n\
3039 With a subcommand you can enable temporarily.",
3040                   &enablelist, "enable ", 1, &cmdlist);
3041
3042   add_abbrev_prefix_cmd ("breakpoints", class_breakpoint, enable_command,
3043                   "Enable some breakpoints.\n\
3044 Give breakpoint numbers (separated by spaces) as arguments.\n\
3045 This is used to cancel the effect of the \"disable\" command.\n\
3046 May be abbreviated to simply \"enable\".\n",
3047                   &enablebreaklist, "enable breakpoints ", 1, &enablelist);
3048
3049   add_cmd ("once", no_class, enable_once_command,
3050            "Enable breakpoints for one hit.  Give breakpoint numbers.\n\
3051 If a breakpoint is hit while enabled in this fashion, it becomes disabled.\n\
3052 See the \"tbreak\" command which sets a breakpoint and enables it once.",
3053            &enablebreaklist);
3054
3055   add_cmd ("delete", no_class, enable_delete_command,
3056            "Enable breakpoints and delete when hit.  Give breakpoint numbers.\n\
3057 If a breakpoint is hit while enabled in this fashion, it is deleted.",
3058            &enablebreaklist);
3059
3060   add_cmd ("delete", no_class, enable_delete_command,
3061            "Enable breakpoints and delete when hit.  Give breakpoint numbers.\n\
3062 If a breakpoint is hit while enabled in this fashion, it is deleted.",
3063            &enablelist);
3064
3065   add_cmd ("once", no_class, enable_once_command,
3066            "Enable breakpoints for one hit.  Give breakpoint numbers.\n\
3067 If a breakpoint is hit while enabled in this fashion, it becomes disabled.\n\
3068 See the \"tbreak\" command which sets a breakpoint and enables it once.",
3069            &enablelist);
3070
3071   add_prefix_cmd ("disable", class_breakpoint, disable_command,
3072            "Disable some breakpoints.\n\
3073 Arguments are breakpoint numbers with spaces in between.\n\
3074 To disable all breakpoints, give no argument.\n\
3075 A disabled breakpoint is not forgotten, but has no effect until reenabled.",
3076                   &disablelist, "disable ", 1, &cmdlist);
3077   add_com_alias ("dis", "disable", class_breakpoint, 1);
3078   add_com_alias ("disa", "disable", class_breakpoint, 1);
3079
3080   add_cmd ("breakpoints", class_alias, disable_command,
3081            "Disable some breakpoints.\n\
3082 Arguments are breakpoint numbers with spaces in between.\n\
3083 To disable all breakpoints, give no argument.\n\
3084 A disabled breakpoint is not forgotten, but has no effect until reenabled.\n\
3085 This command may be abbreviated \"disable\".",
3086            &disablelist);
3087
3088   add_prefix_cmd ("delete", class_breakpoint, delete_command,
3089            "Delete some breakpoints or auto-display expressions.\n\
3090 Arguments are breakpoint numbers with spaces in between.\n\
3091 To delete all breakpoints, give no argument.\n\
3092 \n\
3093 Also a prefix command for deletion of other GDB objects.\n\
3094 The \"unset\" command is also an alias for \"delete\".",
3095                   &deletelist, "delete ", 1, &cmdlist);
3096   add_com_alias ("d", "delete", class_breakpoint, 1);
3097
3098   add_cmd ("breakpoints", class_alias, delete_command,
3099            "Delete some breakpoints or auto-display expressions.\n\
3100 Arguments are breakpoint numbers with spaces in between.\n\
3101 To delete all breakpoints, give no argument.\n\
3102 This command may be abbreviated \"delete\".",
3103            &deletelist);
3104
3105   add_com ("clear", class_breakpoint, clear_command,
3106            "Clear breakpoint at specified line or function.\n\
3107 Argument may be line number, function name, or \"*\" and an address.\n\
3108 If line number is specified, all breakpoints in that line are cleared.\n\
3109 If function is specified, breakpoints at beginning of function are cleared.\n\
3110 If an address is specified, breakpoints at that address are cleared.\n\n\
3111 With no argument, clears all breakpoints in the line that the selected frame\n\
3112 is executing in.\n\
3113 \n\
3114 See also the \"delete\" command which clears breakpoints by number.");
3115
3116   add_com ("break", class_breakpoint, break_command,
3117            "Set breakpoint at specified line or function.\n\
3118 Argument may be line number, function name, or \"*\" and an address.\n\
3119 If line number is specified, break at start of code for that line.\n\
3120 If function is specified, break at start of code for that function.\n\
3121 If an address is specified, break at that exact address.\n\
3122 With no arg, uses current execution address of selected stack frame.\n\
3123 This is useful for breaking on return to a stack frame.\n\
3124 \n\
3125 Multiple breakpoints at one place are permitted, and useful if conditional.\n\
3126 \n\
3127 Do \"help breakpoints\" for info on other commands dealing with breakpoints.");
3128   add_com_alias ("b", "break", class_run, 1);
3129   add_com_alias ("br", "break", class_run, 1);
3130   add_com_alias ("bre", "break", class_run, 1);
3131   add_com_alias ("brea", "break", class_run, 1);
3132
3133   add_info ("breakpoints", breakpoints_info,
3134             "Status of user-settable breakpoints, or breakpoint number NUMBER.\n\
3135 The \"Type\" column indicates one of:\n\
3136 \tbreakpoint     - normal breakpoint\n\
3137 \twatchpoint     - watchpoint\n\
3138 The \"Disp\" column contains one of \"keep\", \"del\", or \"dis\" to indicate\n\
3139 the disposition of the breakpoint after it gets hit.  \"dis\" means that the\n\
3140 breakpoint will be disabled.  The \"Address\" and \"What\" columns indicate the\n\
3141 address and file/line number respectively.\n\n\
3142 Convenience variable \"$_\" and default examine address for \"x\"\n\
3143 are set to the address of the last breakpoint listed.\n\n\
3144 Convenience variable \"$bpnum\" contains the number of the last\n\
3145 breakpoint set.");
3146
3147 #if MAINTENANCE_CMDS
3148
3149   add_cmd ("breakpoints", class_maintenance, maintenance_info_breakpoints,
3150             "Status of all breakpoints, or breakpoint number NUMBER.\n\
3151 The \"Type\" column indicates one of:\n\
3152 \tbreakpoint     - normal breakpoint\n\
3153 \twatchpoint     - watchpoint\n\
3154 \tlongjmp        - internal breakpoint used to step through longjmp()\n\
3155 \tlongjmp resume - internal breakpoint at the target of longjmp()\n\
3156 \tuntil          - internal breakpoint used by the \"until\" command\n\
3157 \tfinish         - internal breakpoint used by the \"finish\" command\n\
3158 The \"Disp\" column contains one of \"keep\", \"del\", or \"dis\" to indicate\n\
3159 the disposition of the breakpoint after it gets hit.  \"dis\" means that the\n\
3160 breakpoint will be disabled.  The \"Address\" and \"What\" columns indicate the\n\
3161 address and file/line number respectively.\n\n\
3162 Convenience variable \"$_\" and default examine address for \"x\"\n\
3163 are set to the address of the last breakpoint listed.\n\n\
3164 Convenience variable \"$bpnum\" contains the number of the last\n\
3165 breakpoint set.",
3166            &maintenanceinfolist);
3167
3168 #endif  /* MAINTENANCE_CMDS */
3169
3170   add_com ("catch", class_breakpoint, catch_command,
3171          "Set breakpoints to catch exceptions that are raised.\n\
3172 Argument may be a single exception to catch, multiple exceptions\n\
3173 to catch, or the default exception \"default\".  If no arguments\n\
3174 are given, breakpoints are set at all exception handlers catch clauses\n\
3175 within the current scope.\n\
3176 \n\
3177 A condition specified for the catch applies to all breakpoints set\n\
3178 with this command\n\
3179 \n\
3180 Do \"help breakpoints\" for info on other commands dealing with breakpoints.");
3181
3182   add_com ("watch", class_breakpoint, watch_command,
3183            "Set a watchpoint for an expression.\n\
3184 A watchpoint stops execution of your program whenever the value of\n\
3185 an expression changes.");
3186
3187   add_info ("watchpoints", breakpoints_info,
3188             "Synonym for ``info breakpoints''.");
3189 }
3190
3191 /* OK, when we call objfile_relocate, we need to relocate breakpoints
3192    too.  breakpoint_re_set is not a good choice--for example, if
3193    addr_string contains just a line number without a file name the
3194    breakpoint might get set in a different file.  In general, there is
3195    no need to go all the way back to the user's string (though this might
3196    work if some effort were made to canonicalize it), since symtabs and
3197    everything except addresses are still valid.
3198
3199    Probably the best way to solve this is to have each breakpoint save
3200    the objfile and the section number that was used to set it (if set
3201    by "*addr", probably it is best to use find_pc_line to get a symtab
3202    and use the objfile and block_line_section for that symtab).  Then
3203    objfile_relocate can call fixup_breakpoints with the objfile and
3204    the new_offsets, and it can relocate only the appropriate breakpoints.  */
3205
3206 #ifdef IBM6000_TARGET
3207 /* But for now, just kludge it based on the concept that before an
3208    objfile is relocated the breakpoint is below 0x10000000, and afterwards
3209    it is higher, so that way we only relocate each breakpoint once.  */
3210
3211 void
3212 fixup_breakpoints (low, high, delta)
3213   CORE_ADDR low;
3214   CORE_ADDR high;
3215   CORE_ADDR delta;
3216 {
3217   struct breakpoint *b;
3218
3219   ALL_BREAKPOINTS (b)
3220     {
3221      if (b->address >= low && b->address <= high)
3222        b->address += delta;
3223     }
3224 }
3225 #endif