* symtab.h (enum address_class): Remove LOC_LOCAL_ARG.
[binutils-gdb.git] / gdb / tracepoint.c
1 /* Tracing functionality for remote targets in custom GDB protocol
2
3 Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
4 2007, 2008 Free Software Foundation, Inc.
5
6 This file is part of GDB.
7
8 This program is free software; you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation; either version 3 of the License, or
11 (at your option) any later version.
12
13 This program is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
17
18 You should have received a copy of the GNU General Public License
19 along with this program. If not, see <http://www.gnu.org/licenses/>. */
20
21 #include "defs.h"
22 #include "symtab.h"
23 #include "frame.h"
24 #include "gdbtypes.h"
25 #include "expression.h"
26 #include "gdbcmd.h"
27 #include "value.h"
28 #include "target.h"
29 #include "language.h"
30 #include "gdb_string.h"
31 #include "inferior.h"
32 #include "tracepoint.h"
33 #include "remote.h"
34 #include "linespec.h"
35 #include "regcache.h"
36 #include "completer.h"
37 #include "gdb-events.h"
38 #include "block.h"
39 #include "dictionary.h"
40
41 #include "ax.h"
42 #include "ax-gdb.h"
43
44 /* readline include files */
45 #include "readline/readline.h"
46 #include "readline/history.h"
47
48 /* readline defines this. */
49 #undef savestring
50
51 #ifdef HAVE_UNISTD_H
52 #include <unistd.h>
53 #endif
54
55 /* Maximum length of an agent aexpression.
56 This accounts for the fact that packets are limited to 400 bytes
57 (which includes everything -- including the checksum), and assumes
58 the worst case of maximum length for each of the pieces of a
59 continuation packet.
60
61 NOTE: expressions get mem2hex'ed otherwise this would be twice as
62 large. (400 - 31)/2 == 184 */
63 #define MAX_AGENT_EXPR_LEN 184
64
65
66 extern void (*deprecated_readline_begin_hook) (char *, ...);
67 extern char *(*deprecated_readline_hook) (char *);
68 extern void (*deprecated_readline_end_hook) (void);
69 extern int addressprint; /* Print machine addresses? */
70
71 /* GDB commands implemented in other modules:
72 */
73
74 extern void output_command (char *, int);
75
76 /*
77 Tracepoint.c:
78
79 This module defines the following debugger commands:
80 trace : set a tracepoint on a function, line, or address.
81 info trace : list all debugger-defined tracepoints.
82 delete trace : delete one or more tracepoints.
83 enable trace : enable one or more tracepoints.
84 disable trace : disable one or more tracepoints.
85 actions : specify actions to be taken at a tracepoint.
86 passcount : specify a pass count for a tracepoint.
87 tstart : start a trace experiment.
88 tstop : stop a trace experiment.
89 tstatus : query the status of a trace experiment.
90 tfind : find a trace frame in the trace buffer.
91 tdump : print everything collected at the current tracepoint.
92 save-tracepoints : write tracepoint setup into a file.
93
94 This module defines the following user-visible debugger variables:
95 $trace_frame : sequence number of trace frame currently being debugged.
96 $trace_line : source line of trace frame currently being debugged.
97 $trace_file : source file of trace frame currently being debugged.
98 $tracepoint : tracepoint number of trace frame currently being debugged.
99 */
100
101
102 /* ======= Important global variables: ======= */
103
104 /* Chain of all tracepoints defined. */
105 struct tracepoint *tracepoint_chain;
106
107 /* Number of last tracepoint made. */
108 static int tracepoint_count;
109
110 /* Number of last traceframe collected. */
111 static int traceframe_number;
112
113 /* Tracepoint for last traceframe collected. */
114 static int tracepoint_number;
115
116 /* Symbol for function for last traceframe collected */
117 static struct symbol *traceframe_fun;
118
119 /* Symtab and line for last traceframe collected */
120 static struct symtab_and_line traceframe_sal;
121
122 /* Tracing command lists */
123 static struct cmd_list_element *tfindlist;
124
125 /* ======= Important command functions: ======= */
126 static void trace_command (char *, int);
127 static void tracepoints_info (char *, int);
128 static void delete_trace_command (char *, int);
129 static void enable_trace_command (char *, int);
130 static void disable_trace_command (char *, int);
131 static void trace_pass_command (char *, int);
132 static void trace_actions_command (char *, int);
133 static void trace_start_command (char *, int);
134 static void trace_stop_command (char *, int);
135 static void trace_status_command (char *, int);
136 static void trace_find_command (char *, int);
137 static void trace_find_pc_command (char *, int);
138 static void trace_find_tracepoint_command (char *, int);
139 static void trace_find_line_command (char *, int);
140 static void trace_find_range_command (char *, int);
141 static void trace_find_outside_command (char *, int);
142 static void tracepoint_save_command (char *, int);
143 static void trace_dump_command (char *, int);
144
145 /* support routines */
146 static void trace_mention (struct tracepoint *);
147
148 struct collection_list;
149 static void add_aexpr (struct collection_list *, struct agent_expr *);
150 static char *mem2hex (gdb_byte *, char *, int);
151 static void add_register (struct collection_list *collection,
152 unsigned int regno);
153 static struct cleanup *make_cleanup_free_actions (struct tracepoint *t);
154 static void free_actions_list (char **actions_list);
155 static void free_actions_list_cleanup_wrapper (void *);
156
157 extern void _initialize_tracepoint (void);
158
159 /* Utility: returns true if "target remote" */
160 static int
161 target_is_remote (void)
162 {
163 if (current_target.to_shortname &&
164 (strcmp (current_target.to_shortname, "remote") == 0
165 || strcmp (current_target.to_shortname, "extended-remote") == 0))
166 return 1;
167 else
168 return 0;
169 }
170
171 /* Utility: generate error from an incoming stub packet. */
172 static void
173 trace_error (char *buf)
174 {
175 if (*buf++ != 'E')
176 return; /* not an error msg */
177 switch (*buf)
178 {
179 case '1': /* malformed packet error */
180 if (*++buf == '0') /* general case: */
181 error (_("tracepoint.c: error in outgoing packet."));
182 else
183 error (_("tracepoint.c: error in outgoing packet at field #%ld."),
184 strtol (buf, NULL, 16));
185 case '2':
186 error (_("trace API error 0x%s."), ++buf);
187 default:
188 error (_("Target returns error code '%s'."), buf);
189 }
190 }
191
192 /* Utility: wait for reply from stub, while accepting "O" packets. */
193 static char *
194 remote_get_noisy_reply (char **buf_p,
195 long *sizeof_buf)
196 {
197 do /* Loop on reply from remote stub. */
198 {
199 char *buf;
200 QUIT; /* allow user to bail out with ^C */
201 getpkt (buf_p, sizeof_buf, 0);
202 buf = *buf_p;
203 if (buf[0] == 0)
204 error (_("Target does not support this command."));
205 else if (buf[0] == 'E')
206 trace_error (buf);
207 else if (buf[0] == 'O' &&
208 buf[1] != 'K')
209 remote_console_output (buf + 1); /* 'O' message from stub */
210 else
211 return buf; /* here's the actual reply */
212 }
213 while (1);
214 }
215
216 /* Set tracepoint count to NUM. */
217 static void
218 set_tracepoint_count (int num)
219 {
220 tracepoint_count = num;
221 set_internalvar (lookup_internalvar ("tpnum"),
222 value_from_longest (builtin_type_int, (LONGEST) num));
223 }
224
225 /* Set traceframe number to NUM. */
226 static void
227 set_traceframe_num (int num)
228 {
229 traceframe_number = num;
230 set_internalvar (lookup_internalvar ("trace_frame"),
231 value_from_longest (builtin_type_int, (LONGEST) num));
232 }
233
234 /* Set tracepoint number to NUM. */
235 static void
236 set_tracepoint_num (int num)
237 {
238 tracepoint_number = num;
239 set_internalvar (lookup_internalvar ("tracepoint"),
240 value_from_longest (builtin_type_int,
241 (LONGEST) num));
242 }
243
244 /* Set externally visible debug variables for querying/printing
245 the traceframe context (line, function, file) */
246
247 static void
248 set_traceframe_context (CORE_ADDR trace_pc)
249 {
250 static struct type *func_string, *file_string;
251 static struct type *func_range, *file_range;
252 struct value *func_val;
253 struct value *file_val;
254 static struct type *charstar;
255 int len;
256
257 if (charstar == (struct type *) NULL)
258 charstar = lookup_pointer_type (builtin_type_char);
259
260 if (trace_pc == -1) /* Cease debugging any trace buffers. */
261 {
262 traceframe_fun = 0;
263 traceframe_sal.pc = traceframe_sal.line = 0;
264 traceframe_sal.symtab = NULL;
265 set_internalvar (lookup_internalvar ("trace_func"),
266 value_from_pointer (charstar, (LONGEST) 0));
267 set_internalvar (lookup_internalvar ("trace_file"),
268 value_from_pointer (charstar, (LONGEST) 0));
269 set_internalvar (lookup_internalvar ("trace_line"),
270 value_from_longest (builtin_type_int,
271 (LONGEST) - 1));
272 return;
273 }
274
275 /* Save as globals for internal use. */
276 traceframe_sal = find_pc_line (trace_pc, 0);
277 traceframe_fun = find_pc_function (trace_pc);
278
279 /* Save linenumber as "$trace_line", a debugger variable visible to
280 users. */
281 set_internalvar (lookup_internalvar ("trace_line"),
282 value_from_longest (builtin_type_int,
283 (LONGEST) traceframe_sal.line));
284
285 /* Save func name as "$trace_func", a debugger variable visible to
286 users. */
287 if (traceframe_fun == NULL ||
288 DEPRECATED_SYMBOL_NAME (traceframe_fun) == NULL)
289 set_internalvar (lookup_internalvar ("trace_func"),
290 value_from_pointer (charstar, (LONGEST) 0));
291 else
292 {
293 len = strlen (DEPRECATED_SYMBOL_NAME (traceframe_fun));
294 func_range = create_range_type (func_range,
295 builtin_type_int, 0, len - 1);
296 func_string = create_array_type (func_string,
297 builtin_type_char, func_range);
298 func_val = allocate_value (func_string);
299 deprecated_set_value_type (func_val, func_string);
300 memcpy (value_contents_raw (func_val),
301 DEPRECATED_SYMBOL_NAME (traceframe_fun),
302 len);
303 deprecated_set_value_modifiable (func_val, 0);
304 set_internalvar (lookup_internalvar ("trace_func"), func_val);
305 }
306
307 /* Save file name as "$trace_file", a debugger variable visible to
308 users. */
309 if (traceframe_sal.symtab == NULL ||
310 traceframe_sal.symtab->filename == NULL)
311 set_internalvar (lookup_internalvar ("trace_file"),
312 value_from_pointer (charstar, (LONGEST) 0));
313 else
314 {
315 len = strlen (traceframe_sal.symtab->filename);
316 file_range = create_range_type (file_range,
317 builtin_type_int, 0, len - 1);
318 file_string = create_array_type (file_string,
319 builtin_type_char, file_range);
320 file_val = allocate_value (file_string);
321 deprecated_set_value_type (file_val, file_string);
322 memcpy (value_contents_raw (file_val),
323 traceframe_sal.symtab->filename,
324 len);
325 deprecated_set_value_modifiable (file_val, 0);
326 set_internalvar (lookup_internalvar ("trace_file"), file_val);
327 }
328 }
329
330 /* Low level routine to set a tracepoint.
331 Returns the tracepoint object so caller can set other things.
332 Does not set the tracepoint number!
333 Does not print anything.
334
335 ==> This routine should not be called if there is a chance of later
336 error(); otherwise it leaves a bogus tracepoint on the chain.
337 Validate your arguments BEFORE calling this routine! */
338
339 static struct tracepoint *
340 set_raw_tracepoint (struct symtab_and_line sal)
341 {
342 struct tracepoint *t, *tc;
343 struct cleanup *old_chain;
344
345 t = (struct tracepoint *) xmalloc (sizeof (struct tracepoint));
346 old_chain = make_cleanup (xfree, t);
347 memset (t, 0, sizeof (*t));
348 t->address = sal.pc;
349 if (sal.symtab == NULL)
350 t->source_file = NULL;
351 else
352 t->source_file = savestring (sal.symtab->filename,
353 strlen (sal.symtab->filename));
354
355 t->section = sal.section;
356 t->language = current_language->la_language;
357 t->input_radix = input_radix;
358 t->line_number = sal.line;
359 t->enabled_p = 1;
360 t->next = 0;
361 t->step_count = 0;
362 t->pass_count = 0;
363 t->addr_string = NULL;
364
365 /* Add this tracepoint to the end of the chain
366 so that a list of tracepoints will come out in order
367 of increasing numbers. */
368
369 tc = tracepoint_chain;
370 if (tc == 0)
371 tracepoint_chain = t;
372 else
373 {
374 while (tc->next)
375 tc = tc->next;
376 tc->next = t;
377 }
378 discard_cleanups (old_chain);
379 return t;
380 }
381
382 /* Set a tracepoint according to ARG (function, linenum or *address). */
383 static void
384 trace_command (char *arg, int from_tty)
385 {
386 char **canonical = (char **) NULL;
387 struct symtabs_and_lines sals;
388 struct symtab_and_line sal;
389 struct tracepoint *t;
390 char *addr_start = 0, *addr_end = 0;
391 int i;
392
393 if (!arg || !*arg)
394 error (_("trace command requires an argument"));
395
396 if (from_tty && info_verbose)
397 printf_filtered ("TRACE %s\n", arg);
398
399 addr_start = arg;
400 sals = decode_line_1 (&arg, 1, (struct symtab *) NULL,
401 0, &canonical, NULL);
402 addr_end = arg;
403 if (!sals.nelts)
404 return; /* ??? Presumably decode_line_1 has already warned? */
405
406 /* Resolve all line numbers to PC's */
407 for (i = 0; i < sals.nelts; i++)
408 resolve_sal_pc (&sals.sals[i]);
409
410 /* Now set all the tracepoints. */
411 for (i = 0; i < sals.nelts; i++)
412 {
413 sal = sals.sals[i];
414
415 t = set_raw_tracepoint (sal);
416 set_tracepoint_count (tracepoint_count + 1);
417 t->number = tracepoint_count;
418
419 /* If a canonical line spec is needed use that instead of the
420 command string. */
421 if (canonical != (char **) NULL && canonical[i] != NULL)
422 t->addr_string = canonical[i];
423 else if (addr_start)
424 t->addr_string = savestring (addr_start, addr_end - addr_start);
425
426 trace_mention (t);
427 }
428
429 if (sals.nelts > 1)
430 {
431 printf_filtered ("Multiple tracepoints were set.\n");
432 printf_filtered ("Use 'delete trace' to delete unwanted tracepoints.\n");
433 }
434 }
435
436 /* Tell the user we have just set a tracepoint TP. */
437
438 static void
439 trace_mention (struct tracepoint *tp)
440 {
441 printf_filtered ("Tracepoint %d", tp->number);
442
443 if (addressprint || (tp->source_file == NULL))
444 {
445 printf_filtered (" at ");
446 printf_filtered ("%s", paddress (tp->address));
447 }
448 if (tp->source_file)
449 printf_filtered (": file %s, line %d.",
450 tp->source_file, tp->line_number);
451
452 printf_filtered ("\n");
453 }
454
455 /* Print information on tracepoint number TPNUM_EXP, or all if
456 omitted. */
457
458 static void
459 tracepoints_info (char *tpnum_exp, int from_tty)
460 {
461 struct tracepoint *t;
462 struct action_line *action;
463 int found_a_tracepoint = 0;
464 char wrap_indent[80];
465 struct symbol *sym;
466 int tpnum = -1;
467
468 if (tpnum_exp)
469 tpnum = parse_and_eval_long (tpnum_exp);
470
471 ALL_TRACEPOINTS (t)
472 if (tpnum == -1 || tpnum == t->number)
473 {
474 extern int addressprint; /* Print machine addresses? */
475
476 if (!found_a_tracepoint++)
477 {
478 printf_filtered ("Num Enb ");
479 if (addressprint)
480 {
481 if (gdbarch_addr_bit (current_gdbarch) <= 32)
482 printf_filtered ("Address ");
483 else
484 printf_filtered ("Address ");
485 }
486 printf_filtered ("PassC StepC What\n");
487 }
488 strcpy (wrap_indent, " ");
489 if (addressprint)
490 {
491 if (gdbarch_addr_bit (current_gdbarch) <= 32)
492 strcat (wrap_indent, " ");
493 else
494 strcat (wrap_indent, " ");
495 }
496
497 printf_filtered ("%-3d %-3s ", t->number,
498 t->enabled_p ? "y" : "n");
499 if (addressprint)
500 {
501 char *tmp;
502
503 if (gdbarch_addr_bit (current_gdbarch) <= 32)
504 tmp = hex_string_custom (t->address & (CORE_ADDR) 0xffffffff,
505 8);
506 else
507 tmp = hex_string_custom (t->address, 16);
508
509 printf_filtered ("%s ", tmp);
510 }
511 printf_filtered ("%-5d %-5ld ", t->pass_count, t->step_count);
512
513 if (t->source_file)
514 {
515 sym = find_pc_sect_function (t->address, t->section);
516 if (sym)
517 {
518 fputs_filtered ("in ", gdb_stdout);
519 fputs_filtered (SYMBOL_PRINT_NAME (sym), gdb_stdout);
520 wrap_here (wrap_indent);
521 fputs_filtered (" at ", gdb_stdout);
522 }
523 fputs_filtered (t->source_file, gdb_stdout);
524 printf_filtered (":%d", t->line_number);
525 }
526 else
527 print_address_symbolic (t->address, gdb_stdout, demangle, " ");
528
529 printf_filtered ("\n");
530 if (t->actions)
531 {
532 printf_filtered (" Actions for tracepoint %d: \n", t->number);
533 for (action = t->actions; action; action = action->next)
534 {
535 printf_filtered ("\t%s\n", action->action);
536 }
537 }
538 }
539 if (!found_a_tracepoint)
540 {
541 if (tpnum == -1)
542 printf_filtered ("No tracepoints.\n");
543 else
544 printf_filtered ("No tracepoint number %d.\n", tpnum);
545 }
546 }
547
548 /* Optimization: the code to parse an enable, disable, or delete TP
549 command is virtually identical except for whether it performs an
550 enable, disable, or delete. Therefore I've combined them into one
551 function with an opcode. */
552 enum tracepoint_opcode
553 {
554 enable_op,
555 disable_op,
556 delete_op
557 };
558
559 /* This function implements enable, disable and delete commands. */
560 static void
561 tracepoint_operation (struct tracepoint *t, int from_tty,
562 enum tracepoint_opcode opcode)
563 {
564 struct tracepoint *t2;
565
566 if (t == NULL) /* no tracepoint operand */
567 return;
568
569 switch (opcode)
570 {
571 case enable_op:
572 t->enabled_p = 1;
573 tracepoint_modify_event (t->number);
574 break;
575 case disable_op:
576 t->enabled_p = 0;
577 tracepoint_modify_event (t->number);
578 break;
579 case delete_op:
580 if (tracepoint_chain == t)
581 tracepoint_chain = t->next;
582
583 ALL_TRACEPOINTS (t2)
584 if (t2->next == t)
585 {
586 t2->next = t->next;
587 break;
588 }
589
590 tracepoint_delete_event (t->number);
591
592 if (t->addr_string)
593 xfree (t->addr_string);
594 if (t->source_file)
595 xfree (t->source_file);
596 if (t->actions)
597 free_actions (t);
598
599 xfree (t);
600 break;
601 }
602 }
603
604 /* Utility: parse a tracepoint number and look it up in the list.
605 If MULTI_P is true, there might be a range of tracepoints in ARG.
606 if OPTIONAL_P is true, then if the argument is missing, the most
607 recent tracepoint (tracepoint_count) is returned. */
608 struct tracepoint *
609 get_tracepoint_by_number (char **arg, int multi_p, int optional_p)
610 {
611 struct tracepoint *t;
612 int tpnum;
613 char *instring = arg == NULL ? NULL : *arg;
614
615 if (arg == NULL || *arg == NULL || ! **arg)
616 {
617 if (optional_p)
618 tpnum = tracepoint_count;
619 else
620 error_no_arg (_("tracepoint number"));
621 }
622 else
623 tpnum = multi_p ? get_number_or_range (arg) : get_number (arg);
624
625 if (tpnum <= 0)
626 {
627 if (instring && *instring)
628 printf_filtered ("bad tracepoint number at or near '%s'\n",
629 instring);
630 else
631 printf_filtered ("Tracepoint argument missing and no previous tracepoint\n");
632 return NULL;
633 }
634
635 ALL_TRACEPOINTS (t)
636 if (t->number == tpnum)
637 {
638 return t;
639 }
640
641 /* FIXME: if we are in the middle of a range we don't want to give
642 a message. The current interface to get_number_or_range doesn't
643 allow us to discover this. */
644 printf_unfiltered ("No tracepoint number %d.\n", tpnum);
645 return NULL;
646 }
647
648 /* Utility:
649 parse a list of tracepoint numbers, and call a func for each. */
650 static void
651 map_args_over_tracepoints (char *args, int from_tty,
652 enum tracepoint_opcode opcode)
653 {
654 struct tracepoint *t, *tmp;
655
656 if (args == 0 || *args == 0) /* do them all */
657 ALL_TRACEPOINTS_SAFE (t, tmp)
658 tracepoint_operation (t, from_tty, opcode);
659 else
660 while (*args)
661 {
662 QUIT; /* Give user option to bail out with ^C. */
663 t = get_tracepoint_by_number (&args, 1, 0);
664 tracepoint_operation (t, from_tty, opcode);
665 while (*args == ' ' || *args == '\t')
666 args++;
667 }
668 }
669
670 /* The 'enable trace' command enables tracepoints.
671 Not supported by all targets. */
672 static void
673 enable_trace_command (char *args, int from_tty)
674 {
675 dont_repeat ();
676 map_args_over_tracepoints (args, from_tty, enable_op);
677 }
678
679 /* The 'disable trace' command disables tracepoints.
680 Not supported by all targets. */
681 static void
682 disable_trace_command (char *args, int from_tty)
683 {
684 dont_repeat ();
685 map_args_over_tracepoints (args, from_tty, disable_op);
686 }
687
688 /* Remove a tracepoint (or all if no argument) */
689 static void
690 delete_trace_command (char *args, int from_tty)
691 {
692 dont_repeat ();
693 if (!args || !*args) /* No args implies all tracepoints; */
694 if (from_tty) /* confirm only if from_tty... */
695 if (tracepoint_chain) /* and if there are tracepoints to
696 delete! */
697 if (!query ("Delete all tracepoints? "))
698 return;
699
700 map_args_over_tracepoints (args, from_tty, delete_op);
701 }
702
703 /* Set passcount for tracepoint.
704
705 First command argument is passcount, second is tracepoint number.
706 If tracepoint number omitted, apply to most recently defined.
707 Also accepts special argument "all". */
708
709 static void
710 trace_pass_command (char *args, int from_tty)
711 {
712 struct tracepoint *t1 = (struct tracepoint *) -1, *t2;
713 unsigned int count;
714 int all = 0;
715
716 if (args == 0 || *args == 0)
717 error (_("passcount command requires an argument (count + optional TP num)"));
718
719 count = strtoul (args, &args, 10); /* Count comes first, then TP num. */
720
721 while (*args && isspace ((int) *args))
722 args++;
723
724 if (*args && strncasecmp (args, "all", 3) == 0)
725 {
726 args += 3; /* Skip special argument "all". */
727 all = 1;
728 if (*args)
729 error (_("Junk at end of arguments."));
730 }
731 else
732 t1 = get_tracepoint_by_number (&args, 1, 1);
733
734 do
735 {
736 if (t1)
737 {
738 ALL_TRACEPOINTS (t2)
739 if (t1 == (struct tracepoint *) -1 || t1 == t2)
740 {
741 t2->pass_count = count;
742 tracepoint_modify_event (t2->number);
743 if (from_tty)
744 printf_filtered ("Setting tracepoint %d's passcount to %d\n",
745 t2->number, count);
746 }
747 if (! all && *args)
748 t1 = get_tracepoint_by_number (&args, 1, 0);
749 }
750 }
751 while (*args);
752 }
753
754 /* ACTIONS functions: */
755
756 /* Prototypes for action-parsing utility commands */
757 static void read_actions (struct tracepoint *);
758
759 /* The three functions:
760 collect_pseudocommand,
761 while_stepping_pseudocommand, and
762 end_actions_pseudocommand
763 are placeholders for "commands" that are actually ONLY to be used
764 within a tracepoint action list. If the actual function is ever called,
765 it means that somebody issued the "command" at the top level,
766 which is always an error. */
767
768 static void
769 end_actions_pseudocommand (char *args, int from_tty)
770 {
771 error (_("This command cannot be used at the top level."));
772 }
773
774 static void
775 while_stepping_pseudocommand (char *args, int from_tty)
776 {
777 error (_("This command can only be used in a tracepoint actions list."));
778 }
779
780 static void
781 collect_pseudocommand (char *args, int from_tty)
782 {
783 error (_("This command can only be used in a tracepoint actions list."));
784 }
785
786 /* Enter a list of actions for a tracepoint. */
787 static void
788 trace_actions_command (char *args, int from_tty)
789 {
790 struct tracepoint *t;
791 char tmpbuf[128];
792 char *end_msg = "End with a line saying just \"end\".";
793
794 t = get_tracepoint_by_number (&args, 0, 1);
795 if (t)
796 {
797 sprintf (tmpbuf, "Enter actions for tracepoint %d, one per line.",
798 t->number);
799
800 if (from_tty)
801 {
802 if (deprecated_readline_begin_hook)
803 (*deprecated_readline_begin_hook) ("%s %s\n", tmpbuf, end_msg);
804 else if (input_from_terminal_p ())
805 printf_filtered ("%s\n%s\n", tmpbuf, end_msg);
806 }
807
808 free_actions (t);
809 t->step_count = 0; /* read_actions may set this */
810 read_actions (t);
811
812 if (deprecated_readline_end_hook)
813 (*deprecated_readline_end_hook) ();
814 /* tracepoints_changed () */
815 }
816 /* else just return */
817 }
818
819 /* worker function */
820 static void
821 read_actions (struct tracepoint *t)
822 {
823 char *line;
824 char *prompt1 = "> ", *prompt2 = " > ";
825 char *prompt = prompt1;
826 enum actionline_type linetype;
827 extern FILE *instream;
828 struct action_line *next = NULL, *temp;
829 struct cleanup *old_chain;
830
831 /* Control-C quits instantly if typed while in this loop
832 since it should not wait until the user types a newline. */
833 immediate_quit++;
834 /* FIXME: kettenis/20010823: Something is wrong here. In this file
835 STOP_SIGNAL is never defined. So this code has been left out, at
836 least for quite a while now. Replacing STOP_SIGNAL with SIGTSTP
837 leads to compilation failures since the variable job_control
838 isn't declared. Leave this alone for now. */
839 #ifdef STOP_SIGNAL
840 if (job_control)
841 signal (STOP_SIGNAL, handle_stop_sig);
842 #endif
843 old_chain = make_cleanup_free_actions (t);
844 while (1)
845 {
846 /* Make sure that all output has been output. Some machines may
847 let you get away with leaving out some of the gdb_flush, but
848 not all. */
849 wrap_here ("");
850 gdb_flush (gdb_stdout);
851 gdb_flush (gdb_stderr);
852
853 if (deprecated_readline_hook && instream == NULL)
854 line = (*deprecated_readline_hook) (prompt);
855 else if (instream == stdin && ISATTY (instream))
856 {
857 line = gdb_readline_wrapper (prompt);
858 if (line && *line) /* add it to command history */
859 add_history (line);
860 }
861 else
862 line = gdb_readline (0);
863
864 if (!line)
865 {
866 line = xstrdup ("end");
867 printf_filtered ("end\n");
868 }
869
870 linetype = validate_actionline (&line, t);
871 if (linetype == BADLINE)
872 continue; /* already warned -- collect another line */
873
874 temp = xmalloc (sizeof (struct action_line));
875 temp->next = NULL;
876 temp->action = line;
877
878 if (next == NULL) /* first action for this tracepoint? */
879 t->actions = next = temp;
880 else
881 {
882 next->next = temp;
883 next = temp;
884 }
885
886 if (linetype == STEPPING) /* begin "while-stepping" */
887 {
888 if (prompt == prompt2)
889 {
890 warning (_("Already processing 'while-stepping'"));
891 continue;
892 }
893 else
894 prompt = prompt2; /* change prompt for stepping actions */
895 }
896 else if (linetype == END)
897 {
898 if (prompt == prompt2)
899 {
900 prompt = prompt1; /* end of single-stepping actions */
901 }
902 else
903 { /* end of actions */
904 if (t->actions->next == NULL)
905 {
906 /* An "end" all by itself with no other actions
907 means this tracepoint has no actions.
908 Discard empty list. */
909 free_actions (t);
910 }
911 break;
912 }
913 }
914 }
915 #ifdef STOP_SIGNAL
916 if (job_control)
917 signal (STOP_SIGNAL, SIG_DFL);
918 #endif
919 immediate_quit--;
920 discard_cleanups (old_chain);
921 }
922
923 /* worker function */
924 enum actionline_type
925 validate_actionline (char **line, struct tracepoint *t)
926 {
927 struct cmd_list_element *c;
928 struct expression *exp = NULL;
929 struct cleanup *old_chain = NULL;
930 char *p;
931
932 /* if EOF is typed, *line is NULL */
933 if (*line == NULL)
934 return END;
935
936 for (p = *line; isspace ((int) *p);)
937 p++;
938
939 /* Symbol lookup etc. */
940 if (*p == '\0') /* empty line: just prompt for another line. */
941 return BADLINE;
942
943 if (*p == '#') /* comment line */
944 return GENERIC;
945
946 c = lookup_cmd (&p, cmdlist, "", -1, 1);
947 if (c == 0)
948 {
949 warning (_("'%s' is not an action that I know, or is ambiguous."),
950 p);
951 return BADLINE;
952 }
953
954 if (cmd_cfunc_eq (c, collect_pseudocommand))
955 {
956 struct agent_expr *aexpr;
957 struct agent_reqs areqs;
958
959 do
960 { /* repeat over a comma-separated list */
961 QUIT; /* allow user to bail out with ^C */
962 while (isspace ((int) *p))
963 p++;
964
965 if (*p == '$') /* look for special pseudo-symbols */
966 {
967 if ((0 == strncasecmp ("reg", p + 1, 3)) ||
968 (0 == strncasecmp ("arg", p + 1, 3)) ||
969 (0 == strncasecmp ("loc", p + 1, 3)))
970 {
971 p = strchr (p, ',');
972 continue;
973 }
974 /* else fall thru, treat p as an expression and parse it! */
975 }
976 exp = parse_exp_1 (&p, block_for_pc (t->address), 1);
977 old_chain = make_cleanup (free_current_contents, &exp);
978
979 if (exp->elts[0].opcode == OP_VAR_VALUE)
980 {
981 if (SYMBOL_CLASS (exp->elts[2].symbol) == LOC_CONST)
982 {
983 warning (_("constant %s (value %ld) will not be collected."),
984 DEPRECATED_SYMBOL_NAME (exp->elts[2].symbol),
985 SYMBOL_VALUE (exp->elts[2].symbol));
986 return BADLINE;
987 }
988 else if (SYMBOL_CLASS (exp->elts[2].symbol) == LOC_OPTIMIZED_OUT)
989 {
990 warning (_("%s is optimized away and cannot be collected."),
991 DEPRECATED_SYMBOL_NAME (exp->elts[2].symbol));
992 return BADLINE;
993 }
994 }
995
996 /* We have something to collect, make sure that the expr to
997 bytecode translator can handle it and that it's not too
998 long. */
999 aexpr = gen_trace_for_expr (t->address, exp);
1000 make_cleanup_free_agent_expr (aexpr);
1001
1002 if (aexpr->len > MAX_AGENT_EXPR_LEN)
1003 error (_("expression too complicated, try simplifying"));
1004
1005 ax_reqs (aexpr, &areqs);
1006 (void) make_cleanup (xfree, areqs.reg_mask);
1007
1008 if (areqs.flaw != agent_flaw_none)
1009 error (_("malformed expression"));
1010
1011 if (areqs.min_height < 0)
1012 error (_("gdb: Internal error: expression has min height < 0"));
1013
1014 if (areqs.max_height > 20)
1015 error (_("expression too complicated, try simplifying"));
1016
1017 do_cleanups (old_chain);
1018 }
1019 while (p && *p++ == ',');
1020 return GENERIC;
1021 }
1022 else if (cmd_cfunc_eq (c, while_stepping_pseudocommand))
1023 {
1024 char *steparg; /* in case warning is necessary */
1025
1026 while (isspace ((int) *p))
1027 p++;
1028 steparg = p;
1029
1030 if (*p == '\0' ||
1031 (t->step_count = strtol (p, &p, 0)) == 0)
1032 {
1033 warning (_("'%s': bad step-count; command ignored."), *line);
1034 return BADLINE;
1035 }
1036 return STEPPING;
1037 }
1038 else if (cmd_cfunc_eq (c, end_actions_pseudocommand))
1039 return END;
1040 else
1041 {
1042 warning (_("'%s' is not a supported tracepoint action."), *line);
1043 return BADLINE;
1044 }
1045 }
1046
1047 /* worker function */
1048 void
1049 free_actions (struct tracepoint *t)
1050 {
1051 struct action_line *line, *next;
1052
1053 for (line = t->actions; line; line = next)
1054 {
1055 next = line->next;
1056 if (line->action)
1057 xfree (line->action);
1058 xfree (line);
1059 }
1060 t->actions = NULL;
1061 }
1062
1063 static void
1064 do_free_actions_cleanup (void *t)
1065 {
1066 free_actions (t);
1067 }
1068
1069 static struct cleanup *
1070 make_cleanup_free_actions (struct tracepoint *t)
1071 {
1072 return make_cleanup (do_free_actions_cleanup, t);
1073 }
1074
1075 enum {
1076 memrange_absolute = -1
1077 };
1078
1079 struct memrange
1080 {
1081 int type; /* memrange_absolute for absolute memory range,
1082 else basereg number */
1083 bfd_signed_vma start;
1084 bfd_signed_vma end;
1085 };
1086
1087 struct collection_list
1088 {
1089 unsigned char regs_mask[32]; /* room for up to 256 regs */
1090 long listsize;
1091 long next_memrange;
1092 struct memrange *list;
1093 long aexpr_listsize; /* size of array pointed to by expr_list elt */
1094 long next_aexpr_elt;
1095 struct agent_expr **aexpr_list;
1096
1097 }
1098 tracepoint_list, stepping_list;
1099
1100 /* MEMRANGE functions: */
1101
1102 static int memrange_cmp (const void *, const void *);
1103
1104 /* compare memranges for qsort */
1105 static int
1106 memrange_cmp (const void *va, const void *vb)
1107 {
1108 const struct memrange *a = va, *b = vb;
1109
1110 if (a->type < b->type)
1111 return -1;
1112 if (a->type > b->type)
1113 return 1;
1114 if (a->type == memrange_absolute)
1115 {
1116 if ((bfd_vma) a->start < (bfd_vma) b->start)
1117 return -1;
1118 if ((bfd_vma) a->start > (bfd_vma) b->start)
1119 return 1;
1120 }
1121 else
1122 {
1123 if (a->start < b->start)
1124 return -1;
1125 if (a->start > b->start)
1126 return 1;
1127 }
1128 return 0;
1129 }
1130
1131 /* Sort the memrange list using qsort, and merge adjacent memranges. */
1132 static void
1133 memrange_sortmerge (struct collection_list *memranges)
1134 {
1135 int a, b;
1136
1137 qsort (memranges->list, memranges->next_memrange,
1138 sizeof (struct memrange), memrange_cmp);
1139 if (memranges->next_memrange > 0)
1140 {
1141 for (a = 0, b = 1; b < memranges->next_memrange; b++)
1142 {
1143 if (memranges->list[a].type == memranges->list[b].type &&
1144 memranges->list[b].start - memranges->list[a].end <=
1145 MAX_REGISTER_SIZE)
1146 {
1147 /* memrange b starts before memrange a ends; merge them. */
1148 if (memranges->list[b].end > memranges->list[a].end)
1149 memranges->list[a].end = memranges->list[b].end;
1150 continue; /* next b, same a */
1151 }
1152 a++; /* next a */
1153 if (a != b)
1154 memcpy (&memranges->list[a], &memranges->list[b],
1155 sizeof (struct memrange));
1156 }
1157 memranges->next_memrange = a + 1;
1158 }
1159 }
1160
1161 /* Add a register to a collection list. */
1162 static void
1163 add_register (struct collection_list *collection, unsigned int regno)
1164 {
1165 if (info_verbose)
1166 printf_filtered ("collect register %d\n", regno);
1167 if (regno >= (8 * sizeof (collection->regs_mask)))
1168 error (_("Internal: register number %d too large for tracepoint"),
1169 regno);
1170 collection->regs_mask[regno / 8] |= 1 << (regno % 8);
1171 }
1172
1173 /* Add a memrange to a collection list */
1174 static void
1175 add_memrange (struct collection_list *memranges,
1176 int type, bfd_signed_vma base,
1177 unsigned long len)
1178 {
1179 if (info_verbose)
1180 {
1181 printf_filtered ("(%d,", type);
1182 printf_vma (base);
1183 printf_filtered (",%ld)\n", len);
1184 }
1185
1186 /* type: memrange_absolute == memory, other n == basereg */
1187 memranges->list[memranges->next_memrange].type = type;
1188 /* base: addr if memory, offset if reg relative. */
1189 memranges->list[memranges->next_memrange].start = base;
1190 /* len: we actually save end (base + len) for convenience */
1191 memranges->list[memranges->next_memrange].end = base + len;
1192 memranges->next_memrange++;
1193 if (memranges->next_memrange >= memranges->listsize)
1194 {
1195 memranges->listsize *= 2;
1196 memranges->list = xrealloc (memranges->list,
1197 memranges->listsize);
1198 }
1199
1200 if (type != memrange_absolute) /* Better collect the base register! */
1201 add_register (memranges, type);
1202 }
1203
1204 /* Add a symbol to a collection list. */
1205 static void
1206 collect_symbol (struct collection_list *collect,
1207 struct symbol *sym,
1208 long frame_regno, long frame_offset)
1209 {
1210 unsigned long len;
1211 unsigned int reg;
1212 bfd_signed_vma offset;
1213
1214 len = TYPE_LENGTH (check_typedef (SYMBOL_TYPE (sym)));
1215 switch (SYMBOL_CLASS (sym))
1216 {
1217 default:
1218 printf_filtered ("%s: don't know symbol class %d\n",
1219 DEPRECATED_SYMBOL_NAME (sym),
1220 SYMBOL_CLASS (sym));
1221 break;
1222 case LOC_CONST:
1223 printf_filtered ("constant %s (value %ld) will not be collected.\n",
1224 DEPRECATED_SYMBOL_NAME (sym), SYMBOL_VALUE (sym));
1225 break;
1226 case LOC_STATIC:
1227 offset = SYMBOL_VALUE_ADDRESS (sym);
1228 if (info_verbose)
1229 {
1230 char tmp[40];
1231
1232 sprintf_vma (tmp, offset);
1233 printf_filtered ("LOC_STATIC %s: collect %ld bytes at %s.\n",
1234 DEPRECATED_SYMBOL_NAME (sym), len,
1235 tmp /* address */);
1236 }
1237 add_memrange (collect, memrange_absolute, offset, len);
1238 break;
1239 case LOC_REGISTER:
1240 case LOC_REGPARM:
1241 reg = SYMBOL_VALUE (sym);
1242 if (info_verbose)
1243 printf_filtered ("LOC_REG[parm] %s: ",
1244 DEPRECATED_SYMBOL_NAME (sym));
1245 add_register (collect, reg);
1246 /* Check for doubles stored in two registers. */
1247 /* FIXME: how about larger types stored in 3 or more regs? */
1248 if (TYPE_CODE (SYMBOL_TYPE (sym)) == TYPE_CODE_FLT &&
1249 len > register_size (current_gdbarch, reg))
1250 add_register (collect, reg + 1);
1251 break;
1252 case LOC_REF_ARG:
1253 printf_filtered ("Sorry, don't know how to do LOC_REF_ARG yet.\n");
1254 printf_filtered (" (will not collect %s)\n",
1255 DEPRECATED_SYMBOL_NAME (sym));
1256 break;
1257 case LOC_ARG:
1258 reg = frame_regno;
1259 offset = frame_offset + SYMBOL_VALUE (sym);
1260 if (info_verbose)
1261 {
1262 printf_filtered ("LOC_LOCAL %s: Collect %ld bytes at offset ",
1263 DEPRECATED_SYMBOL_NAME (sym), len);
1264 printf_vma (offset);
1265 printf_filtered (" from frame ptr reg %d\n", reg);
1266 }
1267 add_memrange (collect, reg, offset, len);
1268 break;
1269 case LOC_REGPARM_ADDR:
1270 reg = SYMBOL_VALUE (sym);
1271 offset = 0;
1272 if (info_verbose)
1273 {
1274 printf_filtered ("LOC_REGPARM_ADDR %s: Collect %ld bytes at offset ",
1275 DEPRECATED_SYMBOL_NAME (sym), len);
1276 printf_vma (offset);
1277 printf_filtered (" from reg %d\n", reg);
1278 }
1279 add_memrange (collect, reg, offset, len);
1280 break;
1281 case LOC_LOCAL:
1282 reg = frame_regno;
1283 offset = frame_offset + SYMBOL_VALUE (sym);
1284 if (info_verbose)
1285 {
1286 printf_filtered ("LOC_LOCAL %s: Collect %ld bytes at offset ",
1287 DEPRECATED_SYMBOL_NAME (sym), len);
1288 printf_vma (offset);
1289 printf_filtered (" from frame ptr reg %d\n", reg);
1290 }
1291 add_memrange (collect, reg, offset, len);
1292 break;
1293 case LOC_BASEREG:
1294 case LOC_BASEREG_ARG:
1295 reg = SYMBOL_BASEREG (sym);
1296 offset = SYMBOL_VALUE (sym);
1297 if (info_verbose)
1298 {
1299 printf_filtered ("LOC_BASEREG %s: collect %ld bytes at offset ",
1300 DEPRECATED_SYMBOL_NAME (sym), len);
1301 printf_vma (offset);
1302 printf_filtered (" from basereg %d\n", reg);
1303 }
1304 add_memrange (collect, reg, offset, len);
1305 break;
1306 case LOC_UNRESOLVED:
1307 printf_filtered ("Don't know LOC_UNRESOLVED %s\n",
1308 DEPRECATED_SYMBOL_NAME (sym));
1309 break;
1310 case LOC_OPTIMIZED_OUT:
1311 printf_filtered ("%s has been optimized out of existence.\n",
1312 DEPRECATED_SYMBOL_NAME (sym));
1313 break;
1314 }
1315 }
1316
1317 /* Add all locals (or args) symbols to collection list */
1318 static void
1319 add_local_symbols (struct collection_list *collect, CORE_ADDR pc,
1320 long frame_regno, long frame_offset, int type)
1321 {
1322 struct symbol *sym;
1323 struct block *block;
1324 struct dict_iterator iter;
1325 int count = 0;
1326
1327 block = block_for_pc (pc);
1328 while (block != 0)
1329 {
1330 QUIT; /* allow user to bail out with ^C */
1331 ALL_BLOCK_SYMBOLS (block, iter, sym)
1332 {
1333 switch (SYMBOL_CLASS (sym))
1334 {
1335 default:
1336 warning (_("don't know how to trace local symbol %s"),
1337 DEPRECATED_SYMBOL_NAME (sym));
1338 case LOC_LOCAL:
1339 case LOC_STATIC:
1340 case LOC_REGISTER:
1341 case LOC_BASEREG:
1342 if (type == 'L') /* collecting Locals */
1343 {
1344 count++;
1345 collect_symbol (collect, sym, frame_regno,
1346 frame_offset);
1347 }
1348 break;
1349 case LOC_ARG:
1350 case LOC_REF_ARG:
1351 case LOC_REGPARM:
1352 case LOC_REGPARM_ADDR:
1353 case LOC_BASEREG_ARG:
1354 if (type == 'A') /* collecting Arguments */
1355 {
1356 count++;
1357 collect_symbol (collect, sym, frame_regno,
1358 frame_offset);
1359 }
1360 }
1361 }
1362 if (BLOCK_FUNCTION (block))
1363 break;
1364 else
1365 block = BLOCK_SUPERBLOCK (block);
1366 }
1367 if (count == 0)
1368 warning (_("No %s found in scope."),
1369 type == 'L' ? "locals" : "args");
1370 }
1371
1372 /* worker function */
1373 static void
1374 clear_collection_list (struct collection_list *list)
1375 {
1376 int ndx;
1377
1378 list->next_memrange = 0;
1379 for (ndx = 0; ndx < list->next_aexpr_elt; ndx++)
1380 {
1381 free_agent_expr (list->aexpr_list[ndx]);
1382 list->aexpr_list[ndx] = NULL;
1383 }
1384 list->next_aexpr_elt = 0;
1385 memset (list->regs_mask, 0, sizeof (list->regs_mask));
1386 }
1387
1388 /* reduce a collection list to string form (for gdb protocol) */
1389 static char **
1390 stringify_collection_list (struct collection_list *list, char *string)
1391 {
1392 char temp_buf[2048];
1393 char tmp2[40];
1394 int count;
1395 int ndx = 0;
1396 char *(*str_list)[];
1397 char *end;
1398 long i;
1399
1400 count = 1 + list->next_memrange + list->next_aexpr_elt + 1;
1401 str_list = (char *(*)[]) xmalloc (count * sizeof (char *));
1402
1403 for (i = sizeof (list->regs_mask) - 1; i > 0; i--)
1404 if (list->regs_mask[i] != 0) /* skip leading zeroes in regs_mask */
1405 break;
1406 if (list->regs_mask[i] != 0) /* prepare to send regs_mask to the stub */
1407 {
1408 if (info_verbose)
1409 printf_filtered ("\nCollecting registers (mask): 0x");
1410 end = temp_buf;
1411 *end++ = 'R';
1412 for (; i >= 0; i--)
1413 {
1414 QUIT; /* allow user to bail out with ^C */
1415 if (info_verbose)
1416 printf_filtered ("%02X", list->regs_mask[i]);
1417 sprintf (end, "%02X", list->regs_mask[i]);
1418 end += 2;
1419 }
1420 (*str_list)[ndx] = savestring (temp_buf, end - temp_buf);
1421 ndx++;
1422 }
1423 if (info_verbose)
1424 printf_filtered ("\n");
1425 if (list->next_memrange > 0 && info_verbose)
1426 printf_filtered ("Collecting memranges: \n");
1427 for (i = 0, count = 0, end = temp_buf; i < list->next_memrange; i++)
1428 {
1429 QUIT; /* allow user to bail out with ^C */
1430 sprintf_vma (tmp2, list->list[i].start);
1431 if (info_verbose)
1432 {
1433 printf_filtered ("(%d, %s, %ld)\n",
1434 list->list[i].type,
1435 tmp2,
1436 (long) (list->list[i].end - list->list[i].start));
1437 }
1438 if (count + 27 > MAX_AGENT_EXPR_LEN)
1439 {
1440 (*str_list)[ndx] = savestring (temp_buf, count);
1441 ndx++;
1442 count = 0;
1443 end = temp_buf;
1444 }
1445
1446 {
1447 bfd_signed_vma length = list->list[i].end - list->list[i].start;
1448
1449 /* The "%X" conversion specifier expects an unsigned argument,
1450 so passing -1 (memrange_absolute) to it directly gives you
1451 "FFFFFFFF" (or more, depending on sizeof (unsigned)).
1452 Special-case it. */
1453 if (list->list[i].type == memrange_absolute)
1454 sprintf (end, "M-1,%s,%lX", tmp2, (long) length);
1455 else
1456 sprintf (end, "M%X,%s,%lX", list->list[i].type, tmp2, (long) length);
1457 }
1458
1459 count += strlen (end);
1460 end = temp_buf + count;
1461 }
1462
1463 for (i = 0; i < list->next_aexpr_elt; i++)
1464 {
1465 QUIT; /* allow user to bail out with ^C */
1466 if ((count + 10 + 2 * list->aexpr_list[i]->len) > MAX_AGENT_EXPR_LEN)
1467 {
1468 (*str_list)[ndx] = savestring (temp_buf, count);
1469 ndx++;
1470 count = 0;
1471 end = temp_buf;
1472 }
1473 sprintf (end, "X%08X,", list->aexpr_list[i]->len);
1474 end += 10; /* 'X' + 8 hex digits + ',' */
1475 count += 10;
1476
1477 end = mem2hex (list->aexpr_list[i]->buf,
1478 end, list->aexpr_list[i]->len);
1479 count += 2 * list->aexpr_list[i]->len;
1480 }
1481
1482 if (count != 0)
1483 {
1484 (*str_list)[ndx] = savestring (temp_buf, count);
1485 ndx++;
1486 count = 0;
1487 end = temp_buf;
1488 }
1489 (*str_list)[ndx] = NULL;
1490
1491 if (ndx == 0)
1492 {
1493 free (str_list);
1494 return NULL;
1495 }
1496 else
1497 return *str_list;
1498 }
1499
1500 static void
1501 free_actions_list_cleanup_wrapper (void *al)
1502 {
1503 free_actions_list (al);
1504 }
1505
1506 static void
1507 free_actions_list (char **actions_list)
1508 {
1509 int ndx;
1510
1511 if (actions_list == 0)
1512 return;
1513
1514 for (ndx = 0; actions_list[ndx]; ndx++)
1515 xfree (actions_list[ndx]);
1516
1517 xfree (actions_list);
1518 }
1519
1520 /* Render all actions into gdb protocol. */
1521 static void
1522 encode_actions (struct tracepoint *t, char ***tdp_actions,
1523 char ***stepping_actions)
1524 {
1525 static char tdp_buff[2048], step_buff[2048];
1526 char *action_exp;
1527 struct expression *exp = NULL;
1528 struct action_line *action;
1529 int i;
1530 struct value *tempval;
1531 struct collection_list *collect;
1532 struct cmd_list_element *cmd;
1533 struct agent_expr *aexpr;
1534 int frame_reg;
1535 LONGEST frame_offset;
1536
1537
1538 clear_collection_list (&tracepoint_list);
1539 clear_collection_list (&stepping_list);
1540 collect = &tracepoint_list;
1541
1542 *tdp_actions = NULL;
1543 *stepping_actions = NULL;
1544
1545 gdbarch_virtual_frame_pointer (current_gdbarch,
1546 t->address, &frame_reg, &frame_offset);
1547
1548 for (action = t->actions; action; action = action->next)
1549 {
1550 QUIT; /* allow user to bail out with ^C */
1551 action_exp = action->action;
1552 while (isspace ((int) *action_exp))
1553 action_exp++;
1554
1555 if (*action_exp == '#') /* comment line */
1556 return;
1557
1558 cmd = lookup_cmd (&action_exp, cmdlist, "", -1, 1);
1559 if (cmd == 0)
1560 error (_("Bad action list item: %s"), action_exp);
1561
1562 if (cmd_cfunc_eq (cmd, collect_pseudocommand))
1563 {
1564 do
1565 { /* repeat over a comma-separated list */
1566 QUIT; /* allow user to bail out with ^C */
1567 while (isspace ((int) *action_exp))
1568 action_exp++;
1569
1570 if (0 == strncasecmp ("$reg", action_exp, 4))
1571 {
1572 for (i = 0; i < gdbarch_num_regs (current_gdbarch); i++)
1573 add_register (collect, i);
1574 action_exp = strchr (action_exp, ','); /* more? */
1575 }
1576 else if (0 == strncasecmp ("$arg", action_exp, 4))
1577 {
1578 add_local_symbols (collect,
1579 t->address,
1580 frame_reg,
1581 frame_offset,
1582 'A');
1583 action_exp = strchr (action_exp, ','); /* more? */
1584 }
1585 else if (0 == strncasecmp ("$loc", action_exp, 4))
1586 {
1587 add_local_symbols (collect,
1588 t->address,
1589 frame_reg,
1590 frame_offset,
1591 'L');
1592 action_exp = strchr (action_exp, ','); /* more? */
1593 }
1594 else
1595 {
1596 unsigned long addr, len;
1597 struct cleanup *old_chain = NULL;
1598 struct cleanup *old_chain1 = NULL;
1599 struct agent_reqs areqs;
1600
1601 exp = parse_exp_1 (&action_exp,
1602 block_for_pc (t->address), 1);
1603 old_chain = make_cleanup (free_current_contents, &exp);
1604
1605 switch (exp->elts[0].opcode)
1606 {
1607 case OP_REGISTER:
1608 {
1609 const char *name = &exp->elts[2].string;
1610
1611 i = frame_map_name_to_regnum (deprecated_safe_get_selected_frame (),
1612 name, strlen (name));
1613 if (i == -1)
1614 internal_error (__FILE__, __LINE__,
1615 _("Register $%s not available"),
1616 name);
1617 if (info_verbose)
1618 printf_filtered ("OP_REGISTER: ");
1619 add_register (collect, i);
1620 break;
1621 }
1622
1623 case UNOP_MEMVAL:
1624 /* safe because we know it's a simple expression */
1625 tempval = evaluate_expression (exp);
1626 addr = VALUE_ADDRESS (tempval) + value_offset (tempval);
1627 len = TYPE_LENGTH (check_typedef (exp->elts[1].type));
1628 add_memrange (collect, memrange_absolute, addr, len);
1629 break;
1630
1631 case OP_VAR_VALUE:
1632 collect_symbol (collect,
1633 exp->elts[2].symbol,
1634 frame_reg,
1635 frame_offset);
1636 break;
1637
1638 default: /* full-fledged expression */
1639 aexpr = gen_trace_for_expr (t->address, exp);
1640
1641 old_chain1 = make_cleanup_free_agent_expr (aexpr);
1642
1643 ax_reqs (aexpr, &areqs);
1644 if (areqs.flaw != agent_flaw_none)
1645 error (_("malformed expression"));
1646
1647 if (areqs.min_height < 0)
1648 error (_("gdb: Internal error: expression has min height < 0"));
1649 if (areqs.max_height > 20)
1650 error (_("expression too complicated, try simplifying"));
1651
1652 discard_cleanups (old_chain1);
1653 add_aexpr (collect, aexpr);
1654
1655 /* take care of the registers */
1656 if (areqs.reg_mask_len > 0)
1657 {
1658 int ndx1;
1659 int ndx2;
1660
1661 for (ndx1 = 0; ndx1 < areqs.reg_mask_len; ndx1++)
1662 {
1663 QUIT; /* allow user to bail out with ^C */
1664 if (areqs.reg_mask[ndx1] != 0)
1665 {
1666 /* assume chars have 8 bits */
1667 for (ndx2 = 0; ndx2 < 8; ndx2++)
1668 if (areqs.reg_mask[ndx1] & (1 << ndx2))
1669 /* it's used -- record it */
1670 add_register (collect,
1671 ndx1 * 8 + ndx2);
1672 }
1673 }
1674 }
1675 break;
1676 } /* switch */
1677 do_cleanups (old_chain);
1678 } /* do */
1679 }
1680 while (action_exp && *action_exp++ == ',');
1681 } /* if */
1682 else if (cmd_cfunc_eq (cmd, while_stepping_pseudocommand))
1683 {
1684 collect = &stepping_list;
1685 }
1686 else if (cmd_cfunc_eq (cmd, end_actions_pseudocommand))
1687 {
1688 if (collect == &stepping_list) /* end stepping actions */
1689 collect = &tracepoint_list;
1690 else
1691 break; /* end tracepoint actions */
1692 }
1693 } /* for */
1694 memrange_sortmerge (&tracepoint_list);
1695 memrange_sortmerge (&stepping_list);
1696
1697 *tdp_actions = stringify_collection_list (&tracepoint_list,
1698 tdp_buff);
1699 *stepping_actions = stringify_collection_list (&stepping_list,
1700 step_buff);
1701 }
1702
1703 static void
1704 add_aexpr (struct collection_list *collect, struct agent_expr *aexpr)
1705 {
1706 if (collect->next_aexpr_elt >= collect->aexpr_listsize)
1707 {
1708 collect->aexpr_list =
1709 xrealloc (collect->aexpr_list,
1710 2 * collect->aexpr_listsize * sizeof (struct agent_expr *));
1711 collect->aexpr_listsize *= 2;
1712 }
1713 collect->aexpr_list[collect->next_aexpr_elt] = aexpr;
1714 collect->next_aexpr_elt++;
1715 }
1716
1717 static char *target_buf;
1718 static long target_buf_size;
1719
1720 /* Set "transparent" memory ranges
1721
1722 Allow trace mechanism to treat text-like sections
1723 (and perhaps all read-only sections) transparently,
1724 i.e. don't reject memory requests from these address ranges
1725 just because they haven't been collected. */
1726
1727 static void
1728 remote_set_transparent_ranges (void)
1729 {
1730 extern bfd *exec_bfd;
1731 asection *s;
1732 bfd_size_type size;
1733 bfd_vma lma;
1734 int anysecs = 0;
1735
1736 if (!exec_bfd)
1737 return; /* No information to give. */
1738
1739 strcpy (target_buf, "QTro");
1740 for (s = exec_bfd->sections; s; s = s->next)
1741 {
1742 char tmp1[40], tmp2[40];
1743
1744 if ((s->flags & SEC_LOAD) == 0 ||
1745 /* (s->flags & SEC_CODE) == 0 || */
1746 (s->flags & SEC_READONLY) == 0)
1747 continue;
1748
1749 anysecs = 1;
1750 lma = s->lma;
1751 size = bfd_get_section_size (s);
1752 sprintf_vma (tmp1, lma);
1753 sprintf_vma (tmp2, lma + size);
1754 sprintf (target_buf + strlen (target_buf),
1755 ":%s,%s", tmp1, tmp2);
1756 }
1757 if (anysecs)
1758 {
1759 putpkt (target_buf);
1760 getpkt (&target_buf, &target_buf_size, 0);
1761 }
1762 }
1763
1764 /* tstart command:
1765
1766 Tell target to clear any previous trace experiment.
1767 Walk the list of tracepoints, and send them (and their actions)
1768 to the target. If no errors,
1769 Tell target to start a new trace experiment. */
1770
1771 static void
1772 trace_start_command (char *args, int from_tty)
1773 {
1774 struct tracepoint *t;
1775 char buf[2048];
1776 char **tdp_actions;
1777 char **stepping_actions;
1778 int ndx;
1779 struct cleanup *old_chain = NULL;
1780
1781 dont_repeat (); /* Like "run", dangerous to repeat accidentally. */
1782
1783 if (target_is_remote ())
1784 {
1785 putpkt ("QTinit");
1786 remote_get_noisy_reply (&target_buf, &target_buf_size);
1787 if (strcmp (target_buf, "OK"))
1788 error (_("Target does not support this command."));
1789
1790 ALL_TRACEPOINTS (t)
1791 {
1792 char tmp[40];
1793
1794 sprintf_vma (tmp, t->address);
1795 sprintf (buf, "QTDP:%x:%s:%c:%lx:%x", t->number,
1796 tmp, /* address */
1797 t->enabled_p ? 'E' : 'D',
1798 t->step_count, t->pass_count);
1799
1800 if (t->actions)
1801 strcat (buf, "-");
1802 putpkt (buf);
1803 remote_get_noisy_reply (&target_buf, &target_buf_size);
1804 if (strcmp (target_buf, "OK"))
1805 error (_("Target does not support tracepoints."));
1806
1807 if (t->actions)
1808 {
1809 encode_actions (t, &tdp_actions, &stepping_actions);
1810 old_chain = make_cleanup (free_actions_list_cleanup_wrapper,
1811 tdp_actions);
1812 (void) make_cleanup (free_actions_list_cleanup_wrapper,
1813 stepping_actions);
1814
1815 /* do_single_steps (t); */
1816 if (tdp_actions)
1817 {
1818 for (ndx = 0; tdp_actions[ndx]; ndx++)
1819 {
1820 QUIT; /* allow user to bail out with ^C */
1821 sprintf (buf, "QTDP:-%x:%s:%s%c",
1822 t->number, tmp, /* address */
1823 tdp_actions[ndx],
1824 ((tdp_actions[ndx + 1] || stepping_actions)
1825 ? '-' : 0));
1826 putpkt (buf);
1827 remote_get_noisy_reply (&target_buf,
1828 &target_buf_size);
1829 if (strcmp (target_buf, "OK"))
1830 error (_("Error on target while setting tracepoints."));
1831 }
1832 }
1833 if (stepping_actions)
1834 {
1835 for (ndx = 0; stepping_actions[ndx]; ndx++)
1836 {
1837 QUIT; /* allow user to bail out with ^C */
1838 sprintf (buf, "QTDP:-%x:%s:%s%s%s",
1839 t->number, tmp, /* address */
1840 ((ndx == 0) ? "S" : ""),
1841 stepping_actions[ndx],
1842 (stepping_actions[ndx + 1] ? "-" : ""));
1843 putpkt (buf);
1844 remote_get_noisy_reply (&target_buf,
1845 &target_buf_size);
1846 if (strcmp (target_buf, "OK"))
1847 error (_("Error on target while setting tracepoints."));
1848 }
1849 }
1850
1851 do_cleanups (old_chain);
1852 }
1853 }
1854 /* Tell target to treat text-like sections as transparent. */
1855 remote_set_transparent_ranges ();
1856 /* Now insert traps and begin collecting data. */
1857 putpkt ("QTStart");
1858 remote_get_noisy_reply (&target_buf, &target_buf_size);
1859 if (strcmp (target_buf, "OK"))
1860 error (_("Bogus reply from target: %s"), target_buf);
1861 set_traceframe_num (-1); /* All old traceframes invalidated. */
1862 set_tracepoint_num (-1);
1863 set_traceframe_context (-1);
1864 trace_running_p = 1;
1865 if (deprecated_trace_start_stop_hook)
1866 deprecated_trace_start_stop_hook (1, from_tty);
1867
1868 }
1869 else
1870 error (_("Trace can only be run on remote targets."));
1871 }
1872
1873 /* tstop command */
1874 static void
1875 trace_stop_command (char *args, int from_tty)
1876 {
1877 if (target_is_remote ())
1878 {
1879 putpkt ("QTStop");
1880 remote_get_noisy_reply (&target_buf, &target_buf_size);
1881 if (strcmp (target_buf, "OK"))
1882 error (_("Bogus reply from target: %s"), target_buf);
1883 trace_running_p = 0;
1884 if (deprecated_trace_start_stop_hook)
1885 deprecated_trace_start_stop_hook (0, from_tty);
1886 }
1887 else
1888 error (_("Trace can only be run on remote targets."));
1889 }
1890
1891 unsigned long trace_running_p;
1892
1893 /* tstatus command */
1894 static void
1895 trace_status_command (char *args, int from_tty)
1896 {
1897 if (target_is_remote ())
1898 {
1899 putpkt ("qTStatus");
1900 remote_get_noisy_reply (&target_buf, &target_buf_size);
1901
1902 if (target_buf[0] != 'T' ||
1903 (target_buf[1] != '0' && target_buf[1] != '1'))
1904 error (_("Bogus reply from target: %s"), target_buf);
1905
1906 /* exported for use by the GUI */
1907 trace_running_p = (target_buf[1] == '1');
1908 }
1909 else
1910 error (_("Trace can only be run on remote targets."));
1911 }
1912
1913 /* Worker function for the various flavors of the tfind command. */
1914 static void
1915 finish_tfind_command (char **msg,
1916 long *sizeof_msg,
1917 int from_tty)
1918 {
1919 int target_frameno = -1, target_tracept = -1;
1920 CORE_ADDR old_frame_addr;
1921 struct symbol *old_func;
1922 char *reply;
1923
1924 old_frame_addr = get_frame_base (get_current_frame ());
1925 old_func = find_pc_function (read_pc ());
1926
1927 putpkt (*msg);
1928 reply = remote_get_noisy_reply (msg, sizeof_msg);
1929
1930 while (reply && *reply)
1931 switch (*reply)
1932 {
1933 case 'F':
1934 if ((target_frameno = (int) strtol (++reply, &reply, 16)) == -1)
1935 {
1936 /* A request for a non-existant trace frame has failed.
1937 Our response will be different, depending on FROM_TTY:
1938
1939 If FROM_TTY is true, meaning that this command was
1940 typed interactively by the user, then give an error
1941 and DO NOT change the state of traceframe_number etc.
1942
1943 However if FROM_TTY is false, meaning that we're either
1944 in a script, a loop, or a user-defined command, then
1945 DON'T give an error, but DO change the state of
1946 traceframe_number etc. to invalid.
1947
1948 The rationalle is that if you typed the command, you
1949 might just have committed a typo or something, and you'd
1950 like to NOT lose your current debugging state. However
1951 if you're in a user-defined command or especially in a
1952 loop, then you need a way to detect that the command
1953 failed WITHOUT aborting. This allows you to write
1954 scripts that search thru the trace buffer until the end,
1955 and then continue on to do something else. */
1956
1957 if (from_tty)
1958 error (_("Target failed to find requested trace frame."));
1959 else
1960 {
1961 if (info_verbose)
1962 printf_filtered ("End of trace buffer.\n");
1963 /* The following will not recurse, since it's
1964 special-cased. */
1965 trace_find_command ("-1", from_tty);
1966 reply = NULL; /* Break out of loop
1967 (avoid recursive nonsense). */
1968 }
1969 }
1970 break;
1971 case 'T':
1972 if ((target_tracept = (int) strtol (++reply, &reply, 16)) == -1)
1973 error (_("Target failed to find requested trace frame."));
1974 break;
1975 case 'O': /* "OK"? */
1976 if (reply[1] == 'K' && reply[2] == '\0')
1977 reply += 2;
1978 else
1979 error (_("Bogus reply from target: %s"), reply);
1980 break;
1981 default:
1982 error (_("Bogus reply from target: %s"), reply);
1983 }
1984
1985 reinit_frame_cache ();
1986 registers_changed ();
1987 set_traceframe_num (target_frameno);
1988 set_tracepoint_num (target_tracept);
1989 if (target_frameno == -1)
1990 set_traceframe_context (-1);
1991 else
1992 set_traceframe_context (read_pc ());
1993
1994 if (from_tty)
1995 {
1996 enum print_what print_what;
1997
1998 /* NOTE: in immitation of the step command, try to determine
1999 whether we have made a transition from one function to
2000 another. If so, we'll print the "stack frame" (ie. the new
2001 function and it's arguments) -- otherwise we'll just show the
2002 new source line.
2003
2004 This determination is made by checking (1) whether the
2005 current function has changed, and (2) whether the current FP
2006 has changed. Hack: if the FP wasn't collected, either at the
2007 current or the previous frame, assume that the FP has NOT
2008 changed. */
2009
2010 if (old_func == find_pc_function (read_pc ()) &&
2011 (old_frame_addr == 0 ||
2012 get_frame_base (get_current_frame ()) == 0 ||
2013 old_frame_addr == get_frame_base (get_current_frame ())))
2014 print_what = SRC_LINE;
2015 else
2016 print_what = SRC_AND_LOC;
2017
2018 print_stack_frame (get_selected_frame (NULL), 1, print_what);
2019 do_displays ();
2020 }
2021 }
2022
2023 /* trace_find_command takes a trace frame number n,
2024 sends "QTFrame:<n>" to the target,
2025 and accepts a reply that may contain several optional pieces
2026 of information: a frame number, a tracepoint number, and an
2027 indication of whether this is a trap frame or a stepping frame.
2028
2029 The minimal response is just "OK" (which indicates that the
2030 target does not give us a frame number or a tracepoint number).
2031 Instead of that, the target may send us a string containing
2032 any combination of:
2033 F<hexnum> (gives the selected frame number)
2034 T<hexnum> (gives the selected tracepoint number)
2035 */
2036
2037 /* tfind command */
2038 static void
2039 trace_find_command (char *args, int from_tty)
2040 { /* this should only be called with a numeric argument */
2041 int frameno = -1;
2042
2043 if (target_is_remote ())
2044 {
2045 if (deprecated_trace_find_hook)
2046 deprecated_trace_find_hook (args, from_tty);
2047
2048 if (args == 0 || *args == 0)
2049 { /* TFIND with no args means find NEXT trace frame. */
2050 if (traceframe_number == -1)
2051 frameno = 0; /* "next" is first one */
2052 else
2053 frameno = traceframe_number + 1;
2054 }
2055 else if (0 == strcmp (args, "-"))
2056 {
2057 if (traceframe_number == -1)
2058 error (_("not debugging trace buffer"));
2059 else if (from_tty && traceframe_number == 0)
2060 error (_("already at start of trace buffer"));
2061
2062 frameno = traceframe_number - 1;
2063 }
2064 else
2065 frameno = parse_and_eval_long (args);
2066
2067 if (frameno < -1)
2068 error (_("invalid input (%d is less than zero)"), frameno);
2069
2070 sprintf (target_buf, "QTFrame:%x", frameno);
2071 finish_tfind_command (&target_buf, &target_buf_size, from_tty);
2072 }
2073 else
2074 error (_("Trace can only be run on remote targets."));
2075 }
2076
2077 /* tfind end */
2078 static void
2079 trace_find_end_command (char *args, int from_tty)
2080 {
2081 trace_find_command ("-1", from_tty);
2082 }
2083
2084 /* tfind none */
2085 static void
2086 trace_find_none_command (char *args, int from_tty)
2087 {
2088 trace_find_command ("-1", from_tty);
2089 }
2090
2091 /* tfind start */
2092 static void
2093 trace_find_start_command (char *args, int from_tty)
2094 {
2095 trace_find_command ("0", from_tty);
2096 }
2097
2098 /* tfind pc command */
2099 static void
2100 trace_find_pc_command (char *args, int from_tty)
2101 {
2102 CORE_ADDR pc;
2103 char tmp[40];
2104
2105 if (target_is_remote ())
2106 {
2107 if (args == 0 || *args == 0)
2108 pc = read_pc (); /* default is current pc */
2109 else
2110 pc = parse_and_eval_address (args);
2111
2112 sprintf_vma (tmp, pc);
2113 sprintf (target_buf, "QTFrame:pc:%s", tmp);
2114 finish_tfind_command (&target_buf, &target_buf_size, from_tty);
2115 }
2116 else
2117 error (_("Trace can only be run on remote targets."));
2118 }
2119
2120 /* tfind tracepoint command */
2121 static void
2122 trace_find_tracepoint_command (char *args, int from_tty)
2123 {
2124 int tdp;
2125
2126 if (target_is_remote ())
2127 {
2128 if (args == 0 || *args == 0)
2129 {
2130 if (tracepoint_number == -1)
2131 error (_("No current tracepoint -- please supply an argument."));
2132 else
2133 tdp = tracepoint_number; /* default is current TDP */
2134 }
2135 else
2136 tdp = parse_and_eval_long (args);
2137
2138 sprintf (target_buf, "QTFrame:tdp:%x", tdp);
2139 finish_tfind_command (&target_buf, &target_buf_size, from_tty);
2140 }
2141 else
2142 error (_("Trace can only be run on remote targets."));
2143 }
2144
2145 /* TFIND LINE command:
2146
2147 This command will take a sourceline for argument, just like BREAK
2148 or TRACE (ie. anything that "decode_line_1" can handle).
2149
2150 With no argument, this command will find the next trace frame
2151 corresponding to a source line OTHER THAN THE CURRENT ONE. */
2152
2153 static void
2154 trace_find_line_command (char *args, int from_tty)
2155 {
2156 static CORE_ADDR start_pc, end_pc;
2157 struct symtabs_and_lines sals;
2158 struct symtab_and_line sal;
2159 struct cleanup *old_chain;
2160 char startpc_str[40], endpc_str[40];
2161
2162 if (target_is_remote ())
2163 {
2164 if (args == 0 || *args == 0)
2165 {
2166 sal = find_pc_line (get_frame_pc (get_current_frame ()), 0);
2167 sals.nelts = 1;
2168 sals.sals = (struct symtab_and_line *)
2169 xmalloc (sizeof (struct symtab_and_line));
2170 sals.sals[0] = sal;
2171 }
2172 else
2173 {
2174 sals = decode_line_spec (args, 1);
2175 sal = sals.sals[0];
2176 }
2177
2178 old_chain = make_cleanup (xfree, sals.sals);
2179 if (sal.symtab == 0)
2180 {
2181 printf_filtered ("TFIND: No line number information available");
2182 if (sal.pc != 0)
2183 {
2184 /* This is useful for "info line *0x7f34". If we can't
2185 tell the user about a source line, at least let them
2186 have the symbolic address. */
2187 printf_filtered (" for address ");
2188 wrap_here (" ");
2189 print_address (sal.pc, gdb_stdout);
2190 printf_filtered (";\n -- will attempt to find by PC. \n");
2191 }
2192 else
2193 {
2194 printf_filtered (".\n");
2195 return; /* No line, no PC; what can we do? */
2196 }
2197 }
2198 else if (sal.line > 0
2199 && find_line_pc_range (sal, &start_pc, &end_pc))
2200 {
2201 if (start_pc == end_pc)
2202 {
2203 printf_filtered ("Line %d of \"%s\"",
2204 sal.line, sal.symtab->filename);
2205 wrap_here (" ");
2206 printf_filtered (" is at address ");
2207 print_address (start_pc, gdb_stdout);
2208 wrap_here (" ");
2209 printf_filtered (" but contains no code.\n");
2210 sal = find_pc_line (start_pc, 0);
2211 if (sal.line > 0 &&
2212 find_line_pc_range (sal, &start_pc, &end_pc) &&
2213 start_pc != end_pc)
2214 printf_filtered ("Attempting to find line %d instead.\n",
2215 sal.line);
2216 else
2217 error (_("Cannot find a good line."));
2218 }
2219 }
2220 else
2221 /* Is there any case in which we get here, and have an address
2222 which the user would want to see? If we have debugging
2223 symbols and no line numbers? */
2224 error (_("Line number %d is out of range for \"%s\"."),
2225 sal.line, sal.symtab->filename);
2226
2227 sprintf_vma (startpc_str, start_pc);
2228 sprintf_vma (endpc_str, end_pc - 1);
2229 /* Find within range of stated line. */
2230 if (args && *args)
2231 sprintf (target_buf, "QTFrame:range:%s:%s",
2232 startpc_str, endpc_str);
2233 /* Find OUTSIDE OF range of CURRENT line. */
2234 else
2235 sprintf (target_buf, "QTFrame:outside:%s:%s",
2236 startpc_str, endpc_str);
2237 finish_tfind_command (&target_buf, &target_buf_size,
2238 from_tty);
2239 do_cleanups (old_chain);
2240 }
2241 else
2242 error (_("Trace can only be run on remote targets."));
2243 }
2244
2245 /* tfind range command */
2246 static void
2247 trace_find_range_command (char *args, int from_tty)
2248 {
2249 static CORE_ADDR start, stop;
2250 char start_str[40], stop_str[40];
2251 char *tmp;
2252
2253 if (target_is_remote ())
2254 {
2255 if (args == 0 || *args == 0)
2256 { /* XXX FIXME: what should default behavior be? */
2257 printf_filtered ("Usage: tfind range <startaddr>,<endaddr>\n");
2258 return;
2259 }
2260
2261 if (0 != (tmp = strchr (args, ',')))
2262 {
2263 *tmp++ = '\0'; /* terminate start address */
2264 while (isspace ((int) *tmp))
2265 tmp++;
2266 start = parse_and_eval_address (args);
2267 stop = parse_and_eval_address (tmp);
2268 }
2269 else
2270 { /* no explicit end address? */
2271 start = parse_and_eval_address (args);
2272 stop = start + 1; /* ??? */
2273 }
2274
2275 sprintf_vma (start_str, start);
2276 sprintf_vma (stop_str, stop);
2277 sprintf (target_buf, "QTFrame:range:%s:%s", start_str, stop_str);
2278 finish_tfind_command (&target_buf, &target_buf_size, from_tty);
2279 }
2280 else
2281 error (_("Trace can only be run on remote targets."));
2282 }
2283
2284 /* tfind outside command */
2285 static void
2286 trace_find_outside_command (char *args, int from_tty)
2287 {
2288 CORE_ADDR start, stop;
2289 char start_str[40], stop_str[40];
2290 char *tmp;
2291
2292 if (target_is_remote ())
2293 {
2294 if (args == 0 || *args == 0)
2295 { /* XXX FIXME: what should default behavior be? */
2296 printf_filtered ("Usage: tfind outside <startaddr>,<endaddr>\n");
2297 return;
2298 }
2299
2300 if (0 != (tmp = strchr (args, ',')))
2301 {
2302 *tmp++ = '\0'; /* terminate start address */
2303 while (isspace ((int) *tmp))
2304 tmp++;
2305 start = parse_and_eval_address (args);
2306 stop = parse_and_eval_address (tmp);
2307 }
2308 else
2309 { /* no explicit end address? */
2310 start = parse_and_eval_address (args);
2311 stop = start + 1; /* ??? */
2312 }
2313
2314 sprintf_vma (start_str, start);
2315 sprintf_vma (stop_str, stop);
2316 sprintf (target_buf, "QTFrame:outside:%s:%s", start_str, stop_str);
2317 finish_tfind_command (&target_buf, &target_buf_size, from_tty);
2318 }
2319 else
2320 error (_("Trace can only be run on remote targets."));
2321 }
2322
2323 /* save-tracepoints command */
2324 static void
2325 tracepoint_save_command (char *args, int from_tty)
2326 {
2327 struct tracepoint *tp;
2328 struct action_line *line;
2329 FILE *fp;
2330 char *i1 = " ", *i2 = " ";
2331 char *indent, *actionline, *pathname;
2332 char tmp[40];
2333
2334 if (args == 0 || *args == 0)
2335 error (_("Argument required (file name in which to save tracepoints)"));
2336
2337 if (tracepoint_chain == 0)
2338 {
2339 warning (_("save-tracepoints: no tracepoints to save."));
2340 return;
2341 }
2342
2343 pathname = tilde_expand (args);
2344 if (!(fp = fopen (pathname, "w")))
2345 error (_("Unable to open file '%s' for saving tracepoints (%s)"),
2346 args, safe_strerror (errno));
2347 xfree (pathname);
2348
2349 ALL_TRACEPOINTS (tp)
2350 {
2351 if (tp->addr_string)
2352 fprintf (fp, "trace %s\n", tp->addr_string);
2353 else
2354 {
2355 sprintf_vma (tmp, tp->address);
2356 fprintf (fp, "trace *0x%s\n", tmp);
2357 }
2358
2359 if (tp->pass_count)
2360 fprintf (fp, " passcount %d\n", tp->pass_count);
2361
2362 if (tp->actions)
2363 {
2364 fprintf (fp, " actions\n");
2365 indent = i1;
2366 for (line = tp->actions; line; line = line->next)
2367 {
2368 struct cmd_list_element *cmd;
2369
2370 QUIT; /* allow user to bail out with ^C */
2371 actionline = line->action;
2372 while (isspace ((int) *actionline))
2373 actionline++;
2374
2375 fprintf (fp, "%s%s\n", indent, actionline);
2376 if (*actionline != '#') /* skip for comment lines */
2377 {
2378 cmd = lookup_cmd (&actionline, cmdlist, "", -1, 1);
2379 if (cmd == 0)
2380 error (_("Bad action list item: %s"), actionline);
2381 if (cmd_cfunc_eq (cmd, while_stepping_pseudocommand))
2382 indent = i2;
2383 else if (cmd_cfunc_eq (cmd, end_actions_pseudocommand))
2384 indent = i1;
2385 }
2386 }
2387 }
2388 }
2389 fclose (fp);
2390 if (from_tty)
2391 printf_filtered ("Tracepoints saved to file '%s'.\n", args);
2392 return;
2393 }
2394
2395 /* info scope command: list the locals for a scope. */
2396 static void
2397 scope_info (char *args, int from_tty)
2398 {
2399 struct symtabs_and_lines sals;
2400 struct symbol *sym;
2401 struct minimal_symbol *msym;
2402 struct block *block;
2403 char **canonical, *symname, *save_args = args;
2404 struct dict_iterator iter;
2405 int j, count = 0;
2406
2407 if (args == 0 || *args == 0)
2408 error (_("requires an argument (function, line or *addr) to define a scope"));
2409
2410 sals = decode_line_1 (&args, 1, NULL, 0, &canonical, NULL);
2411 if (sals.nelts == 0)
2412 return; /* presumably decode_line_1 has already warned */
2413
2414 /* Resolve line numbers to PC */
2415 resolve_sal_pc (&sals.sals[0]);
2416 block = block_for_pc (sals.sals[0].pc);
2417
2418 while (block != 0)
2419 {
2420 QUIT; /* allow user to bail out with ^C */
2421 ALL_BLOCK_SYMBOLS (block, iter, sym)
2422 {
2423 QUIT; /* allow user to bail out with ^C */
2424 if (count == 0)
2425 printf_filtered ("Scope for %s:\n", save_args);
2426 count++;
2427
2428 symname = DEPRECATED_SYMBOL_NAME (sym);
2429 if (symname == NULL || *symname == '\0')
2430 continue; /* probably botched, certainly useless */
2431
2432 printf_filtered ("Symbol %s is ", symname);
2433 switch (SYMBOL_CLASS (sym))
2434 {
2435 default:
2436 case LOC_UNDEF: /* messed up symbol? */
2437 printf_filtered ("a bogus symbol, class %d.\n",
2438 SYMBOL_CLASS (sym));
2439 count--; /* don't count this one */
2440 continue;
2441 case LOC_CONST:
2442 printf_filtered ("a constant with value %ld (0x%lx)",
2443 SYMBOL_VALUE (sym), SYMBOL_VALUE (sym));
2444 break;
2445 case LOC_CONST_BYTES:
2446 printf_filtered ("constant bytes: ");
2447 if (SYMBOL_TYPE (sym))
2448 for (j = 0; j < TYPE_LENGTH (SYMBOL_TYPE (sym)); j++)
2449 fprintf_filtered (gdb_stdout, " %02x",
2450 (unsigned) SYMBOL_VALUE_BYTES (sym)[j]);
2451 break;
2452 case LOC_STATIC:
2453 printf_filtered ("in static storage at address ");
2454 printf_filtered ("%s", paddress (SYMBOL_VALUE_ADDRESS (sym)));
2455 break;
2456 case LOC_REGISTER:
2457 printf_filtered ("a local variable in register $%s",
2458 gdbarch_register_name
2459 (current_gdbarch, SYMBOL_VALUE (sym)));
2460 break;
2461 case LOC_ARG:
2462 printf_filtered ("an argument at stack/frame offset %ld",
2463 SYMBOL_VALUE (sym));
2464 break;
2465 case LOC_LOCAL:
2466 printf_filtered ("a local variable at frame offset %ld",
2467 SYMBOL_VALUE (sym));
2468 break;
2469 case LOC_REF_ARG:
2470 printf_filtered ("a reference argument at offset %ld",
2471 SYMBOL_VALUE (sym));
2472 break;
2473 case LOC_REGPARM:
2474 printf_filtered ("an argument in register $%s",
2475 gdbarch_register_name
2476 (current_gdbarch, SYMBOL_VALUE (sym)));
2477 break;
2478 case LOC_REGPARM_ADDR:
2479 printf_filtered ("the address of an argument, in register $%s",
2480 gdbarch_register_name
2481 (current_gdbarch, SYMBOL_VALUE (sym)));
2482 break;
2483 case LOC_TYPEDEF:
2484 printf_filtered ("a typedef.\n");
2485 continue;
2486 case LOC_LABEL:
2487 printf_filtered ("a label at address ");
2488 printf_filtered ("%s", paddress (SYMBOL_VALUE_ADDRESS (sym)));
2489 break;
2490 case LOC_BLOCK:
2491 printf_filtered ("a function at address ");
2492 printf_filtered ("%s", paddress (BLOCK_START (SYMBOL_BLOCK_VALUE (sym))));
2493 break;
2494 case LOC_BASEREG:
2495 printf_filtered ("a variable at offset %ld from register $%s",
2496 SYMBOL_VALUE (sym),
2497 gdbarch_register_name
2498 (current_gdbarch, SYMBOL_BASEREG (sym)));
2499 break;
2500 case LOC_BASEREG_ARG:
2501 printf_filtered ("an argument at offset %ld from register $%s",
2502 SYMBOL_VALUE (sym),
2503 gdbarch_register_name
2504 (current_gdbarch, SYMBOL_BASEREG (sym)));
2505 break;
2506 case LOC_UNRESOLVED:
2507 msym = lookup_minimal_symbol (DEPRECATED_SYMBOL_NAME (sym),
2508 NULL, NULL);
2509 if (msym == NULL)
2510 printf_filtered ("Unresolved Static");
2511 else
2512 {
2513 printf_filtered ("static storage at address ");
2514 printf_filtered ("%s", paddress (SYMBOL_VALUE_ADDRESS (msym)));
2515 }
2516 break;
2517 case LOC_OPTIMIZED_OUT:
2518 printf_filtered ("optimized out.\n");
2519 continue;
2520 case LOC_COMPUTED:
2521 case LOC_COMPUTED_ARG:
2522 SYMBOL_OPS (sym)->describe_location (sym, gdb_stdout);
2523 break;
2524 }
2525 if (SYMBOL_TYPE (sym))
2526 printf_filtered (", length %d.\n",
2527 TYPE_LENGTH (check_typedef (SYMBOL_TYPE (sym))));
2528 }
2529 if (BLOCK_FUNCTION (block))
2530 break;
2531 else
2532 block = BLOCK_SUPERBLOCK (block);
2533 }
2534 if (count <= 0)
2535 printf_filtered ("Scope for %s contains no locals or arguments.\n",
2536 save_args);
2537 }
2538
2539 /* worker function (cleanup) */
2540 static void
2541 replace_comma (void *data)
2542 {
2543 char *comma = data;
2544 *comma = ',';
2545 }
2546
2547 /* tdump command */
2548 static void
2549 trace_dump_command (char *args, int from_tty)
2550 {
2551 struct regcache *regcache;
2552 struct gdbarch *gdbarch;
2553 struct tracepoint *t;
2554 struct action_line *action;
2555 char *action_exp, *next_comma;
2556 struct cleanup *old_cleanups;
2557 int stepping_actions = 0;
2558 int stepping_frame = 0;
2559
2560 if (!target_is_remote ())
2561 {
2562 error (_("Trace can only be run on remote targets."));
2563 return;
2564 }
2565
2566 if (tracepoint_number == -1)
2567 {
2568 warning (_("No current trace frame."));
2569 return;
2570 }
2571
2572 ALL_TRACEPOINTS (t)
2573 if (t->number == tracepoint_number)
2574 break;
2575
2576 if (t == NULL)
2577 error (_("No known tracepoint matches 'current' tracepoint #%d."),
2578 tracepoint_number);
2579
2580 old_cleanups = make_cleanup (null_cleanup, NULL);
2581
2582 printf_filtered ("Data collected at tracepoint %d, trace frame %d:\n",
2583 tracepoint_number, traceframe_number);
2584
2585 /* The current frame is a trap frame if the frame PC is equal
2586 to the tracepoint PC. If not, then the current frame was
2587 collected during single-stepping. */
2588
2589 regcache = get_current_regcache ();
2590 gdbarch = get_regcache_arch (regcache);
2591
2592 stepping_frame = (t->address != (regcache_read_pc (regcache)
2593 - gdbarch_decr_pc_after_break (gdbarch)));
2594
2595 for (action = t->actions; action; action = action->next)
2596 {
2597 struct cmd_list_element *cmd;
2598
2599 QUIT; /* allow user to bail out with ^C */
2600 action_exp = action->action;
2601 while (isspace ((int) *action_exp))
2602 action_exp++;
2603
2604 /* The collection actions to be done while stepping are
2605 bracketed by the commands "while-stepping" and "end". */
2606
2607 if (*action_exp == '#') /* comment line */
2608 continue;
2609
2610 cmd = lookup_cmd (&action_exp, cmdlist, "", -1, 1);
2611 if (cmd == 0)
2612 error (_("Bad action list item: %s"), action_exp);
2613
2614 if (cmd_cfunc_eq (cmd, while_stepping_pseudocommand))
2615 stepping_actions = 1;
2616 else if (cmd_cfunc_eq (cmd, end_actions_pseudocommand))
2617 stepping_actions = 0;
2618 else if (cmd_cfunc_eq (cmd, collect_pseudocommand))
2619 {
2620 /* Display the collected data.
2621 For the trap frame, display only what was collected at
2622 the trap. Likewise for stepping frames, display only
2623 what was collected while stepping. This means that the
2624 two boolean variables, STEPPING_FRAME and
2625 STEPPING_ACTIONS should be equal. */
2626 if (stepping_frame == stepping_actions)
2627 {
2628 do
2629 { /* repeat over a comma-separated list */
2630 QUIT; /* allow user to bail out with ^C */
2631 if (*action_exp == ',')
2632 action_exp++;
2633 while (isspace ((int) *action_exp))
2634 action_exp++;
2635
2636 next_comma = strchr (action_exp, ',');
2637
2638 if (0 == strncasecmp (action_exp, "$reg", 4))
2639 registers_info (NULL, from_tty);
2640 else if (0 == strncasecmp (action_exp, "$loc", 4))
2641 locals_info (NULL, from_tty);
2642 else if (0 == strncasecmp (action_exp, "$arg", 4))
2643 args_info (NULL, from_tty);
2644 else
2645 { /* variable */
2646 if (next_comma)
2647 {
2648 make_cleanup (replace_comma, next_comma);
2649 *next_comma = '\0';
2650 }
2651 printf_filtered ("%s = ", action_exp);
2652 output_command (action_exp, from_tty);
2653 printf_filtered ("\n");
2654 }
2655 if (next_comma)
2656 *next_comma = ',';
2657 action_exp = next_comma;
2658 }
2659 while (action_exp && *action_exp == ',');
2660 }
2661 }
2662 }
2663 discard_cleanups (old_cleanups);
2664 }
2665
2666 /* Convert the memory pointed to by mem into hex, placing result in buf.
2667 * Return a pointer to the last char put in buf (null)
2668 * "stolen" from sparc-stub.c
2669 */
2670
2671 static const char hexchars[] = "0123456789abcdef";
2672
2673 static char *
2674 mem2hex (gdb_byte *mem, char *buf, int count)
2675 {
2676 gdb_byte ch;
2677
2678 while (count-- > 0)
2679 {
2680 ch = *mem++;
2681
2682 *buf++ = hexchars[ch >> 4];
2683 *buf++ = hexchars[ch & 0xf];
2684 }
2685
2686 *buf = 0;
2687
2688 return buf;
2689 }
2690
2691 int
2692 get_traceframe_number (void)
2693 {
2694 return traceframe_number;
2695 }
2696
2697
2698 /* module initialization */
2699 void
2700 _initialize_tracepoint (void)
2701 {
2702 struct cmd_list_element *c;
2703
2704 tracepoint_chain = 0;
2705 tracepoint_count = 0;
2706 traceframe_number = -1;
2707 tracepoint_number = -1;
2708
2709 if (tracepoint_list.list == NULL)
2710 {
2711 tracepoint_list.listsize = 128;
2712 tracepoint_list.list = xmalloc
2713 (tracepoint_list.listsize * sizeof (struct memrange));
2714 }
2715 if (tracepoint_list.aexpr_list == NULL)
2716 {
2717 tracepoint_list.aexpr_listsize = 128;
2718 tracepoint_list.aexpr_list = xmalloc
2719 (tracepoint_list.aexpr_listsize * sizeof (struct agent_expr *));
2720 }
2721
2722 if (stepping_list.list == NULL)
2723 {
2724 stepping_list.listsize = 128;
2725 stepping_list.list = xmalloc
2726 (stepping_list.listsize * sizeof (struct memrange));
2727 }
2728
2729 if (stepping_list.aexpr_list == NULL)
2730 {
2731 stepping_list.aexpr_listsize = 128;
2732 stepping_list.aexpr_list = xmalloc
2733 (stepping_list.aexpr_listsize * sizeof (struct agent_expr *));
2734 }
2735
2736 add_info ("scope", scope_info,
2737 _("List the variables local to a scope"));
2738
2739 add_cmd ("tracepoints", class_trace, NULL,
2740 _("Tracing of program execution without stopping the program."),
2741 &cmdlist);
2742
2743 add_info ("tracepoints", tracepoints_info, _("\
2744 Status of tracepoints, or tracepoint number NUMBER.\n\
2745 Convenience variable \"$tpnum\" contains the number of the\n\
2746 last tracepoint set."));
2747
2748 add_info_alias ("tp", "tracepoints", 1);
2749
2750 c = add_com ("save-tracepoints", class_trace, tracepoint_save_command, _("\
2751 Save current tracepoint definitions as a script.\n\
2752 Use the 'source' command in another debug session to restore them."));
2753 set_cmd_completer (c, filename_completer);
2754
2755 add_com ("tdump", class_trace, trace_dump_command,
2756 _("Print everything collected at the current tracepoint."));
2757
2758 add_prefix_cmd ("tfind", class_trace, trace_find_command, _("\
2759 Select a trace frame;\n\
2760 No argument means forward by one frame; '-' means backward by one frame."),
2761 &tfindlist, "tfind ", 1, &cmdlist);
2762
2763 add_cmd ("outside", class_trace, trace_find_outside_command, _("\
2764 Select a trace frame whose PC is outside the given range.\n\
2765 Usage: tfind outside addr1, addr2"),
2766 &tfindlist);
2767
2768 add_cmd ("range", class_trace, trace_find_range_command, _("\
2769 Select a trace frame whose PC is in the given range.\n\
2770 Usage: tfind range addr1,addr2"),
2771 &tfindlist);
2772
2773 add_cmd ("line", class_trace, trace_find_line_command, _("\
2774 Select a trace frame by source line.\n\
2775 Argument can be a line number (with optional source file), \n\
2776 a function name, or '*' followed by an address.\n\
2777 Default argument is 'the next source line that was traced'."),
2778 &tfindlist);
2779
2780 add_cmd ("tracepoint", class_trace, trace_find_tracepoint_command, _("\
2781 Select a trace frame by tracepoint number.\n\
2782 Default is the tracepoint for the current trace frame."),
2783 &tfindlist);
2784
2785 add_cmd ("pc", class_trace, trace_find_pc_command, _("\
2786 Select a trace frame by PC.\n\
2787 Default is the current PC, or the PC of the current trace frame."),
2788 &tfindlist);
2789
2790 add_cmd ("end", class_trace, trace_find_end_command, _("\
2791 Synonym for 'none'.\n\
2792 De-select any trace frame and resume 'live' debugging."),
2793 &tfindlist);
2794
2795 add_cmd ("none", class_trace, trace_find_none_command,
2796 _("De-select any trace frame and resume 'live' debugging."),
2797 &tfindlist);
2798
2799 add_cmd ("start", class_trace, trace_find_start_command,
2800 _("Select the first trace frame in the trace buffer."),
2801 &tfindlist);
2802
2803 add_com ("tstatus", class_trace, trace_status_command,
2804 _("Display the status of the current trace data collection."));
2805
2806 add_com ("tstop", class_trace, trace_stop_command,
2807 _("Stop trace data collection."));
2808
2809 add_com ("tstart", class_trace, trace_start_command,
2810 _("Start trace data collection."));
2811
2812 add_com ("passcount", class_trace, trace_pass_command, _("\
2813 Set the passcount for a tracepoint.\n\
2814 The trace will end when the tracepoint has been passed 'count' times.\n\
2815 Usage: passcount COUNT TPNUM, where TPNUM may also be \"all\";\n\
2816 if TPNUM is omitted, passcount refers to the last tracepoint defined."));
2817
2818 add_com ("end", class_trace, end_actions_pseudocommand, _("\
2819 Ends a list of commands or actions.\n\
2820 Several GDB commands allow you to enter a list of commands or actions.\n\
2821 Entering \"end\" on a line by itself is the normal way to terminate\n\
2822 such a list.\n\n\
2823 Note: the \"end\" command cannot be used at the gdb prompt."));
2824
2825 add_com ("while-stepping", class_trace, while_stepping_pseudocommand, _("\
2826 Specify single-stepping behavior at a tracepoint.\n\
2827 Argument is number of instructions to trace in single-step mode\n\
2828 following the tracepoint. This command is normally followed by\n\
2829 one or more \"collect\" commands, to specify what to collect\n\
2830 while single-stepping.\n\n\
2831 Note: this command can only be used in a tracepoint \"actions\" list."));
2832
2833 add_com_alias ("ws", "while-stepping", class_alias, 0);
2834 add_com_alias ("stepping", "while-stepping", class_alias, 0);
2835
2836 add_com ("collect", class_trace, collect_pseudocommand, _("\
2837 Specify one or more data items to be collected at a tracepoint.\n\
2838 Accepts a comma-separated list of (one or more) expressions. GDB will\n\
2839 collect all data (variables, registers) referenced by that expression.\n\
2840 Also accepts the following special arguments:\n\
2841 $regs -- all registers.\n\
2842 $args -- all function arguments.\n\
2843 $locals -- all variables local to the block/function scope.\n\
2844 Note: this command can only be used in a tracepoint \"actions\" list."));
2845
2846 add_com ("actions", class_trace, trace_actions_command, _("\
2847 Specify the actions to be taken at a tracepoint.\n\
2848 Tracepoint actions may include collecting of specified data, \n\
2849 single-stepping, or enabling/disabling other tracepoints, \n\
2850 depending on target's capabilities."));
2851
2852 add_cmd ("tracepoints", class_trace, delete_trace_command, _("\
2853 Delete specified tracepoints.\n\
2854 Arguments are tracepoint numbers, separated by spaces.\n\
2855 No argument means delete all tracepoints."),
2856 &deletelist);
2857
2858 add_cmd ("tracepoints", class_trace, disable_trace_command, _("\
2859 Disable specified tracepoints.\n\
2860 Arguments are tracepoint numbers, separated by spaces.\n\
2861 No argument means disable all tracepoints."),
2862 &disablelist);
2863
2864 add_cmd ("tracepoints", class_trace, enable_trace_command, _("\
2865 Enable specified tracepoints.\n\
2866 Arguments are tracepoint numbers, separated by spaces.\n\
2867 No argument means enable all tracepoints."),
2868 &enablelist);
2869
2870 c = add_com ("trace", class_trace, trace_command, _("\
2871 Set a tracepoint at a specified line or function or address.\n\
2872 Argument may be a line number, function name, or '*' plus an address.\n\
2873 For a line number or function, trace at the start of its code.\n\
2874 If an address is specified, trace at that exact address.\n\n\
2875 Do \"help tracepoints\" for info on other tracepoint commands."));
2876 set_cmd_completer (c, location_completer);
2877
2878 add_com_alias ("tp", "trace", class_alias, 0);
2879 add_com_alias ("tr", "trace", class_alias, 1);
2880 add_com_alias ("tra", "trace", class_alias, 1);
2881 add_com_alias ("trac", "trace", class_alias, 1);
2882
2883 target_buf_size = 2048;
2884 target_buf = xmalloc (target_buf_size);
2885 }