bfd/elfxx-mips.h

   1 /* MIPS ELF specific backend routines.
   2    Copyright (C) 2002-2024 Free Software Foundation, Inc.
   3
   4    This file is part of BFD, the Binary File Descriptor library.
   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 3 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
  17    along with this program; if not, write to the Free Software
  18    Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston,
  19    MA 02110-1301, USA.  */
  20
  21 #include "elf/common.h"
  22 #include "elf/internal.h"
  23 #include "elf/mips.h"
  24
  25 enum reloc_check
  26 {
  27   check_std,
  28   check_inplace,
  29   check_shuffle
  30 };
  31
  32 #ifndef MIPS_DEFAULT_R6
  33 #define MIPS_DEFAULT_R6 0
  34 #endif
  35
  36 struct ecoff_debug_info;
  37
  38 extern bool _bfd_mips_elf_mkobject
  39   (bfd *);
  40 extern bool _bfd_mips_elf_free_cached_info
  41   (bfd *);
  42 extern bool _bfd_mips_elf_new_section_hook
  43   (bfd *, asection *);
  44 extern void _bfd_mips_elf_symbol_processing
  45   (bfd *, asymbol *);
  46 extern unsigned int _bfd_mips_elf_eh_frame_address_size
  47   (bfd *, const asection *);
  48 extern bool _bfd_mips_elf_name_local_section_symbols
  49   (bfd *);
  50 extern bool _bfd_mips_elf_section_processing
  51   (bfd *, Elf_Internal_Shdr *);
  52 extern bool _bfd_mips_elf_section_from_shdr
  53   (bfd *, Elf_Internal_Shdr *, const char *, int);
  54 extern bool _bfd_mips_elf_fake_sections
  55   (bfd *, Elf_Internal_Shdr *, asection *);
  56 extern bool _bfd_mips_elf_section_from_bfd_section
  57   (bfd *, asection *, int *);
  58 extern bool _bfd_mips_elf_add_symbol_hook
  59   (bfd *, struct bfd_link_info *, Elf_Internal_Sym *,
  60    const char **, flagword *, asection **, bfd_vma *);
  61 extern int _bfd_mips_elf_link_output_symbol_hook
  62   (struct bfd_link_info *, const char *, Elf_Internal_Sym *,
  63    asection *, struct elf_link_hash_entry *);
  64 extern bool _bfd_mips_elf_create_dynamic_sections
  65   (bfd *, struct bfd_link_info *);
  66 extern bool _bfd_mips_elf_check_relocs
  67   (bfd *, struct bfd_link_info *, asection *, const Elf_Internal_Rela *);
  68 extern bool _bfd_mips_elf_adjust_dynamic_symbol
  69   (struct bfd_link_info *, struct elf_link_hash_entry *);
  70 extern bool _bfd_mips_elf_late_size_sections
  71   (bfd *, struct bfd_link_info *);
  72 extern int _bfd_mips_elf_relocate_section
  73   (bfd *, struct bfd_link_info *, bfd *, asection *, bfd_byte *,
  74    Elf_Internal_Rela *, Elf_Internal_Sym *, asection **);
  75 extern bool _bfd_mips_elf_finish_dynamic_symbol
  76   (bfd *, struct bfd_link_info *, struct elf_link_hash_entry *,
  77    Elf_Internal_Sym *);
  78 extern bool _bfd_mips_vxworks_finish_dynamic_symbol
  79   (bfd *, struct bfd_link_info *, struct elf_link_hash_entry *,
  80    Elf_Internal_Sym *);
  81 extern bool _bfd_mips_elf_finish_dynamic_sections
  82   (bfd *, struct bfd_link_info *);
  83 extern bool _bfd_mips_elf_sort_relocs_p
  84   (asection *);
  85 extern void _bfd_mips_final_write_processing
  86   (bfd *);
  87 extern bool _bfd_mips_elf_final_write_processing
  88   (bfd *);
  89 extern int _bfd_mips_elf_additional_program_headers
  90   (bfd *, struct bfd_link_info *);
  91 extern bool _bfd_mips_elf_modify_segment_map
  92   (bfd *, struct bfd_link_info *);
  93 extern asection * _bfd_mips_elf_gc_mark_hook
  94   (asection *, struct bfd_link_info *, Elf_Internal_Rela *,
  95    struct elf_link_hash_entry *, Elf_Internal_Sym *);
  96 extern void _bfd_mips_elf_copy_indirect_symbol
  97   (struct bfd_link_info *, struct elf_link_hash_entry *,
  98    struct elf_link_hash_entry *);
  99 extern void _bfd_mips_elf_hide_symbol
 100   (struct bfd_link_info *, struct elf_link_hash_entry *, bool);
 101 extern bool _bfd_mips_elf_ignore_discarded_relocs
 102   (asection *);
 103 extern bool _bfd_mips_elf_is_target_special_symbol
 104   (bfd *abfd, asymbol *sym);
 105 extern bool _bfd_mips_elf_find_nearest_line
 106   (bfd *, asymbol **, asection *, bfd_vma,
 107    const char **, const char **, unsigned int *, unsigned int *);
 108 #define _bfd_mips_elf_find_nearest_line_with_alt \
 109   _bfd_nosymbols_find_nearest_line_with_alt
 110 extern bool _bfd_mips_elf_find_inliner_info
 111   (bfd *, const char **, const char **, unsigned int *);
 112 extern bool _bfd_mips_elf_set_section_contents
 113   (bfd *, asection *, const void *, file_ptr, bfd_size_type);
 114 extern bfd_byte *_bfd_elf_mips_get_relocated_section_contents
 115   (bfd *, struct bfd_link_info *, struct bfd_link_order *,
 116    bfd_byte *, bool, asymbol **);
 117 extern bool _bfd_mips_elf_relax_section
 118   (bfd *abfd, asection *sec, struct bfd_link_info *link_info,
 119    bool *again);
 120 extern struct bfd_link_hash_table *_bfd_mips_elf_link_hash_table_create
 121   (bfd *);
 122 extern struct bfd_link_hash_table *_bfd_mips_vxworks_link_hash_table_create
 123   (bfd *);
 124 extern bool _bfd_mips_elf_final_link
 125   (bfd *, struct bfd_link_info *);
 126 extern bool _bfd_mips_elf_merge_private_bfd_data
 127   (bfd *, struct bfd_link_info *);
 128 extern bool _bfd_mips_elf_set_private_flags
 129   (bfd *, flagword);
 130 extern const char * _bfd_mips_fp_abi_string
 131   (int);
 132 extern bool _bfd_mips_elf_print_private_bfd_data
 133   (bfd *, void *);
 134 extern bool _bfd_mips_elf_discard_info
 135   (bfd *, struct elf_reloc_cookie *, struct bfd_link_info *);
 136 extern bool _bfd_mips_elf_write_section
 137   (bfd *, struct bfd_link_info *, asection *, bfd_byte *);
 138
 139 extern bool _bfd_mips_elf_read_ecoff_info
 140   (bfd *, asection *, struct ecoff_debug_info *);
 141 extern void _bfd_mips_elf_reloc_unshuffle
 142   (bfd *, int, bool, bfd_byte *);
 143 extern void _bfd_mips_elf_reloc_shuffle
 144   (bfd *, int, bool, bfd_byte *);
 145 extern bool _bfd_mips_reloc_offset_in_range
 146   (bfd *, asection *, arelent *, enum reloc_check);
 147 extern bfd_reloc_status_type _bfd_mips_elf_gprel16_with_gp
 148   (bfd *, asymbol *, arelent *, asection *, bool, void *, bfd_vma);
 149 extern bfd_reloc_status_type _bfd_mips_elf32_gprel16_reloc
 150   (bfd *, arelent *, asymbol *, void *, asection *, bfd *, char **);
 151 extern bfd_reloc_status_type _bfd_mips_elf_hi16_reloc
 152   (bfd *, arelent *, asymbol *, void *, asection *, bfd *, char **);
 153 extern bfd_reloc_status_type _bfd_mips_elf_got16_reloc
 154   (bfd *, arelent *, asymbol *, void *, asection *, bfd *, char **);
 155 extern bfd_reloc_status_type _bfd_mips_elf_lo16_reloc
 156   (bfd *, arelent *, asymbol *, void *, asection *, bfd *, char **);
 157 extern bfd_reloc_status_type _bfd_mips_elf_generic_reloc
 158   (bfd *, arelent *, asymbol *, void *, asection *, bfd *, char **);
 159 extern unsigned long _bfd_elf_mips_mach
 160   (flagword);
 161 extern bfd_vma _bfd_mips_elf_sign_extend
 162   (bfd_vma, int);
 163 extern void _bfd_mips_elf_merge_symbol_attribute
 164   (struct elf_link_hash_entry *, unsigned int, bool, bool);
 165 extern char *_bfd_mips_elf_get_target_dtag (bfd_vma);
 166 extern bool _bfd_mips_elf_ignore_undef_symbol
 167   (struct elf_link_hash_entry *);
 168 extern void _bfd_mips_elf_use_plts_and_copy_relocs
 169   (struct bfd_link_info *);
 170 extern void _bfd_mips_elf_linker_flags
 171   (struct bfd_link_info *, bool, bool, bool);
 172 extern void _bfd_mips_elf_compact_branches
 173   (struct bfd_link_info *, bool);
 174 extern bool _bfd_mips_elf_init_stubs
 175   (struct bfd_link_info *,
 176    asection *(*) (const char *, asection *, asection *));
 177 extern bfd_vma _bfd_mips_elf_plt_sym_val
 178   (bfd_vma, const asection *, const arelent *rel);
 179 extern long _bfd_mips_elf_get_synthetic_symtab
 180   (bfd *, long, asymbol **, long, asymbol **, asymbol **);
 181 extern bool _bfd_mips_elf_gc_mark_extra_sections
 182   (struct bfd_link_info *, elf_gc_mark_hook_fn);
 183 extern bool _bfd_mips_init_file_header
 184   (bfd *abfd, struct bfd_link_info *link_info);
 185
 186 extern const struct bfd_elf_special_section _bfd_mips_elf_special_sections [];
 187
 188 extern bool _bfd_mips_elf_common_definition (Elf_Internal_Sym *);
 189
 190 extern int _bfd_mips_elf_compact_eh_encoding (struct bfd_link_info *);
 191 extern int _bfd_mips_elf_cant_unwind_opcode (struct bfd_link_info *);
 192
 193 extern void _bfd_mips_elf_record_xhash_symbol
 194   (struct elf_link_hash_entry *h, bfd_vma xlat_loc);
 195
 196 /* MIPS ABI flags data access.  For the disassembler.  */
 197 extern struct elf_internal_abiflags_v0 *bfd_mips_elf_get_abiflags (bfd *);
 198
 199 static inline bool
 200 gprel16_reloc_p (unsigned int r_type)
 201 {
 202   return (r_type == R_MIPS_GPREL16
 203           || r_type == R_MIPS16_GPREL
 204           || r_type == R_MICROMIPS_GPREL16
 205           || r_type == R_MICROMIPS_GPREL7_S2);
 206 }
 207
 208 static inline bool
 209 literal_reloc_p (int r_type)
 210 {
 211   return r_type == R_MIPS_LITERAL || r_type == R_MICROMIPS_LITERAL;
 212 }
 213
 214 #define elf_backend_common_definition   _bfd_mips_elf_common_definition
 215 #define elf_backend_name_local_section_symbols \
 216   _bfd_mips_elf_name_local_section_symbols
 217 #define elf_backend_special_sections _bfd_mips_elf_special_sections
 218 #define elf_backend_eh_frame_address_size _bfd_mips_elf_eh_frame_address_size
 219 #define elf_backend_merge_symbol_attribute  _bfd_mips_elf_merge_symbol_attribute
 220 #define elf_backend_ignore_undef_symbol _bfd_mips_elf_ignore_undef_symbol
 221 #define elf_backend_init_file_header _bfd_mips_init_file_header
 222 #define elf_backend_compact_eh_encoding _bfd_mips_elf_compact_eh_encoding
 223 #define elf_backend_cant_unwind_opcode _bfd_mips_elf_cant_unwind_opcode
 224 #define elf_backend_record_xhash_symbol _bfd_mips_elf_record_xhash_symbol
 225 #define elf_backend_always_renumber_dynsyms true