[ce14c07] | 1 | <sect2><title> </title><para> </para></sect2>
|
---|
| 2 |
|
---|
[1bbb24b] | 3 | <sect2><title>Descriptions</title>
|
---|
[8fcc2c0] | 4 |
|
---|
[087e584] | 5 | <para>(Last checked against version &binutils-contversion;.)</para>
|
---|
[6370fa6] | 6 |
|
---|
[ab28d5f] | 7 | <sect3><title>Program file descriptions</title>
|
---|
[6370fa6] | 8 |
|
---|
[bdc08c1] | 9 | <sect4><title>addr2line</title>
|
---|
[53ad30a] | 10 | <para>addr2line translates program addresses into file names and line numbers.
|
---|
[2c094d6] | 11 | Given an address and an executable, it uses the debugging information in
|
---|
[53ad30a] | 12 | the executable to figure out which file name and line number are associated
|
---|
[bdc08c1] | 13 | with a given address.</para></sect4>
|
---|
[6370fa6] | 14 |
|
---|
[bdc08c1] | 15 | <sect4><title>ar</title>
|
---|
[b822811] | 16 | <para>The ar program creates, modifies, and extracts from archives. An archive
|
---|
| 17 | is a single file holding a collection of other files in a structure that makes
|
---|
[2c094d6] | 18 | it possible to retrieve the original individual files (called members of
|
---|
[bdc08c1] | 19 | the archive).</para></sect4>
|
---|
[6370fa6] | 20 |
|
---|
[bdc08c1] | 21 | <sect4><title>as</title>
|
---|
[764d8f4] | 22 | <para>as is primarily intended to assemble the output of the GNU C compiler,
|
---|
| 23 | gcc, for use by the linker ld.</para></sect4>
|
---|
[bdc08c1] | 24 |
|
---|
| 25 | <sect4><title>gprof</title>
|
---|
| 26 | <para>gprof displays call graph profile data.</para></sect4>
|
---|
[53ad30a] | 27 |
|
---|
[bdc08c1] | 28 | <sect4><title>ld</title>
|
---|
[2c094d6] | 29 | <para>ld combines a number of object and archive files, relocates their data
|
---|
[53ad30a] | 30 | and ties up symbol references. Often the last step in building a new compiled
|
---|
[bdc08c1] | 31 | program to run is a call to ld.</para></sect4>
|
---|
[6370fa6] | 32 |
|
---|
[bdc08c1] | 33 | <sect4><title>nm</title>
|
---|
| 34 | <para>nm lists the symbols from object files.</para></sect4>
|
---|
[6370fa6] | 35 |
|
---|
[bdc08c1] | 36 | <sect4><title>objcopy</title>
|
---|
[b822811] | 37 | <para>objcopy utility copies the contents of an object file to another. objcopy
|
---|
[6370fa6] | 38 | uses the GNU BFD Library to read and write the object files. It can write
|
---|
| 39 | the destination object file in a format different from that of the source
|
---|
[bdc08c1] | 40 | object file.</para></sect4>
|
---|
[6370fa6] | 41 |
|
---|
[bdc08c1] | 42 | <sect4><title>objdump</title>
|
---|
[b822811] | 43 | <para>objdump displays information about one or more object files. The options
|
---|
[6370fa6] | 44 | control what particular information to display. This information is mostly
|
---|
| 45 | useful to programmers who are working on the compilation tools, as opposed to
|
---|
[bdc08c1] | 46 | programmers who just want their program to compile and work.</para></sect4>
|
---|
[6370fa6] | 47 |
|
---|
[bdc08c1] | 48 | <sect4><title>ranlib</title>
|
---|
[b822811] | 49 | <para>ranlib generates an index to the contents of an archive, and stores it in
|
---|
[2c094d6] | 50 | the archive. The index lists each symbol defined by an archive member
|
---|
[bdc08c1] | 51 | that is a relocatable object file.</para></sect4>
|
---|
[6370fa6] | 52 |
|
---|
[bdc08c1] | 53 | <sect4><title>readelf</title>
|
---|
| 54 | <para>readelf displays information about elf type binaries.</para></sect4>
|
---|
[0c07a90] | 55 |
|
---|
[bdc08c1] | 56 | <sect4><title>size</title>
|
---|
[764d8f4] | 57 | <para>size lists the section sizes --and the total size-- for each of the
|
---|
| 58 | object files in its argument list. By default, one line of output is
|
---|
[bdc08c1] | 59 | generated for each object file or each module in an archive.</para></sect4>
|
---|
[6370fa6] | 60 |
|
---|
[bdc08c1] | 61 | <sect4><title>strings</title>
|
---|
[2c094d6] | 62 | <para>For each file given, strings prints the printable character sequences
|
---|
| 63 | that are at least 4 characters long (or the number specified with an
|
---|
[6370fa6] | 64 | option to the program) and are followed by an unprintable character. By
|
---|
| 65 | default, it only prints the strings from the initialized and loaded
|
---|
[764d8f4] | 66 | sections of object files. For other types of files, it prints the strings
|
---|
[b822811] | 67 | from the whole file.</para>
|
---|
[6370fa6] | 68 |
|
---|
[bdc08c1] | 69 | <para>strings is mainly useful for determining the contents of non-text files.</para></sect4>
|
---|
[6370fa6] | 70 |
|
---|
[bdc08c1] | 71 | <sect4><title>strip</title>
|
---|
[b822811] | 72 | <para>strip discards all or specific symbols from object files. The list of
|
---|
[6370fa6] | 73 | object files may include archives. At least one object file must be
|
---|
| 74 | given. strip modifies the files named in its argument, rather than writing
|
---|
[bdc08c1] | 75 | modified copies under different names.</para></sect4>
|
---|
| 76 |
|
---|
| 77 | </sect3>
|
---|
| 78 |
|
---|
[ab28d5f] | 79 | <sect3><title>Library file descriptions</title>
|
---|
[bdc08c1] | 80 |
|
---|
| 81 | <sect4><title>libbfd</title>
|
---|
| 82 | <para>libbfd is the Binary File Descriptor library.</para></sect4>
|
---|
| 83 |
|
---|
| 84 | <sect4><title>libopcodes</title>
|
---|
[926b857] | 85 | <para>libopcodes is a native library for dealing with opcodes and is
|
---|
[2c094d6] | 86 | used in the course of building utilities such as objdump. Opcodes are
|
---|
[926b857] | 87 | actually "readable text" versions of instructions for the
|
---|
| 88 | processor.</para></sect4>
|
---|
[bdc08c1] | 89 |
|
---|
| 90 | </sect3>
|
---|
[6370fa6] | 91 |
|
---|
| 92 | </sect2>
|
---|
| 93 |
|
---|