README
1 README for GNU development tools
2
3 This directory contains various GNU compilers, assemblers, linkers,
4 debuggers, etc., plus their support routines, definitions, and documentation.
5
6 If you are receiving this as part of a GDB release, see the file gdb/README.
7 If with a binutils release, see binutils/README; if with a libg++ release,
8 see libg++/README, etc. That'll give you info about this
9 package -- supported targets, how to use it, how to report bugs, etc.
10
11 It is now possible to automatically configure and build a variety of
12 tools with one command. To build all of the tools contained herein,
13 run the ``configure'' script here, e.g.:
14
15 ./configure
16 make
17
18 To install them (by default in /usr/local/bin, /usr/local/lib, etc),
19 then do:
20 make install
21
22 (If the configure script can't determine your type of computer, give it
23 the name as an argument, for instance ``./configure sun4''. You can
24 use the script ``config.sub'' to test whether a name is recognized; if
25 it is, config.sub translates it to a triplet specifying CPU, vendor,
26 and OS.)
27
28 If you have more than one compiler on your system, it is often best to
29 explicitly set CC in the environment before running configure, and to
30 also set CC when running make. For example (assuming sh/bash/ksh):
31
32 CC=gcc ./configure
33 make
34
35 A similar example using csh:
36
37 setenv CC gcc
38 ./configure
39 make
40
41 Much of the code and documentation enclosed is copyright by
42 the Free Software Foundation, Inc. See the file COPYING or
43 COPYING.LIB in the various directories, for a description of the
44 GNU General Public License terms under which you can copy the files.
45
46 REPORTING BUGS: Again, see gdb/README, binutils/README, etc., for info
47 on where and how to report problems.
48
README-maintainer-mode
1
2 Notes on enabling maintainer mode
3
4 Note that if you configure with --enable-maintainer-mode, you will need
5 special versions of automake, autoconf, libtool and gettext. You will
6 find the sources for these in the respective upstream directories:
7
8 ftp://ftp.gnu.org/gnu/autoconf
9 ftp://ftp.gnu.org/gnu/automake
10 ftp://ftp.gnu.org/gnu/libtool
11 ftp://ftp.gnu.org/gnu/gettext
12
13 The required versions of the tools for this tree are
14 autoconf 2.64
15 automake 1.11
16 libtool 2.2.6
17 gettext 0.14.5
18
19 Note - "make distclean" does not work with maintainer mode enabled.
20 The Makefiles in the some of the po/ subdirectories depend upon the
21 Makefiles in their parent directories, and distclean will delete the
22 Makefiles in the parent directories before running the Makefiles in
23 the child directories. There is no easy way around this (short of
24 changing the automake macros) as these dependencies need to exist in
25 order to correctly build the NLS files.
26
README.google
1 Patches applied to binutils-20141117:
2
3 Please include a change to this file with each patch, *and* each
4 subsequent modification of the patch. Do NOT combine patch
5 checkins, keep them separate.
6
7 Append new entries to the end of this file. Each entry shall include:
8 * The list of files modified by the patch,
9 * The status of the patch (whether it's been checked in upstream,
10 or is a local patch),
11 * The local 'owner' responsible for the patch, and
12 * A description of the patch (preferably including bug numbers).
13
14 Please include entries for both local patches and for patches which
15 have been checked in to (or back-ported from) the upstream sources.
16 When checking in changes made upstream, add an entry to this file but
17 DO NOT add entries to the GNU ChangeLog files.
18
19 gas/as.c
20 gas/as.h
21 gas/doc/as.texinfo
22 gas/read.c
23 gas/testsuite/gas/all/incbin.d
24 Status: google local
25 Owner: aaw
26 Disable .incbin, unless explicitly enabled with new flag --allow-incbin.
27
28 binutils/doc/Makefile.am
29 binutils/doc/Makefile.in
30 gas/doc/Makefile.am
31 gas/doc/Makefile.in
32 gprof/Makefile.am
33 gprof/Makefile.in
34 ld/Makefile.am
35 ld/Makefile.in
36 Status: local
37 Owner: bmoses
38 Pass --date=" " to pod2man to avoid including build dates when formatting
39 manual and info pages.
40
41 gas/testsuite/gas/aarch64/mapmisc.d
42 Status: local
43 Owner: bmoses
44 Add "--allow-incbin" directive to avoid errors with .incbin patch.
45
46 gold/configure.ac
47 gold/configure
48 gold/Makefile.am
49 gold/Makefile.in
50 gold/testsuite/Makefile.am
51 gold/testsuite/Makefile.in
52 Status: local
53 Owner: bmoses
54 Add a Gold configure option to run tests using the native
55 build tools, even if we are building for a non-native
56 target.
57
58 gold/errors.cc
59 Status: local
60 Owner: ccoutant
61 Add local go/keymethod link to missing vtable error message.
62
63 gold/options.h
64 Status: local
65 Owner: ccoutant
66 Make --disable-new-dtags the default. See b/12844098.
67
68 gold/layout.cc
69 Status: Local
70 Owner: tmsriram
71 Integrated from binutils-2.24.
72 Map input section name prefixes "_function_patch_prologue." and
73 "_function_patch_epilogue." to output section names
74 "_function_patch_prologue" and "_function_patch_epilogue".
75 The compiler patch that creates these sections:
76 http://gcc.gnu.org/ml/gcc-patches/2013-04/msg01835.html
77
78 gold/powerpc.cc
79 bfd/elf64-ppc.c
80 Status: backport
81 Owner: shenhan
82 Backport upstream patches to fix overflow detection for PPC.
83 See cl/80502043.
84
85 gold/powerpc.cc
86 Status: backport
87 Owner: shenhan
88 Backport upstream patch for PowerPC relaxation corner case.
89 See https://sourceware.org/ml/binutils/2014-11/msg00340.html.
90
91 gold/aarch64.cc
92 Status: backport
93 Owner: shenhan
94 Backport upstream patch for tlsdesc linking error under -pie.
95 See https://sourceware.org/ml/binutils/2014-11/msg00343.html.
96
97 gold/powerpc.cc
98 Status: backport
99 Owner: jingyu
100 Backport 2 upstream patches to retry powerpc gold stub grouping when
101 groups prove too large.
102 See https://sourceware.org/ml/binutils/2014-11/msg00342.html
103 and https://sourceware.org/ml/binutils/2014-12/msg00054.html
104
105 gold/aarch64.cc
106 Status: backport
107 Owner: jingyu
108 Backport upstream patch to print informative error message for
109 stub-group-size.
110 See https://sourceware.org/ml/binutils/2014-12/msg00108.html
111
112 gold/aarch64.cc
113 Status: backport
114 Owner: jingyu
115 Backport upstream patch to fix a print bug in 32bit mode.
116 See https://sourceware.org/ml/binutils/2014-12/msg00137.html
117
118 bfd/elf64-ppc.c
119 gold/powerpc.cc
120 gold/symtab.cc
121 Status: backport
122 Owner: jingyu
123 Backport 5 upstream patches for PPC.
124 See https://sourceware.org/git/?p=binutils-gdb.git;a=commit;h=f9dffbf0863b9010a5eece87bd6b36e38c09ffb0
125 https://sourceware.org/git/?p=binutils-gdb.git;a=commit;h=1f98a0748c4dfae57a76c408501c938480c1173c
126 https://sourceware.org/git/?p=binutils-gdb.git;a=commit;h=1611bc4afb0f08f0aff64ec355b8d68e9f4f0a73
127 https://sourceware.org/git/?p=binutils-gdb.git;a=commit;h=e30880c2eeee3b43897161344bbbffd03f3a1c91
128 https://sourceware.org/git/?p=binutils-gdb.git;a=commit;h=b01a4b043a5b08e1208b1fedd61a6f3d65a328e0
129
130 gold/powerpc.cc
131 Status: backport
132 Owner: jingyu
133 Backport upstream patch to correct PPC TLSLD linker optimization.
134 See https://sourceware.org/ml/binutils/2015-01/msg00322.html
135
136 gold/aarch64-reloc.def
137 gold/aarch64.cc
138 Status: backport
139 Owner: jingyu
140 Backport upstream patch to support missing TLSLE relocations.
141 see https://sourceware.org/ml/binutils/2015-02/msg00140.html
142
143 gold/parameters.cc
144 Status: backport
145 Owner: ccoutant
146 Fix a race condition when setting default target for ARM targets.
147 https://sourceware.org/ml/binutils-cvs/2015-03/msg00023.html
148
149 binutils/dwarf.h
150 binutils/readelf.c
151 include/dwarf2.def
152 include/dwarf2.h
153 Status: local
154 Owner: ccoutant
155 Backport two-level line table support for readelf from upstream binutils
156 branch users/ccoutant/two-level-line-150331.
157
158 gas/dwarf2dbg.c
159 gas/dwarf2dbg.h
160 gas/config/obj-elf.c
161 Status: local
162 Owner: ccoutant
163 Backport two-level line table support for GAS from upstream binutils
164 branch users/ccoutant/two-level-line-150331.
165
166 elfcpp/dwarf.h
167 gold/debug.h
168 gold/dwarf_reader.cc
169 gold/dwarf_reader.h
170 Status: local
171 Owner: ccoutant
172 Backport two-level line table support for gold from upstream binutils
173 branch users/ccoutant/two-level-line-150331.
174
175 gold/dwp.cc
176 gold/dynobj.cc
177 gold/object.cc
178 gold/object.h
179 Status: backport
180 Owner: ccoutant
181 Backport upstream patch to add gold support for reading compressed
182 debug info in shared object and dwp files.
183
184 gold/aarch64-reloc.def
185 gold/aarch64.cc
186 Status: backport
187 Owner: jingyu
188 Add support to 2 AARCH64 TLSLD relocations. Change _TLS_MODULE_BASE_.
189 https://sourceware.org/ml/binutils/2015-03/msg00420.html
190
191 gold/ehframe.h
192 gold/gold.cc
193 gold/layout.cc
194 gold/layout.h
195 gold/options.cc
196 gold/testsuite/Makefile.am
197 gold/testsuite/Makefile.in
198 Status: backport
199 Owner: ccoutant
200 Fix gold testsuite failures when using newer versions of GCC.
201 https://sourceware.org/ml/binutils-cvs/2015-03/msg00048.html
202 https://sourceware.org/ml/binutils-cvs/2015-03/msg00075.html
203 https://sourceware.org/ml/binutils-cvs/2015-03/msg00146.html
204
205 gold/aarch.cc
206 Status: backport
207 Owner: jingyu
208 Fix virtual function signature to match the one in the parent class.
209 https://sourceware.org/ml/binutils/2015-04/msg00045.html
210
211 gold/debug.h
212 gold/dwarf_reader.cc
213 gold/symtab.cc
214 gold/testsuite/debug_msg.sh
215 Status: backport
216 Owner: ccoutant
217 Improve ODR checking in gold, to tolerate slight differences in
218 line numbers between clang and gcc.
219 https://sourceware.org/ml/binutils-cvs/2015-04/msg00095.html
220
221 gold/layout.cc
222 gold/target.h
223 gold/x86_64.cc
224 Status: local
225 Owner: tmsriram
226 With PIE links, check the size of the data segment and warn when it is
227 greater than a safe value (128MB for x86_64) to prevent the problem described
228 in go/unsafe-pie.
229
230 gold/options.h
231 gold/symtab.cc
232 gold/symtab.h
233 gold/testsuite/Makefile.am
234 gold/testsuite/Makefile.in
235 gold/testsuite/weak_unresolved_symbols_test.cc
236 Status: backport
237 Owner: tmsriram
238 Backport upstream patch that adds option --warn-unresolved-symbols to gold
239 that treats unresolved symbol references as weak. Details here:
240 https://sourceware.org/ml/binutils/2015-04/msg00358.html
241
242 gold/gold.cc
243 gold/options.h
244 gold/testsuite/Makefile.am
245 gold/testsuite/Makefile.in
246 gold/testsuite/disable_pie_unsafe_size_test.cc
247 gold/testsuite/disable_pie_unsafe_size_test.sh
248 Status: local
249 Owner: tmsriram
250 With PIE links, check the size of the data segment and disable PIE when it
251 is greater than a safe value (128MB for x86_64) to prevent the problem described
252 in go/unsafe-pie. Allow this to be overridden with
253 --no-disable-pie-when-unsafe-data-size
254
255 gold/powerpc.cc
256 Status: backport
257 Owner: saugustine
258 Backport upstream patches that disable assertion when building powerpc symbol
259 tables.
260 https://sourceware.org/ml/binutils/2015-04/msg00428.html
261 https://sourceware.org/ml/binutils/2015-04/msg00429.html
262
263 gold/symtab.cc
264 gold/testsuite/Makefile.am
265 gold/testsuite/tls_pie_test.sh
266 Status: backport
267 Owner: tmsriram
268 Backport upstream patch that allows gold to resolve defined TLS symbols in a
269 PIE link.
270 https://sourceware.org/ml/binutils-cvs/2015-04/msg00098.html
271