1 /* HP PA-RISC SOM object file format: definitions internal to BFD. 2 Copyright (C) 1990-2021 Free Software Foundation, Inc. 3 4 Contributed by the Center for Software Science at the 5 University of Utah (pa-gdb-bugs@cs.utah.edu). 6 7 This file is part of BFD, the Binary File Descriptor library. 8 9 This program is free software; you can redistribute it and/or modify 10 it under the terms of the GNU General Public License as published by 11 the Free Software Foundation; either version 3 of the License, or 12 (at your option) any later version. 13 14 This program is distributed in the hope that it will be useful, 15 but WITHOUT ANY WARRANTY; without even the implied warranty of 16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 17 GNU General Public License for more details. 18 19 You should have received a copy of the GNU General Public License 20 along with this program; if not, write to the Free Software 21 Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston, MA 22 02110-1301, USA. */ 23 24 #ifndef _SOM_H 25 #define _SOM_H 26 27 #include "libhppa.h" 28 29 /* We want reloc.h to provide PA 2.0 defines. */ 30 #define PA_2_0 31 32 #include "som/aout.h" 33 #include "som/lst.h" 34 #include "som/internal.h" 35 36 /* The SOM BFD backend doesn't currently use anything from these 37 two include files, but it's likely to need them in the future. */ 38 #ifdef R_DLT_REL 39 #include <shl.h> 40 #include <dl.h> 41 #endif 42 43 #ifdef __cplusplus 44 extern "C" { 45 #endif 46 47 #if defined (HOST_HPPABSD) || defined (HOST_HPPAOSF) 48 /* BSD uses a completely different scheme for object file identification. 49 so for now, define _PA_RISC_ID to accept any random value for a model 50 number. */ 51 #undef _PA_RISC_ID 52 #define _PA_RISC_ID(__m_num) 1 53 #endif /* HOST_HPPABSD */ 54 55 typedef struct som_symbol 56 { 57 asymbol symbol; 58 unsigned int som_type; 59 60 /* Structured like the ELF tc_data union. Allows more code sharing 61 in GAS this way. */ 62 union 63 { 64 struct 65 { 66 unsigned int hppa_arg_reloc; 67 unsigned int hppa_priv_level; 68 } ap; 69 void * any; 70 } 71 tc_data; 72 73 /* Index of this symbol in the symbol table. Only used when 74 building relocation streams for incomplete objects. */ 75 int index; 76 77 /* How many times this symbol is used in a relocation. By sorting 78 the symbols from most used to least used we can significantly 79 reduce the size of the relocation stream for incomplete objects. */ 80 int reloc_count; 81 82 /* During object file writing, the offset of the name of this symbol 83 in the SOM string table. */ 84 int stringtab_offset; 85 } 86 som_symbol_type; 87 88 /* A structure containing all the magic information stored in a BFD's 89 private data which needs to be copied during an objcopy/strip run. */ 90 struct som_exec_data 91 { 92 /* Sort-of a magic number. BSD uses it to distinguish between 93 native executables and hpux executables. */ 94 short system_id; 95 96 /* Magic exec flags. These control things like whether or not 97 null pointer dereferencing is allowed and the like. */ 98 long exec_flags; 99 100 /* We must preserve the version identifier too. Some versions 101 of the HP linker do not grok NEW_VERSION_ID for reasons unknown. */ 102 unsigned int version_id; 103 104 /* Add more stuff here as needed. Good examples of information 105 we might want to pass would be presumed_dp, entry_* and maybe 106 others from the file header. */ 107 }; 108 109 struct somdata 110 { 111 /* All the magic information about an executable which lives 112 in the private BFD structure and needs to be copied from 113 the input bfd to the output bfd during an objcopy/strip. */ 114 struct som_exec_data *exec_data; 115 116 /* These three fields are only used when writing files and are 117 generated from scratch. They need not be copied for objcopy 118 or strip to work. */ 119 struct som_header *file_hdr; 120 struct som_string_auxhdr *copyright_aux_hdr; 121 struct som_string_auxhdr *version_aux_hdr; 122 struct som_exec_auxhdr *exec_hdr; 123 struct som_compilation_unit *comp_unit; 124 125 /* Pointers to a saved copy of the symbol and string tables. These 126 need not be copied for objcopy or strip to work. */ 127 som_symbol_type *symtab; 128 char *stringtab; 129 asymbol **sorted_syms; 130 131 /* We remember these offsets so that after check_file_format, we have 132 no dependencies on the particular format of the exec_hdr. 133 These offsets need not be copied for objcopy or strip to work. */ 134 135 file_ptr sym_filepos; 136 file_ptr str_filepos; 137 file_ptr reloc_filepos; 138 unsigned stringtab_size; 139 void * line_info; 140 }; 141 142 struct som_data_struct 143 { 144 struct somdata a; 145 }; 146 147 /* Substructure of som_section_data_struct used to hold information 148 which can't be represented by the generic BFD section structure, 149 but which must be copied during objcopy or strip. */ 150 struct som_copyable_section_data_struct 151 { 152 /* Various fields in space and subspace headers that we need 153 to pass around. */ 154 unsigned int sort_key : 8; 155 unsigned int access_control_bits : 7; 156 unsigned int is_defined : 1; 157 unsigned int is_private : 1; 158 unsigned int quadrant : 2; 159 unsigned int is_comdat : 1; 160 unsigned int is_common : 1; 161 unsigned int dup_common : 1; 162 163 /* For subspaces, this points to the section which represents the 164 space in which the subspace is contained. For spaces it points 165 back to the section for this space. */ 166 asection *container; 167 168 /* The user-specified space number. It is wrong to use this as 169 an index since duplicates and holes are allowed. */ 170 int space_number; 171 172 /* Add more stuff here as needed. Good examples of information 173 we might want to pass would be initialization pointers, 174 and the many subspace flags we do not represent yet. */ 175 }; 176 177 /* Used to keep extra SOM specific information for a given section. 178 179 reloc_size holds the size of the relocation stream, note this 180 is very different from the number of relocations as SOM relocations 181 are variable length. 182 183 reloc_stream is the actual stream of relocation entries. */ 184 185 struct som_section_data_struct 186 { 187 struct som_copyable_section_data_struct *copy_data; 188 unsigned int reloc_size; 189 unsigned char *reloc_stream; 190 struct som_space_dictionary_record *space_dict; 191 struct som_subspace_dictionary_record *subspace_dict; 192 }; 193 194 #define somdata(bfd) ((bfd)->tdata.som_data->a) 195 #define obj_som_exec_data(bfd) (somdata (bfd).exec_data) 196 #define obj_som_file_hdr(bfd) (somdata (bfd).file_hdr) 197 #define obj_som_exec_hdr(bfd) (somdata (bfd).exec_hdr) 198 #define obj_som_copyright_hdr(bfd) (somdata (bfd).copyright_aux_hdr) 199 #define obj_som_version_hdr(bfd) (somdata (bfd).version_aux_hdr) 200 #define obj_som_compilation_unit(bfd) (somdata (bfd).comp_unit) 201 #define obj_som_symtab(bfd) (somdata (bfd).symtab) 202 #define obj_som_stringtab(bfd) (somdata (bfd).stringtab) 203 #define obj_som_sym_filepos(bfd) (somdata (bfd).sym_filepos) 204 #define obj_som_str_filepos(bfd) (somdata (bfd).str_filepos) 205 #define obj_som_stringtab_size(bfd) (somdata (bfd).stringtab_size) 206 #define obj_som_reloc_filepos(bfd) (somdata (bfd).reloc_filepos) 207 #define obj_som_sorted_syms(bfd) (somdata (bfd).sorted_syms) 208 #define som_section_data(sec) ((struct som_section_data_struct *) sec->used_by_bfd) 209 #define som_symbol_data(symbol) ((som_symbol_type *) symbol) 210 211 /* Defines groups of basic relocations. FIXME: These should 212 be the only basic relocations created by GAS. The rest 213 should be internal to the BFD backend. 214 215 The idea is both SOM and ELF define these basic relocation 216 types so they map into a SOM or ELF specific relocation as 217 appropriate. This allows GAS to share much more code 218 between the two object formats. */ 219 220 #define R_HPPA_NONE R_NO_RELOCATION 221 #define R_HPPA R_CODE_ONE_SYMBOL 222 #define R_HPPA_PCREL_CALL R_PCREL_CALL 223 #define R_HPPA_ABS_CALL R_ABS_CALL 224 #define R_HPPA_GOTOFF R_DP_RELATIVE 225 #define R_HPPA_ENTRY R_ENTRY 226 #define R_HPPA_EXIT R_EXIT 227 #define R_HPPA_COMPLEX R_COMP1 228 #define R_HPPA_BEGIN_BRTAB R_BEGIN_BRTAB 229 #define R_HPPA_END_BRTAB R_END_BRTAB 230 #define R_HPPA_BEGIN_TRY R_BEGIN_TRY 231 #define R_HPPA_END_TRY R_END_TRY 232 233 /* Exported functions, mostly for use by GAS. */ 234 bool bfd_som_set_section_attributes 235 (asection *, int, int, unsigned int, int); 236 bool bfd_som_set_subsection_attributes 237 (asection *, asection *, int, unsigned int, int, int, int, int); 238 void bfd_som_set_symbol_type 239 (asymbol *, unsigned int); 240 bool bfd_som_attach_aux_hdr 241 (bfd *, int, char *); 242 int **hppa_som_gen_reloc_type 243 (bfd *, int, int, enum hppa_reloc_field_selector_type_alt, int, asymbol *); 244 bool bfd_som_attach_compilation_unit 245 (bfd *, const char *, const char *, const char *, const char *); 246 asection *bfd_section_from_som_symbol 247 (bfd *abfd, struct som_external_symbol_dictionary_record *symbol); 248 249 #ifdef __cplusplus 250 } 251 #endif 252 #endif /* _SOM_H */ 253