1 /* Tracing functionality for remote targets in custom GDB protocol
3 Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
4 2007, 2008, 2009, 2010 Free Software Foundation, Inc.
6 This file is part of GDB.
8 This program is free software; you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation; either version 3 of the License, or
11 (at your option) any later version.
13 This program is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with this program. If not, see <http://www.gnu.org/licenses/>. */
22 #include "arch-utils.h"
26 #include "expression.h"
31 #include "gdb_string.h"
33 #include "breakpoint.h"
34 #include "tracepoint.h"
37 #include "completer.h"
39 #include "dictionary.h"
41 #include "user-regs.h"
45 #include "filenames.h"
46 #include "gdbthread.h"
53 /* readline include files */
54 #include "readline/readline.h"
55 #include "readline/history.h"
57 /* readline defines this. */
68 extern int hex2bin (const char *hex
, gdb_byte
*bin
, int count
);
69 extern int bin2hex (const gdb_byte
*bin
, char *hex
, int count
);
71 extern void stop_tracing ();
73 /* Maximum length of an agent aexpression.
74 This accounts for the fact that packets are limited to 400 bytes
75 (which includes everything -- including the checksum), and assumes
76 the worst case of maximum length for each of the pieces of a
79 NOTE: expressions get mem2hex'ed otherwise this would be twice as
80 large. (400 - 31)/2 == 184 */
81 #define MAX_AGENT_EXPR_LEN 184
83 /* A hook used to notify the UI of tracepoint operations. */
85 void (*deprecated_trace_find_hook
) (char *arg
, int from_tty
);
86 void (*deprecated_trace_start_stop_hook
) (int start
, int from_tty
);
88 extern void (*deprecated_readline_begin_hook
) (char *, ...);
89 extern char *(*deprecated_readline_hook
) (char *);
90 extern void (*deprecated_readline_end_hook
) (void);
92 /* GDB commands implemented in other modules:
95 extern void output_command (char *, int);
100 This module defines the following debugger commands:
101 trace : set a tracepoint on a function, line, or address.
102 info trace : list all debugger-defined tracepoints.
103 delete trace : delete one or more tracepoints.
104 enable trace : enable one or more tracepoints.
105 disable trace : disable one or more tracepoints.
106 actions : specify actions to be taken at a tracepoint.
107 passcount : specify a pass count for a tracepoint.
108 tstart : start a trace experiment.
109 tstop : stop a trace experiment.
110 tstatus : query the status of a trace experiment.
111 tfind : find a trace frame in the trace buffer.
112 tdump : print everything collected at the current tracepoint.
113 save-tracepoints : write tracepoint setup into a file.
115 This module defines the following user-visible debugger variables:
116 $trace_frame : sequence number of trace frame currently being debugged.
117 $trace_line : source line of trace frame currently being debugged.
118 $trace_file : source file of trace frame currently being debugged.
119 $tracepoint : tracepoint number of trace frame currently being debugged.
123 /* ======= Important global variables: ======= */
125 /* The list of all trace state variables. We don't retain pointers to
126 any of these for any reason - API is by name or number only - so it
127 works to have a vector of objects. */
129 typedef struct trace_state_variable tsv_s
;
132 static VEC(tsv_s
) *tvariables
;
134 /* The next integer to assign to a variable. */
136 static int next_tsv_number
= 1;
138 /* Number of last traceframe collected. */
139 static int traceframe_number
;
141 /* Tracepoint for last traceframe collected. */
142 static int tracepoint_number
;
144 /* Symbol for function for last traceframe collected */
145 static struct symbol
*traceframe_fun
;
147 /* Symtab and line for last traceframe collected */
148 static struct symtab_and_line traceframe_sal
;
150 /* Tracing command lists */
151 static struct cmd_list_element
*tfindlist
;
153 /* List of expressions to collect by default at each tracepoint hit. */
154 char *default_collect
= "";
156 static int disconnected_tracing
;
158 /* This variable controls whether we ask the target for a linear or
159 circular trace buffer. */
161 static int circular_trace_buffer
;
163 /* ======= Important command functions: ======= */
164 static void trace_actions_command (char *, int);
165 static void trace_start_command (char *, int);
166 static void trace_stop_command (char *, int);
167 static void trace_status_command (char *, int);
168 static void trace_find_command (char *, int);
169 static void trace_find_pc_command (char *, int);
170 static void trace_find_tracepoint_command (char *, int);
171 static void trace_find_line_command (char *, int);
172 static void trace_find_range_command (char *, int);
173 static void trace_find_outside_command (char *, int);
174 static void trace_dump_command (char *, int);
176 /* support routines */
178 struct collection_list
;
179 static void add_aexpr (struct collection_list
*, struct agent_expr
*);
180 static char *mem2hex (gdb_byte
*, char *, int);
181 static void add_register (struct collection_list
*collection
,
184 extern void send_disconnected_tracing_value (int value
);
186 static void free_uploaded_tps (struct uploaded_tp
**utpp
);
187 static void free_uploaded_tsvs (struct uploaded_tsv
**utsvp
);
190 extern void _initialize_tracepoint (void);
192 static struct trace_status trace_status
;
194 char *stop_reason_names
[] = {
204 struct trace_status
*
205 current_trace_status ()
207 return &trace_status
;
210 /* Set traceframe number to NUM. */
212 set_traceframe_num (int num
)
214 traceframe_number
= num
;
215 set_internalvar_integer (lookup_internalvar ("trace_frame"), num
);
218 /* Set tracepoint number to NUM. */
220 set_tracepoint_num (int num
)
222 tracepoint_number
= num
;
223 set_internalvar_integer (lookup_internalvar ("tracepoint"), num
);
226 /* Set externally visible debug variables for querying/printing
227 the traceframe context (line, function, file) */
230 set_traceframe_context (struct frame_info
*trace_frame
)
234 if (trace_frame
== NULL
) /* Cease debugging any trace buffers. */
237 traceframe_sal
.pc
= traceframe_sal
.line
= 0;
238 traceframe_sal
.symtab
= NULL
;
239 clear_internalvar (lookup_internalvar ("trace_func"));
240 clear_internalvar (lookup_internalvar ("trace_file"));
241 set_internalvar_integer (lookup_internalvar ("trace_line"), -1);
245 /* Save as globals for internal use. */
246 trace_pc
= get_frame_pc (trace_frame
);
247 traceframe_sal
= find_pc_line (trace_pc
, 0);
248 traceframe_fun
= find_pc_function (trace_pc
);
250 /* Save linenumber as "$trace_line", a debugger variable visible to
252 set_internalvar_integer (lookup_internalvar ("trace_line"),
253 traceframe_sal
.line
);
255 /* Save func name as "$trace_func", a debugger variable visible to
257 if (traceframe_fun
== NULL
258 || SYMBOL_LINKAGE_NAME (traceframe_fun
) == NULL
)
259 clear_internalvar (lookup_internalvar ("trace_func"));
261 set_internalvar_string (lookup_internalvar ("trace_func"),
262 SYMBOL_LINKAGE_NAME (traceframe_fun
));
264 /* Save file name as "$trace_file", a debugger variable visible to
266 if (traceframe_sal
.symtab
== NULL
267 || traceframe_sal
.symtab
->filename
== NULL
)
268 clear_internalvar (lookup_internalvar ("trace_file"));
270 set_internalvar_string (lookup_internalvar ("trace_file"),
271 traceframe_sal
.symtab
->filename
);
274 /* Create a new trace state variable with the given name. */
276 struct trace_state_variable
*
277 create_trace_state_variable (const char *name
)
279 struct trace_state_variable tsv
;
281 memset (&tsv
, 0, sizeof (tsv
));
282 tsv
.name
= xstrdup (name
);
283 tsv
.number
= next_tsv_number
++;
284 return VEC_safe_push (tsv_s
, tvariables
, &tsv
);
287 /* Look for a trace state variable of the given name. */
289 struct trace_state_variable
*
290 find_trace_state_variable (const char *name
)
292 struct trace_state_variable
*tsv
;
295 for (ix
= 0; VEC_iterate (tsv_s
, tvariables
, ix
, tsv
); ++ix
)
296 if (strcmp (name
, tsv
->name
) == 0)
303 delete_trace_state_variable (const char *name
)
305 struct trace_state_variable
*tsv
;
308 for (ix
= 0; VEC_iterate (tsv_s
, tvariables
, ix
, tsv
); ++ix
)
309 if (strcmp (name
, tsv
->name
) == 0)
311 xfree ((void *)tsv
->name
);
312 VEC_unordered_remove (tsv_s
, tvariables
, ix
);
316 warning (_("No trace variable named \"$%s\", not deleting"), name
);
319 /* The 'tvariable' command collects a name and optional expression to
320 evaluate into an initial value. */
323 trace_variable_command (char *args
, int from_tty
)
325 struct expression
*expr
;
326 struct cleanup
*old_chain
;
327 struct internalvar
*intvar
= NULL
;
329 struct trace_state_variable
*tsv
;
332 error_no_arg (_("trace state variable name"));
334 /* All the possible valid arguments are expressions. */
335 expr
= parse_expression (args
);
336 old_chain
= make_cleanup (free_current_contents
, &expr
);
338 if (expr
->nelts
== 0)
339 error (_("No expression?"));
341 /* Only allow two syntaxes; "$name" and "$name=value". */
342 if (expr
->elts
[0].opcode
== OP_INTERNALVAR
)
344 intvar
= expr
->elts
[1].internalvar
;
346 else if (expr
->elts
[0].opcode
== BINOP_ASSIGN
347 && expr
->elts
[1].opcode
== OP_INTERNALVAR
)
349 intvar
= expr
->elts
[2].internalvar
;
350 initval
= value_as_long (evaluate_subexpression_type (expr
, 4));
353 error (_("Syntax must be $NAME [ = EXPR ]"));
356 error (_("No name given"));
358 if (strlen (internalvar_name (intvar
)) <= 0)
359 error (_("Must supply a non-empty variable name"));
361 /* If the variable already exists, just change its initial value. */
362 tsv
= find_trace_state_variable (internalvar_name (intvar
));
365 tsv
->initial_value
= initval
;
366 printf_filtered (_("Trace state variable $%s now has initial value %s.\n"),
367 tsv
->name
, plongest (tsv
->initial_value
));
371 /* Create a new variable. */
372 tsv
= create_trace_state_variable (internalvar_name (intvar
));
373 tsv
->initial_value
= initval
;
375 printf_filtered (_("Trace state variable $%s created, with initial value %s.\n"),
376 tsv
->name
, plongest (tsv
->initial_value
));
378 do_cleanups (old_chain
);
382 delete_trace_variable_command (char *args
, int from_tty
)
386 struct cleanup
*back_to
;
387 struct trace_state_variable
*tsv
;
391 if (query (_("Delete all trace state variables? ")))
392 VEC_free (tsv_s
, tvariables
);
397 argv
= gdb_buildargv (args
);
398 back_to
= make_cleanup_freeargv (argv
);
400 for (i
= 0; argv
[i
] != NULL
; i
++)
403 delete_trace_state_variable (argv
[i
] + 1);
405 warning (_("Name \"%s\" not prefixed with '$', ignoring"), argv
[i
]);
408 do_cleanups (back_to
);
414 tvariables_info_1 (void)
416 struct trace_state_variable
*tsv
;
419 struct cleanup
*back_to
;
421 if (VEC_length (tsv_s
, tvariables
) == 0 && !ui_out_is_mi_like_p (uiout
))
423 printf_filtered (_("No trace state variables.\n"));
427 /* Try to acquire values from the target. */
428 for (ix
= 0; VEC_iterate (tsv_s
, tvariables
, ix
, tsv
); ++ix
, ++count
)
429 tsv
->value_known
= target_get_trace_state_variable_value (tsv
->number
,
432 back_to
= make_cleanup_ui_out_table_begin_end (uiout
, 3,
433 count
, "trace-variables");
434 ui_out_table_header (uiout
, 15, ui_left
, "name", "Name");
435 ui_out_table_header (uiout
, 11, ui_left
, "initial", "Initial");
436 ui_out_table_header (uiout
, 11, ui_left
, "current", "Current");
438 ui_out_table_body (uiout
);
440 for (ix
= 0; VEC_iterate (tsv_s
, tvariables
, ix
, tsv
); ++ix
)
442 struct cleanup
*back_to2
;
446 back_to2
= make_cleanup_ui_out_tuple_begin_end (uiout
, "variable");
448 name
= concat ("$", tsv
->name
, NULL
);
449 make_cleanup (xfree
, name
);
450 ui_out_field_string (uiout
, "name", name
);
451 ui_out_field_string (uiout
, "initial", plongest (tsv
->initial_value
));
453 if (tsv
->value_known
)
454 c
= plongest (tsv
->value
);
455 else if (ui_out_is_mi_like_p (uiout
))
456 /* For MI, we prefer not to use magic string constants, but rather
457 omit the field completely. The difference between unknown and
458 undefined does not seem important enough to represent. */
460 else if (current_trace_status ()->running
|| traceframe_number
>= 0)
461 /* The value is/was defined, but we don't have it. */
464 /* It is not meaningful to ask about the value. */
467 ui_out_field_string (uiout
, "current", c
);
468 ui_out_text (uiout
, "\n");
470 do_cleanups (back_to2
);
473 do_cleanups (back_to
);
476 /* List all the trace state variables. */
479 tvariables_info (char *args
, int from_tty
)
481 tvariables_info_1 ();
484 /* Stash definitions of tsvs into the given file. */
487 save_trace_state_variables (struct ui_file
*fp
)
489 struct trace_state_variable
*tsv
;
492 for (ix
= 0; VEC_iterate (tsv_s
, tvariables
, ix
, tsv
); ++ix
)
494 fprintf_unfiltered (fp
, "tvariable $%s", tsv
->name
);
495 if (tsv
->initial_value
)
496 fprintf_unfiltered (fp
, " = %s", plongest (tsv
->initial_value
));
497 fprintf_unfiltered (fp
, "\n");
501 /* ACTIONS functions: */
503 /* The three functions:
504 collect_pseudocommand,
505 while_stepping_pseudocommand, and
506 end_actions_pseudocommand
507 are placeholders for "commands" that are actually ONLY to be used
508 within a tracepoint action list. If the actual function is ever called,
509 it means that somebody issued the "command" at the top level,
510 which is always an error. */
513 end_actions_pseudocommand (char *args
, int from_tty
)
515 error (_("This command cannot be used at the top level."));
519 while_stepping_pseudocommand (char *args
, int from_tty
)
521 error (_("This command can only be used in a tracepoint actions list."));
525 collect_pseudocommand (char *args
, int from_tty
)
527 error (_("This command can only be used in a tracepoint actions list."));
531 teval_pseudocommand (char *args
, int from_tty
)
533 error (_("This command can only be used in a tracepoint actions list."));
536 /* Enter a list of actions for a tracepoint. */
538 trace_actions_command (char *args
, int from_tty
)
540 struct breakpoint
*t
;
541 struct command_line
*l
;
543 t
= get_tracepoint_by_number (&args
, 0, 1);
547 xstrprintf ("Enter actions for tracepoint %d, one per line.",
549 struct cleanup
*cleanups
= make_cleanup (xfree
, tmpbuf
);
551 l
= read_command_lines (tmpbuf
, from_tty
, 1, check_tracepoint_command
, t
);
552 do_cleanups (cleanups
);
553 breakpoint_set_commands (t
, l
);
555 /* else just return */
558 /* Report the results of checking the agent expression, as errors or
562 report_agent_reqs_errors (struct agent_expr
*aexpr
, struct agent_reqs
*areqs
)
564 /* All of the "flaws" are serious bytecode generation issues that
565 should never occur. */
566 if (areqs
->flaw
!= agent_flaw_none
)
567 internal_error (__FILE__
, __LINE__
, _("expression is malformed"));
569 /* If analysis shows a stack underflow, GDB must have done something
570 badly wrong in its bytecode generation. */
571 if (areqs
->min_height
< 0)
572 internal_error (__FILE__
, __LINE__
,
573 _("expression has min height < 0"));
575 /* Issue this error if the stack is predicted to get too deep. The
576 limit is rather arbitrary; a better scheme might be for the
577 target to report how much stack it will have available. The
578 depth roughly corresponds to parenthesization, so a limit of 20
579 amounts to 20 levels of expression nesting, which is actually
580 a pretty big hairy expression. */
581 if (areqs
->max_height
> 20)
582 error (_("Expression is too complicated."));
585 /* worker function */
587 validate_actionline (char **line
, struct breakpoint
*t
)
589 struct cmd_list_element
*c
;
590 struct expression
*exp
= NULL
;
591 struct cleanup
*old_chain
= NULL
;
593 struct bp_location
*loc
;
594 struct agent_expr
*aexpr
;
595 struct agent_reqs areqs
;
597 /* if EOF is typed, *line is NULL */
601 for (p
= *line
; isspace ((int) *p
);)
604 /* Symbol lookup etc. */
605 if (*p
== '\0') /* empty line: just prompt for another line. */
608 if (*p
== '#') /* comment line */
611 c
= lookup_cmd (&p
, cmdlist
, "", -1, 1);
613 error (_("`%s' is not a tracepoint action, or is ambiguous."), p
);
615 if (cmd_cfunc_eq (c
, collect_pseudocommand
))
618 { /* repeat over a comma-separated list */
619 QUIT
; /* allow user to bail out with ^C */
620 while (isspace ((int) *p
))
623 if (*p
== '$') /* look for special pseudo-symbols */
625 if ((0 == strncasecmp ("reg", p
+ 1, 3)) ||
626 (0 == strncasecmp ("arg", p
+ 1, 3)) ||
627 (0 == strncasecmp ("loc", p
+ 1, 3)))
632 /* else fall thru, treat p as an expression and parse it! */
635 for (loc
= t
->loc
; loc
; loc
= loc
->next
)
638 exp
= parse_exp_1 (&p
, block_for_pc (loc
->address
), 1);
639 old_chain
= make_cleanup (free_current_contents
, &exp
);
641 if (exp
->elts
[0].opcode
== OP_VAR_VALUE
)
643 if (SYMBOL_CLASS (exp
->elts
[2].symbol
) == LOC_CONST
)
645 error (_("constant `%s' (value %ld) will not be collected."),
646 SYMBOL_PRINT_NAME (exp
->elts
[2].symbol
),
647 SYMBOL_VALUE (exp
->elts
[2].symbol
));
649 else if (SYMBOL_CLASS (exp
->elts
[2].symbol
) == LOC_OPTIMIZED_OUT
)
651 error (_("`%s' is optimized away and cannot be collected."),
652 SYMBOL_PRINT_NAME (exp
->elts
[2].symbol
));
656 /* We have something to collect, make sure that the expr to
657 bytecode translator can handle it and that it's not too
659 aexpr
= gen_trace_for_expr (loc
->address
, exp
);
660 make_cleanup_free_agent_expr (aexpr
);
662 if (aexpr
->len
> MAX_AGENT_EXPR_LEN
)
663 error (_("Expression is too complicated."));
665 ax_reqs (aexpr
, &areqs
);
666 (void) make_cleanup (xfree
, areqs
.reg_mask
);
668 report_agent_reqs_errors (aexpr
, &areqs
);
670 do_cleanups (old_chain
);
673 while (p
&& *p
++ == ',');
676 else if (cmd_cfunc_eq (c
, teval_pseudocommand
))
679 { /* repeat over a comma-separated list */
680 QUIT
; /* allow user to bail out with ^C */
681 while (isspace ((int) *p
))
685 for (loc
= t
->loc
; loc
; loc
= loc
->next
)
688 /* Only expressions are allowed for this action. */
689 exp
= parse_exp_1 (&p
, block_for_pc (loc
->address
), 1);
690 old_chain
= make_cleanup (free_current_contents
, &exp
);
692 /* We have something to evaluate, make sure that the expr to
693 bytecode translator can handle it and that it's not too
695 aexpr
= gen_eval_for_expr (loc
->address
, exp
);
696 make_cleanup_free_agent_expr (aexpr
);
698 if (aexpr
->len
> MAX_AGENT_EXPR_LEN
)
699 error (_("Expression is too complicated."));
701 ax_reqs (aexpr
, &areqs
);
702 (void) make_cleanup (xfree
, areqs
.reg_mask
);
704 report_agent_reqs_errors (aexpr
, &areqs
);
706 do_cleanups (old_chain
);
709 while (p
&& *p
++ == ',');
712 else if (cmd_cfunc_eq (c
, while_stepping_pseudocommand
))
714 char *steparg
; /* in case warning is necessary */
716 while (isspace ((int) *p
))
720 if (*p
== '\0' || (t
->step_count
= strtol (p
, &p
, 0)) == 0)
721 error (_("while-stepping step count `%s' is malformed."), *line
);
724 else if (cmd_cfunc_eq (c
, end_actions_pseudocommand
))
728 error (_("`%s' is not a supported tracepoint action."), *line
);
732 memrange_absolute
= -1
737 int type
; /* memrange_absolute for absolute memory range,
738 else basereg number */
739 bfd_signed_vma start
;
743 struct collection_list
745 unsigned char regs_mask
[32]; /* room for up to 256 regs */
748 struct memrange
*list
;
749 long aexpr_listsize
; /* size of array pointed to by expr_list elt */
751 struct agent_expr
**aexpr_list
;
754 tracepoint_list
, stepping_list
;
756 /* MEMRANGE functions: */
758 static int memrange_cmp (const void *, const void *);
760 /* compare memranges for qsort */
762 memrange_cmp (const void *va
, const void *vb
)
764 const struct memrange
*a
= va
, *b
= vb
;
766 if (a
->type
< b
->type
)
768 if (a
->type
> b
->type
)
770 if (a
->type
== memrange_absolute
)
772 if ((bfd_vma
) a
->start
< (bfd_vma
) b
->start
)
774 if ((bfd_vma
) a
->start
> (bfd_vma
) b
->start
)
779 if (a
->start
< b
->start
)
781 if (a
->start
> b
->start
)
787 /* Sort the memrange list using qsort, and merge adjacent memranges. */
789 memrange_sortmerge (struct collection_list
*memranges
)
793 qsort (memranges
->list
, memranges
->next_memrange
,
794 sizeof (struct memrange
), memrange_cmp
);
795 if (memranges
->next_memrange
> 0)
797 for (a
= 0, b
= 1; b
< memranges
->next_memrange
; b
++)
799 if (memranges
->list
[a
].type
== memranges
->list
[b
].type
&&
800 memranges
->list
[b
].start
- memranges
->list
[a
].end
<=
803 /* memrange b starts before memrange a ends; merge them. */
804 if (memranges
->list
[b
].end
> memranges
->list
[a
].end
)
805 memranges
->list
[a
].end
= memranges
->list
[b
].end
;
806 continue; /* next b, same a */
810 memcpy (&memranges
->list
[a
], &memranges
->list
[b
],
811 sizeof (struct memrange
));
813 memranges
->next_memrange
= a
+ 1;
817 /* Add a register to a collection list. */
819 add_register (struct collection_list
*collection
, unsigned int regno
)
822 printf_filtered ("collect register %d\n", regno
);
823 if (regno
>= (8 * sizeof (collection
->regs_mask
)))
824 error (_("Internal: register number %d too large for tracepoint"),
826 collection
->regs_mask
[regno
/ 8] |= 1 << (regno
% 8);
829 /* Add a memrange to a collection list */
831 add_memrange (struct collection_list
*memranges
,
832 int type
, bfd_signed_vma base
,
837 printf_filtered ("(%d,", type
);
839 printf_filtered (",%ld)\n", len
);
842 /* type: memrange_absolute == memory, other n == basereg */
843 memranges
->list
[memranges
->next_memrange
].type
= type
;
844 /* base: addr if memory, offset if reg relative. */
845 memranges
->list
[memranges
->next_memrange
].start
= base
;
846 /* len: we actually save end (base + len) for convenience */
847 memranges
->list
[memranges
->next_memrange
].end
= base
+ len
;
848 memranges
->next_memrange
++;
849 if (memranges
->next_memrange
>= memranges
->listsize
)
851 memranges
->listsize
*= 2;
852 memranges
->list
= xrealloc (memranges
->list
,
853 memranges
->listsize
);
856 if (type
!= memrange_absolute
) /* Better collect the base register! */
857 add_register (memranges
, type
);
860 /* Add a symbol to a collection list. */
862 collect_symbol (struct collection_list
*collect
,
864 struct gdbarch
*gdbarch
,
865 long frame_regno
, long frame_offset
,
870 bfd_signed_vma offset
;
871 int treat_as_expr
= 0;
873 len
= TYPE_LENGTH (check_typedef (SYMBOL_TYPE (sym
)));
874 switch (SYMBOL_CLASS (sym
))
877 printf_filtered ("%s: don't know symbol class %d\n",
878 SYMBOL_PRINT_NAME (sym
),
882 printf_filtered ("constant %s (value %ld) will not be collected.\n",
883 SYMBOL_PRINT_NAME (sym
), SYMBOL_VALUE (sym
));
886 offset
= SYMBOL_VALUE_ADDRESS (sym
);
891 sprintf_vma (tmp
, offset
);
892 printf_filtered ("LOC_STATIC %s: collect %ld bytes at %s.\n",
893 SYMBOL_PRINT_NAME (sym
), len
,
896 /* A struct may be a C++ class with static fields, go to general
897 expression handling. */
898 if (TYPE_CODE (SYMBOL_TYPE (sym
)) == TYPE_CODE_STRUCT
)
901 add_memrange (collect
, memrange_absolute
, offset
, len
);
904 reg
= SYMBOL_REGISTER_OPS (sym
)->register_number (sym
, gdbarch
);
906 printf_filtered ("LOC_REG[parm] %s: ",
907 SYMBOL_PRINT_NAME (sym
));
908 add_register (collect
, reg
);
909 /* Check for doubles stored in two registers. */
910 /* FIXME: how about larger types stored in 3 or more regs? */
911 if (TYPE_CODE (SYMBOL_TYPE (sym
)) == TYPE_CODE_FLT
&&
912 len
> register_size (gdbarch
, reg
))
913 add_register (collect
, reg
+ 1);
916 printf_filtered ("Sorry, don't know how to do LOC_REF_ARG yet.\n");
917 printf_filtered (" (will not collect %s)\n",
918 SYMBOL_PRINT_NAME (sym
));
922 offset
= frame_offset
+ SYMBOL_VALUE (sym
);
925 printf_filtered ("LOC_LOCAL %s: Collect %ld bytes at offset ",
926 SYMBOL_PRINT_NAME (sym
), len
);
928 printf_filtered (" from frame ptr reg %d\n", reg
);
930 add_memrange (collect
, reg
, offset
, len
);
932 case LOC_REGPARM_ADDR
:
933 reg
= SYMBOL_VALUE (sym
);
937 printf_filtered ("LOC_REGPARM_ADDR %s: Collect %ld bytes at offset ",
938 SYMBOL_PRINT_NAME (sym
), len
);
940 printf_filtered (" from reg %d\n", reg
);
942 add_memrange (collect
, reg
, offset
, len
);
946 offset
= frame_offset
+ SYMBOL_VALUE (sym
);
949 printf_filtered ("LOC_LOCAL %s: Collect %ld bytes at offset ",
950 SYMBOL_PRINT_NAME (sym
), len
);
952 printf_filtered (" from frame ptr reg %d\n", reg
);
954 add_memrange (collect
, reg
, offset
, len
);
961 case LOC_OPTIMIZED_OUT
:
962 printf_filtered ("%s has been optimized out of existence.\n",
963 SYMBOL_PRINT_NAME (sym
));
971 /* Expressions are the most general case. */
974 struct agent_expr
*aexpr
;
975 struct cleanup
*old_chain1
= NULL
;
976 struct agent_reqs areqs
;
978 aexpr
= gen_trace_for_var (scope
, gdbarch
, sym
);
980 /* It can happen that the symbol is recorded as a computed
981 location, but it's been optimized away and doesn't actually
982 have a location expression. */
985 printf_filtered ("%s has been optimized out of existence.\n",
986 SYMBOL_PRINT_NAME (sym
));
990 old_chain1
= make_cleanup_free_agent_expr (aexpr
);
992 ax_reqs (aexpr
, &areqs
);
994 report_agent_reqs_errors (aexpr
, &areqs
);
996 discard_cleanups (old_chain1
);
997 add_aexpr (collect
, aexpr
);
999 /* take care of the registers */
1000 if (areqs
.reg_mask_len
> 0)
1004 for (ndx1
= 0; ndx1
< areqs
.reg_mask_len
; ndx1
++)
1006 QUIT
; /* allow user to bail out with ^C */
1007 if (areqs
.reg_mask
[ndx1
] != 0)
1009 /* assume chars have 8 bits */
1010 for (ndx2
= 0; ndx2
< 8; ndx2
++)
1011 if (areqs
.reg_mask
[ndx1
] & (1 << ndx2
))
1012 /* it's used -- record it */
1013 add_register (collect
, ndx1
* 8 + ndx2
);
1020 /* Data to be passed around in the calls to the locals and args
1023 struct add_local_symbols_data
1025 struct collection_list
*collect
;
1026 struct gdbarch
*gdbarch
;
1033 /* The callback for the locals and args iterators */
1036 do_collect_symbol (const char *print_name
,
1040 struct add_local_symbols_data
*p
= cb_data
;
1042 collect_symbol (p
->collect
, sym
, p
->gdbarch
, p
->frame_regno
,
1043 p
->frame_offset
, p
->pc
);
1047 /* Add all locals (or args) symbols to collection list */
1049 add_local_symbols (struct collection_list
*collect
,
1050 struct gdbarch
*gdbarch
, CORE_ADDR pc
,
1051 long frame_regno
, long frame_offset
, int type
)
1053 struct block
*block
;
1054 struct add_local_symbols_data cb_data
;
1056 cb_data
.collect
= collect
;
1057 cb_data
.gdbarch
= gdbarch
;
1059 cb_data
.frame_regno
= frame_regno
;
1060 cb_data
.frame_offset
= frame_offset
;
1065 block
= block_for_pc (pc
);
1068 warning (_("Can't collect locals; "
1069 "no symbol table info available.\n"));
1073 iterate_over_block_local_vars (block
, do_collect_symbol
, &cb_data
);
1074 if (cb_data
.count
== 0)
1075 warning (_("No locals found in scope."));
1079 pc
= get_pc_function_start (pc
);
1080 block
= block_for_pc (pc
);
1083 warning (_("Can't collect args; no symbol table info available.\n"));
1087 iterate_over_block_arg_vars (block
, do_collect_symbol
, &cb_data
);
1088 if (cb_data
.count
== 0)
1089 warning (_("No args found in scope."));
1093 /* worker function */
1095 clear_collection_list (struct collection_list
*list
)
1099 list
->next_memrange
= 0;
1100 for (ndx
= 0; ndx
< list
->next_aexpr_elt
; ndx
++)
1102 free_agent_expr (list
->aexpr_list
[ndx
]);
1103 list
->aexpr_list
[ndx
] = NULL
;
1105 list
->next_aexpr_elt
= 0;
1106 memset (list
->regs_mask
, 0, sizeof (list
->regs_mask
));
1109 /* reduce a collection list to string form (for gdb protocol) */
1111 stringify_collection_list (struct collection_list
*list
, char *string
)
1113 char temp_buf
[2048];
1117 char *(*str_list
)[];
1121 count
= 1 + list
->next_memrange
+ list
->next_aexpr_elt
+ 1;
1122 str_list
= (char *(*)[]) xmalloc (count
* sizeof (char *));
1124 for (i
= sizeof (list
->regs_mask
) - 1; i
> 0; i
--)
1125 if (list
->regs_mask
[i
] != 0) /* skip leading zeroes in regs_mask */
1127 if (list
->regs_mask
[i
] != 0) /* prepare to send regs_mask to the stub */
1130 printf_filtered ("\nCollecting registers (mask): 0x");
1135 QUIT
; /* allow user to bail out with ^C */
1137 printf_filtered ("%02X", list
->regs_mask
[i
]);
1138 sprintf (end
, "%02X", list
->regs_mask
[i
]);
1141 (*str_list
)[ndx
] = xstrdup (temp_buf
);
1145 printf_filtered ("\n");
1146 if (list
->next_memrange
> 0 && info_verbose
)
1147 printf_filtered ("Collecting memranges: \n");
1148 for (i
= 0, count
= 0, end
= temp_buf
; i
< list
->next_memrange
; i
++)
1150 QUIT
; /* allow user to bail out with ^C */
1151 sprintf_vma (tmp2
, list
->list
[i
].start
);
1154 printf_filtered ("(%d, %s, %ld)\n",
1157 (long) (list
->list
[i
].end
- list
->list
[i
].start
));
1159 if (count
+ 27 > MAX_AGENT_EXPR_LEN
)
1161 (*str_list
)[ndx
] = savestring (temp_buf
, count
);
1168 bfd_signed_vma length
= list
->list
[i
].end
- list
->list
[i
].start
;
1170 /* The "%X" conversion specifier expects an unsigned argument,
1171 so passing -1 (memrange_absolute) to it directly gives you
1172 "FFFFFFFF" (or more, depending on sizeof (unsigned)).
1174 if (list
->list
[i
].type
== memrange_absolute
)
1175 sprintf (end
, "M-1,%s,%lX", tmp2
, (long) length
);
1177 sprintf (end
, "M%X,%s,%lX", list
->list
[i
].type
, tmp2
, (long) length
);
1180 count
+= strlen (end
);
1181 end
= temp_buf
+ count
;
1184 for (i
= 0; i
< list
->next_aexpr_elt
; i
++)
1186 QUIT
; /* allow user to bail out with ^C */
1187 if ((count
+ 10 + 2 * list
->aexpr_list
[i
]->len
) > MAX_AGENT_EXPR_LEN
)
1189 (*str_list
)[ndx
] = savestring (temp_buf
, count
);
1194 sprintf (end
, "X%08X,", list
->aexpr_list
[i
]->len
);
1195 end
+= 10; /* 'X' + 8 hex digits + ',' */
1198 end
= mem2hex (list
->aexpr_list
[i
]->buf
,
1199 end
, list
->aexpr_list
[i
]->len
);
1200 count
+= 2 * list
->aexpr_list
[i
]->len
;
1205 (*str_list
)[ndx
] = savestring (temp_buf
, count
);
1210 (*str_list
)[ndx
] = NULL
;
1223 encode_actions_1 (struct command_line
*action
,
1224 struct breakpoint
*t
,
1225 struct bp_location
*tloc
,
1227 LONGEST frame_offset
,
1228 struct collection_list
*collect
,
1229 struct collection_list
*stepping_list
)
1232 struct expression
*exp
= NULL
;
1233 struct command_line
*actions
;
1235 struct value
*tempval
;
1236 struct cmd_list_element
*cmd
;
1237 struct agent_expr
*aexpr
;
1239 for (; action
; action
= action
->next
)
1241 QUIT
; /* allow user to bail out with ^C */
1242 action_exp
= action
->line
;
1243 while (isspace ((int) *action_exp
))
1246 cmd
= lookup_cmd (&action_exp
, cmdlist
, "", -1, 1);
1248 error (_("Bad action list item: %s"), action_exp
);
1250 if (cmd_cfunc_eq (cmd
, collect_pseudocommand
))
1253 { /* repeat over a comma-separated list */
1254 QUIT
; /* allow user to bail out with ^C */
1255 while (isspace ((int) *action_exp
))
1258 if (0 == strncasecmp ("$reg", action_exp
, 4))
1260 for (i
= 0; i
< gdbarch_num_regs (t
->gdbarch
); i
++)
1261 add_register (collect
, i
);
1262 action_exp
= strchr (action_exp
, ','); /* more? */
1264 else if (0 == strncasecmp ("$arg", action_exp
, 4))
1266 add_local_symbols (collect
,
1272 action_exp
= strchr (action_exp
, ','); /* more? */
1274 else if (0 == strncasecmp ("$loc", action_exp
, 4))
1276 add_local_symbols (collect
,
1282 action_exp
= strchr (action_exp
, ','); /* more? */
1286 unsigned long addr
, len
;
1287 struct cleanup
*old_chain
= NULL
;
1288 struct cleanup
*old_chain1
= NULL
;
1289 struct agent_reqs areqs
;
1291 exp
= parse_exp_1 (&action_exp
,
1292 block_for_pc (tloc
->address
), 1);
1293 old_chain
= make_cleanup (free_current_contents
, &exp
);
1295 switch (exp
->elts
[0].opcode
)
1299 const char *name
= &exp
->elts
[2].string
;
1301 i
= user_reg_map_name_to_regnum (t
->gdbarch
,
1302 name
, strlen (name
));
1304 internal_error (__FILE__
, __LINE__
,
1305 _("Register $%s not available"),
1308 printf_filtered ("OP_REGISTER: ");
1309 add_register (collect
, i
);
1314 /* safe because we know it's a simple expression */
1315 tempval
= evaluate_expression (exp
);
1316 addr
= value_address (tempval
);
1317 len
= TYPE_LENGTH (check_typedef (exp
->elts
[1].type
));
1318 add_memrange (collect
, memrange_absolute
, addr
, len
);
1322 collect_symbol (collect
,
1323 exp
->elts
[2].symbol
,
1330 default: /* full-fledged expression */
1331 aexpr
= gen_trace_for_expr (tloc
->address
, exp
);
1333 old_chain1
= make_cleanup_free_agent_expr (aexpr
);
1335 ax_reqs (aexpr
, &areqs
);
1337 report_agent_reqs_errors (aexpr
, &areqs
);
1339 discard_cleanups (old_chain1
);
1340 add_aexpr (collect
, aexpr
);
1342 /* take care of the registers */
1343 if (areqs
.reg_mask_len
> 0)
1348 for (ndx1
= 0; ndx1
< areqs
.reg_mask_len
; ndx1
++)
1350 QUIT
; /* allow user to bail out with ^C */
1351 if (areqs
.reg_mask
[ndx1
] != 0)
1353 /* assume chars have 8 bits */
1354 for (ndx2
= 0; ndx2
< 8; ndx2
++)
1355 if (areqs
.reg_mask
[ndx1
] & (1 << ndx2
))
1356 /* it's used -- record it */
1357 add_register (collect
,
1364 do_cleanups (old_chain
);
1367 while (action_exp
&& *action_exp
++ == ',');
1369 else if (cmd_cfunc_eq (cmd
, teval_pseudocommand
))
1372 { /* repeat over a comma-separated list */
1373 QUIT
; /* allow user to bail out with ^C */
1374 while (isspace ((int) *action_exp
))
1378 unsigned long addr
, len
;
1379 struct cleanup
*old_chain
= NULL
;
1380 struct cleanup
*old_chain1
= NULL
;
1381 struct agent_reqs areqs
;
1383 exp
= parse_exp_1 (&action_exp
,
1384 block_for_pc (tloc
->address
), 1);
1385 old_chain
= make_cleanup (free_current_contents
, &exp
);
1387 aexpr
= gen_eval_for_expr (tloc
->address
, exp
);
1388 old_chain1
= make_cleanup_free_agent_expr (aexpr
);
1390 ax_reqs (aexpr
, &areqs
);
1392 report_agent_reqs_errors (aexpr
, &areqs
);
1394 discard_cleanups (old_chain1
);
1395 /* Even though we're not officially collecting, add
1396 to the collect list anyway. */
1397 add_aexpr (collect
, aexpr
);
1399 do_cleanups (old_chain
);
1402 while (action_exp
&& *action_exp
++ == ',');
1404 else if (cmd_cfunc_eq (cmd
, while_stepping_pseudocommand
))
1406 /* We check against nested while-stepping when setting
1407 breakpoint action, so no way to run into nested
1409 gdb_assert (stepping_list
);
1411 encode_actions_1 (action
->body_list
[0], t
, tloc
, frame_reg
, frame_offset
,
1412 stepping_list
, NULL
);
1415 error (_("Invalid tracepoint command '%s'"), action
->line
);
1419 /* Render all actions into gdb protocol. */
1421 encode_actions (struct breakpoint
*t
, struct bp_location
*tloc
,
1422 char ***tdp_actions
, char ***stepping_actions
)
1424 static char tdp_buff
[2048], step_buff
[2048];
1425 char *default_collect_line
= NULL
;
1426 struct command_line
*actions
;
1427 struct command_line
*default_collect_action
= NULL
;
1429 LONGEST frame_offset
;
1430 struct cleanup
*back_to
;
1432 back_to
= make_cleanup (null_cleanup
, NULL
);
1434 clear_collection_list (&tracepoint_list
);
1435 clear_collection_list (&stepping_list
);
1437 *tdp_actions
= NULL
;
1438 *stepping_actions
= NULL
;
1440 gdbarch_virtual_frame_pointer (t
->gdbarch
,
1441 t
->loc
->address
, &frame_reg
, &frame_offset
);
1443 actions
= breakpoint_commands (t
);
1445 /* If there are default expressions to collect, make up a collect
1446 action and prepend to the action list to encode. Note that since
1447 validation is per-tracepoint (local var "xyz" might be valid for
1448 one tracepoint and not another, etc), we make up the action on
1449 the fly, and don't cache it. */
1450 if (*default_collect
)
1454 default_collect_line
= xstrprintf ("collect %s", default_collect
);
1455 make_cleanup (xfree
, default_collect_line
);
1457 line
= default_collect_line
;
1458 validate_actionline (&line
, t
);
1460 default_collect_action
= xmalloc (sizeof (struct command_line
));
1461 make_cleanup (xfree
, default_collect_action
);
1462 default_collect_action
->next
= actions
;
1463 default_collect_action
->line
= line
;
1464 actions
= default_collect_action
;
1466 encode_actions_1 (actions
, t
, tloc
, frame_reg
, frame_offset
,
1467 &tracepoint_list
, &stepping_list
);
1469 memrange_sortmerge (&tracepoint_list
);
1470 memrange_sortmerge (&stepping_list
);
1472 *tdp_actions
= stringify_collection_list (&tracepoint_list
,
1474 *stepping_actions
= stringify_collection_list (&stepping_list
,
1477 do_cleanups (back_to
);
1481 add_aexpr (struct collection_list
*collect
, struct agent_expr
*aexpr
)
1483 if (collect
->next_aexpr_elt
>= collect
->aexpr_listsize
)
1485 collect
->aexpr_list
=
1486 xrealloc (collect
->aexpr_list
,
1487 2 * collect
->aexpr_listsize
* sizeof (struct agent_expr
*));
1488 collect
->aexpr_listsize
*= 2;
1490 collect
->aexpr_list
[collect
->next_aexpr_elt
] = aexpr
;
1491 collect
->next_aexpr_elt
++;
1496 start_tracing (void)
1499 VEC(breakpoint_p
) *tp_vec
= NULL
;
1501 struct breakpoint
*t
;
1502 struct trace_state_variable
*tsv
;
1503 int any_enabled
= 0;
1505 tp_vec
= all_tracepoints ();
1507 /* No point in tracing without any tracepoints... */
1508 if (VEC_length (breakpoint_p
, tp_vec
) == 0)
1510 VEC_free (breakpoint_p
, tp_vec
);
1511 error (_("No tracepoints defined, not starting trace"));
1514 for (ix
= 0; VEC_iterate (breakpoint_p
, tp_vec
, ix
, t
); ix
++)
1516 if (t
->enable_state
== bp_enabled
)
1523 /* No point in tracing with only disabled tracepoints. */
1526 VEC_free (breakpoint_p
, tp_vec
);
1527 error (_("No tracepoints enabled, not starting trace"));
1530 target_trace_init ();
1532 for (ix
= 0; VEC_iterate (breakpoint_p
, tp_vec
, ix
, t
); ix
++)
1534 t
->number_on_target
= 0;
1535 target_download_tracepoint (t
);
1536 t
->number_on_target
= t
->number
;
1538 VEC_free (breakpoint_p
, tp_vec
);
1540 /* Send down all the trace state variables too. */
1541 for (ix
= 0; VEC_iterate (tsv_s
, tvariables
, ix
, tsv
); ++ix
)
1543 target_download_trace_state_variable (tsv
);
1546 /* Tell target to treat text-like sections as transparent. */
1547 target_trace_set_readonly_regions ();
1548 /* Set some mode flags. */
1549 target_set_disconnected_tracing (disconnected_tracing
);
1550 target_set_circular_trace_buffer (circular_trace_buffer
);
1552 /* Now insert traps and begin collecting data. */
1553 target_trace_start ();
1555 /* Reset our local state. */
1556 set_traceframe_num (-1);
1557 set_tracepoint_num (-1);
1558 set_traceframe_context (NULL
);
1559 current_trace_status()->running
= 1;
1564 Tell target to clear any previous trace experiment.
1565 Walk the list of tracepoints, and send them (and their actions)
1566 to the target. If no errors,
1567 Tell target to start a new trace experiment. */
1570 trace_start_command (char *args
, int from_tty
)
1572 dont_repeat (); /* Like "run", dangerous to repeat accidentally. */
1574 if (current_trace_status ()->running
)
1577 && !query (_("A trace is running already. Start a new run? ")))
1578 error (_("New trace run not started."));
1586 trace_stop_command (char *args
, int from_tty
)
1588 if (!current_trace_status ()->running
)
1589 error (_("Trace is not running."));
1597 target_trace_stop ();
1598 /* should change in response to reply? */
1599 current_trace_status ()->running
= 0;
1602 /* tstatus command */
1604 trace_status_command (char *args
, int from_tty
)
1606 struct trace_status
*ts
= current_trace_status ();
1609 status
= target_get_trace_status (ts
);
1614 printf_filtered (_("Using a trace file.\n"));
1617 printf_filtered (_("Trace can not be run on this target.\n"));
1622 if (!ts
->running_known
)
1624 printf_filtered (_("Run/stop status is unknown.\n"));
1626 else if (ts
->running
)
1628 printf_filtered (_("Trace is running on the target.\n"));
1632 switch (ts
->stop_reason
)
1634 case trace_never_run
:
1635 printf_filtered (_("No trace has been run on the target.\n"));
1638 printf_filtered (_("Trace stopped by a tstop command.\n"));
1640 case trace_buffer_full
:
1641 printf_filtered (_("Trace stopped because the buffer was full.\n"));
1643 case trace_disconnected
:
1644 printf_filtered (_("Trace stopped because of disconnection.\n"));
1646 case tracepoint_passcount
:
1647 printf_filtered (_("Trace stopped by tracepoint %d.\n"),
1648 ts
->stopping_tracepoint
);
1650 case tracepoint_error
:
1651 if (ts
->stopping_tracepoint
)
1652 printf_filtered (_("Trace stopped by an error (%s, tracepoint %d).\n"),
1653 ts
->error_desc
, ts
->stopping_tracepoint
);
1655 printf_filtered (_("Trace stopped by an error (%s).\n"),
1658 case trace_stop_reason_unknown
:
1659 printf_filtered (_("Trace stopped for an unknown reason.\n"));
1662 printf_filtered (_("Trace stopped for some other reason (%d).\n"),
1668 if (ts
->traceframes_created
>= 0
1669 && ts
->traceframe_count
!= ts
->traceframes_created
)
1671 printf_filtered (_("Buffer contains %d trace frames (of %d created total).\n"),
1672 ts
->traceframe_count
, ts
->traceframes_created
);
1674 else if (ts
->traceframe_count
>= 0)
1676 printf_filtered (_("Collected %d trace frames.\n"),
1677 ts
->traceframe_count
);
1680 if (ts
->buffer_free
>= 0)
1682 if (ts
->buffer_size
>= 0)
1684 printf_filtered (_("Trace buffer has %d bytes of %d bytes free"),
1685 ts
->buffer_free
, ts
->buffer_size
);
1686 if (ts
->buffer_size
> 0)
1687 printf_filtered (_(" (%d%% full)"),
1688 ((int) ((((long long) (ts
->buffer_size
1689 - ts
->buffer_free
)) * 100)
1690 / ts
->buffer_size
)));
1691 printf_filtered (_(".\n"));
1694 printf_filtered (_("Trace buffer has %d bytes free.\n"),
1698 if (ts
->disconnected_tracing
)
1699 printf_filtered (_("Trace will continue if GDB disconnects.\n"));
1701 printf_filtered (_("Trace will stop if GDB disconnects.\n"));
1703 if (ts
->circular_buffer
)
1704 printf_filtered (_("Trace buffer is circular.\n"));
1706 /* Now report on what we're doing with tfind. */
1707 if (traceframe_number
>= 0)
1708 printf_filtered (_("Looking at trace frame %d, tracepoint %d.\n"),
1709 traceframe_number
, tracepoint_number
);
1711 printf_filtered (_("Not looking at any trace frame.\n"));
1714 /* Report the trace status to uiout, in a way suitable for MI, and not
1715 suitable for CLI. If ON_STOP is true, suppress a few fields that
1716 are not meaningful in the -trace-stop response.
1718 The implementation is essentially parallel to trace_status_command, but
1719 merging them will result in unreadable code. */
1721 trace_status_mi (int on_stop
)
1723 struct trace_status
*ts
= current_trace_status ();
1725 char *string_status
;
1727 status
= target_get_trace_status (ts
);
1729 if (status
== -1 && !ts
->from_file
)
1731 ui_out_field_string (uiout
, "supported", "0");
1736 ui_out_field_string (uiout
, "supported", "file");
1738 ui_out_field_string (uiout
, "supported", "1");
1740 gdb_assert (ts
->running_known
);
1744 ui_out_field_string (uiout
, "running", "1");
1746 /* Unlike CLI, do not show the state of 'disconnected-tracing' variable.
1747 Given that the frontend gets the status either on -trace-stop, or from
1748 -trace-status after re-connection, it does not seem like this
1749 information is necessary for anything. It is not necessary for either
1750 figuring the vital state of the target nor for navigation of trace
1751 frames. If the frontend wants to show the current state is some
1752 configure dialog, it can request the value when such dialog is
1753 invoked by the user. */
1757 char *stop_reason
= NULL
;
1758 int stopping_tracepoint
= -1;
1761 ui_out_field_string (uiout
, "running", "0");
1763 if (ts
->stop_reason
!= trace_stop_reason_unknown
)
1765 switch (ts
->stop_reason
)
1768 stop_reason
= "request";
1770 case trace_buffer_full
:
1771 stop_reason
= "overflow";
1773 case trace_disconnected
:
1774 stop_reason
= "disconnection";
1776 case tracepoint_passcount
:
1777 stop_reason
= "passcount";
1778 stopping_tracepoint
= ts
->stopping_tracepoint
;
1780 case tracepoint_error
:
1781 stop_reason
= "error";
1782 stopping_tracepoint
= ts
->stopping_tracepoint
;
1788 ui_out_field_string (uiout
, "stop-reason", stop_reason
);
1789 if (stopping_tracepoint
!= -1)
1790 ui_out_field_int (uiout
, "stopping-tracepoint",
1791 stopping_tracepoint
);
1792 if (ts
->stop_reason
== tracepoint_error
)
1793 ui_out_field_string (uiout
, "error-description",
1799 if (ts
->traceframe_count
!= -1)
1800 ui_out_field_int (uiout
, "frames", ts
->traceframe_count
);
1801 if (ts
->buffer_size
!= -1)
1802 ui_out_field_int (uiout
, "buffer-size", ts
->buffer_size
);
1803 if (ts
->buffer_free
!= -1)
1804 ui_out_field_int (uiout
, "buffer-free", ts
->buffer_free
);
1806 ui_out_field_int (uiout
, "disconnected", ts
->disconnected_tracing
);
1807 ui_out_field_int (uiout
, "circular", ts
->circular_buffer
);
1810 /* This function handles the details of what to do about an ongoing
1811 tracing run if the user has asked to detach or otherwise disconnect
1814 disconnect_tracing (int from_tty
)
1816 /* It can happen that the target that was tracing went away on its
1817 own, and we didn't notice. Get a status update, and if the
1818 current target doesn't even do tracing, then assume it's not
1820 if (target_get_trace_status (current_trace_status ()) < 0)
1821 current_trace_status ()->running
= 0;
1823 /* If running interactively, give the user the option to cancel and
1824 then decide what to do differently with the run. Scripts are
1825 just going to disconnect and let the target deal with it,
1826 according to how it's been instructed previously via
1827 disconnected-tracing. */
1828 if (current_trace_status ()->running
&& from_tty
)
1830 if (current_trace_status ()->disconnected_tracing
)
1832 if (!query (_("Trace is running and will continue after detach; detach anyway? ")))
1833 error (_("Not confirmed."));
1837 if (!query (_("Trace is running but will stop on detach; detach anyway? ")))
1838 error (_("Not confirmed."));
1842 /* Also we want to be out of tfind mode, otherwise things can get
1843 confusing upon reconnection. Just use these calls instead of
1844 full tfind_1 behavior because we're in the middle of detaching,
1845 and there's no point to updating current stack frame etc. */
1846 set_traceframe_number (-1);
1847 set_traceframe_context (NULL
);
1850 /* Worker function for the various flavors of the tfind command. */
1852 tfind_1 (enum trace_find_type type
, int num
,
1853 ULONGEST addr1
, ULONGEST addr2
,
1856 int target_frameno
= -1, target_tracept
= -1;
1857 struct frame_id old_frame_id
;
1859 struct breakpoint
*tp
;
1861 old_frame_id
= get_frame_id (get_current_frame ());
1863 target_frameno
= target_trace_find (type
, num
, addr1
, addr2
,
1866 if (type
== tfind_number
1868 && target_frameno
== -1)
1870 /* We told the target to get out of tfind mode, and it did. */
1872 else if (target_frameno
== -1)
1874 /* A request for a non-existant trace frame has failed.
1875 Our response will be different, depending on FROM_TTY:
1877 If FROM_TTY is true, meaning that this command was
1878 typed interactively by the user, then give an error
1879 and DO NOT change the state of traceframe_number etc.
1881 However if FROM_TTY is false, meaning that we're either
1882 in a script, a loop, or a user-defined command, then
1883 DON'T give an error, but DO change the state of
1884 traceframe_number etc. to invalid.
1886 The rationalle is that if you typed the command, you
1887 might just have committed a typo or something, and you'd
1888 like to NOT lose your current debugging state. However
1889 if you're in a user-defined command or especially in a
1890 loop, then you need a way to detect that the command
1891 failed WITHOUT aborting. This allows you to write
1892 scripts that search thru the trace buffer until the end,
1893 and then continue on to do something else. */
1896 error (_("Target failed to find requested trace frame."));
1900 printf_filtered ("End of trace buffer.\n");
1901 #if 0 /* dubious now? */
1902 /* The following will not recurse, since it's
1904 trace_find_command ("-1", from_tty
);
1909 tp
= get_tracepoint_by_number_on_target (target_tracept
);
1911 reinit_frame_cache ();
1912 registers_changed ();
1913 target_dcache_invalidate ();
1914 set_traceframe_num (target_frameno
);
1915 set_tracepoint_num (tp
? tp
->number
: target_tracept
);
1916 if (target_frameno
== -1)
1917 set_traceframe_context (NULL
);
1919 set_traceframe_context (get_current_frame ());
1921 if (traceframe_number
>= 0)
1923 /* Use different branches for MI and CLI to make CLI messages
1925 if (ui_out_is_mi_like_p (uiout
))
1927 ui_out_field_string (uiout
, "found", "1");
1928 ui_out_field_int (uiout
, "tracepoint", tracepoint_number
);
1929 ui_out_field_int (uiout
, "traceframe", traceframe_number
);
1933 printf_unfiltered (_("Found trace frame %d, tracepoint %d\n"),
1934 traceframe_number
, tracepoint_number
);
1939 if (ui_out_is_mi_like_p (uiout
))
1940 ui_out_field_string (uiout
, "found", "0");
1942 printf_unfiltered (_("No trace frame found"));
1945 /* If we're in nonstop mode and getting out of looking at trace
1946 frames, there won't be any current frame to go back to and
1949 && (has_stack_frames () || traceframe_number
>= 0))
1951 enum print_what print_what
;
1953 /* NOTE: in immitation of the step command, try to determine
1954 whether we have made a transition from one function to
1955 another. If so, we'll print the "stack frame" (ie. the new
1956 function and it's arguments) -- otherwise we'll just show the
1959 if (frame_id_eq (old_frame_id
,
1960 get_frame_id (get_current_frame ())))
1961 print_what
= SRC_LINE
;
1963 print_what
= SRC_AND_LOC
;
1965 print_stack_frame (get_selected_frame (NULL
), 1, print_what
);
1970 /* trace_find_command takes a trace frame number n,
1971 sends "QTFrame:<n>" to the target,
1972 and accepts a reply that may contain several optional pieces
1973 of information: a frame number, a tracepoint number, and an
1974 indication of whether this is a trap frame or a stepping frame.
1976 The minimal response is just "OK" (which indicates that the
1977 target does not give us a frame number or a tracepoint number).
1978 Instead of that, the target may send us a string containing
1980 F<hexnum> (gives the selected frame number)
1981 T<hexnum> (gives the selected tracepoint number)
1986 trace_find_command (char *args
, int from_tty
)
1987 { /* this should only be called with a numeric argument */
1990 if (current_trace_status ()->running
&& !current_trace_status ()->from_file
)
1991 error ("May not look at trace frames while trace is running.");
1993 if (args
== 0 || *args
== 0)
1994 { /* TFIND with no args means find NEXT trace frame. */
1995 if (traceframe_number
== -1)
1996 frameno
= 0; /* "next" is first one */
1998 frameno
= traceframe_number
+ 1;
2000 else if (0 == strcmp (args
, "-"))
2002 if (traceframe_number
== -1)
2003 error (_("not debugging trace buffer"));
2004 else if (from_tty
&& traceframe_number
== 0)
2005 error (_("already at start of trace buffer"));
2007 frameno
= traceframe_number
- 1;
2009 /* A hack to work around eval's need for fp to have been collected. */
2010 else if (0 == strcmp (args
, "-1"))
2013 frameno
= parse_and_eval_long (args
);
2016 error (_("invalid input (%d is less than zero)"), frameno
);
2018 tfind_1 (tfind_number
, frameno
, 0, 0, from_tty
);
2023 trace_find_end_command (char *args
, int from_tty
)
2025 trace_find_command ("-1", from_tty
);
2030 trace_find_none_command (char *args
, int from_tty
)
2032 trace_find_command ("-1", from_tty
);
2037 trace_find_start_command (char *args
, int from_tty
)
2039 trace_find_command ("0", from_tty
);
2042 /* tfind pc command */
2044 trace_find_pc_command (char *args
, int from_tty
)
2049 if (current_trace_status ()->running
&& !current_trace_status ()->from_file
)
2050 error ("May not look at trace frames while trace is running.");
2052 if (args
== 0 || *args
== 0)
2053 pc
= regcache_read_pc (get_current_regcache ());
2055 pc
= parse_and_eval_address (args
);
2057 tfind_1 (tfind_pc
, 0, pc
, 0, from_tty
);
2060 /* tfind tracepoint command */
2062 trace_find_tracepoint_command (char *args
, int from_tty
)
2065 struct breakpoint
*tp
;
2067 if (current_trace_status ()->running
&& !current_trace_status ()->from_file
)
2068 error ("May not look at trace frames while trace is running.");
2070 if (args
== 0 || *args
== 0)
2072 if (tracepoint_number
== -1)
2073 error (_("No current tracepoint -- please supply an argument."));
2075 tdp
= tracepoint_number
; /* default is current TDP */
2078 tdp
= parse_and_eval_long (args
);
2080 /* If we have the tracepoint on hand, use the number that the
2081 target knows about (which may be different if we disconnected
2082 and reconnected). */
2083 tp
= get_tracepoint (tdp
);
2085 tdp
= tp
->number_on_target
;
2087 tfind_1 (tfind_tp
, tdp
, 0, 0, from_tty
);
2090 /* TFIND LINE command:
2092 This command will take a sourceline for argument, just like BREAK
2093 or TRACE (ie. anything that "decode_line_1" can handle).
2095 With no argument, this command will find the next trace frame
2096 corresponding to a source line OTHER THAN THE CURRENT ONE. */
2099 trace_find_line_command (char *args
, int from_tty
)
2101 static CORE_ADDR start_pc
, end_pc
;
2102 struct symtabs_and_lines sals
;
2103 struct symtab_and_line sal
;
2104 struct cleanup
*old_chain
;
2105 char startpc_str
[40], endpc_str
[40];
2107 if (current_trace_status ()->running
&& !current_trace_status ()->from_file
)
2108 error ("May not look at trace frames while trace is running.");
2110 if (args
== 0 || *args
== 0)
2112 sal
= find_pc_line (get_frame_pc (get_current_frame ()), 0);
2114 sals
.sals
= (struct symtab_and_line
*)
2115 xmalloc (sizeof (struct symtab_and_line
));
2120 sals
= decode_line_spec (args
, 1);
2124 old_chain
= make_cleanup (xfree
, sals
.sals
);
2125 if (sal
.symtab
== 0)
2126 error (_("No line number information available."));
2128 if (sal
.line
> 0 && find_line_pc_range (sal
, &start_pc
, &end_pc
))
2130 if (start_pc
== end_pc
)
2132 printf_filtered ("Line %d of \"%s\"",
2133 sal
.line
, sal
.symtab
->filename
);
2135 printf_filtered (" is at address ");
2136 print_address (get_current_arch (), start_pc
, gdb_stdout
);
2138 printf_filtered (" but contains no code.\n");
2139 sal
= find_pc_line (start_pc
, 0);
2141 && find_line_pc_range (sal
, &start_pc
, &end_pc
)
2142 && start_pc
!= end_pc
)
2143 printf_filtered ("Attempting to find line %d instead.\n",
2146 error (_("Cannot find a good line."));
2150 /* Is there any case in which we get here, and have an address
2151 which the user would want to see? If we have debugging
2152 symbols and no line numbers? */
2153 error (_("Line number %d is out of range for \"%s\"."),
2154 sal
.line
, sal
.symtab
->filename
);
2156 /* Find within range of stated line. */
2158 tfind_1 (tfind_range
, 0, start_pc
, end_pc
- 1, from_tty
);
2160 tfind_1 (tfind_outside
, 0, start_pc
, end_pc
- 1, from_tty
);
2161 do_cleanups (old_chain
);
2164 /* tfind range command */
2166 trace_find_range_command (char *args
, int from_tty
)
2168 static CORE_ADDR start
, stop
;
2169 char start_str
[40], stop_str
[40];
2172 if (current_trace_status ()->running
&& !current_trace_status ()->from_file
)
2173 error ("May not look at trace frames while trace is running.");
2175 if (args
== 0 || *args
== 0)
2176 { /* XXX FIXME: what should default behavior be? */
2177 printf_filtered ("Usage: tfind range <startaddr>,<endaddr>\n");
2181 if (0 != (tmp
= strchr (args
, ',')))
2183 *tmp
++ = '\0'; /* terminate start address */
2184 while (isspace ((int) *tmp
))
2186 start
= parse_and_eval_address (args
);
2187 stop
= parse_and_eval_address (tmp
);
2190 { /* no explicit end address? */
2191 start
= parse_and_eval_address (args
);
2192 stop
= start
+ 1; /* ??? */
2195 tfind_1 (tfind_range
, 0, start
, stop
, from_tty
);
2198 /* tfind outside command */
2200 trace_find_outside_command (char *args
, int from_tty
)
2202 CORE_ADDR start
, stop
;
2203 char start_str
[40], stop_str
[40];
2206 if (current_trace_status ()->running
&& !current_trace_status ()->from_file
)
2207 error ("May not look at trace frames while trace is running.");
2209 if (args
== 0 || *args
== 0)
2210 { /* XXX FIXME: what should default behavior be? */
2211 printf_filtered ("Usage: tfind outside <startaddr>,<endaddr>\n");
2215 if (0 != (tmp
= strchr (args
, ',')))
2217 *tmp
++ = '\0'; /* terminate start address */
2218 while (isspace ((int) *tmp
))
2220 start
= parse_and_eval_address (args
);
2221 stop
= parse_and_eval_address (tmp
);
2224 { /* no explicit end address? */
2225 start
= parse_and_eval_address (args
);
2226 stop
= start
+ 1; /* ??? */
2229 tfind_1 (tfind_outside
, 0, start
, stop
, from_tty
);
2232 /* info scope command: list the locals for a scope. */
2234 scope_info (char *args
, int from_tty
)
2236 struct symtabs_and_lines sals
;
2238 struct minimal_symbol
*msym
;
2239 struct block
*block
;
2240 char **canonical
, *symname
, *save_args
= args
;
2241 struct dict_iterator iter
;
2243 struct gdbarch
*gdbarch
;
2246 if (args
== 0 || *args
== 0)
2247 error (_("requires an argument (function, line or *addr) to define a scope"));
2249 sals
= decode_line_1 (&args
, 1, NULL
, 0, &canonical
, NULL
);
2250 if (sals
.nelts
== 0)
2251 return; /* presumably decode_line_1 has already warned */
2253 /* Resolve line numbers to PC */
2254 resolve_sal_pc (&sals
.sals
[0]);
2255 block
= block_for_pc (sals
.sals
[0].pc
);
2259 QUIT
; /* allow user to bail out with ^C */
2260 ALL_BLOCK_SYMBOLS (block
, iter
, sym
)
2262 QUIT
; /* allow user to bail out with ^C */
2264 printf_filtered ("Scope for %s:\n", save_args
);
2267 symname
= SYMBOL_PRINT_NAME (sym
);
2268 if (symname
== NULL
|| *symname
== '\0')
2269 continue; /* probably botched, certainly useless */
2271 gdbarch
= get_objfile_arch (SYMBOL_SYMTAB (sym
)->objfile
);
2273 printf_filtered ("Symbol %s is ", symname
);
2274 switch (SYMBOL_CLASS (sym
))
2277 case LOC_UNDEF
: /* messed up symbol? */
2278 printf_filtered ("a bogus symbol, class %d.\n",
2279 SYMBOL_CLASS (sym
));
2280 count
--; /* don't count this one */
2283 printf_filtered ("a constant with value %ld (0x%lx)",
2284 SYMBOL_VALUE (sym
), SYMBOL_VALUE (sym
));
2286 case LOC_CONST_BYTES
:
2287 printf_filtered ("constant bytes: ");
2288 if (SYMBOL_TYPE (sym
))
2289 for (j
= 0; j
< TYPE_LENGTH (SYMBOL_TYPE (sym
)); j
++)
2290 fprintf_filtered (gdb_stdout
, " %02x",
2291 (unsigned) SYMBOL_VALUE_BYTES (sym
)[j
]);
2294 printf_filtered ("in static storage at address ");
2295 printf_filtered ("%s", paddress (gdbarch
,
2296 SYMBOL_VALUE_ADDRESS (sym
)));
2299 /* GDBARCH is the architecture associated with the objfile
2300 the symbol is defined in; the target architecture may be
2301 different, and may provide additional registers. However,
2302 we do not know the target architecture at this point.
2303 We assume the objfile architecture will contain all the
2304 standard registers that occur in debug info in that
2306 regno
= SYMBOL_REGISTER_OPS (sym
)->register_number (sym
, gdbarch
);
2308 if (SYMBOL_IS_ARGUMENT (sym
))
2309 printf_filtered ("an argument in register $%s",
2310 gdbarch_register_name (gdbarch
, regno
));
2312 printf_filtered ("a local variable in register $%s",
2313 gdbarch_register_name (gdbarch
, regno
));
2316 printf_filtered ("an argument at stack/frame offset %ld",
2317 SYMBOL_VALUE (sym
));
2320 printf_filtered ("a local variable at frame offset %ld",
2321 SYMBOL_VALUE (sym
));
2324 printf_filtered ("a reference argument at offset %ld",
2325 SYMBOL_VALUE (sym
));
2327 case LOC_REGPARM_ADDR
:
2328 /* Note comment at LOC_REGISTER. */
2329 regno
= SYMBOL_REGISTER_OPS (sym
)->register_number (sym
, gdbarch
);
2330 printf_filtered ("the address of an argument, in register $%s",
2331 gdbarch_register_name (gdbarch
, regno
));
2334 printf_filtered ("a typedef.\n");
2337 printf_filtered ("a label at address ");
2338 printf_filtered ("%s", paddress (gdbarch
,
2339 SYMBOL_VALUE_ADDRESS (sym
)));
2342 printf_filtered ("a function at address ");
2343 printf_filtered ("%s",
2344 paddress (gdbarch
, BLOCK_START (SYMBOL_BLOCK_VALUE (sym
))));
2346 case LOC_UNRESOLVED
:
2347 msym
= lookup_minimal_symbol (SYMBOL_LINKAGE_NAME (sym
),
2350 printf_filtered ("Unresolved Static");
2353 printf_filtered ("static storage at address ");
2354 printf_filtered ("%s",
2355 paddress (gdbarch
, SYMBOL_VALUE_ADDRESS (msym
)));
2358 case LOC_OPTIMIZED_OUT
:
2359 printf_filtered ("optimized out.\n");
2362 SYMBOL_COMPUTED_OPS (sym
)->describe_location (sym
, gdb_stdout
);
2365 if (SYMBOL_TYPE (sym
))
2366 printf_filtered (", length %d.\n",
2367 TYPE_LENGTH (check_typedef (SYMBOL_TYPE (sym
))));
2369 if (BLOCK_FUNCTION (block
))
2372 block
= BLOCK_SUPERBLOCK (block
);
2375 printf_filtered ("Scope for %s contains no locals or arguments.\n",
2379 /* worker function (cleanup) */
2381 replace_comma (void *data
)
2388 /* Helper for trace_dump_command. Dump the action list starting at
2389 ACTION. STEPPING_ACTIONS is true if we're iterating over the
2390 actions of the body of a while-stepping action. STEPPING_FRAME is
2391 set if the current traceframe was determined to be a while-stepping
2395 trace_dump_actions (struct command_line
*action
,
2396 int stepping_actions
, int stepping_frame
,
2399 char *action_exp
, *next_comma
;
2401 for (; action
!= NULL
; action
= action
->next
)
2403 struct cmd_list_element
*cmd
;
2405 QUIT
; /* allow user to bail out with ^C */
2406 action_exp
= action
->line
;
2407 while (isspace ((int) *action_exp
))
2410 /* The collection actions to be done while stepping are
2411 bracketed by the commands "while-stepping" and "end". */
2413 if (*action_exp
== '#') /* comment line */
2416 cmd
= lookup_cmd (&action_exp
, cmdlist
, "", -1, 1);
2418 error (_("Bad action list item: %s"), action_exp
);
2420 if (cmd_cfunc_eq (cmd
, while_stepping_pseudocommand
))
2424 for (i
= 0; i
< action
->body_count
; ++i
)
2425 trace_dump_actions (action
->body_list
[i
],
2426 1, stepping_frame
, from_tty
);
2428 else if (cmd_cfunc_eq (cmd
, collect_pseudocommand
))
2430 /* Display the collected data.
2431 For the trap frame, display only what was collected at
2432 the trap. Likewise for stepping frames, display only
2433 what was collected while stepping. This means that the
2434 two boolean variables, STEPPING_FRAME and
2435 STEPPING_ACTIONS should be equal. */
2436 if (stepping_frame
== stepping_actions
)
2439 { /* repeat over a comma-separated list */
2440 QUIT
; /* allow user to bail out with ^C */
2441 if (*action_exp
== ',')
2443 while (isspace ((int) *action_exp
))
2446 next_comma
= strchr (action_exp
, ',');
2448 if (0 == strncasecmp (action_exp
, "$reg", 4))
2449 registers_info (NULL
, from_tty
);
2450 else if (0 == strncasecmp (action_exp
, "$loc", 4))
2451 locals_info (NULL
, from_tty
);
2452 else if (0 == strncasecmp (action_exp
, "$arg", 4))
2453 args_info (NULL
, from_tty
);
2458 make_cleanup (replace_comma
, next_comma
);
2461 printf_filtered ("%s = ", action_exp
);
2462 output_command (action_exp
, from_tty
);
2463 printf_filtered ("\n");
2467 action_exp
= next_comma
;
2469 while (action_exp
&& *action_exp
== ',');
2475 /* The tdump command. */
2478 trace_dump_command (char *args
, int from_tty
)
2480 struct regcache
*regcache
;
2481 struct breakpoint
*t
;
2482 int stepping_frame
= 0;
2483 struct bp_location
*loc
;
2485 if (tracepoint_number
== -1)
2487 warning (_("No current trace frame."));
2491 t
= get_tracepoint (tracepoint_number
);
2494 error (_("No known tracepoint matches 'current' tracepoint #%d."),
2497 printf_filtered ("Data collected at tracepoint %d, trace frame %d:\n",
2498 tracepoint_number
, traceframe_number
);
2500 /* The current frame is a trap frame if the frame PC is equal
2501 to the tracepoint PC. If not, then the current frame was
2502 collected during single-stepping. */
2504 regcache
= get_current_regcache ();
2506 /* If the traceframe's address matches any of the tracepoint's
2507 locations, assume it is a direct hit rather than a while-stepping
2508 frame. (FIXME this is not reliable, should record each frame's
2511 for (loc
= t
->loc
; loc
; loc
= loc
->next
)
2512 if (loc
->address
== regcache_read_pc (regcache
))
2515 trace_dump_actions (breakpoint_commands (t
), 0, stepping_frame
, from_tty
);
2518 /* Encode a piece of a tracepoint's source-level definition in a form
2519 that is suitable for both protocol and saving in files. */
2520 /* This version does not do multiple encodes for long strings; it should
2521 return an offset to the next piece to encode. FIXME */
2524 encode_source_string (int tpnum
, ULONGEST addr
,
2525 char *srctype
, char *src
, char *buf
, int buf_size
)
2527 if (80 + strlen (srctype
) > buf_size
)
2528 error (_("Buffer too small for source encoding"));
2529 sprintf (buf
, "%x:%s:%s:%x:%x:",
2530 tpnum
, phex_nz (addr
, sizeof (addr
)), srctype
, 0, (int) strlen (src
));
2531 if (strlen (buf
) + strlen (src
) * 2 >= buf_size
)
2532 error (_("Source string too long for buffer"));
2533 bin2hex (src
, buf
+ strlen (buf
), 0);
2537 extern int trace_regblock_size
;
2539 /* Save tracepoint data to file named FILENAME. If TARGET_DOES_SAVE is
2540 non-zero, the save is performed on the target, otherwise GDB obtains all
2541 trace data and saves it locally. */
2544 trace_save (const char *filename
, int target_does_save
)
2546 struct cleanup
*cleanup
;
2548 struct trace_status
*ts
= current_trace_status ();
2551 struct uploaded_tp
*uploaded_tps
= NULL
, *utp
;
2552 struct uploaded_tsv
*uploaded_tsvs
= NULL
, *utsv
;
2556 ULONGEST offset
= 0;
2557 #define MAX_TRACE_UPLOAD 2000
2558 gdb_byte buf
[MAX_TRACE_UPLOAD
];
2561 /* If the target is to save the data to a file on its own, then just
2562 send the command and be done with it. */
2563 if (target_does_save
)
2565 err
= target_save_trace_data (filename
);
2567 error (_("Target failed to save trace data to '%s'."),
2572 /* Get the trace status first before opening the file, so if the
2573 target is losing, we can get out without touching files. */
2574 status
= target_get_trace_status (ts
);
2576 pathname
= tilde_expand (filename
);
2577 cleanup
= make_cleanup (xfree
, pathname
);
2579 fp
= fopen (pathname
, "w");
2581 error (_("Unable to open file '%s' for saving trace data (%s)"),
2582 filename
, safe_strerror (errno
));
2583 make_cleanup_fclose (fp
);
2585 /* Write a file header, with a high-bit-set char to indicate a
2586 binary file, plus a hint as what this file is, and a version
2587 number in case of future needs. */
2588 written
= fwrite ("\x7fTRACE0\n", 8, 1, fp
);
2590 perror_with_name (pathname
);
2592 /* Write descriptive info. */
2594 /* Write out the size of a register block. */
2595 fprintf (fp
, "R %x\n", trace_regblock_size
);
2597 /* Write out status of the tracing run (aka "tstatus" info). */
2598 fprintf (fp
, "status %c;%s",
2599 (ts
->running
? '1' : '0'), stop_reason_names
[ts
->stop_reason
]);
2600 if (ts
->stop_reason
== tracepoint_error
)
2602 char *buf
= (char *) alloca (strlen (ts
->error_desc
) * 2 + 1);
2603 bin2hex ((gdb_byte
*) ts
->error_desc
, buf
, 0);
2604 fprintf (fp
, ":%s", buf
);
2606 fprintf (fp
, ":%x", ts
->stopping_tracepoint
);
2607 if (ts
->traceframe_count
>= 0)
2608 fprintf (fp
, ";tframes:%x", ts
->traceframe_count
);
2609 if (ts
->traceframes_created
>= 0)
2610 fprintf (fp
, ";tcreated:%x", ts
->traceframes_created
);
2611 if (ts
->buffer_free
>= 0)
2612 fprintf (fp
, ";tfree:%x", ts
->buffer_free
);
2613 if (ts
->buffer_size
>= 0)
2614 fprintf (fp
, ";tsize:%x", ts
->buffer_size
);
2615 if (ts
->disconnected_tracing
)
2616 fprintf (fp
, ";disconn:%x", ts
->disconnected_tracing
);
2617 if (ts
->circular_buffer
)
2618 fprintf (fp
, ";circular:%x", ts
->circular_buffer
);
2621 /* Note that we want to upload tracepoints and save those, rather
2622 than simply writing out the local ones, because the user may have
2623 changed tracepoints in GDB in preparation for a future tracing
2624 run, or maybe just mass-deleted all types of breakpoints as part
2625 of cleaning up. So as not to contaminate the session, leave the
2626 data in its uploaded form, don't make into real tracepoints. */
2628 /* Get trace state variables first, they may be checked when parsing
2629 uploaded commands. */
2631 target_upload_trace_state_variables (&uploaded_tsvs
);
2633 for (utsv
= uploaded_tsvs
; utsv
; utsv
= utsv
->next
)
2639 buf
= (char *) xmalloc (strlen (utsv
->name
) * 2 + 1);
2640 bin2hex ((gdb_byte
*) (utsv
->name
), buf
, 0);
2643 fprintf (fp
, "tsv %x:%s:%x:%s\n",
2644 utsv
->number
, phex_nz (utsv
->initial_value
, 8),
2645 utsv
->builtin
, buf
);
2651 free_uploaded_tsvs (&uploaded_tsvs
);
2653 target_upload_tracepoints (&uploaded_tps
);
2655 for (utp
= uploaded_tps
; utp
; utp
= utp
->next
)
2657 fprintf (fp
, "tp T%x:%s:%c:%x:%x",
2658 utp
->number
, phex_nz (utp
->addr
, sizeof (utp
->addr
)),
2659 (utp
->enabled
? 'E' : 'D'), utp
->step
, utp
->pass
);
2660 if (utp
->type
== bp_fast_tracepoint
)
2661 fprintf (fp
, ":F%x", utp
->orig_size
);
2663 fprintf (fp
, ":X%x,%s", (unsigned int) strlen (utp
->cond
) / 2,
2666 for (a
= 0; VEC_iterate (char_ptr
, utp
->actions
, a
, act
); ++a
)
2667 fprintf (fp
, "tp A%x:%s:%s\n",
2668 utp
->number
, phex_nz (utp
->addr
, sizeof (utp
->addr
)), act
);
2669 for (a
= 0; VEC_iterate (char_ptr
, utp
->actions
, a
, act
); ++a
)
2670 fprintf (fp
, "tp S%x:%s:%s\n",
2671 utp
->number
, phex_nz (utp
->addr
, sizeof (utp
->addr
)), act
);
2674 encode_source_string (utp
->number
, utp
->addr
,
2675 "at", utp
->at_string
, buf
, MAX_TRACE_UPLOAD
);
2676 fprintf (fp
, "tp Z%s\n", buf
);
2678 if (utp
->cond_string
)
2680 encode_source_string (utp
->number
, utp
->addr
,
2681 "cond", utp
->cond_string
, buf
, MAX_TRACE_UPLOAD
);
2682 fprintf (fp
, "tp Z%s\n", buf
);
2684 for (a
= 0; VEC_iterate (char_ptr
, utp
->cmd_strings
, a
, act
); ++a
)
2686 encode_source_string (utp
->number
, utp
->addr
, "cmd", act
,
2687 buf
, MAX_TRACE_UPLOAD
);
2688 fprintf (fp
, "tp Z%s\n", buf
);
2692 free_uploaded_tps (&uploaded_tps
);
2694 /* Mark the end of the definition section. */
2697 /* Get and write the trace data proper. We ask for big blocks, in
2698 the hopes of efficiency, but will take less if the target has
2699 packet size limitations or some such. */
2702 gotten
= target_get_raw_trace_data (buf
, offset
, MAX_TRACE_UPLOAD
);
2704 error (_("Failure to get requested trace buffer data"));
2705 /* No more data is forthcoming, we're done. */
2708 written
= fwrite (buf
, gotten
, 1, fp
);
2710 perror_with_name (pathname
);
2714 /* Mark the end of trace data. (We know that gotten is 0 at this point.) */
2715 written
= fwrite (&gotten
, 4, 1, fp
);
2717 perror_with_name (pathname
);
2719 do_cleanups (cleanup
);
2723 trace_save_command (char *args
, int from_tty
)
2725 int target_does_save
= 0;
2727 char *filename
= NULL
;
2728 struct cleanup
*back_to
;
2731 error_no_arg (_("file in which to save trace data"));
2733 argv
= gdb_buildargv (args
);
2734 back_to
= make_cleanup_freeargv (argv
);
2736 for (; *argv
; ++argv
)
2738 if (strcmp (*argv
, "-r") == 0)
2739 target_does_save
= 1;
2740 else if (**argv
== '-')
2741 error (_("unknown option `%s'"), *argv
);
2747 error_no_arg (_("file in which to save trace data"));
2749 trace_save (filename
, target_does_save
);
2752 printf_filtered (_("Trace data saved to file '%s'.\n"), args
);
2754 do_cleanups (back_to
);
2757 /* Tell the target what to do with an ongoing tracing run if GDB
2758 disconnects for some reason. */
2761 send_disconnected_tracing_value (int value
)
2763 target_set_disconnected_tracing (value
);
2767 set_disconnected_tracing (char *args
, int from_tty
,
2768 struct cmd_list_element
*c
)
2770 send_disconnected_tracing_value (disconnected_tracing
);
2774 set_circular_trace_buffer (char *args
, int from_tty
,
2775 struct cmd_list_element
*c
)
2777 target_set_circular_trace_buffer (circular_trace_buffer
);
2780 /* Convert the memory pointed to by mem into hex, placing result in buf.
2781 * Return a pointer to the last char put in buf (null)
2782 * "stolen" from sparc-stub.c
2785 static const char hexchars
[] = "0123456789abcdef";
2788 mem2hex (gdb_byte
*mem
, char *buf
, int count
)
2796 *buf
++ = hexchars
[ch
>> 4];
2797 *buf
++ = hexchars
[ch
& 0xf];
2806 get_traceframe_number (void)
2808 return traceframe_number
;
2811 /* Make the traceframe NUM be the current trace frame. Does nothing
2812 if NUM is already current. */
2815 set_traceframe_number (int num
)
2819 if (traceframe_number
== num
)
2821 /* Nothing to do. */
2825 newnum
= target_trace_find (tfind_number
, num
, 0, 0, NULL
);
2828 warning (_("could not change traceframe"));
2830 traceframe_number
= newnum
;
2832 /* Changing the traceframe changes our view of registers and of the
2834 registers_changed ();
2837 /* A cleanup used when switching away and back from tfind mode. */
2839 struct current_traceframe_cleanup
2841 /* The traceframe we were inspecting. */
2842 int traceframe_number
;
2846 do_restore_current_traceframe_cleanup (void *arg
)
2848 struct current_traceframe_cleanup
*old
= arg
;
2850 set_traceframe_number (old
->traceframe_number
);
2854 restore_current_traceframe_cleanup_dtor (void *arg
)
2856 struct current_traceframe_cleanup
*old
= arg
;
2862 make_cleanup_restore_current_traceframe (void)
2864 struct current_traceframe_cleanup
*old
;
2866 old
= xmalloc (sizeof (struct current_traceframe_cleanup
));
2867 old
->traceframe_number
= traceframe_number
;
2869 return make_cleanup_dtor (do_restore_current_traceframe_cleanup
, old
,
2870 restore_current_traceframe_cleanup_dtor
);
2873 /* Given a number and address, return an uploaded tracepoint with that
2874 number, creating if necessary. */
2876 struct uploaded_tp
*
2877 get_uploaded_tp (int num
, ULONGEST addr
, struct uploaded_tp
**utpp
)
2879 struct uploaded_tp
*utp
;
2881 for (utp
= *utpp
; utp
; utp
= utp
->next
)
2882 if (utp
->number
== num
&& utp
->addr
== addr
)
2884 utp
= (struct uploaded_tp
*) xmalloc (sizeof (struct uploaded_tp
));
2885 memset (utp
, 0, sizeof (struct uploaded_tp
));
2888 utp
->actions
= NULL
;
2889 utp
->step_actions
= NULL
;
2890 utp
->cmd_strings
= NULL
;
2897 free_uploaded_tps (struct uploaded_tp
**utpp
)
2899 struct uploaded_tp
*next_one
;
2903 next_one
= (*utpp
)->next
;
2909 /* Given a number and address, return an uploaded tracepoint with that
2910 number, creating if necessary. */
2912 struct uploaded_tsv
*
2913 get_uploaded_tsv (int num
, struct uploaded_tsv
**utsvp
)
2915 struct uploaded_tsv
*utsv
;
2917 for (utsv
= *utsvp
; utsv
; utsv
= utsv
->next
)
2918 if (utsv
->number
== num
)
2920 utsv
= (struct uploaded_tsv
*) xmalloc (sizeof (struct uploaded_tsv
));
2921 memset (utsv
, 0, sizeof (struct uploaded_tsv
));
2923 utsv
->next
= *utsvp
;
2929 free_uploaded_tsvs (struct uploaded_tsv
**utsvp
)
2931 struct uploaded_tsv
*next_one
;
2935 next_one
= (*utsvp
)->next
;
2941 /* Look for an existing tracepoint that seems similar enough to the
2942 uploaded one. Enablement isn't compared, because the user can
2943 toggle that freely, and may have done so in anticipation of the
2947 find_matching_tracepoint (struct uploaded_tp
*utp
)
2949 VEC(breakpoint_p
) *tp_vec
= all_tracepoints ();
2951 struct breakpoint
*t
;
2952 struct bp_location
*loc
;
2954 for (ix
= 0; VEC_iterate (breakpoint_p
, tp_vec
, ix
, t
); ix
++)
2956 if (t
->type
== utp
->type
2957 && t
->step_count
== utp
->step
2958 && t
->pass_count
== utp
->pass
2959 /* FIXME also test conditionals and actions */
2962 /* Scan the locations for an address match. */
2963 for (loc
= t
->loc
; loc
; loc
= loc
->next
)
2965 if (loc
->address
== utp
->addr
)
2973 /* Given a list of tracepoints uploaded from a target, attempt to
2974 match them up with existing tracepoints, and create new ones if not
2978 merge_uploaded_tracepoints (struct uploaded_tp
**uploaded_tps
)
2980 struct uploaded_tp
*utp
;
2981 struct breakpoint
*t
;
2983 /* Look for GDB tracepoints that match up with our uploaded versions. */
2984 for (utp
= *uploaded_tps
; utp
; utp
= utp
->next
)
2986 t
= find_matching_tracepoint (utp
);
2988 printf_filtered (_("Assuming tracepoint %d is same as target's tracepoint %d at %s.\n"),
2989 t
->number
, utp
->number
, paddress (get_current_arch (), utp
->addr
));
2992 t
= create_tracepoint_from_upload (utp
);
2994 printf_filtered (_("Created tracepoint %d for target's tracepoint %d at %s.\n"),
2995 t
->number
, utp
->number
, paddress (get_current_arch (), utp
->addr
));
2997 printf_filtered (_("Failed to create tracepoint for target's tracepoint %d at %s, skipping it.\n"),
2998 utp
->number
, paddress (get_current_arch (), utp
->addr
));
3000 /* Whether found or created, record the number used by the
3001 target, to help with mapping target tracepoints back to their
3002 counterparts here. */
3004 t
->number_on_target
= utp
->number
;
3007 free_uploaded_tps (uploaded_tps
);
3010 /* Trace state variables don't have much to identify them beyond their
3011 name, so just use that to detect matches. */
3013 struct trace_state_variable
*
3014 find_matching_tsv (struct uploaded_tsv
*utsv
)
3019 return find_trace_state_variable (utsv
->name
);
3022 struct trace_state_variable
*
3023 create_tsv_from_upload (struct uploaded_tsv
*utsv
)
3025 const char *namebase
;
3028 struct trace_state_variable
*tsv
;
3032 namebase
= utsv
->name
;
3033 sprintf (buf
, "%s", namebase
);
3038 sprintf (buf
, "%s_%d", namebase
, try_num
++);
3041 /* Fish for a name that is not in use. */
3042 /* (should check against all internal vars?) */
3043 while (find_trace_state_variable (buf
))
3044 sprintf (buf
, "%s_%d", namebase
, try_num
++);
3046 /* We have an available name, create the variable. */
3047 tsv
= create_trace_state_variable (xstrdup (buf
));
3048 tsv
->initial_value
= utsv
->initial_value
;
3049 tsv
->builtin
= utsv
->builtin
;
3054 /* Given a list of uploaded trace state variables, try to match them
3055 up with existing variables, or create additional ones. */
3058 merge_uploaded_trace_state_variables (struct uploaded_tsv
**uploaded_tsvs
)
3061 struct uploaded_tsv
*utsv
;
3062 struct trace_state_variable
*tsv
;
3065 /* Most likely some numbers will have to be reassigned as part of
3066 the merge, so clear them all in anticipation. */
3067 for (ix
= 0; VEC_iterate (tsv_s
, tvariables
, ix
, tsv
); ++ix
)
3070 for (utsv
= *uploaded_tsvs
; utsv
; utsv
= utsv
->next
)
3072 tsv
= find_matching_tsv (utsv
);
3074 printf_filtered (_("Assuming trace state variable $%s is same as target's variable %d.\n"),
3075 tsv
->name
, utsv
->number
);
3078 tsv
= create_tsv_from_upload (utsv
);
3079 printf_filtered (_("Created trace state variable $%s for target's variable %d.\n"),
3080 tsv
->name
, utsv
->number
);
3082 /* Give precedence to numberings that come from the target. */
3084 tsv
->number
= utsv
->number
;
3087 /* Renumber everything that didn't get a target-assigned number. */
3089 for (ix
= 0; VEC_iterate (tsv_s
, tvariables
, ix
, tsv
); ++ix
)
3090 if (tsv
->number
> highest
)
3091 highest
= tsv
->number
;
3094 for (ix
= 0; VEC_iterate (tsv_s
, tvariables
, ix
, tsv
); ++ix
)
3095 if (tsv
->number
== 0)
3096 tsv
->number
= highest
++;
3098 free_uploaded_tsvs (uploaded_tsvs
);
3101 /* target tfile command */
3103 struct target_ops tfile_ops
;
3105 /* Fill in tfile_ops with its defined operations and properties. */
3107 #define TRACE_HEADER_SIZE 8
3109 char *trace_filename
;
3111 off_t trace_frames_offset
;
3114 int trace_regblock_size
;
3116 static void tfile_interp_line (char *line
,
3117 struct uploaded_tp
**utpp
,
3118 struct uploaded_tsv
**utsvp
);
3121 tfile_open (char *filename
, int from_tty
)
3124 struct cleanup
*old_chain
;
3127 char header
[TRACE_HEADER_SIZE
];
3128 char linebuf
[1000]; /* should be max remote packet size or so */
3130 int bytes
, i
, gotten
;
3131 struct trace_status
*ts
;
3132 struct uploaded_tp
*uploaded_tps
= NULL
;
3133 struct uploaded_tsv
*uploaded_tsvs
= NULL
;
3135 target_preopen (from_tty
);
3137 error (_("No trace file specified."));
3139 filename
= tilde_expand (filename
);
3140 if (!IS_ABSOLUTE_PATH(filename
))
3142 temp
= concat (current_directory
, "/", filename
, (char *)NULL
);
3147 old_chain
= make_cleanup (xfree
, filename
);
3149 flags
= O_BINARY
| O_LARGEFILE
;
3151 scratch_chan
= open (filename
, flags
, 0);
3152 if (scratch_chan
< 0)
3153 perror_with_name (filename
);
3155 /* Looks semi-reasonable. Toss the old trace file and work on the new. */
3157 discard_cleanups (old_chain
); /* Don't free filename any more */
3158 unpush_target (&tfile_ops
);
3160 push_target (&tfile_ops
);
3162 trace_filename
= xstrdup (filename
);
3163 trace_fd
= scratch_chan
;
3166 /* Read the file header and test for validity. */
3167 gotten
= read (trace_fd
, &header
, TRACE_HEADER_SIZE
);
3169 perror_with_name (trace_filename
);
3170 else if (gotten
< TRACE_HEADER_SIZE
)
3171 error (_("Premature end of file while reading trace file"));
3173 bytes
+= TRACE_HEADER_SIZE
;
3174 if (!(header
[0] == 0x7f
3175 && (strncmp (header
+ 1, "TRACE0\n", 7) == 0)))
3176 error (_("File is not a valid trace file."));
3178 trace_regblock_size
= 0;
3179 ts
= current_trace_status ();
3180 /* We know we're working with a file. */
3182 /* Set defaults in case there is no status line. */
3183 ts
->running_known
= 0;
3184 ts
->stop_reason
= trace_stop_reason_unknown
;
3185 ts
->traceframe_count
= -1;
3186 ts
->buffer_free
= 0;
3187 ts
->disconnected_tracing
= 0;
3188 ts
->circular_buffer
= 0;
3190 /* Read through a section of newline-terminated lines that
3191 define things like tracepoints. */
3195 gotten
= read (trace_fd
, &byte
, 1);
3197 perror_with_name (trace_filename
);
3198 else if (gotten
< 1)
3199 error (_("Premature end of file while reading trace file"));
3204 /* Empty line marks end of the definition section. */
3209 tfile_interp_line (linebuf
, &uploaded_tps
, &uploaded_tsvs
);
3212 linebuf
[i
++] = byte
;
3214 error (_("Excessively long lines in trace file"));
3217 /* Add the file's tracepoints and variables into the current mix. */
3219 /* Get trace state variables first, they may be checked when parsing
3220 uploaded commands. */
3221 merge_uploaded_trace_state_variables (&uploaded_tsvs
);
3223 merge_uploaded_tracepoints (&uploaded_tps
);
3225 /* Record the starting offset of the binary trace data. */
3226 trace_frames_offset
= bytes
;
3228 /* If we don't have a blocksize, we can't interpret the
3230 if (trace_regblock_size
== 0)
3231 error (_("No register block size recorded in trace file"));
3232 if (ts
->traceframe_count
<= 0)
3234 warning ("No traceframes present in this file.");
3238 #define TFILE_PID (1)
3239 inferior_appeared (current_inferior (), TFILE_PID
);
3240 inferior_ptid
= pid_to_ptid (TFILE_PID
);
3241 add_thread_silent (inferior_ptid
);
3243 post_create_inferior (&tfile_ops
, from_tty
);
3246 /* FIXME this will get defined in MI patch submission */
3247 tfind_1 (tfind_number
, 0, 0, 0, 0);
3251 /* Interpret the given line from the definitions part of the trace
3255 tfile_interp_line (char *line
,
3256 struct uploaded_tp
**utpp
, struct uploaded_tsv
**utsvp
)
3260 if (strncmp (p
, "R ", strlen ("R ")) == 0)
3263 trace_regblock_size
= strtol (p
, &p
, 16);
3265 else if (strncmp (p
, "status ", strlen ("status ")) == 0)
3267 p
+= strlen ("status ");
3268 parse_trace_status (p
, current_trace_status ());
3270 else if (strncmp (p
, "tp ", strlen ("tp ")) == 0)
3272 p
+= strlen ("tp ");
3273 parse_tracepoint_definition (p
, utpp
);
3275 else if (strncmp (p
, "tsv ", strlen ("tsv ")) == 0)
3277 p
+= strlen ("tsv ");
3278 parse_tsv_definition (p
, utsvp
);
3281 warning ("Ignoring trace file definition \"%s\"", line
);
3284 /* Parse the part of trace status syntax that is shared between
3285 the remote protocol and the trace file reader. */
3287 extern char *unpack_varlen_hex (char *buff
, ULONGEST
*result
);
3290 parse_trace_status (char *line
, struct trace_status
*ts
)
3292 char *p
= line
, *p1
, *p2
, *p_temp
;
3295 ts
->running_known
= 1;
3296 ts
->running
= (*p
++ == '1');
3297 ts
->stop_reason
= trace_stop_reason_unknown
;
3298 xfree (ts
->error_desc
);
3299 ts
->error_desc
= NULL
;
3300 ts
->traceframe_count
= -1;
3301 ts
->traceframes_created
= -1;
3302 ts
->buffer_free
= -1;
3303 ts
->buffer_size
= -1;
3304 ts
->disconnected_tracing
= 0;
3305 ts
->circular_buffer
= 0;
3309 p1
= strchr (p
, ':');
3311 error (_("Malformed trace status, at %s\n\
3312 Status line: '%s'\n"), p
, line
);
3313 if (strncmp (p
, stop_reason_names
[trace_buffer_full
], p1
- p
) == 0)
3315 p
= unpack_varlen_hex (++p1
, &val
);
3316 ts
->stop_reason
= trace_buffer_full
;
3318 else if (strncmp (p
, stop_reason_names
[trace_never_run
], p1
- p
) == 0)
3320 p
= unpack_varlen_hex (++p1
, &val
);
3321 ts
->stop_reason
= trace_never_run
;
3323 else if (strncmp (p
, stop_reason_names
[tracepoint_passcount
], p1
- p
) == 0)
3325 p
= unpack_varlen_hex (++p1
, &val
);
3326 ts
->stop_reason
= tracepoint_passcount
;
3327 ts
->stopping_tracepoint
= val
;
3329 else if (strncmp (p
, stop_reason_names
[tstop_command
], p1
- p
) == 0)
3331 p
= unpack_varlen_hex (++p1
, &val
);
3332 ts
->stop_reason
= tstop_command
;
3334 else if (strncmp (p
, stop_reason_names
[trace_disconnected
], p1
- p
) == 0)
3336 p
= unpack_varlen_hex (++p1
, &val
);
3337 ts
->stop_reason
= trace_disconnected
;
3339 else if (strncmp (p
, stop_reason_names
[tracepoint_error
], p1
- p
) == 0)
3341 p2
= strchr (++p1
, ':');
3346 ts
->error_desc
= xmalloc ((p2
- p1
) / 2 + 1);
3347 end
= hex2bin (p1
, ts
->error_desc
, (p2
- p1
) / 2);
3348 ts
->error_desc
[end
] = '\0';
3351 ts
->error_desc
= xstrdup ("");
3353 p
= unpack_varlen_hex (++p2
, &val
);
3354 ts
->stopping_tracepoint
= val
;
3355 ts
->stop_reason
= tracepoint_error
;
3357 else if (strncmp (p
, "tframes", p1
- p
) == 0)
3359 p
= unpack_varlen_hex (++p1
, &val
);
3360 ts
->traceframe_count
= val
;
3362 else if (strncmp (p
, "tcreated", p1
- p
) == 0)
3364 p
= unpack_varlen_hex (++p1
, &val
);
3365 ts
->traceframes_created
= val
;
3367 else if (strncmp (p
, "tfree", p1
- p
) == 0)
3369 p
= unpack_varlen_hex (++p1
, &val
);
3370 ts
->buffer_free
= val
;
3372 else if (strncmp (p
, "tsize", p1
- p
) == 0)
3374 p
= unpack_varlen_hex (++p1
, &val
);
3375 ts
->buffer_size
= val
;
3377 else if (strncmp (p
, "disconn", p1
- p
) == 0)
3379 p
= unpack_varlen_hex (++p1
, &val
);
3380 ts
->disconnected_tracing
= val
;
3382 else if (strncmp (p
, "circular", p1
- p
) == 0)
3384 p
= unpack_varlen_hex (++p1
, &val
);
3385 ts
->circular_buffer
= val
;
3389 /* Silently skip unknown optional info. */
3390 p_temp
= strchr (p1
+ 1, ';');
3394 /* Must be at the end. */
3400 /* Given a line of text defining a part of a tracepoint, parse it into
3401 an "uploaded tracepoint". */
3404 parse_tracepoint_definition (char *line
, struct uploaded_tp
**utpp
)
3408 ULONGEST num
, addr
, step
, pass
, orig_size
, xlen
, start
;
3409 int enabled
, i
, end
;
3411 char *cond
, *srctype
, *src
, *buf
;
3412 struct uploaded_tp
*utp
= NULL
;
3415 /* Both tracepoint and action definitions start with the same number
3416 and address sequence. */
3418 p
= unpack_varlen_hex (p
, &num
);
3419 p
++; /* skip a colon */
3420 p
= unpack_varlen_hex (p
, &addr
);
3421 p
++; /* skip a colon */
3424 enabled
= (*p
++ == 'E');
3425 p
++; /* skip a colon */
3426 p
= unpack_varlen_hex (p
, &step
);
3427 p
++; /* skip a colon */
3428 p
= unpack_varlen_hex (p
, &pass
);
3429 type
= bp_tracepoint
;
3431 /* Thumb through optional fields. */
3434 p
++; /* skip a colon */
3437 type
= bp_fast_tracepoint
;
3439 p
= unpack_varlen_hex (p
, &orig_size
);
3444 p
= unpack_varlen_hex (p
, &xlen
);
3445 p
++; /* skip a comma */
3446 cond
= (char *) xmalloc (2 * xlen
+ 1);
3447 strncpy (cond
, p
, 2 * xlen
);
3448 cond
[2 * xlen
] = '\0';
3452 warning (_("Unrecognized char '%c' in tracepoint definition, skipping rest"), *p
);
3454 utp
= get_uploaded_tp (num
, addr
, utpp
);
3456 utp
->enabled
= enabled
;
3461 else if (piece
== 'A')
3463 utp
= get_uploaded_tp (num
, addr
, utpp
);
3464 VEC_safe_push (char_ptr
, utp
->actions
, xstrdup (p
));
3466 else if (piece
== 'S')
3468 utp
= get_uploaded_tp (num
, addr
, utpp
);
3469 VEC_safe_push (char_ptr
, utp
->step_actions
, xstrdup (p
));
3471 else if (piece
== 'Z')
3473 /* Parse a chunk of source form definition. */
3474 utp
= get_uploaded_tp (num
, addr
, utpp
);
3476 p
= strchr (p
, ':');
3477 p
++; /* skip a colon */
3478 p
= unpack_varlen_hex (p
, &start
);
3479 p
++; /* skip a colon */
3480 p
= unpack_varlen_hex (p
, &xlen
);
3481 p
++; /* skip a colon */
3483 buf
= alloca (strlen (line
));
3485 end
= hex2bin (p
, (gdb_byte
*) buf
, strlen (p
) / 2);
3488 if (strncmp (srctype
, "at:", strlen ("at:")) == 0)
3489 utp
->at_string
= xstrdup (buf
);
3490 else if (strncmp (srctype
, "cond:", strlen ("cond:")) == 0)
3491 utp
->cond_string
= xstrdup (buf
);
3492 else if (strncmp (srctype
, "cmd:", strlen ("cmd:")) == 0)
3493 VEC_safe_push (char_ptr
, utp
->cmd_strings
, xstrdup (buf
));
3497 /* Don't error out, the target might be sending us optional
3498 info that we don't care about. */
3499 warning (_("Unrecognized tracepoint piece '%c', ignoring"), piece
);
3503 /* Convert a textual description of a trace state variable into an
3507 parse_tsv_definition (char *line
, struct uploaded_tsv
**utsvp
)
3510 ULONGEST num
, initval
, builtin
;
3512 struct uploaded_tsv
*utsv
= NULL
;
3514 buf
= alloca (strlen (line
));
3517 p
= unpack_varlen_hex (p
, &num
);
3518 p
++; /* skip a colon */
3519 p
= unpack_varlen_hex (p
, &initval
);
3520 p
++; /* skip a colon */
3521 p
= unpack_varlen_hex (p
, &builtin
);
3522 p
++; /* skip a colon */
3523 end
= hex2bin (p
, (gdb_byte
*) buf
, strlen (p
) / 2);
3526 utsv
= get_uploaded_tsv (num
, utsvp
);
3527 utsv
->initial_value
= initval
;
3528 utsv
->builtin
= builtin
;
3529 utsv
->name
= xstrdup (buf
);
3532 /* Close the trace file and generally clean up. */
3535 tfile_close (int quitting
)
3542 pid
= ptid_get_pid (inferior_ptid
);
3543 inferior_ptid
= null_ptid
; /* Avoid confusion from thread stuff */
3544 exit_inferior_silent (pid
);
3549 xfree (trace_filename
);
3553 tfile_files_info (struct target_ops
*t
)
3555 /* (it would be useful to mention the name of the file) */
3556 printf_filtered ("Looking at a trace file.\n");
3559 /* The trace status for a file is that tracing can never be run. */
3562 tfile_get_trace_status (struct trace_status
*ts
)
3564 /* Other bits of trace status were collected as part of opening the
3565 trace files, so nothing to do here. */
3570 /* Given the position of a traceframe in the file, figure out what
3571 address the frame was collected at. This would normally be the
3572 value of a collected PC register, but if not available, we
3576 tfile_get_traceframe_address (off_t tframe_offset
)
3580 struct breakpoint
*tp
;
3581 off_t saved_offset
= cur_offset
;
3584 /* FIXME dig pc out of collected registers */
3586 /* Fall back to using tracepoint address. */
3587 lseek (trace_fd
, tframe_offset
, SEEK_SET
);
3588 gotten
= read (trace_fd
, &tpnum
, 2);
3590 perror_with_name (trace_filename
);
3591 else if (gotten
< 2)
3592 error (_("Premature end of file while reading trace file"));
3594 tp
= get_tracepoint_by_number_on_target (tpnum
);
3595 /* FIXME this is a poor heuristic if multiple locations */
3597 addr
= tp
->loc
->address
;
3599 /* Restore our seek position. */
3600 cur_offset
= saved_offset
;
3601 lseek (trace_fd
, cur_offset
, SEEK_SET
);
3605 /* Given a type of search and some parameters, scan the collection of
3606 traceframes in the file looking for a match. When found, return
3607 both the traceframe and tracepoint number, otherwise -1 for
3611 tfile_trace_find (enum trace_find_type type
, int num
,
3612 ULONGEST addr1
, ULONGEST addr2
, int *tpp
)
3615 int tfnum
= 0, found
= 0, gotten
;
3617 struct breakpoint
*tp
;
3618 off_t offset
, tframe_offset
;
3621 lseek (trace_fd
, trace_frames_offset
, SEEK_SET
);
3622 offset
= trace_frames_offset
;
3625 tframe_offset
= offset
;
3626 gotten
= read (trace_fd
, &tpnum
, 2);
3628 perror_with_name (trace_filename
);
3629 else if (gotten
< 2)
3630 error (_("Premature end of file while reading trace file"));
3634 gotten
= read (trace_fd
, &data_size
, 4);
3636 perror_with_name (trace_filename
);
3637 else if (gotten
< 4)
3638 error (_("Premature end of file while reading trace file"));
3647 tfaddr
= tfile_get_traceframe_address (tframe_offset
);
3648 if (tfaddr
== addr1
)
3652 tp
= get_tracepoint (num
);
3653 if (tp
&& tpnum
== tp
->number_on_target
)
3657 tfaddr
= tfile_get_traceframe_address (tframe_offset
);
3658 if (addr1
<= tfaddr
&& tfaddr
<= addr2
)
3662 tfaddr
= tfile_get_traceframe_address (tframe_offset
);
3663 if (!(addr1
<= tfaddr
&& tfaddr
<= addr2
))
3667 internal_error (__FILE__
, __LINE__
, _("unknown tfind type"));
3673 cur_offset
= offset
;
3674 cur_data_size
= data_size
;
3677 /* Skip past the traceframe's data. */
3678 lseek (trace_fd
, data_size
, SEEK_CUR
);
3679 offset
+= data_size
;
3680 /* Update our own count of traceframes. */
3683 /* Did not find what we were looking for. */
3689 /* Look for a block of saved registers in the traceframe, and get the
3690 requested register from it. */
3693 tfile_fetch_registers (struct target_ops
*ops
,
3694 struct regcache
*regcache
, int regno
)
3696 struct gdbarch
*gdbarch
= get_regcache_arch (regcache
);
3698 int i
, pos
, offset
, regn
, regsize
, gotten
, pc_regno
;
3699 unsigned short mlen
;
3702 /* An uninitialized reg size says we're not going to be
3703 successful at getting register blocks. */
3704 if (!trace_regblock_size
)
3707 regs
= alloca (trace_regblock_size
);
3709 lseek (trace_fd
, cur_offset
, SEEK_SET
);
3711 while (pos
< cur_data_size
)
3713 gotten
= read (trace_fd
, &block_type
, 1);
3715 perror_with_name (trace_filename
);
3716 else if (gotten
< 1)
3717 error (_("Premature end of file while reading trace file"));
3723 gotten
= read (trace_fd
, regs
, trace_regblock_size
);
3725 perror_with_name (trace_filename
);
3726 else if (gotten
< trace_regblock_size
)
3727 error (_("Premature end of file while reading trace file"));
3729 /* Assume the block is laid out in GDB register number order,
3730 each register with the size that it has in GDB. */
3732 for (regn
= 0; regn
< gdbarch_num_regs (gdbarch
); regn
++)
3734 regsize
= register_size (gdbarch
, regn
);
3735 /* Make sure we stay within block bounds. */
3736 if (offset
+ regsize
>= trace_regblock_size
)
3738 if (!regcache_valid_p (regcache
, regn
))
3742 regcache_raw_supply (regcache
, regno
, regs
+ offset
);
3745 else if (regno
== -1)
3747 regcache_raw_supply (regcache
, regn
, regs
+ offset
);
3754 lseek (trace_fd
, 8, SEEK_CUR
);
3755 gotten
= read (trace_fd
, &mlen
, 2);
3757 perror_with_name (trace_filename
);
3758 else if (gotten
< 2)
3759 error (_("Premature end of file while reading trace file"));
3760 lseek (trace_fd
, mlen
, SEEK_CUR
);
3761 pos
+= (8 + 2 + mlen
);
3764 lseek (trace_fd
, 4 + 8, SEEK_CUR
);
3768 error ("Unknown block type '%c' (0x%x) in trace frame",
3769 block_type
, block_type
);
3774 /* We get here if no register data has been found. Although we
3775 don't like making up numbers, GDB has all manner of troubles when
3776 the target says some register is not available. Filling in with
3777 zeroes is a reasonable fallback. */
3778 for (regn
= 0; regn
< gdbarch_num_regs (gdbarch
); regn
++)
3779 regcache_raw_supply (regcache
, regn
, NULL
);
3781 /* We can often usefully guess that the PC is going to be the same
3782 as the address of the tracepoint. */
3783 pc_regno
= gdbarch_pc_regnum (gdbarch
);
3784 if (pc_regno
>= 0 && (regno
== -1 || regno
== pc_regno
))
3786 struct breakpoint
*tp
= get_tracepoint (tracepoint_number
);
3790 /* But don't try to guess if tracepoint is multi-location... */
3793 warning ("Tracepoint %d has multiple locations, cannot infer $pc",
3797 /* ... or does while-stepping. */
3798 if (tp
->step_count
> 0)
3800 warning ("Tracepoint %d does while-stepping, cannot infer $pc",
3805 store_unsigned_integer (regs
, register_size (gdbarch
, pc_regno
),
3806 gdbarch_byte_order (gdbarch
),
3808 regcache_raw_supply (regcache
, pc_regno
, regs
);
3814 tfile_xfer_partial (struct target_ops
*ops
, enum target_object object
,
3815 const char *annex
, gdb_byte
*readbuf
,
3816 const gdb_byte
*writebuf
, ULONGEST offset
, LONGEST len
)
3820 ULONGEST maddr
, amt
;
3821 unsigned short mlen
;
3823 /* We're only doing regular memory for now. */
3824 if (object
!= TARGET_OBJECT_MEMORY
)
3827 if (readbuf
== NULL
)
3828 error ("tfile_xfer_partial: trace file is read-only");
3830 lseek (trace_fd
, cur_offset
, SEEK_SET
);
3832 while (pos
< cur_data_size
)
3834 gotten
= read (trace_fd
, &block_type
, 1);
3836 perror_with_name (trace_filename
);
3837 else if (gotten
< 1)
3838 error (_("Premature end of file while reading trace file"));
3843 lseek (trace_fd
, trace_regblock_size
, SEEK_CUR
);
3844 pos
+= trace_regblock_size
;
3847 gotten
= read (trace_fd
, &maddr
, 8);
3849 perror_with_name (trace_filename
);
3850 else if (gotten
< 8)
3851 error (_("Premature end of file while reading trace file"));
3853 gotten
= read (trace_fd
, &mlen
, 2);
3855 perror_with_name (trace_filename
);
3856 else if (gotten
< 2)
3857 error (_("Premature end of file while reading trace file"));
3858 /* If the block includes the first part of the desired
3859 range, return as much it has; GDB will re-request the
3860 remainder, which might be in a different block of this
3862 if (maddr
<= offset
&& offset
< (maddr
+ mlen
))
3864 amt
= (maddr
+ mlen
) - offset
;
3868 read (trace_fd
, readbuf
, amt
);
3871 lseek (trace_fd
, mlen
, SEEK_CUR
);
3872 pos
+= (8 + 2 + mlen
);
3875 lseek (trace_fd
, 4 + 8, SEEK_CUR
);
3879 error ("Unknown block type '%c' (0x%x) in traceframe",
3880 block_type
, block_type
);
3885 /* It's unduly pedantic to refuse to look at the executable for
3886 read-only pieces; so do the equivalent of readonly regions aka
3888 /* FIXME account for relocation at some point */
3895 for (s
= exec_bfd
->sections
; s
; s
= s
->next
)
3897 if ((s
->flags
& SEC_LOAD
) == 0 ||
3898 (s
->flags
& SEC_READONLY
) == 0)
3902 size
= bfd_get_section_size (s
);
3903 if (lma
<= offset
&& offset
< (lma
+ size
))
3905 amt
= (lma
+ size
) - offset
;
3909 amt
= bfd_get_section_contents (exec_bfd
, s
,
3910 readbuf
, offset
- lma
, amt
);
3916 /* Indicate failure to find the requested memory block. */
3920 /* Iterate through the blocks of a trace frame, looking for a 'V'
3921 block with a matching tsv number. */
3924 tfile_get_trace_state_variable_value (int tsvnum
, LONGEST
*val
)
3927 int pos
, vnum
, gotten
;
3928 unsigned short mlen
;
3930 lseek (trace_fd
, cur_offset
, SEEK_SET
);
3932 while (pos
< cur_data_size
)
3934 gotten
= read (trace_fd
, &block_type
, 1);
3936 perror_with_name (trace_filename
);
3937 else if (gotten
< 1)
3938 error (_("Premature end of file while reading trace file"));
3943 lseek (trace_fd
, trace_regblock_size
, SEEK_CUR
);
3944 pos
+= trace_regblock_size
;
3947 lseek (trace_fd
, 8, SEEK_CUR
);
3948 gotten
= read (trace_fd
, &mlen
, 2);
3950 perror_with_name (trace_filename
);
3951 else if (gotten
< 2)
3952 error (_("Premature end of file while reading trace file"));
3953 lseek (trace_fd
, mlen
, SEEK_CUR
);
3954 pos
+= (8 + 2 + mlen
);
3957 gotten
= read (trace_fd
, &vnum
, 4);
3959 perror_with_name (trace_filename
);
3960 else if (gotten
< 4)
3961 error (_("Premature end of file while reading trace file"));
3964 gotten
= read (trace_fd
, val
, 8);
3966 perror_with_name (trace_filename
);
3967 else if (gotten
< 8)
3968 error (_("Premature end of file while reading trace file"));
3971 lseek (trace_fd
, 8, SEEK_CUR
);
3975 error ("Unknown block type '%c' (0x%x) in traceframe",
3976 block_type
, block_type
);
3980 /* Didn't find anything. */
3985 tfile_has_all_memory (struct target_ops
*ops
)
3991 tfile_has_memory (struct target_ops
*ops
)
3997 tfile_has_stack (struct target_ops
*ops
)
4003 tfile_has_registers (struct target_ops
*ops
)
4009 init_tfile_ops (void)
4011 tfile_ops
.to_shortname
= "tfile";
4012 tfile_ops
.to_longname
= "Local trace dump file";
4014 "Use a trace file as a target. Specify the filename of the trace file.";
4015 tfile_ops
.to_open
= tfile_open
;
4016 tfile_ops
.to_close
= tfile_close
;
4017 tfile_ops
.to_fetch_registers
= tfile_fetch_registers
;
4018 tfile_ops
.to_xfer_partial
= tfile_xfer_partial
;
4019 tfile_ops
.to_files_info
= tfile_files_info
;
4020 tfile_ops
.to_get_trace_status
= tfile_get_trace_status
;
4021 tfile_ops
.to_trace_find
= tfile_trace_find
;
4022 tfile_ops
.to_get_trace_state_variable_value
= tfile_get_trace_state_variable_value
;
4023 /* core_stratum might seem more logical, but GDB doesn't like having
4024 more than one core_stratum vector. */
4025 tfile_ops
.to_stratum
= process_stratum
;
4026 tfile_ops
.to_has_all_memory
= tfile_has_all_memory
;
4027 tfile_ops
.to_has_memory
= tfile_has_memory
;
4028 tfile_ops
.to_has_stack
= tfile_has_stack
;
4029 tfile_ops
.to_has_registers
= tfile_has_registers
;
4030 tfile_ops
.to_magic
= OPS_MAGIC
;
4033 /* module initialization */
4035 _initialize_tracepoint (void)
4037 struct cmd_list_element
*c
;
4039 traceframe_number
= -1;
4040 tracepoint_number
= -1;
4042 if (tracepoint_list
.list
== NULL
)
4044 tracepoint_list
.listsize
= 128;
4045 tracepoint_list
.list
= xmalloc
4046 (tracepoint_list
.listsize
* sizeof (struct memrange
));
4048 if (tracepoint_list
.aexpr_list
== NULL
)
4050 tracepoint_list
.aexpr_listsize
= 128;
4051 tracepoint_list
.aexpr_list
= xmalloc
4052 (tracepoint_list
.aexpr_listsize
* sizeof (struct agent_expr
*));
4055 if (stepping_list
.list
== NULL
)
4057 stepping_list
.listsize
= 128;
4058 stepping_list
.list
= xmalloc
4059 (stepping_list
.listsize
* sizeof (struct memrange
));
4062 if (stepping_list
.aexpr_list
== NULL
)
4064 stepping_list
.aexpr_listsize
= 128;
4065 stepping_list
.aexpr_list
= xmalloc
4066 (stepping_list
.aexpr_listsize
* sizeof (struct agent_expr
*));
4069 add_info ("scope", scope_info
,
4070 _("List the variables local to a scope"));
4072 add_cmd ("tracepoints", class_trace
, NULL
,
4073 _("Tracing of program execution without stopping the program."),
4076 add_com ("tdump", class_trace
, trace_dump_command
,
4077 _("Print everything collected at the current tracepoint."));
4079 add_com ("tsave", class_trace
, trace_save_command
, _("\
4080 Save the trace data to a file.\n\
4081 Use the '-r' option to direct the target to save directly to the file,\n\
4082 using its own filesystem."));
4084 c
= add_com ("tvariable", class_trace
, trace_variable_command
,_("\
4085 Define a trace state variable.\n\
4086 Argument is a $-prefixed name, optionally followed\n\
4087 by '=' and an expression that sets the initial value\n\
4088 at the start of tracing."));
4089 set_cmd_completer (c
, expression_completer
);
4091 add_cmd ("tvariable", class_trace
, delete_trace_variable_command
, _("\
4092 Delete one or more trace state variables.\n\
4093 Arguments are the names of the variables to delete.\n\
4094 If no arguments are supplied, delete all variables."), &deletelist
);
4095 /* FIXME add a trace variable completer */
4097 add_info ("tvariables", tvariables_info
, _("\
4098 Status of trace state variables and their values.\n\
4101 add_prefix_cmd ("tfind", class_trace
, trace_find_command
, _("\
4102 Select a trace frame;\n\
4103 No argument means forward by one frame; '-' means backward by one frame."),
4104 &tfindlist
, "tfind ", 1, &cmdlist
);
4106 add_cmd ("outside", class_trace
, trace_find_outside_command
, _("\
4107 Select a trace frame whose PC is outside the given range (exclusive).\n\
4108 Usage: tfind outside addr1, addr2"),
4111 add_cmd ("range", class_trace
, trace_find_range_command
, _("\
4112 Select a trace frame whose PC is in the given range (inclusive).\n\
4113 Usage: tfind range addr1,addr2"),
4116 add_cmd ("line", class_trace
, trace_find_line_command
, _("\
4117 Select a trace frame by source line.\n\
4118 Argument can be a line number (with optional source file), \n\
4119 a function name, or '*' followed by an address.\n\
4120 Default argument is 'the next source line that was traced'."),
4123 add_cmd ("tracepoint", class_trace
, trace_find_tracepoint_command
, _("\
4124 Select a trace frame by tracepoint number.\n\
4125 Default is the tracepoint for the current trace frame."),
4128 add_cmd ("pc", class_trace
, trace_find_pc_command
, _("\
4129 Select a trace frame by PC.\n\
4130 Default is the current PC, or the PC of the current trace frame."),
4133 add_cmd ("end", class_trace
, trace_find_end_command
, _("\
4134 Synonym for 'none'.\n\
4135 De-select any trace frame and resume 'live' debugging."),
4138 add_cmd ("none", class_trace
, trace_find_none_command
,
4139 _("De-select any trace frame and resume 'live' debugging."),
4142 add_cmd ("start", class_trace
, trace_find_start_command
,
4143 _("Select the first trace frame in the trace buffer."),
4146 add_com ("tstatus", class_trace
, trace_status_command
,
4147 _("Display the status of the current trace data collection."));
4149 add_com ("tstop", class_trace
, trace_stop_command
,
4150 _("Stop trace data collection."));
4152 add_com ("tstart", class_trace
, trace_start_command
,
4153 _("Start trace data collection."));
4155 add_com ("end", class_trace
, end_actions_pseudocommand
, _("\
4156 Ends a list of commands or actions.\n\
4157 Several GDB commands allow you to enter a list of commands or actions.\n\
4158 Entering \"end\" on a line by itself is the normal way to terminate\n\
4160 Note: the \"end\" command cannot be used at the gdb prompt."));
4162 add_com ("while-stepping", class_trace
, while_stepping_pseudocommand
, _("\
4163 Specify single-stepping behavior at a tracepoint.\n\
4164 Argument is number of instructions to trace in single-step mode\n\
4165 following the tracepoint. This command is normally followed by\n\
4166 one or more \"collect\" commands, to specify what to collect\n\
4167 while single-stepping.\n\n\
4168 Note: this command can only be used in a tracepoint \"actions\" list."));
4170 add_com_alias ("ws", "while-stepping", class_alias
, 0);
4171 add_com_alias ("stepping", "while-stepping", class_alias
, 0);
4173 add_com ("collect", class_trace
, collect_pseudocommand
, _("\
4174 Specify one or more data items to be collected at a tracepoint.\n\
4175 Accepts a comma-separated list of (one or more) expressions. GDB will\n\
4176 collect all data (variables, registers) referenced by that expression.\n\
4177 Also accepts the following special arguments:\n\
4178 $regs -- all registers.\n\
4179 $args -- all function arguments.\n\
4180 $locals -- all variables local to the block/function scope.\n\
4181 Note: this command can only be used in a tracepoint \"actions\" list."));
4183 add_com ("teval", class_trace
, teval_pseudocommand
, _("\
4184 Specify one or more expressions to be evaluated at a tracepoint.\n\
4185 Accepts a comma-separated list of (one or more) expressions.\n\
4186 The result of each evaluation will be discarded.\n\
4187 Note: this command can only be used in a tracepoint \"actions\" list."));
4189 add_com ("actions", class_trace
, trace_actions_command
, _("\
4190 Specify the actions to be taken at a tracepoint.\n\
4191 Tracepoint actions may include collecting of specified data, \n\
4192 single-stepping, or enabling/disabling other tracepoints, \n\
4193 depending on target's capabilities."));
4195 default_collect
= xstrdup ("");
4196 add_setshow_string_cmd ("default-collect", class_trace
,
4197 &default_collect
, _("\
4198 Set the list of expressions to collect by default"), _("\
4199 Show the list of expressions to collect by default"), NULL
,
4201 &setlist
, &showlist
);
4203 add_setshow_boolean_cmd ("disconnected-tracing", no_class
,
4204 &disconnected_tracing
, _("\
4205 Set whether tracing continues after GDB disconnects."), _("\
4206 Show whether tracing continues after GDB disconnects."), _("\
4207 Use this to continue a tracing run even if GDB disconnects\n\
4208 or detaches from the target. You can reconnect later and look at\n\
4209 trace data collected in the meantime."),
4210 set_disconnected_tracing
,
4215 add_setshow_boolean_cmd ("circular-trace-buffer", no_class
,
4216 &circular_trace_buffer
, _("\
4217 Set target's use of circular trace buffer."), _("\
4218 Show target's use of circular trace buffer."), _("\
4219 Use this to make the trace buffer into a circular buffer,\n\
4220 which will discard traceframes (oldest first) instead of filling\n\
4221 up and stopping the trace run."),
4222 set_circular_trace_buffer
,
4229 add_target (&tfile_ops
);