1 /* Tracing functionality for remote targets in custom GDB protocol
3 Copyright (C) 1997-2016 Free Software Foundation, Inc.
5 This file is part of GDB.
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 3 of the License, or
10 (at your option) any later version.
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with this program. If not, see <http://www.gnu.org/licenses/>. */
21 #include "arch-utils.h"
25 #include "expression.h"
29 #include "target-dcache.h"
32 #include "breakpoint.h"
33 #include "tracepoint.h"
36 #include "completer.h"
38 #include "dictionary.h"
40 #include "user-regs.h"
44 #include "filenames.h"
45 #include "gdbthread.h"
52 #include "cli/cli-utils.h"
55 #include "filestuff.h"
57 #include "tracefile.h"
60 /* readline include files */
61 #include "readline/readline.h"
62 #include "readline/history.h"
64 /* readline defines this. */
69 /* Maximum length of an agent aexpression.
70 This accounts for the fact that packets are limited to 400 bytes
71 (which includes everything -- including the checksum), and assumes
72 the worst case of maximum length for each of the pieces of a
75 NOTE: expressions get mem2hex'ed otherwise this would be twice as
76 large. (400 - 31)/2 == 184 */
77 #define MAX_AGENT_EXPR_LEN 184
79 /* A hook used to notify the UI of tracepoint operations. */
81 void (*deprecated_trace_find_hook) (char *arg, int from_tty);
82 void (*deprecated_trace_start_stop_hook) (int start, int from_tty);
87 This module defines the following debugger commands:
88 trace : set a tracepoint on a function, line, or address.
89 info trace : list all debugger-defined tracepoints.
90 delete trace : delete one or more tracepoints.
91 enable trace : enable one or more tracepoints.
92 disable trace : disable one or more tracepoints.
93 actions : specify actions to be taken at a tracepoint.
94 passcount : specify a pass count for a tracepoint.
95 tstart : start a trace experiment.
96 tstop : stop a trace experiment.
97 tstatus : query the status of a trace experiment.
98 tfind : find a trace frame in the trace buffer.
99 tdump : print everything collected at the current tracepoint.
100 save-tracepoints : write tracepoint setup into a file.
102 This module defines the following user-visible debugger variables:
103 $trace_frame : sequence number of trace frame currently being debugged.
104 $trace_line : source line of trace frame currently being debugged.
105 $trace_file : source file of trace frame currently being debugged.
106 $tracepoint : tracepoint number of trace frame currently being debugged.
110 /* ======= Important global variables: ======= */
112 /* The list of all trace state variables. We don't retain pointers to
113 any of these for any reason - API is by name or number only - so it
114 works to have a vector of objects. */
116 typedef struct trace_state_variable tsv_s;
119 static VEC(tsv_s) *tvariables;
121 /* The next integer to assign to a variable. */
123 static int next_tsv_number = 1;
125 /* Number of last traceframe collected. */
126 static int traceframe_number;
128 /* Tracepoint for last traceframe collected. */
129 static int tracepoint_number;
131 /* The traceframe info of the current traceframe. NULL if we haven't
132 yet attempted to fetch it, or if the target does not support
133 fetching this object, or if we're not inspecting a traceframe
135 static struct traceframe_info *traceframe_info;
137 /* Tracing command lists. */
138 static struct cmd_list_element *tfindlist;
140 /* List of expressions to collect by default at each tracepoint hit. */
141 char *default_collect = "";
143 static int disconnected_tracing;
145 /* This variable controls whether we ask the target for a linear or
146 circular trace buffer. */
148 static int circular_trace_buffer;
150 /* This variable is the requested trace buffer size, or -1 to indicate
151 that we don't care and leave it up to the target to set a size. */
153 static int trace_buffer_size = -1;
155 /* Textual notes applying to the current and/or future trace runs. */
157 char *trace_user = NULL;
159 /* Textual notes applying to the current and/or future trace runs. */
161 char *trace_notes = NULL;
163 /* Textual notes applying to the stopping of a trace. */
165 char *trace_stop_notes = NULL;
167 /* ======= Important command functions: ======= */
168 static void trace_actions_command (char *, int);
169 static void trace_start_command (char *, int);
170 static void trace_stop_command (char *, int);
171 static void trace_status_command (char *, int);
172 static void trace_find_command (char *, int);
173 static void trace_find_pc_command (char *, int);
174 static void trace_find_tracepoint_command (char *, int);
175 static void trace_find_line_command (char *, int);
176 static void trace_find_range_command (char *, int);
177 static void trace_find_outside_command (char *, int);
178 static void trace_dump_command (char *, int);
180 /* support routines */
182 struct collection_list;
183 static void add_aexpr (struct collection_list *, struct agent_expr *);
184 static char *mem2hex (gdb_byte *, char *, int);
185 static void add_register (struct collection_list *collection,
188 static struct command_line *
189 all_tracepoint_actions_and_cleanup (struct breakpoint *t);
191 extern void _initialize_tracepoint (void);
193 static struct trace_status trace_status;
195 const char *stop_reason_names[] = {
205 struct trace_status *
206 current_trace_status (void)
208 return &trace_status;
214 free_traceframe_info (struct traceframe_info *info)
218 VEC_free (mem_range_s, info->memory);
219 VEC_free (int, info->tvars);
225 /* Free and clear the traceframe info cache of the current
229 clear_traceframe_info (void)
231 free_traceframe_info (traceframe_info);
232 traceframe_info = NULL;
235 /* Set traceframe number to NUM. */
237 set_traceframe_num (int num)
239 traceframe_number = num;
240 set_internalvar_integer (lookup_internalvar ("trace_frame"), num);
243 /* Set tracepoint number to NUM. */
245 set_tracepoint_num (int num)
247 tracepoint_number = num;
248 set_internalvar_integer (lookup_internalvar ("tracepoint"), num);
251 /* Set externally visible debug variables for querying/printing
252 the traceframe context (line, function, file). */
255 set_traceframe_context (struct frame_info *trace_frame)
258 struct symbol *traceframe_fun;
259 struct symtab_and_line traceframe_sal;
261 /* Save as globals for internal use. */
262 if (trace_frame != NULL
263 && get_frame_pc_if_available (trace_frame, &trace_pc))
265 traceframe_sal = find_pc_line (trace_pc, 0);
266 traceframe_fun = find_pc_function (trace_pc);
268 /* Save linenumber as "$trace_line", a debugger variable visible to
270 set_internalvar_integer (lookup_internalvar ("trace_line"),
271 traceframe_sal.line);
275 init_sal (&traceframe_sal);
276 traceframe_fun = NULL;
277 set_internalvar_integer (lookup_internalvar ("trace_line"), -1);
280 /* Save func name as "$trace_func", a debugger variable visible to
282 if (traceframe_fun == NULL
283 || SYMBOL_LINKAGE_NAME (traceframe_fun) == NULL)
284 clear_internalvar (lookup_internalvar ("trace_func"));
286 set_internalvar_string (lookup_internalvar ("trace_func"),
287 SYMBOL_LINKAGE_NAME (traceframe_fun));
289 /* Save file name as "$trace_file", a debugger variable visible to
291 if (traceframe_sal.symtab == NULL)
292 clear_internalvar (lookup_internalvar ("trace_file"));
294 set_internalvar_string (lookup_internalvar ("trace_file"),
295 symtab_to_filename_for_display (traceframe_sal.symtab));
298 /* Create a new trace state variable with the given name. */
300 struct trace_state_variable *
301 create_trace_state_variable (const char *name)
303 struct trace_state_variable tsv;
305 memset (&tsv, 0, sizeof (tsv));
306 tsv.name = xstrdup (name);
307 tsv.number = next_tsv_number++;
308 return VEC_safe_push (tsv_s, tvariables, &tsv);
311 /* Look for a trace state variable of the given name. */
313 struct trace_state_variable *
314 find_trace_state_variable (const char *name)
316 struct trace_state_variable *tsv;
319 for (ix = 0; VEC_iterate (tsv_s, tvariables, ix, tsv); ++ix)
320 if (strcmp (name, tsv->name) == 0)
326 /* Look for a trace state variable of the given number. Return NULL if
329 struct trace_state_variable *
330 find_trace_state_variable_by_number (int number)
332 struct trace_state_variable *tsv;
335 for (ix = 0; VEC_iterate (tsv_s, tvariables, ix, tsv); ++ix)
336 if (tsv->number == number)
343 delete_trace_state_variable (const char *name)
345 struct trace_state_variable *tsv;
348 for (ix = 0; VEC_iterate (tsv_s, tvariables, ix, tsv); ++ix)
349 if (strcmp (name, tsv->name) == 0)
351 observer_notify_tsv_deleted (tsv);
353 xfree ((void *)tsv->name);
354 VEC_unordered_remove (tsv_s, tvariables, ix);
359 warning (_("No trace variable named \"$%s\", not deleting"), name);
362 /* Throws an error if NAME is not valid syntax for a trace state
366 validate_trace_state_variable_name (const char *name)
371 error (_("Must supply a non-empty variable name"));
373 /* All digits in the name is reserved for value history
375 for (p = name; isdigit (*p); p++)
378 error (_("$%s is not a valid trace state variable name"), name);
380 for (p = name; isalnum (*p) || *p == '_'; p++)
383 error (_("$%s is not a valid trace state variable name"), name);
386 /* The 'tvariable' command collects a name and optional expression to
387 evaluate into an initial value. */
390 trace_variable_command (char *args, int from_tty)
392 struct cleanup *old_chain;
394 struct trace_state_variable *tsv;
398 error_no_arg (_("Syntax is $NAME [ = EXPR ]"));
400 /* Only allow two syntaxes; "$name" and "$name=value". */
401 p = skip_spaces (args);
404 error (_("Name of trace variable should start with '$'"));
407 while (isalnum (*p) || *p == '_')
409 name = savestring (name, p - name);
410 old_chain = make_cleanup (xfree, name);
413 if (*p != '=' && *p != '\0')
414 error (_("Syntax must be $NAME [ = EXPR ]"));
416 validate_trace_state_variable_name (name);
419 initval = value_as_long (parse_and_eval (++p));
421 /* If the variable already exists, just change its initial value. */
422 tsv = find_trace_state_variable (name);
425 if (tsv->initial_value != initval)
427 tsv->initial_value = initval;
428 observer_notify_tsv_modified (tsv);
430 printf_filtered (_("Trace state variable $%s "
431 "now has initial value %s.\n"),
432 tsv->name, plongest (tsv->initial_value));
433 do_cleanups (old_chain);
437 /* Create a new variable. */
438 tsv = create_trace_state_variable (name);
439 tsv->initial_value = initval;
441 observer_notify_tsv_created (tsv);
443 printf_filtered (_("Trace state variable $%s "
444 "created, with initial value %s.\n"),
445 tsv->name, plongest (tsv->initial_value));
447 do_cleanups (old_chain);
451 delete_trace_variable_command (char *args, int from_tty)
455 struct cleanup *back_to;
459 if (query (_("Delete all trace state variables? ")))
460 VEC_free (tsv_s, tvariables);
462 observer_notify_tsv_deleted (NULL);
466 argv = gdb_buildargv (args);
467 back_to = make_cleanup_freeargv (argv);
469 for (ix = 0; argv[ix] != NULL; ix++)
471 if (*argv[ix] == '$')
472 delete_trace_state_variable (argv[ix] + 1);
474 warning (_("Name \"%s\" not prefixed with '$', ignoring"), argv[ix]);
477 do_cleanups (back_to);
483 tvariables_info_1 (void)
485 struct trace_state_variable *tsv;
488 struct cleanup *back_to;
489 struct ui_out *uiout = current_uiout;
491 if (VEC_length (tsv_s, tvariables) == 0 && !ui_out_is_mi_like_p (uiout))
493 printf_filtered (_("No trace state variables.\n"));
497 /* Try to acquire values from the target. */
498 for (ix = 0; VEC_iterate (tsv_s, tvariables, ix, tsv); ++ix, ++count)
499 tsv->value_known = target_get_trace_state_variable_value (tsv->number,
502 back_to = make_cleanup_ui_out_table_begin_end (uiout, 3,
503 count, "trace-variables");
504 ui_out_table_header (uiout, 15, ui_left, "name", "Name");
505 ui_out_table_header (uiout, 11, ui_left, "initial", "Initial");
506 ui_out_table_header (uiout, 11, ui_left, "current", "Current");
508 ui_out_table_body (uiout);
510 for (ix = 0; VEC_iterate (tsv_s, tvariables, ix, tsv); ++ix)
512 struct cleanup *back_to2;
516 back_to2 = make_cleanup_ui_out_tuple_begin_end (uiout, "variable");
518 name = concat ("$", tsv->name, (char *) NULL);
519 make_cleanup (xfree, name);
520 ui_out_field_string (uiout, "name", name);
521 ui_out_field_string (uiout, "initial", plongest (tsv->initial_value));
523 if (tsv->value_known)
524 c = plongest (tsv->value);
525 else if (ui_out_is_mi_like_p (uiout))
526 /* For MI, we prefer not to use magic string constants, but rather
527 omit the field completely. The difference between unknown and
528 undefined does not seem important enough to represent. */
530 else if (current_trace_status ()->running || traceframe_number >= 0)
531 /* The value is/was defined, but we don't have it. */
534 /* It is not meaningful to ask about the value. */
537 ui_out_field_string (uiout, "current", c);
538 ui_out_text (uiout, "\n");
540 do_cleanups (back_to2);
543 do_cleanups (back_to);
546 /* List all the trace state variables. */
549 tvariables_info (char *args, int from_tty)
551 tvariables_info_1 ();
554 /* Stash definitions of tsvs into the given file. */
557 save_trace_state_variables (struct ui_file *fp)
559 struct trace_state_variable *tsv;
562 for (ix = 0; VEC_iterate (tsv_s, tvariables, ix, tsv); ++ix)
564 fprintf_unfiltered (fp, "tvariable $%s", tsv->name);
565 if (tsv->initial_value)
566 fprintf_unfiltered (fp, " = %s", plongest (tsv->initial_value));
567 fprintf_unfiltered (fp, "\n");
571 /* ACTIONS functions: */
573 /* The three functions:
574 collect_pseudocommand,
575 while_stepping_pseudocommand, and
576 end_actions_pseudocommand
577 are placeholders for "commands" that are actually ONLY to be used
578 within a tracepoint action list. If the actual function is ever called,
579 it means that somebody issued the "command" at the top level,
580 which is always an error. */
583 end_actions_pseudocommand (char *args, int from_tty)
585 error (_("This command cannot be used at the top level."));
589 while_stepping_pseudocommand (char *args, int from_tty)
591 error (_("This command can only be used in a tracepoint actions list."));
595 collect_pseudocommand (char *args, int from_tty)
597 error (_("This command can only be used in a tracepoint actions list."));
601 teval_pseudocommand (char *args, int from_tty)
603 error (_("This command can only be used in a tracepoint actions list."));
606 /* Parse any collection options, such as /s for strings. */
609 decode_agent_options (const char *exp, int *trace_string)
611 struct value_print_options opts;
618 /* Call this to borrow the print elements default for collection
620 get_user_print_options (&opts);
625 if (target_supports_string_tracing ())
627 /* Allow an optional decimal number giving an explicit maximum
628 string length, defaulting it to the "print elements" value;
629 so "collect/s80 mystr" gets at most 80 bytes of string. */
630 *trace_string = opts.print_max;
632 if (*exp >= '0' && *exp <= '9')
633 *trace_string = atoi (exp);
634 while (*exp >= '0' && *exp <= '9')
638 error (_("Target does not support \"/s\" option for string tracing."));
641 error (_("Undefined collection format \"%c\"."), *exp);
643 exp = skip_spaces_const (exp);
648 /* Enter a list of actions for a tracepoint. */
650 trace_actions_command (char *args, int from_tty)
652 struct tracepoint *t;
653 struct command_line *l;
655 t = get_tracepoint_by_number (&args, NULL);
659 xstrprintf ("Enter actions for tracepoint %d, one per line.",
661 struct cleanup *cleanups = make_cleanup (xfree, tmpbuf);
663 l = read_command_lines (tmpbuf, from_tty, 1,
664 check_tracepoint_command, t);
665 do_cleanups (cleanups);
666 breakpoint_set_commands (&t->base, l);
668 /* else just return */
671 /* Report the results of checking the agent expression, as errors or
675 report_agent_reqs_errors (struct agent_expr *aexpr)
677 /* All of the "flaws" are serious bytecode generation issues that
678 should never occur. */
679 if (aexpr->flaw != agent_flaw_none)
680 internal_error (__FILE__, __LINE__, _("expression is malformed"));
682 /* If analysis shows a stack underflow, GDB must have done something
683 badly wrong in its bytecode generation. */
684 if (aexpr->min_height < 0)
685 internal_error (__FILE__, __LINE__,
686 _("expression has min height < 0"));
688 /* Issue this error if the stack is predicted to get too deep. The
689 limit is rather arbitrary; a better scheme might be for the
690 target to report how much stack it will have available. The
691 depth roughly corresponds to parenthesization, so a limit of 20
692 amounts to 20 levels of expression nesting, which is actually
693 a pretty big hairy expression. */
694 if (aexpr->max_height > 20)
695 error (_("Expression is too complicated."));
698 /* worker function */
700 validate_actionline (const char *line, struct breakpoint *b)
702 struct cmd_list_element *c;
703 struct expression *exp = NULL;
704 struct cleanup *old_chain = NULL;
707 struct bp_location *loc;
708 struct agent_expr *aexpr;
709 struct tracepoint *t = (struct tracepoint *) b;
711 /* If EOF is typed, *line is NULL. */
715 p = skip_spaces_const (line);
717 /* Symbol lookup etc. */
718 if (*p == '\0') /* empty line: just prompt for another line. */
721 if (*p == '#') /* comment line */
724 c = lookup_cmd (&p, cmdlist, "", -1, 1);
726 error (_("`%s' is not a tracepoint action, or is ambiguous."), p);
728 if (cmd_cfunc_eq (c, collect_pseudocommand))
730 int trace_string = 0;
733 p = decode_agent_options (p, &trace_string);
736 { /* Repeat over a comma-separated list. */
737 QUIT; /* Allow user to bail out with ^C. */
738 p = skip_spaces_const (p);
740 if (*p == '$') /* Look for special pseudo-symbols. */
742 if (0 == strncasecmp ("reg", p + 1, 3)
743 || 0 == strncasecmp ("arg", p + 1, 3)
744 || 0 == strncasecmp ("loc", p + 1, 3)
745 || 0 == strncasecmp ("_ret", p + 1, 4)
746 || 0 == strncasecmp ("_sdata", p + 1, 6))
751 /* else fall thru, treat p as an expression and parse it! */
754 for (loc = t->base.loc; loc; loc = loc->next)
757 exp = parse_exp_1 (&p, loc->address,
758 block_for_pc (loc->address), 1);
759 old_chain = make_cleanup (free_current_contents, &exp);
761 if (exp->elts[0].opcode == OP_VAR_VALUE)
763 if (SYMBOL_CLASS (exp->elts[2].symbol) == LOC_CONST)
765 error (_("constant `%s' (value %s) "
766 "will not be collected."),
767 SYMBOL_PRINT_NAME (exp->elts[2].symbol),
768 plongest (SYMBOL_VALUE (exp->elts[2].symbol)));
770 else if (SYMBOL_CLASS (exp->elts[2].symbol)
771 == LOC_OPTIMIZED_OUT)
773 error (_("`%s' is optimized away "
774 "and cannot be collected."),
775 SYMBOL_PRINT_NAME (exp->elts[2].symbol));
779 /* We have something to collect, make sure that the expr to
780 bytecode translator can handle it and that it's not too
782 aexpr = gen_trace_for_expr (loc->address, exp, trace_string);
783 make_cleanup_free_agent_expr (aexpr);
785 if (aexpr->len > MAX_AGENT_EXPR_LEN)
786 error (_("Expression is too complicated."));
790 report_agent_reqs_errors (aexpr);
792 do_cleanups (old_chain);
795 while (p && *p++ == ',');
798 else if (cmd_cfunc_eq (c, teval_pseudocommand))
801 { /* Repeat over a comma-separated list. */
802 QUIT; /* Allow user to bail out with ^C. */
803 p = skip_spaces_const (p);
806 for (loc = t->base.loc; loc; loc = loc->next)
810 /* Only expressions are allowed for this action. */
811 exp = parse_exp_1 (&p, loc->address,
812 block_for_pc (loc->address), 1);
813 old_chain = make_cleanup (free_current_contents, &exp);
815 /* We have something to evaluate, make sure that the expr to
816 bytecode translator can handle it and that it's not too
818 aexpr = gen_eval_for_expr (loc->address, exp);
819 make_cleanup_free_agent_expr (aexpr);
821 if (aexpr->len > MAX_AGENT_EXPR_LEN)
822 error (_("Expression is too complicated."));
825 report_agent_reqs_errors (aexpr);
827 do_cleanups (old_chain);
830 while (p && *p++ == ',');
833 else if (cmd_cfunc_eq (c, while_stepping_pseudocommand))
837 p = skip_spaces_const (p);
838 t->step_count = strtol (p, &endp, 0);
839 if (endp == p || t->step_count == 0)
840 error (_("while-stepping step count `%s' is malformed."), line);
844 else if (cmd_cfunc_eq (c, end_actions_pseudocommand))
848 error (_("`%s' is not a supported tracepoint action."), line);
852 memrange_absolute = -1
855 /* MEMRANGE functions: */
857 static int memrange_cmp (const void *, const void *);
859 /* Compare memranges for qsort. */
861 memrange_cmp (const void *va, const void *vb)
863 const struct memrange *a = (const struct memrange *) va;
864 const struct memrange *b = (const struct memrange *) vb;
866 if (a->type < b->type)
868 if (a->type > b->type)
870 if (a->type == memrange_absolute)
872 if ((bfd_vma) a->start < (bfd_vma) b->start)
874 if ((bfd_vma) a->start > (bfd_vma) b->start)
879 if (a->start < b->start)
881 if (a->start > b->start)
887 /* Sort the memrange list using qsort, and merge adjacent memranges. */
889 memrange_sortmerge (struct collection_list *memranges)
893 qsort (memranges->list, memranges->next_memrange,
894 sizeof (struct memrange), memrange_cmp);
895 if (memranges->next_memrange > 0)
897 for (a = 0, b = 1; b < memranges->next_memrange; b++)
899 /* If memrange b overlaps or is adjacent to memrange a,
901 if (memranges->list[a].type == memranges->list[b].type
902 && memranges->list[b].start <= memranges->list[a].end)
904 if (memranges->list[b].end > memranges->list[a].end)
905 memranges->list[a].end = memranges->list[b].end;
906 continue; /* next b, same a */
910 memcpy (&memranges->list[a], &memranges->list[b],
911 sizeof (struct memrange));
913 memranges->next_memrange = a + 1;
917 /* Add a register to a collection list. */
919 add_register (struct collection_list *collection, unsigned int regno)
922 printf_filtered ("collect register %d\n", regno);
923 if (regno >= (8 * sizeof (collection->regs_mask)))
924 error (_("Internal: register number %d too large for tracepoint"),
926 collection->regs_mask[regno / 8] |= 1 << (regno % 8);
929 /* Add a memrange to a collection list. */
931 add_memrange (struct collection_list *memranges,
932 int type, bfd_signed_vma base,
937 printf_filtered ("(%d,", type);
939 printf_filtered (",%ld)\n", len);
942 /* type: memrange_absolute == memory, other n == basereg */
943 memranges->list[memranges->next_memrange].type = type;
944 /* base: addr if memory, offset if reg relative. */
945 memranges->list[memranges->next_memrange].start = base;
946 /* len: we actually save end (base + len) for convenience */
947 memranges->list[memranges->next_memrange].end = base + len;
948 memranges->next_memrange++;
949 if (memranges->next_memrange >= memranges->listsize)
951 memranges->listsize *= 2;
952 memranges->list = (struct memrange *) xrealloc (memranges->list,
953 memranges->listsize);
956 if (type != memrange_absolute) /* Better collect the base register! */
957 add_register (memranges, type);
960 /* Add a symbol to a collection list. */
962 collect_symbol (struct collection_list *collect,
964 struct gdbarch *gdbarch,
965 long frame_regno, long frame_offset,
971 bfd_signed_vma offset;
972 int treat_as_expr = 0;
974 len = TYPE_LENGTH (check_typedef (SYMBOL_TYPE (sym)));
975 switch (SYMBOL_CLASS (sym))
978 printf_filtered ("%s: don't know symbol class %d\n",
979 SYMBOL_PRINT_NAME (sym),
983 printf_filtered ("constant %s (value %s) will not be collected.\n",
984 SYMBOL_PRINT_NAME (sym), plongest (SYMBOL_VALUE (sym)));
987 offset = SYMBOL_VALUE_ADDRESS (sym);
992 sprintf_vma (tmp, offset);
993 printf_filtered ("LOC_STATIC %s: collect %ld bytes at %s.\n",
994 SYMBOL_PRINT_NAME (sym), len,
997 /* A struct may be a C++ class with static fields, go to general
998 expression handling. */
999 if (TYPE_CODE (SYMBOL_TYPE (sym)) == TYPE_CODE_STRUCT)
1002 add_memrange (collect, memrange_absolute, offset, len);
1005 reg = SYMBOL_REGISTER_OPS (sym)->register_number (sym, gdbarch);
1007 printf_filtered ("LOC_REG[parm] %s: ",
1008 SYMBOL_PRINT_NAME (sym));
1009 add_register (collect, reg);
1010 /* Check for doubles stored in two registers. */
1011 /* FIXME: how about larger types stored in 3 or more regs? */
1012 if (TYPE_CODE (SYMBOL_TYPE (sym)) == TYPE_CODE_FLT &&
1013 len > register_size (gdbarch, reg))
1014 add_register (collect, reg + 1);
1017 printf_filtered ("Sorry, don't know how to do LOC_REF_ARG yet.\n");
1018 printf_filtered (" (will not collect %s)\n",
1019 SYMBOL_PRINT_NAME (sym));
1023 offset = frame_offset + SYMBOL_VALUE (sym);
1026 printf_filtered ("LOC_LOCAL %s: Collect %ld bytes at offset ",
1027 SYMBOL_PRINT_NAME (sym), len);
1028 printf_vma (offset);
1029 printf_filtered (" from frame ptr reg %d\n", reg);
1031 add_memrange (collect, reg, offset, len);
1033 case LOC_REGPARM_ADDR:
1034 reg = SYMBOL_VALUE (sym);
1038 printf_filtered ("LOC_REGPARM_ADDR %s: Collect %ld bytes at offset ",
1039 SYMBOL_PRINT_NAME (sym), len);
1040 printf_vma (offset);
1041 printf_filtered (" from reg %d\n", reg);
1043 add_memrange (collect, reg, offset, len);
1047 offset = frame_offset + SYMBOL_VALUE (sym);
1050 printf_filtered ("LOC_LOCAL %s: Collect %ld bytes at offset ",
1051 SYMBOL_PRINT_NAME (sym), len);
1052 printf_vma (offset);
1053 printf_filtered (" from frame ptr reg %d\n", reg);
1055 add_memrange (collect, reg, offset, len);
1058 case LOC_UNRESOLVED:
1062 case LOC_OPTIMIZED_OUT:
1063 printf_filtered ("%s has been optimized out of existence.\n",
1064 SYMBOL_PRINT_NAME (sym));
1072 /* Expressions are the most general case. */
1075 struct agent_expr *aexpr;
1076 struct cleanup *old_chain1 = NULL;
1078 aexpr = gen_trace_for_var (scope, gdbarch, sym, trace_string);
1080 /* It can happen that the symbol is recorded as a computed
1081 location, but it's been optimized away and doesn't actually
1082 have a location expression. */
1085 printf_filtered ("%s has been optimized out of existence.\n",
1086 SYMBOL_PRINT_NAME (sym));
1090 old_chain1 = make_cleanup_free_agent_expr (aexpr);
1094 report_agent_reqs_errors (aexpr);
1096 discard_cleanups (old_chain1);
1097 add_aexpr (collect, aexpr);
1099 /* Take care of the registers. */
1100 if (aexpr->reg_mask_len > 0)
1104 for (ndx1 = 0; ndx1 < aexpr->reg_mask_len; ndx1++)
1106 QUIT; /* Allow user to bail out with ^C. */
1107 if (aexpr->reg_mask[ndx1] != 0)
1109 /* Assume chars have 8 bits. */
1110 for (ndx2 = 0; ndx2 < 8; ndx2++)
1111 if (aexpr->reg_mask[ndx1] & (1 << ndx2))
1112 /* It's used -- record it. */
1113 add_register (collect, ndx1 * 8 + ndx2);
1120 /* Data to be passed around in the calls to the locals and args
1123 struct add_local_symbols_data
1125 struct collection_list *collect;
1126 struct gdbarch *gdbarch;
1134 /* The callback for the locals and args iterators. */
1137 do_collect_symbol (const char *print_name,
1141 struct add_local_symbols_data *p = (struct add_local_symbols_data *) cb_data;
1143 collect_symbol (p->collect, sym, p->gdbarch, p->frame_regno,
1144 p->frame_offset, p->pc, p->trace_string);
1147 VEC_safe_push (char_ptr, p->collect->wholly_collected,
1148 xstrdup (print_name));
1151 /* Add all locals (or args) symbols to collection list. */
1153 add_local_symbols (struct collection_list *collect,
1154 struct gdbarch *gdbarch, CORE_ADDR pc,
1155 long frame_regno, long frame_offset, int type,
1158 const struct block *block;
1159 struct add_local_symbols_data cb_data;
1161 cb_data.collect = collect;
1162 cb_data.gdbarch = gdbarch;
1164 cb_data.frame_regno = frame_regno;
1165 cb_data.frame_offset = frame_offset;
1167 cb_data.trace_string = trace_string;
1171 block = block_for_pc (pc);
1174 warning (_("Can't collect locals; "
1175 "no symbol table info available.\n"));
1179 iterate_over_block_local_vars (block, do_collect_symbol, &cb_data);
1180 if (cb_data.count == 0)
1181 warning (_("No locals found in scope."));
1185 pc = get_pc_function_start (pc);
1186 block = block_for_pc (pc);
1189 warning (_("Can't collect args; no symbol table info available."));
1193 iterate_over_block_arg_vars (block, do_collect_symbol, &cb_data);
1194 if (cb_data.count == 0)
1195 warning (_("No args found in scope."));
1200 add_static_trace_data (struct collection_list *collection)
1203 printf_filtered ("collect static trace data\n");
1204 collection->strace_data = 1;
1207 /* worker function */
1209 clear_collection_list (struct collection_list *list)
1213 list->next_memrange = 0;
1214 for (ndx = 0; ndx < list->next_aexpr_elt; ndx++)
1216 free_agent_expr (list->aexpr_list[ndx]);
1217 list->aexpr_list[ndx] = NULL;
1219 list->next_aexpr_elt = 0;
1220 memset (list->regs_mask, 0, sizeof (list->regs_mask));
1221 list->strace_data = 0;
1223 xfree (list->aexpr_list);
1226 VEC_free (char_ptr, list->wholly_collected);
1227 VEC_free (char_ptr, list->computed);
1230 /* A cleanup wrapper for function clear_collection_list. */
1233 do_clear_collection_list (void *list)
1235 struct collection_list *l = (struct collection_list *) list;
1237 clear_collection_list (l);
1240 /* Initialize collection_list CLIST. */
1243 init_collection_list (struct collection_list *clist)
1245 memset (clist, 0, sizeof *clist);
1247 clist->listsize = 128;
1248 clist->list = XCNEWVEC (struct memrange, clist->listsize);
1250 clist->aexpr_listsize = 128;
1251 clist->aexpr_list = XCNEWVEC (struct agent_expr *, clist->aexpr_listsize);
1254 /* Reduce a collection list to string form (for gdb protocol). */
1256 stringify_collection_list (struct collection_list *list)
1258 char temp_buf[2048];
1262 char *(*str_list)[];
1266 count = 1 + 1 + list->next_memrange + list->next_aexpr_elt + 1;
1267 str_list = (char *(*)[]) xmalloc (count * sizeof (char *));
1269 if (list->strace_data)
1272 printf_filtered ("\nCollecting static trace data\n");
1275 (*str_list)[ndx] = savestring (temp_buf, end - temp_buf);
1279 for (i = sizeof (list->regs_mask) - 1; i > 0; i--)
1280 if (list->regs_mask[i] != 0) /* Skip leading zeroes in regs_mask. */
1282 if (list->regs_mask[i] != 0) /* Prepare to send regs_mask to the stub. */
1285 printf_filtered ("\nCollecting registers (mask): 0x");
1290 QUIT; /* Allow user to bail out with ^C. */
1292 printf_filtered ("%02X", list->regs_mask[i]);
1293 sprintf (end, "%02X", list->regs_mask[i]);
1296 (*str_list)[ndx] = xstrdup (temp_buf);
1300 printf_filtered ("\n");
1301 if (list->next_memrange > 0 && info_verbose)
1302 printf_filtered ("Collecting memranges: \n");
1303 for (i = 0, count = 0, end = temp_buf; i < list->next_memrange; i++)
1305 QUIT; /* Allow user to bail out with ^C. */
1306 sprintf_vma (tmp2, list->list[i].start);
1309 printf_filtered ("(%d, %s, %ld)\n",
1312 (long) (list->list[i].end - list->list[i].start));
1314 if (count + 27 > MAX_AGENT_EXPR_LEN)
1316 (*str_list)[ndx] = savestring (temp_buf, count);
1323 bfd_signed_vma length = list->list[i].end - list->list[i].start;
1325 /* The "%X" conversion specifier expects an unsigned argument,
1326 so passing -1 (memrange_absolute) to it directly gives you
1327 "FFFFFFFF" (or more, depending on sizeof (unsigned)).
1329 if (list->list[i].type == memrange_absolute)
1330 sprintf (end, "M-1,%s,%lX", tmp2, (long) length);
1332 sprintf (end, "M%X,%s,%lX", list->list[i].type, tmp2, (long) length);
1335 count += strlen (end);
1336 end = temp_buf + count;
1339 for (i = 0; i < list->next_aexpr_elt; i++)
1341 QUIT; /* Allow user to bail out with ^C. */
1342 if ((count + 10 + 2 * list->aexpr_list[i]->len) > MAX_AGENT_EXPR_LEN)
1344 (*str_list)[ndx] = savestring (temp_buf, count);
1349 sprintf (end, "X%08X,", list->aexpr_list[i]->len);
1350 end += 10; /* 'X' + 8 hex digits + ',' */
1353 end = mem2hex (list->aexpr_list[i]->buf,
1354 end, list->aexpr_list[i]->len);
1355 count += 2 * list->aexpr_list[i]->len;
1360 (*str_list)[ndx] = savestring (temp_buf, count);
1365 (*str_list)[ndx] = NULL;
1376 /* Add the printed expression EXP to *LIST. */
1379 append_exp (struct expression *exp, VEC(char_ptr) **list)
1381 struct ui_file *tmp_stream = mem_fileopen ();
1384 print_expression (exp, tmp_stream);
1386 text = ui_file_xstrdup (tmp_stream, NULL);
1388 VEC_safe_push (char_ptr, *list, text);
1389 ui_file_delete (tmp_stream);
1393 encode_actions_1 (struct command_line *action,
1394 struct bp_location *tloc,
1396 LONGEST frame_offset,
1397 struct collection_list *collect,
1398 struct collection_list *stepping_list)
1400 const char *action_exp;
1401 struct expression *exp = NULL;
1403 struct value *tempval;
1404 struct cmd_list_element *cmd;
1405 struct agent_expr *aexpr;
1407 for (; action; action = action->next)
1409 QUIT; /* Allow user to bail out with ^C. */
1410 action_exp = action->line;
1411 action_exp = skip_spaces_const (action_exp);
1413 cmd = lookup_cmd (&action_exp, cmdlist, "", -1, 1);
1415 error (_("Bad action list item: %s"), action_exp);
1417 if (cmd_cfunc_eq (cmd, collect_pseudocommand))
1419 int trace_string = 0;
1421 if (*action_exp == '/')
1422 action_exp = decode_agent_options (action_exp, &trace_string);
1425 { /* Repeat over a comma-separated list. */
1426 QUIT; /* Allow user to bail out with ^C. */
1427 action_exp = skip_spaces_const (action_exp);
1429 if (0 == strncasecmp ("$reg", action_exp, 4))
1431 for (i = 0; i < gdbarch_num_regs (target_gdbarch ()); i++)
1432 add_register (collect, i);
1433 action_exp = strchr (action_exp, ','); /* more? */
1435 else if (0 == strncasecmp ("$arg", action_exp, 4))
1437 add_local_symbols (collect,
1444 action_exp = strchr (action_exp, ','); /* more? */
1446 else if (0 == strncasecmp ("$loc", action_exp, 4))
1448 add_local_symbols (collect,
1455 action_exp = strchr (action_exp, ','); /* more? */
1457 else if (0 == strncasecmp ("$_ret", action_exp, 5))
1459 struct cleanup *old_chain1 = NULL;
1461 aexpr = gen_trace_for_return_address (tloc->address,
1465 old_chain1 = make_cleanup_free_agent_expr (aexpr);
1468 report_agent_reqs_errors (aexpr);
1470 discard_cleanups (old_chain1);
1471 add_aexpr (collect, aexpr);
1473 /* take care of the registers */
1474 if (aexpr->reg_mask_len > 0)
1478 for (ndx1 = 0; ndx1 < aexpr->reg_mask_len; ndx1++)
1480 QUIT; /* allow user to bail out with ^C */
1481 if (aexpr->reg_mask[ndx1] != 0)
1483 /* assume chars have 8 bits */
1484 for (ndx2 = 0; ndx2 < 8; ndx2++)
1485 if (aexpr->reg_mask[ndx1] & (1 << ndx2))
1486 /* it's used -- record it */
1487 add_register (collect,
1493 action_exp = strchr (action_exp, ','); /* more? */
1495 else if (0 == strncasecmp ("$_sdata", action_exp, 7))
1497 add_static_trace_data (collect);
1498 action_exp = strchr (action_exp, ','); /* more? */
1503 struct cleanup *old_chain = NULL;
1504 struct cleanup *old_chain1 = NULL;
1506 exp = parse_exp_1 (&action_exp, tloc->address,
1507 block_for_pc (tloc->address), 1);
1508 old_chain = make_cleanup (free_current_contents, &exp);
1510 switch (exp->elts[0].opcode)
1514 const char *name = &exp->elts[2].string;
1516 i = user_reg_map_name_to_regnum (target_gdbarch (),
1517 name, strlen (name));
1519 internal_error (__FILE__, __LINE__,
1520 _("Register $%s not available"),
1523 printf_filtered ("OP_REGISTER: ");
1524 add_register (collect, i);
1529 /* Safe because we know it's a simple expression. */
1530 tempval = evaluate_expression (exp);
1531 addr = value_address (tempval);
1532 /* Initialize the TYPE_LENGTH if it is a typedef. */
1533 check_typedef (exp->elts[1].type);
1534 add_memrange (collect, memrange_absolute, addr,
1535 TYPE_LENGTH (exp->elts[1].type));
1536 append_exp (exp, &collect->computed);
1541 struct symbol *sym = exp->elts[2].symbol;
1542 char_ptr name = (char_ptr) SYMBOL_NATURAL_NAME (sym);
1544 collect_symbol (collect,
1545 exp->elts[2].symbol,
1551 VEC_safe_push (char_ptr,
1552 collect->wholly_collected,
1557 default: /* Full-fledged expression. */
1558 aexpr = gen_trace_for_expr (tloc->address, exp,
1561 old_chain1 = make_cleanup_free_agent_expr (aexpr);
1565 report_agent_reqs_errors (aexpr);
1567 discard_cleanups (old_chain1);
1568 add_aexpr (collect, aexpr);
1570 /* Take care of the registers. */
1571 if (aexpr->reg_mask_len > 0)
1576 for (ndx1 = 0; ndx1 < aexpr->reg_mask_len; ndx1++)
1578 QUIT; /* Allow user to bail out with ^C. */
1579 if (aexpr->reg_mask[ndx1] != 0)
1581 /* Assume chars have 8 bits. */
1582 for (ndx2 = 0; ndx2 < 8; ndx2++)
1583 if (aexpr->reg_mask[ndx1] & (1 << ndx2))
1584 /* It's used -- record it. */
1585 add_register (collect,
1591 append_exp (exp, &collect->computed);
1594 do_cleanups (old_chain);
1597 while (action_exp && *action_exp++ == ',');
1599 else if (cmd_cfunc_eq (cmd, teval_pseudocommand))
1602 { /* Repeat over a comma-separated list. */
1603 QUIT; /* Allow user to bail out with ^C. */
1604 action_exp = skip_spaces_const (action_exp);
1607 struct cleanup *old_chain = NULL;
1608 struct cleanup *old_chain1 = NULL;
1610 exp = parse_exp_1 (&action_exp, tloc->address,
1611 block_for_pc (tloc->address), 1);
1612 old_chain = make_cleanup (free_current_contents, &exp);
1614 aexpr = gen_eval_for_expr (tloc->address, exp);
1615 old_chain1 = make_cleanup_free_agent_expr (aexpr);
1618 report_agent_reqs_errors (aexpr);
1620 discard_cleanups (old_chain1);
1621 /* Even though we're not officially collecting, add
1622 to the collect list anyway. */
1623 add_aexpr (collect, aexpr);
1625 do_cleanups (old_chain);
1628 while (action_exp && *action_exp++ == ',');
1630 else if (cmd_cfunc_eq (cmd, while_stepping_pseudocommand))
1632 /* We check against nested while-stepping when setting
1633 breakpoint action, so no way to run into nested
1635 gdb_assert (stepping_list);
1637 encode_actions_1 (action->body_list[0], tloc, frame_reg,
1638 frame_offset, stepping_list, NULL);
1641 error (_("Invalid tracepoint command '%s'"), action->line);
1645 /* Encode actions of tracepoint TLOC->owner and fill TRACEPOINT_LIST
1646 and STEPPING_LIST. Return a cleanup pointer to clean up both
1647 TRACEPOINT_LIST and STEPPING_LIST. */
1650 encode_actions_and_make_cleanup (struct bp_location *tloc,
1651 struct collection_list *tracepoint_list,
1652 struct collection_list *stepping_list)
1654 struct command_line *actions;
1656 LONGEST frame_offset;
1657 struct cleanup *back_to, *return_chain;
1659 return_chain = make_cleanup (null_cleanup, NULL);
1660 init_collection_list (tracepoint_list);
1661 init_collection_list (stepping_list);
1663 make_cleanup (do_clear_collection_list, tracepoint_list);
1664 make_cleanup (do_clear_collection_list, stepping_list);
1666 back_to = make_cleanup (null_cleanup, NULL);
1667 gdbarch_virtual_frame_pointer (tloc->gdbarch,
1668 tloc->address, &frame_reg, &frame_offset);
1670 actions = all_tracepoint_actions_and_cleanup (tloc->owner);
1672 encode_actions_1 (actions, tloc, frame_reg, frame_offset,
1673 tracepoint_list, stepping_list);
1675 memrange_sortmerge (tracepoint_list);
1676 memrange_sortmerge (stepping_list);
1678 do_cleanups (back_to);
1679 return return_chain;
1682 /* Render all actions into gdb protocol. */
1685 encode_actions_rsp (struct bp_location *tloc, char ***tdp_actions,
1686 char ***stepping_actions)
1688 struct collection_list tracepoint_list, stepping_list;
1689 struct cleanup *cleanup;
1691 *tdp_actions = NULL;
1692 *stepping_actions = NULL;
1694 cleanup = encode_actions_and_make_cleanup (tloc, &tracepoint_list,
1697 *tdp_actions = stringify_collection_list (&tracepoint_list);
1698 *stepping_actions = stringify_collection_list (&stepping_list);
1700 do_cleanups (cleanup);
1704 add_aexpr (struct collection_list *collect, struct agent_expr *aexpr)
1706 if (collect->next_aexpr_elt >= collect->aexpr_listsize)
1708 collect->aexpr_list = XRESIZEVEC (struct agent_expr *,
1709 collect->aexpr_list,
1710 2 * collect->aexpr_listsize);
1711 collect->aexpr_listsize *= 2;
1713 collect->aexpr_list[collect->next_aexpr_elt] = aexpr;
1714 collect->next_aexpr_elt++;
1718 process_tracepoint_on_disconnect (void)
1720 VEC(breakpoint_p) *tp_vec = NULL;
1722 struct breakpoint *b;
1723 int has_pending_p = 0;
1725 /* Check whether we still have pending tracepoint. If we have, warn the
1726 user that pending tracepoint will no longer work. */
1727 tp_vec = all_tracepoints ();
1728 for (ix = 0; VEC_iterate (breakpoint_p, tp_vec, ix, b); ix++)
1737 struct bp_location *loc1;
1739 for (loc1 = b->loc; loc1; loc1 = loc1->next)
1741 if (loc1->shlib_disabled)
1752 VEC_free (breakpoint_p, tp_vec);
1755 warning (_("Pending tracepoints will not be resolved while"
1756 " GDB is disconnected\n"));
1759 /* Reset local state of tracing. */
1762 trace_reset_local_state (void)
1764 set_traceframe_num (-1);
1765 set_tracepoint_num (-1);
1766 set_traceframe_context (NULL);
1767 clear_traceframe_info ();
1771 start_tracing (char *notes)
1773 VEC(breakpoint_p) *tp_vec = NULL;
1775 struct breakpoint *b;
1776 struct trace_state_variable *tsv;
1777 int any_enabled = 0, num_to_download = 0;
1780 tp_vec = all_tracepoints ();
1782 /* No point in tracing without any tracepoints... */
1783 if (VEC_length (breakpoint_p, tp_vec) == 0)
1785 VEC_free (breakpoint_p, tp_vec);
1786 error (_("No tracepoints defined, not starting trace"));
1789 for (ix = 0; VEC_iterate (breakpoint_p, tp_vec, ix, b); ix++)
1791 if (b->enable_state == bp_enabled)
1794 if ((b->type == bp_fast_tracepoint
1795 ? may_insert_fast_tracepoints
1796 : may_insert_tracepoints))
1799 warning (_("May not insert %stracepoints, skipping tracepoint %d"),
1800 (b->type == bp_fast_tracepoint ? "fast " : ""), b->number);
1805 if (target_supports_enable_disable_tracepoint ())
1806 warning (_("No tracepoints enabled"));
1809 /* No point in tracing with only disabled tracepoints that
1810 cannot be re-enabled. */
1811 VEC_free (breakpoint_p, tp_vec);
1812 error (_("No tracepoints enabled, not starting trace"));
1816 if (num_to_download <= 0)
1818 VEC_free (breakpoint_p, tp_vec);
1819 error (_("No tracepoints that may be downloaded, not starting trace"));
1822 target_trace_init ();
1824 for (ix = 0; VEC_iterate (breakpoint_p, tp_vec, ix, b); ix++)
1826 struct tracepoint *t = (struct tracepoint *) b;
1827 struct bp_location *loc;
1828 int bp_location_downloaded = 0;
1830 /* Clear `inserted' flag. */
1831 for (loc = b->loc; loc; loc = loc->next)
1834 if ((b->type == bp_fast_tracepoint
1835 ? !may_insert_fast_tracepoints
1836 : !may_insert_tracepoints))
1839 t->number_on_target = 0;
1841 for (loc = b->loc; loc; loc = loc->next)
1843 /* Since tracepoint locations are never duplicated, `inserted'
1844 flag should be zero. */
1845 gdb_assert (!loc->inserted);
1847 target_download_tracepoint (loc);
1850 bp_location_downloaded = 1;
1853 t->number_on_target = b->number;
1855 for (loc = b->loc; loc; loc = loc->next)
1856 if (loc->probe.probe != NULL
1857 && loc->probe.probe->pops->set_semaphore != NULL)
1858 loc->probe.probe->pops->set_semaphore (loc->probe.probe,
1862 if (bp_location_downloaded)
1863 observer_notify_breakpoint_modified (b);
1865 VEC_free (breakpoint_p, tp_vec);
1867 /* Send down all the trace state variables too. */
1868 for (ix = 0; VEC_iterate (tsv_s, tvariables, ix, tsv); ++ix)
1870 target_download_trace_state_variable (tsv);
1873 /* Tell target to treat text-like sections as transparent. */
1874 target_trace_set_readonly_regions ();
1875 /* Set some mode flags. */
1876 target_set_disconnected_tracing (disconnected_tracing);
1877 target_set_circular_trace_buffer (circular_trace_buffer);
1878 target_set_trace_buffer_size (trace_buffer_size);
1881 notes = trace_notes;
1882 ret = target_set_trace_notes (trace_user, notes, NULL);
1884 if (!ret && (trace_user || notes))
1885 warning (_("Target does not support trace user/notes, info ignored"));
1887 /* Now insert traps and begin collecting data. */
1888 target_trace_start ();
1890 /* Reset our local state. */
1891 trace_reset_local_state ();
1892 current_trace_status()->running = 1;
1895 /* The tstart command requests the target to start a new trace run.
1896 The command passes any arguments it has to the target verbatim, as
1897 an optional "trace note". This is useful as for instance a warning
1898 to other users if the trace runs disconnected, and you don't want
1899 anybody else messing with the target. */
1902 trace_start_command (char *args, int from_tty)
1904 dont_repeat (); /* Like "run", dangerous to repeat accidentally. */
1906 if (current_trace_status ()->running)
1909 && !query (_("A trace is running already. Start a new run? ")))
1910 error (_("New trace run not started."));
1913 start_tracing (args);
1916 /* The tstop command stops the tracing run. The command passes any
1917 supplied arguments to the target verbatim as a "stop note"; if the
1918 target supports trace notes, then it will be reported back as part
1919 of the trace run's status. */
1922 trace_stop_command (char *args, int from_tty)
1924 if (!current_trace_status ()->running)
1925 error (_("Trace is not running."));
1927 stop_tracing (args);
1931 stop_tracing (char *note)
1934 VEC(breakpoint_p) *tp_vec = NULL;
1936 struct breakpoint *t;
1938 target_trace_stop ();
1940 tp_vec = all_tracepoints ();
1941 for (ix = 0; VEC_iterate (breakpoint_p, tp_vec, ix, t); ix++)
1943 struct bp_location *loc;
1945 if ((t->type == bp_fast_tracepoint
1946 ? !may_insert_fast_tracepoints
1947 : !may_insert_tracepoints))
1950 for (loc = t->loc; loc; loc = loc->next)
1952 /* GDB can be totally absent in some disconnected trace scenarios,
1953 but we don't really care if this semaphore goes out of sync.
1954 That's why we are decrementing it here, but not taking care
1956 if (loc->probe.probe != NULL
1957 && loc->probe.probe->pops->clear_semaphore != NULL)
1958 loc->probe.probe->pops->clear_semaphore (loc->probe.probe,
1964 VEC_free (breakpoint_p, tp_vec);
1967 note = trace_stop_notes;
1968 ret = target_set_trace_notes (NULL, NULL, note);
1971 warning (_("Target does not support trace notes, note ignored"));
1973 /* Should change in response to reply? */
1974 current_trace_status ()->running = 0;
1977 /* tstatus command */
1979 trace_status_command (char *args, int from_tty)
1981 struct trace_status *ts = current_trace_status ();
1983 VEC(breakpoint_p) *tp_vec = NULL;
1984 struct breakpoint *t;
1986 status = target_get_trace_status (ts);
1990 if (ts->filename != NULL)
1991 printf_filtered (_("Using a trace file.\n"));
1994 printf_filtered (_("Trace can not be run on this target.\n"));
1999 if (!ts->running_known)
2001 printf_filtered (_("Run/stop status is unknown.\n"));
2003 else if (ts->running)
2005 printf_filtered (_("Trace is running on the target.\n"));
2009 switch (ts->stop_reason)
2011 case trace_never_run:
2012 printf_filtered (_("No trace has been run on the target.\n"));
2016 printf_filtered (_("Trace stopped by a tstop command (%s).\n"),
2019 printf_filtered (_("Trace stopped by a tstop command.\n"));
2021 case trace_buffer_full:
2022 printf_filtered (_("Trace stopped because the buffer was full.\n"));
2024 case trace_disconnected:
2025 printf_filtered (_("Trace stopped because of disconnection.\n"));
2027 case tracepoint_passcount:
2028 printf_filtered (_("Trace stopped by tracepoint %d.\n"),
2029 ts->stopping_tracepoint);
2031 case tracepoint_error:
2032 if (ts->stopping_tracepoint)
2033 printf_filtered (_("Trace stopped by an "
2034 "error (%s, tracepoint %d).\n"),
2035 ts->stop_desc, ts->stopping_tracepoint);
2037 printf_filtered (_("Trace stopped by an error (%s).\n"),
2040 case trace_stop_reason_unknown:
2041 printf_filtered (_("Trace stopped for an unknown reason.\n"));
2044 printf_filtered (_("Trace stopped for some other reason (%d).\n"),
2050 if (ts->traceframes_created >= 0
2051 && ts->traceframe_count != ts->traceframes_created)
2053 printf_filtered (_("Buffer contains %d trace "
2054 "frames (of %d created total).\n"),
2055 ts->traceframe_count, ts->traceframes_created);
2057 else if (ts->traceframe_count >= 0)
2059 printf_filtered (_("Collected %d trace frames.\n"),
2060 ts->traceframe_count);
2063 if (ts->buffer_free >= 0)
2065 if (ts->buffer_size >= 0)
2067 printf_filtered (_("Trace buffer has %d bytes of %d bytes free"),
2068 ts->buffer_free, ts->buffer_size);
2069 if (ts->buffer_size > 0)
2070 printf_filtered (_(" (%d%% full)"),
2071 ((int) ((((long long) (ts->buffer_size
2072 - ts->buffer_free)) * 100)
2073 / ts->buffer_size)));
2074 printf_filtered (_(".\n"));
2077 printf_filtered (_("Trace buffer has %d bytes free.\n"),
2081 if (ts->disconnected_tracing)
2082 printf_filtered (_("Trace will continue if GDB disconnects.\n"));
2084 printf_filtered (_("Trace will stop if GDB disconnects.\n"));
2086 if (ts->circular_buffer)
2087 printf_filtered (_("Trace buffer is circular.\n"));
2089 if (ts->user_name && strlen (ts->user_name) > 0)
2090 printf_filtered (_("Trace user is %s.\n"), ts->user_name);
2092 if (ts->notes && strlen (ts->notes) > 0)
2093 printf_filtered (_("Trace notes: %s.\n"), ts->notes);
2095 /* Now report on what we're doing with tfind. */
2096 if (traceframe_number >= 0)
2097 printf_filtered (_("Looking at trace frame %d, tracepoint %d.\n"),
2098 traceframe_number, tracepoint_number);
2100 printf_filtered (_("Not looking at any trace frame.\n"));
2102 /* Report start/stop times if supplied. */
2107 LONGEST run_time = ts->stop_time - ts->start_time;
2109 /* Reporting a run time is more readable than two long numbers. */
2110 printf_filtered (_("Trace started at %ld.%06ld secs, stopped %ld.%06ld secs later.\n"),
2111 (long int) (ts->start_time / 1000000),
2112 (long int) (ts->start_time % 1000000),
2113 (long int) (run_time / 1000000),
2114 (long int) (run_time % 1000000));
2117 printf_filtered (_("Trace started at %ld.%06ld secs.\n"),
2118 (long int) (ts->start_time / 1000000),
2119 (long int) (ts->start_time % 1000000));
2121 else if (ts->stop_time)
2122 printf_filtered (_("Trace stopped at %ld.%06ld secs.\n"),
2123 (long int) (ts->stop_time / 1000000),
2124 (long int) (ts->stop_time % 1000000));
2126 /* Now report any per-tracepoint status available. */
2127 tp_vec = all_tracepoints ();
2129 for (ix = 0; VEC_iterate (breakpoint_p, tp_vec, ix, t); ix++)
2130 target_get_tracepoint_status (t, NULL);
2132 VEC_free (breakpoint_p, tp_vec);
2135 /* Report the trace status to uiout, in a way suitable for MI, and not
2136 suitable for CLI. If ON_STOP is true, suppress a few fields that
2137 are not meaningful in the -trace-stop response.
2139 The implementation is essentially parallel to trace_status_command, but
2140 merging them will result in unreadable code. */
2142 trace_status_mi (int on_stop)
2144 struct ui_out *uiout = current_uiout;
2145 struct trace_status *ts = current_trace_status ();
2148 status = target_get_trace_status (ts);
2150 if (status == -1 && ts->filename == NULL)
2152 ui_out_field_string (uiout, "supported", "0");
2156 if (ts->filename != NULL)
2157 ui_out_field_string (uiout, "supported", "file");
2159 ui_out_field_string (uiout, "supported", "1");
2161 if (ts->filename != NULL)
2162 ui_out_field_string (uiout, "trace-file", ts->filename);
2164 gdb_assert (ts->running_known);
2168 ui_out_field_string (uiout, "running", "1");
2170 /* Unlike CLI, do not show the state of 'disconnected-tracing' variable.
2171 Given that the frontend gets the status either on -trace-stop, or from
2172 -trace-status after re-connection, it does not seem like this
2173 information is necessary for anything. It is not necessary for either
2174 figuring the vital state of the target nor for navigation of trace
2175 frames. If the frontend wants to show the current state is some
2176 configure dialog, it can request the value when such dialog is
2177 invoked by the user. */
2181 char *stop_reason = NULL;
2182 int stopping_tracepoint = -1;
2185 ui_out_field_string (uiout, "running", "0");
2187 if (ts->stop_reason != trace_stop_reason_unknown)
2189 switch (ts->stop_reason)
2192 stop_reason = "request";
2194 case trace_buffer_full:
2195 stop_reason = "overflow";
2197 case trace_disconnected:
2198 stop_reason = "disconnection";
2200 case tracepoint_passcount:
2201 stop_reason = "passcount";
2202 stopping_tracepoint = ts->stopping_tracepoint;
2204 case tracepoint_error:
2205 stop_reason = "error";
2206 stopping_tracepoint = ts->stopping_tracepoint;
2212 ui_out_field_string (uiout, "stop-reason", stop_reason);
2213 if (stopping_tracepoint != -1)
2214 ui_out_field_int (uiout, "stopping-tracepoint",
2215 stopping_tracepoint);
2216 if (ts->stop_reason == tracepoint_error)
2217 ui_out_field_string (uiout, "error-description",
2223 if (ts->traceframe_count != -1)
2224 ui_out_field_int (uiout, "frames", ts->traceframe_count);
2225 if (ts->traceframes_created != -1)
2226 ui_out_field_int (uiout, "frames-created", ts->traceframes_created);
2227 if (ts->buffer_size != -1)
2228 ui_out_field_int (uiout, "buffer-size", ts->buffer_size);
2229 if (ts->buffer_free != -1)
2230 ui_out_field_int (uiout, "buffer-free", ts->buffer_free);
2232 ui_out_field_int (uiout, "disconnected", ts->disconnected_tracing);
2233 ui_out_field_int (uiout, "circular", ts->circular_buffer);
2235 ui_out_field_string (uiout, "user-name", ts->user_name);
2236 ui_out_field_string (uiout, "notes", ts->notes);
2241 xsnprintf (buf, sizeof buf, "%ld.%06ld",
2242 (long int) (ts->start_time / 1000000),
2243 (long int) (ts->start_time % 1000000));
2244 ui_out_field_string (uiout, "start-time", buf);
2245 xsnprintf (buf, sizeof buf, "%ld.%06ld",
2246 (long int) (ts->stop_time / 1000000),
2247 (long int) (ts->stop_time % 1000000));
2248 ui_out_field_string (uiout, "stop-time", buf);
2252 /* Check if a trace run is ongoing. If so, and FROM_TTY, query the
2253 user if she really wants to detach. */
2256 query_if_trace_running (int from_tty)
2261 /* It can happen that the target that was tracing went away on its
2262 own, and we didn't notice. Get a status update, and if the
2263 current target doesn't even do tracing, then assume it's not
2265 if (target_get_trace_status (current_trace_status ()) < 0)
2266 current_trace_status ()->running = 0;
2268 /* If running interactively, give the user the option to cancel and
2269 then decide what to do differently with the run. Scripts are
2270 just going to disconnect and let the target deal with it,
2271 according to how it's been instructed previously via
2272 disconnected-tracing. */
2273 if (current_trace_status ()->running)
2275 process_tracepoint_on_disconnect ();
2277 if (current_trace_status ()->disconnected_tracing)
2279 if (!query (_("Trace is running and will "
2280 "continue after detach; detach anyway? ")))
2281 error (_("Not confirmed."));
2285 if (!query (_("Trace is running but will "
2286 "stop on detach; detach anyway? ")))
2287 error (_("Not confirmed."));
2292 /* This function handles the details of what to do about an ongoing
2293 tracing run if the user has asked to detach or otherwise disconnect
2297 disconnect_tracing (void)
2299 /* Also we want to be out of tfind mode, otherwise things can get
2300 confusing upon reconnection. Just use these calls instead of
2301 full tfind_1 behavior because we're in the middle of detaching,
2302 and there's no point to updating current stack frame etc. */
2303 trace_reset_local_state ();
2306 /* Worker function for the various flavors of the tfind command. */
2308 tfind_1 (enum trace_find_type type, int num,
2309 CORE_ADDR addr1, CORE_ADDR addr2,
2312 int target_frameno = -1, target_tracept = -1;
2313 struct frame_id old_frame_id = null_frame_id;
2314 struct tracepoint *tp;
2315 struct ui_out *uiout = current_uiout;
2317 /* Only try to get the current stack frame if we have a chance of
2318 succeeding. In particular, if we're trying to get a first trace
2319 frame while all threads are running, it's not going to succeed,
2320 so leave it with a default value and let the frame comparison
2321 below (correctly) decide to print out the source location of the
2323 if (!(type == tfind_number && num == -1)
2324 && (has_stack_frames () || traceframe_number >= 0))
2325 old_frame_id = get_frame_id (get_current_frame ());
2327 target_frameno = target_trace_find (type, num, addr1, addr2,
2330 if (type == tfind_number
2332 && target_frameno == -1)
2334 /* We told the target to get out of tfind mode, and it did. */
2336 else if (target_frameno == -1)
2338 /* A request for a non-existent trace frame has failed.
2339 Our response will be different, depending on FROM_TTY:
2341 If FROM_TTY is true, meaning that this command was
2342 typed interactively by the user, then give an error
2343 and DO NOT change the state of traceframe_number etc.
2345 However if FROM_TTY is false, meaning that we're either
2346 in a script, a loop, or a user-defined command, then
2347 DON'T give an error, but DO change the state of
2348 traceframe_number etc. to invalid.
2350 The rationalle is that if you typed the command, you
2351 might just have committed a typo or something, and you'd
2352 like to NOT lose your current debugging state. However
2353 if you're in a user-defined command or especially in a
2354 loop, then you need a way to detect that the command
2355 failed WITHOUT aborting. This allows you to write
2356 scripts that search thru the trace buffer until the end,
2357 and then continue on to do something else. */
2360 error (_("Target failed to find requested trace frame."));
2364 printf_filtered ("End of trace buffer.\n");
2365 #if 0 /* dubious now? */
2366 /* The following will not recurse, since it's
2368 trace_find_command ("-1", from_tty);
2373 tp = get_tracepoint_by_number_on_target (target_tracept);
2375 reinit_frame_cache ();
2376 target_dcache_invalidate ();
2378 set_tracepoint_num (tp ? tp->base.number : target_tracept);
2380 if (target_frameno != get_traceframe_number ())
2381 observer_notify_traceframe_changed (target_frameno, tracepoint_number);
2383 set_current_traceframe (target_frameno);
2385 if (target_frameno == -1)
2386 set_traceframe_context (NULL);
2388 set_traceframe_context (get_current_frame ());
2390 if (traceframe_number >= 0)
2392 /* Use different branches for MI and CLI to make CLI messages
2394 if (ui_out_is_mi_like_p (uiout))
2396 ui_out_field_string (uiout, "found", "1");
2397 ui_out_field_int (uiout, "tracepoint", tracepoint_number);
2398 ui_out_field_int (uiout, "traceframe", traceframe_number);
2402 printf_unfiltered (_("Found trace frame %d, tracepoint %d\n"),
2403 traceframe_number, tracepoint_number);
2408 if (ui_out_is_mi_like_p (uiout))
2409 ui_out_field_string (uiout, "found", "0");
2410 else if (type == tfind_number && num == -1)
2411 printf_unfiltered (_("No longer looking at any trace frame\n"));
2412 else /* This case may never occur, check. */
2413 printf_unfiltered (_("No trace frame found\n"));
2416 /* If we're in nonstop mode and getting out of looking at trace
2417 frames, there won't be any current frame to go back to and
2420 && (has_stack_frames () || traceframe_number >= 0))
2422 enum print_what print_what;
2424 /* NOTE: in imitation of the step command, try to determine
2425 whether we have made a transition from one function to
2426 another. If so, we'll print the "stack frame" (ie. the new
2427 function and it's arguments) -- otherwise we'll just show the
2430 if (frame_id_eq (old_frame_id,
2431 get_frame_id (get_current_frame ())))
2432 print_what = SRC_LINE;
2434 print_what = SRC_AND_LOC;
2436 print_stack_frame (get_selected_frame (NULL), 1, print_what, 1);
2441 /* Error on looking at traceframes while trace is running. */
2444 check_trace_running (struct trace_status *status)
2446 if (status->running && status->filename == NULL)
2447 error (_("May not look at trace frames while trace is running."));
2450 /* trace_find_command takes a trace frame number n,
2451 sends "QTFrame:<n>" to the target,
2452 and accepts a reply that may contain several optional pieces
2453 of information: a frame number, a tracepoint number, and an
2454 indication of whether this is a trap frame or a stepping frame.
2456 The minimal response is just "OK" (which indicates that the
2457 target does not give us a frame number or a tracepoint number).
2458 Instead of that, the target may send us a string containing
2460 F<hexnum> (gives the selected frame number)
2461 T<hexnum> (gives the selected tracepoint number)
2466 trace_find_command (char *args, int from_tty)
2467 { /* This should only be called with a numeric argument. */
2470 check_trace_running (current_trace_status ());
2472 if (args == 0 || *args == 0)
2473 { /* TFIND with no args means find NEXT trace frame. */
2474 if (traceframe_number == -1)
2475 frameno = 0; /* "next" is first one. */
2477 frameno = traceframe_number + 1;
2479 else if (0 == strcmp (args, "-"))
2481 if (traceframe_number == -1)
2482 error (_("not debugging trace buffer"));
2483 else if (from_tty && traceframe_number == 0)
2484 error (_("already at start of trace buffer"));
2486 frameno = traceframe_number - 1;
2488 /* A hack to work around eval's need for fp to have been collected. */
2489 else if (0 == strcmp (args, "-1"))
2492 frameno = parse_and_eval_long (args);
2495 error (_("invalid input (%d is less than zero)"), frameno);
2497 tfind_1 (tfind_number, frameno, 0, 0, from_tty);
2502 trace_find_end_command (char *args, int from_tty)
2504 trace_find_command ("-1", from_tty);
2509 trace_find_start_command (char *args, int from_tty)
2511 trace_find_command ("0", from_tty);
2514 /* tfind pc command */
2516 trace_find_pc_command (char *args, int from_tty)
2520 check_trace_running (current_trace_status ());
2522 if (args == 0 || *args == 0)
2523 pc = regcache_read_pc (get_current_regcache ());
2525 pc = parse_and_eval_address (args);
2527 tfind_1 (tfind_pc, 0, pc, 0, from_tty);
2530 /* tfind tracepoint command */
2532 trace_find_tracepoint_command (char *args, int from_tty)
2535 struct tracepoint *tp;
2537 check_trace_running (current_trace_status ());
2539 if (args == 0 || *args == 0)
2541 if (tracepoint_number == -1)
2542 error (_("No current tracepoint -- please supply an argument."));
2544 tdp = tracepoint_number; /* Default is current TDP. */
2547 tdp = parse_and_eval_long (args);
2549 /* If we have the tracepoint on hand, use the number that the
2550 target knows about (which may be different if we disconnected
2551 and reconnected). */
2552 tp = get_tracepoint (tdp);
2554 tdp = tp->number_on_target;
2556 tfind_1 (tfind_tp, tdp, 0, 0, from_tty);
2559 /* TFIND LINE command:
2561 This command will take a sourceline for argument, just like BREAK
2562 or TRACE (ie. anything that "decode_line_1" can handle).
2564 With no argument, this command will find the next trace frame
2565 corresponding to a source line OTHER THAN THE CURRENT ONE. */
2568 trace_find_line_command (char *args, int from_tty)
2570 static CORE_ADDR start_pc, end_pc;
2571 struct symtabs_and_lines sals;
2572 struct symtab_and_line sal;
2573 struct cleanup *old_chain;
2575 check_trace_running (current_trace_status ());
2577 if (args == 0 || *args == 0)
2579 sal = find_pc_line (get_frame_pc (get_current_frame ()), 0);
2581 sals.sals = XNEW (struct symtab_and_line);
2586 sals = decode_line_with_current_source (args, DECODE_LINE_FUNFIRSTLINE);
2590 old_chain = make_cleanup (xfree, sals.sals);
2591 if (sal.symtab == 0)
2592 error (_("No line number information available."));
2594 if (sal.line > 0 && find_line_pc_range (sal, &start_pc, &end_pc))
2596 if (start_pc == end_pc)
2598 printf_filtered ("Line %d of \"%s\"",
2600 symtab_to_filename_for_display (sal.symtab));
2602 printf_filtered (" is at address ");
2603 print_address (get_current_arch (), start_pc, gdb_stdout);
2605 printf_filtered (" but contains no code.\n");
2606 sal = find_pc_line (start_pc, 0);
2608 && find_line_pc_range (sal, &start_pc, &end_pc)
2609 && start_pc != end_pc)
2610 printf_filtered ("Attempting to find line %d instead.\n",
2613 error (_("Cannot find a good line."));
2617 /* Is there any case in which we get here, and have an address
2618 which the user would want to see? If we have debugging
2619 symbols and no line numbers? */
2620 error (_("Line number %d is out of range for \"%s\"."),
2621 sal.line, symtab_to_filename_for_display (sal.symtab));
2623 /* Find within range of stated line. */
2625 tfind_1 (tfind_range, 0, start_pc, end_pc - 1, from_tty);
2627 tfind_1 (tfind_outside, 0, start_pc, end_pc - 1, from_tty);
2628 do_cleanups (old_chain);
2631 /* tfind range command */
2633 trace_find_range_command (char *args, int from_tty)
2635 static CORE_ADDR start, stop;
2638 check_trace_running (current_trace_status ());
2640 if (args == 0 || *args == 0)
2641 { /* XXX FIXME: what should default behavior be? */
2642 printf_filtered ("Usage: tfind range <startaddr>,<endaddr>\n");
2646 if (0 != (tmp = strchr (args, ',')))
2648 *tmp++ = '\0'; /* Terminate start address. */
2649 tmp = skip_spaces (tmp);
2650 start = parse_and_eval_address (args);
2651 stop = parse_and_eval_address (tmp);
2654 { /* No explicit end address? */
2655 start = parse_and_eval_address (args);
2656 stop = start + 1; /* ??? */
2659 tfind_1 (tfind_range, 0, start, stop, from_tty);
2662 /* tfind outside command */
2664 trace_find_outside_command (char *args, int from_tty)
2666 CORE_ADDR start, stop;
2669 if (current_trace_status ()->running
2670 && current_trace_status ()->filename == NULL)
2671 error (_("May not look at trace frames while trace is running."));
2673 if (args == 0 || *args == 0)
2674 { /* XXX FIXME: what should default behavior be? */
2675 printf_filtered ("Usage: tfind outside <startaddr>,<endaddr>\n");
2679 if (0 != (tmp = strchr (args, ',')))
2681 *tmp++ = '\0'; /* Terminate start address. */
2682 tmp = skip_spaces (tmp);
2683 start = parse_and_eval_address (args);
2684 stop = parse_and_eval_address (tmp);
2687 { /* No explicit end address? */
2688 start = parse_and_eval_address (args);
2689 stop = start + 1; /* ??? */
2692 tfind_1 (tfind_outside, 0, start, stop, from_tty);
2695 /* info scope command: list the locals for a scope. */
2697 scope_info (char *args, int from_tty)
2699 struct symtabs_and_lines sals;
2701 struct bound_minimal_symbol msym;
2702 const struct block *block;
2703 const char *symname;
2704 char *save_args = args;
2705 struct block_iterator iter;
2707 struct gdbarch *gdbarch;
2709 struct event_location *location;
2710 struct cleanup *back_to;
2712 if (args == 0 || *args == 0)
2713 error (_("requires an argument (function, "
2714 "line or *addr) to define a scope"));
2716 location = string_to_event_location (&args, current_language);
2717 back_to = make_cleanup_delete_event_location (location);
2718 sals = decode_line_1 (location, DECODE_LINE_FUNFIRSTLINE, NULL, NULL, 0);
2719 if (sals.nelts == 0)
2721 /* Presumably decode_line_1 has already warned. */
2722 do_cleanups (back_to);
2726 /* Resolve line numbers to PC. */
2727 resolve_sal_pc (&sals.sals[0]);
2728 block = block_for_pc (sals.sals[0].pc);
2732 QUIT; /* Allow user to bail out with ^C. */
2733 ALL_BLOCK_SYMBOLS (block, iter, sym)
2735 QUIT; /* Allow user to bail out with ^C. */
2737 printf_filtered ("Scope for %s:\n", save_args);
2740 symname = SYMBOL_PRINT_NAME (sym);
2741 if (symname == NULL || *symname == '\0')
2742 continue; /* Probably botched, certainly useless. */
2744 gdbarch = symbol_arch (sym);
2746 printf_filtered ("Symbol %s is ", symname);
2748 if (SYMBOL_COMPUTED_OPS (sym) != NULL)
2749 SYMBOL_COMPUTED_OPS (sym)->describe_location (sym,
2750 BLOCK_START (block),
2754 switch (SYMBOL_CLASS (sym))
2757 case LOC_UNDEF: /* Messed up symbol? */
2758 printf_filtered ("a bogus symbol, class %d.\n",
2759 SYMBOL_CLASS (sym));
2760 count--; /* Don't count this one. */
2763 printf_filtered ("a constant with value %s (%s)",
2764 plongest (SYMBOL_VALUE (sym)),
2765 hex_string (SYMBOL_VALUE (sym)));
2767 case LOC_CONST_BYTES:
2768 printf_filtered ("constant bytes: ");
2769 if (SYMBOL_TYPE (sym))
2770 for (j = 0; j < TYPE_LENGTH (SYMBOL_TYPE (sym)); j++)
2771 fprintf_filtered (gdb_stdout, " %02x",
2772 (unsigned) SYMBOL_VALUE_BYTES (sym)[j]);
2775 printf_filtered ("in static storage at address ");
2776 printf_filtered ("%s", paddress (gdbarch,
2777 SYMBOL_VALUE_ADDRESS (sym)));
2780 /* GDBARCH is the architecture associated with the objfile
2781 the symbol is defined in; the target architecture may be
2782 different, and may provide additional registers. However,
2783 we do not know the target architecture at this point.
2784 We assume the objfile architecture will contain all the
2785 standard registers that occur in debug info in that
2787 regno = SYMBOL_REGISTER_OPS (sym)->register_number (sym,
2790 if (SYMBOL_IS_ARGUMENT (sym))
2791 printf_filtered ("an argument in register $%s",
2792 gdbarch_register_name (gdbarch, regno));
2794 printf_filtered ("a local variable in register $%s",
2795 gdbarch_register_name (gdbarch, regno));
2798 printf_filtered ("an argument at stack/frame offset %s",
2799 plongest (SYMBOL_VALUE (sym)));
2802 printf_filtered ("a local variable at frame offset %s",
2803 plongest (SYMBOL_VALUE (sym)));
2806 printf_filtered ("a reference argument at offset %s",
2807 plongest (SYMBOL_VALUE (sym)));
2809 case LOC_REGPARM_ADDR:
2810 /* Note comment at LOC_REGISTER. */
2811 regno = SYMBOL_REGISTER_OPS (sym)->register_number (sym,
2813 printf_filtered ("the address of an argument, in register $%s",
2814 gdbarch_register_name (gdbarch, regno));
2817 printf_filtered ("a typedef.\n");
2820 printf_filtered ("a label at address ");
2821 printf_filtered ("%s", paddress (gdbarch,
2822 SYMBOL_VALUE_ADDRESS (sym)));
2825 printf_filtered ("a function at address ");
2826 printf_filtered ("%s",
2827 paddress (gdbarch, BLOCK_START (SYMBOL_BLOCK_VALUE (sym))));
2829 case LOC_UNRESOLVED:
2830 msym = lookup_minimal_symbol (SYMBOL_LINKAGE_NAME (sym),
2832 if (msym.minsym == NULL)
2833 printf_filtered ("Unresolved Static");
2836 printf_filtered ("static storage at address ");
2837 printf_filtered ("%s",
2839 BMSYMBOL_VALUE_ADDRESS (msym)));
2842 case LOC_OPTIMIZED_OUT:
2843 printf_filtered ("optimized out.\n");
2846 gdb_assert_not_reached (_("LOC_COMPUTED variable missing a method"));
2849 if (SYMBOL_TYPE (sym))
2850 printf_filtered (", length %d.\n",
2851 TYPE_LENGTH (check_typedef (SYMBOL_TYPE (sym))));
2853 if (BLOCK_FUNCTION (block))
2856 block = BLOCK_SUPERBLOCK (block);
2859 printf_filtered ("Scope for %s contains no locals or arguments.\n",
2861 do_cleanups (back_to);
2864 /* Helper for trace_dump_command. Dump the action list starting at
2865 ACTION. STEPPING_ACTIONS is true if we're iterating over the
2866 actions of the body of a while-stepping action. STEPPING_FRAME is
2867 set if the current traceframe was determined to be a while-stepping
2871 trace_dump_actions (struct command_line *action,
2872 int stepping_actions, int stepping_frame,
2875 const char *action_exp, *next_comma;
2877 for (; action != NULL; action = action->next)
2879 struct cmd_list_element *cmd;
2881 QUIT; /* Allow user to bail out with ^C. */
2882 action_exp = action->line;
2883 action_exp = skip_spaces_const (action_exp);
2885 /* The collection actions to be done while stepping are
2886 bracketed by the commands "while-stepping" and "end". */
2888 if (*action_exp == '#') /* comment line */
2891 cmd = lookup_cmd (&action_exp, cmdlist, "", -1, 1);
2893 error (_("Bad action list item: %s"), action_exp);
2895 if (cmd_cfunc_eq (cmd, while_stepping_pseudocommand))
2899 for (i = 0; i < action->body_count; ++i)
2900 trace_dump_actions (action->body_list[i],
2901 1, stepping_frame, from_tty);
2903 else if (cmd_cfunc_eq (cmd, collect_pseudocommand))
2905 /* Display the collected data.
2906 For the trap frame, display only what was collected at
2907 the trap. Likewise for stepping frames, display only
2908 what was collected while stepping. This means that the
2909 two boolean variables, STEPPING_FRAME and
2910 STEPPING_ACTIONS should be equal. */
2911 if (stepping_frame == stepping_actions)
2914 struct cleanup *old_chain
2915 = make_cleanup (free_current_contents, &cmd);
2916 int trace_string = 0;
2918 if (*action_exp == '/')
2919 action_exp = decode_agent_options (action_exp, &trace_string);
2922 { /* Repeat over a comma-separated list. */
2923 QUIT; /* Allow user to bail out with ^C. */
2924 if (*action_exp == ',')
2926 action_exp = skip_spaces_const (action_exp);
2928 next_comma = strchr (action_exp, ',');
2930 if (0 == strncasecmp (action_exp, "$reg", 4))
2931 registers_info (NULL, from_tty);
2932 else if (0 == strncasecmp (action_exp, "$_ret", 5))
2934 else if (0 == strncasecmp (action_exp, "$loc", 4))
2935 locals_info (NULL, from_tty);
2936 else if (0 == strncasecmp (action_exp, "$arg", 4))
2937 args_info (NULL, from_tty);
2940 if (next_comma != NULL)
2942 size_t len = next_comma - action_exp;
2944 cmd = (char *) xrealloc (cmd, len + 1);
2945 memcpy (cmd, action_exp, len);
2950 size_t len = strlen (action_exp);
2952 cmd = (char *) xrealloc (cmd, len + 1);
2953 memcpy (cmd, action_exp, len + 1);
2956 printf_filtered ("%s = ", cmd);
2957 output_command_const (cmd, from_tty);
2958 printf_filtered ("\n");
2960 action_exp = next_comma;
2962 while (action_exp && *action_exp == ',');
2964 do_cleanups (old_chain);
2970 /* Return bp_location of the tracepoint associated with the current
2971 traceframe. Set *STEPPING_FRAME_P to 1 if the current traceframe
2972 is a stepping traceframe. */
2974 struct bp_location *
2975 get_traceframe_location (int *stepping_frame_p)
2977 struct tracepoint *t;
2978 struct bp_location *tloc;
2979 struct regcache *regcache;
2981 if (tracepoint_number == -1)
2982 error (_("No current trace frame."));
2984 t = get_tracepoint (tracepoint_number);
2987 error (_("No known tracepoint matches 'current' tracepoint #%d."),
2990 /* The current frame is a trap frame if the frame PC is equal to the
2991 tracepoint PC. If not, then the current frame was collected
2992 during single-stepping. */
2993 regcache = get_current_regcache ();
2995 /* If the traceframe's address matches any of the tracepoint's
2996 locations, assume it is a direct hit rather than a while-stepping
2997 frame. (FIXME this is not reliable, should record each frame's
2999 for (tloc = t->base.loc; tloc; tloc = tloc->next)
3000 if (tloc->address == regcache_read_pc (regcache))
3002 *stepping_frame_p = 0;
3006 /* If this is a stepping frame, we don't know which location
3007 triggered. The first is as good (or bad) a guess as any... */
3008 *stepping_frame_p = 1;
3012 /* Return all the actions, including default collect, of a tracepoint
3013 T. It constructs cleanups into the chain, and leaves the caller to
3014 handle them (call do_cleanups). */
3016 static struct command_line *
3017 all_tracepoint_actions_and_cleanup (struct breakpoint *t)
3019 struct command_line *actions;
3021 actions = breakpoint_commands (t);
3023 /* If there are default expressions to collect, make up a collect
3024 action and prepend to the action list to encode. Note that since
3025 validation is per-tracepoint (local var "xyz" might be valid for
3026 one tracepoint and not another, etc), we make up the action on
3027 the fly, and don't cache it. */
3028 if (*default_collect)
3030 struct command_line *default_collect_action;
3031 char *default_collect_line;
3033 default_collect_line = xstrprintf ("collect %s", default_collect);
3034 make_cleanup (xfree, default_collect_line);
3036 validate_actionline (default_collect_line, t);
3037 default_collect_action = XNEW (struct command_line);
3038 make_cleanup (xfree, default_collect_action);
3039 default_collect_action->next = actions;
3040 default_collect_action->line = default_collect_line;
3041 actions = default_collect_action;
3047 /* The tdump command. */
3050 trace_dump_command (char *args, int from_tty)
3052 int stepping_frame = 0;
3053 struct bp_location *loc;
3054 struct cleanup *old_chain;
3055 struct command_line *actions;
3057 /* This throws an error is not inspecting a trace frame. */
3058 loc = get_traceframe_location (&stepping_frame);
3060 printf_filtered ("Data collected at tracepoint %d, trace frame %d:\n",
3061 tracepoint_number, traceframe_number);
3063 old_chain = make_cleanup (null_cleanup, NULL);
3065 /* This command only makes sense for the current frame, not the
3067 make_cleanup_restore_current_thread ();
3068 select_frame (get_current_frame ());
3070 actions = all_tracepoint_actions_and_cleanup (loc->owner);
3072 trace_dump_actions (actions, 0, stepping_frame, from_tty);
3074 do_cleanups (old_chain);
3077 /* Encode a piece of a tracepoint's source-level definition in a form
3078 that is suitable for both protocol and saving in files. */
3079 /* This version does not do multiple encodes for long strings; it should
3080 return an offset to the next piece to encode. FIXME */
3083 encode_source_string (int tpnum, ULONGEST addr,
3084 char *srctype, const char *src, char *buf, int buf_size)
3086 if (80 + strlen (srctype) > buf_size)
3087 error (_("Buffer too small for source encoding"));
3088 sprintf (buf, "%x:%s:%s:%x:%x:",
3089 tpnum, phex_nz (addr, sizeof (addr)),
3090 srctype, 0, (int) strlen (src));
3091 if (strlen (buf) + strlen (src) * 2 >= buf_size)
3092 error (_("Source string too long for buffer"));
3093 bin2hex ((gdb_byte *) src, buf + strlen (buf), strlen (src));
3097 /* Tell the target what to do with an ongoing tracing run if GDB
3098 disconnects for some reason. */
3101 set_disconnected_tracing (char *args, int from_tty,
3102 struct cmd_list_element *c)
3104 target_set_disconnected_tracing (disconnected_tracing);
3108 set_circular_trace_buffer (char *args, int from_tty,
3109 struct cmd_list_element *c)
3111 target_set_circular_trace_buffer (circular_trace_buffer);
3115 set_trace_buffer_size (char *args, int from_tty,
3116 struct cmd_list_element *c)
3118 target_set_trace_buffer_size (trace_buffer_size);
3122 set_trace_user (char *args, int from_tty,
3123 struct cmd_list_element *c)
3127 ret = target_set_trace_notes (trace_user, NULL, NULL);
3130 warning (_("Target does not support trace notes, user ignored"));
3134 set_trace_notes (char *args, int from_tty,
3135 struct cmd_list_element *c)
3139 ret = target_set_trace_notes (NULL, trace_notes, NULL);
3142 warning (_("Target does not support trace notes, note ignored"));
3146 set_trace_stop_notes (char *args, int from_tty,
3147 struct cmd_list_element *c)
3151 ret = target_set_trace_notes (NULL, NULL, trace_stop_notes);
3154 warning (_("Target does not support trace notes, stop note ignored"));
3157 /* Convert the memory pointed to by mem into hex, placing result in buf.
3158 * Return a pointer to the last char put in buf (null)
3159 * "stolen" from sparc-stub.c
3162 static const char hexchars[] = "0123456789abcdef";
3165 mem2hex (gdb_byte *mem, char *buf, int count)
3173 *buf++ = hexchars[ch >> 4];
3174 *buf++ = hexchars[ch & 0xf];
3183 get_traceframe_number (void)
3185 return traceframe_number;
3189 get_tracepoint_number (void)
3191 return tracepoint_number;
3194 /* Make the traceframe NUM be the current trace frame. Does nothing
3195 if NUM is already current. */
3198 set_current_traceframe (int num)
3202 if (traceframe_number == num)
3204 /* Nothing to do. */
3208 newnum = target_trace_find (tfind_number, num, 0, 0, NULL);
3211 warning (_("could not change traceframe"));
3213 set_traceframe_num (newnum);
3215 /* Changing the traceframe changes our view of registers and of the
3217 registers_changed ();
3219 clear_traceframe_info ();
3222 /* A cleanup used when switching away and back from tfind mode. */
3224 struct current_traceframe_cleanup
3226 /* The traceframe we were inspecting. */
3227 int traceframe_number;
3231 do_restore_current_traceframe_cleanup (void *arg)
3233 struct current_traceframe_cleanup *old
3234 = (struct current_traceframe_cleanup *) arg;
3236 set_current_traceframe (old->traceframe_number);
3240 restore_current_traceframe_cleanup_dtor (void *arg)
3242 struct current_traceframe_cleanup *old
3243 = (struct current_traceframe_cleanup *) arg;
3249 make_cleanup_restore_current_traceframe (void)
3251 struct current_traceframe_cleanup *old =
3252 XNEW (struct current_traceframe_cleanup);
3254 old->traceframe_number = traceframe_number;
3256 return make_cleanup_dtor (do_restore_current_traceframe_cleanup, old,
3257 restore_current_traceframe_cleanup_dtor);
3260 /* Given a number and address, return an uploaded tracepoint with that
3261 number, creating if necessary. */
3263 struct uploaded_tp *
3264 get_uploaded_tp (int num, ULONGEST addr, struct uploaded_tp **utpp)
3266 struct uploaded_tp *utp;
3268 for (utp = *utpp; utp; utp = utp->next)
3269 if (utp->number == num && utp->addr == addr)
3272 utp = XCNEW (struct uploaded_tp);
3275 utp->actions = NULL;
3276 utp->step_actions = NULL;
3277 utp->cmd_strings = NULL;
3285 free_uploaded_tps (struct uploaded_tp **utpp)
3287 struct uploaded_tp *next_one;
3291 next_one = (*utpp)->next;
3297 /* Given a number and address, return an uploaded tracepoint with that
3298 number, creating if necessary. */
3300 struct uploaded_tsv *
3301 get_uploaded_tsv (int num, struct uploaded_tsv **utsvp)
3303 struct uploaded_tsv *utsv;
3305 for (utsv = *utsvp; utsv; utsv = utsv->next)
3306 if (utsv->number == num)
3309 utsv = XCNEW (struct uploaded_tsv);
3311 utsv->next = *utsvp;
3318 free_uploaded_tsvs (struct uploaded_tsv **utsvp)
3320 struct uploaded_tsv *next_one;
3324 next_one = (*utsvp)->next;
3330 /* FIXME this function is heuristic and will miss the cases where the
3331 conditional is semantically identical but differs in whitespace,
3332 such as "x == 0" vs "x==0". */
3335 cond_string_is_same (char *str1, char *str2)
3337 if (str1 == NULL || str2 == NULL)
3338 return (str1 == str2);
3340 return (strcmp (str1, str2) == 0);
3343 /* Look for an existing tracepoint that seems similar enough to the
3344 uploaded one. Enablement isn't compared, because the user can
3345 toggle that freely, and may have done so in anticipation of the
3346 next trace run. Return the location of matched tracepoint. */
3348 static struct bp_location *
3349 find_matching_tracepoint_location (struct uploaded_tp *utp)
3351 VEC(breakpoint_p) *tp_vec = all_tracepoints ();
3353 struct breakpoint *b;
3354 struct bp_location *loc;
3356 for (ix = 0; VEC_iterate (breakpoint_p, tp_vec, ix, b); ix++)
3358 struct tracepoint *t = (struct tracepoint *) b;
3360 if (b->type == utp->type
3361 && t->step_count == utp->step
3362 && t->pass_count == utp->pass
3363 && cond_string_is_same (t->base.cond_string, utp->cond_string)
3364 /* FIXME also test actions. */
3367 /* Scan the locations for an address match. */
3368 for (loc = b->loc; loc; loc = loc->next)
3370 if (loc->address == utp->addr)
3378 /* Given a list of tracepoints uploaded from a target, attempt to
3379 match them up with existing tracepoints, and create new ones if not
3383 merge_uploaded_tracepoints (struct uploaded_tp **uploaded_tps)
3385 struct uploaded_tp *utp;
3386 /* A set of tracepoints which are modified. */
3387 VEC(breakpoint_p) *modified_tp = NULL;
3389 struct breakpoint *b;
3391 /* Look for GDB tracepoints that match up with our uploaded versions. */
3392 for (utp = *uploaded_tps; utp; utp = utp->next)
3394 struct bp_location *loc;
3395 struct tracepoint *t;
3397 loc = find_matching_tracepoint_location (utp);
3402 /* Mark this location as already inserted. */
3404 t = (struct tracepoint *) loc->owner;
3405 printf_filtered (_("Assuming tracepoint %d is same "
3406 "as target's tracepoint %d at %s.\n"),
3407 loc->owner->number, utp->number,
3408 paddress (loc->gdbarch, utp->addr));
3410 /* The tracepoint LOC->owner was modified (the location LOC
3411 was marked as inserted in the target). Save it in
3412 MODIFIED_TP if not there yet. The 'breakpoint-modified'
3413 observers will be notified later once for each tracepoint
3414 saved in MODIFIED_TP. */
3416 VEC_iterate (breakpoint_p, modified_tp, ix, b);
3418 if (b == loc->owner)
3424 VEC_safe_push (breakpoint_p, modified_tp, loc->owner);
3428 t = create_tracepoint_from_upload (utp);
3430 printf_filtered (_("Created tracepoint %d for "
3431 "target's tracepoint %d at %s.\n"),
3432 t->base.number, utp->number,
3433 paddress (get_current_arch (), utp->addr));
3435 printf_filtered (_("Failed to create tracepoint for target's "
3436 "tracepoint %d at %s, skipping it.\n"),
3438 paddress (get_current_arch (), utp->addr));
3440 /* Whether found or created, record the number used by the
3441 target, to help with mapping target tracepoints back to their
3442 counterparts here. */
3444 t->number_on_target = utp->number;
3447 /* Notify 'breakpoint-modified' observer that at least one of B's
3448 locations was changed. */
3449 for (ix = 0; VEC_iterate (breakpoint_p, modified_tp, ix, b); ix++)
3450 observer_notify_breakpoint_modified (b);
3452 VEC_free (breakpoint_p, modified_tp);
3453 free_uploaded_tps (uploaded_tps);
3456 /* Trace state variables don't have much to identify them beyond their
3457 name, so just use that to detect matches. */
3459 static struct trace_state_variable *
3460 find_matching_tsv (struct uploaded_tsv *utsv)
3465 return find_trace_state_variable (utsv->name);
3468 static struct trace_state_variable *
3469 create_tsv_from_upload (struct uploaded_tsv *utsv)
3471 const char *namebase;
3474 struct trace_state_variable *tsv;
3475 struct cleanup *old_chain;
3479 namebase = utsv->name;
3480 buf = xstrprintf ("%s", namebase);
3485 buf = xstrprintf ("%s_%d", namebase, try_num++);
3488 /* Fish for a name that is not in use. */
3489 /* (should check against all internal vars?) */
3490 while (find_trace_state_variable (buf))
3493 buf = xstrprintf ("%s_%d", namebase, try_num++);
3496 old_chain = make_cleanup (xfree, buf);
3498 /* We have an available name, create the variable. */
3499 tsv = create_trace_state_variable (buf);
3500 tsv->initial_value = utsv->initial_value;
3501 tsv->builtin = utsv->builtin;
3503 observer_notify_tsv_created (tsv);
3505 do_cleanups (old_chain);
3510 /* Given a list of uploaded trace state variables, try to match them
3511 up with existing variables, or create additional ones. */
3514 merge_uploaded_trace_state_variables (struct uploaded_tsv **uploaded_tsvs)
3517 struct uploaded_tsv *utsv;
3518 struct trace_state_variable *tsv;
3521 /* Most likely some numbers will have to be reassigned as part of
3522 the merge, so clear them all in anticipation. */
3523 for (ix = 0; VEC_iterate (tsv_s, tvariables, ix, tsv); ++ix)
3526 for (utsv = *uploaded_tsvs; utsv; utsv = utsv->next)
3528 tsv = find_matching_tsv (utsv);
3532 printf_filtered (_("Assuming trace state variable $%s "
3533 "is same as target's variable %d.\n"),
3534 tsv->name, utsv->number);
3538 tsv = create_tsv_from_upload (utsv);
3540 printf_filtered (_("Created trace state variable "
3541 "$%s for target's variable %d.\n"),
3542 tsv->name, utsv->number);
3544 /* Give precedence to numberings that come from the target. */
3546 tsv->number = utsv->number;
3549 /* Renumber everything that didn't get a target-assigned number. */
3551 for (ix = 0; VEC_iterate (tsv_s, tvariables, ix, tsv); ++ix)
3552 if (tsv->number > highest)
3553 highest = tsv->number;
3556 for (ix = 0; VEC_iterate (tsv_s, tvariables, ix, tsv); ++ix)
3557 if (tsv->number == 0)
3558 tsv->number = highest++;
3560 free_uploaded_tsvs (uploaded_tsvs);
3563 /* Parse the part of trace status syntax that is shared between
3564 the remote protocol and the trace file reader. */
3567 parse_trace_status (char *line, struct trace_status *ts)
3569 char *p = line, *p1, *p2, *p3, *p_temp;
3573 ts->running_known = 1;
3574 ts->running = (*p++ == '1');
3575 ts->stop_reason = trace_stop_reason_unknown;
3576 xfree (ts->stop_desc);
3577 ts->stop_desc = NULL;
3578 ts->traceframe_count = -1;
3579 ts->traceframes_created = -1;
3580 ts->buffer_free = -1;
3581 ts->buffer_size = -1;
3582 ts->disconnected_tracing = 0;
3583 ts->circular_buffer = 0;
3584 xfree (ts->user_name);
3585 ts->user_name = NULL;
3588 ts->start_time = ts->stop_time = 0;
3592 p1 = strchr (p, ':');
3594 error (_("Malformed trace status, at %s\n\
3595 Status line: '%s'\n"), p, line);
3596 p3 = strchr (p, ';');
3598 p3 = p + strlen (p);
3599 if (strncmp (p, stop_reason_names[trace_buffer_full], p1 - p) == 0)
3601 p = unpack_varlen_hex (++p1, &val);
3602 ts->stop_reason = trace_buffer_full;
3604 else if (strncmp (p, stop_reason_names[trace_never_run], p1 - p) == 0)
3606 p = unpack_varlen_hex (++p1, &val);
3607 ts->stop_reason = trace_never_run;
3609 else if (strncmp (p, stop_reason_names[tracepoint_passcount],
3612 p = unpack_varlen_hex (++p1, &val);
3613 ts->stop_reason = tracepoint_passcount;
3614 ts->stopping_tracepoint = val;
3616 else if (strncmp (p, stop_reason_names[tstop_command], p1 - p) == 0)
3618 p2 = strchr (++p1, ':');
3626 ts->stop_desc = (char *) xmalloc (strlen (line));
3627 end = hex2bin (p1, (gdb_byte *) ts->stop_desc, (p2 - p1) / 2);
3628 ts->stop_desc[end] = '\0';
3631 ts->stop_desc = xstrdup ("");
3633 p = unpack_varlen_hex (++p2, &val);
3634 ts->stop_reason = tstop_command;
3636 else if (strncmp (p, stop_reason_names[trace_disconnected], p1 - p) == 0)
3638 p = unpack_varlen_hex (++p1, &val);
3639 ts->stop_reason = trace_disconnected;
3641 else if (strncmp (p, stop_reason_names[tracepoint_error], p1 - p) == 0)
3643 p2 = strchr (++p1, ':');
3646 ts->stop_desc = (char *) xmalloc ((p2 - p1) / 2 + 1);
3647 end = hex2bin (p1, (gdb_byte *) ts->stop_desc, (p2 - p1) / 2);
3648 ts->stop_desc[end] = '\0';
3651 ts->stop_desc = xstrdup ("");
3653 p = unpack_varlen_hex (++p2, &val);
3654 ts->stopping_tracepoint = val;
3655 ts->stop_reason = tracepoint_error;
3657 else if (strncmp (p, "tframes", p1 - p) == 0)
3659 p = unpack_varlen_hex (++p1, &val);
3660 ts->traceframe_count = val;
3662 else if (strncmp (p, "tcreated", p1 - p) == 0)
3664 p = unpack_varlen_hex (++p1, &val);
3665 ts->traceframes_created = val;
3667 else if (strncmp (p, "tfree", p1 - p) == 0)
3669 p = unpack_varlen_hex (++p1, &val);
3670 ts->buffer_free = val;
3672 else if (strncmp (p, "tsize", p1 - p) == 0)
3674 p = unpack_varlen_hex (++p1, &val);
3675 ts->buffer_size = val;
3677 else if (strncmp (p, "disconn", p1 - p) == 0)
3679 p = unpack_varlen_hex (++p1, &val);
3680 ts->disconnected_tracing = val;
3682 else if (strncmp (p, "circular", p1 - p) == 0)
3684 p = unpack_varlen_hex (++p1, &val);
3685 ts->circular_buffer = val;
3687 else if (strncmp (p, "starttime", p1 - p) == 0)
3689 p = unpack_varlen_hex (++p1, &val);
3690 ts->start_time = val;
3692 else if (strncmp (p, "stoptime", p1 - p) == 0)
3694 p = unpack_varlen_hex (++p1, &val);
3695 ts->stop_time = val;
3697 else if (strncmp (p, "username", p1 - p) == 0)
3700 ts->user_name = (char *) xmalloc (strlen (p) / 2);
3701 end = hex2bin (p1, (gdb_byte *) ts->user_name, (p3 - p1) / 2);
3702 ts->user_name[end] = '\0';
3705 else if (strncmp (p, "notes", p1 - p) == 0)
3708 ts->notes = (char *) xmalloc (strlen (p) / 2);
3709 end = hex2bin (p1, (gdb_byte *) ts->notes, (p3 - p1) / 2);
3710 ts->notes[end] = '\0';
3715 /* Silently skip unknown optional info. */
3716 p_temp = strchr (p1 + 1, ';');
3720 /* Must be at the end. */
3727 parse_tracepoint_status (char *p, struct breakpoint *bp,
3728 struct uploaded_tp *utp)
3731 struct tracepoint *tp = (struct tracepoint *) bp;
3733 p = unpack_varlen_hex (p, &uval);
3735 tp->base.hit_count += uval;
3737 utp->hit_count += uval;
3738 p = unpack_varlen_hex (p + 1, &uval);
3740 tp->traceframe_usage += uval;
3742 utp->traceframe_usage += uval;
3743 /* Ignore any extra, allowing for future extensions. */
3746 /* Given a line of text defining a part of a tracepoint, parse it into
3747 an "uploaded tracepoint". */
3750 parse_tracepoint_definition (char *line, struct uploaded_tp **utpp)
3754 ULONGEST num, addr, step, pass, orig_size, xlen, start;
3757 char *cond, *srctype, *buf;
3758 struct uploaded_tp *utp = NULL;
3761 /* Both tracepoint and action definitions start with the same number
3762 and address sequence. */
3764 p = unpack_varlen_hex (p, &num);
3765 p++; /* skip a colon */
3766 p = unpack_varlen_hex (p, &addr);
3767 p++; /* skip a colon */
3770 enabled = (*p++ == 'E');
3771 p++; /* skip a colon */
3772 p = unpack_varlen_hex (p, &step);
3773 p++; /* skip a colon */
3774 p = unpack_varlen_hex (p, &pass);
3775 type = bp_tracepoint;
3777 /* Thumb through optional fields. */
3780 p++; /* skip a colon */
3783 type = bp_fast_tracepoint;
3785 p = unpack_varlen_hex (p, &orig_size);
3789 type = bp_static_tracepoint;
3795 p = unpack_varlen_hex (p, &xlen);
3796 p++; /* skip a comma */
3797 cond = (char *) xmalloc (2 * xlen + 1);
3798 strncpy (cond, p, 2 * xlen);
3799 cond[2 * xlen] = '\0';
3803 warning (_("Unrecognized char '%c' in tracepoint "
3804 "definition, skipping rest"), *p);
3806 utp = get_uploaded_tp (num, addr, utpp);
3808 utp->enabled = enabled;
3813 else if (piece == 'A')
3815 utp = get_uploaded_tp (num, addr, utpp);
3816 VEC_safe_push (char_ptr, utp->actions, xstrdup (p));
3818 else if (piece == 'S')
3820 utp = get_uploaded_tp (num, addr, utpp);
3821 VEC_safe_push (char_ptr, utp->step_actions, xstrdup (p));
3823 else if (piece == 'Z')
3825 /* Parse a chunk of source form definition. */
3826 utp = get_uploaded_tp (num, addr, utpp);
3828 p = strchr (p, ':');
3829 p++; /* skip a colon */
3830 p = unpack_varlen_hex (p, &start);
3831 p++; /* skip a colon */
3832 p = unpack_varlen_hex (p, &xlen);
3833 p++; /* skip a colon */
3835 buf = (char *) alloca (strlen (line));
3837 end = hex2bin (p, (gdb_byte *) buf, strlen (p) / 2);
3840 if (startswith (srctype, "at:"))
3841 utp->at_string = xstrdup (buf);
3842 else if (startswith (srctype, "cond:"))
3843 utp->cond_string = xstrdup (buf);
3844 else if (startswith (srctype, "cmd:"))
3845 VEC_safe_push (char_ptr, utp->cmd_strings, xstrdup (buf));
3847 else if (piece == 'V')
3849 utp = get_uploaded_tp (num, addr, utpp);
3851 parse_tracepoint_status (p, NULL, utp);
3855 /* Don't error out, the target might be sending us optional
3856 info that we don't care about. */
3857 warning (_("Unrecognized tracepoint piece '%c', ignoring"), piece);
3861 /* Convert a textual description of a trace state variable into an
3865 parse_tsv_definition (char *line, struct uploaded_tsv **utsvp)
3868 ULONGEST num, initval, builtin;
3870 struct uploaded_tsv *utsv = NULL;
3872 buf = (char *) alloca (strlen (line));
3875 p = unpack_varlen_hex (p, &num);
3876 p++; /* skip a colon */
3877 p = unpack_varlen_hex (p, &initval);
3878 p++; /* skip a colon */
3879 p = unpack_varlen_hex (p, &builtin);
3880 p++; /* skip a colon */
3881 end = hex2bin (p, (gdb_byte *) buf, strlen (p) / 2);
3884 utsv = get_uploaded_tsv (num, utsvp);
3885 utsv->initial_value = initval;
3886 utsv->builtin = builtin;
3887 utsv->name = xstrdup (buf);
3891 free_current_marker (void *arg)
3893 struct static_tracepoint_marker **marker_p
3894 = (struct static_tracepoint_marker **) arg;
3896 if (*marker_p != NULL)
3898 release_static_tracepoint_marker (*marker_p);
3905 /* Given a line of text defining a static tracepoint marker, parse it
3906 into a "static tracepoint marker" object. Throws an error is
3907 parsing fails. If PP is non-null, it points to one past the end of
3908 the parsed marker definition. */
3911 parse_static_tracepoint_marker_definition (char *line, char **pp,
3912 struct static_tracepoint_marker *marker)
3919 p = unpack_varlen_hex (p, &addr);
3920 p++; /* skip a colon */
3922 marker->gdbarch = target_gdbarch ();
3923 marker->address = (CORE_ADDR) addr;
3925 endp = strchr (p, ':');
3927 error (_("bad marker definition: %s"), line);
3929 marker->str_id = (char *) xmalloc (endp - p + 1);
3930 end = hex2bin (p, (gdb_byte *) marker->str_id, (endp - p + 1) / 2);
3931 marker->str_id[end] = '\0';
3934 p++; /* skip a colon */
3936 marker->extra = (char *) xmalloc (strlen (p) + 1);
3937 end = hex2bin (p, (gdb_byte *) marker->extra, strlen (p) / 2);
3938 marker->extra[end] = '\0';
3944 /* Release a static tracepoint marker's contents. Note that the
3945 object itself isn't released here. There objects are usually on
3949 release_static_tracepoint_marker (struct static_tracepoint_marker *marker)
3951 xfree (marker->str_id);
3952 marker->str_id = NULL;
3955 /* Print MARKER to gdb_stdout. */
3958 print_one_static_tracepoint_marker (int count,
3959 struct static_tracepoint_marker *marker)
3963 char wrap_indent[80];
3964 char extra_field_indent[80];
3965 struct ui_out *uiout = current_uiout;
3966 struct cleanup *bkpt_chain;
3967 VEC(breakpoint_p) *tracepoints;
3969 struct symtab_and_line sal;
3973 sal.pc = marker->address;
3975 tracepoints = static_tracepoints_here (marker->address);
3977 bkpt_chain = make_cleanup_ui_out_tuple_begin_end (uiout, "marker");
3979 /* A counter field to help readability. This is not a stable
3981 ui_out_field_int (uiout, "count", count);
3983 ui_out_field_string (uiout, "marker-id", marker->str_id);
3985 ui_out_field_fmt (uiout, "enabled", "%c",
3986 !VEC_empty (breakpoint_p, tracepoints) ? 'y' : 'n');
3987 ui_out_spaces (uiout, 2);
3989 strcpy (wrap_indent, " ");
3991 if (gdbarch_addr_bit (marker->gdbarch) <= 32)
3992 strcat (wrap_indent, " ");
3994 strcat (wrap_indent, " ");
3996 strcpy (extra_field_indent, " ");
3998 ui_out_field_core_addr (uiout, "addr", marker->gdbarch, marker->address);
4000 sal = find_pc_line (marker->address, 0);
4001 sym = find_pc_sect_function (marker->address, NULL);
4004 ui_out_text (uiout, "in ");
4005 ui_out_field_string (uiout, "func",
4006 SYMBOL_PRINT_NAME (sym));
4007 ui_out_wrap_hint (uiout, wrap_indent);
4008 ui_out_text (uiout, " at ");
4011 ui_out_field_skip (uiout, "func");
4013 if (sal.symtab != NULL)
4015 ui_out_field_string (uiout, "file",
4016 symtab_to_filename_for_display (sal.symtab));
4017 ui_out_text (uiout, ":");
4019 if (ui_out_is_mi_like_p (uiout))
4021 const char *fullname = symtab_to_fullname (sal.symtab);
4023 ui_out_field_string (uiout, "fullname", fullname);
4026 ui_out_field_skip (uiout, "fullname");
4028 ui_out_field_int (uiout, "line", sal.line);
4032 ui_out_field_skip (uiout, "fullname");
4033 ui_out_field_skip (uiout, "line");
4036 ui_out_text (uiout, "\n");
4037 ui_out_text (uiout, extra_field_indent);
4038 ui_out_text (uiout, _("Data: \""));
4039 ui_out_field_string (uiout, "extra-data", marker->extra);
4040 ui_out_text (uiout, "\"\n");
4042 if (!VEC_empty (breakpoint_p, tracepoints))
4044 struct cleanup *cleanup_chain;
4046 struct breakpoint *b;
4048 cleanup_chain = make_cleanup_ui_out_tuple_begin_end (uiout,
4051 ui_out_text (uiout, extra_field_indent);
4052 ui_out_text (uiout, _("Probed by static tracepoints: "));
4053 for (ix = 0; VEC_iterate(breakpoint_p, tracepoints, ix, b); ix++)
4056 ui_out_text (uiout, ", ");
4057 ui_out_text (uiout, "#");
4058 ui_out_field_int (uiout, "tracepoint-id", b->number);
4061 do_cleanups (cleanup_chain);
4063 if (ui_out_is_mi_like_p (uiout))
4064 ui_out_field_int (uiout, "number-of-tracepoints",
4065 VEC_length(breakpoint_p, tracepoints));
4067 ui_out_text (uiout, "\n");
4069 VEC_free (breakpoint_p, tracepoints);
4071 do_cleanups (bkpt_chain);
4075 info_static_tracepoint_markers_command (char *arg, int from_tty)
4077 VEC(static_tracepoint_marker_p) *markers;
4078 struct cleanup *old_chain;
4079 struct static_tracepoint_marker *marker;
4080 struct ui_out *uiout = current_uiout;
4083 /* We don't have to check target_can_use_agent and agent's capability on
4084 static tracepoint here, in order to be compatible with older GDBserver.
4085 We don't check USE_AGENT is true or not, because static tracepoints
4086 don't work without in-process agent, so we don't bother users to type
4087 `set agent on' when to use static tracepoint. */
4090 = make_cleanup_ui_out_table_begin_end (uiout, 5, -1,
4091 "StaticTracepointMarkersTable");
4093 ui_out_table_header (uiout, 7, ui_left, "counter", "Cnt");
4095 ui_out_table_header (uiout, 40, ui_left, "marker-id", "ID");
4097 ui_out_table_header (uiout, 3, ui_left, "enabled", "Enb");
4098 if (gdbarch_addr_bit (target_gdbarch ()) <= 32)
4099 ui_out_table_header (uiout, 10, ui_left, "addr", "Address");
4101 ui_out_table_header (uiout, 18, ui_left, "addr", "Address");
4102 ui_out_table_header (uiout, 40, ui_noalign, "what", "What");
4104 ui_out_table_body (uiout);
4106 markers = target_static_tracepoint_markers_by_strid (NULL);
4107 make_cleanup (VEC_cleanup (static_tracepoint_marker_p), &markers);
4110 VEC_iterate (static_tracepoint_marker_p,
4111 markers, i, marker);
4114 print_one_static_tracepoint_marker (i + 1, marker);
4115 release_static_tracepoint_marker (marker);
4118 do_cleanups (old_chain);
4121 /* The $_sdata convenience variable is a bit special. We don't know
4122 for sure type of the value until we actually have a chance to fetch
4123 the data --- the size of the object depends on what has been
4124 collected. We solve this by making $_sdata be an internalvar that
4125 creates a new value on access. */
4127 /* Return a new value with the correct type for the sdata object of
4128 the current trace frame. Return a void value if there's no object
4131 static struct value *
4132 sdata_make_value (struct gdbarch *gdbarch, struct internalvar *var,
4138 /* We need to read the whole object before we know its size. */
4139 size = target_read_alloc (¤t_target,
4140 TARGET_OBJECT_STATIC_TRACE_DATA,
4147 type = init_vector_type (builtin_type (gdbarch)->builtin_true_char,
4149 v = allocate_value (type);
4150 memcpy (value_contents_raw (v), buf, size);
4155 return allocate_value (builtin_type (gdbarch)->builtin_void);
4158 #if !defined(HAVE_LIBEXPAT)
4160 struct traceframe_info *
4161 parse_traceframe_info (const char *tframe_info)
4163 static int have_warned;
4168 warning (_("Can not parse XML trace frame info; XML support "
4169 "was disabled at compile time"));
4175 #else /* HAVE_LIBEXPAT */
4177 #include "xml-support.h"
4179 /* Handle the start of a <memory> element. */
4182 traceframe_info_start_memory (struct gdb_xml_parser *parser,
4183 const struct gdb_xml_element *element,
4184 void *user_data, VEC(gdb_xml_value_s) *attributes)
4186 struct traceframe_info *info = (struct traceframe_info *) user_data;
4187 struct mem_range *r = VEC_safe_push (mem_range_s, info->memory, NULL);
4188 ULONGEST *start_p, *length_p;
4191 = (ULONGEST *) xml_find_attribute (attributes, "start")->value;
4193 = (ULONGEST *) xml_find_attribute (attributes, "length")->value;
4195 r->start = *start_p;
4196 r->length = *length_p;
4199 /* Handle the start of a <tvar> element. */
4202 traceframe_info_start_tvar (struct gdb_xml_parser *parser,
4203 const struct gdb_xml_element *element,
4205 VEC(gdb_xml_value_s) *attributes)
4207 struct traceframe_info *info = (struct traceframe_info *) user_data;
4208 const char *id_attrib
4209 = (const char *) xml_find_attribute (attributes, "id")->value;
4210 int id = gdb_xml_parse_ulongest (parser, id_attrib);
4212 VEC_safe_push (int, info->tvars, id);
4215 /* Discard the constructed trace frame info (if an error occurs). */
4218 free_result (void *p)
4220 struct traceframe_info *result = (struct traceframe_info *) p;
4222 free_traceframe_info (result);
4225 /* The allowed elements and attributes for an XML memory map. */
4227 static const struct gdb_xml_attribute memory_attributes[] = {
4228 { "start", GDB_XML_AF_NONE, gdb_xml_parse_attr_ulongest, NULL },
4229 { "length", GDB_XML_AF_NONE, gdb_xml_parse_attr_ulongest, NULL },
4230 { NULL, GDB_XML_AF_NONE, NULL, NULL }
4233 static const struct gdb_xml_attribute tvar_attributes[] = {
4234 { "id", GDB_XML_AF_NONE, NULL, NULL },
4235 { NULL, GDB_XML_AF_NONE, NULL, NULL }
4238 static const struct gdb_xml_element traceframe_info_children[] = {
4239 { "memory", memory_attributes, NULL,
4240 GDB_XML_EF_REPEATABLE | GDB_XML_EF_OPTIONAL,
4241 traceframe_info_start_memory, NULL },
4242 { "tvar", tvar_attributes, NULL,
4243 GDB_XML_EF_REPEATABLE | GDB_XML_EF_OPTIONAL,
4244 traceframe_info_start_tvar, NULL },
4245 { NULL, NULL, NULL, GDB_XML_EF_NONE, NULL, NULL }
4248 static const struct gdb_xml_element traceframe_info_elements[] = {
4249 { "traceframe-info", NULL, traceframe_info_children, GDB_XML_EF_NONE,
4251 { NULL, NULL, NULL, GDB_XML_EF_NONE, NULL, NULL }
4254 /* Parse a traceframe-info XML document. */
4256 struct traceframe_info *
4257 parse_traceframe_info (const char *tframe_info)
4259 struct traceframe_info *result;
4260 struct cleanup *back_to;
4262 result = XCNEW (struct traceframe_info);
4263 back_to = make_cleanup (free_result, result);
4265 if (gdb_xml_parse_quick (_("trace frame info"),
4266 "traceframe-info.dtd", traceframe_info_elements,
4267 tframe_info, result) == 0)
4269 /* Parsed successfully, keep the result. */
4270 discard_cleanups (back_to);
4275 do_cleanups (back_to);
4279 #endif /* HAVE_LIBEXPAT */
4281 /* Returns the traceframe_info object for the current traceframe.
4282 This is where we avoid re-fetching the object from the target if we
4283 already have it cached. */
4285 struct traceframe_info *
4286 get_traceframe_info (void)
4288 if (traceframe_info == NULL)
4289 traceframe_info = target_traceframe_info ();
4291 return traceframe_info;
4294 /* If the target supports the query, return in RESULT the set of
4295 collected memory in the current traceframe, found within the LEN
4296 bytes range starting at MEMADDR. Returns true if the target
4297 supports the query, otherwise returns false, and RESULT is left
4301 traceframe_available_memory (VEC(mem_range_s) **result,
4302 CORE_ADDR memaddr, ULONGEST len)
4304 struct traceframe_info *info = get_traceframe_info ();
4308 struct mem_range *r;
4313 for (i = 0; VEC_iterate (mem_range_s, info->memory, i, r); i++)
4314 if (mem_ranges_overlap (r->start, r->length, memaddr, len))
4316 ULONGEST lo1, hi1, lo2, hi2;
4317 struct mem_range *nr;
4320 hi1 = memaddr + len;
4323 hi2 = r->start + r->length;
4325 nr = VEC_safe_push (mem_range_s, *result, NULL);
4327 nr->start = max (lo1, lo2);
4328 nr->length = min (hi1, hi2) - nr->start;
4331 normalize_mem_ranges (*result);
4338 /* Implementation of `sdata' variable. */
4340 static const struct internalvar_funcs sdata_funcs =
4347 /* module initialization */
4349 _initialize_tracepoint (void)
4351 struct cmd_list_element *c;
4353 /* Explicitly create without lookup, since that tries to create a
4354 value with a void typed value, and when we get here, gdbarch
4355 isn't initialized yet. At this point, we're quite sure there
4356 isn't another convenience variable of the same name. */
4357 create_internalvar_type_lazy ("_sdata", &sdata_funcs, NULL);
4359 traceframe_number = -1;
4360 tracepoint_number = -1;
4362 add_info ("scope", scope_info,
4363 _("List the variables local to a scope"));
4365 add_cmd ("tracepoints", class_trace, NULL,
4366 _("Tracing of program execution without stopping the program."),
4369 add_com ("tdump", class_trace, trace_dump_command,
4370 _("Print everything collected at the current tracepoint."));
4372 c = add_com ("tvariable", class_trace, trace_variable_command,_("\
4373 Define a trace state variable.\n\
4374 Argument is a $-prefixed name, optionally followed\n\
4375 by '=' and an expression that sets the initial value\n\
4376 at the start of tracing."));
4377 set_cmd_completer (c, expression_completer);
4379 add_cmd ("tvariable", class_trace, delete_trace_variable_command, _("\
4380 Delete one or more trace state variables.\n\
4381 Arguments are the names of the variables to delete.\n\
4382 If no arguments are supplied, delete all variables."), &deletelist);
4383 /* FIXME add a trace variable completer. */
4385 add_info ("tvariables", tvariables_info, _("\
4386 Status of trace state variables and their values.\n\
4389 add_info ("static-tracepoint-markers",
4390 info_static_tracepoint_markers_command, _("\
4391 List target static tracepoints markers.\n\
4394 add_prefix_cmd ("tfind", class_trace, trace_find_command, _("\
4395 Select a trace frame;\n\
4396 No argument means forward by one frame; '-' means backward by one frame."),
4397 &tfindlist, "tfind ", 1, &cmdlist);
4399 add_cmd ("outside", class_trace, trace_find_outside_command, _("\
4400 Select a trace frame whose PC is outside the given range (exclusive).\n\
4401 Usage: tfind outside addr1, addr2"),
4404 add_cmd ("range", class_trace, trace_find_range_command, _("\
4405 Select a trace frame whose PC is in the given range (inclusive).\n\
4406 Usage: tfind range addr1,addr2"),
4409 add_cmd ("line", class_trace, trace_find_line_command, _("\
4410 Select a trace frame by source line.\n\
4411 Argument can be a line number (with optional source file),\n\
4412 a function name, or '*' followed by an address.\n\
4413 Default argument is 'the next source line that was traced'."),
4416 add_cmd ("tracepoint", class_trace, trace_find_tracepoint_command, _("\
4417 Select a trace frame by tracepoint number.\n\
4418 Default is the tracepoint for the current trace frame."),
4421 add_cmd ("pc", class_trace, trace_find_pc_command, _("\
4422 Select a trace frame by PC.\n\
4423 Default is the current PC, or the PC of the current trace frame."),
4426 add_cmd ("end", class_trace, trace_find_end_command, _("\
4427 De-select any trace frame and resume 'live' debugging."),
4430 add_alias_cmd ("none", "end", class_trace, 0, &tfindlist);
4432 add_cmd ("start", class_trace, trace_find_start_command,
4433 _("Select the first trace frame in the trace buffer."),
4436 add_com ("tstatus", class_trace, trace_status_command,
4437 _("Display the status of the current trace data collection."));
4439 add_com ("tstop", class_trace, trace_stop_command, _("\
4440 Stop trace data collection.\n\
4441 Usage: tstop [ <notes> ... ]\n\
4442 Any arguments supplied are recorded with the trace as a stop reason and\n\
4443 reported by tstatus (if the target supports trace notes)."));
4445 add_com ("tstart", class_trace, trace_start_command, _("\
4446 Start trace data collection.\n\
4447 Usage: tstart [ <notes> ... ]\n\
4448 Any arguments supplied are recorded with the trace as a note and\n\
4449 reported by tstatus (if the target supports trace notes)."));
4451 add_com ("end", class_trace, end_actions_pseudocommand, _("\
4452 Ends a list of commands or actions.\n\
4453 Several GDB commands allow you to enter a list of commands or actions.\n\
4454 Entering \"end\" on a line by itself is the normal way to terminate\n\
4456 Note: the \"end\" command cannot be used at the gdb prompt."));
4458 add_com ("while-stepping", class_trace, while_stepping_pseudocommand, _("\
4459 Specify single-stepping behavior at a tracepoint.\n\
4460 Argument is number of instructions to trace in single-step mode\n\
4461 following the tracepoint. This command is normally followed by\n\
4462 one or more \"collect\" commands, to specify what to collect\n\
4463 while single-stepping.\n\n\
4464 Note: this command can only be used in a tracepoint \"actions\" list."));
4466 add_com_alias ("ws", "while-stepping", class_alias, 0);
4467 add_com_alias ("stepping", "while-stepping", class_alias, 0);
4469 add_com ("collect", class_trace, collect_pseudocommand, _("\
4470 Specify one or more data items to be collected at a tracepoint.\n\
4471 Accepts a comma-separated list of (one or more) expressions. GDB will\n\
4472 collect all data (variables, registers) referenced by that expression.\n\
4473 Also accepts the following special arguments:\n\
4474 $regs -- all registers.\n\
4475 $args -- all function arguments.\n\
4476 $locals -- all variables local to the block/function scope.\n\
4477 $_sdata -- static tracepoint data (ignored for non-static tracepoints).\n\
4478 Note: this command can only be used in a tracepoint \"actions\" list."));
4480 add_com ("teval", class_trace, teval_pseudocommand, _("\
4481 Specify one or more expressions to be evaluated at a tracepoint.\n\
4482 Accepts a comma-separated list of (one or more) expressions.\n\
4483 The result of each evaluation will be discarded.\n\
4484 Note: this command can only be used in a tracepoint \"actions\" list."));
4486 add_com ("actions", class_trace, trace_actions_command, _("\
4487 Specify the actions to be taken at a tracepoint.\n\
4488 Tracepoint actions may include collecting of specified data,\n\
4489 single-stepping, or enabling/disabling other tracepoints,\n\
4490 depending on target's capabilities."));
4492 default_collect = xstrdup ("");
4493 add_setshow_string_cmd ("default-collect", class_trace,
4494 &default_collect, _("\
4495 Set the list of expressions to collect by default"), _("\
4496 Show the list of expressions to collect by default"), NULL,
4498 &setlist, &showlist);
4500 add_setshow_boolean_cmd ("disconnected-tracing", no_class,
4501 &disconnected_tracing, _("\
4502 Set whether tracing continues after GDB disconnects."), _("\
4503 Show whether tracing continues after GDB disconnects."), _("\
4504 Use this to continue a tracing run even if GDB disconnects\n\
4505 or detaches from the target. You can reconnect later and look at\n\
4506 trace data collected in the meantime."),
4507 set_disconnected_tracing,
4512 add_setshow_boolean_cmd ("circular-trace-buffer", no_class,
4513 &circular_trace_buffer, _("\
4514 Set target's use of circular trace buffer."), _("\
4515 Show target's use of circular trace buffer."), _("\
4516 Use this to make the trace buffer into a circular buffer,\n\
4517 which will discard traceframes (oldest first) instead of filling\n\
4518 up and stopping the trace run."),
4519 set_circular_trace_buffer,
4524 add_setshow_zuinteger_unlimited_cmd ("trace-buffer-size", no_class,
4525 &trace_buffer_size, _("\
4526 Set requested size of trace buffer."), _("\
4527 Show requested size of trace buffer."), _("\
4528 Use this to choose a size for the trace buffer. Some targets\n\
4529 may have fixed or limited buffer sizes. Specifying \"unlimited\" or -1\n\
4530 disables any attempt to set the buffer size and lets the target choose."),
4531 set_trace_buffer_size, NULL,
4532 &setlist, &showlist);
4534 add_setshow_string_cmd ("trace-user", class_trace,
4536 Set the user name to use for current and future trace runs"), _("\
4537 Show the user name to use for current and future trace runs"), NULL,
4538 set_trace_user, NULL,
4539 &setlist, &showlist);
4541 add_setshow_string_cmd ("trace-notes", class_trace,
4543 Set notes string to use for current and future trace runs"), _("\
4544 Show the notes string to use for current and future trace runs"), NULL,
4545 set_trace_notes, NULL,
4546 &setlist, &showlist);
4548 add_setshow_string_cmd ("trace-stop-notes", class_trace,
4549 &trace_stop_notes, _("\
4550 Set notes string to use for future tstop commands"), _("\
4551 Show the notes string to use for future tstop commands"), NULL,
4552 set_trace_stop_notes, NULL,
4553 &setlist, &showlist);