X-Git-Url: https://git.libre-soc.org/?a=blobdiff_plain;f=bfd%2Flibcoff.h;h=024a6481a66b59ee97867a986b01f4482a8c516b;hb=0b99131d48925b260f109613aba933abe711e90b;hp=d0e3d0dd903a617acd879a02c899b0ed8b98404f;hpb=827041555ac443bd57340060f3e034fd7b199dd8;p=binutils-gdb.git diff --git a/bfd/libcoff.h b/bfd/libcoff.h index d0e3d0dd903..024a6481a66 100644 --- a/bfd/libcoff.h +++ b/bfd/libcoff.h @@ -3,7 +3,7 @@ Run "make headers" in your build bfd/ to regenerate. */ /* BFD COFF object file private structure. - Copyright (C) 1990-2019 Free Software Foundation, Inc. + Copyright (C) 1990-2022 Free Software Foundation, Inc. Written by Cygnus Support. This file is part of BFD, the Binary File Descriptor library. @@ -37,8 +37,9 @@ extern "C" { #define coff_data(bfd) ((bfd)->tdata.coff_obj_data) #define obj_pe(bfd) (coff_data (bfd)->pe) +#define obj_go32(bfd) (coff_data (bfd)->go32) #define obj_symbols(bfd) (coff_data (bfd)->symbols) -#define obj_sym_filepos(bfd) (coff_data (bfd)->sym_filepos) +#define obj_sym_filepos(bfd) (coff_data (bfd)->sym_filepos) #define obj_relocbase(bfd) (coff_data (bfd)->relocbase) #define obj_raw_syments(bfd) (coff_data (bfd)->raw_syments) #define obj_raw_syment_count(bfd) (coff_data (bfd)->raw_syment_count) @@ -83,7 +84,7 @@ typedef struct coff_tdata _bfd_coff_get_external_symbols. */ void * external_syms; /* If this is TRUE, the external_syms may not be freed. */ - bfd_boolean keep_syms; + bool keep_syms; /* The string table. May be NULL. Read by _bfd_coff_read_string_table. */ @@ -91,9 +92,9 @@ typedef struct coff_tdata /* The length of the strings table. For error checking. */ bfd_size_type strings_len; /* If this is TRUE, the strings may not be freed. */ - bfd_boolean keep_strings; + bool keep_strings; /* If this is TRUE, the strings have been written out already. */ - bfd_boolean strings_written; + bool strings_written; /* Is this a PE format coff file? */ int pe; @@ -118,9 +119,14 @@ typedef struct coff_tdata used by ARM code. */ flagword flags; - /* coff-stgo32 EXE stub header after BFD tdata has been allocated. Its data - is kept in internal_filehdr.go32stub beforehand. */ - char *go32stub; + /* Is this a GO32 coff file? */ + bool go32; + + /* A stub (extra data prepended before the COFF image) and its size. + Used by coff-go32-exe, it contains executable data that loads the + COFF object into memory. */ + char * stub; + bfd_size_type stub_size; } coff_data_type; /* Tdata for pe image files. */ @@ -131,14 +137,17 @@ typedef struct pe_tdata int dll; int has_reloc_section; int dont_strip_reloc; - bfd_boolean insert_timestamp; - bfd_boolean (*in_reloc_p) (bfd *, reloc_howto_type *); + int dos_message[16]; + /* The timestamp to insert into the output file. + If the timestamp is -1 then the current time is used. */ + int timestamp; + bool (*in_reloc_p) (bfd *, reloc_howto_type *); flagword real_flags; /* Build-id info. */ struct { - bfd_boolean (*after_write_object_contents) (bfd *); + bool (*after_write_object_contents) (bfd *); const char *style; asection *sec; } build_id; @@ -154,10 +163,10 @@ struct xcoff_tdata coff_data_type coff; /* TRUE if this is an XCOFF64 file. */ - bfd_boolean xcoff64; + bool xcoff64; /* TRUE if a large a.out header should be generated. */ - bfd_boolean full_aouthdr; + bool full_aouthdr; /* TOC value. */ bfd_vma toc; @@ -238,8 +247,9 @@ struct coff_link_hash_entry { struct bfd_link_hash_entry root; - /* Symbol index in output file. Set to -1 initially. Set to -2 if - there is a reloc against this symbol. */ + /* Symbol index in output file. This is initialized to -1. It is + set to -2 if the symbol is used by a reloc. It is set to -3 if + this symbol is defined in a discarded section. */ long indx; /* Symbol type. */ @@ -294,7 +304,7 @@ struct coff_reloc_cookie #define coff_link_hash_traverse(table, func, info) \ (bfd_link_hash_traverse \ (&(table)->root, \ - (bfd_boolean (*) (struct bfd_link_hash_entry *, void *)) (func), \ + (bool (*) (struct bfd_link_hash_entry *, void *)) (func), \ (info))) /* Get the COFF linker hash table from a link_info structure. */ @@ -302,7 +312,7 @@ struct coff_reloc_cookie #define coff_hash_table(p) ((struct coff_link_hash_table *) ((p)->hash)) /* Functions in coffgen.c. */ -extern const bfd_target *coff_object_p +extern bfd_cleanup coff_object_p (bfd *); extern struct bfd_section *coff_section_from_bfd_index (bfd *, int); @@ -312,26 +322,26 @@ extern long coff_canonicalize_symtab (bfd *, asymbol **); extern int coff_count_linenumbers (bfd *); -extern bfd_boolean coff_renumber_symbols +extern bool coff_renumber_symbols (bfd *, int *); extern void coff_mangle_symbols (bfd *); -extern bfd_boolean coff_write_symbols +extern bool coff_write_symbols (bfd *); -extern bfd_boolean coff_write_alien_symbol +extern bool coff_write_alien_symbol (bfd *, asymbol *, struct internal_syment *, union internal_auxent *, bfd_vma *, bfd_size_type *, asection **, bfd_size_type *); -extern bfd_boolean coff_write_linenumbers +extern bool coff_write_linenumbers (bfd *); extern alent *coff_get_lineno (bfd *, asymbol *); extern asymbol *coff_section_symbol (bfd *, char *); -extern bfd_boolean _bfd_coff_get_external_symbols +extern bool _bfd_coff_get_external_symbols (bfd *); extern const char *_bfd_coff_read_string_table (bfd *); -extern bfd_boolean _bfd_coff_free_symbols +extern bool _bfd_coff_free_symbols (bfd *); extern struct coff_ptr_struct *coff_get_normalized_symtab (bfd *); @@ -345,31 +355,33 @@ extern void coff_get_symbol_info (bfd *, asymbol *, symbol_info *ret); #define coff_get_symbol_version_string \ _bfd_nosymbols_get_symbol_version_string -extern bfd_boolean _bfd_coff_is_local_label_name +extern bool _bfd_coff_is_local_label_name (bfd *, const char *); extern asymbol *coff_bfd_make_debug_symbol (bfd *, void *, unsigned long); -extern bfd_boolean coff_find_nearest_line +extern bool coff_find_nearest_line (bfd *, asymbol **, asection *, bfd_vma, const char **, const char **, unsigned int *, unsigned int *); #define coff_find_line _bfd_nosymbols_find_line struct dwarf_debug_section; -extern bfd_boolean coff_find_nearest_line_with_names +extern bool coff_find_nearest_line_with_names (bfd *, asymbol **, asection *, bfd_vma, const char **, const char **, unsigned int *, const struct dwarf_debug_section *); -extern bfd_boolean coff_find_inliner_info +extern bool coff_find_inliner_info (bfd *, const char **, const char **, unsigned int *); extern int coff_sizeof_headers (bfd *, struct bfd_link_info *); -extern bfd_boolean bfd_coff_reloc16_relax_section - (bfd *, asection *, struct bfd_link_info *, bfd_boolean *); +extern bool bfd_coff_reloc16_relax_section + (bfd *, asection *, struct bfd_link_info *, bool *); extern bfd_byte *bfd_coff_reloc16_get_relocated_section_contents (bfd *, struct bfd_link_info *, struct bfd_link_order *, - bfd_byte *, bfd_boolean, asymbol **); + bfd_byte *, bool, asymbol **); extern bfd_vma bfd_coff_reloc16_get_value (arelent *, struct bfd_link_info *, asection *); extern void bfd_perform_slip (bfd *, unsigned int, asection *, bfd_vma); +extern bool _bfd_coff_close_and_cleanup + (bfd *); /* Functions and types in cofflink.c. */ @@ -468,11 +480,11 @@ struct coff_final_link_info /* Output BFD. */ bfd *output_bfd; /* Used to indicate failure in traversal routine. */ - bfd_boolean failed; + bool failed; /* If doing "task linking" set only during the time when we want the global symbol writer to convert the storage class of defined global symbols from global to static. */ - bfd_boolean global_to_static; + bool global_to_static; /* Hash table for long symbol names. */ struct bfd_strtab_hash *strtab; /* When doing a relocatable link, an array of information kept for @@ -546,7 +558,7 @@ struct coff_section_alignment_entry extern struct bfd_hash_entry *_bfd_coff_link_hash_newfunc (struct bfd_hash_entry *, struct bfd_hash_table *, const char *); -extern bfd_boolean _bfd_coff_link_hash_table_init +extern bool _bfd_coff_link_hash_table_init (struct coff_link_hash_table *, bfd *, struct bfd_hash_entry *(*) (struct bfd_hash_entry *, struct bfd_hash_table *, @@ -556,32 +568,33 @@ extern struct bfd_link_hash_table *_bfd_coff_link_hash_table_create (bfd *); extern const char *_bfd_coff_internal_syment_name (bfd *, const struct internal_syment *, char *); -extern bfd_boolean _bfd_coff_section_already_linked +extern bool _bfd_coff_section_already_linked (bfd *, asection *, struct bfd_link_info *); -extern bfd_boolean _bfd_coff_link_add_symbols +extern bool _bfd_coff_link_add_symbols (bfd *, struct bfd_link_info *); -extern bfd_boolean _bfd_coff_final_link +extern bool _bfd_coff_final_link (bfd *, struct bfd_link_info *); extern struct internal_reloc *_bfd_coff_read_internal_relocs - (bfd *, asection *, bfd_boolean, bfd_byte *, bfd_boolean, + (bfd *, asection *, bool, bfd_byte *, bool, struct internal_reloc *); -extern bfd_boolean _bfd_coff_generic_relocate_section +extern bool _bfd_coff_generic_relocate_section (bfd *, struct bfd_link_info *, bfd *, asection *, bfd_byte *, struct internal_reloc *, struct internal_syment *, asection **); extern struct bfd_hash_entry *_bfd_coff_debug_merge_hash_newfunc (struct bfd_hash_entry *, struct bfd_hash_table *, const char *); -extern bfd_boolean _bfd_coff_write_global_sym +extern bool _bfd_coff_write_global_sym (struct bfd_hash_entry *, void *); -extern bfd_boolean _bfd_coff_write_task_globals +extern bool _bfd_coff_write_task_globals (struct coff_link_hash_entry *, void *); -extern bfd_boolean _bfd_coff_link_input_bfd +extern bool _bfd_coff_link_input_bfd (struct coff_final_link_info *, bfd *); -extern bfd_boolean _bfd_coff_reloc_link_order +extern bool _bfd_coff_reloc_link_order (bfd *, struct coff_final_link_info *, asection *, struct bfd_link_order *); -extern bfd_boolean bfd_coff_gc_sections +extern bool bfd_coff_gc_sections (bfd *, struct bfd_link_info *); - +extern const char *bfd_coff_group_name + (bfd *, const asection *); #define coff_get_section_contents_in_window \ _bfd_generic_get_section_contents_in_window @@ -598,23 +611,15 @@ extern long _bfd_xcoff_canonicalize_dynamic_reloc (bfd *, arelent **, asymbol **); extern struct bfd_link_hash_table *_bfd_xcoff_bfd_link_hash_table_create (bfd *); -extern bfd_boolean _bfd_xcoff_bfd_link_add_symbols +extern bool _bfd_xcoff_bfd_link_add_symbols (bfd *, struct bfd_link_info *); -extern bfd_boolean _bfd_xcoff_bfd_final_link +extern bool _bfd_xcoff_bfd_final_link (bfd *, struct bfd_link_info *); -extern bfd_boolean _bfd_xcoff_define_common_symbol +extern bool _bfd_xcoff_define_common_symbol (bfd *, struct bfd_link_info *, struct bfd_link_hash_entry *); -extern bfd_boolean _bfd_ppc_xcoff_relocate_section +extern bool _bfd_ppc_xcoff_relocate_section (bfd *, struct bfd_link_info *, bfd *, asection *, bfd_byte *, struct internal_reloc *, struct internal_syment *, asection **); - -/* Functions in coff-ppc.c. FIXME: These are called by pe.em in the - linker, and so should start with bfd and be declared in bfd.h. */ - -extern bfd_boolean ppc_allocate_toc_section - (struct bfd_link_info *); -extern bfd_boolean ppc_process_before_allocation - (bfd *, struct bfd_link_info *); /* Extracted from coffcode.h. */ typedef struct coff_ptr_struct @@ -652,7 +657,11 @@ typedef struct coff_ptr_struct } u; /* Selector for the union above. */ - bfd_boolean is_sym; + bool is_sym; + + /* An extra pointer which can used by format based on COFF (like XCOFF) + to provide extra information to their backend. */ + void *extrap; } combined_entry_type; @@ -670,7 +679,7 @@ typedef struct coff_symbol_struct struct lineno_cache_entry *lineno; /* Have the line numbers been relocated yet ? */ - bfd_boolean done_lineno; + bool done_lineno; } coff_symbol_type; /* COFF symbol classifications. */ @@ -732,14 +741,14 @@ typedef struct unsigned int _bfd_relsz; unsigned int _bfd_linesz; unsigned int _bfd_filnmlen; - bfd_boolean _bfd_coff_long_filenames; + bool _bfd_coff_long_filenames; - bfd_boolean _bfd_coff_long_section_names; - bfd_boolean (*_bfd_coff_set_long_section_names) + bool _bfd_coff_long_section_names; + bool (*_bfd_coff_set_long_section_names) (bfd *, int); unsigned int _bfd_coff_default_section_alignment_power; - bfd_boolean _bfd_coff_force_symnames_in_strings; + bool _bfd_coff_force_symnames_in_strings; unsigned int _bfd_coff_debug_string_prefix_length; unsigned int _bfd_coff_max_nscns; @@ -755,32 +764,32 @@ typedef struct void (*_bfd_coff_swap_reloc_in) (bfd *abfd, void *, void *); - bfd_boolean (*_bfd_coff_bad_format_hook) + bool (*_bfd_coff_bad_format_hook) (bfd *, void *); - bfd_boolean (*_bfd_coff_set_arch_mach_hook) + bool (*_bfd_coff_set_arch_mach_hook) (bfd *, void *); void * (*_bfd_coff_mkobject_hook) (bfd *, void *, void *); - bfd_boolean (*_bfd_styp_to_sec_flags_hook) + bool (*_bfd_styp_to_sec_flags_hook) (bfd *, void *, const char *, asection *, flagword *); void (*_bfd_set_alignment_hook) (bfd *, asection *, void *); - bfd_boolean (*_bfd_coff_slurp_symbol_table) + bool (*_bfd_coff_slurp_symbol_table) (bfd *); - bfd_boolean (*_bfd_coff_symname_in_debug) + bool (*_bfd_coff_symname_in_debug) (bfd *, struct internal_syment *); - bfd_boolean (*_bfd_coff_pointerize_aux_hook) + bool (*_bfd_coff_pointerize_aux_hook) (bfd *, combined_entry_type *, combined_entry_type *, unsigned int, combined_entry_type *); - bfd_boolean (*_bfd_coff_print_aux) + bool (*_bfd_coff_print_aux) (bfd *, FILE *, combined_entry_type *, combined_entry_type *, combined_entry_type *, unsigned int); @@ -795,13 +804,13 @@ typedef struct enum coff_symbol_classification (*_bfd_coff_classify_symbol) (bfd *, struct internal_syment *); - bfd_boolean (*_bfd_coff_compute_section_file_positions) + bool (*_bfd_coff_compute_section_file_positions) (bfd *); - bfd_boolean (*_bfd_coff_start_final_link) + bool (*_bfd_coff_start_final_link) (bfd *, struct bfd_link_info *); - bfd_boolean (*_bfd_coff_relocate_section) + bool (*_bfd_coff_relocate_section) (bfd *, struct bfd_link_info *, bfd *, asection *, bfd_byte *, struct internal_reloc *, struct internal_syment *, asection **); @@ -809,22 +818,22 @@ typedef struct (bfd *, asection *, struct internal_reloc *, struct coff_link_hash_entry *, struct internal_syment *, bfd_vma *); - bfd_boolean (*_bfd_coff_adjust_symndx) + bool (*_bfd_coff_adjust_symndx) (bfd *, struct bfd_link_info *, bfd *, asection *, - struct internal_reloc *, bfd_boolean *); + struct internal_reloc *, bool *); - bfd_boolean (*_bfd_coff_link_add_one_symbol) + bool (*_bfd_coff_link_add_one_symbol) (struct bfd_link_info *, bfd *, const char *, flagword, - asection *, bfd_vma, const char *, bfd_boolean, bfd_boolean, + asection *, bfd_vma, const char *, bool, bool, struct bfd_link_hash_entry **); - bfd_boolean (*_bfd_coff_link_output_has_begun) + bool (*_bfd_coff_link_output_has_begun) (bfd *, struct coff_final_link_info *); - bfd_boolean (*_bfd_coff_final_link_postscript) + bool (*_bfd_coff_final_link_postscript) (bfd *, struct coff_final_link_info *); - bfd_boolean (*_bfd_coff_print_pdata) + bool (*_bfd_coff_print_pdata) (bfd *, void *); } bfd_coff_backend_data; @@ -972,7 +981,7 @@ typedef struct /* Macro: Returns true if the bfd is a PE executable as opposed to a PE object file. */ #define bfd_pei_p(abfd) \ - (CONST_STRNEQ ((abfd)->xvec->name, "pei-")) + (startswith ((abfd)->xvec->name, "pei-")) #ifdef __cplusplus } #endif