ld/emultempl/spuelf.em

   1 # This shell script emits a C file. -*- C -*-
   2 #   Copyright 2006 Free Software Foundation, Inc.
   3 #
   4 # This file is part of GLD, the Gnu Linker.
   5 #
   6 # This program is free software; you can redistribute it and/or modify
   7 # it under the terms of the GNU General Public License as published by
   8 # the Free Software Foundation; either version 2 of the License, or
   9 # (at your option) any later version.
  10 #
  11 # This program is distributed in the hope that it will be useful,
  12 # but WITHOUT ANY WARRANTY; without even the implied warranty of
  13 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14 # GNU General Public License for more details.
  15 #
  16 # You should have received a copy of the GNU General Public License along
  17 # with this program; if not, write to the Free Software Foundation, Inc.,
  18 # 51 Franklin Street - Fifth Floor, Boston, MA 02110-1301, USA.
  19 #
  20
  21 # This file is sourced from elf32.em, and defines extra spu specific
  22 # features.
  23 #
  24 cat >>e${EMULATION_NAME}.c <<EOF
  25 #include "ldctor.h"
  26 #include "elf32-spu.h"
  27
  28 /* Non-zero if no overlay processing should be done.  */
  29 static int no_overlays = 0;
  30
  31 /* Non-zero if we want stubs on all calls out of overlay regions.  */
  32 static int non_overlay_stubs = 0;
  33
  34 /* Whether to emit symbols for stubs.  */
  35 static int emit_stub_syms = 0;
  36
  37 /* Range of valid addresses for loadable sections.  */
  38 static bfd_vma local_store_lo = 0;
  39 static bfd_vma local_store_hi = 0x3ffff;
  40
  41 extern void *_binary_builtin_ovl_mgr_start;
  42 extern void *_binary_builtin_ovl_mgr_end;
  43
  44 static const struct _ovl_stream ovl_mgr_stream = {
  45   &_binary_builtin_ovl_mgr_start,
  46   &_binary_builtin_ovl_mgr_end
  47 };
  48
  49 static asection *toe = NULL;
  50
  51
  52 static int
  53 is_spu_target (void)
  54 {
  55   extern const bfd_target bfd_elf32_spu_vec;
  56
  57   return link_info.hash->creator == &bfd_elf32_spu_vec;
  58 }
  59
  60 /* Create our note section.  */
  61
  62 static void
  63 spu_after_open (void)
  64 {
  65   if (is_spu_target ()
  66       && !link_info.relocatable
  67       && link_info.input_bfds != NULL
  68       && !spu_elf_create_sections (output_bfd, &link_info))
  69     einfo ("%X%P: can not create note section: %E\n");
  70
  71   gld${EMULATION_NAME}_after_open ();
  72 }
  73
  74 /* Add section S at the end of output section OUTPUT_NAME.
  75
  76    Really, we should be duplicating ldlang.c map_input_to_output_sections
  77    logic here, ie. using the linker script to find where the section
  78    goes.  That's rather a lot of code, and we don't want to run
  79    map_input_to_output_sections again because most sections are already
  80    mapped.  So cheat, and put the section in a fixed place, ignoring any
  81    attempt via a linker script to put .stub, .ovtab, and built-in
  82    overlay manager code somewhere else.  */
  83
  84 static void
  85 spu_place_special_section (asection *s, const char *output_name)
  86 {
  87   lang_output_section_statement_type *os;
  88
  89   os = lang_output_section_find (output_name);
  90   if (os == NULL)
  91     {
  92       const char *save = s->name;
  93       s->name = output_name;
  94       gld${EMULATION_NAME}_place_orphan (s);
  95       s->name = save;
  96     }
  97   else
  98     lang_add_section (&os->children, s, os);
  99
 100   s->output_section->size += s->size;
 101 }
 102
 103 /* Load built-in overlay manager, and tweak overlay section alignment.  */
 104
 105 static void
 106 spu_elf_load_ovl_mgr (void)
 107 {
 108   lang_output_section_statement_type *os;
 109   struct elf_link_hash_entry *h;
 110
 111   h = elf_link_hash_lookup (elf_hash_table (&link_info),
 112                             "__ovly_load", FALSE, FALSE, FALSE);
 113
 114   if (h != NULL
 115       && (h->root.type == bfd_link_hash_defined
 116           || h->root.type == bfd_link_hash_defweak)
 117       && h->def_regular)
 118     {
 119       /* User supplied __ovly_load.  */
 120     }
 121   else
 122     {
 123       lang_input_statement_type *ovl_is;
 124
 125       ovl_is = lang_add_input_file ("builtin ovl_mgr",
 126                                     lang_input_file_is_file_enum,
 127                                     NULL);
 128
 129       if (!spu_elf_open_builtin_lib (&ovl_is->the_bfd, &ovl_mgr_stream))
 130         einfo ("%X%P: can not open built-in overlay manager: %E\n");
 131       else
 132         {
 133           asection *in;
 134
 135           if (!load_symbols (ovl_is, NULL))
 136             einfo ("%X%P: can not load built-in overlay manager: %E\n");
 137
 138           /* Map overlay manager sections to output sections.  */
 139           for (in = ovl_is->the_bfd->sections; in != NULL; in = in->next)
 140             if ((in->flags & (SEC_ALLOC | SEC_LOAD))
 141                 == (SEC_ALLOC | SEC_LOAD))
 142               spu_place_special_section (in, ".text");
 143         }
 144     }
 145
 146   /* Ensure alignment of overlay sections is sufficient.  */
 147   for (os = &lang_output_section_statement.head->output_section_statement;
 148        os != NULL;
 149        os = os->next)
 150     if (os->bfd_section != NULL
 151         && spu_elf_section_data (os->bfd_section) != NULL
 152         && spu_elf_section_data (os->bfd_section)->ovl_index != 0)
 153       {
 154         if (os->bfd_section->alignment_power < 4)
 155           os->bfd_section->alignment_power = 4;
 156
 157         /* Also ensure size rounds up.  */
 158         os->block_value = 16;
 159       }
 160 }
 161
 162 /* Go find if we need to do anything special for overlays.  */
 163
 164 static void
 165 spu_before_allocation (void)
 166 {
 167   if (is_spu_target ()
 168       && !link_info.relocatable
 169       && !no_overlays)
 170     {
 171       /* Size the sections.  This is premature, but we need to know the
 172          rough layout so that overlays can be found.  */
 173       expld.phase = lang_mark_phase_enum;
 174       expld.dataseg.phase = exp_dataseg_none;
 175       one_lang_size_sections_pass (NULL, TRUE);
 176
 177       /* Find overlays by inspecting section vmas.  */
 178       if (spu_elf_find_overlays (output_bfd, &link_info))
 179         {
 180           asection *stub, *ovtab;
 181
 182           if (!spu_elf_size_stubs (output_bfd, &link_info, non_overlay_stubs,
 183                                    &stub, &ovtab, &toe))
 184             einfo ("%X%P: can not size overlay stubs: %E\n");
 185
 186           if (stub != NULL)
 187             {
 188               spu_place_special_section (stub, ".text");
 189               spu_place_special_section (ovtab, ".data");
 190               spu_place_special_section (toe, ".toe");
 191
 192               spu_elf_load_ovl_mgr ();
 193             }
 194         }
 195
 196       /* We must not cache anything from the preliminary sizing.  */
 197       lang_reset_memory_regions ();
 198     }
 199
 200   gld${EMULATION_NAME}_before_allocation ();
 201 }
 202
 203 /* Final emulation specific call.  */
 204
 205 static void
 206 gld${EMULATION_NAME}_finish (void)
 207 {
 208   int need_laying_out;
 209
 210   need_laying_out = bfd_elf_discard_info (output_bfd, &link_info);
 211
 212   gld${EMULATION_NAME}_map_segments (need_laying_out);
 213
 214   if (is_spu_target () && local_store_lo < local_store_hi)
 215     {
 216       asection *s;
 217
 218       s = spu_elf_check_vma (output_bfd, local_store_lo, local_store_hi);
 219       if (s != NULL)
 220         einfo ("%X%P: %A exceeds local store range\n", s);
 221     }
 222
 223   if (toe != NULL
 224       && !spu_elf_build_stubs (&link_info,
 225                                emit_stub_syms || link_info.emitrelocations,
 226                                toe))
 227     einfo ("%X%P: can not build overlay stubs: %E\n");
 228
 229   finish_default ();
 230 }
 231
 232 EOF
 233
 234 # Define some shell vars to insert bits of code into the standard elf
 235 # parse_args and list_options functions.
 236 #
 237 PARSE_AND_LIST_PROLOGUE='
 238 #define OPTION_SPU_PLUGIN               301
 239 #define OPTION_SPU_NO_OVERLAYS          (OPTION_SPU_PLUGIN + 1)
 240 #define OPTION_SPU_STUB_SYMS            (OPTION_SPU_NO_OVERLAYS + 1)
 241 #define OPTION_SPU_NON_OVERLAY_STUBS    (OPTION_SPU_STUB_SYMS + 1)
 242 #define OPTION_SPU_LOCAL_STORE          (OPTION_SPU_NON_OVERLAY_STUBS + 1)
 243 '
 244
 245 PARSE_AND_LIST_LONGOPTS='
 246   { "plugin", no_argument, NULL, OPTION_SPU_PLUGIN },
 247   { "no-overlays", no_argument, NULL, OPTION_SPU_NO_OVERLAYS },
 248   { "emit-stub-syms", no_argument, NULL, OPTION_SPU_STUB_SYMS },
 249   { "extra-overlay-stubs", no_argument, NULL, OPTION_SPU_NON_OVERLAY_STUBS },
 250   { "local-store", required_argument, NULL, OPTION_SPU_LOCAL_STORE },
 251 '
 252
 253 PARSE_AND_LIST_OPTIONS='
 254   fprintf (file, _("\
 255   --plugin              Make SPU plugin.\n\
 256   --no-overlays         No overlay handling.\n\
 257   --emit-stub-syms      Add symbols on overlay call stubs.\n\
 258   --extra-overlay-stubs Add stubs on all calls out of overlay regions.\n\
 259   --local-store=lo:hi   Valid address range.\n"
 260                    ));
 261 '
 262
 263 PARSE_AND_LIST_ARGS_CASES='
 264     case OPTION_SPU_PLUGIN:
 265       spu_elf_plugin (1);
 266       break;
 267
 268     case OPTION_SPU_NO_OVERLAYS:
 269       no_overlays = 1;
 270       break;
 271
 272     case OPTION_SPU_STUB_SYMS:
 273       emit_stub_syms = 1;
 274       break;
 275
 276     case OPTION_SPU_NON_OVERLAY_STUBS:
 277       non_overlay_stubs = 1;
 278       break;
 279
 280     case OPTION_SPU_LOCAL_STORE:
 281       {
 282         char *end;
 283         local_store_lo = strtoul (optarg, &end, 0);
 284         if (*end == '\'':'\'')
 285           {
 286             local_store_hi = strtoul (end + 1, &end, 0);
 287             if (*end == 0)
 288               break;
 289           }
 290         einfo (_("%P%F: invalid --local-store address range `%s'\''\n"), optarg);
 291       }
 292       break;
 293 '
 294
 295 LDEMUL_AFTER_OPEN=spu_after_open
 296 LDEMUL_BEFORE_ALLOCATION=spu_before_allocation
 297 LDEMUL_FINISH=gld${EMULATION_NAME}_finish