gdb/record.c

   1 /* Process record and replay target for GDB, the GNU debugger.
   2
   3    Copyright (C) 2008-2020 Free Software Foundation, Inc.
   4
   5    This file is part of GDB.
   6
   7    This program is free software; you can redistribute it and/or modify
   8    it under the terms of the GNU General Public License as published by
   9    the Free Software Foundation; either version 3 of the License, or
  10    (at your option) any later version.
  11
  12    This program is distributed in the hope that it will be useful,
  13    but WITHOUT ANY WARRANTY; without even the implied warranty of
  14    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15    GNU General Public License for more details.
  16
  17    You should have received a copy of the GNU General Public License
  18    along with this program.  If not, see <http://www.gnu.org/licenses/>.  */
  19
  20 #include "defs.h"
  21 #include "gdbcmd.h"
  22 #include "completer.h"
  23 #include "record.h"
  24 #include "observable.h"
  25 #include "inferior.h"
  26 #include "gdbsupport/common-utils.h"
  27 #include "cli/cli-utils.h"
  28 #include "disasm.h"
  29
  30 #include <ctype.h>
  31
  32 /* This is the debug switch for process record.  */
  33 unsigned int record_debug = 0;
  34
  35 /* The number of instructions to print in "record instruction-history".  */
  36 static unsigned int record_insn_history_size = 10;
  37
  38 /* The variable registered as control variable in the "record
  39    instruction-history" command.  Necessary for extra input
  40    validation.  */
  41 static unsigned int record_insn_history_size_setshow_var;
  42
  43 /* The number of functions to print in "record function-call-history".  */
  44 static unsigned int record_call_history_size = 10;
  45
  46 /* The variable registered as control variable in the "record
  47    call-history" command.  Necessary for extra input validation.  */
  48 static unsigned int record_call_history_size_setshow_var;
  49
  50 struct cmd_list_element *record_cmdlist = NULL;
  51 struct cmd_list_element *record_goto_cmdlist = NULL;
  52 struct cmd_list_element *set_record_cmdlist = NULL;
  53 struct cmd_list_element *show_record_cmdlist = NULL;
  54 struct cmd_list_element *info_record_cmdlist = NULL;
  55
  56 #define DEBUG(msg, args...)                                             \
  57   if (record_debug)                                                     \
  58     fprintf_unfiltered (gdb_stdlog, "record: " msg "\n", ##args)
  59
  60 /* See record.h.  */
  61
  62 struct target_ops *
  63 find_record_target (void)
  64 {
  65   return find_target_at (record_stratum);
  66 }
  67
  68 /* Check that recording is active.  Throw an error, if it isn't.  */
  69
  70 static struct target_ops *
  71 require_record_target (void)
  72 {
  73   struct target_ops *t;
  74
  75   t = find_record_target ();
  76   if (t == NULL)
  77     error (_("No record target is currently active.\n"
  78              "Use one of the \"target record-<TAB><TAB>\" commands first."));
  79
  80   return t;
  81 }
  82
  83 /* See record.h.  */
  84
  85 void
  86 record_preopen (void)
  87 {
  88   /* Check if a record target is already running.  */
  89   if (find_record_target () != NULL)
  90     error (_("The process is already being recorded.  Use \"record stop\" to "
  91              "stop recording first."));
  92 }
  93
  94 /* See record.h.  */
  95
  96 void
  97 record_start (const char *method, const char *format, int from_tty)
  98 {
  99   if (method == NULL)
 100     {
 101       if (format == NULL)
 102         execute_command_to_string ("record", from_tty, false);
 103       else
 104         error (_("Invalid format."));
 105     }
 106   else if (strcmp (method, "full") == 0)
 107     {
 108       if (format == NULL)
 109         execute_command_to_string ("record full", from_tty, false);
 110       else
 111         error (_("Invalid format."));
 112     }
 113   else if (strcmp (method, "btrace") == 0)
 114     {
 115       if (format == NULL)
 116         execute_command_to_string ("record btrace", from_tty, false);
 117       else if (strcmp (format, "bts") == 0)
 118         execute_command_to_string ("record btrace bts", from_tty, false);
 119       else if (strcmp (format, "pt") == 0)
 120         execute_command_to_string ("record btrace pt", from_tty, false);
 121       else
 122         error (_("Invalid format."));
 123     }
 124   else
 125     error (_("Invalid method."));
 126 }
 127
 128 /* See record.h.  */
 129
 130 void
 131 record_stop (int from_tty)
 132 {
 133   execute_command_to_string ("record stop", from_tty, false);
 134 }
 135
 136 /* See record.h.  */
 137
 138 int
 139 record_read_memory (struct gdbarch *gdbarch,
 140                     CORE_ADDR memaddr, gdb_byte *myaddr,
 141                     ssize_t len)
 142 {
 143   int ret = target_read_memory (memaddr, myaddr, len);
 144
 145   if (ret != 0)
 146     DEBUG ("error reading memory at addr %s len = %ld.\n",
 147            paddress (gdbarch, memaddr), (long) len);
 148
 149   return ret;
 150 }
 151
 152 /* Stop recording.  */
 153
 154 static void
 155 record_stop (struct target_ops *t)
 156 {
 157   DEBUG ("stop %s", t->shortname ());
 158
 159   t->stop_recording ();
 160 }
 161
 162 /* Unpush the record target.  */
 163
 164 static void
 165 record_unpush (struct target_ops *t)
 166 {
 167   DEBUG ("unpush %s", t->shortname ());
 168
 169   unpush_target (t);
 170 }
 171
 172 /* See record.h.  */
 173
 174 void
 175 record_disconnect (struct target_ops *t, const char *args, int from_tty)
 176 {
 177   gdb_assert (t->stratum () == record_stratum);
 178
 179   DEBUG ("disconnect %s", t->shortname ());
 180
 181   record_stop (t);
 182   record_unpush (t);
 183
 184   target_disconnect (args, from_tty);
 185 }
 186
 187 /* See record.h.  */
 188
 189 void
 190 record_detach (struct target_ops *t, inferior *inf, int from_tty)
 191 {
 192   gdb_assert (t->stratum () == record_stratum);
 193
 194   DEBUG ("detach %s", t->shortname ());
 195
 196   record_stop (t);
 197   record_unpush (t);
 198
 199   target_detach (inf, from_tty);
 200 }
 201
 202 /* See record.h.  */
 203
 204 void
 205 record_mourn_inferior (struct target_ops *t)
 206 {
 207   gdb_assert (t->stratum () == record_stratum);
 208
 209   DEBUG ("mourn inferior %s", t->shortname ());
 210
 211   /* It is safer to not stop recording.  Resources will be freed when
 212      threads are discarded.  */
 213   record_unpush (t);
 214
 215   target_mourn_inferior (inferior_ptid);
 216 }
 217
 218 /* See record.h.  */
 219
 220 void
 221 record_kill (struct target_ops *t)
 222 {
 223   gdb_assert (t->stratum () == record_stratum);
 224
 225   DEBUG ("kill %s", t->shortname ());
 226
 227   /* It is safer to not stop recording.  Resources will be freed when
 228      threads are discarded.  */
 229   record_unpush (t);
 230
 231   target_kill ();
 232 }
 233
 234 /* See record.h.  */
 235
 236 int
 237 record_check_stopped_by_breakpoint (const address_space *aspace,
 238                                     CORE_ADDR pc,
 239                                     enum target_stop_reason *reason)
 240 {
 241   if (breakpoint_inserted_here_p (aspace, pc))
 242     {
 243       if (hardware_breakpoint_inserted_here_p (aspace, pc))
 244         *reason = TARGET_STOPPED_BY_HW_BREAKPOINT;
 245       else
 246         *reason = TARGET_STOPPED_BY_SW_BREAKPOINT;
 247       return 1;
 248     }
 249
 250   *reason = TARGET_STOPPED_BY_NO_REASON;
 251   return 0;
 252 }
 253
 254 /* Implement "show record debug" command.  */
 255
 256 static void
 257 show_record_debug (struct ui_file *file, int from_tty,
 258                    struct cmd_list_element *c, const char *value)
 259 {
 260   fprintf_filtered (file, _("Debugging of process record target is %s.\n"),
 261                     value);
 262 }
 263
 264 /* Alias for "target record".  */
 265
 266 static void
 267 cmd_record_start (const char *args, int from_tty)
 268 {
 269   execute_command ("target record-full", from_tty);
 270 }
 271
 272 /* Truncate the record log from the present point
 273    of replay until the end.  */
 274
 275 static void
 276 cmd_record_delete (const char *args, int from_tty)
 277 {
 278   require_record_target ();
 279
 280   if (!target_record_is_replaying (inferior_ptid))
 281     {
 282       printf_unfiltered (_("Already at end of record list.\n"));
 283       return;
 284     }
 285
 286   if (!target_supports_delete_record ())
 287     {
 288       printf_unfiltered (_("The current record target does not support "
 289                            "this operation.\n"));
 290       return;
 291     }
 292
 293   if (!from_tty || query (_("Delete the log from this point forward "
 294                             "and begin to record the running message "
 295                             "at current PC?")))
 296     target_delete_record ();
 297 }
 298
 299 /* Implement the "stoprecord" or "record stop" command.  */
 300
 301 static void
 302 cmd_record_stop (const char *args, int from_tty)
 303 {
 304   struct target_ops *t;
 305
 306   t = require_record_target ();
 307
 308   record_stop (t);
 309   record_unpush (t);
 310
 311   printf_unfiltered (_("Process record is stopped and all execution "
 312                        "logs are deleted.\n"));
 313
 314   gdb::observers::record_changed.notify (current_inferior (), 0, NULL, NULL);
 315 }
 316
 317 /* The "set record" command.  */
 318
 319 static void
 320 set_record_command (const char *args, int from_tty)
 321 {
 322   printf_unfiltered (_("\"set record\" must be followed "
 323                        "by an appropriate subcommand.\n"));
 324   help_list (set_record_cmdlist, "set record ", all_commands, gdb_stdout);
 325 }
 326
 327 /* The "show record" command.  */
 328
 329 static void
 330 show_record_command (const char *args, int from_tty)
 331 {
 332   cmd_show_list (show_record_cmdlist, from_tty, "");
 333 }
 334
 335 /* The "info record" command.  */
 336
 337 static void
 338 info_record_command (const char *args, int from_tty)
 339 {
 340   struct target_ops *t;
 341
 342   t = find_record_target ();
 343   if (t == NULL)
 344     {
 345       printf_filtered (_("No record target is currently active.\n"));
 346       return;
 347     }
 348
 349   printf_filtered (_("Active record target: %s\n"), t->shortname ());
 350   t->info_record ();
 351 }
 352
 353 /* The "record save" command.  */
 354
 355 static void
 356 cmd_record_save (const char *args, int from_tty)
 357 {
 358   const char *recfilename;
 359   char recfilename_buffer[40];
 360
 361   require_record_target ();
 362
 363   if (args != NULL && *args != 0)
 364     recfilename = args;
 365   else
 366     {
 367       /* Default recfile name is "gdb_record.PID".  */
 368       xsnprintf (recfilename_buffer, sizeof (recfilename_buffer),
 369                 "gdb_record.%d", inferior_ptid.pid ());
 370       recfilename = recfilename_buffer;
 371     }
 372
 373   target_save_record (recfilename);
 374 }
 375
 376 /* See record.h.  */
 377
 378 void
 379 record_goto (const char *arg)
 380 {
 381   ULONGEST insn;
 382
 383   if (arg == NULL || *arg == '\0')
 384     error (_("Command requires an argument (insn number to go to)."));
 385
 386   insn = parse_and_eval_long (arg);
 387
 388   require_record_target ();
 389   target_goto_record (insn);
 390 }
 391
 392 /* "record goto" command.  Argument is an instruction number,
 393    as given by "info record".
 394
 395    Rewinds the recording (forward or backward) to the given instruction.  */
 396
 397 static void
 398 cmd_record_goto (const char *arg, int from_tty)
 399 {
 400   record_goto (arg);
 401 }
 402
 403 /* The "record goto begin" command.  */
 404
 405 static void
 406 cmd_record_goto_begin (const char *arg, int from_tty)
 407 {
 408   if (arg != NULL && *arg != '\0')
 409     error (_("Junk after argument: %s."), arg);
 410
 411   require_record_target ();
 412   target_goto_record_begin ();
 413 }
 414
 415 /* The "record goto end" command.  */
 416
 417 static void
 418 cmd_record_goto_end (const char *arg, int from_tty)
 419 {
 420   if (arg != NULL && *arg != '\0')
 421     error (_("Junk after argument: %s."), arg);
 422
 423   require_record_target ();
 424   target_goto_record_end ();
 425 }
 426
 427 /* Read an instruction number from an argument string.  */
 428
 429 static ULONGEST
 430 get_insn_number (const char **arg)
 431 {
 432   ULONGEST number;
 433   const char *begin, *end, *pos;
 434
 435   begin = *arg;
 436   pos = skip_spaces (begin);
 437
 438   if (!isdigit (*pos))
 439     error (_("Expected positive number, got: %s."), pos);
 440
 441   number = strtoulst (pos, &end, 10);
 442
 443   *arg += (end - begin);
 444
 445   return number;
 446 }
 447
 448 /* Read a context size from an argument string.  */
 449
 450 static int
 451 get_context_size (const char **arg)
 452 {
 453   const char *pos;
 454   char *end;
 455
 456   pos = skip_spaces (*arg);
 457
 458   if (!isdigit (*pos))
 459     error (_("Expected positive number, got: %s."), pos);
 460
 461   long result = strtol (pos, &end, 10);
 462   *arg = end;
 463   return result;
 464 }
 465
 466 /* Complain about junk at the end of an argument string.  */
 467
 468 static void
 469 no_chunk (const char *arg)
 470 {
 471   if (*arg != 0)
 472     error (_("Junk after argument: %s."), arg);
 473 }
 474
 475 /* Read instruction-history modifiers from an argument string.  */
 476
 477 static gdb_disassembly_flags
 478 get_insn_history_modifiers (const char **arg)
 479 {
 480   gdb_disassembly_flags modifiers;
 481   const char *args;
 482
 483   modifiers = 0;
 484   args = *arg;
 485
 486   if (args == NULL)
 487     return modifiers;
 488
 489   while (*args == '/')
 490     {
 491       ++args;
 492
 493       if (*args == '\0')
 494         error (_("Missing modifier."));
 495
 496       for (; *args; ++args)
 497         {
 498           if (isspace (*args))
 499             break;
 500
 501           if (*args == '/')
 502             continue;
 503
 504           switch (*args)
 505             {
 506             case 'm':
 507             case 's':
 508               modifiers |= DISASSEMBLY_SOURCE;
 509               modifiers |= DISASSEMBLY_FILENAME;
 510               break;
 511             case 'r':
 512               modifiers |= DISASSEMBLY_RAW_INSN;
 513               break;
 514             case 'f':
 515               modifiers |= DISASSEMBLY_OMIT_FNAME;
 516               break;
 517             case 'p':
 518               modifiers |= DISASSEMBLY_OMIT_PC;
 519               break;
 520             default:
 521               error (_("Invalid modifier: %c."), *args);
 522             }
 523         }
 524
 525       args = skip_spaces (args);
 526     }
 527
 528   /* Update the argument string.  */
 529   *arg = args;
 530
 531   return modifiers;
 532 }
 533
 534 /* The "set record instruction-history-size / set record
 535    function-call-history-size" commands are unsigned, with UINT_MAX
 536    meaning unlimited.  The target interfaces works with signed int
 537    though, to indicate direction, so map "unlimited" to INT_MAX, which
 538    is about the same as unlimited in practice.  If the user does have
 539    a log that huge, she can fetch it in chunks across several requests,
 540    but she'll likely have other problems first...  */
 541
 542 static int
 543 command_size_to_target_size (unsigned int size)
 544 {
 545   gdb_assert (size <= INT_MAX || size == UINT_MAX);
 546
 547   if (size == UINT_MAX)
 548     return INT_MAX;
 549   else
 550     return size;
 551 }
 552
 553 /* The "record instruction-history" command.  */
 554
 555 static void
 556 cmd_record_insn_history (const char *arg, int from_tty)
 557 {
 558   require_record_target ();
 559
 560   gdb_disassembly_flags flags = get_insn_history_modifiers (&arg);
 561
 562   int size = command_size_to_target_size (record_insn_history_size);
 563
 564   if (arg == NULL || *arg == 0 || strcmp (arg, "+") == 0)
 565     target_insn_history (size, flags);
 566   else if (strcmp (arg, "-") == 0)
 567     target_insn_history (-size, flags);
 568   else
 569     {
 570       ULONGEST begin, end;
 571
 572       begin = get_insn_number (&arg);
 573
 574       if (*arg == ',')
 575         {
 576           arg = skip_spaces (++arg);
 577
 578           if (*arg == '+')
 579             {
 580               arg += 1;
 581               size = get_context_size (&arg);
 582
 583               no_chunk (arg);
 584
 585               target_insn_history_from (begin, size, flags);
 586             }
 587           else if (*arg == '-')
 588             {
 589               arg += 1;
 590               size = get_context_size (&arg);
 591
 592               no_chunk (arg);
 593
 594               target_insn_history_from (begin, -size, flags);
 595             }
 596           else
 597             {
 598               end = get_insn_number (&arg);
 599
 600               no_chunk (arg);
 601
 602               target_insn_history_range (begin, end, flags);
 603             }
 604         }
 605       else
 606         {
 607           no_chunk (arg);
 608
 609           target_insn_history_from (begin, size, flags);
 610         }
 611
 612       dont_repeat ();
 613     }
 614 }
 615
 616 /* Read function-call-history modifiers from an argument string.  */
 617
 618 static record_print_flags
 619 get_call_history_modifiers (const char **arg)
 620 {
 621   record_print_flags modifiers = 0;
 622   const char *args = *arg;
 623
 624   if (args == NULL)
 625     return modifiers;
 626
 627   while (*args == '/')
 628     {
 629       ++args;
 630
 631       if (*args == '\0')
 632         error (_("Missing modifier."));
 633
 634       for (; *args; ++args)
 635         {
 636           if (isspace (*args))
 637             break;
 638
 639           if (*args == '/')
 640             continue;
 641
 642           switch (*args)
 643             {
 644             case 'l':
 645               modifiers |= RECORD_PRINT_SRC_LINE;
 646               break;
 647             case 'i':
 648               modifiers |= RECORD_PRINT_INSN_RANGE;
 649               break;
 650             case 'c':
 651               modifiers |= RECORD_PRINT_INDENT_CALLS;
 652               break;
 653             default:
 654               error (_("Invalid modifier: %c."), *args);
 655             }
 656         }
 657
 658       args = skip_spaces (args);
 659     }
 660
 661   /* Update the argument string.  */
 662   *arg = args;
 663
 664   return modifiers;
 665 }
 666
 667 /* The "record function-call-history" command.  */
 668
 669 static void
 670 cmd_record_call_history (const char *arg, int from_tty)
 671 {
 672   require_record_target ();
 673
 674   record_print_flags flags = get_call_history_modifiers (&arg);
 675
 676   int size = command_size_to_target_size (record_call_history_size);
 677
 678   if (arg == NULL || *arg == 0 || strcmp (arg, "+") == 0)
 679     target_call_history (size, flags);
 680   else if (strcmp (arg, "-") == 0)
 681     target_call_history (-size, flags);
 682   else
 683     {
 684       ULONGEST begin, end;
 685
 686       begin = get_insn_number (&arg);
 687
 688       if (*arg == ',')
 689         {
 690           arg = skip_spaces (++arg);
 691
 692           if (*arg == '+')
 693             {
 694               arg += 1;
 695               size = get_context_size (&arg);
 696
 697               no_chunk (arg);
 698
 699               target_call_history_from (begin, size, flags);
 700             }
 701           else if (*arg == '-')
 702             {
 703               arg += 1;
 704               size = get_context_size (&arg);
 705
 706               no_chunk (arg);
 707
 708               target_call_history_from (begin, -size, flags);
 709             }
 710           else
 711             {
 712               end = get_insn_number (&arg);
 713
 714               no_chunk (arg);
 715
 716               target_call_history_range (begin, end, flags);
 717             }
 718         }
 719       else
 720         {
 721           no_chunk (arg);
 722
 723           target_call_history_from (begin, size, flags);
 724         }
 725
 726       dont_repeat ();
 727     }
 728 }
 729
 730 /* Helper for "set record instruction-history-size" and "set record
 731    function-call-history-size" input validation.  COMMAND_VAR is the
 732    variable registered in the command as control variable.  *SETTING
 733    is the real setting the command allows changing.  */
 734
 735 static void
 736 validate_history_size (unsigned int *command_var, unsigned int *setting)
 737 {
 738   if (*command_var != UINT_MAX && *command_var > INT_MAX)
 739     {
 740       unsigned int new_value = *command_var;
 741
 742       /* Restore previous value.  */
 743       *command_var = *setting;
 744       error (_("integer %u out of range"), new_value);
 745     }
 746
 747   /* Commit new value.  */
 748   *setting = *command_var;
 749 }
 750
 751 /* Called by do_setshow_command.  We only want values in the
 752    [0..INT_MAX] range, while the command's machinery accepts
 753    [0..UINT_MAX].  See command_size_to_target_size.  */
 754
 755 static void
 756 set_record_insn_history_size (const char *args, int from_tty,
 757                               struct cmd_list_element *c)
 758 {
 759   validate_history_size (&record_insn_history_size_setshow_var,
 760                          &record_insn_history_size);
 761 }
 762
 763 /* Called by do_setshow_command.  We only want values in the
 764    [0..INT_MAX] range, while the command's machinery accepts
 765    [0..UINT_MAX].  See command_size_to_target_size.  */
 766
 767 static void
 768 set_record_call_history_size (const char *args, int from_tty,
 769                               struct cmd_list_element *c)
 770 {
 771   validate_history_size (&record_call_history_size_setshow_var,
 772                          &record_call_history_size);
 773 }
 774
 775 void _initialize_record ();
 776 void
 777 _initialize_record ()
 778 {
 779   struct cmd_list_element *c;
 780
 781   add_setshow_zuinteger_cmd ("record", no_class, &record_debug,
 782                              _("Set debugging of record/replay feature."),
 783                              _("Show debugging of record/replay feature."),
 784                              _("When enabled, debugging output for "
 785                                "record/replay feature is displayed."),
 786                              NULL, show_record_debug, &setdebuglist,
 787                              &showdebuglist);
 788
 789   add_setshow_uinteger_cmd ("instruction-history-size", no_class,
 790                             &record_insn_history_size_setshow_var, _("\
 791 Set number of instructions to print in \"record instruction-history\"."), _("\
 792 Show number of instructions to print in \"record instruction-history\"."), _("\
 793 A size of \"unlimited\" means unlimited instructions.  The default is 10."),
 794                             set_record_insn_history_size, NULL,
 795                             &set_record_cmdlist, &show_record_cmdlist);
 796
 797   add_setshow_uinteger_cmd ("function-call-history-size", no_class,
 798                             &record_call_history_size_setshow_var, _("\
 799 Set number of function to print in \"record function-call-history\"."), _("\
 800 Show number of functions to print in \"record function-call-history\"."), _("\
 801 A size of \"unlimited\" means unlimited lines.  The default is 10."),
 802                             set_record_call_history_size, NULL,
 803                             &set_record_cmdlist, &show_record_cmdlist);
 804
 805   c = add_prefix_cmd ("record", class_obscure, cmd_record_start,
 806                       _("Start recording."),
 807                       &record_cmdlist, "record ", 0, &cmdlist);
 808   set_cmd_completer (c, filename_completer);
 809
 810   add_com_alias ("rec", "record", class_obscure, 1);
 811   add_prefix_cmd ("record", class_support, set_record_command,
 812                   _("Set record options."), &set_record_cmdlist,
 813                   "set record ", 0, &setlist);
 814   add_alias_cmd ("rec", "record", class_obscure, 1, &setlist);
 815   add_prefix_cmd ("record", class_support, show_record_command,
 816                   _("Show record options."), &show_record_cmdlist,
 817                   "show record ", 0, &showlist);
 818   add_alias_cmd ("rec", "record", class_obscure, 1, &showlist);
 819   add_prefix_cmd ("record", class_support, info_record_command,
 820                   _("Info record options."), &info_record_cmdlist,
 821                   "info record ", 0, &infolist);
 822   add_alias_cmd ("rec", "record", class_obscure, 1, &infolist);
 823
 824   c = add_cmd ("save", class_obscure, cmd_record_save,
 825                _("Save the execution log to a file.\n\
 826 Usage: record save [FILENAME]\n\
 827 Default filename is 'gdb_record.PROCESS_ID'."),
 828                &record_cmdlist);
 829   set_cmd_completer (c, filename_completer);
 830
 831   add_cmd ("delete", class_obscure, cmd_record_delete,
 832            _("Delete the rest of execution log and start recording it anew."),
 833            &record_cmdlist);
 834   add_alias_cmd ("d", "delete", class_obscure, 1, &record_cmdlist);
 835   add_alias_cmd ("del", "delete", class_obscure, 1, &record_cmdlist);
 836
 837   add_cmd ("stop", class_obscure, cmd_record_stop,
 838            _("Stop the record/replay target."),
 839            &record_cmdlist);
 840   add_alias_cmd ("s", "stop", class_obscure, 1, &record_cmdlist);
 841
 842   add_prefix_cmd ("goto", class_obscure, cmd_record_goto, _("\
 843 Restore the program to its state at instruction number N.\n\
 844 Argument is instruction number, as shown by 'info record'."),
 845                   &record_goto_cmdlist, "record goto ", 1, &record_cmdlist);
 846
 847   add_cmd ("begin", class_obscure, cmd_record_goto_begin,
 848            _("Go to the beginning of the execution log."),
 849            &record_goto_cmdlist);
 850   add_alias_cmd ("start", "begin", class_obscure, 1, &record_goto_cmdlist);
 851
 852   add_cmd ("end", class_obscure, cmd_record_goto_end,
 853            _("Go to the end of the execution log."),
 854            &record_goto_cmdlist);
 855
 856   add_cmd ("instruction-history", class_obscure, cmd_record_insn_history, _("\
 857 Print disassembled instructions stored in the execution log.\n\
 858 With a /m or /s modifier, source lines are included (if available).\n\
 859 With a /r modifier, raw instructions in hex are included.\n\
 860 With a /f modifier, function names are omitted.\n\
 861 With a /p modifier, current position markers are omitted.\n\
 862 With no argument, disassembles ten more instructions after the previous \
 863 disassembly.\n\
 864 \"record instruction-history -\" disassembles ten instructions before a \
 865 previous disassembly.\n\
 866 One argument specifies an instruction number as shown by 'info record', and \
 867 ten instructions are disassembled after that instruction.\n\
 868 Two arguments with comma between them specify starting and ending instruction \
 869 numbers to disassemble.\n\
 870 If the second argument is preceded by '+' or '-', it specifies the distance \
 871 from the first argument.\n\
 872 The number of instructions to disassemble can be defined with \"set record \
 873 instruction-history-size\"."),
 874            &record_cmdlist);
 875
 876   add_cmd ("function-call-history", class_obscure, cmd_record_call_history, _("\
 877 Prints the execution history at function granularity.\n\
 878 It prints one line for each sequence of instructions that belong to the same \
 879 function.\n\
 880 Without modifiers, it prints the function name.\n\
 881 With a /l modifier, the source file and line number range is included.\n\
 882 With a /i modifier, the instruction number range is included.\n\
 883 With a /c modifier, the output is indented based on the call stack depth.\n\
 884 With no argument, prints ten more lines after the previous ten-line print.\n\
 885 \"record function-call-history -\" prints ten lines before a previous ten-line \
 886 print.\n\
 887 One argument specifies a function number as shown by 'info record', and \
 888 ten lines are printed after that function.\n\
 889 Two arguments with comma between them specify a range of functions to print.\n\
 890 If the second argument is preceded by '+' or '-', it specifies the distance \
 891 from the first argument.\n\
 892 The number of functions to print can be defined with \"set record \
 893 function-call-history-size\"."),
 894            &record_cmdlist);
 895
 896   /* Sync command control variables.  */
 897   record_insn_history_size_setshow_var = record_insn_history_size;
 898   record_call_history_size_setshow_var = record_call_history_size;
 899 }