Add support to readelf to decode and display the contents of .debug_ranges
[external/binutils.git] / binutils / NEWS
1 -*- text -*-
2
3 * readelf can now display address ranges from .debug_range sections.  This
4   happens automatically when a DW_AT_range attribute is encountered.  The
5   command line switch --debug-dump=Ranges (or -wR) can also be used to display
6   the contents of the .debug_range section.
7
8 * nm and objdump now have a switch "--special-syms" to enable the displaying of
9   symbols which the target considers to be special.  By default these symbols
10   are no longer displayed.  Currently the only special symbols are the Mapping
11   symbols used by the ARM port to mark transitions between text and data and
12   between ARM and THUMB code.
13
14 * dlltool has a switch "--ext-prefix-alias <prefix>" to generate additional
15   import and export symbols with <preifx> prepended to them.
16
17 Changes in 2.15:
18
19 * objcopy and strip can now take wildcard patterns in symbol names specified on
20   the command line provided that the --wildcard switch is used to enable them.
21
22 * readelf can now parse archives.
23
24 * objdump now accepts --debugging-tags to print the debug information in a
25   format compatible with ctags tool.
26
27 * objcopy and strip now accept --only-keep-debug to create a file containing
28   those sections that would be stripped out by --strip-debug.  The idea is that
29   this can be used in conjunction with the --add-gnu-debuglink switch to create
30   a two part program distribution - one a stripped executable and the other the
31   debugging info.
32
33 * objcopy now accepts --add-gnu-debuglink=<file> to insert a .gnu_debuglink
34   section into a (presumably stripped) executable.  This allows the debug
35   information for the file to be held in a separate file.
36   
37 * BFD marks the sections .comment and .note as 'n' in the BSD/POSIX
38   single-character representation.  This can be checked by running nm
39   with the -a switch.
40
41 Changes in 2.14:
42
43 * Added --info switch to objcopy and strip.
44
45 * Support for Vitesse IQ2000 added by Red Hat.
46
47 * Added 'S' encoding to strings to allow the display of 8-bit characters.
48
49 * Added --prefix-symbols=<text>, --prefix-sections=<text> and
50   --prefix-alloc-sections=<text> to objcopy.
51
52 * readelf can handle the extensions to the DWARF2 spec used by the Unified
53   Parallel C compiler.
54
55 * BFD no longer declares a "boolean" type, to avoid clashes with other
56   headers that declare the same.  Users of BFD should replace boolean,
57   false and true, with int, 0 and 1, or define their own boolean type.
58
59 * Support for IP2K added by Denis Chertykov.
60
61 Changes in 2.13:
62
63 * Support for the Fujitsu FRV architecture added by Red Hat. Models for FR400
64   and FR500 included.
65
66 Changes in version 2.12:
67
68 * Support for Don Knuth's MMIX, by Hans-Peter Nilsson.
69
70 * size: Add --totals to display summary of sizes (Berkeley format only).
71
72 * readelf: Add --wide option to not break section header or segment listing
73   lines to fit into 80 columns.
74
75 * strings: Add --encoding to display wide character strings.  By Markus Kuhn.
76
77 * objcopy: Add --rename-section to change section names.
78
79 * readelf: Support added for DWARF 2.1 extensions.  Support added for
80   displaying the contents of .debug.macinfo sections.
81
82 * New command line switches added to objcopy to allow symbols to be kept as
83   global symbols, and also to specify files containing lists of such symbols.
84   by Honda Hiroki.
85
86 * Support for OpenRISC by Johan Rydberg.
87
88 * New command line switch to objcopy --alt-machine-code which creates a binary
89   with an alternate machine code if one is defined in the architecture
90   description.  Only supported for ELF targets.  By Alexandre Oliva.
91
92 * New command line switch to objcopy -B (or --binary-architecture) which sets
93   the architecture of the output file to the given argument.  This option only
94   makes sense, if the input target is binary.  Otherwise it is ignored.
95   By Stefan Geuken.
96
97 * Support for PDP-11 by Lars Brinkhoff.
98
99 Changes in binutils 2.11:
100
101 * Add support for ARM v5t and v5te architectures and Intel's XScale ARM
102   extenstions.
103
104 * Add --srec-len and --srec-forceS3 command line switch to objcopy.
105   By Luciano Gemme.
106
107 * Support for the MIPS32, by Anders Norlander.
108
109 * Support for the i860, by Jason Eckhardt.
110
111 * Support for CRIS (Axis Communications ETRAX series).
112
113 Changes in binutils 2.10:
114
115 * Support for 64-bit ELF on HPPA.
116
117 * New command line switch to objdump --file-start-context which shows the
118   entire file contents up to the source line first encountered for a given
119   file.
120
121 * New command line switch to objdump -M (or --disassembler-options) which takes
122   a parameter which can then be interpreted on a per-target basis by the
123   disassembler.  Used by ARM targets to select register name sets, ISA, APCS or
124   raw verions.
125
126 * objdump support for -mi386:intel which causes disassembly to be displayed
127   with intel syntax.
128
129 * New program: readelf.  This displays the contents of ELF format files,
130   regardless of target machine.
131
132 * objcopy now takes --change-section-lma, --change-section-vma, and
133   --change-section-address options.  The old --adjust-section-vma option is
134   equivalent to --change-section-address.  The other --adjust-* options are now
135   renamed to --change-*, although --adjust-* continues to work.
136
137 * objcopy has a --redefine-sym option that lets you rename symbols.
138
139 * objcopy now takes a -j/--only-section option to copy only the specified
140   sections.
141
142 * dlltool now supports the IMPORTS command.
143
144 * dlltool now takes --export-all-symbols, --no-export-all-symbols,
145   --exclude-symbols, and --no-default-excludes options.
146
147 Changes in binutils 2.9:
148
149 * Added windres program, which can be used to manipulate resources in WIN32
150   files as used on Windows 95 and Windows NT.
151
152 * The objcopy --gap-fill and --pad-to options operate on the LMA rather than
153   the VMA of the sections.
154
155 * Added S modifier to ar to not build a symbol table.
156
157 Changes in binutils 2.8:
158
159 * The objdump disassembly format has been changed, and hopefully improved.  Use
160   the new --prefix-addresses option to get the old format.  There are also new
161   --disassemble-zeroes and --no-show-raw-insn options which affect disassembler
162   output.
163
164 * Formats may now be specified as configuration triplets.  For example,
165   objdump -b i386-pc-linux.  The triplets are not passed through config.sub,
166   so they must be in canonical form.
167
168 * Added new addr2line program.  This uses the debugging information to convert
169   an address into a file name and line number within a program.
170
171 * Added --change-leading-char argument to objcopy.
172
173 * Added --weaken argument to objcopy.
174
175 * objdump --dynamic-reloc now works on ELF executables and shared libraries.
176
177 * Added --adjust-vma option to objdump.
178
179 * Added -C/--demangle option to objdump.
180
181 * Added -p/--preserve-dates option to strip and objcopy.
182
183 Changes in binutils 2.7:
184
185 * Added --enable-shared and --enable-commonbfdlib options to configure.
186
187 * Added --debugging argument to objdump and objcopy.
188
189 * Added --defined-only argument to nm.
190
191 * Added --remove-leading-char argument to objcopy.
192
193 * The objdump --line-numbers option is now meaningful with --reloc.
194
195 * Added --line-numbers option to nm.
196
197 * Added --endian/-EB/-EL option to objdump.
198
199 * Added support for Alpha OpenVMS/AXP.
200
201 Changes in binutils 2.6:
202
203 * Added -N/--strip-symbol and -K/--keep-symbol arguments to strip and objcopy.
204
205 * Added several arguments to objcopy to provide some control over how the new
206   file is laid out in memory.  Also added binary output format to BFD to permit
207   generating plain binary files.
208
209 * Added --start-address and --stop-address options to objdump.
210
211 * ar and ranlib now work on AIX.  The tools are now built by default on AIX.
212
213 Changes in binutils 2.5:
214
215 * Changed objdump -dr to dump the relocs interspersed with the assembly
216   listing, for a more useful listing of relocatable files.
217
218 * Changed objdump -d/--disassemble to only disassemble SEC_CODE sections.
219   Added -D/--disassemble-all option to disassemble all sections.
220
221 * Added --size-sort option to nm.
222
223 * strip and objcopy should now be able to handle dynamically linked ELF
224   executables.
225
226 Changes in binutils 2.4:
227
228 * Support for HP-PA (by Jeff Law), i386 Mach (by David Mackenzie), RS/6000 and
229   PowerPC (except ar and ranlib; by Ian Taylor).
230
231 * Support for Irix 5.
232
233 * Programs `strip' and `objcopy' will not attempt to write dynamically linked
234   ELF output files, since BFD currently can't create them properly.
235
236 Changes in binutils 2.3:
237
238 * A new --stabs argument has been added to objdump to dump stabs sections in
239   ELF and COFF files.
240
241 * A new program, nlmconv, has been added.  It can convert object files into
242   Novell NetWare Loadable Modules.
243
244 * The strings program has been added.
245
246 Changes in binutils 2.2:
247
248 * The 'copy' program has been renamed to 'objcopy', for consistency with
249   'objdump', and because 'copy' might more plausibly be used as a synonym for
250   'cp'.
251
252 * The new stand-alone program c++filt is a filter that converts encoded
253   (mangled) C++ assembly-level identifiers to user-level names.  (Note: This
254   may get moved to the gcc distribution.)
255
256 * nm -o on an archive now prefixes each line with the archive name, matching
257   the output from BSD nm.
258
259 * ar (and ld) can now read (but not write) BSD4.4-style archives.
260
261 * New support for H8500, Z8000, and the Hitach SH.
262
263 * Dis-assembler interface changed to allow sharing with gdb.
264
265 * There is new Elf code, but it is not yet ready for general use.
266
267 * There is the beginnings of a test suite.
268
269 Changes in binutils 2.1:
270
271 * There is now support for writing ECOFF files, so ld and the other utilities
272   should work on Risc/Ultrix and Irix.  Please let us know how well this works.
273
274 * ar now automatically creates a symbol table (a __.SYMDEF member, in the BSD
275   version), if there are any object files in the archive.  So running ranlib is
276   now redundant (unless the non-standard q command is used).  This is required
277   for Posix.2 conformance.
278
279 * The archive-reading code now reads both BSD-style and SYSV-style archives
280   independently of the selected target format.  This is to encourage people to
281   switch to SYSV-format, which has a number of advantages.
282
283 * The strip and copy programs now have options to remove debug-symbols only
284   and/or local symbols only.  They now also support long options.
285
286 \f
287 Local variables:
288 fill-column: 79
289 End: