Added a few comments here and there
[linux_from_scratch.git] / BOOK / appendixa / binutils-desc.xml
blobc4eaa0732d21e7a71678af9203c21e53e737f9bb
1 <sect2><title>Short descriptions</title>
3 <para><command>addr2line</command> translates program addresses to file
4 names and line numbers. Given an address and the name of an executable, it
5 uses the debugging information in the executable to figure out which source
6 file and line number are associated with the address.</para>
8 <para><command>ar</command> creates, modifies, and extracts from archives. An archive
9 is a single file holding a collection of other files in a structure that makes
10 it possible to retrieve the original individual files (called members of
11 the archive).</para>
13 <para><command>as</command> is an assembler. It assembles the output of
14 gcc into object files.</para>
16 <para><command>c++filt</command> is used by the linker to demangle C++ and
17 Java symbols, to keep overloaded functions from clashing.</para>
19 <para><command>gprof</command> displays call graph profile data.</para>
21 <para><command>ld</command> is a linker. It combines a number of object
22 and archive files into a single file, relocating their data and tying up symbol
23 references.</para>
25 <para><command>nm</command> lists the symbols occurring in a given object file.</para>
27 <para><command>objcopy</command> is used to translate one type of object
28 file into another.</para>
30 <para><command>objdump</command> displays information about the given
31 object file, with options controlling what particular information to display.
32 The information shown is mostly only useful to programmers who are working on
33 the compilation tools.</para>
35 <para><command>ranlib</command> generates an index of the contents of an
36 archive, and stores it in the archive. The index lists all the symbols defined
37 by archive members that are relocatable object files.</para>
39 <para><command>readelf</command> displays information about elf type binaries.</para>
41 <para><command>size</command> lists the section sizes -- and the grand
42 total -- for the given object files.</para>
44 <para><command>strings</command> outputs for each file given the sequences
45 of printable characters that are of at least the specified length (defaulting to 4)
46 For object files it prints by default only the strings from the initializing
47 and loading sections. For other types of files it scans the whole file.</para>
49 <para><command>strip</command> discards symbols from object files.</para>
51 <para><command>libiberty</command> contains routines used by various GNU
52 programs, including getopt, obstack, strerror, strtol and strtoul.</para>
54 <para><command>libbfd</command> is the Binary File Descriptor library.</para>
56 <para><command>libopcodes</command> is a library for dealing with opcodes.
57 It is used for building utilities like objdump. Opcodes are the "readable text"
58 versions of instructions for the processor.</para>
60 </sect2>