gdb/remote-sim.c

   1 /* Generic remote debugging interface for simulators.
   2    Copyright 1993, 1994, 1996, 1997, 2000, 2001 Free Software Foundation, Inc.
   3    Contributed by Cygnus Support.
   4    Steve Chamberlain (sac@cygnus.com).
   5
   6    This file is part of GDB.
   7
   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.
  12
  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.
  17
  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., 59 Temple Place - Suite 330,
  21    Boston, MA 02111-1307, USA.  */
  22
  23 #include "defs.h"
  24 #include "inferior.h"
  25 #include "value.h"
  26 #include "gdb_string.h"
  27 #include <ctype.h>
  28 #include <fcntl.h>
  29 #include <signal.h>
  30 #include <setjmp.h>
  31 #include <errno.h>
  32 #include "terminal.h"
  33 #include "target.h"
  34 #include "gdbcore.h"
  35 #include "callback.h"
  36 #include "remote-sim.h"
  37 #include "remote-utils.h"
  38 #include "command.h"
  39
  40 /* Prototypes */
  41
  42 extern void _initialize_remote_sim (void);
  43
  44 extern int (*ui_loop_hook) (int signo);
  45
  46 static void dump_mem (char *buf, int len);
  47
  48 static void init_callbacks (void);
  49
  50 static void end_callbacks (void);
  51
  52 static int gdb_os_write_stdout (host_callback *, const char *, int);
  53
  54 static void gdb_os_flush_stdout (host_callback *);
  55
  56 static int gdb_os_write_stderr (host_callback *, const char *, int);
  57
  58 static void gdb_os_flush_stderr (host_callback *);
  59
  60 static int gdb_os_poll_quit (host_callback *);
  61
  62 /* printf_filtered is depreciated */
  63 static void gdb_os_printf_filtered (host_callback *, const char *, ...);
  64
  65 static void gdb_os_vprintf_filtered (host_callback *, const char *, va_list);
  66
  67 static void gdb_os_evprintf_filtered (host_callback *, const char *, va_list);
  68
  69 static void gdb_os_error (host_callback *, const char *, ...);
  70
  71 static void gdbsim_fetch_register (int regno);
  72
  73 static void gdbsim_store_register (int regno);
  74
  75 static void gdbsim_kill (void);
  76
  77 static void gdbsim_load (char *prog, int fromtty);
  78
  79 static void gdbsim_create_inferior (char *exec_file, char *args, char **env);
  80
  81 static void gdbsim_open (char *args, int from_tty);
  82
  83 static void gdbsim_close (int quitting);
  84
  85 static void gdbsim_detach (char *args, int from_tty);
  86
  87 static void gdbsim_resume (int pid, int step, enum target_signal siggnal);
  88
  89 static int gdbsim_wait (int pid, struct target_waitstatus *status);
  90
  91 static void gdbsim_prepare_to_store (void);
  92
  93 static int gdbsim_xfer_inferior_memory (CORE_ADDR memaddr, char *myaddr,
  94                                         int len, int write,
  95                                         struct mem_attrib *attrib,
  96                                         struct target_ops *target);
  97
  98 static void gdbsim_files_info (struct target_ops *target);
  99
 100 static void gdbsim_mourn_inferior (void);
 101
 102 static void gdbsim_stop (void);
 103
 104 void simulator_command (char *args, int from_tty);
 105
 106 /* Naming convention:
 107
 108    sim_* are the interface to the simulator (see remote-sim.h).
 109    gdbsim_* are stuff which is internal to gdb.  */
 110
 111 /* Forward data declarations */
 112 extern struct target_ops gdbsim_ops;
 113
 114 static int program_loaded = 0;
 115
 116 /* We must keep track of whether the simulator has been opened or not because
 117    GDB can call a target's close routine twice, but sim_close doesn't allow
 118    this.  We also need to record the result of sim_open so we can pass it
 119    back to the other sim_foo routines.  */
 120 static SIM_DESC gdbsim_desc = 0;
 121
 122 static void
 123 dump_mem (char *buf, int len)
 124 {
 125   if (len <= 8)
 126     {
 127       if (len == 8 || len == 4)
 128         {
 129           long l[2];
 130           memcpy (l, buf, len);
 131           printf_filtered ("\t0x%lx", l[0]);
 132           if (len == 8)
 133             printf_filtered (" 0x%lx", l[1]);
 134           printf_filtered ("\n");
 135         }
 136       else
 137         {
 138           int i;
 139           printf_filtered ("\t");
 140           for (i = 0; i < len; i++)
 141             printf_filtered ("0x%x ", buf[i]);
 142           printf_filtered ("\n");
 143         }
 144     }
 145 }
 146
 147 static host_callback gdb_callback;
 148 static int callbacks_initialized = 0;
 149
 150 /* Initialize gdb_callback.  */
 151
 152 static void
 153 init_callbacks (void)
 154 {
 155   if (!callbacks_initialized)
 156     {
 157       gdb_callback = default_callback;
 158       gdb_callback.init (&gdb_callback);
 159       gdb_callback.write_stdout = gdb_os_write_stdout;
 160       gdb_callback.flush_stdout = gdb_os_flush_stdout;
 161       gdb_callback.write_stderr = gdb_os_write_stderr;
 162       gdb_callback.flush_stderr = gdb_os_flush_stderr;
 163       gdb_callback.printf_filtered = gdb_os_printf_filtered;
 164       gdb_callback.vprintf_filtered = gdb_os_vprintf_filtered;
 165       gdb_callback.evprintf_filtered = gdb_os_evprintf_filtered;
 166       gdb_callback.error = gdb_os_error;
 167       gdb_callback.poll_quit = gdb_os_poll_quit;
 168       gdb_callback.magic = HOST_CALLBACK_MAGIC;
 169       callbacks_initialized = 1;
 170     }
 171 }
 172
 173 /* Release callbacks (free resources used by them).  */
 174
 175 static void
 176 end_callbacks (void)
 177 {
 178   if (callbacks_initialized)
 179     {
 180       gdb_callback.shutdown (&gdb_callback);
 181       callbacks_initialized = 0;
 182     }
 183 }
 184
 185 /* GDB version of os_write_stdout callback.  */
 186
 187 static int
 188 gdb_os_write_stdout (host_callback *p, const char *buf, int len)
 189 {
 190   int i;
 191   char b[2];
 192
 193   ui_file_write (gdb_stdtarg, buf, len);
 194   return len;
 195 }
 196
 197 /* GDB version of os_flush_stdout callback.  */
 198
 199 static void
 200 gdb_os_flush_stdout (host_callback *p)
 201 {
 202   gdb_flush (gdb_stdtarg);
 203 }
 204
 205 /* GDB version of os_write_stderr callback.  */
 206
 207 static int
 208 gdb_os_write_stderr (host_callback *p, const char *buf, int len)
 209 {
 210   int i;
 211   char b[2];
 212
 213   for (i = 0; i < len; i++)
 214     {
 215       b[0] = buf[i];
 216       b[1] = 0;
 217       fputs_unfiltered (b, gdb_stdtarg);
 218     }
 219   return len;
 220 }
 221
 222 /* GDB version of os_flush_stderr callback.  */
 223
 224 static void
 225 gdb_os_flush_stderr (host_callback *p)
 226 {
 227   gdb_flush (gdb_stderr);
 228 }
 229
 230 /* GDB version of printf_filtered callback.  */
 231
 232 static void
 233 gdb_os_printf_filtered (host_callback * p, const char *format,...)
 234 {
 235   va_list args;
 236   va_start (args, format);
 237
 238   vfprintf_filtered (gdb_stdout, format, args);
 239
 240   va_end (args);
 241 }
 242
 243 /* GDB version of error vprintf_filtered.  */
 244
 245 static void
 246 gdb_os_vprintf_filtered (host_callback * p, const char *format, va_list ap)
 247 {
 248   vfprintf_filtered (gdb_stdout, format, ap);
 249 }
 250
 251 /* GDB version of error evprintf_filtered.  */
 252
 253 static void
 254 gdb_os_evprintf_filtered (host_callback * p, const char *format, va_list ap)
 255 {
 256   vfprintf_filtered (gdb_stderr, format, ap);
 257 }
 258
 259 /* GDB version of error callback.  */
 260
 261 static void
 262 gdb_os_error (host_callback * p, const char *format,...)
 263 {
 264   if (error_hook)
 265     (*error_hook) ();
 266   else
 267     {
 268       va_list args;
 269       va_start (args, format);
 270       verror (format, args);
 271       va_end (args);
 272     }
 273 }
 274
 275 static void
 276 gdbsim_fetch_register (int regno)
 277 {
 278   static int warn_user = 1;
 279   if (regno == -1)
 280     {
 281       for (regno = 0; regno < NUM_REGS; regno++)
 282         gdbsim_fetch_register (regno);
 283     }
 284   else if (REGISTER_NAME (regno) != NULL
 285            && *REGISTER_NAME (regno) != '\0')
 286     {
 287       char buf[MAX_REGISTER_RAW_SIZE];
 288       int nr_bytes;
 289       if (REGISTER_SIM_REGNO (regno) >= 0)
 290         nr_bytes = sim_fetch_register (gdbsim_desc,
 291                                        REGISTER_SIM_REGNO (regno),
 292                                        buf, REGISTER_RAW_SIZE (regno));
 293       else
 294         nr_bytes = 0;
 295       if (nr_bytes == 0)
 296         /* register not applicable, supply zero's */
 297         memset (buf, 0, MAX_REGISTER_RAW_SIZE);
 298       else if (nr_bytes > 0 && nr_bytes != REGISTER_RAW_SIZE (regno)
 299                && warn_user)
 300         {
 301           fprintf_unfiltered (gdb_stderr,
 302                               "Size of register %s (%d/%d) incorrect (%d instead of %d))",
 303                               REGISTER_NAME (regno),
 304                               regno, REGISTER_SIM_REGNO (regno),
 305                               nr_bytes, REGISTER_RAW_SIZE (regno));
 306           warn_user = 0;
 307         }
 308       supply_register (regno, buf);
 309       if (sr_get_debug ())
 310         {
 311           printf_filtered ("gdbsim_fetch_register: %d", regno);
 312           /* FIXME: We could print something more intelligible.  */
 313           dump_mem (buf, REGISTER_RAW_SIZE (regno));
 314         }
 315     }
 316 }
 317
 318
 319 static void
 320 gdbsim_store_register (int regno)
 321 {
 322   if (regno == -1)
 323     {
 324       for (regno = 0; regno < NUM_REGS; regno++)
 325         gdbsim_store_register (regno);
 326     }
 327   else if (REGISTER_NAME (regno) != NULL
 328            && *REGISTER_NAME (regno) != '\0'
 329            && REGISTER_SIM_REGNO (regno) >= 0)
 330     {
 331       char tmp[MAX_REGISTER_RAW_SIZE];
 332       int nr_bytes;
 333       read_register_gen (regno, tmp);
 334       nr_bytes = sim_store_register (gdbsim_desc,
 335                                      REGISTER_SIM_REGNO (regno),
 336                                      tmp, REGISTER_RAW_SIZE (regno));
 337       if (nr_bytes > 0 && nr_bytes != REGISTER_RAW_SIZE (regno))
 338         internal_error (__FILE__, __LINE__,
 339                         "Register size different to expected");
 340       if (sr_get_debug ())
 341         {
 342           printf_filtered ("gdbsim_store_register: %d", regno);
 343           /* FIXME: We could print something more intelligible.  */
 344           dump_mem (tmp, REGISTER_RAW_SIZE (regno));
 345         }
 346     }
 347 }
 348
 349 /* Kill the running program.  This may involve closing any open files
 350    and releasing other resources acquired by the simulated program.  */
 351
 352 static void
 353 gdbsim_kill (void)
 354 {
 355   if (sr_get_debug ())
 356     printf_filtered ("gdbsim_kill\n");
 357
 358   /* There is no need to `kill' running simulator - the simulator is
 359      not running */
 360   inferior_pid = 0;
 361 }
 362
 363 /* Load an executable file into the target process.  This is expected to
 364    not only bring new code into the target process, but also to update
 365    GDB's symbol tables to match.  */
 366
 367 static void
 368 gdbsim_load (char *prog, int fromtty)
 369 {
 370   if (sr_get_debug ())
 371     printf_filtered ("gdbsim_load: prog \"%s\"\n", prog);
 372
 373   inferior_pid = 0;
 374
 375   /* FIXME: We will print two messages on error.
 376      Need error to either not print anything if passed NULL or need
 377      another routine that doesn't take any arguments.  */
 378   if (sim_load (gdbsim_desc, prog, NULL, fromtty) == SIM_RC_FAIL)
 379     error ("unable to load program");
 380
 381   /* FIXME: If a load command should reset the targets registers then
 382      a call to sim_create_inferior() should go here. */
 383
 384   program_loaded = 1;
 385 }
 386
 387
 388 /* Start an inferior process and set inferior_pid to its pid.
 389    EXEC_FILE is the file to run.
 390    ARGS is a string containing the arguments to the program.
 391    ENV is the environment vector to pass.  Errors reported with error().
 392    On VxWorks and various standalone systems, we ignore exec_file.  */
 393 /* This is called not only when we first attach, but also when the
 394    user types "run" after having attached.  */
 395
 396 static void
 397 gdbsim_create_inferior (char *exec_file, char *args, char **env)
 398 {
 399   int len;
 400   char *arg_buf, **argv;
 401
 402   if (exec_file == 0 || exec_bfd == 0)
 403     warning ("No executable file specified.");
 404   if (!program_loaded)
 405     warning ("No program loaded.");
 406
 407   if (sr_get_debug ())
 408     printf_filtered ("gdbsim_create_inferior: exec_file \"%s\", args \"%s\"\n",
 409                      (exec_file ? exec_file : "(NULL)"),
 410                      args);
 411
 412   gdbsim_kill ();
 413   remove_breakpoints ();
 414   init_wait_for_inferior ();
 415
 416   if (exec_file != NULL)
 417     {
 418       len = strlen (exec_file) + 1 + strlen (args) + 1 + /*slop */ 10;
 419       arg_buf = (char *) alloca (len);
 420       arg_buf[0] = '\0';
 421       strcat (arg_buf, exec_file);
 422       strcat (arg_buf, " ");
 423       strcat (arg_buf, args);
 424       argv = buildargv (arg_buf);
 425       make_cleanup_freeargv (argv);
 426     }
 427   else
 428     argv = NULL;
 429   sim_create_inferior (gdbsim_desc, exec_bfd, argv, env);
 430
 431   inferior_pid = 42;
 432   insert_breakpoints ();        /* Needed to get correct instruction in cache */
 433
 434   clear_proceed_status ();
 435
 436   /* NB: Entry point already set by sim_create_inferior. */
 437   proceed ((CORE_ADDR) -1, TARGET_SIGNAL_DEFAULT, 0);
 438 }
 439
 440 /* The open routine takes the rest of the parameters from the command,
 441    and (if successful) pushes a new target onto the stack.
 442    Targets should supply this routine, if only to provide an error message.  */
 443 /* Called when selecting the simulator. EG: (gdb) target sim name.  */
 444
 445 static void
 446 gdbsim_open (char *args, int from_tty)
 447 {
 448   int len;
 449   char *arg_buf;
 450   char **argv;
 451
 452   if (sr_get_debug ())
 453     printf_filtered ("gdbsim_open: args \"%s\"\n", args ? args : "(null)");
 454
 455   /* Remove current simulator if one exists.  Only do this if the simulator
 456      has been opened because sim_close requires it.
 457      This is important because the call to push_target below will cause
 458      sim_close to be called if the simulator is already open, but push_target
 459      is called after sim_open!  We can't move the call to push_target before
 460      the call to sim_open because sim_open may invoke `error'.  */
 461   if (gdbsim_desc != NULL)
 462     unpush_target (&gdbsim_ops);
 463
 464   len = (7 + 1                  /* gdbsim */
 465          + strlen (" -E little")
 466          + strlen (" --architecture=xxxxxxxxxx")
 467          + (args ? strlen (args) : 0)
 468          + 50) /* slack */ ;
 469   arg_buf = (char *) alloca (len);
 470   strcpy (arg_buf, "gdbsim");   /* 7 */
 471   /* Specify the byte order for the target when it is both selectable
 472      and explicitly specified by the user (not auto detected). */
 473   if (TARGET_BYTE_ORDER_SELECTABLE_P
 474       && !TARGET_BYTE_ORDER_AUTO)
 475     {
 476       switch (TARGET_BYTE_ORDER)
 477         {
 478         case BIG_ENDIAN:
 479           strcat (arg_buf, " -E big");
 480           break;
 481         case LITTLE_ENDIAN:
 482           strcat (arg_buf, " -E little");
 483           break;
 484         default:
 485           internal_error (__FILE__, __LINE__,
 486                           "Value of TARGET_BYTE_ORDER unknown");
 487         }
 488     }
 489   /* Specify the architecture of the target when it has been
 490      explicitly specified */
 491   if (!TARGET_ARCHITECTURE_AUTO)
 492     {
 493       strcat (arg_buf, " --architecture=");
 494       strcat (arg_buf, TARGET_ARCHITECTURE->printable_name);
 495     }
 496   /* finally, any explicit args */
 497   if (args)
 498     {
 499       strcat (arg_buf, " ");    /* 1 */
 500       strcat (arg_buf, args);
 501     }
 502   argv = buildargv (arg_buf);
 503   if (argv == NULL)
 504     error ("Insufficient memory available to allocate simulator arg list.");
 505   make_cleanup_freeargv (argv);
 506
 507   init_callbacks ();
 508   gdbsim_desc = sim_open (SIM_OPEN_DEBUG, &gdb_callback, exec_bfd, argv);
 509
 510   if (gdbsim_desc == 0)
 511     error ("unable to create simulator instance");
 512
 513   push_target (&gdbsim_ops);
 514   target_fetch_registers (-1);
 515   printf_filtered ("Connected to the simulator.\n");
 516 }
 517
 518 /* Does whatever cleanup is required for a target that we are no longer
 519    going to be calling.  Argument says whether we are quitting gdb and
 520    should not get hung in case of errors, or whether we want a clean
 521    termination even if it takes a while.  This routine is automatically
 522    always called just before a routine is popped off the target stack.
 523    Closing file descriptors and freeing memory are typical things it should
 524    do.  */
 525 /* Close out all files and local state before this target loses control. */
 526
 527 static void
 528 gdbsim_close (int quitting)
 529 {
 530   if (sr_get_debug ())
 531     printf_filtered ("gdbsim_close: quitting %d\n", quitting);
 532
 533   program_loaded = 0;
 534
 535   if (gdbsim_desc != NULL)
 536     {
 537       sim_close (gdbsim_desc, quitting);
 538       gdbsim_desc = NULL;
 539     }
 540
 541   end_callbacks ();
 542   generic_mourn_inferior ();
 543 }
 544
 545 /* Takes a program previously attached to and detaches it.
 546    The program may resume execution (some targets do, some don't) and will
 547    no longer stop on signals, etc.  We better not have left any breakpoints
 548    in the program or it'll die when it hits one.  ARGS is arguments
 549    typed by the user (e.g. a signal to send the process).  FROM_TTY
 550    says whether to be verbose or not.  */
 551 /* Terminate the open connection to the remote debugger.
 552    Use this when you want to detach and do something else with your gdb.  */
 553
 554 static void
 555 gdbsim_detach (char *args, int from_tty)
 556 {
 557   if (sr_get_debug ())
 558     printf_filtered ("gdbsim_detach: args \"%s\"\n", args);
 559
 560   pop_target ();                /* calls gdbsim_close to do the real work */
 561   if (from_tty)
 562     printf_filtered ("Ending simulator %s debugging\n", target_shortname);
 563 }
 564
 565 /* Resume execution of the target process.  STEP says whether to single-step
 566    or to run free; SIGGNAL is the signal value (e.g. SIGINT) to be given
 567    to the target, or zero for no signal.  */
 568
 569 static enum target_signal resume_siggnal;
 570 static int resume_step;
 571
 572 static void
 573 gdbsim_resume (int pid, int step, enum target_signal siggnal)
 574 {
 575   if (inferior_pid != 42)
 576     error ("The program is not being run.");
 577
 578   if (sr_get_debug ())
 579     printf_filtered ("gdbsim_resume: step %d, signal %d\n", step, siggnal);
 580
 581   resume_siggnal = siggnal;
 582   resume_step = step;
 583 }
 584
 585 /* Notify the simulator of an asynchronous request to stop.
 586
 587    The simulator shall ensure that the stop request is eventually
 588    delivered to the simulator.  If the call is made while the
 589    simulator is not running then the stop request is processed when
 590    the simulator is next resumed.
 591
 592    For simulators that do not support this operation, just abort */
 593
 594 static void
 595 gdbsim_stop (void)
 596 {
 597   if (!sim_stop (gdbsim_desc))
 598     {
 599       quit ();
 600     }
 601 }
 602
 603 /* GDB version of os_poll_quit callback.
 604    Taken from gdb/util.c - should be in a library */
 605
 606 static int
 607 gdb_os_poll_quit (host_callback *p)
 608 {
 609   if (ui_loop_hook != NULL)
 610     ui_loop_hook (0);
 611
 612   notice_quit ();
 613   if (quit_flag)                /* gdb's idea of quit */
 614     {
 615       quit_flag = 0;            /* we've stolen it */
 616       return 1;
 617     }
 618   else if (immediate_quit)
 619     {
 620       return 1;
 621     }
 622   return 0;
 623 }
 624
 625 /* Wait for inferior process to do something.  Return pid of child,
 626    or -1 in case of error; store status through argument pointer STATUS,
 627    just as `wait' would. */
 628
 629 static void
 630 gdbsim_cntrl_c (int signo)
 631 {
 632   gdbsim_stop ();
 633 }
 634
 635 static int
 636 gdbsim_wait (int pid, struct target_waitstatus *status)
 637 {
 638   static RETSIGTYPE (*prev_sigint) ();
 639   int sigrc = 0;
 640   enum sim_stop reason = sim_running;
 641
 642   if (sr_get_debug ())
 643     printf_filtered ("gdbsim_wait\n");
 644
 645 #if defined (HAVE_SIGACTION) && defined (SA_RESTART)
 646   {
 647     struct sigaction sa, osa;
 648     sa.sa_handler = gdbsim_cntrl_c;
 649     sigemptyset (&sa.sa_mask);
 650     sa.sa_flags = 0;
 651     sigaction (SIGINT, &sa, &osa);
 652     prev_sigint = osa.sa_handler;
 653   }
 654 #else
 655   prev_sigint = signal (SIGINT, gdbsim_cntrl_c);
 656 #endif
 657   sim_resume (gdbsim_desc, resume_step,
 658               target_signal_to_host (resume_siggnal));
 659   signal (SIGINT, prev_sigint);
 660   resume_step = 0;
 661
 662   sim_stop_reason (gdbsim_desc, &reason, &sigrc);
 663
 664   switch (reason)
 665     {
 666     case sim_exited:
 667       status->kind = TARGET_WAITKIND_EXITED;
 668       status->value.integer = sigrc;
 669       break;
 670     case sim_stopped:
 671       switch (sigrc)
 672         {
 673         case SIGABRT:
 674           quit ();
 675           break;
 676         case SIGINT:
 677         case SIGTRAP:
 678         default:
 679           status->kind = TARGET_WAITKIND_STOPPED;
 680           /* The signal in sigrc is a host signal.  That probably
 681              should be fixed.  */
 682           status->value.sig = target_signal_from_host (sigrc);
 683           break;
 684         }
 685       break;
 686     case sim_signalled:
 687       status->kind = TARGET_WAITKIND_SIGNALLED;
 688       /* The signal in sigrc is a host signal.  That probably
 689          should be fixed.  */
 690       status->value.sig = target_signal_from_host (sigrc);
 691       break;
 692     case sim_running:
 693     case sim_polling:
 694       /* FIXME: Is this correct? */
 695       break;
 696     }
 697
 698   return inferior_pid;
 699 }
 700
 701 /* Get ready to modify the registers array.  On machines which store
 702    individual registers, this doesn't need to do anything.  On machines
 703    which store all the registers in one fell swoop, this makes sure
 704    that registers contains all the registers from the program being
 705    debugged.  */
 706
 707 static void
 708 gdbsim_prepare_to_store (void)
 709 {
 710   /* Do nothing, since we can store individual regs */
 711 }
 712
 713 /* Transfer LEN bytes between GDB address MYADDR and target address
 714    MEMADDR.  If WRITE is non-zero, transfer them to the target,
 715    otherwise transfer them from the target.  TARGET is unused.
 716
 717    Returns the number of bytes transferred. */
 718
 719 static int
 720 gdbsim_xfer_inferior_memory (CORE_ADDR memaddr, char *myaddr, int len,
 721                              int write,
 722                              struct mem_attrib *attrib ATTRIBUTE_UNUSED,
 723                              struct target_ops *target ATTRIBUTE_UNUSED)
 724 {
 725   if (!program_loaded)
 726     error ("No program loaded.");
 727
 728   if (sr_get_debug ())
 729     {
 730       /* FIXME: Send to something other than STDOUT? */
 731       printf_filtered ("gdbsim_xfer_inferior_memory: myaddr 0x");
 732       gdb_print_host_address (myaddr, gdb_stdout);
 733       printf_filtered (", memaddr 0x%s, len %d, write %d\n",
 734                        paddr_nz (memaddr), len, write);
 735       if (sr_get_debug () && write)
 736         dump_mem (myaddr, len);
 737     }
 738
 739   if (write)
 740     {
 741       len = sim_write (gdbsim_desc, memaddr, myaddr, len);
 742     }
 743   else
 744     {
 745       len = sim_read (gdbsim_desc, memaddr, myaddr, len);
 746       if (sr_get_debug () && len > 0)
 747         dump_mem (myaddr, len);
 748     }
 749   return len;
 750 }
 751
 752 static void
 753 gdbsim_files_info (struct target_ops *target)
 754 {
 755   char *file = "nothing";
 756
 757   if (exec_bfd)
 758     file = bfd_get_filename (exec_bfd);
 759
 760   if (sr_get_debug ())
 761     printf_filtered ("gdbsim_files_info: file \"%s\"\n", file);
 762
 763   if (exec_bfd)
 764     {
 765       printf_filtered ("\tAttached to %s running program %s\n",
 766                        target_shortname, file);
 767       sim_info (gdbsim_desc, 0);
 768     }
 769 }
 770
 771 /* Clear the simulator's notion of what the break points are.  */
 772
 773 static void
 774 gdbsim_mourn_inferior (void)
 775 {
 776   if (sr_get_debug ())
 777     printf_filtered ("gdbsim_mourn_inferior:\n");
 778
 779   remove_breakpoints ();
 780   generic_mourn_inferior ();
 781 }
 782
 783 static int
 784 gdbsim_insert_breakpoint (CORE_ADDR addr, char *contents_cache)
 785 {
 786 #ifdef SIM_HAS_BREAKPOINTS
 787   SIM_RC retcode;
 788
 789   retcode = sim_set_breakpoint (gdbsim_desc, addr);
 790
 791   switch (retcode)
 792     {
 793     case SIM_RC_OK:
 794       return 0;
 795     case SIM_RC_INSUFFICIENT_RESOURCES:
 796       return ENOMEM;
 797     default:
 798       return EIO;
 799     }
 800 #else
 801   return memory_insert_breakpoint (addr, contents_cache);
 802 #endif
 803 }
 804
 805 static int
 806 gdbsim_remove_breakpoint (CORE_ADDR addr, char *contents_cache)
 807 {
 808 #ifdef SIM_HAS_BREAKPOINTS
 809   SIM_RC retcode;
 810
 811   retcode = sim_clear_breakpoint (gdbsim_desc, addr);
 812
 813   switch (retcode)
 814     {
 815     case SIM_RC_OK:
 816     case SIM_RC_UNKNOWN_BREAKPOINT:
 817       return 0;
 818     case SIM_RC_INSUFFICIENT_RESOURCES:
 819       return ENOMEM;
 820     default:
 821       return EIO;
 822     }
 823 #else
 824   return memory_remove_breakpoint (addr, contents_cache);
 825 #endif
 826 }
 827
 828 /* Pass the command argument through to the simulator verbatim.  The
 829    simulator must do any command interpretation work.  */
 830
 831 void
 832 simulator_command (char *args, int from_tty)
 833 {
 834   if (gdbsim_desc == NULL)
 835     {
 836
 837       /* PREVIOUSLY: The user may give a command before the simulator
 838          is opened. [...] (??? assuming of course one wishes to
 839          continue to allow commands to be sent to unopened simulators,
 840          which isn't entirely unreasonable). */
 841
 842       /* The simulator is a builtin abstraction of a remote target.
 843          Consistent with that model, access to the simulator, via sim
 844          commands, is restricted to the period when the channel to the
 845          simulator is open. */
 846
 847       error ("Not connected to the simulator target");
 848     }
 849
 850   sim_do_command (gdbsim_desc, args);
 851
 852   /* Invalidate the register cache, in case the simulator command does
 853      something funny. */
 854   registers_changed ();
 855 }
 856
 857 /* Define the target subroutine names */
 858
 859 struct target_ops gdbsim_ops;
 860
 861 static void
 862 init_gdbsim_ops (void)
 863 {
 864   gdbsim_ops.to_shortname = "sim";
 865   gdbsim_ops.to_longname = "simulator";
 866   gdbsim_ops.to_doc = "Use the compiled-in simulator.";
 867   gdbsim_ops.to_open = gdbsim_open;
 868   gdbsim_ops.to_close = gdbsim_close;
 869   gdbsim_ops.to_attach = NULL;
 870   gdbsim_ops.to_post_attach = NULL;
 871   gdbsim_ops.to_require_attach = NULL;
 872   gdbsim_ops.to_detach = gdbsim_detach;
 873   gdbsim_ops.to_require_detach = NULL;
 874   gdbsim_ops.to_resume = gdbsim_resume;
 875   gdbsim_ops.to_wait = gdbsim_wait;
 876   gdbsim_ops.to_post_wait = NULL;
 877   gdbsim_ops.to_fetch_registers = gdbsim_fetch_register;
 878   gdbsim_ops.to_store_registers = gdbsim_store_register;
 879   gdbsim_ops.to_prepare_to_store = gdbsim_prepare_to_store;
 880   gdbsim_ops.to_xfer_memory = gdbsim_xfer_inferior_memory;
 881   gdbsim_ops.to_files_info = gdbsim_files_info;
 882   gdbsim_ops.to_insert_breakpoint = gdbsim_insert_breakpoint;
 883   gdbsim_ops.to_remove_breakpoint = gdbsim_remove_breakpoint;
 884   gdbsim_ops.to_terminal_init = NULL;
 885   gdbsim_ops.to_terminal_inferior = NULL;
 886   gdbsim_ops.to_terminal_ours_for_output = NULL;
 887   gdbsim_ops.to_terminal_ours = NULL;
 888   gdbsim_ops.to_terminal_info = NULL;
 889   gdbsim_ops.to_kill = gdbsim_kill;
 890   gdbsim_ops.to_load = gdbsim_load;
 891   gdbsim_ops.to_lookup_symbol = NULL;
 892   gdbsim_ops.to_create_inferior = gdbsim_create_inferior;
 893   gdbsim_ops.to_post_startup_inferior = NULL;
 894   gdbsim_ops.to_acknowledge_created_inferior = NULL;
 895   gdbsim_ops.to_clone_and_follow_inferior = NULL;
 896   gdbsim_ops.to_post_follow_inferior_by_clone = NULL;
 897   gdbsim_ops.to_insert_fork_catchpoint = NULL;
 898   gdbsim_ops.to_remove_fork_catchpoint = NULL;
 899   gdbsim_ops.to_insert_vfork_catchpoint = NULL;
 900   gdbsim_ops.to_remove_vfork_catchpoint = NULL;
 901   gdbsim_ops.to_has_forked = NULL;
 902   gdbsim_ops.to_has_vforked = NULL;
 903   gdbsim_ops.to_can_follow_vfork_prior_to_exec = NULL;
 904   gdbsim_ops.to_post_follow_vfork = NULL;
 905   gdbsim_ops.to_insert_exec_catchpoint = NULL;
 906   gdbsim_ops.to_remove_exec_catchpoint = NULL;
 907   gdbsim_ops.to_has_execd = NULL;
 908   gdbsim_ops.to_reported_exec_events_per_exec_call = NULL;
 909   gdbsim_ops.to_has_exited = NULL;
 910   gdbsim_ops.to_mourn_inferior = gdbsim_mourn_inferior;
 911   gdbsim_ops.to_can_run = 0;
 912   gdbsim_ops.to_notice_signals = 0;
 913   gdbsim_ops.to_thread_alive = 0;
 914   gdbsim_ops.to_stop = gdbsim_stop;
 915   gdbsim_ops.to_pid_to_exec_file = NULL;
 916   gdbsim_ops.to_core_file_to_sym_file = NULL;
 917   gdbsim_ops.to_stratum = process_stratum;
 918   gdbsim_ops.DONT_USE = NULL;
 919   gdbsim_ops.to_has_all_memory = 1;
 920   gdbsim_ops.to_has_memory = 1;
 921   gdbsim_ops.to_has_stack = 1;
 922   gdbsim_ops.to_has_registers = 1;
 923   gdbsim_ops.to_has_execution = 1;
 924   gdbsim_ops.to_sections = NULL;
 925   gdbsim_ops.to_sections_end = NULL;
 926   gdbsim_ops.to_magic = OPS_MAGIC;
 927
 928 #ifdef TARGET_REDEFINE_DEFAULT_OPS
 929   TARGET_REDEFINE_DEFAULT_OPS (&gdbsim_ops);
 930 #endif
 931 }
 932
 933 void
 934 _initialize_remote_sim (void)
 935 {
 936   init_gdbsim_ops ();
 937   add_target (&gdbsim_ops);
 938
 939   add_com ("sim <command>", class_obscure, simulator_command,
 940            "Send a command to the simulator.");
 941 }