ld/NEWS

   1 -*- text -*-
   2
   3 * Add a configure option --enable-compressed-debug-sections={all,ld} to
   4   decide whether DWARF debug sections should be compressed by default.
   5
   6 * Add support for the ARC EM/HS, and ARC600/700 architectures.
   7
   8 * Experimental support for linker garbage collection (--gc-sections)
   9   has been enabled for COFF and PE based targets.
  10
  11 * New command line option for ELF targets to compress DWARF debug
  12   sections, --compress-debug-sections=[none|zlib|zlib-gnu|zlib-gabi].
  13
  14 * New command line option, --orphan-handling=[place|warn|error|discard], to
  15   adjust how orphan sections are handled.  The default is 'place' which gives
  16   the current behaviour, 'warn' and 'error' issue a warning or error
  17   respectively when orphan sections are found, and 'discard' will discard all
  18   orphan sections.
  19
  20 * Add support for LLVM plugin.
  21
  22 * Add --print-memory-usage option to report memory blocks usage.
  23
  24 * Add --require-defined option, it's like --undefined except the new symbol
  25   must be defined by the end of the link.
  26
  27 Changes in 2.25:
  28
  29 * PE binaries now once again contain real timestamps by default.  To disable
  30   the inclusion of a timestamp in a PE binary, use the --no-insert-timestamp
  31   command line option.
  32
  33 * Replace support for openrisc and or32 with support for or1k.
  34
  35 * Add support for the --build-id command line option to COFF based targets.
  36
  37 * x86/x86_64 pe-coff now supports the --build-id option.
  38
  39 * Add support for the Andes NDS32.
  40
  41 Changes in 2.24:
  42
  43 * Add LOG2CEIL() builtin function to the linker script language
  44
  45 * Add support for the Texas Instruments MSP430X processor.
  46
  47 * Add support for Altera Nios II.
  48
  49 * Add support for the V850E3V5 architecture.
  50
  51 * Add support for the Imagination Technologies Meta processor.
  52
  53 * --enable-new-dtags no longer generates old dtags in addition to new dtags.
  54
  55 * Remove linker support for MIPS ECOFF targets.
  56
  57 * Add ALIGN_WITH_INPUT to the linker script language to force the alignment of
  58   an output section to use the maximum alignment of all its input sections.
  59
  60 Changes in 2.23:
  61
  62 * Enable compressed debug section feature for x86/x86_64 pe-coff.
  63
  64 * Add support for the 64-bit ARM architecture: AArch64.
  65
  66 * Added SORT_NONE to the linker script language to disable section sorting.
  67
  68 * Add a linker-provided symbol when producing ELF output, '__ehdr_start'
  69   to point to the ELF file header (and nearby program headers) in the
  70   program's memory image.
  71
  72 * Add support for S12X processor.
  73
  74 * Add support for the VLE extension to the PowerPC architecture.
  75
  76 * Add support for the Freescale XGATE architecture.
  77
  78 * Add option -f FILE on AIX (for response file).
  79
  80 * Add support for the Renesas RL78 architecture.
  81
  82 * Add support for the Adapteva EPIPHANY architecture.
  83
  84 Changes in 2.22:
  85
  86 * --copy-dt-needed-entries is no longer enabled by default.  Instead
  87   --no-copy-dt-needed-entries is the default.
  88
  89 * INPUT_SECTION_FLAGS has been added to the linker script language
  90   to allow selection of input sections by section header section flags.
  91
  92 * Add support for the Tilera TILEPro and TILE-Gx architectures.
  93
  94 * Added SORT_BY_INIT_PRIORITY to the linker script language to permit
  95   sorting sections by numerical value of the GCC init_priority attribute
  96   encoded in the section name.
  97
  98 Changes in 2.21:
  99
 100 * Linker script expression evaluation is somewhat more sane.  This may
 101   break scripts that depend on quirks of the old expression evaluation.
 102
 103 * Turn off underscoring for x86_64 PE+-COFF targets.  For old behavior the
 104   option --enable-leading-mingw64-underscores can be used on configure of
 105   bfd.
 106
 107 * Add support for the TMS320C6000 (TI C6X) processor family.
 108
 109 * --add-needed renamed to --copy-dt-needed-entries in order to avoid confusion
 110   with --as-needed option.
 111
 112 * Extend .def file syntax by '== <ID>' for imports and exports. This allows
 113   to alias the import/export table name written in PE image.
 114
 115 * Add --exclude-all-symbols option to PE based linkers.  This prevents all
 116   symbols from automatically being exported.
 117
 118 * Add support for the Renesas RX processor.
 119
 120 * Add support for alpha-vms target.
 121
 122 Changes in 2.20:
 123
 124 * GNU/Linux targets now support the STB_GNU_UNIQUE symbol binding.  This is a
 125   GNU extension to the standard set of ELF symbol bindings.  The binding will
 126   be passed on to the dynamic linker which will make sure that in the entire
 127   process there is just one symbol with the given name and type in use.
 128
 129 * PE targets now support a GNU extension to allow the alignment of common
 130   common symbols to be specified.  This support uses custom options in
 131   the .drectve section, which will be disregarded by the native tools.
 132
 133 * PE targets now add primitive support for ELF version scripts; symbols
 134   are not versioned, but the local and global symbol visibility directives
 135   are respected when filtering symbols in auto-export mode.
 136
 137 * New option --no-export-dynamic to undo the effect of the -E and
 138   --export-dynamic options.
 139
 140 * ELF: --warn-alternate-em option to warn if an object has alternate
 141   ELF machine code.
 142
 143 * New script function REGION_ALIAS to add alias names to memory regions.
 144
 145 * PE targets no longer make use of the long section names PE extension to
 146   the COFF format when generating executable images, by default.  The old
 147   (slightly non-conformant) behaviour can still be invoked by using the
 148   new '--enable-long-section-names' command-line option.  It is also enabled
 149   automatically in the presence of un-stripped debug information, as GDB
 150   needs to be able to find the debug info sections by their full names.
 151
 152 * For GNU/Linux systems the linker will now avoid processing any relocations
 153   made against symbols of the STT_GNU_IFUNC type and instead emit them into
 154   the resulting binary for processing by the loader.
 155
 156 * --as-needed now links in a dynamic library if it satisfies undefined
 157   symbols in regular objects, or in other dynamic libraries.  In the
 158   latter case the library is not linked if it is found in a DT_NEEDED
 159   entry of one of the libraries already linked.
 160
 161 * Add a new command line option, -Ttext-segment ADDR, for ELF targets
 162   to set the address of the first byte of the text segment.
 163
 164 * Add support for Sunplus score architecture.
 165
 166 * Add new option --use-nul-prefixed-import-tables to ld for PE targets to
 167   allow fallback to old import table generation with null element prefix.
 168
 169 * Windows PE systems now support a new --exclude-modules-for-implib option,
 170   allowing users to partition object files and archive members between a DLL
 171   and its associated import library as they are generated during linking.
 172
 173 * Add support for Lattice Mico32 (lm32) architecture.
 174
 175 * Add CR16 ELF --embedded-relocs (used to embedded relocations into binaries
 176   for Embedded-PIC code) option.
 177
 178 * Add to the PE/PE+ targets the support of two different kinds of
 179   pseudo-relocations.  They can be selected by the switches
 180   --enable-runtime-pseudo-reloc-v1 and --enable-runtime-pseudo-reloc-v2.
 181   For the switch --enable-runtime-pseudo-reloc it uses for 32-bit
 182   runtime pseudo relocation version one, for 64-bit the version two.
 183
 184 Changes in 2.19:
 185
 186 * Linker scripts support a new INSERT command that makes it easier to
 187   augment the default script.
 188
 189 * Linker script input section filespecs may now specify a file within an
 190   archive by writing "archive:file".
 191
 192 * The --sort-common switch now has an optional argument which specifies the
 193   direction of sorting.
 194
 195 * The M68K linker now supports multiple GOT generation schemes controlled via
 196   the --got=<type> command line option.
 197
 198 * The ARM EABI linker will now generate stubs for function calls to symbols
 199   that are too far away.  The placement of the stubs is controlled by a new
 200   linker command line option: --stub-group-size=N.
 201
 202 Changes in 2.18:
 203
 204 * Linker sources now released under version 3 of the GNU General Public
 205   License.
 206
 207 * ELF: New --build-id option to generate a unique per-binary identifier
 208   embedded in a note section.
 209
 210 * Added support for National Semicondutor CompactRISC (ie CR16) target.
 211
 212 * -l:foo now searches the library path for a filename called foo,
 213   without converting it to libfoo.a or libfoo.so.
 214
 215 * Add a new command line option '--default-script=FILE' or '-dT FILE'
 216   which specifies a replacement for the built in, default linker
 217   script.
 218
 219 * ELF: Add -Bsymbolic-functions, --dynamic-list-cpp-new, which puts C++
 220   operator new and delete on the dynamic list, and --dynamic-list-data,
 221   builtin list for --dynamic-list, which puts global data symbols on the
 222   dynamic list.
 223
 224 * Add support for x86_64 PE+ target.
 225
 226 * Add support for Score target.
 227
 228 * ELF: Add --dynamic-list option to specify a list of global symbols
 229   whose references shouldn't be bound to the definition within the
 230   shared library, or a list of symbols which should be added to the
 231   symbol table in the executable.
 232
 233 * The default output section LMA has changed for allocatable sections from
 234   being equal to VMA, to keeping the difference between LMA and VMA the same as
 235   the previous output section in the same region.  This is a more useful
 236   default when using overlays and other cases where you specify an LMA
 237   differing from the VMA for some sections.
 238
 239 * New switch: --print-gc-sections to list any sections removed by garabge
 240   collection.
 241
 242 * ARM: Added --vfp11-denorm-fix option to work around an erratum in current
 243   VFP11 coprocessors.
 244
 245 Changes in 2.17:
 246
 247 * Support for the Infineon XC16X has been added by KPIT Cummins Infosystems.
 248
 249 * Modify the Linux linker search order to better match ld.so search order.
 250   Look for DT_NEEDED libraries in paths specified by ld.so.conf before
 251   searching the default directories, rather than vice versa.
 252   Use $prefix/etc/ld.so.conf if it exists, otherwise /etc/ld.so.conf.
 253
 254 * PE-COFF: Forward exports from DLL's can now be specified in .def files
 255   passed directly to ld.
 256
 257 * Support for the Z80 processor family has been added.
 258
 259 * Add support for the "@<file>" syntax to the command line, so that extra
 260   switches can be read from <file>.
 261
 262 Changes in 2.16:
 263
 264 * Support for the R_ARM_V4BX relocation as defined in the ARM AAELF
 265   specification has been added via the --fix-v4bx command-line option.
 266
 267 * New linker script construct AS_NEEDED(), which sets the --as-needed flag
 268   for input files listed inside of it.
 269
 270 * A new command-line option, --sysroot, can be used to override the
 271   default sysroot location.  It only applies to toolchains that were
 272   configured using --with-sysroot.
 273
 274 * New linker script functions: ORIGIN() and LENGTH() which return information
 275   about a specified memory region.
 276
 277 * Port to MAXQ processor contributed by HCL Tech.
 278
 279 * Added SEGMENT_START to the linker script language to permit the user to
 280   override the base address for a segment from the command-line.
 281
 282 * ELF: --warn-shared-textrel option to warn if adding a DT_TEXTREL to a shared
 283   object.
 284
 285 * Added SORT_BY_NAME and SORT_BY_ALIGNMENT to the linker script
 286   language to permit sorting sections by section name or section
 287   maximum alignment.
 288
 289 * Added a new linker command line switch, --sort-section name|alignment,
 290   to sort sections by section name or maximum alignment.
 291
 292 * ELF: --add-needed/--no-add-needed options to control if a DT_NEEDED tag
 293   should be added when a shared library comes from DT_NEEDED tags.
 294
 295 * Support for the crx-elf target added.
 296
 297 * Support for the sh-symbianelf target added.
 298
 299 * A new linker command line switch has been added which allows the hash table
 300   size to be set to a suitable prime value near to its argument.  This switch
 301   is --hash-size=<NUMBER>.  Also if the switch --reduce-memory-overheads is
 302   used, and --hash-size has not been used, then the default value will be set
 303   to 1021.
 304
 305 * Linker map files are now generated with an O(N) algorithm for finding symbols
 306   that are defined in each section.  This uses about 40% more memory for
 307   symbols than the old O(N^2) algorithm.  You can use the new
 308   --reduce-memory-overheads option to select the old algorithm; this option
 309   might also be used in the future to select similar tradeoffs.
 310
 311 Changes in 2.15:
 312
 313 * ELF: --as-needed/--no-as-needed options to control if a DT_NEEDED tag should
 314   be added only when a shared library is referenced.
 315
 316 * PE: --large-address-aware option to indicate executables support virtual
 317   addresses greater than 2 gigabytes.
 318
 319 * DWARF 2 support for i386pe added.
 320
 321 * The linker script operator DEFINED() will now yield 1 only for a symbol that
 322   is defined before the statement where DEFINED is used.
 323
 324 * The MIPS --embedded-relocs (used to embed relocations into binaries for
 325   Embedded-PIC code) is deprecated and will be removed in a future release.
 326
 327 * cr16c support added by NSC.
 328
 329 * m32r Linux (ELF) support added by Renesas.
 330
 331 * Improved linker's handling of unresolved symbols.  The switch
 332   --unresolved-symbols=<method> has been added to tell the linker when it
 333   should report them and the switch --warn-unresolved-symbols has been added to
 334   make reports be issued as warning messages rather than errors.
 335
 336 Changes in 2.14:
 337
 338 * Added support for Xtensa architecture.
 339
 340 * Added --with-sysroot configure switch to specify a target system root, for
 341   linking against a target filesystem image.
 342
 343 * Added --accept-unknown-linker-format to restore old linker behaviour (pre
 344   2.14) of silently accepting and linking in any files in an unknown binary
 345   file format.
 346
 347 * Added --no-omagic to undo the effects of the -N option.
 348
 349 * Support for Texas Instruments TMS320C4x and TMS320C3x series of
 350   DSP's contributed by Michael Hayes and Svein E. Seldal.
 351
 352 * Added --with-lib-path configure switch to specify default value for
 353   LIB_PATH.
 354
 355 * ARM port to QNX operating system added by Graeme Peterson.
 356
 357 * IP2K support added by Denis Chertykov.
 358
 359 Changes in 2.13:
 360
 361 * Support for the Fujitsu FRV architecture added by Red Hat. Models for FR400
 362   and FR500 included.
 363
 364 Changes in version 2.13:
 365
 366 * DEC VAX ELF support, by Matt Thomas.
 367
 368 Changes in version 2.12:
 369
 370 * Support for Don Knuth's MMIX, by Hans-Peter Nilsson.
 371
 372 * Support for the OpenRISC 32-bit embedded processor by OpenCores.
 373
 374 * Support for -z nocopyreloc in the x86 ELF linker, which disables
 375   production of copy relocs.  Warning: using this option may result in
 376   non-sharable applications.
 377
 378 * Support for -z combreloc in the ELF linker, which puts dynamic
 379   relocations against the same symbol together, so that dynamic linker
 380   can use an one-entry symbol lookup cache.
 381
 382 * Support for ELF SHF_MERGE section merging, by Jakub Jelinek.
 383
 384 Changes in version 2.11:
 385
 386 * Support for AMD x86-64 architecture, by Jan Hubicka, SuSE Labs.
 387
 388 * Support added for eliminating duplicate DWARF2 debug information by
 389   having the compiler generate the information in sections called
 390   .gnu.linkonce.wi.XXXX where XXXX is a checksum for the contents.  The
 391   linker then merges these sections together into the normal .debug_info
 392   section.
 393
 394 * The native ELF linker now searches the directories in DT_RUNPATH or
 395   DT_RPATH of a shared library for shared libraries needed by it.
 396
 397 * TI C54x support, by Timothy Wall.
 398
 399 * Added command line switch --section-start to set the start address of any
 400   specified section.
 401
 402 * Added ability to emit full relocation information in linked executables,
 403   enabled by --emit-relocs.  Some post-linkage optimization tools need
 404   this information in order to be able to correctly identify and perform
 405   symbol relative addressing in the event of changes in section contents
 406   (instructions being added or deleted, extending data sections, etc.)
 407
 408 * Support for i860, by Jason Eckhardt (preliminary, alpha quality).
 409
 410 * Support for CRIS (Axis Communications ETRAX series).
 411
 412 * Support for PDP-11 and 2.11BSD a.out format, by Lars Brinkhoff.
 413
 414 Changes in version 2.10:
 415
 416 * Added AT> to the linker script language to allow load-time allocation of
 417   sections into regions.
 418
 419 * Added garbage collection of unused sections, enabled by --gc-sections.
 420   It does require a bit of backend support; currently implemented are
 421   arm-elf, avr-elf, d10v-elf, fr30-elf, i386-elf, m32r-elf, m68k-elf,
 422   mcore-elf, mips-elf, mn10300-elf, ppc-elf, sh-elf, sparc-elf, and v850-elf.
 423   Others will ignore the option.
 424
 425 * Added SORT to the linker script language to permit sorting sections by file
 426   name or section name.
 427
 428 * Added EXTERN to the linker script language as an equivalent to the -u
 429   command-line option.
 430
 431 * Added ASSERT to the linker script language.
 432
 433 * Added EXCLUDE_FILE to the linker script language for further control over
 434   wildcard file names.
 435
 436 * Added -O option to optimize linker output (as of this writing, this only
 437   affects ELF shared library generation).
 438
 439 * The -e option now accepts a number as well as a symbol name.
 440
 441 * Added --no-undefined option to disallow undefined symbols when creating a
 442   shared library.
 443
 444 * The linker now issues a warning, not an error, for an undefined symbol when
 445   using -Bsymbolic; use the new --no-undefined option to get the old
 446   behaviour.
 447
 448 * Added --demangle and --no-demangle options.
 449
 450 Changes in version 2.9:
 451
 452 * Added SQUAD to the linker script language.
 453
 454 * New option --no-warn-mismatch.
 455
 456 * The MEMORY command now parses the attributes to determine where sections that
 457   are not placed in a specific memory region are placed.
 458
 459 Changes in version 2.8:
 460
 461 * Linker scripts may now contain shell wildcard characters for file and section
 462   names.
 463
 464 * The linker now supports symbol versions in ELF.
 465
 466 * The NOCROSSREFS command was added to the linker script language.
 467
 468 * The LOADADDR expression was added to the linker script language.
 469
 470 * MAX and MIN functions were added to the linker script language.
 471
 472 * The OVERLAY construct was added to the linker script language.
 473
 474 * New option --warn-section-align to warn when the address of an output section
 475   changes due to alignment of an input section.
 476
 477 * New options --filter/-F and --auxiliary/-f.
 478
 479 Changes in version 2.7:
 480
 481 * New option --cref to print out a cross reference table.
 482
 483 * New option --wrap SYMBOL.
 484
 485 * New option --no-whole-archive, to turn off the effect of --whole-archive.
 486
 487 * Input sections assigned to the output section /DISCARD/ in the linker script
 488   are not included in the output file.
 489
 490 * The SunOS and ELF linkers now merge stabs debugging information which uses
 491   the N_BINCL and N_EINCL stab types.  This reduces the amount of debugging
 492   information generated.
 493
 494 Changes in version 2.6:
 495
 496 * When an ELF section name is representable as a C identifier (this is not true
 497 of most ELF section names), the linker will automatically define symbols
 498 __start_SECNAME and __stop_SECNAME, where SECNAME is the section name, at the
 499 beginning and the end of the section.  This is used by glibc.
 500
 501   Addendum: Current versions of the linker (at least for version 2.18 onwards
 502 and possibly much earlier as well) place two restrictions on this feature:  The
 503 symbols are only implemented for orphaned sections, not for explicitly placed
 504 sections and they are PROVIDEd rather than being defined.
 505
 506 * When an ELF section named .gnu.warning is encountered in an input file, the
 507 contents of the section are displayed as an error message, and the section is
 508 not copied into the output file.  This is used by glibc.
 509
 510 * When an ELF section named .gnu.warning.SYMBOL is encountered in an input
 511 file, and the symbol SYMBOL is referenced by some object file, the contents of
 512 the section are displayed as an error message.  The section is not copied into
 513 the output file, unless doing a relocatable or shared link.  This is used by
 514 glibc.
 515
 516 * New options -split-by-reloc and -split-by-file.
 517
 518 * The linker now supports linking PIC compiled code on SPARC SunOS.  It can
 519 also create SPARC SunOS shared libraries, and, like the native SunOS linker,
 520 will do so whenever there is an undefined symbol in the link and neither the -e
 521 nor the -r option was used.
 522
 523 * The -rpath option may be used on SunOS to set the list of directories to be
 524 searched at run time.  This overrides the default of building the list from the
 525 -L options.
 526
 527 * The COFF linker now combines debugging information for structs, unions, and
 528 enums, so that even if the same type is defined in multiple input files it will
 529 only be defined once in the output file.  The --traditional-format switch will
 530 prevent this optimization.
 531
 532 Changes in version 2.5:
 533
 534 * The linker now supports linking against SunOS shared libraries.  It still can
 535 not link SunOS PIC (Position Independent Code) files, so it can not be used to
 536 generate shared libraries.
 537
 538 * The linker now supports linking against ELF shared libraries for the i386
 539 (UnixWare) and SPARC (Solaris).  It can also link ELF PIC files, and can be
 540 used to generate shared libraries.  Shared library generation is not well
 541 tested; please report any problems encountered.  The linker is now enabled for
 542 Solaris again.
 543
 544 * Eric Youngdale has contributed Linux support code, including linking against
 545 Linux a.out shared libraries.  The linker produces Linux QMAGIC binaries.
 546
 547 * The ELF backend has been converted to the new linker code.  To use the new
 548 ELF linker, each particular target requires a relocation function.  So far,
 549 this function has been written for i386 (UnixWare), SPARC (Solaris) MIPS (Irix
 550 5), and HPPA ELF targets.
 551
 552 * The -( (--start-group) and -) (--end-group) options have been added to
 553 support searching a group of archives as though they were a single archive.
 554 This can also be used in a linker script, as GROUP ( files ).
 555
 556 * When a file is named on the command line, and the linker does not recognize
 557 it as an object file, the linker will now treat the file as a linker script
 558 file.  A linker script named in this way augments, but does not replace, the
 559 default linker script.
 560
 561 * The -warn-once option was added.  It causes the linker to only warn once per
 562 undefined symbol, rather than once per reference.
 563
 564 * The COFF backend has been converted to the new linker code.  As with ELF, to
 565 use the new linker, each particular target requires a relocation function.  So
 566 far, this function has been written for the i386, m68k, a29k and SH targets.
 567
 568 * The -V flag was made a synonym for -v, for SVR4 compatibility.  The old -V
 569 behaviour is available via --verbose.
 570
 571 Changes in version 2.4:
 572
 573 * New linker code, by Steve Chamberlain and Ian Taylor.  For a.out and ecoff
 574   formats (so far), this should result in considerable savings in time
 575   and memory used while linking; slightly poorer performance than
 576   before for formats not converted yet.
 577
 578 * Command-line parsing is no longer done with flex.  This means
 579   oddball characters in filenames won't get treated as argument
 580   separators.
 581
 582 * HP-PA ELF support, by Jeff Law.  (No SOM support yet.)
 583
 584 * Mach i386 support, by David Mackenzie.
 585
 586 * Irix 4 shared libraries are now supported (Irix 5 uses ELF, and ELF shared
 587   libraries are not yet supported).
 588
 589 * COFF shared libraries (as on SCO) should work as well.
 590
 591 * The linker is disabled for Solaris.  (Actually, it was in 2.3 also, I just
 592   forgot to note it.)  Some of their C library routines don't work when
 593   statically linked, and the GNU linker doesn't support dynamic linking yet.
 594
 595 Changes in version 2.3:
 596
 597 * Weak symbols are now supported.
 598
 599 * ELF support has been added.  The linker has been bootstrapped on
 600   UnixWare and Solaris.
 601
 602 * Alpha OSF/1 support has been added (non dynamic linking only).
 603
 604 Changes in version 2.2:
 605
 606 * The `bfd' library has been updated to reduce a.out-format string
 607   table size.  The effect of this is that files linked from many input
 608   files with duplicate symbols (`-g' debugging records, or identical
 609   static symbols) should be much smaller.
 610
 611 Changes in version 2.1:
 612
 613 * The ld -ySYMBOL flag (to trace references to SYMBOL) is now implemented.
 614
 615 * There is now support for writing ECOFF files, so ld and the
 616   other utilities should work on Risc/Ultrix and Irix.
 617
 618 \f
 619 Copyright (C) 2012-2015 Free Software Foundation, Inc.
 620
 621 Copying and distribution of this file, with or without modification,
 622 are permitted in any medium without royalty provided the copyright
 623 notice and this notice are preserved.
 624
 625 Local variables:
 626 fill-column: 79
 627 End: