| /* Motorola 68HC11/68HC12-specific support for 32-bit ELF |
| Copyright (C) 2003-2024 Free Software Foundation, Inc. |
| Contributed by Stephane Carrez (stcarrez@nerim.fr) |
| |
| This file is part of BFD, the Binary File Descriptor library. |
| |
| This program is free software; you can redistribute it and/or modify |
| it under the terms of the GNU General Public License as published by |
| the Free Software Foundation; either version 3 of the License, or |
| (at your option) any later version. |
| |
| This program is distributed in the hope that it will be useful, |
| but WITHOUT ANY WARRANTY; without even the implied warranty of |
| MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| GNU General Public License for more details. |
| |
| You should have received a copy of the GNU General Public License |
| along with this program; if not, write to the Free Software |
| Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston, |
| MA 02110-1301, USA. */ |
| |
| #ifndef _ELF32_M68HC1X_H |
| #define _ELF32_M68HC1X_H |
| |
| #include "elf-bfd.h" |
| #include "bfdlink.h" |
| #include "elf/m68hc11.h" |
| |
| /* Name of symbols exported by HC11/HC12 linker when there is a memory |
| bank window. */ |
| #define BFD_M68HC11_BANK_START_NAME "__bank_start" |
| #define BFD_M68HC11_BANK_SIZE_NAME "__bank_size" |
| #define BFD_M68HC11_BANK_VIRTUAL_NAME "__bank_virtual" |
| |
| /* Set and control ELF flags in ELF header. */ |
| extern bool _bfd_m68hc11_elf_merge_private_bfd_data |
| (bfd *, struct bfd_link_info *); |
| extern bool _bfd_m68hc11_elf_set_private_flags (bfd*,flagword); |
| extern bool _bfd_m68hc11_elf_print_private_bfd_data (bfd*, void*); |
| |
| /* This hash entry is used to record a trampoline that must be generated |
| to call a far function using a normal calling convention ('jsr'). |
| The trampoline is used when a pointer to a far function is used. |
| It takes care of installing the proper memory bank as well as creating |
| the 'call/rtc' calling convention. */ |
| struct elf32_m68hc11_stub_hash_entry |
| { |
| /* Base hash table entry structure. */ |
| struct bfd_hash_entry root; |
| |
| /* The stub section. */ |
| asection *stub_sec; |
| |
| /* Offset within stub_sec of the beginning of this stub. */ |
| bfd_vma stub_offset; |
| |
| /* Given the symbol's value and its section we can determine its final |
| value when building the stubs (so the stub knows where to jump. */ |
| bfd_vma target_value; |
| asection *target_section; |
| }; |
| |
| /* Placeholder for the parameters to compute memory page and physical address. |
| The following formulas are used: |
| |
| sym > bank_virtual => |
| %addr(sym) = (((sym - bank_virtual) & bank_mask) + bank_physical |
| %page(sym) = (((sym - bank_virtual) >> bank_shift) % 256 |
| |
| sym < bank_virtual => |
| %addr(sym) = sym |
| %page(sym) = 0 |
| |
| |
| These parameters are obtained from the symbol table by looking |
| at the following: |
| |
| __bank_start Symbol marking the start of memory bank window |
| (bank_physical) |
| __bank_virtual Logical address of symbols for which the transformation |
| must be computed |
| __bank_page_size Size in bytes of page size (this is *NOT* the memory |
| bank window size and the window size is always |
| less or equal to the page size) |
| |
| For 68HC12, the window is at 0x8000 and the page size is 16K (full window). |
| For 68HC11 this is board specific (implemented by external hardware). */ |
| |
| struct m68hc11_page_info |
| { |
| bfd_vma bank_virtual; |
| bfd_vma bank_physical; |
| bfd_vma bank_physical_end; |
| bfd_vma bank_mask; |
| bfd_vma bank_size; |
| int bank_shift; |
| int bank_param_initialized; |
| bfd_vma trampoline_addr; |
| }; |
| |
| struct m68hc11_elf_link_hash_table |
| { |
| struct elf_link_hash_table root; |
| struct m68hc11_page_info pinfo; |
| |
| /* The stub hash table. */ |
| struct bfd_hash_table* stub_hash_table; |
| |
| /* Linker stub bfd. */ |
| bfd *stub_bfd; |
| |
| asection* stub_section; |
| asection* tramp_section; |
| |
| /* Linker call-backs. */ |
| asection * (*add_stub_section) (const char *, asection *); |
| |
| /* Assorted information used by elf32_hppa_size_stubs. */ |
| unsigned int bfd_count; |
| int top_index; |
| asection **input_list; |
| |
| bool (* size_one_stub) (struct bfd_hash_entry*, void*); |
| bool (* build_one_stub) (struct bfd_hash_entry*, void*); |
| }; |
| |
| /* Get the Sparc64 ELF linker hash table from a link_info structure. */ |
| |
| #define m68hc11_elf_hash_table(p) \ |
| ((is_elf_hash_table ((p)->hash) \ |
| && elf_hash_table_id (elf_hash_table (p)) == M68HC11_ELF_DATA) \ |
| ? (struct m68hc11_elf_link_hash_table *) (p)->hash : NULL) |
| |
| /* Create a 68HC11/68HC12 ELF linker hash table. */ |
| |
| extern struct m68hc11_elf_link_hash_table* m68hc11_elf_hash_table_create |
| (bfd*); |
| |
| extern void m68hc11_elf_get_bank_parameters (struct bfd_link_info*); |
| |
| /* Return 1 if the address is in banked memory. |
| This can be applied to a virtual address and to a physical address. */ |
| extern int m68hc11_addr_is_banked (struct m68hc11_page_info*, bfd_vma); |
| |
| /* Return the physical address seen by the processor, taking |
| into account banked memory. */ |
| extern bfd_vma m68hc11_phys_addr (struct m68hc11_page_info*, bfd_vma); |
| |
| /* Return the page number corresponding to an address in banked memory. */ |
| extern bfd_vma m68hc11_phys_page (struct m68hc11_page_info*, bfd_vma); |
| |
| bfd_reloc_status_type m68hc11_elf_ignore_reloc |
| (bfd *abfd, arelent *reloc_entry, |
| asymbol *symbol, void *data, asection *input_section, |
| bfd *output_bfd, char **error_message); |
| bfd_reloc_status_type m68hc11_elf_special_reloc |
| (bfd *abfd, arelent *reloc_entry, |
| asymbol *symbol, void *data, asection *input_section, |
| bfd *output_bfd, char **error_message); |
| |
| bool elf32_m68hc11_check_relocs |
| (bfd * abfd, struct bfd_link_info * info, |
| asection * sec, const Elf_Internal_Rela * relocs); |
| int elf32_m68hc11_relocate_section |
| (bfd *output_bfd, struct bfd_link_info *info, |
| bfd *input_bfd, asection *input_section, |
| bfd_byte *contents, Elf_Internal_Rela *relocs, |
| Elf_Internal_Sym *local_syms, asection **local_sections); |
| |
| bool elf32_m68hc11_add_symbol_hook |
| (bfd *abfd, struct bfd_link_info *info, |
| Elf_Internal_Sym *sym, const char **namep, |
| flagword *flagsp, asection **secp, |
| bfd_vma *valp); |
| |
| void elf32_m68hc11_merge_symbol_attribute |
| (struct elf_link_hash_entry *, unsigned int, bool, bool); |
| |
| /* Tweak the OSABI field of the elf header. */ |
| |
| extern bool elf32_m68hc11_init_file_header (bfd*, struct bfd_link_info*); |
| |
| int elf32_m68hc11_setup_section_lists (bfd *, struct bfd_link_info *); |
| |
| bool elf32_m68hc11_size_stubs |
| (bfd *, bfd *, struct bfd_link_info *, |
| asection * (*) (const char *, asection *)); |
| |
| bool elf32_m68hc11_build_stubs (bfd* abfd, struct bfd_link_info *); |
| #endif |