Home | History | Annotate | Line # | Download | only in common
      1 /* Generic load for hardware simulator models.
      2    Copyright (C) 1997-2024 Free Software Foundation, Inc.
      3    Contributed by Cygnus Support.
      4 
      5 This file is part of GDB, the GNU debugger.
      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 /* This must come before any other includes.  */
     21 #include "defs.h"
     22 
     23 #include "bfd.h"
     24 
     25 #include "sim-main.h"
     26 #include "sim-utils.h"
     27 #include "sim-assert.h"
     28 
     29 
     30 /* Generic implementation of sim_load that works with simulators
     31    modeling a hardware platform. */
     32 
     33 SIM_RC
     34 sim_load (SIM_DESC sd, const char *prog_name, struct bfd *prog_bfd, int from_tty)
     35 {
     36   bfd *result_bfd;
     37 
     38   SIM_ASSERT (STATE_MAGIC (sd) == SIM_MAGIC_NUMBER);
     39   if (sim_analyze_program (sd, prog_name, prog_bfd) != SIM_RC_OK)
     40     return SIM_RC_FAIL;
     41   SIM_ASSERT (STATE_PROG_BFD (sd) != NULL);
     42 
     43   /* NOTE: For historical reasons, older hardware simulators
     44      incorrectly write the program sections at LMA interpreted as a
     45      virtual address.  This is still accommodated for backward
     46      compatibility reasons. */
     47 
     48   result_bfd = sim_load_file (sd, STATE_MY_NAME (sd),
     49 			      STATE_CALLBACK (sd),
     50 			      prog_name,
     51 			      STATE_PROG_BFD (sd),
     52 			      STATE_OPEN_KIND (sd) == SIM_OPEN_DEBUG,
     53 			      STATE_LOAD_AT_LMA_P (sd),
     54 			      sim_write);
     55   if (result_bfd == NULL)
     56     {
     57       bfd_close (STATE_PROG_BFD (sd));
     58       STATE_PROG_BFD (sd) = NULL;
     59       return SIM_RC_FAIL;
     60     }
     61   return SIM_RC_OK;
     62 }
     63