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 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 2 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, write to the Free Software
20 Foundation, Inc., 51 Franklin Street, Fifth Floor,
21 Boston, MA 02110-1301, USA. */
27 #include "expression.h"
32 #include "gdb_string.h"
34 #include "tracepoint.h"
38 #include "completer.h"
39 #include "gdb-events.h"
41 #include "dictionary.h"
46 /* readline include files */
47 #include "readline/readline.h"
48 #include "readline/history.h"
50 /* readline defines this. */
57 /* Maximum length of an agent aexpression.
58 This accounts for the fact that packets are limited to 400 bytes
59 (which includes everything -- including the checksum), and assumes
60 the worst case of maximum length for each of the pieces of a
63 NOTE: expressions get mem2hex'ed otherwise this would be twice as
64 large. (400 - 31)/2 == 184 */
65 #define MAX_AGENT_EXPR_LEN 184
68 extern void (*deprecated_readline_begin_hook) (char *, ...);
69 extern char *(*deprecated_readline_hook) (char *);
70 extern void (*deprecated_readline_end_hook) (void);
71 extern int addressprint; /* Print machine addresses? */
73 /* GDB commands implemented in other modules:
76 extern void output_command (char *, int);
81 This module defines the following debugger commands:
82 trace : set a tracepoint on a function, line, or address.
83 info trace : list all debugger-defined tracepoints.
84 delete trace : delete one or more tracepoints.
85 enable trace : enable one or more tracepoints.
86 disable trace : disable one or more tracepoints.
87 actions : specify actions to be taken at a tracepoint.
88 passcount : specify a pass count for a tracepoint.
89 tstart : start a trace experiment.
90 tstop : stop a trace experiment.
91 tstatus : query the status of a trace experiment.
92 tfind : find a trace frame in the trace buffer.
93 tdump : print everything collected at the current tracepoint.
94 save-tracepoints : write tracepoint setup into a file.
96 This module defines the following user-visible debugger variables:
97 $trace_frame : sequence number of trace frame currently being debugged.
98 $trace_line : source line of trace frame currently being debugged.
99 $trace_file : source file of trace frame currently being debugged.
100 $tracepoint : tracepoint number of trace frame currently being debugged.
104 /* ======= Important global variables: ======= */
106 /* Chain of all tracepoints defined. */
107 struct tracepoint *tracepoint_chain;
109 /* Number of last tracepoint made. */
110 static int tracepoint_count;
112 /* Number of last traceframe collected. */
113 static int traceframe_number;
115 /* Tracepoint for last traceframe collected. */
116 static int tracepoint_number;
118 /* Symbol for function for last traceframe collected */
119 static struct symbol *traceframe_fun;
121 /* Symtab and line for last traceframe collected */
122 static struct symtab_and_line traceframe_sal;
124 /* Tracing command lists */
125 static struct cmd_list_element *tfindlist;
127 /* ======= Important command functions: ======= */
128 static void trace_command (char *, int);
129 static void tracepoints_info (char *, int);
130 static void delete_trace_command (char *, int);
131 static void enable_trace_command (char *, int);
132 static void disable_trace_command (char *, int);
133 static void trace_pass_command (char *, int);
134 static void trace_actions_command (char *, int);
135 static void trace_start_command (char *, int);
136 static void trace_stop_command (char *, int);
137 static void trace_status_command (char *, int);
138 static void trace_find_command (char *, int);
139 static void trace_find_pc_command (char *, int);
140 static void trace_find_tracepoint_command (char *, int);
141 static void trace_find_line_command (char *, int);
142 static void trace_find_range_command (char *, int);
143 static void trace_find_outside_command (char *, int);
144 static void tracepoint_save_command (char *, int);
145 static void trace_dump_command (char *, int);
147 /* support routines */
148 static void trace_mention (struct tracepoint *);
150 struct collection_list;
151 static void add_aexpr (struct collection_list *, struct agent_expr *);
152 static char *mem2hex (gdb_byte *, char *, int);
153 static void add_register (struct collection_list *collection,
155 static struct cleanup *make_cleanup_free_actions (struct tracepoint *t);
156 static void free_actions_list (char **actions_list);
157 static void free_actions_list_cleanup_wrapper (void *);
159 extern void _initialize_tracepoint (void);
161 /* Utility: returns true if "target remote" */
163 target_is_remote (void)
165 if (current_target.to_shortname &&
166 (strcmp (current_target.to_shortname, "remote") == 0
167 || strcmp (current_target.to_shortname, "extended-remote") == 0))
173 /* Utility: generate error from an incoming stub packet. */
175 trace_error (char *buf)
178 return; /* not an error msg */
181 case '1': /* malformed packet error */
182 if (*++buf == '0') /* general case: */
183 error (_("tracepoint.c: error in outgoing packet."));
185 error (_("tracepoint.c: error in outgoing packet at field #%ld."),
186 strtol (buf, NULL, 16));
188 error (_("trace API error 0x%s."), ++buf);
190 error (_("Target returns error code '%s'."), buf);
194 /* Utility: wait for reply from stub, while accepting "O" packets. */
196 remote_get_noisy_reply (char **buf_p,
199 do /* Loop on reply from remote stub. */
202 QUIT; /* allow user to bail out with ^C */
203 getpkt (buf_p, sizeof_buf, 0);
206 error (_("Target does not support this command."));
207 else if (buf[0] == 'E')
209 else if (buf[0] == 'O' &&
211 remote_console_output (buf + 1); /* 'O' message from stub */
213 return buf; /* here's the actual reply */
218 /* Set tracepoint count to NUM. */
220 set_tracepoint_count (int num)
222 tracepoint_count = num;
223 set_internalvar (lookup_internalvar ("tpnum"),
224 value_from_longest (builtin_type_int, (LONGEST) num));
227 /* Set traceframe number to NUM. */
229 set_traceframe_num (int num)
231 traceframe_number = num;
232 set_internalvar (lookup_internalvar ("trace_frame"),
233 value_from_longest (builtin_type_int, (LONGEST) num));
236 /* Set tracepoint number to NUM. */
238 set_tracepoint_num (int num)
240 tracepoint_number = num;
241 set_internalvar (lookup_internalvar ("tracepoint"),
242 value_from_longest (builtin_type_int,
246 /* Set externally visible debug variables for querying/printing
247 the traceframe context (line, function, file) */
250 set_traceframe_context (CORE_ADDR trace_pc)
252 static struct type *func_string, *file_string;
253 static struct type *func_range, *file_range;
254 struct value *func_val;
255 struct value *file_val;
256 static struct type *charstar;
259 if (charstar == (struct type *) NULL)
260 charstar = lookup_pointer_type (builtin_type_char);
262 if (trace_pc == -1) /* Cease debugging any trace buffers. */
265 traceframe_sal.pc = traceframe_sal.line = 0;
266 traceframe_sal.symtab = NULL;
267 set_internalvar (lookup_internalvar ("trace_func"),
268 value_from_pointer (charstar, (LONGEST) 0));
269 set_internalvar (lookup_internalvar ("trace_file"),
270 value_from_pointer (charstar, (LONGEST) 0));
271 set_internalvar (lookup_internalvar ("trace_line"),
272 value_from_longest (builtin_type_int,
277 /* Save as globals for internal use. */
278 traceframe_sal = find_pc_line (trace_pc, 0);
279 traceframe_fun = find_pc_function (trace_pc);
281 /* Save linenumber as "$trace_line", a debugger variable visible to
283 set_internalvar (lookup_internalvar ("trace_line"),
284 value_from_longest (builtin_type_int,
285 (LONGEST) traceframe_sal.line));
287 /* Save func name as "$trace_func", a debugger variable visible to
289 if (traceframe_fun == NULL ||
290 DEPRECATED_SYMBOL_NAME (traceframe_fun) == NULL)
291 set_internalvar (lookup_internalvar ("trace_func"),
292 value_from_pointer (charstar, (LONGEST) 0));
295 len = strlen (DEPRECATED_SYMBOL_NAME (traceframe_fun));
296 func_range = create_range_type (func_range,
297 builtin_type_int, 0, len - 1);
298 func_string = create_array_type (func_string,
299 builtin_type_char, func_range);
300 func_val = allocate_value (func_string);
301 deprecated_set_value_type (func_val, func_string);
302 memcpy (value_contents_raw (func_val),
303 DEPRECATED_SYMBOL_NAME (traceframe_fun),
305 deprecated_set_value_modifiable (func_val, 0);
306 set_internalvar (lookup_internalvar ("trace_func"), func_val);
309 /* Save file name as "$trace_file", a debugger variable visible to
311 if (traceframe_sal.symtab == NULL ||
312 traceframe_sal.symtab->filename == NULL)
313 set_internalvar (lookup_internalvar ("trace_file"),
314 value_from_pointer (charstar, (LONGEST) 0));
317 len = strlen (traceframe_sal.symtab->filename);
318 file_range = create_range_type (file_range,
319 builtin_type_int, 0, len - 1);
320 file_string = create_array_type (file_string,
321 builtin_type_char, file_range);
322 file_val = allocate_value (file_string);
323 deprecated_set_value_type (file_val, file_string);
324 memcpy (value_contents_raw (file_val),
325 traceframe_sal.symtab->filename,
327 deprecated_set_value_modifiable (file_val, 0);
328 set_internalvar (lookup_internalvar ("trace_file"), file_val);
332 /* Low level routine to set a tracepoint.
333 Returns the tracepoint object so caller can set other things.
334 Does not set the tracepoint number!
335 Does not print anything.
337 ==> This routine should not be called if there is a chance of later
338 error(); otherwise it leaves a bogus tracepoint on the chain.
339 Validate your arguments BEFORE calling this routine! */
341 static struct tracepoint *
342 set_raw_tracepoint (struct symtab_and_line sal)
344 struct tracepoint *t, *tc;
345 struct cleanup *old_chain;
347 t = (struct tracepoint *) xmalloc (sizeof (struct tracepoint));
348 old_chain = make_cleanup (xfree, t);
349 memset (t, 0, sizeof (*t));
351 if (sal.symtab == NULL)
352 t->source_file = NULL;
354 t->source_file = savestring (sal.symtab->filename,
355 strlen (sal.symtab->filename));
357 t->section = sal.section;
358 t->language = current_language->la_language;
359 t->input_radix = input_radix;
360 t->line_number = sal.line;
365 t->addr_string = NULL;
367 /* Add this tracepoint to the end of the chain
368 so that a list of tracepoints will come out in order
369 of increasing numbers. */
371 tc = tracepoint_chain;
373 tracepoint_chain = t;
380 discard_cleanups (old_chain);
384 /* Set a tracepoint according to ARG (function, linenum or *address). */
386 trace_command (char *arg, int from_tty)
388 char **canonical = (char **) NULL;
389 struct symtabs_and_lines sals;
390 struct symtab_and_line sal;
391 struct tracepoint *t;
392 char *addr_start = 0, *addr_end = 0;
396 error (_("trace command requires an argument"));
398 if (from_tty && info_verbose)
399 printf_filtered ("TRACE %s\n", arg);
402 sals = decode_line_1 (&arg, 1, (struct symtab *) NULL,
403 0, &canonical, NULL);
406 return; /* ??? Presumably decode_line_1 has already warned? */
408 /* Resolve all line numbers to PC's */
409 for (i = 0; i < sals.nelts; i++)
410 resolve_sal_pc (&sals.sals[i]);
412 /* Now set all the tracepoints. */
413 for (i = 0; i < sals.nelts; i++)
417 t = set_raw_tracepoint (sal);
418 set_tracepoint_count (tracepoint_count + 1);
419 t->number = tracepoint_count;
421 /* If a canonical line spec is needed use that instead of the
423 if (canonical != (char **) NULL && canonical[i] != NULL)
424 t->addr_string = canonical[i];
426 t->addr_string = savestring (addr_start, addr_end - addr_start);
433 printf_filtered ("Multiple tracepoints were set.\n");
434 printf_filtered ("Use 'delete trace' to delete unwanted tracepoints.\n");
438 /* Tell the user we have just set a tracepoint TP. */
441 trace_mention (struct tracepoint *tp)
443 printf_filtered ("Tracepoint %d", tp->number);
445 if (addressprint || (tp->source_file == NULL))
447 printf_filtered (" at ");
448 deprecated_print_address_numeric (tp->address, 1, gdb_stdout);
451 printf_filtered (": file %s, line %d.",
452 tp->source_file, tp->line_number);
454 printf_filtered ("\n");
457 /* Print information on tracepoint number TPNUM_EXP, or all if
461 tracepoints_info (char *tpnum_exp, int from_tty)
463 struct tracepoint *t;
464 struct action_line *action;
465 int found_a_tracepoint = 0;
466 char wrap_indent[80];
471 tpnum = parse_and_eval_long (tpnum_exp);
474 if (tpnum == -1 || tpnum == t->number)
476 extern int addressprint; /* Print machine addresses? */
478 if (!found_a_tracepoint++)
480 printf_filtered ("Num Enb ");
483 if (TARGET_ADDR_BIT <= 32)
484 printf_filtered ("Address ");
486 printf_filtered ("Address ");
488 printf_filtered ("PassC StepC What\n");
490 strcpy (wrap_indent, " ");
493 if (TARGET_ADDR_BIT <= 32)
494 strcat (wrap_indent, " ");
496 strcat (wrap_indent, " ");
499 printf_filtered ("%-3d %-3s ", t->number,
500 t->enabled_p ? "y" : "n");
505 if (TARGET_ADDR_BIT <= 32)
506 tmp = hex_string_custom (t->address & (CORE_ADDR) 0xffffffff,
509 tmp = hex_string_custom (t->address, 16);
511 printf_filtered ("%s ", tmp);
513 printf_filtered ("%-5d %-5ld ", t->pass_count, t->step_count);
517 sym = find_pc_sect_function (t->address, t->section);
520 fputs_filtered ("in ", gdb_stdout);
521 fputs_filtered (SYMBOL_PRINT_NAME (sym), gdb_stdout);
522 wrap_here (wrap_indent);
523 fputs_filtered (" at ", gdb_stdout);
525 fputs_filtered (t->source_file, gdb_stdout);
526 printf_filtered (":%d", t->line_number);
529 print_address_symbolic (t->address, gdb_stdout, demangle, " ");
531 printf_filtered ("\n");
534 printf_filtered (" Actions for tracepoint %d: \n", t->number);
535 for (action = t->actions; action; action = action->next)
537 printf_filtered ("\t%s\n", action->action);
541 if (!found_a_tracepoint)
544 printf_filtered ("No tracepoints.\n");
546 printf_filtered ("No tracepoint number %d.\n", tpnum);
550 /* Optimization: the code to parse an enable, disable, or delete TP
551 command is virtually identical except for whether it performs an
552 enable, disable, or delete. Therefore I've combined them into one
553 function with an opcode. */
554 enum tracepoint_opcode
561 /* This function implements enable, disable and delete commands. */
563 tracepoint_operation (struct tracepoint *t, int from_tty,
564 enum tracepoint_opcode opcode)
566 struct tracepoint *t2;
568 if (t == NULL) /* no tracepoint operand */
575 tracepoint_modify_event (t->number);
579 tracepoint_modify_event (t->number);
582 if (tracepoint_chain == t)
583 tracepoint_chain = t->next;
588 tracepoint_delete_event (t2->number);
594 xfree (t->addr_string);
596 xfree (t->source_file);
605 /* Utility: parse a tracepoint number and look it up in the list.
606 If MULTI_P is true, there might be a range of tracepoints in ARG.
607 if OPTIONAL_P is true, then if the argument is missing, the most
608 recent tracepoint (tracepoint_count) is returned. */
610 get_tracepoint_by_number (char **arg, int multi_p, int optional_p)
612 struct tracepoint *t;
614 char *instring = arg == NULL ? NULL : *arg;
616 if (arg == NULL || *arg == NULL || ! **arg)
619 tpnum = tracepoint_count;
621 error_no_arg (_("tracepoint number"));
624 tpnum = multi_p ? get_number_or_range (arg) : get_number (arg);
628 if (instring && *instring)
629 printf_filtered ("bad tracepoint number at or near '%s'\n",
632 printf_filtered ("Tracepoint argument missing and no previous tracepoint\n");
637 if (t->number == tpnum)
642 /* FIXME: if we are in the middle of a range we don't want to give
643 a message. The current interface to get_number_or_range doesn't
644 allow us to discover this. */
645 printf_unfiltered ("No tracepoint number %d.\n", tpnum);
650 parse a list of tracepoint numbers, and call a func for each. */
652 map_args_over_tracepoints (char *args, int from_tty,
653 enum tracepoint_opcode opcode)
655 struct tracepoint *t, *tmp;
657 if (args == 0 || *args == 0) /* do them all */
658 ALL_TRACEPOINTS_SAFE (t, tmp)
659 tracepoint_operation (t, from_tty, opcode);
663 QUIT; /* Give user option to bail out with ^C. */
664 t = get_tracepoint_by_number (&args, 1, 0);
665 tracepoint_operation (t, from_tty, opcode);
666 while (*args == ' ' || *args == '\t')
671 /* The 'enable trace' command enables tracepoints.
672 Not supported by all targets. */
674 enable_trace_command (char *args, int from_tty)
677 map_args_over_tracepoints (args, from_tty, enable_op);
680 /* The 'disable trace' command disables tracepoints.
681 Not supported by all targets. */
683 disable_trace_command (char *args, int from_tty)
686 map_args_over_tracepoints (args, from_tty, disable_op);
689 /* Remove a tracepoint (or all if no argument) */
691 delete_trace_command (char *args, int from_tty)
694 if (!args || !*args) /* No args implies all tracepoints; */
695 if (from_tty) /* confirm only if from_tty... */
696 if (tracepoint_chain) /* and if there are tracepoints to
698 if (!query ("Delete all tracepoints? "))
701 map_args_over_tracepoints (args, from_tty, delete_op);
704 /* Set passcount for tracepoint.
706 First command argument is passcount, second is tracepoint number.
707 If tracepoint number omitted, apply to most recently defined.
708 Also accepts special argument "all". */
711 trace_pass_command (char *args, int from_tty)
713 struct tracepoint *t1 = (struct tracepoint *) -1, *t2;
717 if (args == 0 || *args == 0)
718 error (_("passcount command requires an argument (count + optional TP num)"));
720 count = strtoul (args, &args, 10); /* Count comes first, then TP num. */
722 while (*args && isspace ((int) *args))
725 if (*args && strncasecmp (args, "all", 3) == 0)
727 args += 3; /* Skip special argument "all". */
730 error (_("Junk at end of arguments."));
733 t1 = get_tracepoint_by_number (&args, 1, 1);
740 if (t1 == (struct tracepoint *) -1 || t1 == t2)
742 t2->pass_count = count;
743 tracepoint_modify_event (t2->number);
745 printf_filtered ("Setting tracepoint %d's passcount to %d\n",
749 t1 = get_tracepoint_by_number (&args, 1, 0);
755 /* ACTIONS functions: */
757 /* Prototypes for action-parsing utility commands */
758 static void read_actions (struct tracepoint *);
760 /* The three functions:
761 collect_pseudocommand,
762 while_stepping_pseudocommand, and
763 end_actions_pseudocommand
764 are placeholders for "commands" that are actually ONLY to be used
765 within a tracepoint action list. If the actual function is ever called,
766 it means that somebody issued the "command" at the top level,
767 which is always an error. */
770 end_actions_pseudocommand (char *args, int from_tty)
772 error (_("This command cannot be used at the top level."));
776 while_stepping_pseudocommand (char *args, int from_tty)
778 error (_("This command can only be used in a tracepoint actions list."));
782 collect_pseudocommand (char *args, int from_tty)
784 error (_("This command can only be used in a tracepoint actions list."));
787 /* Enter a list of actions for a tracepoint. */
789 trace_actions_command (char *args, int from_tty)
791 struct tracepoint *t;
793 char *end_msg = "End with a line saying just \"end\".";
795 t = get_tracepoint_by_number (&args, 0, 1);
798 sprintf (tmpbuf, "Enter actions for tracepoint %d, one per line.",
803 if (deprecated_readline_begin_hook)
804 (*deprecated_readline_begin_hook) ("%s %s\n", tmpbuf, end_msg);
805 else if (input_from_terminal_p ())
806 printf_filtered ("%s\n%s\n", tmpbuf, end_msg);
810 t->step_count = 0; /* read_actions may set this */
813 if (deprecated_readline_end_hook)
814 (*deprecated_readline_end_hook) ();
815 /* tracepoints_changed () */
817 /* else just return */
820 /* worker function */
822 read_actions (struct tracepoint *t)
825 char *prompt1 = "> ", *prompt2 = " > ";
826 char *prompt = prompt1;
827 enum actionline_type linetype;
828 extern FILE *instream;
829 struct action_line *next = NULL, *temp;
830 struct cleanup *old_chain;
832 /* Control-C quits instantly if typed while in this loop
833 since it should not wait until the user types a newline. */
835 /* FIXME: kettenis/20010823: Something is wrong here. In this file
836 STOP_SIGNAL is never defined. So this code has been left out, at
837 least for quite a while now. Replacing STOP_SIGNAL with SIGTSTP
838 leads to compilation failures since the variable job_control
839 isn't declared. Leave this alone for now. */
842 signal (STOP_SIGNAL, handle_stop_sig);
844 old_chain = make_cleanup_free_actions (t);
847 /* Make sure that all output has been output. Some machines may
848 let you get away with leaving out some of the gdb_flush, but
851 gdb_flush (gdb_stdout);
852 gdb_flush (gdb_stderr);
854 if (deprecated_readline_hook && instream == NULL)
855 line = (*deprecated_readline_hook) (prompt);
856 else if (instream == stdin && ISATTY (instream))
858 line = gdb_readline_wrapper (prompt);
859 if (line && *line) /* add it to command history */
863 line = gdb_readline (0);
868 linetype = validate_actionline (&line, t);
869 if (linetype == BADLINE)
870 continue; /* already warned -- collect another line */
872 temp = xmalloc (sizeof (struct action_line));
876 if (next == NULL) /* first action for this tracepoint? */
877 t->actions = next = temp;
884 if (linetype == STEPPING) /* begin "while-stepping" */
886 if (prompt == prompt2)
888 warning (_("Already processing 'while-stepping'"));
892 prompt = prompt2; /* change prompt for stepping actions */
894 else if (linetype == END)
896 if (prompt == prompt2)
898 prompt = prompt1; /* end of single-stepping actions */
901 { /* end of actions */
902 if (t->actions->next == NULL)
904 /* An "end" all by itself with no other actions
905 means this tracepoint has no actions.
906 Discard empty list. */
915 signal (STOP_SIGNAL, SIG_DFL);
918 discard_cleanups (old_chain);
921 /* worker function */
923 validate_actionline (char **line, struct tracepoint *t)
925 struct cmd_list_element *c;
926 struct expression *exp = NULL;
927 struct cleanup *old_chain = NULL;
930 /* if EOF is typed, *line is NULL */
934 for (p = *line; isspace ((int) *p);)
937 /* Symbol lookup etc. */
938 if (*p == '\0') /* empty line: just prompt for another line. */
941 if (*p == '#') /* comment line */
944 c = lookup_cmd (&p, cmdlist, "", -1, 1);
947 warning (_("'%s' is not an action that I know, or is ambiguous."),
952 if (cmd_cfunc_eq (c, collect_pseudocommand))
954 struct agent_expr *aexpr;
955 struct agent_reqs areqs;
958 { /* repeat over a comma-separated list */
959 QUIT; /* allow user to bail out with ^C */
960 while (isspace ((int) *p))
963 if (*p == '$') /* look for special pseudo-symbols */
965 if ((0 == strncasecmp ("reg", p + 1, 3)) ||
966 (0 == strncasecmp ("arg", p + 1, 3)) ||
967 (0 == strncasecmp ("loc", p + 1, 3)))
972 /* else fall thru, treat p as an expression and parse it! */
974 exp = parse_exp_1 (&p, block_for_pc (t->address), 1);
975 old_chain = make_cleanup (free_current_contents, &exp);
977 if (exp->elts[0].opcode == OP_VAR_VALUE)
979 if (SYMBOL_CLASS (exp->elts[2].symbol) == LOC_CONST)
981 warning (_("constant %s (value %ld) will not be collected."),
982 DEPRECATED_SYMBOL_NAME (exp->elts[2].symbol),
983 SYMBOL_VALUE (exp->elts[2].symbol));
986 else if (SYMBOL_CLASS (exp->elts[2].symbol) == LOC_OPTIMIZED_OUT)
988 warning (_("%s is optimized away and cannot be collected."),
989 DEPRECATED_SYMBOL_NAME (exp->elts[2].symbol));
994 /* We have something to collect, make sure that the expr to
995 bytecode translator can handle it and that it's not too
997 aexpr = gen_trace_for_expr (t->address, exp);
998 make_cleanup_free_agent_expr (aexpr);
1000 if (aexpr->len > MAX_AGENT_EXPR_LEN)
1001 error (_("expression too complicated, try simplifying"));
1003 ax_reqs (aexpr, &areqs);
1004 (void) make_cleanup (xfree, areqs.reg_mask);
1006 if (areqs.flaw != agent_flaw_none)
1007 error (_("malformed expression"));
1009 if (areqs.min_height < 0)
1010 error (_("gdb: Internal error: expression has min height < 0"));
1012 if (areqs.max_height > 20)
1013 error (_("expression too complicated, try simplifying"));
1015 do_cleanups (old_chain);
1017 while (p && *p++ == ',');
1020 else if (cmd_cfunc_eq (c, while_stepping_pseudocommand))
1022 char *steparg; /* in case warning is necessary */
1024 while (isspace ((int) *p))
1029 (t->step_count = strtol (p, &p, 0)) == 0)
1031 warning (_("'%s': bad step-count; command ignored."), *line);
1036 else if (cmd_cfunc_eq (c, end_actions_pseudocommand))
1040 warning (_("'%s' is not a supported tracepoint action."), *line);
1045 /* worker function */
1047 free_actions (struct tracepoint *t)
1049 struct action_line *line, *next;
1051 for (line = t->actions; line; line = next)
1055 xfree (line->action);
1062 do_free_actions_cleanup (void *t)
1067 static struct cleanup *
1068 make_cleanup_free_actions (struct tracepoint *t)
1070 return make_cleanup (do_free_actions_cleanup, t);
1074 memrange_absolute = -1
1079 int type; /* memrange_absolute for absolute memory range,
1080 else basereg number */
1081 bfd_signed_vma start;
1085 struct collection_list
1087 unsigned char regs_mask[32]; /* room for up to 256 regs */
1090 struct memrange *list;
1091 long aexpr_listsize; /* size of array pointed to by expr_list elt */
1092 long next_aexpr_elt;
1093 struct agent_expr **aexpr_list;
1096 tracepoint_list, stepping_list;
1098 /* MEMRANGE functions: */
1100 static int memrange_cmp (const void *, const void *);
1102 /* compare memranges for qsort */
1104 memrange_cmp (const void *va, const void *vb)
1106 const struct memrange *a = va, *b = vb;
1108 if (a->type < b->type)
1110 if (a->type > b->type)
1112 if (a->type == memrange_absolute)
1114 if ((bfd_vma) a->start < (bfd_vma) b->start)
1116 if ((bfd_vma) a->start > (bfd_vma) b->start)
1121 if (a->start < b->start)
1123 if (a->start > b->start)
1129 /* Sort the memrange list using qsort, and merge adjacent memranges. */
1131 memrange_sortmerge (struct collection_list *memranges)
1135 qsort (memranges->list, memranges->next_memrange,
1136 sizeof (struct memrange), memrange_cmp);
1137 if (memranges->next_memrange > 0)
1139 for (a = 0, b = 1; b < memranges->next_memrange; b++)
1141 if (memranges->list[a].type == memranges->list[b].type &&
1142 memranges->list[b].start - memranges->list[a].end <=
1145 /* memrange b starts before memrange a ends; merge them. */
1146 if (memranges->list[b].end > memranges->list[a].end)
1147 memranges->list[a].end = memranges->list[b].end;
1148 continue; /* next b, same a */
1152 memcpy (&memranges->list[a], &memranges->list[b],
1153 sizeof (struct memrange));
1155 memranges->next_memrange = a + 1;
1159 /* Add a register to a collection list. */
1161 add_register (struct collection_list *collection, unsigned int regno)
1164 printf_filtered ("collect register %d\n", regno);
1165 if (regno > (8 * sizeof (collection->regs_mask)))
1166 error (_("Internal: register number %d too large for tracepoint"),
1168 collection->regs_mask[regno / 8] |= 1 << (regno % 8);
1171 /* Add a memrange to a collection list */
1173 add_memrange (struct collection_list *memranges,
1174 int type, bfd_signed_vma base,
1179 printf_filtered ("(%d,", type);
1181 printf_filtered (",%ld)\n", len);
1184 /* type: memrange_absolute == memory, other n == basereg */
1185 memranges->list[memranges->next_memrange].type = type;
1186 /* base: addr if memory, offset if reg relative. */
1187 memranges->list[memranges->next_memrange].start = base;
1188 /* len: we actually save end (base + len) for convenience */
1189 memranges->list[memranges->next_memrange].end = base + len;
1190 memranges->next_memrange++;
1191 if (memranges->next_memrange >= memranges->listsize)
1193 memranges->listsize *= 2;
1194 memranges->list = xrealloc (memranges->list,
1195 memranges->listsize);
1198 if (type != memrange_absolute) /* Better collect the base register! */
1199 add_register (memranges, type);
1202 /* Add a symbol to a collection list. */
1204 collect_symbol (struct collection_list *collect,
1206 long frame_regno, long frame_offset)
1210 bfd_signed_vma offset;
1212 len = TYPE_LENGTH (check_typedef (SYMBOL_TYPE (sym)));
1213 switch (SYMBOL_CLASS (sym))
1216 printf_filtered ("%s: don't know symbol class %d\n",
1217 DEPRECATED_SYMBOL_NAME (sym),
1218 SYMBOL_CLASS (sym));
1221 printf_filtered ("constant %s (value %ld) will not be collected.\n",
1222 DEPRECATED_SYMBOL_NAME (sym), SYMBOL_VALUE (sym));
1225 offset = SYMBOL_VALUE_ADDRESS (sym);
1230 sprintf_vma (tmp, offset);
1231 printf_filtered ("LOC_STATIC %s: collect %ld bytes at %s.\n",
1232 DEPRECATED_SYMBOL_NAME (sym), len,
1235 add_memrange (collect, memrange_absolute, offset, len);
1239 reg = SYMBOL_VALUE (sym);
1241 printf_filtered ("LOC_REG[parm] %s: ",
1242 DEPRECATED_SYMBOL_NAME (sym));
1243 add_register (collect, reg);
1244 /* Check for doubles stored in two registers. */
1245 /* FIXME: how about larger types stored in 3 or more regs? */
1246 if (TYPE_CODE (SYMBOL_TYPE (sym)) == TYPE_CODE_FLT &&
1247 len > register_size (current_gdbarch, reg))
1248 add_register (collect, reg + 1);
1251 printf_filtered ("Sorry, don't know how to do LOC_REF_ARG yet.\n");
1252 printf_filtered (" (will not collect %s)\n",
1253 DEPRECATED_SYMBOL_NAME (sym));
1257 offset = frame_offset + SYMBOL_VALUE (sym);
1260 printf_filtered ("LOC_LOCAL %s: Collect %ld bytes at offset ",
1261 DEPRECATED_SYMBOL_NAME (sym), len);
1262 printf_vma (offset);
1263 printf_filtered (" from frame ptr reg %d\n", reg);
1265 add_memrange (collect, reg, offset, len);
1267 case LOC_REGPARM_ADDR:
1268 reg = SYMBOL_VALUE (sym);
1272 printf_filtered ("LOC_REGPARM_ADDR %s: Collect %ld bytes at offset ",
1273 DEPRECATED_SYMBOL_NAME (sym), len);
1274 printf_vma (offset);
1275 printf_filtered (" from reg %d\n", reg);
1277 add_memrange (collect, reg, offset, len);
1282 offset = frame_offset + SYMBOL_VALUE (sym);
1285 printf_filtered ("LOC_LOCAL %s: Collect %ld bytes at offset ",
1286 DEPRECATED_SYMBOL_NAME (sym), len);
1287 printf_vma (offset);
1288 printf_filtered (" from frame ptr reg %d\n", reg);
1290 add_memrange (collect, reg, offset, len);
1293 case LOC_BASEREG_ARG:
1294 reg = SYMBOL_BASEREG (sym);
1295 offset = SYMBOL_VALUE (sym);
1298 printf_filtered ("LOC_BASEREG %s: collect %ld bytes at offset ",
1299 DEPRECATED_SYMBOL_NAME (sym), len);
1300 printf_vma (offset);
1301 printf_filtered (" from basereg %d\n", reg);
1303 add_memrange (collect, reg, offset, len);
1305 case LOC_UNRESOLVED:
1306 printf_filtered ("Don't know LOC_UNRESOLVED %s\n",
1307 DEPRECATED_SYMBOL_NAME (sym));
1309 case LOC_OPTIMIZED_OUT:
1310 printf_filtered ("%s has been optimized out of existence.\n",
1311 DEPRECATED_SYMBOL_NAME (sym));
1316 /* Add all locals (or args) symbols to collection list */
1318 add_local_symbols (struct collection_list *collect, CORE_ADDR pc,
1319 long frame_regno, long frame_offset, int type)
1322 struct block *block;
1323 struct dict_iterator iter;
1326 block = block_for_pc (pc);
1329 QUIT; /* allow user to bail out with ^C */
1330 ALL_BLOCK_SYMBOLS (block, iter, sym)
1332 switch (SYMBOL_CLASS (sym))
1335 warning (_("don't know how to trace local symbol %s"),
1336 DEPRECATED_SYMBOL_NAME (sym));
1341 if (type == 'L') /* collecting Locals */
1344 collect_symbol (collect, sym, frame_regno,
1352 case LOC_REGPARM_ADDR:
1353 case LOC_BASEREG_ARG:
1354 if (type == 'A') /* collecting Arguments */
1357 collect_symbol (collect, sym, frame_regno,
1362 if (BLOCK_FUNCTION (block))
1365 block = BLOCK_SUPERBLOCK (block);
1368 warning (_("No %s found in scope."),
1369 type == 'L' ? "locals" : "args");
1372 /* worker function */
1374 clear_collection_list (struct collection_list *list)
1378 list->next_memrange = 0;
1379 for (ndx = 0; ndx < list->next_aexpr_elt; ndx++)
1381 free_agent_expr (list->aexpr_list[ndx]);
1382 list->aexpr_list[ndx] = NULL;
1384 list->next_aexpr_elt = 0;
1385 memset (list->regs_mask, 0, sizeof (list->regs_mask));
1388 /* reduce a collection list to string form (for gdb protocol) */
1390 stringify_collection_list (struct collection_list *list, char *string)
1392 char temp_buf[2048];
1396 char *(*str_list)[];
1400 count = 1 + list->next_memrange + list->next_aexpr_elt + 1;
1401 str_list = (char *(*)[]) xmalloc (count * sizeof (char *));
1403 for (i = sizeof (list->regs_mask) - 1; i > 0; i--)
1404 if (list->regs_mask[i] != 0) /* skip leading zeroes in regs_mask */
1406 if (list->regs_mask[i] != 0) /* prepare to send regs_mask to the stub */
1409 printf_filtered ("\nCollecting registers (mask): 0x");
1414 QUIT; /* allow user to bail out with ^C */
1416 printf_filtered ("%02X", list->regs_mask[i]);
1417 sprintf (end, "%02X", list->regs_mask[i]);
1420 (*str_list)[ndx] = savestring (temp_buf, end - temp_buf);
1424 printf_filtered ("\n");
1425 if (list->next_memrange > 0 && info_verbose)
1426 printf_filtered ("Collecting memranges: \n");
1427 for (i = 0, count = 0, end = temp_buf; i < list->next_memrange; i++)
1429 QUIT; /* allow user to bail out with ^C */
1430 sprintf_vma (tmp2, list->list[i].start);
1433 printf_filtered ("(%d, %s, %ld)\n",
1436 (long) (list->list[i].end - list->list[i].start));
1438 if (count + 27 > MAX_AGENT_EXPR_LEN)
1440 (*str_list)[ndx] = savestring (temp_buf, count);
1447 bfd_signed_vma length = list->list[i].end - list->list[i].start;
1449 /* The "%X" conversion specifier expects an unsigned argument,
1450 so passing -1 (memrange_absolute) to it directly gives you
1451 "FFFFFFFF" (or more, depending on sizeof (unsigned)).
1453 if (list->list[i].type == memrange_absolute)
1454 sprintf (end, "M-1,%s,%lX", tmp2, (long) length);
1456 sprintf (end, "M%X,%s,%lX", list->list[i].type, tmp2, (long) length);
1459 count += strlen (end);
1460 end = temp_buf + count;
1463 for (i = 0; i < list->next_aexpr_elt; i++)
1465 QUIT; /* allow user to bail out with ^C */
1466 if ((count + 10 + 2 * list->aexpr_list[i]->len) > MAX_AGENT_EXPR_LEN)
1468 (*str_list)[ndx] = savestring (temp_buf, count);
1473 sprintf (end, "X%08X,", list->aexpr_list[i]->len);
1474 end += 10; /* 'X' + 8 hex digits + ',' */
1477 end = mem2hex (list->aexpr_list[i]->buf,
1478 end, list->aexpr_list[i]->len);
1479 count += 2 * list->aexpr_list[i]->len;
1484 (*str_list)[ndx] = savestring (temp_buf, count);
1489 (*str_list)[ndx] = NULL;
1498 free_actions_list_cleanup_wrapper (void *al)
1500 free_actions_list (al);
1504 free_actions_list (char **actions_list)
1508 if (actions_list == 0)
1511 for (ndx = 0; actions_list[ndx]; ndx++)
1512 xfree (actions_list[ndx]);
1514 xfree (actions_list);
1517 /* Render all actions into gdb protocol. */
1519 encode_actions (struct tracepoint *t, char ***tdp_actions,
1520 char ***stepping_actions)
1522 static char tdp_buff[2048], step_buff[2048];
1524 struct expression *exp = NULL;
1525 struct action_line *action;
1527 struct value *tempval;
1528 struct collection_list *collect;
1529 struct cmd_list_element *cmd;
1530 struct agent_expr *aexpr;
1532 LONGEST frame_offset;
1535 clear_collection_list (&tracepoint_list);
1536 clear_collection_list (&stepping_list);
1537 collect = &tracepoint_list;
1539 *tdp_actions = NULL;
1540 *stepping_actions = NULL;
1542 gdbarch_virtual_frame_pointer (current_gdbarch,
1543 t->address, &frame_reg, &frame_offset);
1545 for (action = t->actions; action; action = action->next)
1547 QUIT; /* allow user to bail out with ^C */
1548 action_exp = action->action;
1549 while (isspace ((int) *action_exp))
1552 if (*action_exp == '#') /* comment line */
1555 cmd = lookup_cmd (&action_exp, cmdlist, "", -1, 1);
1557 error (_("Bad action list item: %s"), action_exp);
1559 if (cmd_cfunc_eq (cmd, collect_pseudocommand))
1562 { /* repeat over a comma-separated list */
1563 QUIT; /* allow user to bail out with ^C */
1564 while (isspace ((int) *action_exp))
1567 if (0 == strncasecmp ("$reg", action_exp, 4))
1569 for (i = 0; i < gdbarch_num_regs (current_gdbarch); i++)
1570 add_register (collect, i);
1571 action_exp = strchr (action_exp, ','); /* more? */
1573 else if (0 == strncasecmp ("$arg", action_exp, 4))
1575 add_local_symbols (collect,
1580 action_exp = strchr (action_exp, ','); /* more? */
1582 else if (0 == strncasecmp ("$loc", action_exp, 4))
1584 add_local_symbols (collect,
1589 action_exp = strchr (action_exp, ','); /* more? */
1593 unsigned long addr, len;
1594 struct cleanup *old_chain = NULL;
1595 struct cleanup *old_chain1 = NULL;
1596 struct agent_reqs areqs;
1598 exp = parse_exp_1 (&action_exp,
1599 block_for_pc (t->address), 1);
1600 old_chain = make_cleanup (free_current_contents, &exp);
1602 switch (exp->elts[0].opcode)
1606 const char *name = &exp->elts[2].string;
1608 i = frame_map_name_to_regnum (deprecated_safe_get_selected_frame (),
1609 name, strlen (name));
1611 internal_error (__FILE__, __LINE__,
1612 _("Register $%s not available"),
1615 printf_filtered ("OP_REGISTER: ");
1616 add_register (collect, i);
1621 /* safe because we know it's a simple expression */
1622 tempval = evaluate_expression (exp);
1623 addr = VALUE_ADDRESS (tempval) + value_offset (tempval);
1624 len = TYPE_LENGTH (check_typedef (exp->elts[1].type));
1625 add_memrange (collect, memrange_absolute, addr, len);
1629 collect_symbol (collect,
1630 exp->elts[2].symbol,
1635 default: /* full-fledged expression */
1636 aexpr = gen_trace_for_expr (t->address, exp);
1638 old_chain1 = make_cleanup_free_agent_expr (aexpr);
1640 ax_reqs (aexpr, &areqs);
1641 if (areqs.flaw != agent_flaw_none)
1642 error (_("malformed expression"));
1644 if (areqs.min_height < 0)
1645 error (_("gdb: Internal error: expression has min height < 0"));
1646 if (areqs.max_height > 20)
1647 error (_("expression too complicated, try simplifying"));
1649 discard_cleanups (old_chain1);
1650 add_aexpr (collect, aexpr);
1652 /* take care of the registers */
1653 if (areqs.reg_mask_len > 0)
1658 for (ndx1 = 0; ndx1 < areqs.reg_mask_len; ndx1++)
1660 QUIT; /* allow user to bail out with ^C */
1661 if (areqs.reg_mask[ndx1] != 0)
1663 /* assume chars have 8 bits */
1664 for (ndx2 = 0; ndx2 < 8; ndx2++)
1665 if (areqs.reg_mask[ndx1] & (1 << ndx2))
1666 /* it's used -- record it */
1667 add_register (collect,
1674 do_cleanups (old_chain);
1677 while (action_exp && *action_exp++ == ',');
1679 else if (cmd_cfunc_eq (cmd, while_stepping_pseudocommand))
1681 collect = &stepping_list;
1683 else if (cmd_cfunc_eq (cmd, end_actions_pseudocommand))
1685 if (collect == &stepping_list) /* end stepping actions */
1686 collect = &tracepoint_list;
1688 break; /* end tracepoint actions */
1691 memrange_sortmerge (&tracepoint_list);
1692 memrange_sortmerge (&stepping_list);
1694 *tdp_actions = stringify_collection_list (&tracepoint_list,
1696 *stepping_actions = stringify_collection_list (&stepping_list,
1701 add_aexpr (struct collection_list *collect, struct agent_expr *aexpr)
1703 if (collect->next_aexpr_elt >= collect->aexpr_listsize)
1705 collect->aexpr_list =
1706 xrealloc (collect->aexpr_list,
1707 2 * collect->aexpr_listsize * sizeof (struct agent_expr *));
1708 collect->aexpr_listsize *= 2;
1710 collect->aexpr_list[collect->next_aexpr_elt] = aexpr;
1711 collect->next_aexpr_elt++;
1714 static char *target_buf;
1715 static long target_buf_size;
1717 /* Set "transparent" memory ranges
1719 Allow trace mechanism to treat text-like sections
1720 (and perhaps all read-only sections) transparently,
1721 i.e. don't reject memory requests from these address ranges
1722 just because they haven't been collected. */
1725 remote_set_transparent_ranges (void)
1727 extern bfd *exec_bfd;
1734 return; /* No information to give. */
1736 strcpy (target_buf, "QTro");
1737 for (s = exec_bfd->sections; s; s = s->next)
1739 char tmp1[40], tmp2[40];
1741 if ((s->flags & SEC_LOAD) == 0 ||
1742 /* (s->flags & SEC_CODE) == 0 || */
1743 (s->flags & SEC_READONLY) == 0)
1748 size = bfd_get_section_size (s);
1749 sprintf_vma (tmp1, lma);
1750 sprintf_vma (tmp2, lma + size);
1751 sprintf (target_buf + strlen (target_buf),
1752 ":%s,%s", tmp1, tmp2);
1756 putpkt (target_buf);
1757 getpkt (&target_buf, &target_buf_size, 0);
1763 Tell target to clear any previous trace experiment.
1764 Walk the list of tracepoints, and send them (and their actions)
1765 to the target. If no errors,
1766 Tell target to start a new trace experiment. */
1769 trace_start_command (char *args, int from_tty)
1771 struct tracepoint *t;
1774 char **stepping_actions;
1776 struct cleanup *old_chain = NULL;
1778 dont_repeat (); /* Like "run", dangerous to repeat accidentally. */
1780 if (target_is_remote ())
1783 remote_get_noisy_reply (&target_buf, &target_buf_size);
1784 if (strcmp (target_buf, "OK"))
1785 error (_("Target does not support this command."));
1791 sprintf_vma (tmp, t->address);
1792 sprintf (buf, "QTDP:%x:%s:%c:%lx:%x", t->number,
1794 t->enabled_p ? 'E' : 'D',
1795 t->step_count, t->pass_count);
1800 remote_get_noisy_reply (&target_buf, &target_buf_size);
1801 if (strcmp (target_buf, "OK"))
1802 error (_("Target does not support tracepoints."));
1806 encode_actions (t, &tdp_actions, &stepping_actions);
1807 old_chain = make_cleanup (free_actions_list_cleanup_wrapper,
1809 (void) make_cleanup (free_actions_list_cleanup_wrapper,
1812 /* do_single_steps (t); */
1815 for (ndx = 0; tdp_actions[ndx]; ndx++)
1817 QUIT; /* allow user to bail out with ^C */
1818 sprintf (buf, "QTDP:-%x:%s:%s%c",
1819 t->number, tmp, /* address */
1821 ((tdp_actions[ndx + 1] || stepping_actions)
1824 remote_get_noisy_reply (&target_buf,
1826 if (strcmp (target_buf, "OK"))
1827 error (_("Error on target while setting tracepoints."));
1830 if (stepping_actions)
1832 for (ndx = 0; stepping_actions[ndx]; ndx++)
1834 QUIT; /* allow user to bail out with ^C */
1835 sprintf (buf, "QTDP:-%x:%s:%s%s%s",
1836 t->number, tmp, /* address */
1837 ((ndx == 0) ? "S" : ""),
1838 stepping_actions[ndx],
1839 (stepping_actions[ndx + 1] ? "-" : ""));
1841 remote_get_noisy_reply (&target_buf,
1843 if (strcmp (target_buf, "OK"))
1844 error (_("Error on target while setting tracepoints."));
1848 do_cleanups (old_chain);
1851 /* Tell target to treat text-like sections as transparent. */
1852 remote_set_transparent_ranges ();
1853 /* Now insert traps and begin collecting data. */
1855 remote_get_noisy_reply (&target_buf, &target_buf_size);
1856 if (strcmp (target_buf, "OK"))
1857 error (_("Bogus reply from target: %s"), target_buf);
1858 set_traceframe_num (-1); /* All old traceframes invalidated. */
1859 set_tracepoint_num (-1);
1860 set_traceframe_context (-1);
1861 trace_running_p = 1;
1862 if (deprecated_trace_start_stop_hook)
1863 deprecated_trace_start_stop_hook (1, from_tty);
1867 error (_("Trace can only be run on remote targets."));
1872 trace_stop_command (char *args, int from_tty)
1874 if (target_is_remote ())
1877 remote_get_noisy_reply (&target_buf, &target_buf_size);
1878 if (strcmp (target_buf, "OK"))
1879 error (_("Bogus reply from target: %s"), target_buf);
1880 trace_running_p = 0;
1881 if (deprecated_trace_start_stop_hook)
1882 deprecated_trace_start_stop_hook (0, from_tty);
1885 error (_("Trace can only be run on remote targets."));
1888 unsigned long trace_running_p;
1890 /* tstatus command */
1892 trace_status_command (char *args, int from_tty)
1894 if (target_is_remote ())
1896 putpkt ("qTStatus");
1897 remote_get_noisy_reply (&target_buf, &target_buf_size);
1899 if (target_buf[0] != 'T' ||
1900 (target_buf[1] != '0' && target_buf[1] != '1'))
1901 error (_("Bogus reply from target: %s"), target_buf);
1903 /* exported for use by the GUI */
1904 trace_running_p = (target_buf[1] == '1');
1907 error (_("Trace can only be run on remote targets."));
1910 /* Worker function for the various flavors of the tfind command. */
1912 finish_tfind_command (char **msg,
1916 int target_frameno = -1, target_tracept = -1;
1917 CORE_ADDR old_frame_addr;
1918 struct symbol *old_func;
1921 old_frame_addr = get_frame_base (get_current_frame ());
1922 old_func = find_pc_function (read_pc ());
1925 reply = remote_get_noisy_reply (msg, sizeof_msg);
1927 while (reply && *reply)
1931 if ((target_frameno = (int) strtol (++reply, &reply, 16)) == -1)
1933 /* A request for a non-existant trace frame has failed.
1934 Our response will be different, depending on FROM_TTY:
1936 If FROM_TTY is true, meaning that this command was
1937 typed interactively by the user, then give an error
1938 and DO NOT change the state of traceframe_number etc.
1940 However if FROM_TTY is false, meaning that we're either
1941 in a script, a loop, or a user-defined command, then
1942 DON'T give an error, but DO change the state of
1943 traceframe_number etc. to invalid.
1945 The rationalle is that if you typed the command, you
1946 might just have committed a typo or something, and you'd
1947 like to NOT lose your current debugging state. However
1948 if you're in a user-defined command or especially in a
1949 loop, then you need a way to detect that the command
1950 failed WITHOUT aborting. This allows you to write
1951 scripts that search thru the trace buffer until the end,
1952 and then continue on to do something else. */
1955 error (_("Target failed to find requested trace frame."));
1959 printf_filtered ("End of trace buffer.\n");
1960 /* The following will not recurse, since it's
1962 trace_find_command ("-1", from_tty);
1963 reply = NULL; /* Break out of loop
1964 (avoid recursive nonsense). */
1969 if ((target_tracept = (int) strtol (++reply, &reply, 16)) == -1)
1970 error (_("Target failed to find requested trace frame."));
1972 case 'O': /* "OK"? */
1973 if (reply[1] == 'K' && reply[2] == '\0')
1976 error (_("Bogus reply from target: %s"), reply);
1979 error (_("Bogus reply from target: %s"), reply);
1982 reinit_frame_cache ();
1983 registers_changed ();
1984 set_traceframe_num (target_frameno);
1985 set_tracepoint_num (target_tracept);
1986 if (target_frameno == -1)
1987 set_traceframe_context (-1);
1989 set_traceframe_context (read_pc ());
1993 enum print_what print_what;
1995 /* NOTE: in immitation of the step command, try to determine
1996 whether we have made a transition from one function to
1997 another. If so, we'll print the "stack frame" (ie. the new
1998 function and it's arguments) -- otherwise we'll just show the
2001 This determination is made by checking (1) whether the
2002 current function has changed, and (2) whether the current FP
2003 has changed. Hack: if the FP wasn't collected, either at the
2004 current or the previous frame, assume that the FP has NOT
2007 if (old_func == find_pc_function (read_pc ()) &&
2008 (old_frame_addr == 0 ||
2009 get_frame_base (get_current_frame ()) == 0 ||
2010 old_frame_addr == get_frame_base (get_current_frame ())))
2011 print_what = SRC_LINE;
2013 print_what = SRC_AND_LOC;
2015 print_stack_frame (get_selected_frame (NULL), 1, print_what);
2020 /* trace_find_command takes a trace frame number n,
2021 sends "QTFrame:<n>" to the target,
2022 and accepts a reply that may contain several optional pieces
2023 of information: a frame number, a tracepoint number, and an
2024 indication of whether this is a trap frame or a stepping frame.
2026 The minimal response is just "OK" (which indicates that the
2027 target does not give us a frame number or a tracepoint number).
2028 Instead of that, the target may send us a string containing
2030 F<hexnum> (gives the selected frame number)
2031 T<hexnum> (gives the selected tracepoint number)
2036 trace_find_command (char *args, int from_tty)
2037 { /* this should only be called with a numeric argument */
2040 if (target_is_remote ())
2042 if (deprecated_trace_find_hook)
2043 deprecated_trace_find_hook (args, from_tty);
2045 if (args == 0 || *args == 0)
2046 { /* TFIND with no args means find NEXT trace frame. */
2047 if (traceframe_number == -1)
2048 frameno = 0; /* "next" is first one */
2050 frameno = traceframe_number + 1;
2052 else if (0 == strcmp (args, "-"))
2054 if (traceframe_number == -1)
2055 error (_("not debugging trace buffer"));
2056 else if (from_tty && traceframe_number == 0)
2057 error (_("already at start of trace buffer"));
2059 frameno = traceframe_number - 1;
2062 frameno = parse_and_eval_long (args);
2065 error (_("invalid input (%d is less than zero)"), frameno);
2067 sprintf (target_buf, "QTFrame:%x", frameno);
2068 finish_tfind_command (&target_buf, &target_buf_size, from_tty);
2071 error (_("Trace can only be run on remote targets."));
2076 trace_find_end_command (char *args, int from_tty)
2078 trace_find_command ("-1", from_tty);
2083 trace_find_none_command (char *args, int from_tty)
2085 trace_find_command ("-1", from_tty);
2090 trace_find_start_command (char *args, int from_tty)
2092 trace_find_command ("0", from_tty);
2095 /* tfind pc command */
2097 trace_find_pc_command (char *args, int from_tty)
2102 if (target_is_remote ())
2104 if (args == 0 || *args == 0)
2105 pc = read_pc (); /* default is current pc */
2107 pc = parse_and_eval_address (args);
2109 sprintf_vma (tmp, pc);
2110 sprintf (target_buf, "QTFrame:pc:%s", tmp);
2111 finish_tfind_command (&target_buf, &target_buf_size, from_tty);
2114 error (_("Trace can only be run on remote targets."));
2117 /* tfind tracepoint command */
2119 trace_find_tracepoint_command (char *args, int from_tty)
2123 if (target_is_remote ())
2125 if (args == 0 || *args == 0)
2127 if (tracepoint_number == -1)
2128 error (_("No current tracepoint -- please supply an argument."));
2130 tdp = tracepoint_number; /* default is current TDP */
2133 tdp = parse_and_eval_long (args);
2135 sprintf (target_buf, "QTFrame:tdp:%x", tdp);
2136 finish_tfind_command (&target_buf, &target_buf_size, from_tty);
2139 error (_("Trace can only be run on remote targets."));
2142 /* TFIND LINE command:
2144 This command will take a sourceline for argument, just like BREAK
2145 or TRACE (ie. anything that "decode_line_1" can handle).
2147 With no argument, this command will find the next trace frame
2148 corresponding to a source line OTHER THAN THE CURRENT ONE. */
2151 trace_find_line_command (char *args, int from_tty)
2153 static CORE_ADDR start_pc, end_pc;
2154 struct symtabs_and_lines sals;
2155 struct symtab_and_line sal;
2156 struct cleanup *old_chain;
2157 char startpc_str[40], endpc_str[40];
2159 if (target_is_remote ())
2161 if (args == 0 || *args == 0)
2163 sal = find_pc_line (get_frame_pc (get_current_frame ()), 0);
2165 sals.sals = (struct symtab_and_line *)
2166 xmalloc (sizeof (struct symtab_and_line));
2171 sals = decode_line_spec (args, 1);
2175 old_chain = make_cleanup (xfree, sals.sals);
2176 if (sal.symtab == 0)
2178 printf_filtered ("TFIND: No line number information available");
2181 /* This is useful for "info line *0x7f34". If we can't
2182 tell the user about a source line, at least let them
2183 have the symbolic address. */
2184 printf_filtered (" for address ");
2186 print_address (sal.pc, gdb_stdout);
2187 printf_filtered (";\n -- will attempt to find by PC. \n");
2191 printf_filtered (".\n");
2192 return; /* No line, no PC; what can we do? */
2195 else if (sal.line > 0
2196 && find_line_pc_range (sal, &start_pc, &end_pc))
2198 if (start_pc == end_pc)
2200 printf_filtered ("Line %d of \"%s\"",
2201 sal.line, sal.symtab->filename);
2203 printf_filtered (" is at address ");
2204 print_address (start_pc, gdb_stdout);
2206 printf_filtered (" but contains no code.\n");
2207 sal = find_pc_line (start_pc, 0);
2209 find_line_pc_range (sal, &start_pc, &end_pc) &&
2211 printf_filtered ("Attempting to find line %d instead.\n",
2214 error (_("Cannot find a good line."));
2218 /* Is there any case in which we get here, and have an address
2219 which the user would want to see? If we have debugging
2220 symbols and no line numbers? */
2221 error (_("Line number %d is out of range for \"%s\"."),
2222 sal.line, sal.symtab->filename);
2224 sprintf_vma (startpc_str, start_pc);
2225 sprintf_vma (endpc_str, end_pc - 1);
2226 /* Find within range of stated line. */
2228 sprintf (target_buf, "QTFrame:range:%s:%s",
2229 startpc_str, endpc_str);
2230 /* Find OUTSIDE OF range of CURRENT line. */
2232 sprintf (target_buf, "QTFrame:outside:%s:%s",
2233 startpc_str, endpc_str);
2234 finish_tfind_command (&target_buf, &target_buf_size,
2236 do_cleanups (old_chain);
2239 error (_("Trace can only be run on remote targets."));
2242 /* tfind range command */
2244 trace_find_range_command (char *args, int from_tty)
2246 static CORE_ADDR start, stop;
2247 char start_str[40], stop_str[40];
2250 if (target_is_remote ())
2252 if (args == 0 || *args == 0)
2253 { /* XXX FIXME: what should default behavior be? */
2254 printf_filtered ("Usage: tfind range <startaddr>,<endaddr>\n");
2258 if (0 != (tmp = strchr (args, ',')))
2260 *tmp++ = '\0'; /* terminate start address */
2261 while (isspace ((int) *tmp))
2263 start = parse_and_eval_address (args);
2264 stop = parse_and_eval_address (tmp);
2267 { /* no explicit end address? */
2268 start = parse_and_eval_address (args);
2269 stop = start + 1; /* ??? */
2272 sprintf_vma (start_str, start);
2273 sprintf_vma (stop_str, stop);
2274 sprintf (target_buf, "QTFrame:range:%s:%s", start_str, stop_str);
2275 finish_tfind_command (&target_buf, &target_buf_size, from_tty);
2278 error (_("Trace can only be run on remote targets."));
2281 /* tfind outside command */
2283 trace_find_outside_command (char *args, int from_tty)
2285 CORE_ADDR start, stop;
2286 char start_str[40], stop_str[40];
2289 if (target_is_remote ())
2291 if (args == 0 || *args == 0)
2292 { /* XXX FIXME: what should default behavior be? */
2293 printf_filtered ("Usage: tfind outside <startaddr>,<endaddr>\n");
2297 if (0 != (tmp = strchr (args, ',')))
2299 *tmp++ = '\0'; /* terminate start address */
2300 while (isspace ((int) *tmp))
2302 start = parse_and_eval_address (args);
2303 stop = parse_and_eval_address (tmp);
2306 { /* no explicit end address? */
2307 start = parse_and_eval_address (args);
2308 stop = start + 1; /* ??? */
2311 sprintf_vma (start_str, start);
2312 sprintf_vma (stop_str, stop);
2313 sprintf (target_buf, "QTFrame:outside:%s:%s", start_str, stop_str);
2314 finish_tfind_command (&target_buf, &target_buf_size, from_tty);
2317 error (_("Trace can only be run on remote targets."));
2320 /* save-tracepoints command */
2322 tracepoint_save_command (char *args, int from_tty)
2324 struct tracepoint *tp;
2325 struct action_line *line;
2327 char *i1 = " ", *i2 = " ";
2328 char *indent, *actionline, *pathname;
2331 if (args == 0 || *args == 0)
2332 error (_("Argument required (file name in which to save tracepoints)"));
2334 if (tracepoint_chain == 0)
2336 warning (_("save-tracepoints: no tracepoints to save."));
2340 pathname = tilde_expand (args);
2341 if (!(fp = fopen (pathname, "w")))
2342 error (_("Unable to open file '%s' for saving tracepoints (%s)"),
2343 args, safe_strerror (errno));
2346 ALL_TRACEPOINTS (tp)
2348 if (tp->addr_string)
2349 fprintf (fp, "trace %s\n", tp->addr_string);
2352 sprintf_vma (tmp, tp->address);
2353 fprintf (fp, "trace *0x%s\n", tmp);
2357 fprintf (fp, " passcount %d\n", tp->pass_count);
2361 fprintf (fp, " actions\n");
2363 for (line = tp->actions; line; line = line->next)
2365 struct cmd_list_element *cmd;
2367 QUIT; /* allow user to bail out with ^C */
2368 actionline = line->action;
2369 while (isspace ((int) *actionline))
2372 fprintf (fp, "%s%s\n", indent, actionline);
2373 if (*actionline != '#') /* skip for comment lines */
2375 cmd = lookup_cmd (&actionline, cmdlist, "", -1, 1);
2377 error (_("Bad action list item: %s"), actionline);
2378 if (cmd_cfunc_eq (cmd, while_stepping_pseudocommand))
2380 else if (cmd_cfunc_eq (cmd, end_actions_pseudocommand))
2388 printf_filtered ("Tracepoints saved to file '%s'.\n", args);
2392 /* info scope command: list the locals for a scope. */
2394 scope_info (char *args, int from_tty)
2396 struct symtabs_and_lines sals;
2398 struct minimal_symbol *msym;
2399 struct block *block;
2400 char **canonical, *symname, *save_args = args;
2401 struct dict_iterator iter;
2404 if (args == 0 || *args == 0)
2405 error (_("requires an argument (function, line or *addr) to define a scope"));
2407 sals = decode_line_1 (&args, 1, NULL, 0, &canonical, NULL);
2408 if (sals.nelts == 0)
2409 return; /* presumably decode_line_1 has already warned */
2411 /* Resolve line numbers to PC */
2412 resolve_sal_pc (&sals.sals[0]);
2413 block = block_for_pc (sals.sals[0].pc);
2417 QUIT; /* allow user to bail out with ^C */
2418 ALL_BLOCK_SYMBOLS (block, iter, sym)
2420 QUIT; /* allow user to bail out with ^C */
2422 printf_filtered ("Scope for %s:\n", save_args);
2425 symname = DEPRECATED_SYMBOL_NAME (sym);
2426 if (symname == NULL || *symname == '\0')
2427 continue; /* probably botched, certainly useless */
2429 printf_filtered ("Symbol %s is ", symname);
2430 switch (SYMBOL_CLASS (sym))
2433 case LOC_UNDEF: /* messed up symbol? */
2434 printf_filtered ("a bogus symbol, class %d.\n",
2435 SYMBOL_CLASS (sym));
2436 count--; /* don't count this one */
2439 printf_filtered ("a constant with value %ld (0x%lx)",
2440 SYMBOL_VALUE (sym), SYMBOL_VALUE (sym));
2442 case LOC_CONST_BYTES:
2443 printf_filtered ("constant bytes: ");
2444 if (SYMBOL_TYPE (sym))
2445 for (j = 0; j < TYPE_LENGTH (SYMBOL_TYPE (sym)); j++)
2446 fprintf_filtered (gdb_stdout, " %02x",
2447 (unsigned) SYMBOL_VALUE_BYTES (sym)[j]);
2450 printf_filtered ("in static storage at address ");
2451 deprecated_print_address_numeric (SYMBOL_VALUE_ADDRESS (sym),
2455 printf_filtered ("a local variable in register $%s",
2456 gdbarch_register_name
2457 (current_gdbarch, SYMBOL_VALUE (sym)));
2461 printf_filtered ("an argument at stack/frame offset %ld",
2462 SYMBOL_VALUE (sym));
2465 printf_filtered ("a local variable at frame offset %ld",
2466 SYMBOL_VALUE (sym));
2469 printf_filtered ("a reference argument at offset %ld",
2470 SYMBOL_VALUE (sym));
2473 printf_filtered ("an argument in register $%s",
2474 gdbarch_register_name
2475 (current_gdbarch, SYMBOL_VALUE (sym)));
2477 case LOC_REGPARM_ADDR:
2478 printf_filtered ("the address of an argument, in register $%s",
2479 gdbarch_register_name
2480 (current_gdbarch, SYMBOL_VALUE (sym)));
2483 printf_filtered ("a typedef.\n");
2486 printf_filtered ("a label at address ");
2487 deprecated_print_address_numeric (SYMBOL_VALUE_ADDRESS (sym),
2491 printf_filtered ("a function at address ");
2492 deprecated_print_address_numeric (BLOCK_START (SYMBOL_BLOCK_VALUE (sym)),
2496 printf_filtered ("a variable at offset %ld from register $%s",
2498 gdbarch_register_name
2499 (current_gdbarch, SYMBOL_BASEREG (sym)));
2501 case LOC_BASEREG_ARG:
2502 printf_filtered ("an argument at offset %ld from register $%s",
2504 gdbarch_register_name
2505 (current_gdbarch, SYMBOL_BASEREG (sym)));
2507 case LOC_UNRESOLVED:
2508 msym = lookup_minimal_symbol (DEPRECATED_SYMBOL_NAME (sym),
2511 printf_filtered ("Unresolved Static");
2514 printf_filtered ("static storage at address ");
2515 deprecated_print_address_numeric (SYMBOL_VALUE_ADDRESS (msym), 1,
2519 case LOC_OPTIMIZED_OUT:
2520 printf_filtered ("optimized out.\n");
2522 case LOC_HP_THREAD_LOCAL_STATIC:
2523 printf_filtered ("HP thread local static ");
2526 printf_filtered ("extern (local indirect) at address ");
2527 deprecated_print_address_numeric (SYMBOL_VALUE_ADDRESS (sym),
2531 case LOC_COMPUTED_ARG:
2532 SYMBOL_OPS (sym)->describe_location (sym, gdb_stdout);
2535 if (SYMBOL_TYPE (sym))
2536 printf_filtered (", length %d.\n",
2537 TYPE_LENGTH (check_typedef (SYMBOL_TYPE (sym))));
2539 if (BLOCK_FUNCTION (block))
2542 block = BLOCK_SUPERBLOCK (block);
2545 printf_filtered ("Scope for %s contains no locals or arguments.\n",
2549 /* worker function (cleanup) */
2551 replace_comma (void *data)
2559 trace_dump_command (char *args, int from_tty)
2561 struct tracepoint *t;
2562 struct action_line *action;
2563 char *action_exp, *next_comma;
2564 struct cleanup *old_cleanups;
2565 int stepping_actions = 0;
2566 int stepping_frame = 0;
2568 if (!target_is_remote ())
2570 error (_("Trace can only be run on remote targets."));
2574 if (tracepoint_number == -1)
2576 warning (_("No current trace frame."));
2581 if (t->number == tracepoint_number)
2585 error (_("No known tracepoint matches 'current' tracepoint #%d."),
2588 old_cleanups = make_cleanup (null_cleanup, NULL);
2590 printf_filtered ("Data collected at tracepoint %d, trace frame %d:\n",
2591 tracepoint_number, traceframe_number);
2593 /* The current frame is a trap frame if the frame PC is equal
2594 to the tracepoint PC. If not, then the current frame was
2595 collected during single-stepping. */
2597 stepping_frame = (t->address != (read_pc () - gdbarch_decr_pc_after_break
2598 (current_gdbarch)));
2600 for (action = t->actions; action; action = action->next)
2602 struct cmd_list_element *cmd;
2604 QUIT; /* allow user to bail out with ^C */
2605 action_exp = action->action;
2606 while (isspace ((int) *action_exp))
2609 /* The collection actions to be done while stepping are
2610 bracketed by the commands "while-stepping" and "end". */
2612 if (*action_exp == '#') /* comment line */
2615 cmd = lookup_cmd (&action_exp, cmdlist, "", -1, 1);
2617 error (_("Bad action list item: %s"), action_exp);
2619 if (cmd_cfunc_eq (cmd, while_stepping_pseudocommand))
2620 stepping_actions = 1;
2621 else if (cmd_cfunc_eq (cmd, end_actions_pseudocommand))
2622 stepping_actions = 0;
2623 else if (cmd_cfunc_eq (cmd, collect_pseudocommand))
2625 /* Display the collected data.
2626 For the trap frame, display only what was collected at
2627 the trap. Likewise for stepping frames, display only
2628 what was collected while stepping. This means that the
2629 two boolean variables, STEPPING_FRAME and
2630 STEPPING_ACTIONS should be equal. */
2631 if (stepping_frame == stepping_actions)
2634 { /* repeat over a comma-separated list */
2635 QUIT; /* allow user to bail out with ^C */
2636 if (*action_exp == ',')
2638 while (isspace ((int) *action_exp))
2641 next_comma = strchr (action_exp, ',');
2643 if (0 == strncasecmp (action_exp, "$reg", 4))
2644 registers_info (NULL, from_tty);
2645 else if (0 == strncasecmp (action_exp, "$loc", 4))
2646 locals_info (NULL, from_tty);
2647 else if (0 == strncasecmp (action_exp, "$arg", 4))
2648 args_info (NULL, from_tty);
2653 make_cleanup (replace_comma, next_comma);
2656 printf_filtered ("%s = ", action_exp);
2657 output_command (action_exp, from_tty);
2658 printf_filtered ("\n");
2662 action_exp = next_comma;
2664 while (action_exp && *action_exp == ',');
2668 discard_cleanups (old_cleanups);
2671 /* Convert the memory pointed to by mem into hex, placing result in buf.
2672 * Return a pointer to the last char put in buf (null)
2673 * "stolen" from sparc-stub.c
2676 static const char hexchars[] = "0123456789abcdef";
2679 mem2hex (gdb_byte *mem, char *buf, int count)
2687 *buf++ = hexchars[ch >> 4];
2688 *buf++ = hexchars[ch & 0xf];
2697 get_traceframe_number (void)
2699 return traceframe_number;
2703 /* module initialization */
2705 _initialize_tracepoint (void)
2707 struct cmd_list_element *c;
2709 tracepoint_chain = 0;
2710 tracepoint_count = 0;
2711 traceframe_number = -1;
2712 tracepoint_number = -1;
2714 if (tracepoint_list.list == NULL)
2716 tracepoint_list.listsize = 128;
2717 tracepoint_list.list = xmalloc
2718 (tracepoint_list.listsize * sizeof (struct memrange));
2720 if (tracepoint_list.aexpr_list == NULL)
2722 tracepoint_list.aexpr_listsize = 128;
2723 tracepoint_list.aexpr_list = xmalloc
2724 (tracepoint_list.aexpr_listsize * sizeof (struct agent_expr *));
2727 if (stepping_list.list == NULL)
2729 stepping_list.listsize = 128;
2730 stepping_list.list = xmalloc
2731 (stepping_list.listsize * sizeof (struct memrange));
2734 if (stepping_list.aexpr_list == NULL)
2736 stepping_list.aexpr_listsize = 128;
2737 stepping_list.aexpr_list = xmalloc
2738 (stepping_list.aexpr_listsize * sizeof (struct agent_expr *));
2741 add_info ("scope", scope_info,
2742 _("List the variables local to a scope"));
2744 add_cmd ("tracepoints", class_trace, NULL,
2745 _("Tracing of program execution without stopping the program."),
2748 add_info ("tracepoints", tracepoints_info, _("\
2749 Status of tracepoints, or tracepoint number NUMBER.\n\
2750 Convenience variable \"$tpnum\" contains the number of the\n\
2751 last tracepoint set."));
2753 add_info_alias ("tp", "tracepoints", 1);
2755 c = add_com ("save-tracepoints", class_trace, tracepoint_save_command, _("\
2756 Save current tracepoint definitions as a script.\n\
2757 Use the 'source' command in another debug session to restore them."));
2758 set_cmd_completer (c, filename_completer);
2760 add_com ("tdump", class_trace, trace_dump_command,
2761 _("Print everything collected at the current tracepoint."));
2763 add_prefix_cmd ("tfind", class_trace, trace_find_command, _("\
2764 Select a trace frame;\n\
2765 No argument means forward by one frame; '-' means backward by one frame."),
2766 &tfindlist, "tfind ", 1, &cmdlist);
2768 add_cmd ("outside", class_trace, trace_find_outside_command, _("\
2769 Select a trace frame whose PC is outside the given range.\n\
2770 Usage: tfind outside addr1, addr2"),
2773 add_cmd ("range", class_trace, trace_find_range_command, _("\
2774 Select a trace frame whose PC is in the given range.\n\
2775 Usage: tfind range addr1,addr2"),
2778 add_cmd ("line", class_trace, trace_find_line_command, _("\
2779 Select a trace frame by source line.\n\
2780 Argument can be a line number (with optional source file), \n\
2781 a function name, or '*' followed by an address.\n\
2782 Default argument is 'the next source line that was traced'."),
2785 add_cmd ("tracepoint", class_trace, trace_find_tracepoint_command, _("\
2786 Select a trace frame by tracepoint number.\n\
2787 Default is the tracepoint for the current trace frame."),
2790 add_cmd ("pc", class_trace, trace_find_pc_command, _("\
2791 Select a trace frame by PC.\n\
2792 Default is the current PC, or the PC of the current trace frame."),
2795 add_cmd ("end", class_trace, trace_find_end_command, _("\
2796 Synonym for 'none'.\n\
2797 De-select any trace frame and resume 'live' debugging."),
2800 add_cmd ("none", class_trace, trace_find_none_command,
2801 _("De-select any trace frame and resume 'live' debugging."),
2804 add_cmd ("start", class_trace, trace_find_start_command,
2805 _("Select the first trace frame in the trace buffer."),
2808 add_com ("tstatus", class_trace, trace_status_command,
2809 _("Display the status of the current trace data collection."));
2811 add_com ("tstop", class_trace, trace_stop_command,
2812 _("Stop trace data collection."));
2814 add_com ("tstart", class_trace, trace_start_command,
2815 _("Start trace data collection."));
2817 add_com ("passcount", class_trace, trace_pass_command, _("\
2818 Set the passcount for a tracepoint.\n\
2819 The trace will end when the tracepoint has been passed 'count' times.\n\
2820 Usage: passcount COUNT TPNUM, where TPNUM may also be \"all\";\n\
2821 if TPNUM is omitted, passcount refers to the last tracepoint defined."));
2823 add_com ("end", class_trace, end_actions_pseudocommand, _("\
2824 Ends a list of commands or actions.\n\
2825 Several GDB commands allow you to enter a list of commands or actions.\n\
2826 Entering \"end\" on a line by itself is the normal way to terminate\n\
2828 Note: the \"end\" command cannot be used at the gdb prompt."));
2830 add_com ("while-stepping", class_trace, while_stepping_pseudocommand, _("\
2831 Specify single-stepping behavior at a tracepoint.\n\
2832 Argument is number of instructions to trace in single-step mode\n\
2833 following the tracepoint. This command is normally followed by\n\
2834 one or more \"collect\" commands, to specify what to collect\n\
2835 while single-stepping.\n\n\
2836 Note: this command can only be used in a tracepoint \"actions\" list."));
2838 add_com_alias ("ws", "while-stepping", class_alias, 0);
2839 add_com_alias ("stepping", "while-stepping", class_alias, 0);
2841 add_com ("collect", class_trace, collect_pseudocommand, _("\
2842 Specify one or more data items to be collected at a tracepoint.\n\
2843 Accepts a comma-separated list of (one or more) expressions. GDB will\n\
2844 collect all data (variables, registers) referenced by that expression.\n\
2845 Also accepts the following special arguments:\n\
2846 $regs -- all registers.\n\
2847 $args -- all function arguments.\n\
2848 $locals -- all variables local to the block/function scope.\n\
2849 Note: this command can only be used in a tracepoint \"actions\" list."));
2851 add_com ("actions", class_trace, trace_actions_command, _("\
2852 Specify the actions to be taken at a tracepoint.\n\
2853 Tracepoint actions may include collecting of specified data, \n\
2854 single-stepping, or enabling/disabling other tracepoints, \n\
2855 depending on target's capabilities."));
2857 add_cmd ("tracepoints", class_trace, delete_trace_command, _("\
2858 Delete specified tracepoints.\n\
2859 Arguments are tracepoint numbers, separated by spaces.\n\
2860 No argument means delete all tracepoints."),
2863 add_cmd ("tracepoints", class_trace, disable_trace_command, _("\
2864 Disable specified tracepoints.\n\
2865 Arguments are tracepoint numbers, separated by spaces.\n\
2866 No argument means disable all tracepoints."),
2869 add_cmd ("tracepoints", class_trace, enable_trace_command, _("\
2870 Enable specified tracepoints.\n\
2871 Arguments are tracepoint numbers, separated by spaces.\n\
2872 No argument means enable all tracepoints."),
2875 c = add_com ("trace", class_trace, trace_command, _("\
2876 Set a tracepoint at a specified line or function or address.\n\
2877 Argument may be a line number, function name, or '*' plus an address.\n\
2878 For a line number or function, trace at the start of its code.\n\
2879 If an address is specified, trace at that exact address.\n\n\
2880 Do \"help tracepoints\" for info on other tracepoint commands."));
2881 set_cmd_completer (c, location_completer);
2883 add_com_alias ("tp", "trace", class_alias, 0);
2884 add_com_alias ("tr", "trace", class_alias, 1);
2885 add_com_alias ("tra", "trace", class_alias, 1);
2886 add_com_alias ("trac", "trace", class_alias, 1);
2888 target_buf_size = 2048;
2889 target_buf = xmalloc (target_buf_size);