1/* SPU specific support for 32-bit ELF.
2
3   Copyright (C) 2006-2020 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
22struct 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
79struct spu_elf_stack_info;
80
81struct _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
104enum _ovly_flavour
105{
106  ovly_normal,
107  ovly_soft_icache
108};
109
110struct _ovl_stream
111{
112  const void *start;
113  const void *end;
114};
115
116extern void spu_elf_setup (struct bfd_link_info *, struct spu_elf_params *);
117extern void spu_elf_plugin (int);
118extern bfd_boolean spu_elf_open_builtin_lib (bfd **,
119					     const struct _ovl_stream *);
120extern bfd_boolean spu_elf_create_sections (struct bfd_link_info *);
121extern bfd_boolean spu_elf_size_sections (bfd *, struct bfd_link_info *);
122extern int spu_elf_find_overlays (struct bfd_link_info *);
123extern int spu_elf_size_stubs (struct bfd_link_info *);
124extern void spu_elf_place_overlay_data (struct bfd_link_info *);
125extern asection *spu_elf_check_vma (struct bfd_link_info *);
126