1 /* Tracing functionality for remote targets in custom GDB protocol
3 Copyright (C) 1997-2013 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"
30 #include "gdb_string.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"
53 #include "exceptions.h"
54 #include "cli/cli-utils.h"
57 /* readline include files */
58 #include "readline/readline.h"
59 #include "readline/history.h"
61 /* readline defines this. */
72 /* Maximum length of an agent aexpression.
73 This accounts for the fact that packets are limited to 400 bytes
74 (which includes everything -- including the checksum), and assumes
75 the worst case of maximum length for each of the pieces of a
78 NOTE: expressions get mem2hex'ed otherwise this would be twice as
79 large. (400 - 31)/2 == 184 */
80 #define MAX_AGENT_EXPR_LEN 184
84 /* A hook used to notify the UI of tracepoint operations. */
86 void (*deprecated_trace_find_hook) (char *arg, int from_tty);
87 void (*deprecated_trace_start_stop_hook) (int start, int from_tty);
89 extern void (*deprecated_readline_begin_hook) (char *, ...);
90 extern char *(*deprecated_readline_hook) (char *);
91 extern void (*deprecated_readline_end_hook) (void);
96 This module defines the following debugger commands:
97 trace : set a tracepoint on a function, line, or address.
98 info trace : list all debugger-defined tracepoints.
99 delete trace : delete one or more tracepoints.
100 enable trace : enable one or more tracepoints.
101 disable trace : disable one or more tracepoints.
102 actions : specify actions to be taken at a tracepoint.
103 passcount : specify a pass count for a tracepoint.
104 tstart : start a trace experiment.
105 tstop : stop a trace experiment.
106 tstatus : query the status of a trace experiment.
107 tfind : find a trace frame in the trace buffer.
108 tdump : print everything collected at the current tracepoint.
109 save-tracepoints : write tracepoint setup into a file.
111 This module defines the following user-visible debugger variables:
112 $trace_frame : sequence number of trace frame currently being debugged.
113 $trace_line : source line of trace frame currently being debugged.
114 $trace_file : source file of trace frame currently being debugged.
115 $tracepoint : tracepoint number of trace frame currently being debugged.
119 /* ======= Important global variables: ======= */
121 /* The list of all trace state variables. We don't retain pointers to
122 any of these for any reason - API is by name or number only - so it
123 works to have a vector of objects. */
125 typedef struct trace_state_variable tsv_s;
128 /* An object describing the contents of a traceframe. */
130 struct traceframe_info
132 /* Collected memory. */
133 VEC(mem_range_s) *memory;
136 static VEC(tsv_s) *tvariables;
138 /* The next integer to assign to a variable. */
140 static int next_tsv_number = 1;
142 /* Number of last traceframe collected. */
143 static int traceframe_number;
145 /* Tracepoint for last traceframe collected. */
146 static int tracepoint_number;
148 /* Symbol for function for last traceframe collected. */
149 static struct symbol *traceframe_fun;
151 /* Symtab and line for last traceframe collected. */
152 static struct symtab_and_line traceframe_sal;
154 /* The traceframe info of the current traceframe. NULL if we haven't
155 yet attempted to fetch it, or if the target does not support
156 fetching this object, or if we're not inspecting a traceframe
158 static struct traceframe_info *traceframe_info;
160 /* Tracing command lists. */
161 static struct cmd_list_element *tfindlist;
163 /* List of expressions to collect by default at each tracepoint hit. */
164 char *default_collect = "";
166 static int disconnected_tracing;
168 /* This variable controls whether we ask the target for a linear or
169 circular trace buffer. */
171 static int circular_trace_buffer;
173 /* This variable is the requested trace buffer size, or -1 to indicate
174 that we don't care and leave it up to the target to set a size. */
176 static int trace_buffer_size = -1;
178 /* Textual notes applying to the current and/or future trace runs. */
180 char *trace_user = NULL;
182 /* Textual notes applying to the current and/or future trace runs. */
184 char *trace_notes = NULL;
186 /* Textual notes applying to the stopping of a trace. */
188 char *trace_stop_notes = NULL;
190 /* ======= Important command functions: ======= */
191 static void trace_actions_command (char *, int);
192 static void trace_start_command (char *, int);
193 static void trace_stop_command (char *, int);
194 static void trace_status_command (char *, int);
195 static void trace_find_command (char *, int);
196 static void trace_find_pc_command (char *, int);
197 static void trace_find_tracepoint_command (char *, int);
198 static void trace_find_line_command (char *, int);
199 static void trace_find_range_command (char *, int);
200 static void trace_find_outside_command (char *, int);
201 static void trace_dump_command (char *, int);
203 /* support routines */
205 struct collection_list;
206 static void add_aexpr (struct collection_list *, struct agent_expr *);
207 static char *mem2hex (gdb_byte *, char *, int);
208 static void add_register (struct collection_list *collection,
211 static void free_uploaded_tps (struct uploaded_tp **utpp);
212 static void free_uploaded_tsvs (struct uploaded_tsv **utsvp);
215 extern void _initialize_tracepoint (void);
217 static struct trace_status trace_status;
219 char *stop_reason_names[] = {
229 struct trace_status *
230 current_trace_status (void)
232 return &trace_status;
238 free_traceframe_info (struct traceframe_info *info)
242 VEC_free (mem_range_s, info->memory);
248 /* Free and clear the traceframe info cache of the current
252 clear_traceframe_info (void)
254 free_traceframe_info (traceframe_info);
255 traceframe_info = NULL;
258 /* Set traceframe number to NUM. */
260 set_traceframe_num (int num)
262 traceframe_number = num;
263 set_internalvar_integer (lookup_internalvar ("trace_frame"), num);
266 /* Set tracepoint number to NUM. */
268 set_tracepoint_num (int num)
270 tracepoint_number = num;
271 set_internalvar_integer (lookup_internalvar ("tracepoint"), num);
274 /* Set externally visible debug variables for querying/printing
275 the traceframe context (line, function, file). */
278 set_traceframe_context (struct frame_info *trace_frame)
282 /* Save as globals for internal use. */
283 if (trace_frame != NULL
284 && get_frame_pc_if_available (trace_frame, &trace_pc))
286 traceframe_sal = find_pc_line (trace_pc, 0);
287 traceframe_fun = find_pc_function (trace_pc);
289 /* Save linenumber as "$trace_line", a debugger variable visible to
291 set_internalvar_integer (lookup_internalvar ("trace_line"),
292 traceframe_sal.line);
296 init_sal (&traceframe_sal);
297 traceframe_fun = NULL;
298 set_internalvar_integer (lookup_internalvar ("trace_line"), -1);
301 /* Save func name as "$trace_func", a debugger variable visible to
303 if (traceframe_fun == NULL
304 || SYMBOL_LINKAGE_NAME (traceframe_fun) == NULL)
305 clear_internalvar (lookup_internalvar ("trace_func"));
307 set_internalvar_string (lookup_internalvar ("trace_func"),
308 SYMBOL_LINKAGE_NAME (traceframe_fun));
310 /* Save file name as "$trace_file", a debugger variable visible to
312 if (traceframe_sal.symtab == NULL)
313 clear_internalvar (lookup_internalvar ("trace_file"));
315 set_internalvar_string (lookup_internalvar ("trace_file"),
316 symtab_to_filename_for_display (traceframe_sal.symtab));
319 /* Create a new trace state variable with the given name. */
321 struct trace_state_variable *
322 create_trace_state_variable (const char *name)
324 struct trace_state_variable tsv;
326 memset (&tsv, 0, sizeof (tsv));
327 tsv.name = xstrdup (name);
328 tsv.number = next_tsv_number++;
329 return VEC_safe_push (tsv_s, tvariables, &tsv);
332 /* Look for a trace state variable of the given name. */
334 struct trace_state_variable *
335 find_trace_state_variable (const char *name)
337 struct trace_state_variable *tsv;
340 for (ix = 0; VEC_iterate (tsv_s, tvariables, ix, tsv); ++ix)
341 if (strcmp (name, tsv->name) == 0)
348 delete_trace_state_variable (const char *name)
350 struct trace_state_variable *tsv;
353 for (ix = 0; VEC_iterate (tsv_s, tvariables, ix, tsv); ++ix)
354 if (strcmp (name, tsv->name) == 0)
356 observer_notify_tsv_deleted (tsv);
358 xfree ((void *)tsv->name);
359 VEC_unordered_remove (tsv_s, tvariables, ix);
364 warning (_("No trace variable named \"$%s\", not deleting"), name);
367 /* Throws an error if NAME is not valid syntax for a trace state
371 validate_trace_state_variable_name (const char *name)
376 error (_("Must supply a non-empty variable name"));
378 /* All digits in the name is reserved for value history
380 for (p = name; isdigit (*p); p++)
383 error (_("$%s is not a valid trace state variable name"), name);
385 for (p = name; isalnum (*p) || *p == '_'; p++)
388 error (_("$%s is not a valid trace state variable name"), name);
391 /* The 'tvariable' command collects a name and optional expression to
392 evaluate into an initial value. */
395 trace_variable_command (char *args, int from_tty)
397 struct cleanup *old_chain;
399 struct trace_state_variable *tsv;
403 error_no_arg (_("Syntax is $NAME [ = EXPR ]"));
405 /* Only allow two syntaxes; "$name" and "$name=value". */
406 p = skip_spaces (args);
409 error (_("Name of trace variable should start with '$'"));
412 while (isalnum (*p) || *p == '_')
414 name = savestring (name, p - name);
415 old_chain = make_cleanup (xfree, name);
418 if (*p != '=' && *p != '\0')
419 error (_("Syntax must be $NAME [ = EXPR ]"));
421 validate_trace_state_variable_name (name);
424 initval = value_as_long (parse_and_eval (++p));
426 /* If the variable already exists, just change its initial value. */
427 tsv = find_trace_state_variable (name);
430 if (tsv->initial_value != initval)
432 tsv->initial_value = initval;
433 observer_notify_tsv_modified (tsv);
435 printf_filtered (_("Trace state variable $%s "
436 "now has initial value %s.\n"),
437 tsv->name, plongest (tsv->initial_value));
438 do_cleanups (old_chain);
442 /* Create a new variable. */
443 tsv = create_trace_state_variable (name);
444 tsv->initial_value = initval;
446 observer_notify_tsv_created (tsv);
448 printf_filtered (_("Trace state variable $%s "
449 "created, with initial value %s.\n"),
450 tsv->name, plongest (tsv->initial_value));
452 do_cleanups (old_chain);
456 delete_trace_variable_command (char *args, int from_tty)
460 struct cleanup *back_to;
464 if (query (_("Delete all trace state variables? ")))
465 VEC_free (tsv_s, tvariables);
467 observer_notify_tsv_deleted (NULL);
471 argv = gdb_buildargv (args);
472 back_to = make_cleanup_freeargv (argv);
474 for (ix = 0; argv[ix] != NULL; ix++)
476 if (*argv[ix] == '$')
477 delete_trace_state_variable (argv[ix] + 1);
479 warning (_("Name \"%s\" not prefixed with '$', ignoring"), argv[ix]);
482 do_cleanups (back_to);
488 tvariables_info_1 (void)
490 struct trace_state_variable *tsv;
493 struct cleanup *back_to;
494 struct ui_out *uiout = current_uiout;
496 if (VEC_length (tsv_s, tvariables) == 0 && !ui_out_is_mi_like_p (uiout))
498 printf_filtered (_("No trace state variables.\n"));
502 /* Try to acquire values from the target. */
503 for (ix = 0; VEC_iterate (tsv_s, tvariables, ix, tsv); ++ix, ++count)
504 tsv->value_known = target_get_trace_state_variable_value (tsv->number,
507 back_to = make_cleanup_ui_out_table_begin_end (uiout, 3,
508 count, "trace-variables");
509 ui_out_table_header (uiout, 15, ui_left, "name", "Name");
510 ui_out_table_header (uiout, 11, ui_left, "initial", "Initial");
511 ui_out_table_header (uiout, 11, ui_left, "current", "Current");
513 ui_out_table_body (uiout);
515 for (ix = 0; VEC_iterate (tsv_s, tvariables, ix, tsv); ++ix)
517 struct cleanup *back_to2;
521 back_to2 = make_cleanup_ui_out_tuple_begin_end (uiout, "variable");
523 name = concat ("$", tsv->name, (char *) NULL);
524 make_cleanup (xfree, name);
525 ui_out_field_string (uiout, "name", name);
526 ui_out_field_string (uiout, "initial", plongest (tsv->initial_value));
528 if (tsv->value_known)
529 c = plongest (tsv->value);
530 else if (ui_out_is_mi_like_p (uiout))
531 /* For MI, we prefer not to use magic string constants, but rather
532 omit the field completely. The difference between unknown and
533 undefined does not seem important enough to represent. */
535 else if (current_trace_status ()->running || traceframe_number >= 0)
536 /* The value is/was defined, but we don't have it. */
539 /* It is not meaningful to ask about the value. */
542 ui_out_field_string (uiout, "current", c);
543 ui_out_text (uiout, "\n");
545 do_cleanups (back_to2);
548 do_cleanups (back_to);
551 /* List all the trace state variables. */
554 tvariables_info (char *args, int from_tty)
556 tvariables_info_1 ();
559 /* Stash definitions of tsvs into the given file. */
562 save_trace_state_variables (struct ui_file *fp)
564 struct trace_state_variable *tsv;
567 for (ix = 0; VEC_iterate (tsv_s, tvariables, ix, tsv); ++ix)
569 fprintf_unfiltered (fp, "tvariable $%s", tsv->name);
570 if (tsv->initial_value)
571 fprintf_unfiltered (fp, " = %s", plongest (tsv->initial_value));
572 fprintf_unfiltered (fp, "\n");
576 /* ACTIONS functions: */
578 /* The three functions:
579 collect_pseudocommand,
580 while_stepping_pseudocommand, and
581 end_actions_pseudocommand
582 are placeholders for "commands" that are actually ONLY to be used
583 within a tracepoint action list. If the actual function is ever called,
584 it means that somebody issued the "command" at the top level,
585 which is always an error. */
588 end_actions_pseudocommand (char *args, int from_tty)
590 error (_("This command cannot be used at the top level."));
594 while_stepping_pseudocommand (char *args, int from_tty)
596 error (_("This command can only be used in a tracepoint actions list."));
600 collect_pseudocommand (char *args, int from_tty)
602 error (_("This command can only be used in a tracepoint actions list."));
606 teval_pseudocommand (char *args, int from_tty)
608 error (_("This command can only be used in a tracepoint actions list."));
611 /* Parse any collection options, such as /s for strings. */
614 decode_agent_options (char *exp)
616 struct value_print_options opts;
621 /* Call this to borrow the print elements default for collection
623 get_user_print_options (&opts);
628 if (target_supports_string_tracing ())
630 /* Allow an optional decimal number giving an explicit maximum
631 string length, defaulting it to the "print elements" value;
632 so "collect/s80 mystr" gets at most 80 bytes of string. */
633 trace_string_kludge = opts.print_max;
635 if (*exp >= '0' && *exp <= '9')
636 trace_string_kludge = atoi (exp);
637 while (*exp >= '0' && *exp <= '9')
641 error (_("Target does not support \"/s\" option for string tracing."));
644 error (_("Undefined collection format \"%c\"."), *exp);
646 exp = skip_spaces (exp);
651 /* Enter a list of actions for a tracepoint. */
653 trace_actions_command (char *args, int from_tty)
655 struct tracepoint *t;
656 struct command_line *l;
658 t = get_tracepoint_by_number (&args, NULL, 1);
662 xstrprintf ("Enter actions for tracepoint %d, one per line.",
664 struct cleanup *cleanups = make_cleanup (xfree, tmpbuf);
666 l = read_command_lines (tmpbuf, from_tty, 1,
667 check_tracepoint_command, t);
668 do_cleanups (cleanups);
669 breakpoint_set_commands (&t->base, l);
671 /* else just return */
674 /* Report the results of checking the agent expression, as errors or
678 report_agent_reqs_errors (struct agent_expr *aexpr)
680 /* All of the "flaws" are serious bytecode generation issues that
681 should never occur. */
682 if (aexpr->flaw != agent_flaw_none)
683 internal_error (__FILE__, __LINE__, _("expression is malformed"));
685 /* If analysis shows a stack underflow, GDB must have done something
686 badly wrong in its bytecode generation. */
687 if (aexpr->min_height < 0)
688 internal_error (__FILE__, __LINE__,
689 _("expression has min height < 0"));
691 /* Issue this error if the stack is predicted to get too deep. The
692 limit is rather arbitrary; a better scheme might be for the
693 target to report how much stack it will have available. The
694 depth roughly corresponds to parenthesization, so a limit of 20
695 amounts to 20 levels of expression nesting, which is actually
696 a pretty big hairy expression. */
697 if (aexpr->max_height > 20)
698 error (_("Expression is too complicated."));
701 /* worker function */
703 validate_actionline (char **line, struct breakpoint *b)
705 struct cmd_list_element *c;
706 struct expression *exp = NULL;
707 struct cleanup *old_chain = NULL;
709 struct bp_location *loc;
710 struct agent_expr *aexpr;
711 struct tracepoint *t = (struct tracepoint *) b;
713 /* If EOF is typed, *line is NULL. */
717 p = skip_spaces (*line);
719 /* Symbol lookup etc. */
720 if (*p == '\0') /* empty line: just prompt for another line. */
723 if (*p == '#') /* comment line */
726 c = lookup_cmd (&p, cmdlist, "", -1, 1);
728 error (_("`%s' is not a tracepoint action, or is ambiguous."), p);
730 if (cmd_cfunc_eq (c, collect_pseudocommand))
732 trace_string_kludge = 0;
734 p = decode_agent_options (p);
737 { /* Repeat over a comma-separated list. */
738 QUIT; /* Allow user to bail out with ^C. */
741 if (*p == '$') /* Look for special pseudo-symbols. */
743 if (0 == strncasecmp ("reg", p + 1, 3)
744 || 0 == strncasecmp ("arg", p + 1, 3)
745 || 0 == strncasecmp ("loc", p + 1, 3)
746 || 0 == strncasecmp ("_ret", p + 1, 4)
747 || 0 == strncasecmp ("_sdata", p + 1, 6))
752 /* else fall thru, treat p as an expression and parse it! */
755 for (loc = t->base.loc; loc; loc = loc->next)
760 exp = parse_exp_1 (&q, loc->address,
761 block_for_pc (loc->address), 1);
763 old_chain = make_cleanup (free_current_contents, &exp);
765 if (exp->elts[0].opcode == OP_VAR_VALUE)
767 if (SYMBOL_CLASS (exp->elts[2].symbol) == LOC_CONST)
769 error (_("constant `%s' (value %s) "
770 "will not be collected."),
771 SYMBOL_PRINT_NAME (exp->elts[2].symbol),
772 plongest (SYMBOL_VALUE (exp->elts[2].symbol)));
774 else if (SYMBOL_CLASS (exp->elts[2].symbol)
775 == LOC_OPTIMIZED_OUT)
777 error (_("`%s' is optimized away "
778 "and cannot be collected."),
779 SYMBOL_PRINT_NAME (exp->elts[2].symbol));
783 /* We have something to collect, make sure that the expr to
784 bytecode translator can handle it and that it's not too
786 aexpr = gen_trace_for_expr (loc->address, exp);
787 make_cleanup_free_agent_expr (aexpr);
789 if (aexpr->len > MAX_AGENT_EXPR_LEN)
790 error (_("Expression is too complicated."));
794 report_agent_reqs_errors (aexpr);
796 do_cleanups (old_chain);
799 while (p && *p++ == ',');
802 else if (cmd_cfunc_eq (c, teval_pseudocommand))
805 { /* Repeat over a comma-separated list. */
806 QUIT; /* Allow user to bail out with ^C. */
810 for (loc = t->base.loc; loc; loc = loc->next)
815 /* Only expressions are allowed for this action. */
816 exp = parse_exp_1 (&q, loc->address,
817 block_for_pc (loc->address), 1);
819 old_chain = make_cleanup (free_current_contents, &exp);
821 /* We have something to evaluate, make sure that the expr to
822 bytecode translator can handle it and that it's not too
824 aexpr = gen_eval_for_expr (loc->address, exp);
825 make_cleanup_free_agent_expr (aexpr);
827 if (aexpr->len > MAX_AGENT_EXPR_LEN)
828 error (_("Expression is too complicated."));
831 report_agent_reqs_errors (aexpr);
833 do_cleanups (old_chain);
836 while (p && *p++ == ',');
839 else if (cmd_cfunc_eq (c, while_stepping_pseudocommand))
841 char *steparg; /* In case warning is necessary. */
846 if (*p == '\0' || (t->step_count = strtol (p, &p, 0)) == 0)
847 error (_("while-stepping step count `%s' is malformed."), *line);
850 else if (cmd_cfunc_eq (c, end_actions_pseudocommand))
854 error (_("`%s' is not a supported tracepoint action."), *line);
858 memrange_absolute = -1
863 int type; /* memrange_absolute for absolute memory range,
864 else basereg number. */
865 bfd_signed_vma start;
869 struct collection_list
871 unsigned char regs_mask[32]; /* room for up to 256 regs */
874 struct memrange *list;
875 long aexpr_listsize; /* size of array pointed to by expr_list elt */
877 struct agent_expr **aexpr_list;
879 /* True is the user requested a collection of "$_sdata", "static
883 tracepoint_list, stepping_list;
885 /* MEMRANGE functions: */
887 static int memrange_cmp (const void *, const void *);
889 /* Compare memranges for qsort. */
891 memrange_cmp (const void *va, const void *vb)
893 const struct memrange *a = va, *b = vb;
895 if (a->type < b->type)
897 if (a->type > b->type)
899 if (a->type == memrange_absolute)
901 if ((bfd_vma) a->start < (bfd_vma) b->start)
903 if ((bfd_vma) a->start > (bfd_vma) b->start)
908 if (a->start < b->start)
910 if (a->start > b->start)
916 /* Sort the memrange list using qsort, and merge adjacent memranges. */
918 memrange_sortmerge (struct collection_list *memranges)
922 qsort (memranges->list, memranges->next_memrange,
923 sizeof (struct memrange), memrange_cmp);
924 if (memranges->next_memrange > 0)
926 for (a = 0, b = 1; b < memranges->next_memrange; b++)
928 /* If memrange b overlaps or is adjacent to memrange a,
930 if (memranges->list[a].type == memranges->list[b].type
931 && memranges->list[b].start <= memranges->list[a].end)
933 if (memranges->list[b].end > memranges->list[a].end)
934 memranges->list[a].end = memranges->list[b].end;
935 continue; /* next b, same a */
939 memcpy (&memranges->list[a], &memranges->list[b],
940 sizeof (struct memrange));
942 memranges->next_memrange = a + 1;
946 /* Add a register to a collection list. */
948 add_register (struct collection_list *collection, unsigned int regno)
951 printf_filtered ("collect register %d\n", regno);
952 if (regno >= (8 * sizeof (collection->regs_mask)))
953 error (_("Internal: register number %d too large for tracepoint"),
955 collection->regs_mask[regno / 8] |= 1 << (regno % 8);
958 /* Add a memrange to a collection list. */
960 add_memrange (struct collection_list *memranges,
961 int type, bfd_signed_vma base,
966 printf_filtered ("(%d,", type);
968 printf_filtered (",%ld)\n", len);
971 /* type: memrange_absolute == memory, other n == basereg */
972 memranges->list[memranges->next_memrange].type = type;
973 /* base: addr if memory, offset if reg relative. */
974 memranges->list[memranges->next_memrange].start = base;
975 /* len: we actually save end (base + len) for convenience */
976 memranges->list[memranges->next_memrange].end = base + len;
977 memranges->next_memrange++;
978 if (memranges->next_memrange >= memranges->listsize)
980 memranges->listsize *= 2;
981 memranges->list = xrealloc (memranges->list,
982 memranges->listsize);
985 if (type != memrange_absolute) /* Better collect the base register! */
986 add_register (memranges, type);
989 /* Add a symbol to a collection list. */
991 collect_symbol (struct collection_list *collect,
993 struct gdbarch *gdbarch,
994 long frame_regno, long frame_offset,
999 bfd_signed_vma offset;
1000 int treat_as_expr = 0;
1002 len = TYPE_LENGTH (check_typedef (SYMBOL_TYPE (sym)));
1003 switch (SYMBOL_CLASS (sym))
1006 printf_filtered ("%s: don't know symbol class %d\n",
1007 SYMBOL_PRINT_NAME (sym),
1008 SYMBOL_CLASS (sym));
1011 printf_filtered ("constant %s (value %s) will not be collected.\n",
1012 SYMBOL_PRINT_NAME (sym), plongest (SYMBOL_VALUE (sym)));
1015 offset = SYMBOL_VALUE_ADDRESS (sym);
1020 sprintf_vma (tmp, offset);
1021 printf_filtered ("LOC_STATIC %s: collect %ld bytes at %s.\n",
1022 SYMBOL_PRINT_NAME (sym), len,
1025 /* A struct may be a C++ class with static fields, go to general
1026 expression handling. */
1027 if (TYPE_CODE (SYMBOL_TYPE (sym)) == TYPE_CODE_STRUCT)
1030 add_memrange (collect, memrange_absolute, offset, len);
1033 reg = SYMBOL_REGISTER_OPS (sym)->register_number (sym, gdbarch);
1035 printf_filtered ("LOC_REG[parm] %s: ",
1036 SYMBOL_PRINT_NAME (sym));
1037 add_register (collect, reg);
1038 /* Check for doubles stored in two registers. */
1039 /* FIXME: how about larger types stored in 3 or more regs? */
1040 if (TYPE_CODE (SYMBOL_TYPE (sym)) == TYPE_CODE_FLT &&
1041 len > register_size (gdbarch, reg))
1042 add_register (collect, reg + 1);
1045 printf_filtered ("Sorry, don't know how to do LOC_REF_ARG yet.\n");
1046 printf_filtered (" (will not collect %s)\n",
1047 SYMBOL_PRINT_NAME (sym));
1051 offset = frame_offset + SYMBOL_VALUE (sym);
1054 printf_filtered ("LOC_LOCAL %s: Collect %ld bytes at offset ",
1055 SYMBOL_PRINT_NAME (sym), len);
1056 printf_vma (offset);
1057 printf_filtered (" from frame ptr reg %d\n", reg);
1059 add_memrange (collect, reg, offset, len);
1061 case LOC_REGPARM_ADDR:
1062 reg = SYMBOL_VALUE (sym);
1066 printf_filtered ("LOC_REGPARM_ADDR %s: Collect %ld bytes at offset ",
1067 SYMBOL_PRINT_NAME (sym), len);
1068 printf_vma (offset);
1069 printf_filtered (" from reg %d\n", reg);
1071 add_memrange (collect, reg, offset, len);
1075 offset = frame_offset + SYMBOL_VALUE (sym);
1078 printf_filtered ("LOC_LOCAL %s: Collect %ld bytes at offset ",
1079 SYMBOL_PRINT_NAME (sym), len);
1080 printf_vma (offset);
1081 printf_filtered (" from frame ptr reg %d\n", reg);
1083 add_memrange (collect, reg, offset, len);
1086 case LOC_UNRESOLVED:
1090 case LOC_OPTIMIZED_OUT:
1091 printf_filtered ("%s has been optimized out of existence.\n",
1092 SYMBOL_PRINT_NAME (sym));
1100 /* Expressions are the most general case. */
1103 struct agent_expr *aexpr;
1104 struct cleanup *old_chain1 = NULL;
1106 aexpr = gen_trace_for_var (scope, gdbarch, sym);
1108 /* It can happen that the symbol is recorded as a computed
1109 location, but it's been optimized away and doesn't actually
1110 have a location expression. */
1113 printf_filtered ("%s has been optimized out of existence.\n",
1114 SYMBOL_PRINT_NAME (sym));
1118 old_chain1 = make_cleanup_free_agent_expr (aexpr);
1122 report_agent_reqs_errors (aexpr);
1124 discard_cleanups (old_chain1);
1125 add_aexpr (collect, aexpr);
1127 /* Take care of the registers. */
1128 if (aexpr->reg_mask_len > 0)
1132 for (ndx1 = 0; ndx1 < aexpr->reg_mask_len; ndx1++)
1134 QUIT; /* Allow user to bail out with ^C. */
1135 if (aexpr->reg_mask[ndx1] != 0)
1137 /* Assume chars have 8 bits. */
1138 for (ndx2 = 0; ndx2 < 8; ndx2++)
1139 if (aexpr->reg_mask[ndx1] & (1 << ndx2))
1140 /* It's used -- record it. */
1141 add_register (collect, ndx1 * 8 + ndx2);
1148 /* Data to be passed around in the calls to the locals and args
1151 struct add_local_symbols_data
1153 struct collection_list *collect;
1154 struct gdbarch *gdbarch;
1161 /* The callback for the locals and args iterators. */
1164 do_collect_symbol (const char *print_name,
1168 struct add_local_symbols_data *p = cb_data;
1170 collect_symbol (p->collect, sym, p->gdbarch, p->frame_regno,
1171 p->frame_offset, p->pc);
1175 /* Add all locals (or args) symbols to collection list. */
1177 add_local_symbols (struct collection_list *collect,
1178 struct gdbarch *gdbarch, CORE_ADDR pc,
1179 long frame_regno, long frame_offset, int type)
1181 struct block *block;
1182 struct add_local_symbols_data cb_data;
1184 cb_data.collect = collect;
1185 cb_data.gdbarch = gdbarch;
1187 cb_data.frame_regno = frame_regno;
1188 cb_data.frame_offset = frame_offset;
1193 block = block_for_pc (pc);
1196 warning (_("Can't collect locals; "
1197 "no symbol table info available.\n"));
1201 iterate_over_block_local_vars (block, do_collect_symbol, &cb_data);
1202 if (cb_data.count == 0)
1203 warning (_("No locals found in scope."));
1207 pc = get_pc_function_start (pc);
1208 block = block_for_pc (pc);
1211 warning (_("Can't collect args; no symbol table info available."));
1215 iterate_over_block_arg_vars (block, do_collect_symbol, &cb_data);
1216 if (cb_data.count == 0)
1217 warning (_("No args found in scope."));
1222 add_static_trace_data (struct collection_list *collection)
1225 printf_filtered ("collect static trace data\n");
1226 collection->strace_data = 1;
1229 /* worker function */
1231 clear_collection_list (struct collection_list *list)
1235 list->next_memrange = 0;
1236 for (ndx = 0; ndx < list->next_aexpr_elt; ndx++)
1238 free_agent_expr (list->aexpr_list[ndx]);
1239 list->aexpr_list[ndx] = NULL;
1241 list->next_aexpr_elt = 0;
1242 memset (list->regs_mask, 0, sizeof (list->regs_mask));
1243 list->strace_data = 0;
1246 /* Reduce a collection list to string form (for gdb protocol). */
1248 stringify_collection_list (struct collection_list *list, char *string)
1250 char temp_buf[2048];
1254 char *(*str_list)[];
1258 count = 1 + 1 + list->next_memrange + list->next_aexpr_elt + 1;
1259 str_list = (char *(*)[]) xmalloc (count * sizeof (char *));
1261 if (list->strace_data)
1264 printf_filtered ("\nCollecting static trace data\n");
1267 (*str_list)[ndx] = savestring (temp_buf, end - temp_buf);
1271 for (i = sizeof (list->regs_mask) - 1; i > 0; i--)
1272 if (list->regs_mask[i] != 0) /* Skip leading zeroes in regs_mask. */
1274 if (list->regs_mask[i] != 0) /* Prepare to send regs_mask to the stub. */
1277 printf_filtered ("\nCollecting registers (mask): 0x");
1282 QUIT; /* Allow user to bail out with ^C. */
1284 printf_filtered ("%02X", list->regs_mask[i]);
1285 sprintf (end, "%02X", list->regs_mask[i]);
1288 (*str_list)[ndx] = xstrdup (temp_buf);
1292 printf_filtered ("\n");
1293 if (list->next_memrange > 0 && info_verbose)
1294 printf_filtered ("Collecting memranges: \n");
1295 for (i = 0, count = 0, end = temp_buf; i < list->next_memrange; i++)
1297 QUIT; /* Allow user to bail out with ^C. */
1298 sprintf_vma (tmp2, list->list[i].start);
1301 printf_filtered ("(%d, %s, %ld)\n",
1304 (long) (list->list[i].end - list->list[i].start));
1306 if (count + 27 > MAX_AGENT_EXPR_LEN)
1308 (*str_list)[ndx] = savestring (temp_buf, count);
1315 bfd_signed_vma length = list->list[i].end - list->list[i].start;
1317 /* The "%X" conversion specifier expects an unsigned argument,
1318 so passing -1 (memrange_absolute) to it directly gives you
1319 "FFFFFFFF" (or more, depending on sizeof (unsigned)).
1321 if (list->list[i].type == memrange_absolute)
1322 sprintf (end, "M-1,%s,%lX", tmp2, (long) length);
1324 sprintf (end, "M%X,%s,%lX", list->list[i].type, tmp2, (long) length);
1327 count += strlen (end);
1328 end = temp_buf + count;
1331 for (i = 0; i < list->next_aexpr_elt; i++)
1333 QUIT; /* Allow user to bail out with ^C. */
1334 if ((count + 10 + 2 * list->aexpr_list[i]->len) > MAX_AGENT_EXPR_LEN)
1336 (*str_list)[ndx] = savestring (temp_buf, count);
1341 sprintf (end, "X%08X,", list->aexpr_list[i]->len);
1342 end += 10; /* 'X' + 8 hex digits + ',' */
1345 end = mem2hex (list->aexpr_list[i]->buf,
1346 end, list->aexpr_list[i]->len);
1347 count += 2 * list->aexpr_list[i]->len;
1352 (*str_list)[ndx] = savestring (temp_buf, count);
1357 (*str_list)[ndx] = NULL;
1370 encode_actions_1 (struct command_line *action,
1371 struct breakpoint *t,
1372 struct bp_location *tloc,
1374 LONGEST frame_offset,
1375 struct collection_list *collect,
1376 struct collection_list *stepping_list)
1379 struct expression *exp = NULL;
1381 struct value *tempval;
1382 struct cmd_list_element *cmd;
1383 struct agent_expr *aexpr;
1385 for (; action; action = action->next)
1387 QUIT; /* Allow user to bail out with ^C. */
1388 action_exp = action->line;
1389 action_exp = skip_spaces (action_exp);
1391 cmd = lookup_cmd (&action_exp, cmdlist, "", -1, 1);
1393 error (_("Bad action list item: %s"), action_exp);
1395 if (cmd_cfunc_eq (cmd, collect_pseudocommand))
1397 trace_string_kludge = 0;
1398 if (*action_exp == '/')
1399 action_exp = decode_agent_options (action_exp);
1402 { /* Repeat over a comma-separated list. */
1403 QUIT; /* Allow user to bail out with ^C. */
1404 action_exp = skip_spaces (action_exp);
1406 if (0 == strncasecmp ("$reg", action_exp, 4))
1408 for (i = 0; i < gdbarch_num_regs (tloc->gdbarch); i++)
1409 add_register (collect, i);
1410 action_exp = strchr (action_exp, ','); /* more? */
1412 else if (0 == strncasecmp ("$arg", action_exp, 4))
1414 add_local_symbols (collect,
1420 action_exp = strchr (action_exp, ','); /* more? */
1422 else if (0 == strncasecmp ("$loc", action_exp, 4))
1424 add_local_symbols (collect,
1430 action_exp = strchr (action_exp, ','); /* more? */
1432 else if (0 == strncasecmp ("$_ret", action_exp, 5))
1434 struct cleanup *old_chain1 = NULL;
1436 aexpr = gen_trace_for_return_address (tloc->address,
1439 old_chain1 = make_cleanup_free_agent_expr (aexpr);
1442 report_agent_reqs_errors (aexpr);
1444 discard_cleanups (old_chain1);
1445 add_aexpr (collect, aexpr);
1447 /* take care of the registers */
1448 if (aexpr->reg_mask_len > 0)
1452 for (ndx1 = 0; ndx1 < aexpr->reg_mask_len; ndx1++)
1454 QUIT; /* allow user to bail out with ^C */
1455 if (aexpr->reg_mask[ndx1] != 0)
1457 /* assume chars have 8 bits */
1458 for (ndx2 = 0; ndx2 < 8; ndx2++)
1459 if (aexpr->reg_mask[ndx1] & (1 << ndx2))
1460 /* it's used -- record it */
1461 add_register (collect,
1467 action_exp = strchr (action_exp, ','); /* more? */
1469 else if (0 == strncasecmp ("$_sdata", action_exp, 7))
1471 add_static_trace_data (collect);
1472 action_exp = strchr (action_exp, ','); /* more? */
1477 struct cleanup *old_chain = NULL;
1478 struct cleanup *old_chain1 = NULL;
1482 exp = parse_exp_1 (&q, tloc->address,
1483 block_for_pc (tloc->address), 1);
1484 action_exp = (char *) q;
1485 old_chain = make_cleanup (free_current_contents, &exp);
1487 switch (exp->elts[0].opcode)
1491 const char *name = &exp->elts[2].string;
1493 i = user_reg_map_name_to_regnum (tloc->gdbarch,
1494 name, strlen (name));
1496 internal_error (__FILE__, __LINE__,
1497 _("Register $%s not available"),
1500 printf_filtered ("OP_REGISTER: ");
1501 add_register (collect, i);
1506 /* Safe because we know it's a simple expression. */
1507 tempval = evaluate_expression (exp);
1508 addr = value_address (tempval);
1509 /* Initialize the TYPE_LENGTH if it is a typedef. */
1510 check_typedef (exp->elts[1].type);
1511 add_memrange (collect, memrange_absolute, addr,
1512 TYPE_LENGTH (exp->elts[1].type));
1516 collect_symbol (collect,
1517 exp->elts[2].symbol,
1524 default: /* Full-fledged expression. */
1525 aexpr = gen_trace_for_expr (tloc->address, exp);
1527 old_chain1 = make_cleanup_free_agent_expr (aexpr);
1531 report_agent_reqs_errors (aexpr);
1533 discard_cleanups (old_chain1);
1534 add_aexpr (collect, aexpr);
1536 /* Take care of the registers. */
1537 if (aexpr->reg_mask_len > 0)
1542 for (ndx1 = 0; ndx1 < aexpr->reg_mask_len; ndx1++)
1544 QUIT; /* Allow user to bail out with ^C. */
1545 if (aexpr->reg_mask[ndx1] != 0)
1547 /* Assume chars have 8 bits. */
1548 for (ndx2 = 0; ndx2 < 8; ndx2++)
1549 if (aexpr->reg_mask[ndx1] & (1 << ndx2))
1550 /* It's used -- record it. */
1551 add_register (collect,
1558 do_cleanups (old_chain);
1561 while (action_exp && *action_exp++ == ',');
1563 else if (cmd_cfunc_eq (cmd, teval_pseudocommand))
1566 { /* Repeat over a comma-separated list. */
1567 QUIT; /* Allow user to bail out with ^C. */
1568 action_exp = skip_spaces (action_exp);
1571 struct cleanup *old_chain = NULL;
1572 struct cleanup *old_chain1 = NULL;
1576 exp = parse_exp_1 (&q, tloc->address,
1577 block_for_pc (tloc->address), 1);
1578 action_exp = (char *) q;
1579 old_chain = make_cleanup (free_current_contents, &exp);
1581 aexpr = gen_eval_for_expr (tloc->address, exp);
1582 old_chain1 = make_cleanup_free_agent_expr (aexpr);
1585 report_agent_reqs_errors (aexpr);
1587 discard_cleanups (old_chain1);
1588 /* Even though we're not officially collecting, add
1589 to the collect list anyway. */
1590 add_aexpr (collect, aexpr);
1592 do_cleanups (old_chain);
1595 while (action_exp && *action_exp++ == ',');
1597 else if (cmd_cfunc_eq (cmd, while_stepping_pseudocommand))
1599 /* We check against nested while-stepping when setting
1600 breakpoint action, so no way to run into nested
1602 gdb_assert (stepping_list);
1604 encode_actions_1 (action->body_list[0], t, tloc, frame_reg,
1605 frame_offset, stepping_list, NULL);
1608 error (_("Invalid tracepoint command '%s'"), action->line);
1612 /* Render all actions into gdb protocol. */
1615 encode_actions (struct breakpoint *t, struct bp_location *tloc,
1616 char ***tdp_actions, char ***stepping_actions)
1618 static char tdp_buff[2048], step_buff[2048];
1619 char *default_collect_line = NULL;
1620 struct command_line *actions;
1621 struct command_line *default_collect_action = NULL;
1623 LONGEST frame_offset;
1624 struct cleanup *back_to;
1626 back_to = make_cleanup (null_cleanup, NULL);
1628 clear_collection_list (&tracepoint_list);
1629 clear_collection_list (&stepping_list);
1631 *tdp_actions = NULL;
1632 *stepping_actions = NULL;
1634 gdbarch_virtual_frame_pointer (tloc->gdbarch,
1635 tloc->address, &frame_reg, &frame_offset);
1637 actions = breakpoint_commands (t);
1639 /* If there are default expressions to collect, make up a collect
1640 action and prepend to the action list to encode. Note that since
1641 validation is per-tracepoint (local var "xyz" might be valid for
1642 one tracepoint and not another, etc), we make up the action on
1643 the fly, and don't cache it. */
1644 if (*default_collect)
1648 default_collect_line = xstrprintf ("collect %s", default_collect);
1649 make_cleanup (xfree, default_collect_line);
1651 line = default_collect_line;
1652 validate_actionline (&line, t);
1654 default_collect_action = xmalloc (sizeof (struct command_line));
1655 make_cleanup (xfree, default_collect_action);
1656 default_collect_action->next = actions;
1657 default_collect_action->line = line;
1658 actions = default_collect_action;
1660 encode_actions_1 (actions, t, tloc, frame_reg, frame_offset,
1661 &tracepoint_list, &stepping_list);
1663 memrange_sortmerge (&tracepoint_list);
1664 memrange_sortmerge (&stepping_list);
1666 *tdp_actions = stringify_collection_list (&tracepoint_list,
1668 *stepping_actions = stringify_collection_list (&stepping_list,
1671 do_cleanups (back_to);
1675 add_aexpr (struct collection_list *collect, struct agent_expr *aexpr)
1677 if (collect->next_aexpr_elt >= collect->aexpr_listsize)
1679 collect->aexpr_list =
1680 xrealloc (collect->aexpr_list,
1681 2 * collect->aexpr_listsize * sizeof (struct agent_expr *));
1682 collect->aexpr_listsize *= 2;
1684 collect->aexpr_list[collect->next_aexpr_elt] = aexpr;
1685 collect->next_aexpr_elt++;
1689 process_tracepoint_on_disconnect (void)
1691 VEC(breakpoint_p) *tp_vec = NULL;
1693 struct breakpoint *b;
1694 int has_pending_p = 0;
1696 /* Check whether we still have pending tracepoint. If we have, warn the
1697 user that pending tracepoint will no longer work. */
1698 tp_vec = all_tracepoints ();
1699 for (ix = 0; VEC_iterate (breakpoint_p, tp_vec, ix, b); ix++)
1708 struct bp_location *loc1;
1710 for (loc1 = b->loc; loc1; loc1 = loc1->next)
1712 if (loc1->shlib_disabled)
1723 VEC_free (breakpoint_p, tp_vec);
1726 warning (_("Pending tracepoints will not be resolved while"
1727 " GDB is disconnected\n"));
1732 start_tracing (char *notes)
1734 VEC(breakpoint_p) *tp_vec = NULL;
1736 struct breakpoint *b;
1737 struct trace_state_variable *tsv;
1738 int any_enabled = 0, num_to_download = 0;
1741 tp_vec = all_tracepoints ();
1743 /* No point in tracing without any tracepoints... */
1744 if (VEC_length (breakpoint_p, tp_vec) == 0)
1746 VEC_free (breakpoint_p, tp_vec);
1747 error (_("No tracepoints defined, not starting trace"));
1750 for (ix = 0; VEC_iterate (breakpoint_p, tp_vec, ix, b); ix++)
1752 struct tracepoint *t = (struct tracepoint *) b;
1753 struct bp_location *loc;
1755 if (b->enable_state == bp_enabled)
1758 if ((b->type == bp_fast_tracepoint
1759 ? may_insert_fast_tracepoints
1760 : may_insert_tracepoints))
1763 warning (_("May not insert %stracepoints, skipping tracepoint %d"),
1764 (b->type == bp_fast_tracepoint ? "fast " : ""), b->number);
1769 if (target_supports_enable_disable_tracepoint ())
1770 warning (_("No tracepoints enabled"));
1773 /* No point in tracing with only disabled tracepoints that
1774 cannot be re-enabled. */
1775 VEC_free (breakpoint_p, tp_vec);
1776 error (_("No tracepoints enabled, not starting trace"));
1780 if (num_to_download <= 0)
1782 VEC_free (breakpoint_p, tp_vec);
1783 error (_("No tracepoints that may be downloaded, not starting trace"));
1786 target_trace_init ();
1788 for (ix = 0; VEC_iterate (breakpoint_p, tp_vec, ix, b); ix++)
1790 struct tracepoint *t = (struct tracepoint *) b;
1791 struct bp_location *loc;
1792 int bp_location_downloaded = 0;
1794 /* Clear `inserted' flag. */
1795 for (loc = b->loc; loc; loc = loc->next)
1798 if ((b->type == bp_fast_tracepoint
1799 ? !may_insert_fast_tracepoints
1800 : !may_insert_tracepoints))
1803 t->number_on_target = 0;
1805 for (loc = b->loc; loc; loc = loc->next)
1807 /* Since tracepoint locations are never duplicated, `inserted'
1808 flag should be zero. */
1809 gdb_assert (!loc->inserted);
1811 target_download_tracepoint (loc);
1814 bp_location_downloaded = 1;
1817 t->number_on_target = b->number;
1819 for (loc = b->loc; loc; loc = loc->next)
1820 if (loc->probe != NULL)
1821 loc->probe->pops->set_semaphore (loc->probe, loc->gdbarch);
1823 if (bp_location_downloaded)
1824 observer_notify_breakpoint_modified (b);
1826 VEC_free (breakpoint_p, tp_vec);
1828 /* Send down all the trace state variables too. */
1829 for (ix = 0; VEC_iterate (tsv_s, tvariables, ix, tsv); ++ix)
1831 target_download_trace_state_variable (tsv);
1834 /* Tell target to treat text-like sections as transparent. */
1835 target_trace_set_readonly_regions ();
1836 /* Set some mode flags. */
1837 target_set_disconnected_tracing (disconnected_tracing);
1838 target_set_circular_trace_buffer (circular_trace_buffer);
1839 target_set_trace_buffer_size (trace_buffer_size);
1842 notes = trace_notes;
1843 ret = target_set_trace_notes (trace_user, notes, NULL);
1845 if (!ret && (trace_user || notes))
1846 warning (_("Target does not support trace user/notes, info ignored"));
1848 /* Now insert traps and begin collecting data. */
1849 target_trace_start ();
1851 /* Reset our local state. */
1852 set_traceframe_num (-1);
1853 set_tracepoint_num (-1);
1854 set_traceframe_context (NULL);
1855 current_trace_status()->running = 1;
1856 clear_traceframe_info ();
1859 /* The tstart command requests the target to start a new trace run.
1860 The command passes any arguments it has to the target verbatim, as
1861 an optional "trace note". This is useful as for instance a warning
1862 to other users if the trace runs disconnected, and you don't want
1863 anybody else messing with the target. */
1866 trace_start_command (char *args, int from_tty)
1868 dont_repeat (); /* Like "run", dangerous to repeat accidentally. */
1870 if (current_trace_status ()->running)
1873 && !query (_("A trace is running already. Start a new run? ")))
1874 error (_("New trace run not started."));
1877 start_tracing (args);
1880 /* The tstop command stops the tracing run. The command passes any
1881 supplied arguments to the target verbatim as a "stop note"; if the
1882 target supports trace notes, then it will be reported back as part
1883 of the trace run's status. */
1886 trace_stop_command (char *args, int from_tty)
1888 if (!current_trace_status ()->running)
1889 error (_("Trace is not running."));
1891 stop_tracing (args);
1895 stop_tracing (char *note)
1898 VEC(breakpoint_p) *tp_vec = NULL;
1900 struct breakpoint *t;
1902 target_trace_stop ();
1904 tp_vec = all_tracepoints ();
1905 for (ix = 0; VEC_iterate (breakpoint_p, tp_vec, ix, t); ix++)
1907 struct bp_location *loc;
1909 if ((t->type == bp_fast_tracepoint
1910 ? !may_insert_fast_tracepoints
1911 : !may_insert_tracepoints))
1914 for (loc = t->loc; loc; loc = loc->next)
1916 /* GDB can be totally absent in some disconnected trace scenarios,
1917 but we don't really care if this semaphore goes out of sync.
1918 That's why we are decrementing it here, but not taking care
1920 if (loc->probe != NULL)
1921 loc->probe->pops->clear_semaphore (loc->probe, loc->gdbarch);
1925 VEC_free (breakpoint_p, tp_vec);
1928 note = trace_stop_notes;
1929 ret = target_set_trace_notes (NULL, NULL, note);
1932 warning (_("Target does not support trace notes, note ignored"));
1934 /* Should change in response to reply? */
1935 current_trace_status ()->running = 0;
1938 /* tstatus command */
1940 trace_status_command (char *args, int from_tty)
1942 struct trace_status *ts = current_trace_status ();
1944 VEC(breakpoint_p) *tp_vec = NULL;
1945 struct breakpoint *t;
1947 status = target_get_trace_status (ts);
1951 if (ts->filename != NULL)
1952 printf_filtered (_("Using a trace file.\n"));
1955 printf_filtered (_("Trace can not be run on this target.\n"));
1960 if (!ts->running_known)
1962 printf_filtered (_("Run/stop status is unknown.\n"));
1964 else if (ts->running)
1966 printf_filtered (_("Trace is running on the target.\n"));
1970 switch (ts->stop_reason)
1972 case trace_never_run:
1973 printf_filtered (_("No trace has been run on the target.\n"));
1977 printf_filtered (_("Trace stopped by a tstop command (%s).\n"),
1980 printf_filtered (_("Trace stopped by a tstop command.\n"));
1982 case trace_buffer_full:
1983 printf_filtered (_("Trace stopped because the buffer was full.\n"));
1985 case trace_disconnected:
1986 printf_filtered (_("Trace stopped because of disconnection.\n"));
1988 case tracepoint_passcount:
1989 printf_filtered (_("Trace stopped by tracepoint %d.\n"),
1990 ts->stopping_tracepoint);
1992 case tracepoint_error:
1993 if (ts->stopping_tracepoint)
1994 printf_filtered (_("Trace stopped by an "
1995 "error (%s, tracepoint %d).\n"),
1996 ts->stop_desc, ts->stopping_tracepoint);
1998 printf_filtered (_("Trace stopped by an error (%s).\n"),
2001 case trace_stop_reason_unknown:
2002 printf_filtered (_("Trace stopped for an unknown reason.\n"));
2005 printf_filtered (_("Trace stopped for some other reason (%d).\n"),
2011 if (ts->traceframes_created >= 0
2012 && ts->traceframe_count != ts->traceframes_created)
2014 printf_filtered (_("Buffer contains %d trace "
2015 "frames (of %d created total).\n"),
2016 ts->traceframe_count, ts->traceframes_created);
2018 else if (ts->traceframe_count >= 0)
2020 printf_filtered (_("Collected %d trace frames.\n"),
2021 ts->traceframe_count);
2024 if (ts->buffer_free >= 0)
2026 if (ts->buffer_size >= 0)
2028 printf_filtered (_("Trace buffer has %d bytes of %d bytes free"),
2029 ts->buffer_free, ts->buffer_size);
2030 if (ts->buffer_size > 0)
2031 printf_filtered (_(" (%d%% full)"),
2032 ((int) ((((long long) (ts->buffer_size
2033 - ts->buffer_free)) * 100)
2034 / ts->buffer_size)));
2035 printf_filtered (_(".\n"));
2038 printf_filtered (_("Trace buffer has %d bytes free.\n"),
2042 if (ts->disconnected_tracing)
2043 printf_filtered (_("Trace will continue if GDB disconnects.\n"));
2045 printf_filtered (_("Trace will stop if GDB disconnects.\n"));
2047 if (ts->circular_buffer)
2048 printf_filtered (_("Trace buffer is circular.\n"));
2050 if (ts->user_name && strlen (ts->user_name) > 0)
2051 printf_filtered (_("Trace user is %s.\n"), ts->user_name);
2053 if (ts->notes && strlen (ts->notes) > 0)
2054 printf_filtered (_("Trace notes: %s.\n"), ts->notes);
2056 /* Now report on what we're doing with tfind. */
2057 if (traceframe_number >= 0)
2058 printf_filtered (_("Looking at trace frame %d, tracepoint %d.\n"),
2059 traceframe_number, tracepoint_number);
2061 printf_filtered (_("Not looking at any trace frame.\n"));
2063 /* Report start/stop times if supplied. */
2068 LONGEST run_time = ts->stop_time - ts->start_time;
2070 /* Reporting a run time is more readable than two long numbers. */
2071 printf_filtered (_("Trace started at %ld.%06ld secs, stopped %ld.%06ld secs later.\n"),
2072 (long int) ts->start_time / 1000000,
2073 (long int) ts->start_time % 1000000,
2074 (long int) run_time / 1000000,
2075 (long int) run_time % 1000000);
2078 printf_filtered (_("Trace started at %ld.%06ld secs.\n"),
2079 (long int) ts->start_time / 1000000,
2080 (long int) ts->start_time % 1000000);
2082 else if (ts->stop_time)
2083 printf_filtered (_("Trace stopped at %ld.%06ld secs.\n"),
2084 (long int) ts->stop_time / 1000000,
2085 (long int) ts->stop_time % 1000000);
2087 /* Now report any per-tracepoint status available. */
2088 tp_vec = all_tracepoints ();
2090 for (ix = 0; VEC_iterate (breakpoint_p, tp_vec, ix, t); ix++)
2091 target_get_tracepoint_status (t, NULL);
2093 VEC_free (breakpoint_p, tp_vec);
2096 /* Report the trace status to uiout, in a way suitable for MI, and not
2097 suitable for CLI. If ON_STOP is true, suppress a few fields that
2098 are not meaningful in the -trace-stop response.
2100 The implementation is essentially parallel to trace_status_command, but
2101 merging them will result in unreadable code. */
2103 trace_status_mi (int on_stop)
2105 struct ui_out *uiout = current_uiout;
2106 struct trace_status *ts = current_trace_status ();
2109 status = target_get_trace_status (ts);
2111 if (status == -1 && ts->filename == NULL)
2113 ui_out_field_string (uiout, "supported", "0");
2117 if (ts->filename != NULL)
2118 ui_out_field_string (uiout, "supported", "file");
2120 ui_out_field_string (uiout, "supported", "1");
2122 if (ts->filename != NULL)
2123 ui_out_field_string (uiout, "trace-file", ts->filename);
2125 gdb_assert (ts->running_known);
2129 ui_out_field_string (uiout, "running", "1");
2131 /* Unlike CLI, do not show the state of 'disconnected-tracing' variable.
2132 Given that the frontend gets the status either on -trace-stop, or from
2133 -trace-status after re-connection, it does not seem like this
2134 information is necessary for anything. It is not necessary for either
2135 figuring the vital state of the target nor for navigation of trace
2136 frames. If the frontend wants to show the current state is some
2137 configure dialog, it can request the value when such dialog is
2138 invoked by the user. */
2142 char *stop_reason = NULL;
2143 int stopping_tracepoint = -1;
2146 ui_out_field_string (uiout, "running", "0");
2148 if (ts->stop_reason != trace_stop_reason_unknown)
2150 switch (ts->stop_reason)
2153 stop_reason = "request";
2155 case trace_buffer_full:
2156 stop_reason = "overflow";
2158 case trace_disconnected:
2159 stop_reason = "disconnection";
2161 case tracepoint_passcount:
2162 stop_reason = "passcount";
2163 stopping_tracepoint = ts->stopping_tracepoint;
2165 case tracepoint_error:
2166 stop_reason = "error";
2167 stopping_tracepoint = ts->stopping_tracepoint;
2173 ui_out_field_string (uiout, "stop-reason", stop_reason);
2174 if (stopping_tracepoint != -1)
2175 ui_out_field_int (uiout, "stopping-tracepoint",
2176 stopping_tracepoint);
2177 if (ts->stop_reason == tracepoint_error)
2178 ui_out_field_string (uiout, "error-description",
2184 if (ts->traceframe_count != -1)
2185 ui_out_field_int (uiout, "frames", ts->traceframe_count);
2186 if (ts->traceframes_created != -1)
2187 ui_out_field_int (uiout, "frames-created", ts->traceframes_created);
2188 if (ts->buffer_size != -1)
2189 ui_out_field_int (uiout, "buffer-size", ts->buffer_size);
2190 if (ts->buffer_free != -1)
2191 ui_out_field_int (uiout, "buffer-free", ts->buffer_free);
2193 ui_out_field_int (uiout, "disconnected", ts->disconnected_tracing);
2194 ui_out_field_int (uiout, "circular", ts->circular_buffer);
2196 ui_out_field_string (uiout, "user-name", ts->user_name);
2197 ui_out_field_string (uiout, "notes", ts->notes);
2202 xsnprintf (buf, sizeof buf, "%ld.%06ld",
2203 (long int) ts->start_time / 1000000,
2204 (long int) ts->start_time % 1000000);
2205 ui_out_field_string (uiout, "start-time", buf);
2206 xsnprintf (buf, sizeof buf, "%ld.%06ld",
2207 (long int) ts->stop_time / 1000000,
2208 (long int) ts->stop_time % 1000000);
2209 ui_out_field_string (uiout, "stop-time", buf);
2213 /* This function handles the details of what to do about an ongoing
2214 tracing run if the user has asked to detach or otherwise disconnect
2217 disconnect_tracing (int from_tty)
2219 /* It can happen that the target that was tracing went away on its
2220 own, and we didn't notice. Get a status update, and if the
2221 current target doesn't even do tracing, then assume it's not
2223 if (target_get_trace_status (current_trace_status ()) < 0)
2224 current_trace_status ()->running = 0;
2226 /* If running interactively, give the user the option to cancel and
2227 then decide what to do differently with the run. Scripts are
2228 just going to disconnect and let the target deal with it,
2229 according to how it's been instructed previously via
2230 disconnected-tracing. */
2231 if (current_trace_status ()->running && from_tty)
2233 process_tracepoint_on_disconnect ();
2235 if (current_trace_status ()->disconnected_tracing)
2237 if (!query (_("Trace is running and will "
2238 "continue after detach; detach anyway? ")))
2239 error (_("Not confirmed."));
2243 if (!query (_("Trace is running but will "
2244 "stop on detach; detach anyway? ")))
2245 error (_("Not confirmed."));
2249 /* Also we want to be out of tfind mode, otherwise things can get
2250 confusing upon reconnection. Just use these calls instead of
2251 full tfind_1 behavior because we're in the middle of detaching,
2252 and there's no point to updating current stack frame etc. */
2253 set_current_traceframe (-1);
2254 set_tracepoint_num (-1);
2255 set_traceframe_context (NULL);
2258 /* Worker function for the various flavors of the tfind command. */
2260 tfind_1 (enum trace_find_type type, int num,
2261 ULONGEST addr1, ULONGEST addr2,
2264 int target_frameno = -1, target_tracept = -1;
2265 struct frame_id old_frame_id = null_frame_id;
2266 struct tracepoint *tp;
2267 struct ui_out *uiout = current_uiout;
2269 /* Only try to get the current stack frame if we have a chance of
2270 succeeding. In particular, if we're trying to get a first trace
2271 frame while all threads are running, it's not going to succeed,
2272 so leave it with a default value and let the frame comparison
2273 below (correctly) decide to print out the source location of the
2275 if (!(type == tfind_number && num == -1)
2276 && (has_stack_frames () || traceframe_number >= 0))
2277 old_frame_id = get_frame_id (get_current_frame ());
2279 target_frameno = target_trace_find (type, num, addr1, addr2,
2282 if (type == tfind_number
2284 && target_frameno == -1)
2286 /* We told the target to get out of tfind mode, and it did. */
2288 else if (target_frameno == -1)
2290 /* A request for a non-existent trace frame has failed.
2291 Our response will be different, depending on FROM_TTY:
2293 If FROM_TTY is true, meaning that this command was
2294 typed interactively by the user, then give an error
2295 and DO NOT change the state of traceframe_number etc.
2297 However if FROM_TTY is false, meaning that we're either
2298 in a script, a loop, or a user-defined command, then
2299 DON'T give an error, but DO change the state of
2300 traceframe_number etc. to invalid.
2302 The rationalle is that if you typed the command, you
2303 might just have committed a typo or something, and you'd
2304 like to NOT lose your current debugging state. However
2305 if you're in a user-defined command or especially in a
2306 loop, then you need a way to detect that the command
2307 failed WITHOUT aborting. This allows you to write
2308 scripts that search thru the trace buffer until the end,
2309 and then continue on to do something else. */
2312 error (_("Target failed to find requested trace frame."));
2316 printf_filtered ("End of trace buffer.\n");
2317 #if 0 /* dubious now? */
2318 /* The following will not recurse, since it's
2320 trace_find_command ("-1", from_tty);
2325 tp = get_tracepoint_by_number_on_target (target_tracept);
2327 reinit_frame_cache ();
2328 target_dcache_invalidate ();
2330 set_tracepoint_num (tp ? tp->base.number : target_tracept);
2332 if (target_frameno != get_traceframe_number ())
2333 observer_notify_traceframe_changed (target_frameno, tracepoint_number);
2335 set_current_traceframe (target_frameno);
2337 if (target_frameno == -1)
2338 set_traceframe_context (NULL);
2340 set_traceframe_context (get_current_frame ());
2342 if (traceframe_number >= 0)
2344 /* Use different branches for MI and CLI to make CLI messages
2346 if (ui_out_is_mi_like_p (uiout))
2348 ui_out_field_string (uiout, "found", "1");
2349 ui_out_field_int (uiout, "tracepoint", tracepoint_number);
2350 ui_out_field_int (uiout, "traceframe", traceframe_number);
2354 printf_unfiltered (_("Found trace frame %d, tracepoint %d\n"),
2355 traceframe_number, tracepoint_number);
2360 if (ui_out_is_mi_like_p (uiout))
2361 ui_out_field_string (uiout, "found", "0");
2362 else if (type == tfind_number && num == -1)
2363 printf_unfiltered (_("No longer looking at any trace frame\n"));
2364 else /* This case may never occur, check. */
2365 printf_unfiltered (_("No trace frame found\n"));
2368 /* If we're in nonstop mode and getting out of looking at trace
2369 frames, there won't be any current frame to go back to and
2372 && (has_stack_frames () || traceframe_number >= 0))
2374 enum print_what print_what;
2376 /* NOTE: in imitation of the step command, try to determine
2377 whether we have made a transition from one function to
2378 another. If so, we'll print the "stack frame" (ie. the new
2379 function and it's arguments) -- otherwise we'll just show the
2382 if (frame_id_eq (old_frame_id,
2383 get_frame_id (get_current_frame ())))
2384 print_what = SRC_LINE;
2386 print_what = SRC_AND_LOC;
2388 print_stack_frame (get_selected_frame (NULL), 1, print_what);
2393 /* trace_find_command takes a trace frame number n,
2394 sends "QTFrame:<n>" to the target,
2395 and accepts a reply that may contain several optional pieces
2396 of information: a frame number, a tracepoint number, and an
2397 indication of whether this is a trap frame or a stepping frame.
2399 The minimal response is just "OK" (which indicates that the
2400 target does not give us a frame number or a tracepoint number).
2401 Instead of that, the target may send us a string containing
2403 F<hexnum> (gives the selected frame number)
2404 T<hexnum> (gives the selected tracepoint number)
2409 trace_find_command (char *args, int from_tty)
2410 { /* This should only be called with a numeric argument. */
2413 if (current_trace_status ()->running
2414 && current_trace_status ()->filename == NULL)
2415 error (_("May not look at trace frames while trace is running."));
2417 if (args == 0 || *args == 0)
2418 { /* TFIND with no args means find NEXT trace frame. */
2419 if (traceframe_number == -1)
2420 frameno = 0; /* "next" is first one. */
2422 frameno = traceframe_number + 1;
2424 else if (0 == strcmp (args, "-"))
2426 if (traceframe_number == -1)
2427 error (_("not debugging trace buffer"));
2428 else if (from_tty && traceframe_number == 0)
2429 error (_("already at start of trace buffer"));
2431 frameno = traceframe_number - 1;
2433 /* A hack to work around eval's need for fp to have been collected. */
2434 else if (0 == strcmp (args, "-1"))
2437 frameno = parse_and_eval_long (args);
2440 error (_("invalid input (%d is less than zero)"), frameno);
2442 tfind_1 (tfind_number, frameno, 0, 0, from_tty);
2447 trace_find_end_command (char *args, int from_tty)
2449 trace_find_command ("-1", from_tty);
2454 trace_find_start_command (char *args, int from_tty)
2456 trace_find_command ("0", from_tty);
2459 /* tfind pc command */
2461 trace_find_pc_command (char *args, int from_tty)
2465 if (current_trace_status ()->running
2466 && current_trace_status ()->filename == NULL)
2467 error (_("May not look at trace frames while trace is running."));
2469 if (args == 0 || *args == 0)
2470 pc = regcache_read_pc (get_current_regcache ());
2472 pc = parse_and_eval_address (args);
2474 tfind_1 (tfind_pc, 0, pc, 0, from_tty);
2477 /* tfind tracepoint command */
2479 trace_find_tracepoint_command (char *args, int from_tty)
2482 struct tracepoint *tp;
2484 if (current_trace_status ()->running
2485 && current_trace_status ()->filename == NULL)
2486 error (_("May not look at trace frames while trace is running."));
2488 if (args == 0 || *args == 0)
2490 if (tracepoint_number == -1)
2491 error (_("No current tracepoint -- please supply an argument."));
2493 tdp = tracepoint_number; /* Default is current TDP. */
2496 tdp = parse_and_eval_long (args);
2498 /* If we have the tracepoint on hand, use the number that the
2499 target knows about (which may be different if we disconnected
2500 and reconnected). */
2501 tp = get_tracepoint (tdp);
2503 tdp = tp->number_on_target;
2505 tfind_1 (tfind_tp, tdp, 0, 0, from_tty);
2508 /* TFIND LINE command:
2510 This command will take a sourceline for argument, just like BREAK
2511 or TRACE (ie. anything that "decode_line_1" can handle).
2513 With no argument, this command will find the next trace frame
2514 corresponding to a source line OTHER THAN THE CURRENT ONE. */
2517 trace_find_line_command (char *args, int from_tty)
2519 static CORE_ADDR start_pc, end_pc;
2520 struct symtabs_and_lines sals;
2521 struct symtab_and_line sal;
2522 struct cleanup *old_chain;
2524 if (current_trace_status ()->running
2525 && current_trace_status ()->filename == NULL)
2526 error (_("May not look at trace frames while trace is running."));
2528 if (args == 0 || *args == 0)
2530 sal = find_pc_line (get_frame_pc (get_current_frame ()), 0);
2532 sals.sals = (struct symtab_and_line *)
2533 xmalloc (sizeof (struct symtab_and_line));
2538 sals = decode_line_with_current_source (args, DECODE_LINE_FUNFIRSTLINE);
2542 old_chain = make_cleanup (xfree, sals.sals);
2543 if (sal.symtab == 0)
2544 error (_("No line number information available."));
2546 if (sal.line > 0 && find_line_pc_range (sal, &start_pc, &end_pc))
2548 if (start_pc == end_pc)
2550 printf_filtered ("Line %d of \"%s\"",
2552 symtab_to_filename_for_display (sal.symtab));
2554 printf_filtered (" is at address ");
2555 print_address (get_current_arch (), start_pc, gdb_stdout);
2557 printf_filtered (" but contains no code.\n");
2558 sal = find_pc_line (start_pc, 0);
2560 && find_line_pc_range (sal, &start_pc, &end_pc)
2561 && start_pc != end_pc)
2562 printf_filtered ("Attempting to find line %d instead.\n",
2565 error (_("Cannot find a good line."));
2569 /* Is there any case in which we get here, and have an address
2570 which the user would want to see? If we have debugging
2571 symbols and no line numbers? */
2572 error (_("Line number %d is out of range for \"%s\"."),
2573 sal.line, symtab_to_filename_for_display (sal.symtab));
2575 /* Find within range of stated line. */
2577 tfind_1 (tfind_range, 0, start_pc, end_pc - 1, from_tty);
2579 tfind_1 (tfind_outside, 0, start_pc, end_pc - 1, from_tty);
2580 do_cleanups (old_chain);
2583 /* tfind range command */
2585 trace_find_range_command (char *args, int from_tty)
2587 static CORE_ADDR start, stop;
2590 if (current_trace_status ()->running
2591 && current_trace_status ()->filename == NULL)
2592 error (_("May not look at trace frames while trace is running."));
2594 if (args == 0 || *args == 0)
2595 { /* XXX FIXME: what should default behavior be? */
2596 printf_filtered ("Usage: tfind range <startaddr>,<endaddr>\n");
2600 if (0 != (tmp = strchr (args, ',')))
2602 *tmp++ = '\0'; /* Terminate start address. */
2603 tmp = skip_spaces (tmp);
2604 start = parse_and_eval_address (args);
2605 stop = parse_and_eval_address (tmp);
2608 { /* No explicit end address? */
2609 start = parse_and_eval_address (args);
2610 stop = start + 1; /* ??? */
2613 tfind_1 (tfind_range, 0, start, stop, from_tty);
2616 /* tfind outside command */
2618 trace_find_outside_command (char *args, int from_tty)
2620 CORE_ADDR start, stop;
2623 if (current_trace_status ()->running
2624 && current_trace_status ()->filename == NULL)
2625 error (_("May not look at trace frames while trace is running."));
2627 if (args == 0 || *args == 0)
2628 { /* XXX FIXME: what should default behavior be? */
2629 printf_filtered ("Usage: tfind outside <startaddr>,<endaddr>\n");
2633 if (0 != (tmp = strchr (args, ',')))
2635 *tmp++ = '\0'; /* Terminate start address. */
2636 tmp = skip_spaces (tmp);
2637 start = parse_and_eval_address (args);
2638 stop = parse_and_eval_address (tmp);
2641 { /* No explicit end address? */
2642 start = parse_and_eval_address (args);
2643 stop = start + 1; /* ??? */
2646 tfind_1 (tfind_outside, 0, start, stop, from_tty);
2649 /* info scope command: list the locals for a scope. */
2651 scope_info (char *args, int from_tty)
2653 struct symtabs_and_lines sals;
2655 struct minimal_symbol *msym;
2656 struct block *block;
2657 const char *symname;
2658 char *save_args = args;
2659 struct block_iterator iter;
2661 struct gdbarch *gdbarch;
2664 if (args == 0 || *args == 0)
2665 error (_("requires an argument (function, "
2666 "line or *addr) to define a scope"));
2668 sals = decode_line_1 (&args, DECODE_LINE_FUNFIRSTLINE, NULL, 0);
2669 if (sals.nelts == 0)
2670 return; /* Presumably decode_line_1 has already warned. */
2672 /* Resolve line numbers to PC. */
2673 resolve_sal_pc (&sals.sals[0]);
2674 block = block_for_pc (sals.sals[0].pc);
2678 QUIT; /* Allow user to bail out with ^C. */
2679 ALL_BLOCK_SYMBOLS (block, iter, sym)
2681 QUIT; /* Allow user to bail out with ^C. */
2683 printf_filtered ("Scope for %s:\n", save_args);
2686 symname = SYMBOL_PRINT_NAME (sym);
2687 if (symname == NULL || *symname == '\0')
2688 continue; /* Probably botched, certainly useless. */
2690 gdbarch = get_objfile_arch (SYMBOL_SYMTAB (sym)->objfile);
2692 printf_filtered ("Symbol %s is ", symname);
2693 switch (SYMBOL_CLASS (sym))
2696 case LOC_UNDEF: /* Messed up symbol? */
2697 printf_filtered ("a bogus symbol, class %d.\n",
2698 SYMBOL_CLASS (sym));
2699 count--; /* Don't count this one. */
2702 printf_filtered ("a constant with value %s (%s)",
2703 plongest (SYMBOL_VALUE (sym)),
2704 hex_string (SYMBOL_VALUE (sym)));
2706 case LOC_CONST_BYTES:
2707 printf_filtered ("constant bytes: ");
2708 if (SYMBOL_TYPE (sym))
2709 for (j = 0; j < TYPE_LENGTH (SYMBOL_TYPE (sym)); j++)
2710 fprintf_filtered (gdb_stdout, " %02x",
2711 (unsigned) SYMBOL_VALUE_BYTES (sym)[j]);
2714 printf_filtered ("in static storage at address ");
2715 printf_filtered ("%s", paddress (gdbarch,
2716 SYMBOL_VALUE_ADDRESS (sym)));
2719 /* GDBARCH is the architecture associated with the objfile
2720 the symbol is defined in; the target architecture may be
2721 different, and may provide additional registers. However,
2722 we do not know the target architecture at this point.
2723 We assume the objfile architecture will contain all the
2724 standard registers that occur in debug info in that
2726 regno = SYMBOL_REGISTER_OPS (sym)->register_number (sym,
2729 if (SYMBOL_IS_ARGUMENT (sym))
2730 printf_filtered ("an argument in register $%s",
2731 gdbarch_register_name (gdbarch, regno));
2733 printf_filtered ("a local variable in register $%s",
2734 gdbarch_register_name (gdbarch, regno));
2737 printf_filtered ("an argument at stack/frame offset %s",
2738 plongest (SYMBOL_VALUE (sym)));
2741 printf_filtered ("a local variable at frame offset %s",
2742 plongest (SYMBOL_VALUE (sym)));
2745 printf_filtered ("a reference argument at offset %s",
2746 plongest (SYMBOL_VALUE (sym)));
2748 case LOC_REGPARM_ADDR:
2749 /* Note comment at LOC_REGISTER. */
2750 regno = SYMBOL_REGISTER_OPS (sym)->register_number (sym,
2752 printf_filtered ("the address of an argument, in register $%s",
2753 gdbarch_register_name (gdbarch, regno));
2756 printf_filtered ("a typedef.\n");
2759 printf_filtered ("a label at address ");
2760 printf_filtered ("%s", paddress (gdbarch,
2761 SYMBOL_VALUE_ADDRESS (sym)));
2764 printf_filtered ("a function at address ");
2765 printf_filtered ("%s",
2766 paddress (gdbarch, BLOCK_START (SYMBOL_BLOCK_VALUE (sym))));
2768 case LOC_UNRESOLVED:
2769 msym = lookup_minimal_symbol (SYMBOL_LINKAGE_NAME (sym),
2772 printf_filtered ("Unresolved Static");
2775 printf_filtered ("static storage at address ");
2776 printf_filtered ("%s",
2777 paddress (gdbarch, SYMBOL_VALUE_ADDRESS (msym)));
2780 case LOC_OPTIMIZED_OUT:
2781 printf_filtered ("optimized out.\n");
2784 SYMBOL_COMPUTED_OPS (sym)->describe_location (sym,
2785 BLOCK_START (block),
2789 if (SYMBOL_TYPE (sym))
2790 printf_filtered (", length %d.\n",
2791 TYPE_LENGTH (check_typedef (SYMBOL_TYPE (sym))));
2793 if (BLOCK_FUNCTION (block))
2796 block = BLOCK_SUPERBLOCK (block);
2799 printf_filtered ("Scope for %s contains no locals or arguments.\n",
2803 /* worker function (cleanup) */
2805 replace_comma (void *data)
2812 /* Helper for trace_dump_command. Dump the action list starting at
2813 ACTION. STEPPING_ACTIONS is true if we're iterating over the
2814 actions of the body of a while-stepping action. STEPPING_FRAME is
2815 set if the current traceframe was determined to be a while-stepping
2819 trace_dump_actions (struct command_line *action,
2820 int stepping_actions, int stepping_frame,
2823 char *action_exp, *next_comma;
2825 for (; action != NULL; action = action->next)
2827 struct cmd_list_element *cmd;
2829 QUIT; /* Allow user to bail out with ^C. */
2830 action_exp = action->line;
2831 action_exp = skip_spaces (action_exp);
2833 /* The collection actions to be done while stepping are
2834 bracketed by the commands "while-stepping" and "end". */
2836 if (*action_exp == '#') /* comment line */
2839 cmd = lookup_cmd (&action_exp, cmdlist, "", -1, 1);
2841 error (_("Bad action list item: %s"), action_exp);
2843 if (cmd_cfunc_eq (cmd, while_stepping_pseudocommand))
2847 for (i = 0; i < action->body_count; ++i)
2848 trace_dump_actions (action->body_list[i],
2849 1, stepping_frame, from_tty);
2851 else if (cmd_cfunc_eq (cmd, collect_pseudocommand))
2853 /* Display the collected data.
2854 For the trap frame, display only what was collected at
2855 the trap. Likewise for stepping frames, display only
2856 what was collected while stepping. This means that the
2857 two boolean variables, STEPPING_FRAME and
2858 STEPPING_ACTIONS should be equal. */
2859 if (stepping_frame == stepping_actions)
2861 if (*action_exp == '/')
2862 action_exp = decode_agent_options (action_exp);
2865 { /* Repeat over a comma-separated list. */
2866 QUIT; /* Allow user to bail out with ^C. */
2867 if (*action_exp == ',')
2869 action_exp = skip_spaces (action_exp);
2871 next_comma = strchr (action_exp, ',');
2873 if (0 == strncasecmp (action_exp, "$reg", 4))
2874 registers_info (NULL, from_tty);
2875 else if (0 == strncasecmp (action_exp, "$_ret", 5))
2877 else if (0 == strncasecmp (action_exp, "$loc", 4))
2878 locals_info (NULL, from_tty);
2879 else if (0 == strncasecmp (action_exp, "$arg", 4))
2880 args_info (NULL, from_tty);
2885 make_cleanup (replace_comma, next_comma);
2888 printf_filtered ("%s = ", action_exp);
2889 output_command (action_exp, from_tty);
2890 printf_filtered ("\n");
2894 action_exp = next_comma;
2896 while (action_exp && *action_exp == ',');
2902 /* The tdump command. */
2905 trace_dump_command (char *args, int from_tty)
2907 struct regcache *regcache;
2908 struct tracepoint *t;
2909 int stepping_frame = 0;
2910 struct bp_location *loc;
2911 char *line, *default_collect_line = NULL;
2912 struct command_line *actions, *default_collect_action = NULL;
2913 struct cleanup *old_chain = NULL;
2915 if (tracepoint_number == -1)
2917 warning (_("No current trace frame."));
2921 t = get_tracepoint (tracepoint_number);
2924 error (_("No known tracepoint matches 'current' tracepoint #%d."),
2927 printf_filtered ("Data collected at tracepoint %d, trace frame %d:\n",
2928 tracepoint_number, traceframe_number);
2930 /* The current frame is a trap frame if the frame PC is equal
2931 to the tracepoint PC. If not, then the current frame was
2932 collected during single-stepping. */
2934 regcache = get_current_regcache ();
2936 /* If the traceframe's address matches any of the tracepoint's
2937 locations, assume it is a direct hit rather than a while-stepping
2938 frame. (FIXME this is not reliable, should record each frame's
2941 for (loc = t->base.loc; loc; loc = loc->next)
2942 if (loc->address == regcache_read_pc (regcache))
2945 actions = breakpoint_commands (&t->base);
2947 /* If there is a default-collect list, make up a collect command,
2948 prepend to the tracepoint's commands, and pass the whole mess to
2949 the trace dump scanner. We need to validate because
2950 default-collect might have been junked since the trace run. */
2951 if (*default_collect)
2953 default_collect_line = xstrprintf ("collect %s", default_collect);
2954 old_chain = make_cleanup (xfree, default_collect_line);
2955 line = default_collect_line;
2956 validate_actionline (&line, &t->base);
2957 default_collect_action = xmalloc (sizeof (struct command_line));
2958 make_cleanup (xfree, default_collect_action);
2959 default_collect_action->next = actions;
2960 default_collect_action->line = line;
2961 actions = default_collect_action;
2964 trace_dump_actions (actions, 0, stepping_frame, from_tty);
2966 if (*default_collect)
2967 do_cleanups (old_chain);
2970 /* Encode a piece of a tracepoint's source-level definition in a form
2971 that is suitable for both protocol and saving in files. */
2972 /* This version does not do multiple encodes for long strings; it should
2973 return an offset to the next piece to encode. FIXME */
2976 encode_source_string (int tpnum, ULONGEST addr,
2977 char *srctype, char *src, char *buf, int buf_size)
2979 if (80 + strlen (srctype) > buf_size)
2980 error (_("Buffer too small for source encoding"));
2981 sprintf (buf, "%x:%s:%s:%x:%x:",
2982 tpnum, phex_nz (addr, sizeof (addr)),
2983 srctype, 0, (int) strlen (src));
2984 if (strlen (buf) + strlen (src) * 2 >= buf_size)
2985 error (_("Source string too long for buffer"));
2986 bin2hex (src, buf + strlen (buf), 0);
2990 extern int trace_regblock_size;
2992 /* Save tracepoint data to file named FILENAME. If TARGET_DOES_SAVE is
2993 non-zero, the save is performed on the target, otherwise GDB obtains all
2994 trace data and saves it locally. */
2997 trace_save (const char *filename, int target_does_save)
2999 struct cleanup *cleanup;
3001 struct trace_status *ts = current_trace_status ();
3004 struct uploaded_tp *uploaded_tps = NULL, *utp;
3005 struct uploaded_tsv *uploaded_tsvs = NULL, *utsv;
3009 ULONGEST offset = 0;
3010 #define MAX_TRACE_UPLOAD 2000
3011 gdb_byte buf[MAX_TRACE_UPLOAD];
3014 /* If the target is to save the data to a file on its own, then just
3015 send the command and be done with it. */
3016 if (target_does_save)
3018 err = target_save_trace_data (filename);
3020 error (_("Target failed to save trace data to '%s'."),
3025 /* Get the trace status first before opening the file, so if the
3026 target is losing, we can get out without touching files. */
3027 status = target_get_trace_status (ts);
3029 pathname = tilde_expand (filename);
3030 cleanup = make_cleanup (xfree, pathname);
3032 fp = fopen (pathname, "wb");
3034 error (_("Unable to open file '%s' for saving trace data (%s)"),
3035 filename, safe_strerror (errno));
3036 make_cleanup_fclose (fp);
3038 /* Write a file header, with a high-bit-set char to indicate a
3039 binary file, plus a hint as what this file is, and a version
3040 number in case of future needs. */
3041 written = fwrite ("\x7fTRACE0\n", 8, 1, fp);
3043 perror_with_name (pathname);
3045 /* Write descriptive info. */
3047 /* Write out the size of a register block. */
3048 fprintf (fp, "R %x\n", trace_regblock_size);
3050 /* Write out status of the tracing run (aka "tstatus" info). */
3051 fprintf (fp, "status %c;%s",
3052 (ts->running ? '1' : '0'), stop_reason_names[ts->stop_reason]);
3053 if (ts->stop_reason == tracepoint_error)
3055 char *buf = (char *) alloca (strlen (ts->stop_desc) * 2 + 1);
3057 bin2hex ((gdb_byte *) ts->stop_desc, buf, 0);
3058 fprintf (fp, ":%s", buf);
3060 fprintf (fp, ":%x", ts->stopping_tracepoint);
3061 if (ts->traceframe_count >= 0)
3062 fprintf (fp, ";tframes:%x", ts->traceframe_count);
3063 if (ts->traceframes_created >= 0)
3064 fprintf (fp, ";tcreated:%x", ts->traceframes_created);
3065 if (ts->buffer_free >= 0)
3066 fprintf (fp, ";tfree:%x", ts->buffer_free);
3067 if (ts->buffer_size >= 0)
3068 fprintf (fp, ";tsize:%x", ts->buffer_size);
3069 if (ts->disconnected_tracing)
3070 fprintf (fp, ";disconn:%x", ts->disconnected_tracing);
3071 if (ts->circular_buffer)
3072 fprintf (fp, ";circular:%x", ts->circular_buffer);
3075 /* Note that we want to upload tracepoints and save those, rather
3076 than simply writing out the local ones, because the user may have
3077 changed tracepoints in GDB in preparation for a future tracing
3078 run, or maybe just mass-deleted all types of breakpoints as part
3079 of cleaning up. So as not to contaminate the session, leave the
3080 data in its uploaded form, don't make into real tracepoints. */
3082 /* Get trace state variables first, they may be checked when parsing
3083 uploaded commands. */
3085 target_upload_trace_state_variables (&uploaded_tsvs);
3087 for (utsv = uploaded_tsvs; utsv; utsv = utsv->next)
3093 buf = (char *) xmalloc (strlen (utsv->name) * 2 + 1);
3094 bin2hex ((gdb_byte *) (utsv->name), buf, 0);
3097 fprintf (fp, "tsv %x:%s:%x:%s\n",
3098 utsv->number, phex_nz (utsv->initial_value, 8),
3099 utsv->builtin, buf);
3105 free_uploaded_tsvs (&uploaded_tsvs);
3107 target_upload_tracepoints (&uploaded_tps);
3109 for (utp = uploaded_tps; utp; utp = utp->next)
3110 target_get_tracepoint_status (NULL, utp);
3112 for (utp = uploaded_tps; utp; utp = utp->next)
3114 fprintf (fp, "tp T%x:%s:%c:%x:%x",
3115 utp->number, phex_nz (utp->addr, sizeof (utp->addr)),
3116 (utp->enabled ? 'E' : 'D'), utp->step, utp->pass);
3117 if (utp->type == bp_fast_tracepoint)
3118 fprintf (fp, ":F%x", utp->orig_size);
3120 fprintf (fp, ":X%x,%s", (unsigned int) strlen (utp->cond) / 2,
3123 for (a = 0; VEC_iterate (char_ptr, utp->actions, a, act); ++a)
3124 fprintf (fp, "tp A%x:%s:%s\n",
3125 utp->number, phex_nz (utp->addr, sizeof (utp->addr)), act);
3126 for (a = 0; VEC_iterate (char_ptr, utp->step_actions, a, act); ++a)
3127 fprintf (fp, "tp S%x:%s:%s\n",
3128 utp->number, phex_nz (utp->addr, sizeof (utp->addr)), act);
3131 encode_source_string (utp->number, utp->addr,
3132 "at", utp->at_string, buf, MAX_TRACE_UPLOAD);
3133 fprintf (fp, "tp Z%s\n", buf);
3135 if (utp->cond_string)
3137 encode_source_string (utp->number, utp->addr,
3138 "cond", utp->cond_string,
3139 buf, MAX_TRACE_UPLOAD);
3140 fprintf (fp, "tp Z%s\n", buf);
3142 for (a = 0; VEC_iterate (char_ptr, utp->cmd_strings, a, act); ++a)
3144 encode_source_string (utp->number, utp->addr, "cmd", act,
3145 buf, MAX_TRACE_UPLOAD);
3146 fprintf (fp, "tp Z%s\n", buf);
3148 fprintf (fp, "tp V%x:%s:%x:%s\n",
3149 utp->number, phex_nz (utp->addr, sizeof (utp->addr)),
3151 phex_nz (utp->traceframe_usage,
3152 sizeof (utp->traceframe_usage)));
3155 free_uploaded_tps (&uploaded_tps);
3157 /* Mark the end of the definition section. */
3160 /* Get and write the trace data proper. We ask for big blocks, in
3161 the hopes of efficiency, but will take less if the target has
3162 packet size limitations or some such. */
3165 gotten = target_get_raw_trace_data (buf, offset, MAX_TRACE_UPLOAD);
3167 error (_("Failure to get requested trace buffer data"));
3168 /* No more data is forthcoming, we're done. */
3171 written = fwrite (buf, gotten, 1, fp);
3173 perror_with_name (pathname);
3177 /* Mark the end of trace data. (We know that gotten is 0 at this point.) */
3178 written = fwrite (&gotten, 4, 1, fp);
3180 perror_with_name (pathname);
3182 do_cleanups (cleanup);
3186 trace_save_command (char *args, int from_tty)
3188 int target_does_save = 0;
3190 char *filename = NULL;
3191 struct cleanup *back_to;
3194 error_no_arg (_("file in which to save trace data"));
3196 argv = gdb_buildargv (args);
3197 back_to = make_cleanup_freeargv (argv);
3199 for (; *argv; ++argv)
3201 if (strcmp (*argv, "-r") == 0)
3202 target_does_save = 1;
3203 else if (**argv == '-')
3204 error (_("unknown option `%s'"), *argv);
3210 error_no_arg (_("file in which to save trace data"));
3212 trace_save (filename, target_does_save);
3215 printf_filtered (_("Trace data saved to file '%s'.\n"), filename);
3217 do_cleanups (back_to);
3220 /* Tell the target what to do with an ongoing tracing run if GDB
3221 disconnects for some reason. */
3224 set_disconnected_tracing (char *args, int from_tty,
3225 struct cmd_list_element *c)
3227 target_set_disconnected_tracing (disconnected_tracing);
3231 set_circular_trace_buffer (char *args, int from_tty,
3232 struct cmd_list_element *c)
3234 target_set_circular_trace_buffer (circular_trace_buffer);
3238 set_trace_buffer_size (char *args, int from_tty,
3239 struct cmd_list_element *c)
3241 target_set_trace_buffer_size (trace_buffer_size);
3245 set_trace_user (char *args, int from_tty,
3246 struct cmd_list_element *c)
3250 ret = target_set_trace_notes (trace_user, NULL, NULL);
3253 warning (_("Target does not support trace notes, user ignored"));
3257 set_trace_notes (char *args, int from_tty,
3258 struct cmd_list_element *c)
3262 ret = target_set_trace_notes (NULL, trace_notes, NULL);
3265 warning (_("Target does not support trace notes, note ignored"));
3269 set_trace_stop_notes (char *args, int from_tty,
3270 struct cmd_list_element *c)
3274 ret = target_set_trace_notes (NULL, NULL, trace_stop_notes);
3277 warning (_("Target does not support trace notes, stop note ignored"));
3280 /* Convert the memory pointed to by mem into hex, placing result in buf.
3281 * Return a pointer to the last char put in buf (null)
3282 * "stolen" from sparc-stub.c
3285 static const char hexchars[] = "0123456789abcdef";
3288 mem2hex (gdb_byte *mem, char *buf, int count)
3296 *buf++ = hexchars[ch >> 4];
3297 *buf++ = hexchars[ch & 0xf];
3306 get_traceframe_number (void)
3308 return traceframe_number;
3311 /* Make the traceframe NUM be the current trace frame. Does nothing
3312 if NUM is already current. */
3315 set_current_traceframe (int num)
3319 if (traceframe_number == num)
3321 /* Nothing to do. */
3325 newnum = target_trace_find (tfind_number, num, 0, 0, NULL);
3328 warning (_("could not change traceframe"));
3330 set_traceframe_num (newnum);
3332 /* Changing the traceframe changes our view of registers and of the
3334 registers_changed ();
3336 clear_traceframe_info ();
3339 /* Make the traceframe NUM be the current trace frame, and do nothing
3343 set_traceframe_number (int num)
3345 traceframe_number = num;
3348 /* A cleanup used when switching away and back from tfind mode. */
3350 struct current_traceframe_cleanup
3352 /* The traceframe we were inspecting. */
3353 int traceframe_number;
3357 do_restore_current_traceframe_cleanup (void *arg)
3359 struct current_traceframe_cleanup *old = arg;
3361 set_current_traceframe (old->traceframe_number);
3365 restore_current_traceframe_cleanup_dtor (void *arg)
3367 struct current_traceframe_cleanup *old = arg;
3373 make_cleanup_restore_current_traceframe (void)
3375 struct current_traceframe_cleanup *old;
3377 old = xmalloc (sizeof (struct current_traceframe_cleanup));
3378 old->traceframe_number = traceframe_number;
3380 return make_cleanup_dtor (do_restore_current_traceframe_cleanup, old,
3381 restore_current_traceframe_cleanup_dtor);
3385 make_cleanup_restore_traceframe_number (void)
3387 return make_cleanup_restore_integer (&traceframe_number);
3390 /* Given a number and address, return an uploaded tracepoint with that
3391 number, creating if necessary. */
3393 struct uploaded_tp *
3394 get_uploaded_tp (int num, ULONGEST addr, struct uploaded_tp **utpp)
3396 struct uploaded_tp *utp;
3398 for (utp = *utpp; utp; utp = utp->next)
3399 if (utp->number == num && utp->addr == addr)
3401 utp = (struct uploaded_tp *) xmalloc (sizeof (struct uploaded_tp));
3402 memset (utp, 0, sizeof (struct uploaded_tp));
3405 utp->actions = NULL;
3406 utp->step_actions = NULL;
3407 utp->cmd_strings = NULL;
3414 free_uploaded_tps (struct uploaded_tp **utpp)
3416 struct uploaded_tp *next_one;
3420 next_one = (*utpp)->next;
3426 /* Given a number and address, return an uploaded tracepoint with that
3427 number, creating if necessary. */
3429 static struct uploaded_tsv *
3430 get_uploaded_tsv (int num, struct uploaded_tsv **utsvp)
3432 struct uploaded_tsv *utsv;
3434 for (utsv = *utsvp; utsv; utsv = utsv->next)
3435 if (utsv->number == num)
3437 utsv = (struct uploaded_tsv *) xmalloc (sizeof (struct uploaded_tsv));
3438 memset (utsv, 0, sizeof (struct uploaded_tsv));
3440 utsv->next = *utsvp;
3446 free_uploaded_tsvs (struct uploaded_tsv **utsvp)
3448 struct uploaded_tsv *next_one;
3452 next_one = (*utsvp)->next;
3458 /* FIXME this function is heuristic and will miss the cases where the
3459 conditional is semantically identical but differs in whitespace,
3460 such as "x == 0" vs "x==0". */
3463 cond_string_is_same (char *str1, char *str2)
3465 if (str1 == NULL || str2 == NULL)
3466 return (str1 == str2);
3468 return (strcmp (str1, str2) == 0);
3471 /* Look for an existing tracepoint that seems similar enough to the
3472 uploaded one. Enablement isn't compared, because the user can
3473 toggle that freely, and may have done so in anticipation of the
3474 next trace run. Return the location of matched tracepoint. */
3476 static struct bp_location *
3477 find_matching_tracepoint_location (struct uploaded_tp *utp)
3479 VEC(breakpoint_p) *tp_vec = all_tracepoints ();
3481 struct breakpoint *b;
3482 struct bp_location *loc;
3484 for (ix = 0; VEC_iterate (breakpoint_p, tp_vec, ix, b); ix++)
3486 struct tracepoint *t = (struct tracepoint *) b;
3488 if (b->type == utp->type
3489 && t->step_count == utp->step
3490 && t->pass_count == utp->pass
3491 && cond_string_is_same (t->base.cond_string, utp->cond_string)
3492 /* FIXME also test actions. */
3495 /* Scan the locations for an address match. */
3496 for (loc = b->loc; loc; loc = loc->next)
3498 if (loc->address == utp->addr)
3506 /* Given a list of tracepoints uploaded from a target, attempt to
3507 match them up with existing tracepoints, and create new ones if not
3511 merge_uploaded_tracepoints (struct uploaded_tp **uploaded_tps)
3513 struct uploaded_tp *utp;
3514 /* A set of tracepoints which are modified. */
3515 VEC(breakpoint_p) *modified_tp = NULL;
3517 struct breakpoint *b;
3519 /* Look for GDB tracepoints that match up with our uploaded versions. */
3520 for (utp = *uploaded_tps; utp; utp = utp->next)
3522 struct bp_location *loc;
3523 struct tracepoint *t;
3525 loc = find_matching_tracepoint_location (utp);
3530 /* Mark this location as already inserted. */
3532 t = (struct tracepoint *) loc->owner;
3533 printf_filtered (_("Assuming tracepoint %d is same "
3534 "as target's tracepoint %d at %s.\n"),
3535 loc->owner->number, utp->number,
3536 paddress (loc->gdbarch, utp->addr));
3538 /* The tracepoint LOC->owner was modified (the location LOC
3539 was marked as inserted in the target). Save it in
3540 MODIFIED_TP if not there yet. The 'breakpoint-modified'
3541 observers will be notified later once for each tracepoint
3542 saved in MODIFIED_TP. */
3544 VEC_iterate (breakpoint_p, modified_tp, ix, b);
3546 if (b == loc->owner)
3552 VEC_safe_push (breakpoint_p, modified_tp, loc->owner);
3556 t = create_tracepoint_from_upload (utp);
3558 printf_filtered (_("Created tracepoint %d for "
3559 "target's tracepoint %d at %s.\n"),
3560 t->base.number, utp->number,
3561 paddress (get_current_arch (), utp->addr));
3563 printf_filtered (_("Failed to create tracepoint for target's "
3564 "tracepoint %d at %s, skipping it.\n"),
3566 paddress (get_current_arch (), utp->addr));
3568 /* Whether found or created, record the number used by the
3569 target, to help with mapping target tracepoints back to their
3570 counterparts here. */
3572 t->number_on_target = utp->number;
3575 /* Notify 'breakpoint-modified' observer that at least one of B's
3576 locations was changed. */
3577 for (ix = 0; VEC_iterate (breakpoint_p, modified_tp, ix, b); ix++)
3578 observer_notify_breakpoint_modified (b);
3580 VEC_free (breakpoint_p, modified_tp);
3581 free_uploaded_tps (uploaded_tps);
3584 /* Trace state variables don't have much to identify them beyond their
3585 name, so just use that to detect matches. */
3587 static struct trace_state_variable *
3588 find_matching_tsv (struct uploaded_tsv *utsv)
3593 return find_trace_state_variable (utsv->name);
3596 static struct trace_state_variable *
3597 create_tsv_from_upload (struct uploaded_tsv *utsv)
3599 const char *namebase;
3602 struct trace_state_variable *tsv;
3603 struct cleanup *old_chain;
3607 namebase = utsv->name;
3608 buf = xstrprintf ("%s", namebase);
3613 buf = xstrprintf ("%s_%d", namebase, try_num++);
3616 /* Fish for a name that is not in use. */
3617 /* (should check against all internal vars?) */
3618 while (find_trace_state_variable (buf))
3621 buf = xstrprintf ("%s_%d", namebase, try_num++);
3624 old_chain = make_cleanup (xfree, buf);
3626 /* We have an available name, create the variable. */
3627 tsv = create_trace_state_variable (buf);
3628 tsv->initial_value = utsv->initial_value;
3629 tsv->builtin = utsv->builtin;
3631 observer_notify_tsv_created (tsv);
3633 do_cleanups (old_chain);
3638 /* Given a list of uploaded trace state variables, try to match them
3639 up with existing variables, or create additional ones. */
3642 merge_uploaded_trace_state_variables (struct uploaded_tsv **uploaded_tsvs)
3645 struct uploaded_tsv *utsv;
3646 struct trace_state_variable *tsv;
3649 /* Most likely some numbers will have to be reassigned as part of
3650 the merge, so clear them all in anticipation. */
3651 for (ix = 0; VEC_iterate (tsv_s, tvariables, ix, tsv); ++ix)
3654 for (utsv = *uploaded_tsvs; utsv; utsv = utsv->next)
3656 tsv = find_matching_tsv (utsv);
3660 printf_filtered (_("Assuming trace state variable $%s "
3661 "is same as target's variable %d.\n"),
3662 tsv->name, utsv->number);
3666 tsv = create_tsv_from_upload (utsv);
3668 printf_filtered (_("Created trace state variable "
3669 "$%s for target's variable %d.\n"),
3670 tsv->name, utsv->number);
3672 /* Give precedence to numberings that come from the target. */
3674 tsv->number = utsv->number;
3677 /* Renumber everything that didn't get a target-assigned number. */
3679 for (ix = 0; VEC_iterate (tsv_s, tvariables, ix, tsv); ++ix)
3680 if (tsv->number > highest)
3681 highest = tsv->number;
3684 for (ix = 0; VEC_iterate (tsv_s, tvariables, ix, tsv); ++ix)
3685 if (tsv->number == 0)
3686 tsv->number = highest++;
3688 free_uploaded_tsvs (uploaded_tsvs);
3691 /* target tfile command */
3693 static struct target_ops tfile_ops;
3695 /* Fill in tfile_ops with its defined operations and properties. */
3697 #define TRACE_HEADER_SIZE 8
3699 static char *trace_filename;
3700 static int trace_fd = -1;
3701 static off_t trace_frames_offset;
3702 static off_t cur_offset;
3703 static int cur_data_size;
3704 int trace_regblock_size;
3706 static void tfile_interp_line (char *line,
3707 struct uploaded_tp **utpp,
3708 struct uploaded_tsv **utsvp);
3710 /* Read SIZE bytes into READBUF from the trace frame, starting at
3711 TRACE_FD's current position. Note that this call `read'
3712 underneath, hence it advances the file's seek position. Throws an
3713 error if the `read' syscall fails, or less than SIZE bytes are
3717 tfile_read (gdb_byte *readbuf, int size)
3721 gotten = read (trace_fd, readbuf, size);
3723 perror_with_name (trace_filename);
3724 else if (gotten < size)
3725 error (_("Premature end of file while reading trace file"));
3729 tfile_open (char *filename, int from_tty)
3731 volatile struct gdb_exception ex;
3733 struct cleanup *old_chain;
3736 char header[TRACE_HEADER_SIZE];
3737 char linebuf[1000]; /* Should be max remote packet size or so. */
3740 struct trace_status *ts;
3741 struct uploaded_tp *uploaded_tps = NULL;
3742 struct uploaded_tsv *uploaded_tsvs = NULL;
3744 target_preopen (from_tty);
3746 error (_("No trace file specified."));
3748 filename = tilde_expand (filename);
3749 if (!IS_ABSOLUTE_PATH(filename))
3751 temp = concat (current_directory, "/", filename, (char *) NULL);
3756 old_chain = make_cleanup (xfree, filename);
3758 flags = O_BINARY | O_LARGEFILE;
3760 scratch_chan = open (filename, flags, 0);
3761 if (scratch_chan < 0)
3762 perror_with_name (filename);
3764 /* Looks semi-reasonable. Toss the old trace file and work on the new. */
3766 discard_cleanups (old_chain); /* Don't free filename any more. */
3767 unpush_target (&tfile_ops);
3769 trace_filename = xstrdup (filename);
3770 trace_fd = scratch_chan;
3773 /* Read the file header and test for validity. */
3774 tfile_read ((gdb_byte *) &header, TRACE_HEADER_SIZE);
3776 bytes += TRACE_HEADER_SIZE;
3777 if (!(header[0] == 0x7f
3778 && (strncmp (header + 1, "TRACE0\n", 7) == 0)))
3779 error (_("File is not a valid trace file."));
3781 push_target (&tfile_ops);
3783 trace_regblock_size = 0;
3784 ts = current_trace_status ();
3785 /* We know we're working with a file. Record its name. */
3786 ts->filename = trace_filename;
3787 /* Set defaults in case there is no status line. */
3788 ts->running_known = 0;
3789 ts->stop_reason = trace_stop_reason_unknown;
3790 ts->traceframe_count = -1;
3791 ts->buffer_free = 0;
3792 ts->disconnected_tracing = 0;
3793 ts->circular_buffer = 0;
3795 TRY_CATCH (ex, RETURN_MASK_ALL)
3797 /* Read through a section of newline-terminated lines that
3798 define things like tracepoints. */
3802 tfile_read (&byte, 1);
3807 /* Empty line marks end of the definition section. */
3812 tfile_interp_line (linebuf, &uploaded_tps, &uploaded_tsvs);
3815 linebuf[i++] = byte;
3817 error (_("Excessively long lines in trace file"));
3820 /* Record the starting offset of the binary trace data. */
3821 trace_frames_offset = bytes;
3823 /* If we don't have a blocksize, we can't interpret the
3825 if (trace_regblock_size == 0)
3826 error (_("No register block size recorded in trace file"));
3830 /* Pop the partially set up target. */
3832 throw_exception (ex);
3835 inferior_appeared (current_inferior (), TFILE_PID);
3836 inferior_ptid = pid_to_ptid (TFILE_PID);
3837 add_thread_silent (inferior_ptid);
3839 if (ts->traceframe_count <= 0)
3840 warning (_("No traceframes present in this file."));
3842 /* Add the file's tracepoints and variables into the current mix. */
3844 /* Get trace state variables first, they may be checked when parsing
3845 uploaded commands. */
3846 merge_uploaded_trace_state_variables (&uploaded_tsvs);
3848 merge_uploaded_tracepoints (&uploaded_tps);
3850 post_create_inferior (&tfile_ops, from_tty);
3853 /* Interpret the given line from the definitions part of the trace
3857 tfile_interp_line (char *line,
3858 struct uploaded_tp **utpp, struct uploaded_tsv **utsvp)
3862 if (strncmp (p, "R ", strlen ("R ")) == 0)
3865 trace_regblock_size = strtol (p, &p, 16);
3867 else if (strncmp (p, "status ", strlen ("status ")) == 0)
3869 p += strlen ("status ");
3870 parse_trace_status (p, current_trace_status ());
3872 else if (strncmp (p, "tp ", strlen ("tp ")) == 0)
3874 p += strlen ("tp ");
3875 parse_tracepoint_definition (p, utpp);
3877 else if (strncmp (p, "tsv ", strlen ("tsv ")) == 0)
3879 p += strlen ("tsv ");
3880 parse_tsv_definition (p, utsvp);
3883 warning (_("Ignoring trace file definition \"%s\""), line);
3886 /* Parse the part of trace status syntax that is shared between
3887 the remote protocol and the trace file reader. */
3890 parse_trace_status (char *line, struct trace_status *ts)
3892 char *p = line, *p1, *p2, *p3, *p_temp;
3896 ts->running_known = 1;
3897 ts->running = (*p++ == '1');
3898 ts->stop_reason = trace_stop_reason_unknown;
3899 xfree (ts->stop_desc);
3900 ts->stop_desc = NULL;
3901 ts->traceframe_count = -1;
3902 ts->traceframes_created = -1;
3903 ts->buffer_free = -1;
3904 ts->buffer_size = -1;
3905 ts->disconnected_tracing = 0;
3906 ts->circular_buffer = 0;
3907 xfree (ts->user_name);
3908 ts->user_name = NULL;
3911 ts->start_time = ts->stop_time = 0;
3915 p1 = strchr (p, ':');
3917 error (_("Malformed trace status, at %s\n\
3918 Status line: '%s'\n"), p, line);
3919 p3 = strchr (p, ';');
3921 p3 = p + strlen (p);
3922 if (strncmp (p, stop_reason_names[trace_buffer_full], p1 - p) == 0)
3924 p = unpack_varlen_hex (++p1, &val);
3925 ts->stop_reason = trace_buffer_full;
3927 else if (strncmp (p, stop_reason_names[trace_never_run], p1 - p) == 0)
3929 p = unpack_varlen_hex (++p1, &val);
3930 ts->stop_reason = trace_never_run;
3932 else if (strncmp (p, stop_reason_names[tracepoint_passcount],
3935 p = unpack_varlen_hex (++p1, &val);
3936 ts->stop_reason = tracepoint_passcount;
3937 ts->stopping_tracepoint = val;
3939 else if (strncmp (p, stop_reason_names[tstop_command], p1 - p) == 0)
3941 p2 = strchr (++p1, ':');
3949 ts->stop_desc = xmalloc (strlen (line));
3950 end = hex2bin (p1, ts->stop_desc, (p2 - p1) / 2);
3951 ts->stop_desc[end] = '\0';
3954 ts->stop_desc = xstrdup ("");
3956 p = unpack_varlen_hex (++p2, &val);
3957 ts->stop_reason = tstop_command;
3959 else if (strncmp (p, stop_reason_names[trace_disconnected], p1 - p) == 0)
3961 p = unpack_varlen_hex (++p1, &val);
3962 ts->stop_reason = trace_disconnected;
3964 else if (strncmp (p, stop_reason_names[tracepoint_error], p1 - p) == 0)
3966 p2 = strchr (++p1, ':');
3969 ts->stop_desc = xmalloc ((p2 - p1) / 2 + 1);
3970 end = hex2bin (p1, ts->stop_desc, (p2 - p1) / 2);
3971 ts->stop_desc[end] = '\0';
3974 ts->stop_desc = xstrdup ("");
3976 p = unpack_varlen_hex (++p2, &val);
3977 ts->stopping_tracepoint = val;
3978 ts->stop_reason = tracepoint_error;
3980 else if (strncmp (p, "tframes", p1 - p) == 0)
3982 p = unpack_varlen_hex (++p1, &val);
3983 ts->traceframe_count = val;
3985 else if (strncmp (p, "tcreated", p1 - p) == 0)
3987 p = unpack_varlen_hex (++p1, &val);
3988 ts->traceframes_created = val;
3990 else if (strncmp (p, "tfree", p1 - p) == 0)
3992 p = unpack_varlen_hex (++p1, &val);
3993 ts->buffer_free = val;
3995 else if (strncmp (p, "tsize", p1 - p) == 0)
3997 p = unpack_varlen_hex (++p1, &val);
3998 ts->buffer_size = val;
4000 else if (strncmp (p, "disconn", p1 - p) == 0)
4002 p = unpack_varlen_hex (++p1, &val);
4003 ts->disconnected_tracing = val;
4005 else if (strncmp (p, "circular", p1 - p) == 0)
4007 p = unpack_varlen_hex (++p1, &val);
4008 ts->circular_buffer = val;
4010 else if (strncmp (p, "starttime", p1 - p) == 0)
4012 p = unpack_varlen_hex (++p1, &val);
4013 ts->start_time = val;
4015 else if (strncmp (p, "stoptime", p1 - p) == 0)
4017 p = unpack_varlen_hex (++p1, &val);
4018 ts->stop_time = val;
4020 else if (strncmp (p, "username", p1 - p) == 0)
4023 ts->user_name = xmalloc (strlen (p) / 2);
4024 end = hex2bin (p1, ts->user_name, (p3 - p1) / 2);
4025 ts->user_name[end] = '\0';
4028 else if (strncmp (p, "notes", p1 - p) == 0)
4031 ts->notes = xmalloc (strlen (p) / 2);
4032 end = hex2bin (p1, ts->notes, (p3 - p1) / 2);
4033 ts->notes[end] = '\0';
4038 /* Silently skip unknown optional info. */
4039 p_temp = strchr (p1 + 1, ';');
4043 /* Must be at the end. */
4050 parse_tracepoint_status (char *p, struct breakpoint *bp,
4051 struct uploaded_tp *utp)
4054 struct tracepoint *tp = (struct tracepoint *) bp;
4056 p = unpack_varlen_hex (p, &uval);
4058 tp->base.hit_count += uval;
4060 utp->hit_count += uval;
4061 p = unpack_varlen_hex (p + 1, &uval);
4063 tp->traceframe_usage += uval;
4065 utp->traceframe_usage += uval;
4066 /* Ignore any extra, allowing for future extensions. */
4069 /* Given a line of text defining a part of a tracepoint, parse it into
4070 an "uploaded tracepoint". */
4073 parse_tracepoint_definition (char *line, struct uploaded_tp **utpp)
4077 ULONGEST num, addr, step, pass, orig_size, xlen, start;
4080 char *cond, *srctype, *buf;
4081 struct uploaded_tp *utp = NULL;
4084 /* Both tracepoint and action definitions start with the same number
4085 and address sequence. */
4087 p = unpack_varlen_hex (p, &num);
4088 p++; /* skip a colon */
4089 p = unpack_varlen_hex (p, &addr);
4090 p++; /* skip a colon */
4093 enabled = (*p++ == 'E');
4094 p++; /* skip a colon */
4095 p = unpack_varlen_hex (p, &step);
4096 p++; /* skip a colon */
4097 p = unpack_varlen_hex (p, &pass);
4098 type = bp_tracepoint;
4100 /* Thumb through optional fields. */
4103 p++; /* skip a colon */
4106 type = bp_fast_tracepoint;
4108 p = unpack_varlen_hex (p, &orig_size);
4112 type = bp_static_tracepoint;
4118 p = unpack_varlen_hex (p, &xlen);
4119 p++; /* skip a comma */
4120 cond = (char *) xmalloc (2 * xlen + 1);
4121 strncpy (cond, p, 2 * xlen);
4122 cond[2 * xlen] = '\0';
4126 warning (_("Unrecognized char '%c' in tracepoint "
4127 "definition, skipping rest"), *p);
4129 utp = get_uploaded_tp (num, addr, utpp);
4131 utp->enabled = enabled;
4136 else if (piece == 'A')
4138 utp = get_uploaded_tp (num, addr, utpp);
4139 VEC_safe_push (char_ptr, utp->actions, xstrdup (p));
4141 else if (piece == 'S')
4143 utp = get_uploaded_tp (num, addr, utpp);
4144 VEC_safe_push (char_ptr, utp->step_actions, xstrdup (p));
4146 else if (piece == 'Z')
4148 /* Parse a chunk of source form definition. */
4149 utp = get_uploaded_tp (num, addr, utpp);
4151 p = strchr (p, ':');
4152 p++; /* skip a colon */
4153 p = unpack_varlen_hex (p, &start);
4154 p++; /* skip a colon */
4155 p = unpack_varlen_hex (p, &xlen);
4156 p++; /* skip a colon */
4158 buf = alloca (strlen (line));
4160 end = hex2bin (p, (gdb_byte *) buf, strlen (p) / 2);
4163 if (strncmp (srctype, "at:", strlen ("at:")) == 0)
4164 utp->at_string = xstrdup (buf);
4165 else if (strncmp (srctype, "cond:", strlen ("cond:")) == 0)
4166 utp->cond_string = xstrdup (buf);
4167 else if (strncmp (srctype, "cmd:", strlen ("cmd:")) == 0)
4168 VEC_safe_push (char_ptr, utp->cmd_strings, xstrdup (buf));
4170 else if (piece == 'V')
4172 utp = get_uploaded_tp (num, addr, utpp);
4174 parse_tracepoint_status (p, NULL, utp);
4178 /* Don't error out, the target might be sending us optional
4179 info that we don't care about. */
4180 warning (_("Unrecognized tracepoint piece '%c', ignoring"), piece);
4184 /* Convert a textual description of a trace state variable into an
4188 parse_tsv_definition (char *line, struct uploaded_tsv **utsvp)
4191 ULONGEST num, initval, builtin;
4193 struct uploaded_tsv *utsv = NULL;
4195 buf = alloca (strlen (line));
4198 p = unpack_varlen_hex (p, &num);
4199 p++; /* skip a colon */
4200 p = unpack_varlen_hex (p, &initval);
4201 p++; /* skip a colon */
4202 p = unpack_varlen_hex (p, &builtin);
4203 p++; /* skip a colon */
4204 end = hex2bin (p, (gdb_byte *) buf, strlen (p) / 2);
4207 utsv = get_uploaded_tsv (num, utsvp);
4208 utsv->initial_value = initval;
4209 utsv->builtin = builtin;
4210 utsv->name = xstrdup (buf);
4213 /* Close the trace file and generally clean up. */
4216 tfile_close (int quitting)
4223 pid = ptid_get_pid (inferior_ptid);
4224 inferior_ptid = null_ptid; /* Avoid confusion from thread stuff. */
4225 exit_inferior_silent (pid);
4229 xfree (trace_filename);
4230 trace_filename = NULL;
4234 tfile_files_info (struct target_ops *t)
4236 printf_filtered ("\t`%s'\n", trace_filename);
4239 /* The trace status for a file is that tracing can never be run. */
4242 tfile_get_trace_status (struct trace_status *ts)
4244 /* Other bits of trace status were collected as part of opening the
4245 trace files, so nothing to do here. */
4251 tfile_get_tracepoint_status (struct breakpoint *tp, struct uploaded_tp *utp)
4253 /* Other bits of trace status were collected as part of opening the
4254 trace files, so nothing to do here. */
4257 /* Given the position of a traceframe in the file, figure out what
4258 address the frame was collected at. This would normally be the
4259 value of a collected PC register, but if not available, we
4263 tfile_get_traceframe_address (off_t tframe_offset)
4267 struct tracepoint *tp;
4268 off_t saved_offset = cur_offset;
4270 /* FIXME dig pc out of collected registers. */
4272 /* Fall back to using tracepoint address. */
4273 lseek (trace_fd, tframe_offset, SEEK_SET);
4274 tfile_read ((gdb_byte *) &tpnum, 2);
4275 tpnum = (short) extract_signed_integer ((gdb_byte *) &tpnum, 2,
4277 (target_gdbarch ()));
4279 tp = get_tracepoint_by_number_on_target (tpnum);
4280 /* FIXME this is a poor heuristic if multiple locations. */
4281 if (tp && tp->base.loc)
4282 addr = tp->base.loc->address;
4284 /* Restore our seek position. */
4285 cur_offset = saved_offset;
4286 lseek (trace_fd, cur_offset, SEEK_SET);
4290 /* Given a type of search and some parameters, scan the collection of
4291 traceframes in the file looking for a match. When found, return
4292 both the traceframe and tracepoint number, otherwise -1 for
4296 tfile_trace_find (enum trace_find_type type, int num,
4297 ULONGEST addr1, ULONGEST addr2, int *tpp)
4300 int tfnum = 0, found = 0;
4301 unsigned int data_size;
4302 struct tracepoint *tp;
4303 off_t offset, tframe_offset;
4313 lseek (trace_fd, trace_frames_offset, SEEK_SET);
4314 offset = trace_frames_offset;
4317 tframe_offset = offset;
4318 tfile_read ((gdb_byte *) &tpnum, 2);
4319 tpnum = (short) extract_signed_integer ((gdb_byte *) &tpnum, 2,
4321 (target_gdbarch ()));
4325 tfile_read ((gdb_byte *) &data_size, 4);
4326 data_size = (unsigned int) extract_unsigned_integer
4327 ((gdb_byte *) &data_size, 4,
4328 gdbarch_byte_order (target_gdbarch ()));
4331 if (type == tfind_number)
4333 /* Looking for a specific trace frame. */
4339 /* Start from the _next_ trace frame. */
4340 if (tfnum > traceframe_number)
4345 tfaddr = tfile_get_traceframe_address (tframe_offset);
4346 if (tfaddr == addr1)
4350 tp = get_tracepoint (num);
4351 if (tp && tpnum == tp->number_on_target)
4355 tfaddr = tfile_get_traceframe_address (tframe_offset);
4356 if (addr1 <= tfaddr && tfaddr <= addr2)
4360 tfaddr = tfile_get_traceframe_address (tframe_offset);
4361 if (!(addr1 <= tfaddr && tfaddr <= addr2))
4365 internal_error (__FILE__, __LINE__, _("unknown tfind type"));
4374 cur_offset = offset;
4375 cur_data_size = data_size;
4379 /* Skip past the traceframe's data. */
4380 lseek (trace_fd, data_size, SEEK_CUR);
4381 offset += data_size;
4382 /* Update our own count of traceframes. */
4385 /* Did not find what we were looking for. */
4391 /* Prototype of the callback passed to tframe_walk_blocks. */
4392 typedef int (*walk_blocks_callback_func) (char blocktype, void *data);
4394 /* Callback for traceframe_walk_blocks, used to find a given block
4395 type in a traceframe. */
4398 match_blocktype (char blocktype, void *data)
4400 char *wantedp = data;
4402 if (*wantedp == blocktype)
4408 /* Walk over all traceframe block starting at POS offset from
4409 CUR_OFFSET, and call CALLBACK for each block found, passing in DATA
4410 unmodified. If CALLBACK returns true, this returns the position in
4411 the traceframe where the block is found, relative to the start of
4412 the traceframe (cur_offset). Returns -1 if no callback call
4413 returned true, indicating that all blocks have been walked. */
4416 traceframe_walk_blocks (walk_blocks_callback_func callback,
4417 int pos, void *data)
4419 /* Iterate through a traceframe's blocks, looking for a block of the
4422 lseek (trace_fd, cur_offset + pos, SEEK_SET);
4423 while (pos < cur_data_size)
4425 unsigned short mlen;
4428 tfile_read (&block_type, 1);
4432 if ((*callback) (block_type, data))
4438 lseek (trace_fd, cur_offset + pos + trace_regblock_size, SEEK_SET);
4439 pos += trace_regblock_size;
4442 lseek (trace_fd, cur_offset + pos + 8, SEEK_SET);
4443 tfile_read ((gdb_byte *) &mlen, 2);
4444 mlen = (unsigned short)
4445 extract_unsigned_integer ((gdb_byte *) &mlen, 2,
4447 (target_gdbarch ()));
4448 lseek (trace_fd, mlen, SEEK_CUR);
4449 pos += (8 + 2 + mlen);
4452 lseek (trace_fd, cur_offset + pos + 4 + 8, SEEK_SET);
4456 error (_("Unknown block type '%c' (0x%x) in trace frame"),
4457 block_type, block_type);
4465 /* Convenience wrapper around traceframe_walk_blocks. Looks for the
4466 position offset of a block of type TYPE_WANTED in the current trace
4467 frame, starting at POS. Returns -1 if no such block was found. */
4470 traceframe_find_block_type (char type_wanted, int pos)
4472 return traceframe_walk_blocks (match_blocktype, pos, &type_wanted);
4475 /* Look for a block of saved registers in the traceframe, and get the
4476 requested register from it. */
4479 tfile_fetch_registers (struct target_ops *ops,
4480 struct regcache *regcache, int regno)
4482 struct gdbarch *gdbarch = get_regcache_arch (regcache);
4483 int offset, regn, regsize, pc_regno;
4486 /* An uninitialized reg size says we're not going to be
4487 successful at getting register blocks. */
4488 if (!trace_regblock_size)
4491 regs = alloca (trace_regblock_size);
4493 if (traceframe_find_block_type ('R', 0) >= 0)
4495 tfile_read (regs, trace_regblock_size);
4497 /* Assume the block is laid out in GDB register number order,
4498 each register with the size that it has in GDB. */
4500 for (regn = 0; regn < gdbarch_num_regs (gdbarch); regn++)
4502 regsize = register_size (gdbarch, regn);
4503 /* Make sure we stay within block bounds. */
4504 if (offset + regsize >= trace_regblock_size)
4506 if (regcache_register_status (regcache, regn) == REG_UNKNOWN)
4510 regcache_raw_supply (regcache, regno, regs + offset);
4513 else if (regno == -1)
4515 regcache_raw_supply (regcache, regn, regs + offset);
4523 /* We get here if no register data has been found. Mark registers
4525 for (regn = 0; regn < gdbarch_num_regs (gdbarch); regn++)
4526 regcache_raw_supply (regcache, regn, NULL);
4528 /* We can often usefully guess that the PC is going to be the same
4529 as the address of the tracepoint. */
4530 pc_regno = gdbarch_pc_regnum (gdbarch);
4531 if (pc_regno >= 0 && (regno == -1 || regno == pc_regno))
4533 struct tracepoint *tp = get_tracepoint (tracepoint_number);
4535 if (tp && tp->base.loc)
4537 /* But don't try to guess if tracepoint is multi-location... */
4538 if (tp->base.loc->next)
4540 warning (_("Tracepoint %d has multiple "
4541 "locations, cannot infer $pc"),
4545 /* ... or does while-stepping. */
4546 if (tp->step_count > 0)
4548 warning (_("Tracepoint %d does while-stepping, "
4549 "cannot infer $pc"),
4554 store_unsigned_integer (regs, register_size (gdbarch, pc_regno),
4555 gdbarch_byte_order (gdbarch),
4556 tp->base.loc->address);
4557 regcache_raw_supply (regcache, pc_regno, regs);
4563 tfile_xfer_partial (struct target_ops *ops, enum target_object object,
4564 const char *annex, gdb_byte *readbuf,
4565 const gdb_byte *writebuf, ULONGEST offset, LONGEST len)
4567 /* We're only doing regular memory for now. */
4568 if (object != TARGET_OBJECT_MEMORY)
4571 if (readbuf == NULL)
4572 error (_("tfile_xfer_partial: trace file is read-only"));
4574 if (traceframe_number != -1)
4578 /* Iterate through the traceframe's blocks, looking for
4580 while ((pos = traceframe_find_block_type ('M', pos)) >= 0)
4582 ULONGEST maddr, amt;
4583 unsigned short mlen;
4584 enum bfd_endian byte_order = gdbarch_byte_order (target_gdbarch ());
4586 tfile_read ((gdb_byte *) &maddr, 8);
4587 maddr = extract_unsigned_integer ((gdb_byte *) &maddr, 8,
4589 tfile_read ((gdb_byte *) &mlen, 2);
4590 mlen = (unsigned short)
4591 extract_unsigned_integer ((gdb_byte *) &mlen, 2, byte_order);
4593 /* If the block includes the first part of the desired
4594 range, return as much it has; GDB will re-request the
4595 remainder, which might be in a different block of this
4597 if (maddr <= offset && offset < (maddr + mlen))
4599 amt = (maddr + mlen) - offset;
4603 if (maddr != offset)
4604 lseek (trace_fd, offset - maddr, SEEK_CUR);
4605 tfile_read (readbuf, amt);
4609 /* Skip over this block. */
4610 pos += (8 + 2 + mlen);
4614 /* It's unduly pedantic to refuse to look at the executable for
4615 read-only pieces; so do the equivalent of readonly regions aka
4617 /* FIXME account for relocation at some point. */
4624 for (s = exec_bfd->sections; s; s = s->next)
4626 if ((s->flags & SEC_LOAD) == 0
4627 || (s->flags & SEC_READONLY) == 0)
4631 size = bfd_get_section_size (s);
4632 if (vma <= offset && offset < (vma + size))
4636 amt = (vma + size) - offset;
4640 amt = bfd_get_section_contents (exec_bfd, s,
4641 readbuf, offset - vma, amt);
4647 /* Indicate failure to find the requested memory block. */
4651 /* Iterate through the blocks of a trace frame, looking for a 'V'
4652 block with a matching tsv number. */
4655 tfile_get_trace_state_variable_value (int tsvnum, LONGEST *val)
4660 while ((pos = traceframe_find_block_type ('V', pos)) >= 0)
4664 tfile_read ((gdb_byte *) &vnum, 4);
4665 vnum = (int) extract_signed_integer ((gdb_byte *) &vnum, 4,
4667 (target_gdbarch ()));
4670 tfile_read ((gdb_byte *) val, 8);
4671 *val = extract_signed_integer ((gdb_byte *) val, 8,
4673 (target_gdbarch ()));
4679 /* Didn't find anything. */
4684 tfile_has_all_memory (struct target_ops *ops)
4690 tfile_has_memory (struct target_ops *ops)
4696 tfile_has_stack (struct target_ops *ops)
4698 return traceframe_number != -1;
4702 tfile_has_registers (struct target_ops *ops)
4704 return traceframe_number != -1;
4708 tfile_thread_alive (struct target_ops *ops, ptid_t ptid)
4713 /* Callback for traceframe_walk_blocks. Builds a traceframe_info
4714 object for the tfile target's current traceframe. */
4717 build_traceframe_info (char blocktype, void *data)
4719 struct traceframe_info *info = data;
4725 struct mem_range *r;
4727 unsigned short mlen;
4729 tfile_read ((gdb_byte *) &maddr, 8);
4730 maddr = extract_unsigned_integer ((gdb_byte *) &maddr, 8,
4732 (target_gdbarch ()));
4733 tfile_read ((gdb_byte *) &mlen, 2);
4734 mlen = (unsigned short)
4735 extract_unsigned_integer ((gdb_byte *) &mlen,
4736 2, gdbarch_byte_order
4737 (target_gdbarch ()));
4739 r = VEC_safe_push (mem_range_s, info->memory, NULL);
4752 warning (_("Unhandled trace block type (%d) '%c ' "
4753 "while building trace frame info."),
4754 blocktype, blocktype);
4761 static struct traceframe_info *
4762 tfile_traceframe_info (void)
4764 struct traceframe_info *info = XCNEW (struct traceframe_info);
4766 traceframe_walk_blocks (build_traceframe_info, 0, info);
4771 init_tfile_ops (void)
4773 tfile_ops.to_shortname = "tfile";
4774 tfile_ops.to_longname = "Local trace dump file";
4776 = "Use a trace file as a target. Specify the filename of the trace file.";
4777 tfile_ops.to_open = tfile_open;
4778 tfile_ops.to_close = tfile_close;
4779 tfile_ops.to_fetch_registers = tfile_fetch_registers;
4780 tfile_ops.to_xfer_partial = tfile_xfer_partial;
4781 tfile_ops.to_files_info = tfile_files_info;
4782 tfile_ops.to_get_trace_status = tfile_get_trace_status;
4783 tfile_ops.to_get_tracepoint_status = tfile_get_tracepoint_status;
4784 tfile_ops.to_trace_find = tfile_trace_find;
4785 tfile_ops.to_get_trace_state_variable_value
4786 = tfile_get_trace_state_variable_value;
4787 tfile_ops.to_stratum = process_stratum;
4788 tfile_ops.to_has_all_memory = tfile_has_all_memory;
4789 tfile_ops.to_has_memory = tfile_has_memory;
4790 tfile_ops.to_has_stack = tfile_has_stack;
4791 tfile_ops.to_has_registers = tfile_has_registers;
4792 tfile_ops.to_traceframe_info = tfile_traceframe_info;
4793 tfile_ops.to_thread_alive = tfile_thread_alive;
4794 tfile_ops.to_magic = OPS_MAGIC;
4798 free_current_marker (void *arg)
4800 struct static_tracepoint_marker **marker_p = arg;
4802 if (*marker_p != NULL)
4804 release_static_tracepoint_marker (*marker_p);
4811 /* Given a line of text defining a static tracepoint marker, parse it
4812 into a "static tracepoint marker" object. Throws an error is
4813 parsing fails. If PP is non-null, it points to one past the end of
4814 the parsed marker definition. */
4817 parse_static_tracepoint_marker_definition (char *line, char **pp,
4818 struct static_tracepoint_marker *marker)
4825 p = unpack_varlen_hex (p, &addr);
4826 p++; /* skip a colon */
4828 marker->gdbarch = target_gdbarch ();
4829 marker->address = (CORE_ADDR) addr;
4831 endp = strchr (p, ':');
4833 error (_("bad marker definition: %s"), line);
4835 marker->str_id = xmalloc (endp - p + 1);
4836 end = hex2bin (p, (gdb_byte *) marker->str_id, (endp - p + 1) / 2);
4837 marker->str_id[end] = '\0';
4840 p++; /* skip a colon */
4842 marker->extra = xmalloc (strlen (p) + 1);
4843 end = hex2bin (p, (gdb_byte *) marker->extra, strlen (p) / 2);
4844 marker->extra[end] = '\0';
4850 /* Release a static tracepoint marker's contents. Note that the
4851 object itself isn't released here. There objects are usually on
4855 release_static_tracepoint_marker (struct static_tracepoint_marker *marker)
4857 xfree (marker->str_id);
4858 marker->str_id = NULL;
4861 /* Print MARKER to gdb_stdout. */
4864 print_one_static_tracepoint_marker (int count,
4865 struct static_tracepoint_marker *marker)
4867 struct command_line *l;
4870 char wrap_indent[80];
4871 char extra_field_indent[80];
4872 struct ui_out *uiout = current_uiout;
4873 struct cleanup *bkpt_chain;
4874 VEC(breakpoint_p) *tracepoints;
4876 struct symtab_and_line sal;
4880 sal.pc = marker->address;
4882 tracepoints = static_tracepoints_here (marker->address);
4884 bkpt_chain = make_cleanup_ui_out_tuple_begin_end (uiout, "marker");
4886 /* A counter field to help readability. This is not a stable
4888 ui_out_field_int (uiout, "count", count);
4890 ui_out_field_string (uiout, "marker-id", marker->str_id);
4892 ui_out_field_fmt (uiout, "enabled", "%c",
4893 !VEC_empty (breakpoint_p, tracepoints) ? 'y' : 'n');
4894 ui_out_spaces (uiout, 2);
4896 strcpy (wrap_indent, " ");
4898 if (gdbarch_addr_bit (marker->gdbarch) <= 32)
4899 strcat (wrap_indent, " ");
4901 strcat (wrap_indent, " ");
4903 strcpy (extra_field_indent, " ");
4905 ui_out_field_core_addr (uiout, "addr", marker->gdbarch, marker->address);
4907 sal = find_pc_line (marker->address, 0);
4908 sym = find_pc_sect_function (marker->address, NULL);
4911 ui_out_text (uiout, "in ");
4912 ui_out_field_string (uiout, "func",
4913 SYMBOL_PRINT_NAME (sym));
4914 ui_out_wrap_hint (uiout, wrap_indent);
4915 ui_out_text (uiout, " at ");
4918 ui_out_field_skip (uiout, "func");
4920 if (sal.symtab != NULL)
4922 ui_out_field_string (uiout, "file",
4923 symtab_to_filename_for_display (sal.symtab));
4924 ui_out_text (uiout, ":");
4926 if (ui_out_is_mi_like_p (uiout))
4928 const char *fullname = symtab_to_fullname (sal.symtab);
4930 ui_out_field_string (uiout, "fullname", fullname);
4933 ui_out_field_skip (uiout, "fullname");
4935 ui_out_field_int (uiout, "line", sal.line);
4939 ui_out_field_skip (uiout, "fullname");
4940 ui_out_field_skip (uiout, "line");
4943 ui_out_text (uiout, "\n");
4944 ui_out_text (uiout, extra_field_indent);
4945 ui_out_text (uiout, _("Data: \""));
4946 ui_out_field_string (uiout, "extra-data", marker->extra);
4947 ui_out_text (uiout, "\"\n");
4949 if (!VEC_empty (breakpoint_p, tracepoints))
4951 struct cleanup *cleanup_chain;
4953 struct breakpoint *b;
4955 cleanup_chain = make_cleanup_ui_out_tuple_begin_end (uiout,
4958 ui_out_text (uiout, extra_field_indent);
4959 ui_out_text (uiout, _("Probed by static tracepoints: "));
4960 for (ix = 0; VEC_iterate(breakpoint_p, tracepoints, ix, b); ix++)
4963 ui_out_text (uiout, ", ");
4964 ui_out_text (uiout, "#");
4965 ui_out_field_int (uiout, "tracepoint-id", b->number);
4968 do_cleanups (cleanup_chain);
4970 if (ui_out_is_mi_like_p (uiout))
4971 ui_out_field_int (uiout, "number-of-tracepoints",
4972 VEC_length(breakpoint_p, tracepoints));
4974 ui_out_text (uiout, "\n");
4976 VEC_free (breakpoint_p, tracepoints);
4978 do_cleanups (bkpt_chain);
4982 info_static_tracepoint_markers_command (char *arg, int from_tty)
4984 VEC(static_tracepoint_marker_p) *markers;
4985 struct cleanup *old_chain;
4986 struct static_tracepoint_marker *marker;
4987 struct ui_out *uiout = current_uiout;
4990 /* We don't have to check target_can_use_agent and agent's capability on
4991 static tracepoint here, in order to be compatible with older GDBserver.
4992 We don't check USE_AGENT is true or not, because static tracepoints
4993 don't work without in-process agent, so we don't bother users to type
4994 `set agent on' when to use static tracepoint. */
4997 = make_cleanup_ui_out_table_begin_end (uiout, 5, -1,
4998 "StaticTracepointMarkersTable");
5000 ui_out_table_header (uiout, 7, ui_left, "counter", "Cnt");
5002 ui_out_table_header (uiout, 40, ui_left, "marker-id", "ID");
5004 ui_out_table_header (uiout, 3, ui_left, "enabled", "Enb");
5005 if (gdbarch_addr_bit (target_gdbarch ()) <= 32)
5006 ui_out_table_header (uiout, 10, ui_left, "addr", "Address");
5008 ui_out_table_header (uiout, 18, ui_left, "addr", "Address");
5009 ui_out_table_header (uiout, 40, ui_noalign, "what", "What");
5011 ui_out_table_body (uiout);
5013 markers = target_static_tracepoint_markers_by_strid (NULL);
5014 make_cleanup (VEC_cleanup (static_tracepoint_marker_p), &markers);
5017 VEC_iterate (static_tracepoint_marker_p,
5018 markers, i, marker);
5021 print_one_static_tracepoint_marker (i + 1, marker);
5022 release_static_tracepoint_marker (marker);
5025 do_cleanups (old_chain);
5028 /* The $_sdata convenience variable is a bit special. We don't know
5029 for sure type of the value until we actually have a chance to fetch
5030 the data --- the size of the object depends on what has been
5031 collected. We solve this by making $_sdata be an internalvar that
5032 creates a new value on access. */
5034 /* Return a new value with the correct type for the sdata object of
5035 the current trace frame. Return a void value if there's no object
5038 static struct value *
5039 sdata_make_value (struct gdbarch *gdbarch, struct internalvar *var,
5045 /* We need to read the whole object before we know its size. */
5046 size = target_read_alloc (¤t_target,
5047 TARGET_OBJECT_STATIC_TRACE_DATA,
5054 type = init_vector_type (builtin_type (gdbarch)->builtin_true_char,
5056 v = allocate_value (type);
5057 memcpy (value_contents_raw (v), buf, size);
5062 return allocate_value (builtin_type (gdbarch)->builtin_void);
5065 #if !defined(HAVE_LIBEXPAT)
5067 struct traceframe_info *
5068 parse_traceframe_info (const char *tframe_info)
5070 static int have_warned;
5075 warning (_("Can not parse XML trace frame info; XML support "
5076 "was disabled at compile time"));
5082 #else /* HAVE_LIBEXPAT */
5084 #include "xml-support.h"
5086 /* Handle the start of a <memory> element. */
5089 traceframe_info_start_memory (struct gdb_xml_parser *parser,
5090 const struct gdb_xml_element *element,
5091 void *user_data, VEC(gdb_xml_value_s) *attributes)
5093 struct traceframe_info *info = user_data;
5094 struct mem_range *r = VEC_safe_push (mem_range_s, info->memory, NULL);
5095 ULONGEST *start_p, *length_p;
5097 start_p = xml_find_attribute (attributes, "start")->value;
5098 length_p = xml_find_attribute (attributes, "length")->value;
5100 r->start = *start_p;
5101 r->length = *length_p;
5104 /* Discard the constructed trace frame info (if an error occurs). */
5107 free_result (void *p)
5109 struct traceframe_info *result = p;
5111 free_traceframe_info (result);
5114 /* The allowed elements and attributes for an XML memory map. */
5116 static const struct gdb_xml_attribute memory_attributes[] = {
5117 { "start", GDB_XML_AF_NONE, gdb_xml_parse_attr_ulongest, NULL },
5118 { "length", GDB_XML_AF_NONE, gdb_xml_parse_attr_ulongest, NULL },
5119 { NULL, GDB_XML_AF_NONE, NULL, NULL }
5122 static const struct gdb_xml_element traceframe_info_children[] = {
5123 { "memory", memory_attributes, NULL,
5124 GDB_XML_EF_REPEATABLE | GDB_XML_EF_OPTIONAL,
5125 traceframe_info_start_memory, NULL },
5126 { NULL, NULL, NULL, GDB_XML_EF_NONE, NULL, NULL }
5129 static const struct gdb_xml_element traceframe_info_elements[] = {
5130 { "traceframe-info", NULL, traceframe_info_children, GDB_XML_EF_NONE,
5132 { NULL, NULL, NULL, GDB_XML_EF_NONE, NULL, NULL }
5135 /* Parse a traceframe-info XML document. */
5137 struct traceframe_info *
5138 parse_traceframe_info (const char *tframe_info)
5140 struct traceframe_info *result;
5141 struct cleanup *back_to;
5143 result = XCNEW (struct traceframe_info);
5144 back_to = make_cleanup (free_result, result);
5146 if (gdb_xml_parse_quick (_("trace frame info"),
5147 "traceframe-info.dtd", traceframe_info_elements,
5148 tframe_info, result) == 0)
5150 /* Parsed successfully, keep the result. */
5151 discard_cleanups (back_to);
5156 do_cleanups (back_to);
5160 #endif /* HAVE_LIBEXPAT */
5162 /* Returns the traceframe_info object for the current traceframe.
5163 This is where we avoid re-fetching the object from the target if we
5164 already have it cached. */
5166 static struct traceframe_info *
5167 get_traceframe_info (void)
5169 if (traceframe_info == NULL)
5170 traceframe_info = target_traceframe_info ();
5172 return traceframe_info;
5175 /* If the target supports the query, return in RESULT the set of
5176 collected memory in the current traceframe, found within the LEN
5177 bytes range starting at MEMADDR. Returns true if the target
5178 supports the query, otherwise returns false, and RESULT is left
5182 traceframe_available_memory (VEC(mem_range_s) **result,
5183 CORE_ADDR memaddr, ULONGEST len)
5185 struct traceframe_info *info = get_traceframe_info ();
5189 struct mem_range *r;
5194 for (i = 0; VEC_iterate (mem_range_s, info->memory, i, r); i++)
5195 if (mem_ranges_overlap (r->start, r->length, memaddr, len))
5197 ULONGEST lo1, hi1, lo2, hi2;
5198 struct mem_range *nr;
5201 hi1 = memaddr + len;
5204 hi2 = r->start + r->length;
5206 nr = VEC_safe_push (mem_range_s, *result, NULL);
5208 nr->start = max (lo1, lo2);
5209 nr->length = min (hi1, hi2) - nr->start;
5212 normalize_mem_ranges (*result);
5219 /* Implementation of `sdata' variable. */
5221 static const struct internalvar_funcs sdata_funcs =
5228 /* module initialization */
5230 _initialize_tracepoint (void)
5232 struct cmd_list_element *c;
5234 /* Explicitly create without lookup, since that tries to create a
5235 value with a void typed value, and when we get here, gdbarch
5236 isn't initialized yet. At this point, we're quite sure there
5237 isn't another convenience variable of the same name. */
5238 create_internalvar_type_lazy ("_sdata", &sdata_funcs, NULL);
5240 traceframe_number = -1;
5241 tracepoint_number = -1;
5243 if (tracepoint_list.list == NULL)
5245 tracepoint_list.listsize = 128;
5246 tracepoint_list.list = xmalloc
5247 (tracepoint_list.listsize * sizeof (struct memrange));
5249 if (tracepoint_list.aexpr_list == NULL)
5251 tracepoint_list.aexpr_listsize = 128;
5252 tracepoint_list.aexpr_list = xmalloc
5253 (tracepoint_list.aexpr_listsize * sizeof (struct agent_expr *));
5256 if (stepping_list.list == NULL)
5258 stepping_list.listsize = 128;
5259 stepping_list.list = xmalloc
5260 (stepping_list.listsize * sizeof (struct memrange));
5263 if (stepping_list.aexpr_list == NULL)
5265 stepping_list.aexpr_listsize = 128;
5266 stepping_list.aexpr_list = xmalloc
5267 (stepping_list.aexpr_listsize * sizeof (struct agent_expr *));
5270 add_info ("scope", scope_info,
5271 _("List the variables local to a scope"));
5273 add_cmd ("tracepoints", class_trace, NULL,
5274 _("Tracing of program execution without stopping the program."),
5277 add_com ("tdump", class_trace, trace_dump_command,
5278 _("Print everything collected at the current tracepoint."));
5280 add_com ("tsave", class_trace, trace_save_command, _("\
5281 Save the trace data to a file.\n\
5282 Use the '-r' option to direct the target to save directly to the file,\n\
5283 using its own filesystem."));
5285 c = add_com ("tvariable", class_trace, trace_variable_command,_("\
5286 Define a trace state variable.\n\
5287 Argument is a $-prefixed name, optionally followed\n\
5288 by '=' and an expression that sets the initial value\n\
5289 at the start of tracing."));
5290 set_cmd_completer (c, expression_completer);
5292 add_cmd ("tvariable", class_trace, delete_trace_variable_command, _("\
5293 Delete one or more trace state variables.\n\
5294 Arguments are the names of the variables to delete.\n\
5295 If no arguments are supplied, delete all variables."), &deletelist);
5296 /* FIXME add a trace variable completer. */
5298 add_info ("tvariables", tvariables_info, _("\
5299 Status of trace state variables and their values.\n\
5302 add_info ("static-tracepoint-markers",
5303 info_static_tracepoint_markers_command, _("\
5304 List target static tracepoints markers.\n\
5307 add_prefix_cmd ("tfind", class_trace, trace_find_command, _("\
5308 Select a trace frame;\n\
5309 No argument means forward by one frame; '-' means backward by one frame."),
5310 &tfindlist, "tfind ", 1, &cmdlist);
5312 add_cmd ("outside", class_trace, trace_find_outside_command, _("\
5313 Select a trace frame whose PC is outside the given range (exclusive).\n\
5314 Usage: tfind outside addr1, addr2"),
5317 add_cmd ("range", class_trace, trace_find_range_command, _("\
5318 Select a trace frame whose PC is in the given range (inclusive).\n\
5319 Usage: tfind range addr1,addr2"),
5322 add_cmd ("line", class_trace, trace_find_line_command, _("\
5323 Select a trace frame by source line.\n\
5324 Argument can be a line number (with optional source file),\n\
5325 a function name, or '*' followed by an address.\n\
5326 Default argument is 'the next source line that was traced'."),
5329 add_cmd ("tracepoint", class_trace, trace_find_tracepoint_command, _("\
5330 Select a trace frame by tracepoint number.\n\
5331 Default is the tracepoint for the current trace frame."),
5334 add_cmd ("pc", class_trace, trace_find_pc_command, _("\
5335 Select a trace frame by PC.\n\
5336 Default is the current PC, or the PC of the current trace frame."),
5339 add_cmd ("end", class_trace, trace_find_end_command, _("\
5340 De-select any trace frame and resume 'live' debugging."),
5343 add_alias_cmd ("none", "end", class_trace, 0, &tfindlist);
5345 add_cmd ("start", class_trace, trace_find_start_command,
5346 _("Select the first trace frame in the trace buffer."),
5349 add_com ("tstatus", class_trace, trace_status_command,
5350 _("Display the status of the current trace data collection."));
5352 add_com ("tstop", class_trace, trace_stop_command, _("\
5353 Stop trace data collection.\n\
5354 Usage: tstop [ <notes> ... ]\n\
5355 Any arguments supplied are recorded with the trace as a stop reason and\n\
5356 reported by tstatus (if the target supports trace notes)."));
5358 add_com ("tstart", class_trace, trace_start_command, _("\
5359 Start trace data collection.\n\
5360 Usage: tstart [ <notes> ... ]\n\
5361 Any arguments supplied are recorded with the trace as a note and\n\
5362 reported by tstatus (if the target supports trace notes)."));
5364 add_com ("end", class_trace, end_actions_pseudocommand, _("\
5365 Ends a list of commands or actions.\n\
5366 Several GDB commands allow you to enter a list of commands or actions.\n\
5367 Entering \"end\" on a line by itself is the normal way to terminate\n\
5369 Note: the \"end\" command cannot be used at the gdb prompt."));
5371 add_com ("while-stepping", class_trace, while_stepping_pseudocommand, _("\
5372 Specify single-stepping behavior at a tracepoint.\n\
5373 Argument is number of instructions to trace in single-step mode\n\
5374 following the tracepoint. This command is normally followed by\n\
5375 one or more \"collect\" commands, to specify what to collect\n\
5376 while single-stepping.\n\n\
5377 Note: this command can only be used in a tracepoint \"actions\" list."));
5379 add_com_alias ("ws", "while-stepping", class_alias, 0);
5380 add_com_alias ("stepping", "while-stepping", class_alias, 0);
5382 add_com ("collect", class_trace, collect_pseudocommand, _("\
5383 Specify one or more data items to be collected at a tracepoint.\n\
5384 Accepts a comma-separated list of (one or more) expressions. GDB will\n\
5385 collect all data (variables, registers) referenced by that expression.\n\
5386 Also accepts the following special arguments:\n\
5387 $regs -- all registers.\n\
5388 $args -- all function arguments.\n\
5389 $locals -- all variables local to the block/function scope.\n\
5390 $_sdata -- static tracepoint data (ignored for non-static tracepoints).\n\
5391 Note: this command can only be used in a tracepoint \"actions\" list."));
5393 add_com ("teval", class_trace, teval_pseudocommand, _("\
5394 Specify one or more expressions to be evaluated at a tracepoint.\n\
5395 Accepts a comma-separated list of (one or more) expressions.\n\
5396 The result of each evaluation will be discarded.\n\
5397 Note: this command can only be used in a tracepoint \"actions\" list."));
5399 add_com ("actions", class_trace, trace_actions_command, _("\
5400 Specify the actions to be taken at a tracepoint.\n\
5401 Tracepoint actions may include collecting of specified data,\n\
5402 single-stepping, or enabling/disabling other tracepoints,\n\
5403 depending on target's capabilities."));
5405 default_collect = xstrdup ("");
5406 add_setshow_string_cmd ("default-collect", class_trace,
5407 &default_collect, _("\
5408 Set the list of expressions to collect by default"), _("\
5409 Show the list of expressions to collect by default"), NULL,
5411 &setlist, &showlist);
5413 add_setshow_boolean_cmd ("disconnected-tracing", no_class,
5414 &disconnected_tracing, _("\
5415 Set whether tracing continues after GDB disconnects."), _("\
5416 Show whether tracing continues after GDB disconnects."), _("\
5417 Use this to continue a tracing run even if GDB disconnects\n\
5418 or detaches from the target. You can reconnect later and look at\n\
5419 trace data collected in the meantime."),
5420 set_disconnected_tracing,
5425 add_setshow_boolean_cmd ("circular-trace-buffer", no_class,
5426 &circular_trace_buffer, _("\
5427 Set target's use of circular trace buffer."), _("\
5428 Show target's use of circular trace buffer."), _("\
5429 Use this to make the trace buffer into a circular buffer,\n\
5430 which will discard traceframes (oldest first) instead of filling\n\
5431 up and stopping the trace run."),
5432 set_circular_trace_buffer,
5437 add_setshow_zuinteger_unlimited_cmd ("trace-buffer-size", no_class,
5438 &trace_buffer_size, _("\
5439 Set requested size of trace buffer."), _("\
5440 Show requested size of trace buffer."), _("\
5441 Use this to choose a size for the trace buffer. Some targets\n\
5442 may have fixed or limited buffer sizes. A value of -1 disables\n\
5443 any attempt to set the buffer size and lets the target choose."),
5444 set_trace_buffer_size, NULL,
5445 &setlist, &showlist);
5447 add_setshow_string_cmd ("trace-user", class_trace,
5449 Set the user name to use for current and future trace runs"), _("\
5450 Show the user name to use for current and future trace runs"), NULL,
5451 set_trace_user, NULL,
5452 &setlist, &showlist);
5454 add_setshow_string_cmd ("trace-notes", class_trace,
5456 Set notes string to use for current and future trace runs"), _("\
5457 Show the notes string to use for current and future trace runs"), NULL,
5458 set_trace_notes, NULL,
5459 &setlist, &showlist);
5461 add_setshow_string_cmd ("trace-stop-notes", class_trace,
5462 &trace_stop_notes, _("\
5463 Set notes string to use for future tstop commands"), _("\
5464 Show the notes string to use for future tstop commands"), NULL,
5465 set_trace_stop_notes, NULL,
5466 &setlist, &showlist);
5470 add_target (&tfile_ops);