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
sim_load(SIM_DESC sd,const char * prog_name,struct bfd * prog_bfd,int from_tty)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