Commit | Line | Data |
---|---|---|
252b5132 | 1 | -*- text -*- |
97a232d7 | 2 | |
a6dbf402 L |
3 | * Add a command-line option for ELF linker, --warn-textrel, to warn that |
4 | DT_TEXTREL is set in a position-independent executable or shared object. | |
5 | ||
abf874aa CL |
6 | * Add command-line options --enable-non-contiguous-regions and |
7 | --enable-non-contiguous-regions-warnings. | |
8 | ||
fa1477dc SC |
9 | * Add command-line option --imagic for the pdp11-aout target to output format |
10 | IMAGIC (0411) for separate instruction and data spaces, and change the | |
11 | default format option for pdp11-aout to be --omagic. | |
12 | ||
16171946 FS |
13 | * Relative pathnames in INPUT() and GROUP() directives in linker scripts are |
14 | searched relative to the directory of the linker script before other search | |
15 | paths. | |
16 | ||
ae774686 NC |
17 | Changes in 2.34: |
18 | ||
7b3c2715 AM |
19 | * The ld check for "PHDR segment not covered by LOAD segment" is more |
20 | effective, catching cases that were wrongly allowed by previous versions of | |
21 | ld. If you see this error it is likely you are linking with a bad linker | |
22 | script or the binary you are building is not intended to be loaded by a | |
23 | dynamic loader. In the latter case --no-dynamic-linker is appropriate. | |
24 | ||
595d3787 AM |
25 | * cr16c support removed. |
26 | ||
6655dba2 SB |
27 | * Add support for z80-elf. |
28 | ||
29 | * Add support for relocation of each byte or word of multibyte value to Z80 | |
30 | targets. | |
31 | ||
32 | * Add support for Zilog eZ80 (both ADL and Z80 mode) and Zilog Z180 CPUs. | |
33 | ||
60391a25 PB |
34 | Changes in 2.33: |
35 | ||
035801ce FS |
36 | * Add command-line option --no-print-map-discarded. |
37 | ||
739b5c9c TC |
38 | * The Cortex-A53 Erratum 843419 workaround now supports a choice of which |
39 | workaround to use. The option --fix-cortex-a53-843419 now takes an | |
40 | optional argument --fix-cortex-a53-843419[=full|adr|adrp] which can be | |
41 | used to force a particular workaround to be used. See --help for AArch64 | |
42 | for more details. | |
43 | ||
cd702818 SD |
44 | * Add target handlers for AArch64 for ELF GNU program properties. |
45 | ||
46 | * Add support for GNU_PROPERTY_AARCH64_FEATURE_1_BTI in ELF GNU program | |
47 | properties in the AArch64 ELF linker. | |
48 | ||
49 | * Add support for GNU_PROPERTY_AARCH64_FEATURE_1_PAC in ELF GNU program | |
50 | properties in the AArch64 ELF linker. | |
51 | ||
8bf6d176 | 52 | * Add -z force-bti for AArch64 to enable GNU_PROPERTY_AARCH64_FEATURE_1_BTI |
37c18eed SD |
53 | on output while warning about missing GNU_PROPERTY_AARCH64_FEATURE_1_BTI |
54 | on inputs and use PLTs protected with BTI. | |
55 | ||
8bf6d176 | 56 | * Add -z pac-plt for AArch64 to pick PAC enabled PLTs. |
1dbade74 | 57 | |
f48dfe41 NC |
58 | Changes in 2.32: |
59 | ||
d2ef37eb L |
60 | * Report property change in linker map file when merging GNU properties. |
61 | ||
b8891f8d AJ |
62 | * Add support for the C-SKY processor series. |
63 | ||
4f4690cd AM |
64 | * -t now doesn't report members within archives, unless -t is given twice. |
65 | A single -t is now more useful when generating a list of files that should be | |
66 | packaged for a linker bug report. For example: | |
67 | gcc hello.c -save-temps -Wl,-t | xargs realpath | sort | uniq > files | |
68 | tar cJf test.tar.xz `cat files` | |
69 | ||
719d8288 NC |
70 | Changes in 2.31: |
71 | ||
142b7a14 EB |
72 | * Speed up direct linking with DLLs for Cygwin and Mingw targets. |
73 | ||
f6aec96d L |
74 | * Add a configure option --enable-separate-code to decide whether |
75 | -z separate-code should be enabled in ELF linker by default. Default | |
76 | to yes for Linux/x86 targets. Note that -z separate-code can increase | |
77 | disk and memory size. | |
78 | ||
9176ac5b NC |
79 | Changes in 2.30: |
80 | ||
47acac12 L |
81 | * Add -z separate-code to generate separate code PT_LOAD segment. |
82 | ||
a05a5b64 | 83 | * Add "-z undefs" command-line option as the inverse of the "-z defs" option. |
97a232d7 | 84 | |
a05a5b64 | 85 | * Add -z globalaudit command-line option to force audit libraries to be run |
93ab9c0d | 86 | for every dynamic object loaded by an executable - provided that the loader |
6c19b93b | 87 | supports this functionality. |
7feec526 | 88 | |
2b94abd4 AB |
89 | * Tighten linker script grammar around file name specifiers to prevent the use |
90 | of SORT_BY_ALIGNMENT and SORT_BY_INIT_PRIORITY on filenames. These would | |
91 | previously be accepted but had no effect. | |
92 | ||
93 | * The EXCLUDE_FILE directive can now be placed within any SORT_* directive | |
94 | within input section lists. | |
95 | ||
55a09eb6 TG |
96 | Changes in 2.29: |
97 | ||
48580982 L |
98 | * Support for -z shstk in the x86 ELF linker to generate |
99 | GNU_PROPERTY_X86_FEATURE_1_SHSTK in ELF GNU program properties. | |
100 | ||
101 | * Add support for GNU_PROPERTY_X86_FEATURE_1_SHSTK in ELF GNU program | |
102 | properties in the x86 ELF linker. | |
103 | ||
ee2fdd6f | 104 | * Add support for GNU_PROPERTY_X86_FEATURE_1_IBT in ELF GNU program |
48580982 | 105 | properties in the x86 ELF linker. |
ee2fdd6f L |
106 | |
107 | * Support for -z ibtplt in the x86 ELF linker to generate IBT-enabled | |
108 | PLT. | |
109 | ||
110 | * Support for -z ibt in the x86 ELF linker to generate IBT-enabled | |
111 | PLT as well as GNU_PROPERTY_X86_FEATURE_1_IBT in ELF GNU program | |
112 | properties. | |
113 | ||
a91e1603 L |
114 | * Add support for ELF SHF_GNU_MBIND and PT_GNU_MBIND_XXX. |
115 | ||
46bed679 L |
116 | * Add support for ELF GNU program properties. |
117 | ||
0220170b DD |
118 | * Add support for the Texas Instruments PRU processor. |
119 | ||
d7488716 AB |
120 | * When configuring for arc*-*-linux* targets the default linker emulation will |
121 | change if --with-cpu=nps400 is used at configure time. | |
122 | ||
77f5e65e AB |
123 | * Improve assignment of LMAs to orphan sections in some edge cases where a |
124 | mixture of both AT>LMA_REGION and AT(LMA) are used. | |
125 | ||
14ea2c1b AB |
126 | * Orphan sections placed after an empty section that has an AT(LMA) will now |
127 | take an load memory address starting from LMA. | |
128 | ||
7bdf4127 AB |
129 | * Section groups can now be resolved (the group deleted and the group members |
130 | placed like normal sections) at partial link time either using the new linker | |
131 | option --force-group-allocation or by placing FORCE_GROUP_ALLOCATION into the | |
132 | linker script. | |
133 | ||
9703a4ef TG |
134 | Changes in 2.28: |
135 | ||
8f1732fc AB |
136 | * The EXCLUDE_FILE linker script construct can now be applied outside of the |
137 | section list in order for the exclusions to apply over all input sections in | |
138 | the list. | |
139 | ||
e23eba97 | 140 | * Add support for the RISC-V architecture. |
76359541 | 141 | |
a05a5b64 | 142 | * The command-line option --no-eh-frame-hdr can now be used in ELF based |
29063f8b NC |
143 | linkers to disable the automatic generation of .eh_frame_hdr sections. |
144 | ||
0955507f TP |
145 | * Add --in-implib=<infile> to the ARM linker to enable specifying a set of |
146 | Secure Gateway veneers that must exist in the output import library specified | |
147 | by --out-implib=<outfile> and the address they must have. As such, | |
148 | --in-implib is only supported in combination with --cmse-implib. | |
149 | ||
76359541 TP |
150 | * Extended the --out-implib=<file> option, previously restricted to x86 PE |
151 | targets, to any ELF based target. This allows the generation of an import | |
152 | library for an ELF executable, which can then be used by another application | |
153 | to link against the executable. | |
154 | ||
96a84ea3 TG |
155 | Changes in 2.27: |
156 | ||
647e4d46 L |
157 | * Add a configure option --enable-relro to decide whether -z relro should |
158 | be enabled in ELF linker by default. Default to yes for all Linux | |
9194f82d AM |
159 | targets except FRV, HPPA, IA64 and MIPS. Note that -z relro can increase |
160 | disk and memory size. | |
647e4d46 | 161 | |
4c10bbaa L |
162 | * Support for -z noreloc-overflow in the x86-64 ELF linker to disable |
163 | relocation overflow check. | |
164 | ||
b8871f35 L |
165 | * Add -z common/-z nocommon options for ELF targets to control whether to |
166 | convert common symbols to the STT_COMMON type during a relocatable link. | |
167 | ||
aec6b87e L |
168 | * Support for -z nodynamic-undefined-weak in the x86 ELF linker, which |
169 | avoids dynamic relocations against undefined weak symbols in executable. | |
170 | ||
cdf96953 MF |
171 | * The NOCROSSREFSTO command was added to the linker script language. |
172 | ||
1f56df9d JW |
173 | * Add --no-apply-dynamic-relocs to the AArch64 linker to do not apply link-time |
174 | values for dynamic relocations. | |
175 | ||
7feec526 TG |
176 | Changes in 2.26: |
177 | ||
a504d23a LA |
178 | * Add --fix-stm32l4xx-629360 to the ARM linker to enable a link-time |
179 | workaround for a bug in the bus matrix / memory controller for some of | |
180 | the STM32 Cortex-M4 based products (STM32L4xx) | |
81c23f82 | 181 | |
6c3bc0f8 NC |
182 | * Add a configure option --enable-compressed-debug-sections={all,ld} to |
183 | decide whether DWARF debug sections should be compressed by default. | |
184 | ||
886a2506 NC |
185 | * Add support for the ARC EM/HS, and ARC600/700 architectures. |
186 | ||
0f088b2a KT |
187 | * Experimental support for linker garbage collection (--gc-sections) |
188 | has been enabled for COFF and PE based targets. | |
189 | ||
a05a5b64 | 190 | * New command-line option for ELF targets to compress DWARF debug |
ea556d25 L |
191 | sections, --compress-debug-sections=[none|zlib|zlib-gnu|zlib-gabi]. |
192 | ||
a05a5b64 | 193 | * New command-line option, --orphan-handling=[place|warn|error|discard], to |
c005eb9e AB |
194 | adjust how orphan sections are handled. The default is 'place' which gives |
195 | the current behaviour, 'warn' and 'error' issue a warning or error | |
196 | respectively when orphan sections are found, and 'discard' will discard all | |
197 | orphan sections. | |
3ea60775 | 198 | |
b0619670 L |
199 | * Add support for LLVM plugin. |
200 | ||
3604cb1f TG |
201 | * Add --print-memory-usage option to report memory blocks usage. |
202 | ||
0a618243 AB |
203 | * Add --require-defined option, it's like --undefined except the new symbol |
204 | must be defined by the end of the link. | |
205 | ||
c50415e2 TG |
206 | Changes in 2.25: |
207 | ||
eeb14e5a LZ |
208 | * PE binaries now once again contain real timestamps by default. To disable |
209 | the inclusion of a timestamp in a PE binary, use the --no-insert-timestamp | |
a05a5b64 | 210 | command-line option. |
eeb14e5a | 211 | |
73589c9d CS |
212 | * Replace support for openrisc and or32 with support for or1k. |
213 | ||
a05a5b64 | 214 | * Add support for the --build-id command-line option to COFF based targets. |
61e2488c JT |
215 | |
216 | * x86/x86_64 pe-coff now supports the --build-id option. | |
217 | ||
35c08157 KLC |
218 | * Add support for the Andes NDS32. |
219 | ||
58ca03a2 TG |
220 | Changes in 2.24: |
221 | ||
2e53f7d6 NC |
222 | * Add LOG2CEIL() builtin function to the linker script language |
223 | ||
13761a11 NC |
224 | * Add support for the Texas Instruments MSP430X processor. |
225 | ||
36591ba1 SL |
226 | * Add support for Altera Nios II. |
227 | ||
78c8d46c NC |
228 | * Add support for the V850E3V5 architecture. |
229 | ||
a3c62988 NC |
230 | * Add support for the Imagination Technologies Meta processor. |
231 | ||
b1b00fcc MF |
232 | * --enable-new-dtags no longer generates old dtags in addition to new dtags. |
233 | ||
e8044f35 RS |
234 | * Remove linker support for MIPS ECOFF targets. |
235 | ||
1eec346e NC |
236 | * Add ALIGN_WITH_INPUT to the linker script language to force the alignment of |
237 | an output section to use the maximum alignment of all its input sections. | |
238 | ||
af18cb59 TG |
239 | Changes in 2.23: |
240 | ||
8d55a8a0 KT |
241 | * Enable compressed debug section feature for x86/x86_64 pe-coff. |
242 | ||
da2bb560 NC |
243 | * Add support for the 64-bit ARM architecture: AArch64. |
244 | ||
eda680f8 L |
245 | * Added SORT_NONE to the linker script language to disable section sorting. |
246 | ||
62655c7b RM |
247 | * Add a linker-provided symbol when producing ELF output, '__ehdr_start' |
248 | to point to the ELF file header (and nearby program headers) in the | |
249 | program's memory image. | |
250 | ||
6927f982 NC |
251 | * Add support for S12X processor. |
252 | ||
b9c361e0 JL |
253 | * Add support for the VLE extension to the PowerPC architecture. |
254 | ||
f6c1a2d5 NC |
255 | * Add support for the Freescale XGATE architecture. |
256 | ||
a72173de TG |
257 | * Add option -f FILE on AIX (for response file). |
258 | ||
99c513f6 DD |
259 | * Add support for the Renesas RL78 architecture. |
260 | ||
cfb8c092 NC |
261 | * Add support for the Adapteva EPIPHANY architecture. |
262 | ||
a7142d94 TG |
263 | Changes in 2.22: |
264 | ||
d064f206 NC |
265 | * --copy-dt-needed-entries is no longer enabled by default. Instead |
266 | --no-copy-dt-needed-entries is the default. | |
267 | ||
ae17ab41 | 268 | * INPUT_SECTION_FLAGS has been added to the linker script language |
cfb8c092 | 269 | to allow selection of input sections by section header section flags. |
ae17ab41 | 270 | |
69f56ae1 | 271 | * Add support for the Tilera TILEPro and TILE-Gx architectures. |
90b3661c | 272 | |
02ecc8e9 | 273 | * Added SORT_BY_INIT_PRIORITY to the linker script language to permit |
cfb8c092 NC |
274 | sorting sections by numerical value of the GCC init_priority attribute |
275 | encoded in the section name. | |
02ecc8e9 | 276 | |
44f45767 TG |
277 | Changes in 2.21: |
278 | ||
5fec8599 L |
279 | * Linker script expression evaluation is somewhat more sane. This may |
280 | break scripts that depend on quirks of the old expression evaluation. | |
281 | ||
17f73277 KT |
282 | * Turn off underscoring for x86_64 PE+-COFF targets. For old behavior the |
283 | option --enable-leading-mingw64-underscores can be used on configure of | |
284 | bfd. | |
285 | ||
40b36596 JM |
286 | * Add support for the TMS320C6000 (TI C6X) processor family. |
287 | ||
ddbb8a31 NC |
288 | * --add-needed renamed to --copy-dt-needed-entries in order to avoid confusion |
289 | with --as-needed option. | |
290 | ||
7fcab871 KT |
291 | * Extend .def file syntax by '== <ID>' for imports and exports. This allows |
292 | to alias the import/export table name written in PE image. | |
293 | ||
a72173de | 294 | * Add --exclude-all-symbols option to PE based linkers. This prevents all |
2927aaca NC |
295 | symbols from automatically being exported. |
296 | ||
c7927a3c NC |
297 | * Add support for the Renesas RX processor. |
298 | ||
75875724 TG |
299 | * Add support for alpha-vms target. |
300 | ||
81c23f82 TG |
301 | Changes in 2.20: |
302 | ||
3e7a7d11 NC |
303 | * GNU/Linux targets now support the STB_GNU_UNIQUE symbol binding. This is a |
304 | GNU extension to the standard set of ELF symbol bindings. The binding will | |
305 | be passed on to the dynamic linker which will make sure that in the entire | |
306 | process there is just one symbol with the given name and type in use. | |
ce11ba6c | 307 | |
c1711530 DK |
308 | * PE targets now support a GNU extension to allow the alignment of common |
309 | common symbols to be specified. This support uses custom options in | |
310 | the .drectve section, which will be disregarded by the native tools. | |
311 | ||
09e2aba4 DK |
312 | * PE targets now add primitive support for ELF version scripts; symbols |
313 | are not versioned, but the local and global symbol visibility directives | |
314 | are respected when filtering symbols in auto-export mode. | |
315 | ||
267e2722 CD |
316 | * New option --no-export-dynamic to undo the effect of the -E and |
317 | --export-dynamic options. | |
318 | ||
a0c402a5 L |
319 | * ELF: --warn-alternate-em option to warn if an object has alternate |
320 | ELF machine code. | |
321 | ||
4a93e180 NC |
322 | * New script function REGION_ALIAS to add alias names to memory regions. |
323 | ||
88183869 DK |
324 | * PE targets no longer make use of the long section names PE extension to |
325 | the COFF format when generating executable images, by default. The old | |
326 | (slightly non-conformant) behaviour can still be invoked by using the | |
3efd345c DK |
327 | new '--enable-long-section-names' command-line option. It is also enabled |
328 | automatically in the presence of un-stripped debug information, as GDB | |
329 | needs to be able to find the debug info sections by their full names. | |
88183869 | 330 | |
d8045f23 NC |
331 | * For GNU/Linux systems the linker will now avoid processing any relocations |
332 | made against symbols of the STT_GNU_IFUNC type and instead emit them into | |
333 | the resulting binary for processing by the loader. | |
334 | ||
28024d9d L |
335 | * --as-needed now links in a dynamic library if it satisfies undefined |
336 | symbols in regular objects, or in other dynamic libraries. In the | |
337 | latter case the library is not linked if it is found in a DT_NEEDED | |
338 | entry of one of the libraries already linked. | |
339 | ||
a05a5b64 | 340 | * Add a new command-line option, -Ttext-segment ADDR, for ELF targets |
258795f5 L |
341 | to set the address of the first byte of the text segment. |
342 | ||
c3b7224a NC |
343 | * Add support for Sunplus score architecture. |
344 | ||
ce11ba6c KT |
345 | * Add new option --use-nul-prefixed-import-tables to ld for PE targets to |
346 | allow fallback to old import table generation with null element prefix. | |
347 | ||
e1c37eb5 DK |
348 | * Windows PE systems now support a new --exclude-modules-for-implib option, |
349 | allowing users to partition object files and archive members between a DLL | |
350 | and its associated import library as they are generated during linking. | |
351 | ||
84e94c90 NC |
352 | * Add support for Lattice Mico32 (lm32) architecture. |
353 | ||
62655c7b | 354 | * Add CR16 ELF --embedded-relocs (used to embedded relocations into binaries |
7251ccbf SR |
355 | for Embedded-PIC code) option. |
356 | ||
6cb442d3 KT |
357 | * Add to the PE/PE+ targets the support of two different kinds of |
358 | pseudo-relocations. They can be selected by the switches | |
359 | --enable-runtime-pseudo-reloc-v1 and --enable-runtime-pseudo-reloc-v2. | |
360 | For the switch --enable-runtime-pseudo-reloc it uses for 32-bit | |
361 | runtime pseudo relocation version one, for 64-bit the version two. | |
362 | ||
6e33da12 TG |
363 | Changes in 2.19: |
364 | ||
66c103b7 AM |
365 | * Linker scripts support a new INSERT command that makes it easier to |
366 | augment the default script. | |
367 | ||
967928e9 | 368 | * Linker script input section filespecs may now specify a file within an |
66c103b7 | 369 | archive by writing "archive:file". |
967928e9 | 370 | |
de7dd2bd NC |
371 | * The --sort-common switch now has an optional argument which specifies the |
372 | direction of sorting. | |
373 | ||
7fb9f789 | 374 | * The M68K linker now supports multiple GOT generation schemes controlled via |
a05a5b64 | 375 | the --got=<type> command-line option. |
7fb9f789 | 376 | |
66c103b7 AM |
377 | * The ARM EABI linker will now generate stubs for function calls to symbols |
378 | that are too far away. The placement of the stubs is controlled by a new | |
a05a5b64 | 379 | linker command-line option: --stub-group-size=N. |
726150b7 | 380 | |
7c3d153f NC |
381 | Changes in 2.18: |
382 | ||
f96b4a7b NC |
383 | * Linker sources now released under version 3 of the GNU General Public |
384 | License. | |
385 | ||
c0065db7 RM |
386 | * ELF: New --build-id option to generate a unique per-binary identifier |
387 | embedded in a note section. | |
388 | ||
3d3d428f | 389 | * Added support for National Semicondutor CompactRISC (ie CR16) target. |
a19bcec6 | 390 | |
bcb674cf RS |
391 | * -l:foo now searches the library path for a filename called foo, |
392 | without converting it to libfoo.a or libfoo.so. | |
393 | ||
a05a5b64 | 394 | * Add a new command-line option '--default-script=FILE' or '-dT FILE' |
14be8564 L |
395 | which specifies a replacement for the built in, default linker |
396 | script. | |
397 | ||
40b36307 L |
398 | * ELF: Add -Bsymbolic-functions, --dynamic-list-cpp-new, which puts C++ |
399 | operator new and delete on the dynamic list, and --dynamic-list-data, | |
400 | builtin list for --dynamic-list, which puts global data symbols on the | |
401 | dynamic list. | |
402 | ||
99ad8390 NC |
403 | * Add support for x86_64 PE+ target. |
404 | ||
1c0d3aa6 NC |
405 | * Add support for Score target. |
406 | ||
55255dae L |
407 | * ELF: Add --dynamic-list option to specify a list of global symbols |
408 | whose references shouldn't be bound to the definition within the | |
409 | shared library, or a list of symbols which should be added to the | |
410 | symbol table in the executable. | |
411 | ||
dc0b6aa0 AM |
412 | * The default output section LMA has changed for allocatable sections from |
413 | being equal to VMA, to keeping the difference between LMA and VMA the same as | |
414 | the previous output section in the same region. This is a more useful | |
415 | default when using overlays and other cases where you specify an LMA | |
416 | differing from the VMA for some sections. | |
417 | ||
c17d87de NC |
418 | * New switch: --print-gc-sections to list any sections removed by garabge |
419 | collection. | |
420 | ||
c6dd86c6 | 421 | * ARM: Added --vfp11-denorm-fix option to work around an erratum in current |
f96b4a7b | 422 | VFP11 coprocessors. |
c6dd86c6 | 423 | |
c17d87de | 424 | Changes in 2.17: |
cf88bb9f | 425 | |
d70c5fc7 NC |
426 | * Support for the Infineon XC16X has been added by KPIT Cummins Infosystems. |
427 | ||
dfcffada AM |
428 | * Modify the Linux linker search order to better match ld.so search order. |
429 | Look for DT_NEEDED libraries in paths specified by ld.so.conf before | |
430 | searching the default directories, rather than vice versa. | |
431 | Use $prefix/etc/ld.so.conf if it exists, otherwise /etc/ld.so.conf. | |
c1446dba | 432 | |
4b5bd4e7 DS |
433 | * PE-COFF: Forward exports from DLL's can now be specified in .def files |
434 | passed directly to ld. | |
435 | ||
3c9b82ba NC |
436 | * Support for the Z80 processor family has been added. |
437 | ||
3e8a519c MM |
438 | * Add support for the "@<file>" syntax to the command line, so that extra |
439 | switches can be read from <file>. | |
440 | ||
957d91c1 NC |
441 | Changes in 2.16: |
442 | ||
319850b4 JB |
443 | * Support for the R_ARM_V4BX relocation as defined in the ARM AAELF |
444 | specification has been added via the --fix-v4bx command-line option. | |
445 | ||
b717d30e JJ |
446 | * New linker script construct AS_NEEDED(), which sets the --as-needed flag |
447 | for input files listed inside of it. | |
448 | ||
e2243057 RS |
449 | * A new command-line option, --sysroot, can be used to override the |
450 | default sysroot location. It only applies to toolchains that were | |
451 | configured using --with-sysroot. | |
452 | ||
3ec57632 NC |
453 | * New linker script functions: ORIGIN() and LENGTH() which return information |
454 | about a specified memory region. | |
455 | ||
7499d566 NC |
456 | * Port to MAXQ processor contributed by HCL Tech. |
457 | ||
ba916c8a MM |
458 | * Added SEGMENT_START to the linker script language to permit the user to |
459 | override the base address for a segment from the command-line. | |
460 | ||
8fdd7217 NC |
461 | * ELF: --warn-shared-textrel option to warn if adding a DT_TEXTREL to a shared |
462 | object. | |
463 | ||
bcaa7b3e L |
464 | * Added SORT_BY_NAME and SORT_BY_ALIGNMENT to the linker script |
465 | language to permit sorting sections by section name or section | |
466 | maximum alignment. | |
467 | ||
a05a5b64 | 468 | * Added a new linker command-line switch, --sort-section name|alignment, |
bcaa7b3e L |
469 | to sort sections by section name or maximum alignment. |
470 | ||
8fdd7217 NC |
471 | * ELF: --add-needed/--no-add-needed options to control if a DT_NEEDED tag |
472 | should be added when a shared library comes from DT_NEEDED tags. | |
14b3c463 | 473 | |
1fe1f39c NC |
474 | * Support for the crx-elf target added. |
475 | ||
1a320fbb | 476 | * Support for the sh-symbianelf target added. |
1fe1f39c | 477 | |
a05a5b64 | 478 | * A new linker command-line switch has been added which allows the hash table |
2d643429 NC |
479 | size to be set to a suitable prime value near to its argument. This switch |
480 | is --hash-size=<NUMBER>. Also if the switch --reduce-memory-overheads is | |
481 | used, and --hash-size has not been used, then the default value will be set | |
482 | to 1021. | |
483 | ||
35835446 JR |
484 | * Linker map files are now generated with an O(N) algorithm for finding symbols |
485 | that are defined in each section. This uses about 40% more memory for | |
486 | symbols than the old O(N^2) algorithm. You can use the new | |
487 | --reduce-memory-overheads option to select the old algorithm; this option | |
488 | might also be used in the future to select similar tradeoffs. | |
489 | ||
2d643429 | 490 | Changes in 2.15: |
14b3c463 | 491 | |
8fdd7217 NC |
492 | * ELF: --as-needed/--no-as-needed options to control if a DT_NEEDED tag should |
493 | be added only when a shared library is referenced. | |
c0065db7 | 494 | |
8fdd7217 | 495 | * PE: --large-address-aware option to indicate executables support virtual |
26d2d8a2 BF |
496 | addresses greater than 2 gigabytes. |
497 | ||
1b169501 BF |
498 | * DWARF 2 support for i386pe added. |
499 | ||
c894ddfb HPN |
500 | * The linker script operator DEFINED() will now yield 1 only for a symbol that |
501 | is defined before the statement where DEFINED is used. | |
502 | ||
7a7f4e42 CD |
503 | * The MIPS --embedded-relocs (used to embed relocations into binaries for |
504 | Embedded-PIC code) is deprecated and will be removed in a future release. | |
505 | ||
0949843d NC |
506 | * cr16c support added by NSC. |
507 | ||
6edf0760 NC |
508 | * m32r Linux (ELF) support added by Renesas. |
509 | ||
560e09e9 NC |
510 | * Improved linker's handling of unresolved symbols. The switch |
511 | --unresolved-symbols=<method> has been added to tell the linker when it | |
512 | should report them and the switch --warn-unresolved-symbols has been added to | |
513 | make reports be issued as warning messages rather than errors. | |
514 | ||
43c58ae6 CD |
515 | Changes in 2.14: |
516 | ||
e8fd7476 NC |
517 | * Added support for Xtensa architecture. |
518 | ||
9c8ebd6a DJ |
519 | * Added --with-sysroot configure switch to specify a target system root, for |
520 | linking against a target filesystem image. | |
521 | ||
312b768e NC |
522 | * Added --accept-unknown-linker-format to restore old linker behaviour (pre |
523 | 2.14) of silently accepting and linking in any files in an unknown binary | |
524 | file format. | |
525 | ||
63fd3b82 NC |
526 | * Added --no-omagic to undo the effects of the -N option. |
527 | ||
004d9caf NC |
528 | * Support for Texas Instruments TMS320C4x and TMS320C3x series of |
529 | DSP's contributed by Michael Hayes and Svein E. Seldal. | |
c0065db7 | 530 | |
8e523c23 NC |
531 | * Added --with-lib-path configure switch to specify default value for |
532 | LIB_PATH. | |
533 | ||
7e392df6 NC |
534 | * ARM port to QNX operating system added by Graeme Peterson. |
535 | ||
cf88bb9f NC |
536 | * IP2K support added by Denis Chertykov. |
537 | ||
2cbb2eef NC |
538 | Changes in 2.13: |
539 | ||
540 | * Support for the Fujitsu FRV architecture added by Red Hat. Models for FR400 | |
541 | and FR500 included. | |
7d553a40 | 542 | |
37020578 JT |
543 | Changes in version 2.13: |
544 | ||
545 | * DEC VAX ELF support, by Matt Thomas. | |
546 | ||
9a66911f NC |
547 | Changes in version 2.12: |
548 | ||
49fda6c8 HPN |
549 | * Support for Don Knuth's MMIX, by Hans-Peter Nilsson. |
550 | ||
3b16e843 NC |
551 | * Support for the OpenRISC 32-bit embedded processor by OpenCores. |
552 | ||
8bd621d8 AM |
553 | * Support for -z nocopyreloc in the x86 ELF linker, which disables |
554 | production of copy relocs. Warning: using this option may result in | |
555 | non-sharable applications. | |
5b343f5a | 556 | |
db6751f2 JJ |
557 | * Support for -z combreloc in the ELF linker, which puts dynamic |
558 | relocations against the same symbol together, so that dynamic linker | |
559 | can use an one-entry symbol lookup cache. | |
560 | ||
561 | * Support for ELF SHF_MERGE section merging, by Jakub Jelinek. | |
562 | ||
9a66911f NC |
563 | Changes in version 2.11: |
564 | ||
b8355149 JH |
565 | * Support for AMD x86-64 architecture, by Jan Hubicka, SuSE Labs. |
566 | ||
18e03609 NC |
567 | * Support added for eliminating duplicate DWARF2 debug information by |
568 | having the compiler generate the information in sections called | |
569 | .gnu.linkonce.wi.XXXX where XXXX is a checksum for the contents. The | |
570 | linker then merges these sections together into the normal .debug_info | |
571 | section. | |
252b5132 | 572 | |
ec4eb78a L |
573 | * The native ELF linker now searches the directories in DT_RUNPATH or |
574 | DT_RPATH of a shared library for shared libraries needed by it. | |
575 | ||
2d30b3da TW |
576 | * TI C54x support, by Timothy Wall. |
577 | ||
a05a5b64 | 578 | * Added command-line switch --section-start to set the start address of any |
c0065db7 | 579 | specified section. |
176355da | 580 | |
a712da20 NC |
581 | * Added ability to emit full relocation information in linked executables, |
582 | enabled by --emit-relocs. Some post-linkage optimization tools need | |
583 | this information in order to be able to correctly identify and perform | |
584 | symbol relative addressing in the event of changes in section contents | |
585 | (instructions being added or deleted, extending data sections, etc.) | |
586 | ||
22b36938 JE |
587 | * Support for i860, by Jason Eckhardt (preliminary, alpha quality). |
588 | ||
5bcac8a4 HPN |
589 | * Support for CRIS (Axis Communications ETRAX series). |
590 | ||
500800ca NC |
591 | * Support for PDP-11 and 2.11BSD a.out format, by Lars Brinkhoff. |
592 | ||
919e4093 AM |
593 | Changes in version 2.10: |
594 | ||
c0065db7 | 595 | * Added AT> to the linker script language to allow load-time allocation of |
5948916f TW |
596 | sections into regions. |
597 | ||
c0065db7 | 598 | * Added garbage collection of unused sections, enabled by --gc-sections. |
252b5132 | 599 | It does require a bit of backend support; currently implemented are |
4667035e AM |
600 | arm-elf, avr-elf, d10v-elf, fr30-elf, i386-elf, m32r-elf, m68k-elf, |
601 | mcore-elf, mips-elf, mn10300-elf, ppc-elf, sh-elf, sparc-elf, and v850-elf. | |
987fd5b4 | 602 | Others will ignore the option. |
252b5132 RH |
603 | |
604 | * Added SORT to the linker script language to permit sorting sections by file | |
605 | name or section name. | |
606 | ||
607 | * Added EXTERN to the linker script language as an equivalent to the -u | |
608 | command-line option. | |
609 | ||
610 | * Added ASSERT to the linker script language. | |
611 | ||
277c9afe ILT |
612 | * Added EXCLUDE_FILE to the linker script language for further control over |
613 | wildcard file names. | |
614 | ||
252b5132 | 615 | * Added -O option to optimize linker output (as of this writing, this only |
500800ca | 616 | affects ELF shared library generation). |
252b5132 RH |
617 | |
618 | * The -e option now accepts a number as well as a symbol name. | |
619 | ||
2575273d ILT |
620 | * Added --no-undefined option to disallow undefined symbols when creating a |
621 | shared library. | |
622 | ||
9b1d3b78 ILT |
623 | * The linker now issues a warning, not an error, for an undefined symbol when |
624 | using -Bsymbolic; use the new --no-undefined option to get the old | |
625 | behaviour. | |
626 | ||
252b5132 RH |
627 | * Added --demangle and --no-demangle options. |
628 | ||
629 | Changes in version 2.9: | |
630 | ||
631 | * Added SQUAD to the linker script language. | |
632 | ||
633 | * New option --no-warn-mismatch. | |
634 | ||
635 | * The MEMORY command now parses the attributes to determine where sections that | |
636 | are not placed in a specific memory region are placed. | |
637 | ||
638 | Changes in version 2.8: | |
639 | ||
640 | * Linker scripts may now contain shell wildcard characters for file and section | |
641 | names. | |
642 | ||
643 | * The linker now supports symbol versions in ELF. | |
644 | ||
645 | * The NOCROSSREFS command was added to the linker script language. | |
646 | ||
647 | * The LOADADDR expression was added to the linker script language. | |
648 | ||
649 | * MAX and MIN functions were added to the linker script language. | |
650 | ||
651 | * The OVERLAY construct was added to the linker script language. | |
652 | ||
653 | * New option --warn-section-align to warn when the address of an output section | |
654 | changes due to alignment of an input section. | |
655 | ||
656 | * New options --filter/-F and --auxiliary/-f. | |
657 | ||
658 | Changes in version 2.7: | |
659 | ||
660 | * New option --cref to print out a cross reference table. | |
661 | ||
662 | * New option --wrap SYMBOL. | |
663 | ||
664 | * New option --no-whole-archive, to turn off the effect of --whole-archive. | |
665 | ||
666 | * Input sections assigned to the output section /DISCARD/ in the linker script | |
667 | are not included in the output file. | |
668 | ||
669 | * The SunOS and ELF linkers now merge stabs debugging information which uses | |
670 | the N_BINCL and N_EINCL stab types. This reduces the amount of debugging | |
671 | information generated. | |
672 | ||
673 | Changes in version 2.6: | |
674 | ||
675 | * When an ELF section name is representable as a C identifier (this is not true | |
45f111cc NC |
676 | of most ELF section names), the linker will automatically define symbols |
677 | __start_SECNAME and __stop_SECNAME, where SECNAME is the section name, at the | |
678 | beginning and the end of the section. This is used by glibc. | |
679 | ||
680 | Addendum: Current versions of the linker (at least for version 2.18 onwards | |
681 | and possibly much earlier as well) place two restrictions on this feature: The | |
682 | symbols are only implemented for orphaned sections, not for explicitly placed | |
683 | sections and they are PROVIDEd rather than being defined. | |
252b5132 RH |
684 | |
685 | * When an ELF section named .gnu.warning is encountered in an input file, the | |
686 | contents of the section are displayed as an error message, and the section is | |
687 | not copied into the output file. This is used by glibc. | |
688 | ||
689 | * When an ELF section named .gnu.warning.SYMBOL is encountered in an input | |
690 | file, and the symbol SYMBOL is referenced by some object file, the contents of | |
691 | the section are displayed as an error message. The section is not copied into | |
1049f94e | 692 | the output file, unless doing a relocatable or shared link. This is used by |
252b5132 RH |
693 | glibc. |
694 | ||
695 | * New options -split-by-reloc and -split-by-file. | |
696 | ||
697 | * The linker now supports linking PIC compiled code on SPARC SunOS. It can | |
698 | also create SPARC SunOS shared libraries, and, like the native SunOS linker, | |
699 | will do so whenever there is an undefined symbol in the link and neither the -e | |
700 | nor the -r option was used. | |
701 | ||
702 | * The -rpath option may be used on SunOS to set the list of directories to be | |
703 | searched at run time. This overrides the default of building the list from the | |
704 | -L options. | |
705 | ||
706 | * The COFF linker now combines debugging information for structs, unions, and | |
707 | enums, so that even if the same type is defined in multiple input files it will | |
708 | only be defined once in the output file. The --traditional-format switch will | |
709 | prevent this optimization. | |
710 | ||
711 | Changes in version 2.5: | |
712 | ||
713 | * The linker now supports linking against SunOS shared libraries. It still can | |
714 | not link SunOS PIC (Position Independent Code) files, so it can not be used to | |
07f3b6ad | 715 | generate shared libraries. |
252b5132 RH |
716 | |
717 | * The linker now supports linking against ELF shared libraries for the i386 | |
718 | (UnixWare) and SPARC (Solaris). It can also link ELF PIC files, and can be | |
719 | used to generate shared libraries. Shared library generation is not well | |
720 | tested; please report any problems encountered. The linker is now enabled for | |
721 | Solaris again. | |
722 | ||
723 | * Eric Youngdale has contributed Linux support code, including linking against | |
724 | Linux a.out shared libraries. The linker produces Linux QMAGIC binaries. | |
725 | ||
726 | * The ELF backend has been converted to the new linker code. To use the new | |
727 | ELF linker, each particular target requires a relocation function. So far, | |
728 | this function has been written for i386 (UnixWare), SPARC (Solaris) MIPS (Irix | |
729 | 5), and HPPA ELF targets. | |
730 | ||
731 | * The -( (--start-group) and -) (--end-group) options have been added to | |
732 | support searching a group of archives as though they were a single archive. | |
733 | This can also be used in a linker script, as GROUP ( files ). | |
734 | ||
735 | * When a file is named on the command line, and the linker does not recognize | |
736 | it as an object file, the linker will now treat the file as a linker script | |
737 | file. A linker script named in this way augments, but does not replace, the | |
738 | default linker script. | |
739 | ||
740 | * The -warn-once option was added. It causes the linker to only warn once per | |
741 | undefined symbol, rather than once per reference. | |
742 | ||
743 | * The COFF backend has been converted to the new linker code. As with ELF, to | |
744 | use the new linker, each particular target requires a relocation function. So | |
745 | far, this function has been written for the i386, m68k, a29k and SH targets. | |
746 | ||
747 | * The -V flag was made a synonym for -v, for SVR4 compatibility. The old -V | |
748 | behaviour is available via --verbose. | |
749 | ||
750 | Changes in version 2.4: | |
751 | ||
752 | * New linker code, by Steve Chamberlain and Ian Taylor. For a.out and ecoff | |
753 | formats (so far), this should result in considerable savings in time | |
754 | and memory used while linking; slightly poorer performance than | |
755 | before for formats not converted yet. | |
756 | ||
757 | * Command-line parsing is no longer done with flex. This means | |
758 | oddball characters in filenames won't get treated as argument | |
759 | separators. | |
760 | ||
761 | * HP-PA ELF support, by Jeff Law. (No SOM support yet.) | |
762 | ||
763 | * Mach i386 support, by David Mackenzie. | |
764 | ||
765 | * Irix 4 shared libraries are now supported (Irix 5 uses ELF, and ELF shared | |
766 | libraries are not yet supported). | |
767 | ||
768 | * COFF shared libraries (as on SCO) should work as well. | |
769 | ||
770 | * The linker is disabled for Solaris. (Actually, it was in 2.3 also, I just | |
771 | forgot to note it.) Some of their C library routines don't work when | |
772 | statically linked, and the GNU linker doesn't support dynamic linking yet. | |
773 | ||
774 | Changes in version 2.3: | |
775 | ||
776 | * Weak symbols are now supported. | |
777 | ||
778 | * ELF support has been added. The linker has been bootstrapped on | |
779 | UnixWare and Solaris. | |
780 | ||
781 | * Alpha OSF/1 support has been added (non dynamic linking only). | |
782 | ||
783 | Changes in version 2.2: | |
784 | ||
785 | * The `bfd' library has been updated to reduce a.out-format string | |
786 | table size. The effect of this is that files linked from many input | |
787 | files with duplicate symbols (`-g' debugging records, or identical | |
788 | static symbols) should be much smaller. | |
789 | ||
790 | Changes in version 2.1: | |
791 | ||
792 | * The ld -ySYMBOL flag (to trace references to SYMBOL) is now implemented. | |
793 | ||
794 | * There is now support for writing ECOFF files, so ld and the | |
795 | other utilities should work on Risc/Ultrix and Irix. | |
796 | ||
797 | \f | |
b3adc24a | 798 | Copyright (C) 2012-2020 Free Software Foundation, Inc. |
5bf135a7 NC |
799 | |
800 | Copying and distribution of this file, with or without modification, | |
801 | are permitted in any medium without royalty provided the copyright | |
802 | notice and this notice are preserved. | |
803 | ||
252b5132 RH |
804 | Local variables: |
805 | fill-column: 79 | |
806 | End: |