mirror of
https://sourceware.org/git/binutils-gdb.git
synced 2025-01-24 12:35:55 +08:00
270c993744
The goal of this patch is to provide an easy way to make
--disable-werror the default when building binutils, or the parts
of binutils that need to get built when building GDB. In development
mode, we want to continue making -Werror the default with GCC.
But, when making releases, I think we want to make it as easy as
possible for regular users to successfully build from sources.
GDB already has this kind of feature to turn -Werror as well as
the use of the libmcheck library. As GDB Release Manager, I take
advantage of it to turn those off after having cut the branch.
I'd like to be able to do the same for the binutils bits. And
perhaps Tristan will want to do the same for his releases too
(not sure, binutils builders might be a little savvier than GDB
builders).
This patch introduces a new file, called development.sh, which
just sets a variable called $development. In our development branches
(Eg. "master"), it's set to true. But setting it to false would allow
us to change the default behavior of various development-related
features to be turned off; in this case, it turns off the use of
-Werror by default (use --enable-werror to turn it back on).
bfd/ChangeLog:
* development.sh: New file.
* warning.m4 (AM_BINUTILS_WARNINGS): Source bfd/development.sh.
Make -Werror the default with GCC only if DEVELOPMENT is true.
* Makefile.am (CONFIG_STATUS_DEPENDENCIES): Add
$(srcdir)/development.sh.
* Makefile.in, configure: Regenerate.
binutils/ChangeLog:
* Makefile.am (CONFIG_STATUS_DEPENDENCIES): Add dependency on
bfd's development.sh.
* Makefile.in, configure: Regenerate.
gas/ChangeLog:
* Makefile.am (CONFIG_STATUS_DEPENDENCIES): Add dependency on
bfd's development.sh.
* Makefile.in, configure: Regenerate.
gold/ChangeLog:
* Makefile.am (CONFIG_STATUS_DEPENDENCIES): New.
* Makefile.in, configure: Regenerate.
gprof/ChangeLog:
* Makefile.am (CONFIG_STATUS_DEPENDENCIES): Add dependency on
bfd's development.sh.
* Makefile.in, configure: Regenerate.
ld/ChangeLog:
* Makefile.am (CONFIG_STATUS_DEPENDENCIES): Add dependency on
bfd's development.sh.
* Makefile.in, configure: Regenerate.
opcodes/ChangeLog:
* Makefile.am (CONFIG_STATUS_DEPENDENCIES): Add dependency on
bfd's development.sh.
* Makefile.in, configure: Regenerate.
gdb/ChangeLog:
* development.sh: Delete.
* Makefile.in (config.status): Adjust dependency on development.sh.
* configure.ac: Adjust development.sh source call.
* configure: Regenerate.
gdb/gdbserver/ChangeLog:
* configure.ac: Adjust development.sh source call.
* Makefile.in (config.status): Adjust dependency on development.sh.
* configure: Regenerate.
Tested on x86_64-linux by building two ways: One with DEVELOPMENT
set to true, and one with DEVELOPMENT set to false. In the first
case, I could see the use of -Werror, while it disappeared in
the second case.
|
||
|---|---|---|
| .. | ||
| doc | ||
| hosts | ||
| po | ||
| .gitignore | ||
| acinclude.m4 | ||
| aclocal.m4 | ||
| aix5ppc-core.c | ||
| aix386-core.c | ||
| aout0.c | ||
| aout32.c | ||
| aout64.c | ||
| aout-adobe.c | ||
| aout-arm.c | ||
| aout-cris.c | ||
| aout-ns32k.c | ||
| aout-sparcle.c | ||
| aout-target.h | ||
| aout-tic30.c | ||
| aoutf1.h | ||
| aoutx.h | ||
| archive64.c | ||
| archive.c | ||
| archures.c | ||
| armnetbsd.c | ||
| bfd-in2.h | ||
| bfd-in.h | ||
| bfd.c | ||
| bfd.m4 | ||
| bfdio.c | ||
| bfdwin.c | ||
| binary.c | ||
| bout.c | ||
| cache.c | ||
| cf-i386lynx.c | ||
| cf-sparclynx.c | ||
| ChangeLog | ||
| ChangeLog-0001 | ||
| ChangeLog-0203 | ||
| ChangeLog-2004 | ||
| ChangeLog-2005 | ||
| ChangeLog-2006 | ||
| ChangeLog-2007 | ||
| ChangeLog-2008 | ||
| ChangeLog-2009 | ||
| ChangeLog-2010 | ||
| ChangeLog-2011 | ||
| ChangeLog-2012 | ||
| ChangeLog-2013 | ||
| ChangeLog-9193 | ||
| ChangeLog-9495 | ||
| ChangeLog-9697 | ||
| ChangeLog-9899 | ||
| cisco-core.c | ||
| coff64-rs6000.c | ||
| coff-alpha.c | ||
| coff-apollo.c | ||
| coff-arm.c | ||
| coff-aux.c | ||
| coff-go32.c | ||
| coff-h8300.c | ||
| coff-h8500.c | ||
| coff-i386.c | ||
| coff-i860.c | ||
| coff-i960.c | ||
| coff-ia64.c | ||
| coff-m68k.c | ||
| coff-m88k.c | ||
| coff-mcore.c | ||
| coff-mips.c | ||
| coff-ppc.c | ||
| coff-rs6000.c | ||
| coff-sh.c | ||
| coff-sparc.c | ||
| coff-stgo32.c | ||
| coff-svm68k.c | ||
| coff-tic4x.c | ||
| coff-tic30.c | ||
| coff-tic54x.c | ||
| coff-tic80.c | ||
| coff-u68k.c | ||
| coff-w65.c | ||
| coff-we32k.c | ||
| coff-x86_64.c | ||
| coff-z8k.c | ||
| coff-z80.c | ||
| coffcode.h | ||
| coffgen.c | ||
| cofflink.c | ||
| coffswap.h | ||
| compress.c | ||
| config.bfd | ||
| config.in | ||
| configure | ||
| configure.com | ||
| configure.host | ||
| configure.in | ||
| COPYING | ||
| corefile.c | ||
| cpu-aarch64.c | ||
| cpu-alpha.c | ||
| cpu-arc.c | ||
| cpu-arm.c | ||
| cpu-avr.c | ||
| cpu-bfin.c | ||
| cpu-cr16.c | ||
| cpu-cr16c.c | ||
| cpu-cris.c | ||
| cpu-crx.c | ||
| cpu-d10v.c | ||
| cpu-d30v.c | ||
| cpu-dlx.c | ||
| cpu-epiphany.c | ||
| cpu-fr30.c | ||
| cpu-frv.c | ||
| cpu-h8300.c | ||
| cpu-h8500.c | ||
| cpu-hppa.c | ||
| cpu-i370.c | ||
| cpu-i386.c | ||
| cpu-i860.c | ||
| cpu-i960.c | ||
| cpu-ia64-opc.c | ||
| cpu-ia64.c | ||
| cpu-ip2k.c | ||
| cpu-iq2000.c | ||
| cpu-k1om.c | ||
| cpu-l1om.c | ||
| cpu-lm32.c | ||
| cpu-m9s12x.c | ||
| cpu-m9s12xg.c | ||
| cpu-m32c.c | ||
| cpu-m32r.c | ||
| cpu-m68hc11.c | ||
| cpu-m68hc12.c | ||
| cpu-m68k.c | ||
| cpu-m88k.c | ||
| cpu-m10200.c | ||
| cpu-m10300.c | ||
| cpu-mcore.c | ||
| cpu-mep.c | ||
| cpu-metag.c | ||
| cpu-microblaze.c | ||
| cpu-mips.c | ||
| cpu-mmix.c | ||
| cpu-moxie.c | ||
| cpu-msp430.c | ||
| cpu-mt.c | ||
| cpu-nds32.c | ||
| cpu-nios2.c | ||
| cpu-ns32k.c | ||
| cpu-or1k.c | ||
| cpu-pdp11.c | ||
| cpu-pj.c | ||
| cpu-plugin.c | ||
| cpu-powerpc.c | ||
| cpu-rl78.c | ||
| cpu-rs6000.c | ||
| cpu-rx.c | ||
| cpu-s390.c | ||
| cpu-score.c | ||
| cpu-sh.c | ||
| cpu-sparc.c | ||
| cpu-spu.c | ||
| cpu-tic4x.c | ||
| cpu-tic6x.c | ||
| cpu-tic30.c | ||
| cpu-tic54x.c | ||
| cpu-tic80.c | ||
| cpu-tilegx.c | ||
| cpu-tilepro.c | ||
| cpu-v850_rh850.c | ||
| cpu-v850.c | ||
| cpu-vax.c | ||
| cpu-w65.c | ||
| cpu-we32k.c | ||
| cpu-xc16x.c | ||
| cpu-xgate.c | ||
| cpu-xstormy16.c | ||
| cpu-xtensa.c | ||
| cpu-z8k.c | ||
| cpu-z80.c | ||
| demo64.c | ||
| dep-in.sed | ||
| development.sh | ||
| dwarf1.c | ||
| dwarf2.c | ||
| ecoff.c | ||
| ecofflink.c | ||
| ecoffswap.h | ||
| elf32-am33lin.c | ||
| elf32-arc.c | ||
| elf32-arm.c | ||
| elf32-avr.c | ||
| elf32-avr.h | ||
| elf32-bfin.c | ||
| elf32-cr16.c | ||
| elf32-cr16c.c | ||
| elf32-cris.c | ||
| elf32-crx.c | ||
| elf32-d10v.c | ||
| elf32-d30v.c | ||
| elf32-dlx.c | ||
| elf32-epiphany.c | ||
| elf32-fr30.c | ||
| elf32-frv.c | ||
| elf32-gen.c | ||
| elf32-h8300.c | ||
| elf32-hppa.c | ||
| elf32-hppa.h | ||
| elf32-i370.c | ||
| elf32-i386.c | ||
| elf32-i860.c | ||
| elf32-i960.c | ||
| elf32-ip2k.c | ||
| elf32-iq2000.c | ||
| elf32-lm32.c | ||
| elf32-m32c.c | ||
| elf32-m32r.c | ||
| elf32-m68hc1x.c | ||
| elf32-m68hc1x.h | ||
| elf32-m68hc11.c | ||
| elf32-m68hc12.c | ||
| elf32-m68k.c | ||
| elf32-m88k.c | ||
| elf32-mcore.c | ||
| elf32-mep.c | ||
| elf32-metag.c | ||
| elf32-metag.h | ||
| elf32-microblaze.c | ||
| elf32-mips.c | ||
| elf32-moxie.c | ||
| elf32-msp430.c | ||
| elf32-mt.c | ||
| elf32-nds32.c | ||
| elf32-nds32.h | ||
| elf32-nios2.c | ||
| elf32-nios2.h | ||
| elf32-or1k.c | ||
| elf32-pj.c | ||
| elf32-ppc.c | ||
| elf32-ppc.h | ||
| elf32-rl78.c | ||
| elf32-rx.c | ||
| elf32-rx.h | ||
| elf32-s390.c | ||
| elf32-score7.c | ||
| elf32-score.c | ||
| elf32-score.h | ||
| elf32-sh64-com.c | ||
| elf32-sh64.c | ||
| elf32-sh64.h | ||
| elf32-sh-relocs.h | ||
| elf32-sh-symbian.c | ||
| elf32-sh.c | ||
| elf32-sparc.c | ||
| elf32-spu.c | ||
| elf32-spu.h | ||
| elf32-tic6x.c | ||
| elf32-tic6x.h | ||
| elf32-tilegx.c | ||
| elf32-tilegx.h | ||
| elf32-tilepro.c | ||
| elf32-tilepro.h | ||
| elf32-v850.c | ||
| elf32-vax.c | ||
| elf32-xc16x.c | ||
| elf32-xgate.c | ||
| elf32-xgate.h | ||
| elf32-xstormy16.c | ||
| elf32-xtensa.c | ||
| elf32.c | ||
| elf64-alpha.c | ||
| elf64-gen.c | ||
| elf64-hppa.c | ||
| elf64-hppa.h | ||
| elf64-ia64-vms.c | ||
| elf64-mips.c | ||
| elf64-mmix.c | ||
| elf64-ppc.c | ||
| elf64-ppc.h | ||
| elf64-s390.c | ||
| elf64-sh64.c | ||
| elf64-sparc.c | ||
| elf64-tilegx.c | ||
| elf64-tilegx.h | ||
| elf64-x86-64.c | ||
| elf64.c | ||
| elf-attrs.c | ||
| elf-bfd.h | ||
| elf-eh-frame.c | ||
| elf-hppa.h | ||
| elf-ifunc.c | ||
| elf-linux-psinfo.h | ||
| elf-m10200.c | ||
| elf-m10300.c | ||
| elf-nacl.c | ||
| elf-nacl.h | ||
| elf-s390-common.c | ||
| elf-strtab.c | ||
| elf-vxworks.c | ||
| elf-vxworks.h | ||
| elf.c | ||
| elfcode.h | ||
| elfcore.h | ||
| elflink.c | ||
| elfn32-mips.c | ||
| elfnn-aarch64.c | ||
| elfnn-ia64.c | ||
| elfxx-aarch64.c | ||
| elfxx-aarch64.h | ||
| elfxx-ia64.c | ||
| elfxx-ia64.h | ||
| elfxx-mips.c | ||
| elfxx-mips.h | ||
| elfxx-sparc.c | ||
| elfxx-sparc.h | ||
| elfxx-target.h | ||
| elfxx-tilegx.c | ||
| elfxx-tilegx.h | ||
| epoc-pe-arm.c | ||
| epoc-pei-arm.c | ||
| format.c | ||
| freebsd.h | ||
| gen-aout.c | ||
| genlink.h | ||
| go32stub.h | ||
| hash.c | ||
| host-aout.c | ||
| hp300bsd.c | ||
| hp300hpux.c | ||
| hppabsd-core.c | ||
| hpux-core.c | ||
| i386aout.c | ||
| i386bsd.c | ||
| i386dynix.c | ||
| i386freebsd.c | ||
| i386linux.c | ||
| i386lynx.c | ||
| i386mach3.c | ||
| i386msdos.c | ||
| i386netbsd.c | ||
| i386os9k.c | ||
| ieee.c | ||
| ihex.c | ||
| init.c | ||
| irix-core.c | ||
| libaout.h | ||
| libbfd-in.h | ||
| libbfd.c | ||
| libbfd.h | ||
| libcoff-in.h | ||
| libcoff.h | ||
| libecoff.h | ||
| libhppa.h | ||
| libieee.h | ||
| libnlm.h | ||
| liboasys.h | ||
| libpei.h | ||
| libxcoff.h | ||
| linker.c | ||
| lynx-core.c | ||
| m68k4knetbsd.c | ||
| m68klinux.c | ||
| m68knetbsd.c | ||
| m88kmach3.c | ||
| m88kopenbsd.c | ||
| mach-o-i386.c | ||
| mach-o-target.c | ||
| mach-o-x86-64.c | ||
| mach-o.c | ||
| mach-o.h | ||
| MAINTAINERS | ||
| Makefile.am | ||
| Makefile.in | ||
| makefile.vms | ||
| mep-relocs.pl | ||
| merge.c | ||
| mipsbsd.c | ||
| mmo.c | ||
| netbsd-core.c | ||
| netbsd.h | ||
| newsos3.c | ||
| nlm32-alpha.c | ||
| nlm32-i386.c | ||
| nlm32-ppc.c | ||
| nlm32-sparc.c | ||
| nlm32.c | ||
| nlm64.c | ||
| nlm-target.h | ||
| nlm.c | ||
| nlmcode.h | ||
| nlmswap.h | ||
| ns32k.h | ||
| ns32knetbsd.c | ||
| oasys.c | ||
| opncls.c | ||
| osf-core.c | ||
| pc532-mach.c | ||
| pdp11.c | ||
| pe-arm-wince.c | ||
| pe-arm.c | ||
| pe-i386.c | ||
| pe-mcore.c | ||
| pe-mips.c | ||
| pe-ppc.c | ||
| pe-sh.c | ||
| pe-x86_64.c | ||
| pef-traceback.h | ||
| pef.c | ||
| pef.h | ||
| pei-arm-wince.c | ||
| pei-arm.c | ||
| pei-i386.c | ||
| pei-ia64.c | ||
| pei-mcore.c | ||
| pei-mips.c | ||
| pei-ppc.c | ||
| pei-sh.c | ||
| pei-x86_64.c | ||
| peicode.h | ||
| peXXigen.c | ||
| plugin.c | ||
| plugin.h | ||
| PORTING | ||
| ppcboot.c | ||
| ptrace-core.c | ||
| README | ||
| reloc16.c | ||
| reloc.c | ||
| riscix.c | ||
| rs6000-core.c | ||
| sco5-core.c | ||
| section.c | ||
| simple.c | ||
| som.c | ||
| som.h | ||
| sparclinux.c | ||
| sparclynx.c | ||
| sparcnetbsd.c | ||
| srec.c | ||
| stab-syms.c | ||
| stabs.c | ||
| stamp-h.in | ||
| sunos.c | ||
| syms.c | ||
| sysdep.h | ||
| targets.c | ||
| targmatch.sed | ||
| tekhex.c | ||
| TODO | ||
| trad-core.c | ||
| vax1knetbsd.c | ||
| vaxbsd.c | ||
| vaxnetbsd.c | ||
| verilog.c | ||
| versados.c | ||
| version.h | ||
| vms-alpha.c | ||
| vms-lib.c | ||
| vms-misc.c | ||
| vms.h | ||
| warning.m4 | ||
| xcofflink.c | ||
| xsym.c | ||
| xsym.h | ||
| xtensa-isa.c | ||
| xtensa-modules.c | ||
BFD is an object file library. It permits applications to use the
same routines to process object files regardless of their format.
BFD is used by the GNU debugger, assembler, linker, and the binary
utilities.
The documentation on using BFD is scanty and may be occasionally
incorrect. Pointers to documentation problems, or an entirely
rewritten manual, would be appreciated.
There is some BFD internals documentation in doc/bfdint.texi which may
help programmers who want to modify BFD.
BFD is normally built as part of another package. See the build
instructions for that package, probably in a README file in the
appropriate directory.
BFD supports the following configure options:
--target=TARGET
The default target for which to build the library. TARGET is
a configuration target triplet, such as sparc-sun-solaris.
--enable-targets=TARGET,TARGET,TARGET...
Additional targets the library should support. To include
support for all known targets, use --enable-targets=all.
--enable-64-bit-bfd
Include support for 64 bit targets. This is automatically
turned on if you explicitly request a 64 bit target, but not
for --enable-targets=all. This requires a compiler with a 64
bit integer type, such as gcc.
--enable-shared
Build BFD as a shared library.
--with-mmap
Use mmap when accessing files. This is faster on some hosts,
but slower on others. It may not work on all hosts.
Report bugs with BFD to bug-binutils@gnu.org.
Patches are encouraged. When sending patches, always send the output
of diff -u or diff -c from the original file to the new file. Do not
send default diff output. Do not make the diff from the new file to
the original file. Remember that any patch must not break other
systems. Remember that BFD must support cross compilation from any
host to any target, so patches which use ``#ifdef HOST'' are not
acceptable. Please also read the ``Reporting Bugs'' section of the
gcc manual.
Bug reports without patches will be remembered, but they may never get
fixed until somebody volunteers to fix them.
Copyright (C) 2012-2014 Free Software Foundation, Inc.
Copying and distribution of this file, with or without modification,
are permitted in any medium without royalty provided the copyright
notice and this notice are preserved.