binutils/NEWS

   1 -*- text -*-
   2
   3 Changes in 2.42:
   4
   5 * The objdump program has a new command line option -Z/--decompress which
   6   changes the behaviour of the -s/--full-contents option, forcing it to
   7   decompress the contents of any compressed section before they are displayed.
   8
   9   In addition when objdump is displaying sections headers (via the -h/--headers
  10   command line option) it will now display "COMPRESSED" in the Flags field of
  11   any compressed section.
  12
  13 * The readelf program has a new command line option --extra-sym-info which
  14   extends the information displayed by the --symbols option.  When enabled
  15   the display will include the name of the section referenced by a symbol's
  16   index field (st_shndx).  In the future more information may also be displayed
  17   when this option is enabled.
  18
  19 * objcopy --set-section-flags now supports "large" to set SHF_X86_64_LARGE
  20   for ELF x86-64 objects.
  21
  22 * objdump --visualize-jumps is now supported on s390 architecture.
  23
  24 * The s390 disassembly now optionally includes the instruction description as
  25   comment with the s390-specific disassembler option "insndesc":
  26   - For objdump it can be enabled with "objdump -M insndesc ...".
  27   - In gdb it can be enabled with "set disassembler-options insndesc".
  28
  29 Changes in 2.41:
  30
  31 * The MIPS port now supports the Sony Interactive Entertainment Allegrex
  32   processor, used with the PlayStation Portable, which implements the MIPS
  33   II ISA along with a single-precision FPU and a few implementation-specific
  34   integer instructions.
  35
  36 * Objdump's --private option can now be used on PE format files to display the
  37   fields in the file header and section headers.
  38
  39 * New versioned release of libsframe: libsframe.so.1.  This release introduces
  40   versioned symbols with version node name LIBSFRAME_1.0.  This release also
  41   updates the ABI in an incompatible way: this includes removal of
  42   sframe_get_funcdesc_with_addr API, change in the behavior of
  43   sframe_fre_get_ra_offset and sframe_fre_get_fp_offset APIs.
  44
  45 * SFrame Version 2 is now the default (and only) format version supported by
  46   gas, ld, readelf and objdump.
  47
  48 * Add command-line option, --strip-section-headers, to objcopy and strip to
  49   remove ELF section header from ELF file.
  50
  51 * The RISC-V port now supports the following new standard extensions:
  52   - Zicond (conditional zero instructions)
  53   - Zfa (additional floating-point instructions)
  54   - Zvbb, Zvbc, Zvkg, Zvkned, Zvknh[ab], Zvksed, Zvksh, Zvkn, Zvknc, Zvkng,
  55     Zvks, Zvksc, Zvkg, Zvkt (vector crypto instructions)
  56
  57 * The RISC-V port now supports the following vendor-defined extensions:
  58   - XVentanaCondOps
  59
  60 * The LoongArch port now supports the following extensions:
  61   - LSX (Loongson SIMD eXtension; 128-bit vectors)
  62   - LASX (Loongson Advanced SIMD eXtension; 256-bit vectors)
  63   - LVZ (Loongson Virtualization extension)
  64   - LBT (Loongson Binary Translation extension)
  65
  66 * The LoongArch disassembly output received the following tweaks:
  67   - Colored output is now supported.
  68   - Some pseudo-instructions are now shown in place of the canonical forms,
  69     where semantics are equivalent. A disassembler option '-M no-aliases' is
  70     added to disable the new behavior.
  71   - Signed immediates are no longer printed with their hex representation.
  72   - Unrecognized instruction words are now shown with '.word'.
  73
  74 Changes in 2.40:
  75
  76 * Objdump has a new command line option --show-all-symbols which will make it
  77   display all symbols that match a given address when disassembling.  (Normally
  78   only the first symbol that matches an address is shown).
  79
  80 * Add --enable-colored-disassembly configure time option to enable colored
  81   disassembly output by default, if the output device is a terminal.  Note,
  82   this configure option is disabled by default.
  83
  84 * DCO signed contributions are now accepted.
  85
  86 * objcopy --decompress-debug-sections now supports zstd compressed debug
  87   sections.  The new option --compress-debug-sections=zstd compresses debug
  88   sections with zstd.
  89
  90 * addr2line and objdump --dwarf now support zstd compressed debug sections.
  91
  92 * The dlltool program now accepts --deterministic-libraries and
  93   --non-deterministic-libraries as command line options to control whether or
  94   not it generates deterministic output libraries.  If neither of these options
  95   are used the default is whatever was set when the binutils were configured.
  96
  97 * readelf and objdump now have a newly added option --sframe which dumps the
  98   SFrame section.
  99
 100 Changes in 2.39:
 101
 102 * Add --no-weak/-W option to nm to make it ignore weak symbols.
 103
 104 * Add an option to objdump and readelf to prevent attempts to access debuginfod
 105   servers when following links.
 106
 107 * objcopy --weaken, --weaken-symbol, and --weaken-symbols now make ELF
 108   STB_GNU_UNIQUE symbols weak.
 109
 110 * objdump now supports syntax highlighting of disassembler output for some
 111   architectures.  Use the --disassembler-color=MODE command line flag, with
 112   mode being either off, color, or extended-color.
 113
 114 Changes in 2.38:
 115
 116 * elfedit: Add --output-abiversion option to update ABIVERSION.
 117
 118 * Add support for the LoongArch instruction set.
 119
 120 * Tools which display symbols or strings (readelf, strings, nm, objdump)
 121   have a new command line option which controls how unicode characters are
 122   handled.  By default they are treated as normal for the tool.  Using
 123   --unicode=locale will display them according to the current locale.
 124   Using --unicode=hex will display them as hex byte values, whilst
 125   --unicode=escape will display them as escape sequences.  In addition
 126   using --unicode=highlight will display them as unicode escape sequences
 127   highlighted in red (if supported by the output device).
 128
 129 * readelf -r dumps RELR relative relocations now.
 130
 131 * Support for efi-app-aarch64, efi-rtdrv-aarch64 and efi-bsdrv-aarch64 has been
 132   added to objcopy in order to enable UEFI development using binutils.
 133
 134 * ar: Add --thin for creating thin archives. -T is a deprecated alias without
 135   diagnostics. In many ar implementations -T has a different meaning, as
 136   specified by X/Open System Interface.
 137
 138 Changes in 2.37:
 139
 140 * The readelf tool has a new command line option which can be used to specify
 141   how the numeric values of symbols are reported.  --sym-base=0|8|10|16 tells
 142   readelf to display the values in base 8, base 10 or base 16.  A sym base of 0
 143   represents the default action of displaying values under 10000 in base 10 and
 144   values above that in base 16.
 145
 146 * Binutils now requires a C99 compiler and library to build.
 147
 148 * A new format has been added to the nm program.  Specifying
 149   --format=just-symbols (or just using -j) will tell the program to only
 150   display symbol names and nothing else.
 151
 152 * A new command line --keep-section-symbols has been added to objcopy and
 153   strip.  This stops the removal of unused section symbols when the file is
 154   copied.  Removing these symbols saves space, but sometimes they are needed by
 155   other tools.
 156
 157 * objcopy --weaken, --weaken-symbol and --weaken-symbols now make undefined
 158   symbols weak on targets that support weak symbols.
 159
 160 * Readelf and objdump can now display and use the contents of .debug_sup
 161   sections.
 162
 163 * Readelf and objdump will now follow links to separate debug info files by
 164   default.  This behaviour can be stopped via the use of the new -wN or
 165   --debug-dump=no-follow-links options for readelf and the -WN or
 166   --dwarf=no-follow-links options for objdump.  Also the old behaviour can be
 167   restored by the use of the --enable-follow-debug-links=no configure time
 168   option.
 169
 170   The semantics of the =follow-links option have also been slightly changed.
 171   When enabled, the option allows for the loading of symbol tables and string
 172   tables from the separate files which can be used to enhance the information
 173   displayed when dumping other sections, but it does not automatically imply
 174   that information from the separate files should be displayed.
 175
 176   If other debug section display options are also enabled (eg
 177   --debug-dump=info) then the contents of matching sections in both the main
 178   file and the separate debuginfo file *will* be displayed.  This is because in
 179   most cases the debug section will only be present in one of the files.
 180
 181   If however non-debug section display options are enabled (eg --sections) then
 182   the contents of matching parts of the separate debuginfo file will *not* be
 183   displayed.  This is because in most cases the user probably only wanted to
 184   load the symbol information from the separate debuginfo file.  In order to
 185   change this behaviour a new command line option --process-links can be used.
 186   This will allow di0pslay options to applied to both the main file and any
 187   separate debuginfo files.
 188
 189 * Nm has a new command line option: --quiet.  This suppresses "no symbols"
 190   diagnostic.
 191
 192 Changes in 2.36:
 193
 194 * Update elfedit and readelf with LAM_U48 and LAM_U57 support.
 195
 196 * Nm has a new command line option: --ifunc-chars=CHARS.  This specifies a
 197   string of one or two characters.  The first character is used as the type
 198   character when displaying global ifunc symbols.  The second character, if
 199   present is used when displaying local ifunc symbols.
 200
 201   In addition a new configure time option --enable-f-for-ifunc-symbols has been
 202   created, which if used will change nm's default characters for ifunc symbols
 203   from i (both local and global) to F (global) and f (local).
 204
 205 * The ar tool's previously unused l modifier is now used for specifying
 206   dependencies of a static library. The arguments of this option
 207   (or --record-libdeps long form option) will be stored verbatim in the
 208   __.LIBDEP member of the archive, which the linker may read at link time.
 209
 210 * Readelf can now display the contents of LTO symbol table sections when asked
 211   to do so via the --lto-syms command line option.
 212
 213 * Readelf now accepts the -C command line option to enable the demangling of
 214   symbol names.  In addition the --demangle=<style>, --no-demangle,
 215   --recurse-limit and --no-recurse-limit options are also now availale.
 216
 217 * Add support for the SHF_GNU_RETAIN ELF section flag.
 218   This flag specifies that the section should not be garbage collected by the
 219   linker.
 220
 221 Changes in 2.35:
 222
 223 * Changed readelf's display of symbol names when wide mode is not enabled.
 224   If the name is too long it will be truncated and the last five characters
 225   replaced with "[...]".  The old behaviour of displaying 5 more characters but
 226   not indicating that truncation has happened can be restored by the use of the
 227   -T or --silent-truncation options.
 228
 229 * X86 NaCl target support is removed.
 230
 231 * The readelf tool now has a -L or --lint or --enable-checks option which turns
 232   on warning messages about possible problems with the file(s) being examined.
 233   These checks include things like zero-sized sections, which are allowed by
 234   the ELF standard but which nevertheless might be of concern if the user
 235   was expecting them to actually contain something.
 236
 237 Changes in 2.34:
 238
 239 * Binutils now supports debuginfod, an HTTP server for distributing
 240   ELF/DWARF debugging information as well as source code. When built with
 241   debuginfod, readelf and objdump can automatically query debuginfod
 242   servers for separate debug files when they otherwise cannot be found.
 243   To build binutils with debuginfod, pass --with-debuginfod to configure.
 244   This requires libdebuginfod, the debuginfod client library. debuginfod
 245   is distributed with elfutils, starting with version 0.178. For more
 246   information see https://sourceware.org/elfutils.
 247
 248 * Add --output option to the "ar" program.  This option can be used to specify
 249   the output directory when extracting members from an archive.
 250
 251 * Add --keep-section option to objcopy and strip.  This option keeps the
 252   specified section from being removed.
 253
 254  * Add visualization of jumps inside a function by drawing an ascii character
 255    graph between the address and the disassembler column.  Enabled via the
 256    --visualize-jumps command line option for objdump.  Currently supported by
 257    the x86, x86_64, and ARM targets.  The output looks something like this:
 258
 259   c6:   |  |     \----------> be 00 00 00 00            mov    $0x0,%esi
 260   cb:   |  |           /----> 48 8b 3d 00 00 00 00      mov    0x0(%rip),%rdi        # d2 <main+0xd2>
 261   d2:   |  |           |      31 c0                     xor    %eax,%eax
 262   d4:   |  |           |  /-- e8 00 00 00 00            callq  d9 <main+0xd9>
 263   d9:   |  |           |  \-> bf 02 00 00 00            mov    $0x2,%edi
 264   de:   |  +-----------|----- e8 00 00 00 00            callq  e3 <main+0xe3>
 265   e3:   |  \-----------|----> 48 89 da                  mov    %rbx,%rdx
 266   e6:   |              |      be 00 00 00 00            mov    $0x0,%esi
 267   eb:   |              \----- eb de                     jmp    cb <main+0xcb>
 268   ed:   \-------------------> 48 8b 16                  mov    (%rsi),%rdx
 269
 270   Additional arguments to the --visualize-jumps option add colors to the
 271   output.
 272
 273 Changes in 2.33:
 274
 275 * Add --source-comment[=<txt>] option to objdump which if present,
 276   provides a prefix to source code lines displayed in a disassembly.
 277
 278 * Add --set-section-alignment <section-name>=<align> option to objcopy to allow
 279   the changing of section alignments.
 280
 281 * Add --verilog-data-width option to objcopy for verilog targets to control
 282   width of data elements in verilog hex format.
 283
 284 * Add support for the Armv8.1-M Mainline and M-profile Vector Extension (MVE)
 285   instructions.
 286
 287 * The separate debug info file options of readelf (--debug-dump=links
 288   and --debug-dump=follow) and objdump (--dwarf=links and
 289   --dwarf=follow-links) will now display and/or follow multiple links if
 290   more than one are present in a file.  (This usually happens when gcc's
 291   -gsplit-dwarf option is used).
 292
 293   In addition objdump's --dwarf=follow-links now also affects its other
 294   display options, so that for example, when combined with --syms it will
 295   cause the symbol tables in any linked debug info files to also be
 296   displayed.  In addition when combined with --disassemble the --dwarf=
 297   follow-links option will ensure that any symbol tables in the linked
 298   files are read and used when disassembling code in the main file.
 299
 300  * Add support for dumping types encoded in the Compact Type Format
 301    to objdump and readelf.
 302
 303 Changes in 2.32:
 304
 305 * The addr2line, c++filt, nm and objdump tools now have a limit on the
 306   maximum amount of recursion that is allowed whilst demangling strings.
 307   The value for this limit is defined by the DEMANGLE_RECRUSE_LIMIT
 308   constant declared in the include/demangle.h header file.  At the time
 309   of writing this constant has the value of 2048.
 310
 311   The --no-recurse-limit option can be used to remove the limit, restoring
 312   the behaviour of earlier versions of these tools.  This may be needed in
 313   order to dmangle truly complicated names, but it also leaves the tools
 314   vulnerable to stack exhaustion from maliciously constructed mangled names.
 315
 316 * Objdump's --disassemble option can now take a parameter, specifying the
 317   starting symbol for disassembly.  Disassembly will continue from this
 318   symbol up to the next symbol or the end of the function.
 319
 320 * The MIPS port now supports the Loongson 2K1000 processor which implements
 321   the MIPS64r2 ISA, the Loongson-mmi ASE, Loongson-cam ASE, Loongson-ext ASE,
 322   Loongson-ext2 ASE and MSA ASE instructions. Add -march=gs264e option for
 323   Loongson 2K1000 processor.
 324
 325 * The MIPS port now supports the Loongson 3A2000/3A3000 processor which
 326   implements the MIPS64r2 ISA, the Loongson-mmi ASE, Loongson-cam ASE,
 327   Loongson-ext ASE and Loongson-ext2 ASE instructions. Add -march=gs464e
 328   option for Loongson 3A2000/3A3000 processor.
 329
 330 * The MIPS port now supports the Loongson 3A1000 processor, aka Loongson3a,
 331   which implements the MIPS64r2 ISA, the Loongson-mmi ASE, Loongson-cam ASE
 332   and Loongson-ext ASE instructions. Add -march=gs464 option for Loongson
 333   3A1000 processor, The -march=loongson3a is an alias of -march=gs464 for
 334   compatibility.
 335
 336 * The size tool now has a new output format '--format=GNU' or '-G'.  The
 337   results are displayed in a similar manor to the default berkeley layout,
 338   except read-only data is counted in the data column, not the text column.
 339   Additionally the total is only included once.
 340
 341 Changes in 2.31:
 342
 343 * Add support for disassembling netronome Flow Processor (NFP) firmware files.
 344
 345 * The AArch64 port now supports showing disassembly notes which are emitted
 346   when inconsistencies are found with the instruction that may result in the
 347   instruction being invalid.  These can be turned on with the option -M notes
 348   to objdump.
 349
 350 * The AArch64 port now emits warnings when a combination of an instruction and
 351   a named register could be invalid.
 352
 353 * Added O modifier to ar to display member offsets inside an archive
 354
 355 Changes in 2.30:
 356
 357 * Add --debug-dump=links option to readelf and --dwarf=links option to objdump
 358   which displays the contents of any .gnu_debuglink or .gnu_debugaltlink
 359   sections.
 360
 361   Add a --debug-dump=follow-links option to readelf and a --dwarf=follow-links
 362   option to objdump which causes indirect links into separate debug info files
 363   to be followed when dumping other DWARF sections.
 364
 365 Changes in 2.29:
 366
 367 * The MIPS port now supports microMIPS eXtended Physical Addressing (XPA)
 368   instructions for assembly and disassembly.
 369
 370 * The MIPS port now supports the microMIPS Release 5 ISA for assembly and
 371   disassembly.
 372
 373 * The MIPS port now supports the Imagination interAptiv MR2 processor,
 374   which implements the MIPS32r3 ISA, the MIPS16e2 ASE as well as a couple
 375   of implementation-specific regular MIPS and MIPS16e2 ASE instructions.
 376
 377 * The SPARC port now supports the SPARC M8 processor, which implements the
 378   Oracle SPARC Architecture 2017.
 379
 380 * The MIPS port now supports the MIPS16e2 ASE for assembly and disassembly.
 381
 382 * Add support for ELF SHF_GNU_MBIND and PT_GNU_MBIND_XXX.
 383
 384 * Add support for the wasm32 ELF conversion of the WebAssembly file format.
 385
 386 * Add --inlines option to objdump, which extends the --line-numbers option
 387   so that inlined functions will display their nesting information.
 388
 389 * Add --merge-notes options to objcopy to reduce the size of notes in
 390   a binary file by merging and deleting redundant notes.
 391
 392 * Add support for locating separate debug info files using the build-id
 393   method, where the separate file has a name based upon the build-id of
 394   the original file.
 395
 396 Changes in 2.28:
 397
 398 * This version of binutils fixes a problem with PowerPC VLE 16A and 16D
 399   relocations which were functionally swapped, for example,
 400   R_PPC_VLE_HA16A performed like R_PPC_VLE_HA16D while R_PPC_VLE_HA16D
 401   performed like R_PPC_VLE_HA16A.  This could have been fixed by
 402   renumbering relocations, which would keep object files created by an
 403   older version of gas compatible with a newer ld.  However, that would
 404   require an ABI update, affecting other assemblers and linkers that
 405   create and process the relocations correctly.  It is recommended that
 406   all VLE object files be recompiled, but ld can modify the relocations
 407   if --vle-reloc-fixup is passed to ld.  If the new ld command-line
 408   option is not used, ld will ld warn on finding relocations inconsistent
 409   with the instructions being relocated.
 410
 411 * The nm program has a new command-line option (--with-version-strings)
 412   which will display a symbol's version information, if any, after the
 413   symbol's name.
 414
 415 * The ARC port of objdump now accepts a -M option to specify the extra
 416   instruction class(es) that should be disassembled.
 417
 418 * The --remove-section option for objcopy and strip now accepts section
 419   patterns starting with an exclamation point to indicate a non-matching
 420   section.  A non-matching section is removed from the set of sections
 421   matched by an earlier --remove-section pattern.
 422
 423 * The --only-section option for objcopy now accepts section patterns
 424   starting with an exclamation point to indicate a non-matching section.
 425   A non-matching section is removed from the set of sections matched by
 426   an earlier --only-section pattern.
 427
 428 * New --remove-relocations=SECTIONPATTERN option for objcopy and strip.
 429   This option can be used to remove sections containing relocations.
 430   The SECTIONPATTERN is the section to which the relocations apply, not
 431   the relocation section itself.
 432
 433 Changes in 2.27:
 434
 435 * Add a configure option, --enable-64-bit-archive, to force use of a
 436   64-bit format when creating an archive symbol index.
 437
 438 * Add --elf-stt-common= option to objcopy for ELF targets to control
 439   whether to convert common symbols to the STT_COMMON type.
 440
 441 Changes in 2.26:
 442
 443 * Add option to objcopy to insert new symbols into a file:
 444   --add-symbol <name>=[<section>:]<value>[,<flags>]
 445
 446 * Add support for the ARC EM/HS, and ARC600/700 architectures.
 447
 448 * Extend objcopy --compress-debug-sections option to support
 449   --compress-debug-sections=[none|zlib|zlib-gnu|zlib-gabi] for ELF
 450   targets.
 451
 452 * Add --update-section option to objcopy.
 453
 454 * Add --output-separator option to strings.
 455
 456 Changes in 2.25:
 457
 458 * Add --data option to strings to only print strings in loadable, initialized
 459   data sections.  Change the default behaviour to be --all, but add a new
 460   configure time option of --disable-default-strings-all to restore the old
 461   default behaviour.
 462
 463 * Add --include-all-whitespace to strings.
 464
 465 * Add --dump-section option to objcopy.
 466
 467 * Add support for the Andes NDS32.
 468
 469 Changes in 2.24:
 470
 471 * Objcopy now supports wildcard characters in command-line options that take
 472   section names.
 473
 474 * Add support for Altera Nios II.
 475
 476 Changes in 2.23:
 477
 478 * Add support for the VLE extension to the PowerPC architecture.
 479
 480 * Add support for x64 Windows target of the delayed-load-library.
 481
 482 * Add support for the Renesas RL78 architecture.
 483
 484 Changes in 2.22:
 485
 486 * Add support for displaying the contents of .debug.macro sections.
 487
 488 * Add --preprocessor-arg option to windres to specify additional options
 489   passed to preprocessor.
 490
 491 * Add --dwarf-start and --dwarf-end to readelf and objdump.  These are used by
 492   the new Emacs mode, see dwarf-mode.el.
 493
 494 * Add support for the Tilera TILEPro and TILE-Gx architectures.
 495
 496 changes in 2.21:
 497
 498 * Add --interleave-width option to objcopy to allowing copying a range of
 499   bytes from the input to the output with the --interleave option.
 500
 501 * Add support for the TMS320C6000 (TI C6X) processor family.
 502
 503 * Readelf can now display ARM unwind tables (.ARM.exidx / .ARM.extab) using
 504   the -u / --unwind option.
 505
 506 * Add --dyn-syms to readelf to dump dynamic symbol table.
 507
 508 * A new tool - elfedit - has been added to directly manipulate ELF format
 509   binaries.
 510
 511 * Add to dlltool .def file feature of aliasing PE internal symbol name by
 512   '== <ID>' option.
 513
 514 * Add a new command-line option -a / --addresses to addr2line to display the
 515   address before function name or source filename.
 516
 517 * Add a new command-line option -p / --pretty-print to addr2line to have
 518   a more human readable output.
 519
 520 * The hppa/som targets can now be compiled on any host.
 521
 522 Changes in 2.20:
 523
 524 * Add support for delay importing to dlltool.  Use the --output-delaylib <file>
 525   switch to create a delay-import library.  The resulting app will load the dll
 526   as soon as the first function is called.  It will link to __delayLoadHelper2()
 527   from the static delayimp library, which will import LoadLibraryA and
 528   GetProcAddress from kernel32.
 529
 530 * Add a new command-line option, --insn-width=WIDTH, to objdump to specify
 531   number of bytes to be displayed on a single line when disassembling
 532   instructions.
 533
 534 * Readelf can now display the relocated contents of a section as a sequence
 535   of bytes via the --relocated-dump=<name|number> command-line option.
 536
 537 * The gprof program has been given a new command-line option:
 538   --external-symbols-table=<filename> which reads in symbols from a specified
 539   file.
 540
 541 * The plugin target has been added to bfd. It can load the same shared objects
 542   used by gold and uses them to provide basic support for new file formats.
 543
 544 * The verilog memory hex dump file format is now supported as an output format
 545   for objcopy.
 546
 547 * Add --file-alignment, --heap, --image-base, --section-alignment,
 548   --stack and --subsystem command-line options to objcopy, which will
 549   set PE optional header.
 550
 551 * Option --dwarf/-W of objdump is now as flexible as readelf --debug-dump/-w.
 552
 553 * --as-needed now links in a dynamic library if it satisfies undefined
 554   symbols in regular objects, or in other dynamic libraries.  In the
 555   latter case the library is not linked if it is found in a DT_NEEDED
 556   entry of one of the libraries already linked.
 557
 558 * Added --prefix=PREFIX and --prefix-strip=LEVEL switches to objdump to
 559   add absolute paths for -S.
 560
 561 * Add new option --use-nul-prefixed-import-tables to dlltool to allow fall-
 562   back to old import table generation with null element prefix.
 563
 564 * Added --identify-strict switch to cause --identify <implib> to
 565   report an error when the import library is associated with
 566   multiple DLLs.
 567
 568 * Added --identify <implib> option to dlltool, which determines the
 569   name of the DLL associated with the specified <implib>.
 570
 571 * Support for PowerPC booke64 instructions has been removed.  The assembler no
 572   longer accepts -mbooke32 or -mbooke64 and the disassembler no longer accepts
 573   -Mbooke32 or -Mbooke64.  Instead, -mbooke and -Mbooke should be used.
 574
 575 Changes in 2.19:
 576
 577 * Added -wL switch to dump decoded contents of .debug_line.
 578
 579 * Added support for "thin" archives which contain pathnames pointing to
 580   object files rather than the files themselves and which contain a
 581   flattened symbol index for all objects, and archives, which have been
 582   added to the archive.
 583
 584 * Added -F switch to objdump to include file offsets in the disassembly.
 585
 586 * Added -c switch to readelf to allow string dumps of archive symbol index.
 587
 588 * Support for SSE5 has been added to the i386 port.
 589
 590 * Added -p switch to readelf to allow string dumps of sections.
 591
 592 Changes in 2.18:
 593
 594 * Resolved 37 coding problems in bfd including static array overruns, null
 595   pointer dereferences and use of a malloc buffer after it has been freed, as
 596   revealed by static analysis donated by Coverity, Inc. (http://scan.coverity.com).
 597
 598 * The binutils sources are now released under version 3 of the GNU General
 599   Public License.
 600
 601 * A new tool "windmc" has been added for some targets.  This is a message
 602   compiler which attempts to be compatible with the MS version.
 603
 604 * Add codepage support to the windres tool.  It now supports many new
 605   resource types (e.g. MANIFEST, TOOLBAR, etc).  The output generation
 606   for binary files is done now via bfd itself.  The endianess problems
 607   for different hosts are solved.  Dumps of .res files can now be
 608   re-compiled by windres without lossing resources or compilation errors.
 609   Some problems on dialog resource translations are corrected.
 610
 611 * Add --extract-symbol command-line option to objcopy, which will
 612   strip everything out of an ordinary object file or executable except
 613   for its symbol table.  Files containing just symbols can be useful
 614   to some OSes.
 615
 616 Changes in 2.17:
 617
 618 * Add "-x NAME" to readelf in addition to "-x NUMBER".
 619
 620 * Add -i and -t switches to cxxfilt.  -i disables the display of implementation
 621   specific extra demangling information (if any) and -t disables the demangling
 622   of types.
 623
 624 * Add support for the "@<file>" syntax to the command lines of all tools, so
 625   that extra switches can be read from <file>.
 626
 627 * Add "-W/--dwarf" to objdump to display the contents of the DWARF
 628   debug sections.
 629
 630 * Add "-t/--section-details" to readelf to display section details.
 631   "-N/--full-section-name" is deprecated.
 632
 633 * powerpc-linux ld now supports a variant form of PLT and GOT for the security
 634   conscious.  This form will automatically be chosen when ld detects that all
 635   code in regular object files was generated by gcc -msecure-plt.  The old PLT
 636   and GOT may be forced by a new ld option, --bss-plt.
 637
 638 * Add "-i/--inlines" to addr2line to print enclosing scope information
 639   for inlined function chains, back to first non-inlined function.
 640
 641 * Add "-N/--full-section-name" to readelf to display full section name.
 642
 643 * Add "-M entry:<addr>" switch to objdump to specify a function entry address
 644   when disassembling VAX binaries.
 645
 646 * Add "--globalize-symbol <name>" and "--globalize-symbols <filename>" switches
 647   to objcopy to convert local symbols into global symbols.
 648
 649 * gprof now allows input files to have histogram records for
 650   several memory ranges, provided those ranges are disjoint.
 651
 652 Changes in 2.16:
 653
 654 * Add "-g/--section-groups" to readelf to display section groups.
 655
 656 * objcopy recognizes two new options --strip-unneeded-symbol and
 657   --strip-unneeded-symbols, namely for use together with the wildcard
 658   matching the original --strip-symbol/--strip-symbols provided, but
 659   retaining any symbols matching but needed by relocations.
 660
 661 * readelf can now display address ranges from .debug_range sections.  This
 662   happens automatically when a DW_AT_range attribute is encountered.  The
 663   command-line switch --debug-dump=Ranges (or -wR) can also be used to display
 664   the contents of the .debug_range section.
 665
 666 * nm and objdump now have a switch "--special-syms" to enable the displaying of
 667   symbols which the target considers to be special.  By default these symbols
 668   are no longer displayed.  Currently the only special symbols are the Mapping
 669   symbols used by the ARM port to mark transitions between text and data and
 670   between ARM and THUMB code.
 671
 672 * dlltool has a switch "--ext-prefix-alias <prefix>" to generate additional
 673   import and export symbols with <preifx> prepended to them.
 674
 675 Changes in 2.15:
 676
 677 * objcopy for MIPS targets now accepts "-M no-aliases" as an option to the
 678   disassembler to print the "raw" mips instruction mnemonic instead of some
 679   pseudo instruction name.  I.E. print "daddu" or "or" instead of "move",
 680   "sll" instead of "nop", etc.
 681
 682 * objcopy and strip can now take wildcard patterns in symbol names specified on
 683   the command line provided that the --wildcard switch is used to enable them.
 684
 685 * readelf can now parse archives.
 686
 687 * objdump now accepts --debugging-tags to print the debug information in a
 688   format compatible with ctags tool.
 689
 690 * objcopy and strip now accept --only-keep-debug to create a file containing
 691   those sections that would be stripped out by --strip-debug.  The idea is that
 692   this can be used in conjunction with the --add-gnu-debuglink switch to create
 693   a two part program distribution - one a stripped executable and the other the
 694   debugging info.
 695
 696 * objcopy now accepts --add-gnu-debuglink=<file> to insert a .gnu_debuglink
 697   section into a (presumably stripped) executable.  This allows the debug
 698   information for the file to be held in a separate file.
 699
 700 * BFD marks the sections .comment and .note as 'n' in the BSD/POSIX
 701   single-character representation.  This can be checked by running nm
 702   with the -a switch.
 703
 704 Changes in 2.14:
 705
 706 * Added --info switch to objcopy and strip.
 707
 708 * Support for Vitesse IQ2000 added by Red Hat.
 709
 710 * Added 'S' encoding to strings to allow the display of 8-bit characters.
 711
 712 * Added --prefix-symbols=<text>, --prefix-sections=<text> and
 713   --prefix-alloc-sections=<text> to objcopy.
 714
 715 * readelf can handle the extensions to the DWARF2 spec used by the Unified
 716   Parallel C compiler.
 717
 718 * BFD no longer declares a "boolean" type, to avoid clashes with other
 719   headers that declare the same.  Users of BFD should replace boolean,
 720   false and true, with int, 0 and 1, or define their own boolean type.
 721
 722 * Support for IP2K added by Denis Chertykov.
 723
 724 Changes in 2.13:
 725
 726 * Support for the Fujitsu FRV architecture added by Red Hat. Models for FR400
 727   and FR500 included.
 728
 729 Changes in version 2.12:
 730
 731 * Support for Don Knuth's MMIX, by Hans-Peter Nilsson.
 732
 733 * size: Add --totals to display summary of sizes (Berkeley format only).
 734
 735 * readelf: Add --wide option to not break section header or segment listing
 736   lines to fit into 80 columns.
 737
 738 * strings: Add --encoding to display wide character strings.  By Markus Kuhn.
 739
 740 * objcopy: Add --rename-section to change section names.
 741
 742 * readelf: Support added for DWARF 2.1 extensions.  Support added for
 743   displaying the contents of .debug.macinfo sections.
 744
 745 * New command-line switches added to objcopy to allow symbols to be kept as
 746   global symbols, and also to specify files containing lists of such symbols.
 747   by Honda Hiroki.
 748
 749 * Support for OpenRISC by Johan Rydberg.
 750
 751 * New command-line switch to objcopy --alt-machine-code which creates a binary
 752   with an alternate machine code if one is defined in the architecture
 753   description.  Only supported for ELF targets.  By Alexandre Oliva.
 754
 755 * New command-line switch to objcopy -B (or --binary-architecture) which sets
 756   the architecture of the output file to the given argument.  This option only
 757   makes sense, if the input target is binary.  Otherwise it is ignored.
 758   By Stefan Geuken.
 759
 760 * Support for PDP-11 by Lars Brinkhoff.
 761
 762 Changes in binutils 2.11:
 763
 764 * Add support for ARM v5t and v5te architectures and Intel's XScale ARM
 765   extenstions.
 766
 767 * Add --srec-len and --srec-forceS3 command-line switch to objcopy.
 768   By Luciano Gemme.
 769
 770 * Support for the MIPS32, by Anders Norlander.
 771
 772 * Support for the i860, by Jason Eckhardt.
 773
 774 * Support for CRIS (Axis Communications ETRAX series).
 775
 776 Changes in binutils 2.10:
 777
 778 * Support for 64-bit ELF on HPPA.
 779
 780 * New command-line switch to objdump --file-start-context which shows the
 781   entire file contents up to the source line first encountered for a given
 782   file.
 783
 784 * New command-line switch to objdump -M (or --disassembler-options) which takes
 785   a parameter which can then be interpreted on a per-target basis by the
 786   disassembler.  Used by ARM targets to select register name sets, ISA, APCS or
 787   raw verions.
 788
 789 * objdump support for -mi386:intel which causes disassembly to be displayed
 790   with intel syntax.
 791
 792 * New program: readelf.  This displays the contents of ELF format files,
 793   regardless of target machine.
 794
 795 * objcopy now takes --change-section-lma, --change-section-vma, and
 796   --change-section-address options.  The old --adjust-section-vma option is
 797   equivalent to --change-section-address.  The other --adjust-* options are now
 798   renamed to --change-*, although --adjust-* continues to work.
 799
 800 * objcopy has a --redefine-sym option that lets you rename symbols.
 801
 802 * objcopy now takes a -j/--only-section option to copy only the specified
 803   sections.
 804
 805 * dlltool now supports the IMPORTS command.
 806
 807 * dlltool now takes --export-all-symbols, --no-export-all-symbols,
 808   --exclude-symbols, and --no-default-excludes options.
 809
 810 Changes in binutils 2.9:
 811
 812 * Added windres program, which can be used to manipulate resources in WIN32
 813   files as used on Windows 95 and Windows NT.
 814
 815 * The objcopy --gap-fill and --pad-to options operate on the LMA rather than
 816   the VMA of the sections.
 817
 818 * Added S modifier to ar to not build a symbol table.
 819
 820 Changes in binutils 2.8:
 821
 822 * The objdump disassembly format has been changed, and hopefully improved.  Use
 823   the new --prefix-addresses option to get the old format.  There are also new
 824   --disassemble-zeroes and --no-show-raw-insn options which affect disassembler
 825   output.
 826
 827 * Formats may now be specified as configuration triplets.  For example,
 828   objdump -b i386-pc-linux.  The triplets are not passed through config.sub,
 829   so they must be in canonical form.
 830
 831 * Added new addr2line program.  This uses the debugging information to convert
 832   an address into a file name and line number within a program.
 833
 834 * Added --change-leading-char argument to objcopy.
 835
 836 * Added --weaken argument to objcopy.
 837
 838 * objdump --dynamic-reloc now works on ELF executables and shared libraries.
 839
 840 * Added --adjust-vma option to objdump.
 841
 842 * Added -C/--demangle option to objdump.
 843
 844 * Added -p/--preserve-dates option to strip and objcopy.
 845
 846 Changes in binutils 2.7:
 847
 848 * Added --enable-shared and --enable-commonbfdlib options to configure.
 849
 850 * Added --debugging argument to objdump and objcopy.
 851
 852 * Added --defined-only argument to nm.
 853
 854 * Added --remove-leading-char argument to objcopy.
 855
 856 * The objdump --line-numbers option is now meaningful with --reloc.
 857
 858 * Added --line-numbers option to nm.
 859
 860 * Added --endian/-EB/-EL option to objdump.
 861
 862 * Added support for Alpha OpenVMS/AXP.
 863
 864 Changes in binutils 2.6:
 865
 866 * Added -N/--strip-symbol and -K/--keep-symbol arguments to strip and objcopy.
 867
 868 * Added several arguments to objcopy to provide some control over how the new
 869   file is laid out in memory.  Also added binary output format to BFD to permit
 870   generating plain binary files.
 871
 872 * Added --start-address and --stop-address options to objdump.
 873
 874 * ar and ranlib now work on AIX.  The tools are now built by default on AIX.
 875
 876 Changes in binutils 2.5:
 877
 878 * Changed objdump -dr to dump the relocs interspersed with the assembly
 879   listing, for a more useful listing of relocatable files.
 880
 881 * Changed objdump -d/--disassemble to only disassemble SEC_CODE sections.
 882   Added -D/--disassemble-all option to disassemble all sections.
 883
 884 * Added --size-sort option to nm.
 885
 886 * strip and objcopy should now be able to handle dynamically linked ELF
 887   executables.
 888
 889 Changes in binutils 2.4:
 890
 891 * Support for HP-PA (by Jeff Law), i386 Mach (by David Mackenzie), RS/6000 and
 892   PowerPC (except ar and ranlib; by Ian Taylor).
 893
 894 * Support for Irix 5.
 895
 896 * Programs `strip' and `objcopy' will not attempt to write dynamically linked
 897   ELF output files, since BFD currently can't create them properly.
 898
 899 Changes in binutils 2.3:
 900
 901 * A new --stabs argument has been added to objdump to dump stabs sections in
 902   ELF and COFF files.
 903
 904 * A new program, nlmconv, has been added.  It can convert object files into
 905   Novell NetWare Loadable Modules.
 906
 907 * The strings program has been added.
 908
 909 Changes in binutils 2.2:
 910
 911 * The 'copy' program has been renamed to 'objcopy', for consistency with
 912   'objdump', and because 'copy' might more plausibly be used as a synonym for
 913   'cp'.
 914
 915 * The new stand-alone program c++filt is a filter that converts encoded
 916   (mangled) C++ assembly-level identifiers to user-level names.  (Note: This
 917   may get moved to the gcc distribution.)
 918
 919 * nm -o on an archive now prefixes each line with the archive name, matching
 920   the output from BSD nm.
 921
 922 * ar (and ld) can now read (but not write) BSD4.4-style archives.
 923
 924 * New support for H8500, Z8000, and the Hitach SH.
 925
 926 * Dis-assembler interface changed to allow sharing with gdb.
 927
 928 * There is new Elf code, but it is not yet ready for general use.
 929
 930 * There is the beginnings of a test suite.
 931
 932 Changes in binutils 2.1:
 933
 934 * There is now support for writing ECOFF files, so ld and the other utilities
 935   should work on Risc/Ultrix and Irix.  Please let us know how well this works.
 936
 937 * ar now automatically creates a symbol table (a __.SYMDEF member, in the BSD
 938   version), if there are any object files in the archive.  So running ranlib is
 939   now redundant (unless the non-standard q command is used).  This is required
 940   for Posix.2 conformance.
 941
 942 * The archive-reading code now reads both BSD-style and SYSV-style archives
 943   independently of the selected target format.  This is to encourage people to
 944   switch to SYSV-format, which has a number of advantages.
 945
 946 * The strip and copy programs now have options to remove debug-symbols only
 947   and/or local symbols only.  They now also support long options.
 948
 949 \f
 950 Copyright (C) 2012-2024 Free Software Foundation, Inc.
 951
 952 Copying and distribution of this file, with or without modification,
 953 are permitted in any medium without royalty provided the copyright
 954 notice and this notice are preserved.
 955
 956 Local variables:
 957 fill-column: 79
 958 End: