Home | History | Annotate | Line # | Download | only in scripttempl
      1 # Copyright (C) 2014-2025 Free Software Foundation, Inc.
      2 #
      3 # Copying and distribution of this file, with or without modification,
      4 # are permitted in any medium without royalty provided the copyright
      5 # notice and this notice are preserved.
      6 #
      7 # Unusual variables checked by this code:
      8 #	NOP - two byte opcode for no-op (defaults to 0)
      9 #	INITIAL_READONLY_SECTIONS - at start of text segment
     10 #	OTHER_READONLY_SECTIONS - other than .text .init .rodata ...
     11 #		(e.g., .PARISC.milli)
     12 #	OTHER_TEXT_SECTIONS - these get put in .text when relocating
     13 #	OTHER_READWRITE_SECTIONS - other than .data .bss .ctors .sdata ...
     14 #		(e.g., .PARISC.global)
     15 #	OTHER_SECTIONS - at the end
     16 #	EXECUTABLE_SYMBOLS - symbols that must be defined for an
     17 #		executable (e.g., _DYNAMIC_LINK)
     18 #	TEXT_START_SYMBOLS - symbols that appear at the start of the
     19 #		.text section.
     20 #	DATA_START_SYMBOLS - symbols that appear at the start of the
     21 #		.data section.
     22 #	OTHER_GOT_SYMBOLS - symbols defined just before .got.
     23 #	OTHER_GOT_SECTIONS - sections just after .got and .sdata.
     24 #	OTHER_BSS_SYMBOLS - symbols that appear at the start of the
     25 #		.bss section besides __bss_start.
     26 #	INPUT_FILES - INPUT command of files to always include
     27 #	INIT_START, INIT_END -  statements just before and just after
     28 #	combination of .init sections.
     29 #	FINI_START, FINI_END - statements just before and just after
     30 #	combination of .fini sections.
     31 #
     32 # When adding sections, do note that the names of some sections are used
     33 # when specifying the start address of the next.
     34 #
     35 
     36 #  Many sections come in three flavours.  There is the 'real' section,
     37 #  like ".data".  Then there are the per-procedure or per-variable
     38 #  sections, generated by -ffunction-sections and -fdata-sections in GCC,
     39 #  and useful for --gc-sections, which for a variable "foo" might be
     40 #  ".data.foo".  Then there are the linkonce sections, for which the linker
     41 #  eliminates duplicates, which are named like ".gnu.linkonce.d.foo".
     42 #  The exact correspondences are:
     43 #
     44 #  Section	Linkonce section
     45 #  .text	.gnu.linkonce.t.foo
     46 #  .rodata	.gnu.linkonce.r.foo
     47 #  .data	.gnu.linkonce.d.foo
     48 #  .bss		.gnu.linkonce.b.foo
     49 #  .sdata	.gnu.linkonce.s.foo
     50 #  .sbss	.gnu.linkonce.sb.foo
     51 #  .sdata2	.gnu.linkonce.s2.foo
     52 #  .sbss2	.gnu.linkonce.sb2.foo
     53 #
     54 #  Each of these can also have corresponding .rel.* and .rela.* sections.
     55 
     56 test -z "$ENTRY" && ENTRY=_start
     57 test -z "${BIG_OUTPUT_FORMAT}" && BIG_OUTPUT_FORMAT=${OUTPUT_FORMAT}
     58 test -z "${LITTLE_OUTPUT_FORMAT}" && LITTLE_OUTPUT_FORMAT=${OUTPUT_FORMAT}
     59 if [ -z "$MACHINE" ]; then OUTPUT_ARCH=${ARCH}; else OUTPUT_ARCH=${ARCH}:${MACHINE}; fi
     60 test -z "${ELFSIZE}" && ELFSIZE=32
     61 test -z "${ALIGNMENT}" && ALIGNMENT="${ELFSIZE} / 8"
     62 CTOR=".ctors ${CONSTRUCTING-0} :
     63   {
     64     ${CONSTRUCTING+${CTOR_START}}
     65     /* gcc uses crtbegin.o to find the start of
     66        the constructors, so we make sure it is
     67        first.  Because this is a wildcard, it
     68        doesn't matter if the user does not
     69        actually link against crtbegin.o; the
     70        linker won't look for a file to match a
     71        wildcard.  The wildcard also means that it
     72        doesn't matter which directory crtbegin.o
     73        is in.  */
     74 
     75     KEEP (*crtbegin.o(.ctors))
     76     KEEP (*crtbegin?.o(.ctors))
     77 
     78     /* We don't want to include the .ctor section from
     79        the crtend.o file until after the sorted ctors.
     80        The .ctor section from the crtend file contains the
     81        end of ctors marker and it must be last */
     82 
     83     KEEP (*(EXCLUDE_FILE (*crtend.o *crtend?.o $OTHER_EXCLUDE_FILES) .ctors))
     84     KEEP (*(SORT(.ctors.*)))
     85     KEEP (*(.ctors))
     86     ${CONSTRUCTING+${CTOR_END}}
     87   } > ROM"
     88 
     89 DTOR=" .dtors       ${CONSTRUCTING-0} :
     90   {
     91     ${CONSTRUCTING+${DTOR_START}}
     92     KEEP (*crtbegin.o(.dtors))
     93     KEEP (*crtbegin?.o(.dtors))
     94     KEEP (*(EXCLUDE_FILE (*crtend.o *crtend?.o $OTHER_EXCLUDE_FILES) .dtors))
     95     KEEP (*(SORT(.dtors.*)))
     96     KEEP (*(.dtors))
     97     ${CONSTRUCTING+${DTOR_END}}
     98   } > ROM"
     99 
    100 cat <<EOF
    101 /* Copyright (C) 2014-2025 Free Software Foundation, Inc.
    102 
    103    Copying and distribution of this script, with or without modification,
    104    are permitted in any medium without royalty provided the copyright
    105    notice and this notice are preserved.  */
    106 
    107 OUTPUT_FORMAT("${OUTPUT_FORMAT}", "${BIG_OUTPUT_FORMAT}",
    108 	      "${LITTLE_OUTPUT_FORMAT}")
    109 OUTPUT_ARCH(${OUTPUT_ARCH})
    110 EOF
    111 
    112 test -n "${RELOCATING}" && cat <<EOF
    113 ENTRY(${ENTRY})
    114 
    115 ${LIB_SEARCH_DIRS}
    116 ${EXECUTABLE_SYMBOLS}
    117 ${INPUT_FILES}
    118 
    119 /* There are two memory regions we care about, one from 0 through 0x7F00
    120    that is RAM and one from 0x8000 up which is ROM.  */
    121 MEMORY
    122 {
    123   RAM (w) : ORIGIN = 0, LENGTH = 0x7F00
    124   ROM (!w) : ORIGIN = 0x8000, LENGTH = 0xFF8000
    125 }
    126 EOF
    127 
    128 cat <<EOF
    129 SECTIONS
    130 {
    131   .data  ${RELOCATING-0} :
    132   {
    133     ${RELOCATING+__rdata = .;}
    134     ${RELOCATING+__data = .;}
    135     ${RELOCATING+${DATA_START_SYMBOLS}}
    136     *(.data)
    137     ${RELOCATING+*(.data.*)}
    138     ${RELOCATING+*(.gnu.linkonce.d.*)}
    139     ${CONSTRUCTING+SORT(CONSTRUCTORS)}
    140   }${RELOCATING+ > RAM}
    141   ${RELOCATING+${OTHER_READWRITE_SECTIONS}}
    142   ${RELOCATING+${OTHER_GOT_SYMBOLS}}
    143   ${RELOCATING+${OTHER_GOT_SECTIONS}}
    144   ${RELOCATING+_edata = .;}
    145   ${RELOCATING+PROVIDE (edata = .);}
    146   ${RELOCATING+. = ALIGN(ALIGNOF(NEXT_SECTION));}
    147   ${RELOCATING+__bss_start = .;}
    148   ${RELOCATING+${OTHER_BSS_SYMBOLS}}
    149   .bss     ${RELOCATING-0} :
    150   {
    151    ${RELOCATING+*(.dynbss)}
    152    *(.bss)
    153    ${RELOCATING+*(.bss.*)}
    154    ${RELOCATING+*(.gnu.linkonce.b.*)}
    155    ${RELOCATING+*(COMMON)
    156    /* Align here to ensure that the .bss section occupies space up to
    157       _end.  Align after .bss to ensure correct alignment even if the
    158       .bss section disappears because there are no input sections.  */
    159    . = ALIGN(${ALIGNMENT});}
    160   }${RELOCATING+ > RAM}
    161   ${RELOCATING+${OTHER_BSS_END_SYMBOLS}}
    162   ${RELOCATING+. = ALIGN(${ALIGNMENT});}
    163   ${RELOCATING+${OTHER_END_SYMBOLS}}
    164   ${RELOCATING+_end = .;}
    165   ${RELOCATING+__stack = .;}
    166   ${RELOCATING+PROVIDE (end = .);}
    167 
    168   /* Read-only sections in ROM.  */
    169   .int_vec     ${RELOCATING-0} : { *(.int_vec)	}${RELOCATING+ > ROM}
    170 
    171   .rodata ${RELOCATING-0} : { *(.rodata) ${RELOCATING+*(.rodata.*)} ${RELOCATING+*(.gnu.linkonce.r.*)} }${RELOCATING+ > ROM}
    172   ${RELOCATING+${CTOR}}
    173   ${RELOCATING+${DTOR}}
    174   .jcr : { KEEP (*(.jcr)) }${RELOCATING+ > ROM}
    175   .eh_frame : { KEEP (*(.eh_frame)) }${RELOCATING+ > ROM}
    176   .gcc_except_table : { *(.gcc_except_table)${RELOCATING+ *(.gcc_except_table.*)} }${RELOCATING+ > ROM}
    177   .plt : { *(.plt) }${RELOCATING+ > ROM}
    178 
    179   .text    ${RELOCATING-0} :
    180   {
    181     ${RELOCATING+${TEXT_START_SYMBOLS}}
    182     *(.text)
    183     ${RELOCATING+*(.text.*)}
    184     *(.stub)
    185     /* .gnu.warning sections are handled specially by elf.em.  */
    186     *(.gnu.warning)
    187     ${RELOCATING+*(.gnu.linkonce.t.*)}
    188     ${RELOCATING+${OTHER_TEXT_SECTIONS}}
    189   }${RELOCATING+ > ROM =${NOP-0}}
    190   .init        ${RELOCATING-0} :
    191   {
    192     ${RELOCATING+${INIT_START}}
    193     KEEP (*(SORT_NONE(.init)))
    194     ${RELOCATING+${INIT_END}}
    195   }${RELOCATING+ > ROM =${NOP-0}}
    196   .fini    ${RELOCATING-0} :
    197   {
    198     ${RELOCATING+${FINI_START}}
    199     KEEP (*(SORT_NONE(.fini)))
    200     ${RELOCATING+${FINI_END}}
    201   }${RELOCATING+ > ROM =${NOP-0}}
    202   ${RELOCATING+PROVIDE (__etext = .);}
    203   ${RELOCATING+PROVIDE (_etext = .);}
    204   ${RELOCATING+PROVIDE (etext = .);}
    205   ${RELOCATING+${OTHER_READONLY_SECTIONS}}
    206 
    207 EOF
    208 
    209 source_sh $srcdir/scripttempl/misc-sections.sc
    210 source_sh $srcdir/scripttempl/DWARF.sc
    211 
    212 cat <<EOF
    213   ${RELOCATING+${OTHER_RELOCATING_SECTIONS}}
    214 
    215   /* These must appear regardless of ${RELOCATING}.  */
    216   ${OTHER_SECTIONS}
    217 }
    218 EOF
    219