1  /* SPU specific support for 32-bit ELF.
       2  
       3     Copyright (C) 2006-2023 Free Software Foundation, Inc.
       4  
       5     This file is part of BFD, the Binary File Descriptor library.
       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, write to the Free Software
      19     Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston,
      20     MA 02110-1301, USA.  */
      21  
      22  struct spu_elf_params
      23  {
      24    /* Stash various callbacks for --auto-overlay.  */
      25    void (*place_spu_section) (asection *, asection *, const char *);
      26    bfd_size_type (*spu_elf_load_ovl_mgr) (void);
      27    FILE *(*spu_elf_open_overlay_script) (void);
      28    void (*spu_elf_relink) (void);
      29  
      30    /* Bit 0 set if --auto-overlay.
      31       Bit 1 set if --auto-relink.
      32       Bit 2 set if --overlay-rodata.  */
      33    unsigned int auto_overlay : 3;
      34  #define AUTO_OVERLAY 1
      35  #define AUTO_RELINK 2
      36  #define OVERLAY_RODATA 4
      37  
      38    /* Type of overlays, enum _ovly_flavour.  */
      39    unsigned int ovly_flavour : 1;
      40    unsigned int compact_stub : 1;
      41  
      42    /* Set if we should emit symbols for stubs.  */
      43    unsigned int emit_stub_syms : 1;
      44  
      45    /* Set if we want stubs on calls out of overlay regions to
      46       non-overlay regions.  */
      47    unsigned int non_overlay_stubs : 1;
      48  
      49    /* Set if lr liveness analysis should be done.  */
      50    unsigned int lrlive_analysis : 1;
      51  
      52    /* Set if stack size analysis should be done.  */
      53    unsigned int stack_analysis : 1;
      54  
      55    /* Set if __stack_* syms will be emitted.  */
      56    unsigned int emit_stack_syms : 1;
      57  
      58    /* Set if non-icache code should be allowed in icache lines.  */
      59    unsigned int non_ia_text : 1;
      60  
      61    /* Set when the .fixup section should be generated. */
      62    unsigned int emit_fixups : 1;
      63  
      64    /* Range of valid addresses for loadable sections.  */
      65    bfd_vma local_store_lo;
      66    bfd_vma local_store_hi;
      67  
      68    /* Control --auto-overlay feature.  */
      69    unsigned int num_lines;
      70    unsigned int line_size;
      71    unsigned int max_branch;
      72    unsigned int auto_overlay_fixed;
      73    unsigned int auto_overlay_reserved;
      74    int extra_stack_space;
      75  };
      76  
      77  /* Extra info kept for SPU sections.  */
      78  
      79  struct spu_elf_stack_info;
      80  
      81  struct _spu_elf_section_data
      82  {
      83    struct bfd_elf_section_data elf;
      84  
      85    union {
      86      /* Info kept for input sections.  */
      87      struct {
      88        /* Stack analysis info kept for this section.  */
      89        struct spu_elf_stack_info *stack_info;
      90      } i;
      91  
      92      /* Info kept for output sections.  */
      93      struct {
      94        /* Non-zero for overlay output sections.  */
      95        unsigned int ovl_index;
      96        unsigned int ovl_buf;
      97      } o;
      98    } u;
      99  };
     100  
     101  #define spu_elf_section_data(sec) \
     102    ((struct _spu_elf_section_data *) elf_section_data (sec))
     103  
     104  enum _ovly_flavour
     105  {
     106    ovly_normal,
     107    ovly_soft_icache
     108  };
     109  
     110  struct _ovl_stream
     111  {
     112    const void *start;
     113    const void *end;
     114  };
     115  
     116  extern void spu_elf_setup (struct bfd_link_info *, struct spu_elf_params *);
     117  extern void spu_elf_plugin (int);
     118  extern bool spu_elf_open_builtin_lib (bfd **, const struct _ovl_stream *);
     119  extern bool spu_elf_create_sections (struct bfd_link_info *);
     120  extern bool spu_elf_size_sections (bfd *, struct bfd_link_info *);
     121  extern int spu_elf_find_overlays (struct bfd_link_info *);
     122  extern int spu_elf_size_stubs (struct bfd_link_info *);
     123  extern void spu_elf_place_overlay_data (struct bfd_link_info *);
     124  extern asection *spu_elf_check_vma (struct bfd_link_info *);