diff options
Diffstat (limited to 'chapter06/binutils.xml')
| -rw-r--r-- | chapter06/binutils.xml | 157 |
1 files changed, 117 insertions, 40 deletions
diff --git a/chapter06/binutils.xml b/chapter06/binutils.xml index d0eb862a6..cee1136c7 100644 --- a/chapter06/binutils.xml +++ b/chapter06/binutils.xml @@ -95,96 +95,173 @@ some packages:</para> </sect2> -<sect2 id="contents-binutils"><title>Contents of Binutils</title> - -<para><emphasis>Installed programs</emphasis>: addr2line, ar, as, c++filt, -gprof, ld, nm, objcopy, objdump, ranlib, readelf, size, strings and -strip</para> - -<para><emphasis>Installed libraries</emphasis>: libiberty.a, libbfd.[a,so] and -libopcodes.[a,so]</para> - -</sect2> +<sect2 id="contents-binutils" role="content"><title>Contents of Binutils</title> +<segmentedlist> +<segtitle>Installed programs</segtitle> +<segtitle>Installed libraries</segtitle> +<seglistitem><seg>addr2line, ar, as, c++filt, gprof, ld, nm, objcopy, objdump, +ranlib, readelf, size, strings and strip</seg> +<seg>libiberty.a, libbfd.[a,so] and libopcodes.[a,so]</seg></seglistitem> +</segmentedlist> -<sect2><title>Short descriptions</title> +<variablelist><title>Short descriptions</title> +<varlistentry> +<term id="addr2line"><command>addr2line</command></term> +<listitem> <indexterm zone="ch-system-binutils addr2line"><primary sortas="b-addr2line">addr2line</primary></indexterm> -<para id="addr2line"><command>addr2line</command> translates program addresses to file +<para>translates program addresses to file names and line numbers. Given an address and the name of an executable, it uses the debugging information in the executable to figure out which source file and line number are associated with the address.</para> +</listitem> +</varlistentry> +<varlistentry> +<term id="ar"><command>ar</command></term> +<listitem> <indexterm zone="ch-system-binutils ar"><primary sortas="b-ar">ar</primary></indexterm> -<para id="ar"><command>ar</command> creates, modifies, and extracts from archives. An archive +<para>creates, modifies, and extracts from archives. An archive is a single file holding a collection of other files in a structure that makes it possible to retrieve the original individual files (called members of the archive).</para> +</listitem> +</varlistentry> +<varlistentry> +<term id="as"><command>as</command></term> +<listitem> <indexterm zone="ch-system-binutils as"><primary sortas="b-as">as</primary></indexterm> -<para id="as"><command>as</command> is an assembler. It assembles the output of -gcc into object files.</para> +<para>is an assembler. It assembles the output of gcc into object files.</para> +</listitem> +</varlistentry> +<varlistentry> +<term id="c-filt"><command>c++filt</command></term> +<listitem> <indexterm zone="ch-system-binutils c-filt"><primary sortas="b-c++filt">c++filt</primary></indexterm> -<para id="c-filt"><command>c++filt</command> is used by the linker to de-mangle C++ and +<para>is used by the linker to de-mangle C++ and Java symbols, to keep overloaded functions from clashing.</para> +</listitem> +</varlistentry> +<varlistentry> +<term id="gprof"><command>gprof</command></term> +<listitem> <indexterm zone="ch-system-binutils gprof"><primary sortas="b-gprof">gprof</primary></indexterm> -<para id="gprof"><command>gprof</command> displays call graph profile data.</para> +<para>displays call graph profile data.</para> +</listitem> +</varlistentry> +<varlistentry> +<term id="ld"><command>ld</command></term> +<listitem> <indexterm zone="ch-system-binutils ld"><primary sortas="b-ld">ld</primary></indexterm> -<para id="ld"><command>ld</command> is a linker. It combines a number of object -and archive files into a single file, relocating their data and tying up symbol -references.</para> - +<para>is a linker. It combines a number of object and archive files into a single file, +relocating their data and tying up symbol references.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term id="nm"><command>nm</command></term> +<listitem> <indexterm zone="ch-system-binutils nm"><primary sortas="b-nm">nm</primary></indexterm> -<para id="nm"><command>nm</command> lists the symbols occurring in a given object file.</para> +<para>lists the symbols occurring in a given object file.</para> +</listitem> +</varlistentry> +<varlistentry> +<term id="objcopy"><command>objcopy</command></term> +<listitem> <indexterm zone="ch-system-binutils objcopy"><primary sortas="b-objcopy">objcopy</primary></indexterm> -<para id="objcopy"><command>objcopy</command> is used to translate one type of object -file into another.</para> +<para>is used to translate one type of object file into another.</para> +</listitem> +</varlistentry> +<varlistentry> +<term id="objdump"><command>objdump</command></term> +<listitem> <indexterm zone="ch-system-binutils objdump"><primary sortas="b-objdump">objdump</primary></indexterm> -<para id="objdump"><command>objdump</command> displays information about the given -object file, with options controlling what particular information to display. -The information shown is mostly only useful to programmers who are working on -the compilation tools.</para> - +<para>displays information about the given object file, with options controlling what +particular information to display. The information shown is mostly only useful to +programmers who are working on the compilation tools.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term id="ranlib"><command>ranlib</command></term> +<listitem> <indexterm zone="ch-system-binutils ranlib"><primary sortas="b-ranlib">ranlib</primary></indexterm> -<para id="ranlib"><command>ranlib</command> generates an index of the contents of an +<para>generates an index of the contents of an archive, and stores it in the archive. The index lists all the symbols defined by archive members that are relocatable object files.</para> +</listitem> +</varlistentry> +<varlistentry> +<term id="readelf"><command>readelf</command></term> +<listitem> <indexterm zone="ch-system-binutils readelf"><primary sortas="b-readelf">readelf</primary></indexterm> -<para id="readelf"><command>readelf</command> displays information about elf type binaries.</para> +<para>displays information about elf type binaries.</para> +</listitem> +</varlistentry> +<varlistentry> +<term id="size"><command>size</command></term> +<listitem> <indexterm zone="ch-system-binutils size"><primary sortas="b-size">size</primary></indexterm> -<para id="size"><command>size</command> lists the section sizes -- and the grand -total -- for the given object files.</para> +<para>lists the section sizes -- and the grand total -- for the given object files.</para> +</listitem> +</varlistentry> +<varlistentry> +<term id="strings"><command>strings</command></term> +<listitem> <indexterm zone="ch-system-binutils strings"><primary sortas="b-strings">strings</primary></indexterm> -<para id="strings"><command>strings</command> outputs, for each given file, the sequences +<para>outputs, for each given file, the sequences of printable characters that are of at least the specified length (defaulting to 4). For object files it prints, by default, only the strings from the initializing and loading sections. For other types of files it scans the whole file.</para> +</listitem> +</varlistentry> +<varlistentry> +<term id="strip"><command>strip</command></term> +<listitem> <indexterm zone="ch-system-binutils strip"><primary sortas="b-strip">strip</primary></indexterm> -<para id="strip"><command>strip</command> discards symbols from object files.</para> +<para>discards symbols from object files.</para> +</listitem> +</varlistentry> +<varlistentry> +<term id="libiberty"><command>libiberty</command></term> +<listitem> <indexterm zone="ch-system-binutils libiberty"><primary sortas="c-libiberty">libiberty</primary></indexterm> -<para id="libiberty"><command>libiberty</command> contains routines used by various GNU +<para>contains routines used by various GNU programs, including getopt, obstack, strerror, strtol and strtoul.</para> +</listitem> +</varlistentry> +<varlistentry> +<term id="libbfd"><command>libbfd</command></term> +<listitem> <indexterm zone="ch-system-binutils libbfd"><primary sortas="c-libbfd">libbfd</primary></indexterm> -<para id="libbfd"><command>libbfd</command> is the Binary File Descriptor library.</para> +<para>is the Binary File Descriptor library.</para> +</listitem> +</varlistentry> +<varlistentry> +<term id="libopcodes"><command>libopcodes</command></term> +<listitem> <indexterm zone="ch-system-binutils libopcodes"><primary sortas="c-libopcodes">libopcodes</primary></indexterm> -<para id="libopcodes"><command>libopcodes</command> is a library for dealing with opcodes. +<para>is a library for dealing with opcodes. It is used for building utilities like objdump. Opcodes are the <quote>readable text</quote> versions of instructions for the processor.</para> +</listitem> +</varlistentry> +</variablelist> </sect2> - - </sect1> |