Home | History | Annotate | Line # | Download | only in bfd 
      1   1.1  christos BFD is an object file library.  It permits applications to use the
      2   1.1  christos same routines to process object files regardless of their format.
      3   1.1  christos 
      4   1.1  christos BFD is used by the GNU debugger, assembler, linker, and the binary
      5   1.1  christos utilities.
      6   1.1  christos 
      7   1.1  christos The documentation on using BFD is scanty and may be occasionally
      8   1.1  christos incorrect.  Pointers to documentation problems, or an entirely
      9   1.1  christos rewritten manual, would be appreciated.
     10   1.1  christos 
     11   1.1  christos There is some BFD internals documentation in doc/bfdint.texi which may
     12   1.1  christos help programmers who want to modify BFD.
     13   1.1  christos 
     14   1.1  christos BFD is normally built as part of another package.  See the build
     15   1.1  christos instructions for that package, probably in a README file in the
     16   1.1  christos appropriate directory.
     17   1.1  christos 
     18   1.1  christos BFD supports the following configure options:
     19   1.1  christos 
     20   1.1  christos   --target=TARGET
     21   1.1  christos 	The default target for which to build the library.  TARGET is
     22   1.1  christos 	a configuration target triplet, such as sparc-sun-solaris.
     23   1.1  christos   --enable-targets=TARGET,TARGET,TARGET...
     24   1.1  christos 	Additional targets the library should support.  To include
     25   1.1  christos 	support for all known targets, use --enable-targets=all.
     26   1.1  christos   --enable-64-bit-bfd
     27   1.1  christos 	Include support for 64 bit targets.  This is automatically
     28   1.1  christos 	turned on if you explicitly request a 64 bit target, but not
     29   1.1  christos 	for --enable-targets=all.  This requires a compiler with a 64
     30   1.1  christos 	bit integer type, such as gcc.
     31   1.1  christos   --enable-shared
     32   1.1  christos 	Build BFD as a shared library.
     33   1.1  christos   --with-mmap
     34   1.1  christos 	Use mmap when accessing files.  This is faster on some hosts,
     35   1.1  christos 	but slower on others.  It may not work on all hosts.
     36   1.1  christos 
     37  1.10  christos Report bugs in BFD to https://sourceware.org/bugzilla/
     38   1.1  christos 
     39   1.1  christos Patches are encouraged.  When sending patches, always send the output
     40   1.1  christos of diff -u or diff -c from the original file to the new file.  Do not
     41   1.1  christos send default diff output.  Do not make the diff from the new file to
     42   1.1  christos the original file.  Remember that any patch must not break other
     43   1.1  christos systems.  Remember that BFD must support cross compilation from any
     44   1.1  christos host to any target, so patches which use ``#ifdef HOST'' are not
     45   1.1  christos acceptable.  Please also read the ``Reporting Bugs'' section of the
     46   1.1  christos gcc manual.
     47   1.1  christos 
     48   1.1  christos Bug reports without patches will be remembered, but they may never get
     49   1.1  christos fixed until somebody volunteers to fix them.
     50   1.1  christos 
     52   1.1  christos Copyright (C) 2012-2024 Free Software Foundation, Inc.
     53   1.1  christos 
     54   1.1  christos Copying and distribution of this file, with or without modification,
     55   1.1  christos are permitted in any medium without royalty provided the copyright
     56                 notice and this notice are preserved.
     57