bfd/elf32-avr.h

   1 /* AVR-specific support for 32-bit ELF.
   2    Copyright (C) 2006-2020 Free Software Foundation, Inc.
   3
   4    Written by Bjoern Haase <bjoern.m.haase@web.de>
   5
   6    This file is part of BFD, the Binary File Descriptor library.
   7
   8    This program is free software; you can redistribute it and/or modify
   9    it under the terms of the GNU General Public License as published by
  10    the Free Software Foundation; either version 3 of the License, or
  11    (at your option) any later version.
  12
  13    This program is distributed in the hope that it will be useful,
  14    but WITHOUT ANY WARRANTY; without even the implied warranty of
  15    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16    GNU General Public License for more details.
  17
  18    You should have received a copy of the GNU General Public License
  19    along with this program; if not, write to the Free Software
  20    Foundation, Inc., 51 Franklin Street - Fifth Floor,
  21    Boston, MA 02110-1301, USA.  */
  22
  23
  24 /* These four functions will be called from the ld back-end.  */
  25
  26 extern void
  27 elf32_avr_setup_params (struct bfd_link_info *, bfd *, asection *,
  28                         bfd_boolean, bfd_boolean, bfd_boolean,
  29                         bfd_vma, bfd_boolean);
  30
  31 extern int
  32 elf32_avr_setup_section_lists (bfd *, struct bfd_link_info *);
  33
  34 extern bfd_boolean
  35 elf32_avr_size_stubs (bfd *, struct bfd_link_info *, bfd_boolean);
  36
  37 extern bfd_boolean
  38 elf32_avr_build_stubs (struct bfd_link_info *);
  39
  40 /* The name of the section into which the property records are stored.  */
  41 #define AVR_PROPERTY_RECORD_SECTION_NAME ".avr.prop"
  42
  43 /* The current version number for the format of the property records.  */
  44 #define AVR_PROPERTY_RECORDS_VERSION 1
  45
  46 /* The size of the header that is written to the property record section
  47    before the property records are written out.  */
  48 #define AVR_PROPERTY_SECTION_HEADER_SIZE 4
  49
  50 /* This holds a single property record in memory, the structure of this
  51    data when written out to the ELF section is more compressed.  */
  52
  53 struct avr_property_record
  54 {
  55   /* The section and offset for this record.  */
  56   asection *section;
  57   bfd_vma offset;
  58
  59   /* The type of this record.  */
  60   enum {
  61     RECORD_ORG = 0,
  62     RECORD_ORG_AND_FILL = 1,
  63     RECORD_ALIGN = 2,
  64     RECORD_ALIGN_AND_FILL = 3
  65   } type;
  66
  67   /* Type specific data.  */
  68   union
  69   {
  70     /* RECORD_ORG and RECORD_ORG_AND_FILL.  */
  71     struct
  72     {
  73       unsigned long fill;
  74     } org;
  75
  76     /* RECORD_ALIGN and RECORD_ALIGN_AND_FILL.  */
  77     struct
  78     {
  79       unsigned long bytes;
  80       unsigned long fill;
  81
  82       /* This field is used during linker relaxation to track the number of
  83          bytes that have been opened up before this alignment directive.
  84          When we have enough bytes available it is possible to move the
  85          re-align this directive backwards while still maintaining the
  86          alignment requirement.  */
  87       unsigned long preceding_deleted;
  88     } align;
  89   } data;
  90 };
  91
  92 struct avr_property_record_list
  93 {
  94   /* The version number tells us the structure of the property record data
  95      within the section.  See AVR_PROPERTY_RECORDS_VERSION.  */
  96   bfd_byte version;
  97
  98   /* The flags field is currently unused.  This should be set to 0.  */
  99   bfd_byte flags;
 100
 101   /* The number of property records.  This is stored as a 2-byte value in
 102      the section contents.  */
 103   unsigned long record_count;
 104
 105   /* The section from which the property records were loaded.  This is the
 106      actual section containing the records, not the section(s) to which the
 107      records apply.  */
 108   asection *section;
 109
 110   /* The actual property records.  */
 111   struct avr_property_record *records;
 112 };
 113
 114 /* Load the property records from ABFD, return NULL if there are non
 115    found, otherwise return pointer to dynamically allocated memory.  The
 116    memory for the header and all of the records are allocated in a single
 117    block, as such only the header needs to be freed.  */
 118
 119 extern struct avr_property_record_list *avr_elf32_load_property_records (bfd *abfd);
 120
 121 /* Return a string that is the name of the property record pointed to by REC.  */
 122 extern const char *avr_elf32_property_record_name (struct avr_property_record *rec);