Ignore:
Timestamp:
05/17/2004 09:55:01 PM (20 years ago)
Author:
Manuel Canales Esparcia <manuel@…>
Branches:
10.0, 10.0-rc1, 10.1, 10.1-rc1, 11.0, 11.0-rc1, 11.0-rc2, 11.0-rc3, 11.1, 11.1-rc1, 11.2, 11.2-rc1, 11.3, 11.3-rc1, 12.0, 12.0-rc1, 12.1, 12.1-rc1, 6.0, 6.1, 6.1.1, 6.3, 6.4, 6.5, 6.6, 6.7, 6.8, 7.0, 7.1, 7.2, 7.3, 7.4, 7.5, 7.5-systemd, 7.6, 7.6-systemd, 7.7, 7.7-systemd, 7.8, 7.8-systemd, 7.9, 7.9-systemd, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, arm, bdubbs/gcc13, ml-11.0, multilib, renodr/libudev-from-systemd, s6-init, trunk, xry111/arm64, xry111/arm64-12.0, xry111/clfs-ng, xry111/lfs-next, xry111/loongarch, xry111/loongarch-12.0, xry111/loongarch-12.1, xry111/mips64el, xry111/pip3, xry111/rust-wip-20221008, xry111/update-glibc
Children:
6f461cb
Parents:
01b2724c
Message:

HEAD: Retagged the Contents of ... sections.

git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@3621 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689

File:
1 edited

Legend:

Unmodified
Added
Removed
  • chapter06/binutils.xml

    r01b2724c rc6cb3aa  
    9696
    9797
    98 <sect2 id="contents-binutils"><title>Contents of Binutils</title>
    99 
    100 <para><emphasis>Installed programs</emphasis>: addr2line, ar, as, c++filt,
    101 gprof, ld, nm, objcopy, objdump, ranlib, readelf, size, strings and
    102 strip</para>
    103 
    104 <para><emphasis>Installed libraries</emphasis>: libiberty.a, libbfd.[a,so] and
    105 libopcodes.[a,so]</para>
    106 
    107 </sect2>
    108 
    109 
    110 <sect2><title>Short descriptions</title>
    111 
     98<sect2 id="contents-binutils" role="content"><title>Contents of Binutils</title>
     99
     100<segmentedlist>
     101<segtitle>Installed programs</segtitle>
     102<segtitle>Installed libraries</segtitle>
     103<seglistitem><seg>addr2line, ar, as, c++filt, gprof, ld, nm, objcopy, objdump,
     104ranlib, readelf, size, strings and strip</seg>
     105<seg>libiberty.a, libbfd.[a,so] and libopcodes.[a,so]</seg></seglistitem>
     106</segmentedlist>
     107
     108<variablelist><title>Short descriptions</title>
     109
     110<varlistentry>
     111<term id="addr2line"><command>addr2line</command></term>
     112<listitem>
    112113<indexterm zone="ch-system-binutils addr2line"><primary sortas="b-addr2line">addr2line</primary></indexterm>
    113 <para id="addr2line"><command>addr2line</command> translates program addresses to file
     114<para>translates program addresses to file
    114115names and line numbers. Given an address and the name of an executable, it
    115116uses the debugging information in the executable to figure out which source
    116117file and line number are associated with the address.</para>
    117 
     118</listitem>
     119</varlistentry>
     120
     121<varlistentry>
     122<term id="ar"><command>ar</command></term>
     123<listitem>
    118124<indexterm zone="ch-system-binutils ar"><primary sortas="b-ar">ar</primary></indexterm>
    119 <para id="ar"><command>ar</command> creates, modifies, and extracts from archives. An archive
     125<para>creates, modifies, and extracts from archives. An archive
    120126is a single file holding a collection of other files in a structure that makes
    121127it possible to retrieve the original individual files (called members of
    122128the archive).</para>
    123 
     129</listitem>
     130</varlistentry>
     131
     132<varlistentry>
     133<term id="as"><command>as</command></term>
     134<listitem>
    124135<indexterm zone="ch-system-binutils as"><primary sortas="b-as">as</primary></indexterm>
    125 <para id="as"><command>as</command> is an assembler. It assembles the output of
    126 gcc into object files.</para>
    127 
     136<para>is an assembler. It assembles the output of gcc into object files.</para>
     137</listitem>
     138</varlistentry>
     139
     140<varlistentry>
     141<term id="c-filt"><command>c++filt</command></term>
     142<listitem>
    128143<indexterm zone="ch-system-binutils c-filt"><primary sortas="b-c++filt">c++filt</primary></indexterm>
    129 <para id="c-filt"><command>c++filt</command> is used by the linker to de-mangle C++ and
     144<para>is used by the linker to de-mangle C++ and
    130145Java symbols, to keep overloaded functions from clashing.</para>
    131 
     146</listitem>
     147</varlistentry>
     148
     149<varlistentry>
     150<term id="gprof"><command>gprof</command></term>
     151<listitem>
    132152<indexterm zone="ch-system-binutils gprof"><primary sortas="b-gprof">gprof</primary></indexterm>
    133 <para id="gprof"><command>gprof</command> displays call graph profile data.</para>
    134 
     153<para>displays call graph profile data.</para>
     154</listitem>
     155</varlistentry>
     156
     157<varlistentry>
     158<term id="ld"><command>ld</command></term>
     159<listitem>
    135160<indexterm zone="ch-system-binutils ld"><primary sortas="b-ld">ld</primary></indexterm>
    136 <para id="ld"><command>ld</command> is a linker. It combines a number of object
    137 and archive files into a single file, relocating their data and tying up symbol
    138 references.</para>
    139 
     161<para>is a linker. It combines a number of object and archive files into a single file,
     162relocating their data and tying up symbol references.</para>
     163</listitem>
     164</varlistentry>
     165
     166<varlistentry>
     167<term id="nm"><command>nm</command></term>
     168<listitem>
    140169<indexterm zone="ch-system-binutils nm"><primary sortas="b-nm">nm</primary></indexterm>
    141 <para id="nm"><command>nm</command> lists the symbols occurring in a given object file.</para>
    142 
     170<para>lists the symbols occurring in a given object file.</para>
     171</listitem>
     172</varlistentry>
     173
     174<varlistentry>
     175<term id="objcopy"><command>objcopy</command></term>
     176<listitem>
    143177<indexterm zone="ch-system-binutils objcopy"><primary sortas="b-objcopy">objcopy</primary></indexterm>
    144 <para id="objcopy"><command>objcopy</command> is used to translate one type of object
    145 file into another.</para>
    146 
     178<para>is used to translate one type of object file into another.</para>
     179</listitem>
     180</varlistentry>
     181
     182<varlistentry>
     183<term id="objdump"><command>objdump</command></term>
     184<listitem>
    147185<indexterm zone="ch-system-binutils objdump"><primary sortas="b-objdump">objdump</primary></indexterm>
    148 <para id="objdump"><command>objdump</command> displays information about the given
    149 object file, with options controlling what particular information to display.
    150 The information shown is mostly only useful to programmers who are working on
    151 the compilation tools.</para>
    152 
     186<para>displays information about the given object file, with options controlling what
     187particular information to display. The information shown is mostly only useful to
     188programmers who are working on the compilation tools.</para>
     189</listitem>
     190</varlistentry>
     191
     192<varlistentry>
     193<term id="ranlib"><command>ranlib</command></term>
     194<listitem>
    153195<indexterm zone="ch-system-binutils ranlib"><primary sortas="b-ranlib">ranlib</primary></indexterm>
    154 <para id="ranlib"><command>ranlib</command> generates an index of the contents of an
     196<para>generates an index of the contents of an
    155197archive, and stores it in the archive. The index lists all the symbols defined
    156198by archive members that are relocatable object files.</para>
    157 
     199</listitem>
     200</varlistentry>
     201
     202<varlistentry>
     203<term id="readelf"><command>readelf</command></term>
     204<listitem>
    158205<indexterm zone="ch-system-binutils readelf"><primary sortas="b-readelf">readelf</primary></indexterm>
    159 <para id="readelf"><command>readelf</command> displays information about elf type binaries.</para>
    160 
     206<para>displays information about elf type binaries.</para>
     207</listitem>
     208</varlistentry>
     209
     210<varlistentry>
     211<term id="size"><command>size</command></term>
     212<listitem>
    161213<indexterm zone="ch-system-binutils size"><primary sortas="b-size">size</primary></indexterm>
    162 <para id="size"><command>size</command> lists the section sizes -- and the grand
    163 total -- for the given object files.</para>
    164 
     214<para>lists the section sizes -- and the grand total -- for the given object files.</para>
     215</listitem>
     216</varlistentry>
     217
     218<varlistentry>
     219<term id="strings"><command>strings</command></term>
     220<listitem>
    165221<indexterm zone="ch-system-binutils strings"><primary sortas="b-strings">strings</primary></indexterm>
    166 <para id="strings"><command>strings</command> outputs, for each given file, the sequences
     222<para>outputs, for each given file, the sequences
    167223of printable characters that are of at least the specified length (defaulting to 4).
    168224For object files it prints, by default, only the strings from the initializing
    169225and loading sections. For other types of files it scans the whole file.</para>
    170 
     226</listitem>
     227</varlistentry>
     228
     229<varlistentry>
     230<term id="strip"><command>strip</command></term>
     231<listitem>
    171232<indexterm zone="ch-system-binutils strip"><primary sortas="b-strip">strip</primary></indexterm>
    172 <para id="strip"><command>strip</command> discards symbols from object files.</para>
    173 
     233<para>discards symbols from object files.</para>
     234</listitem>
     235</varlistentry>
     236
     237<varlistentry>
     238<term id="libiberty"><command>libiberty</command></term>
     239<listitem>
    174240<indexterm zone="ch-system-binutils libiberty"><primary sortas="c-libiberty">libiberty</primary></indexterm>
    175 <para id="libiberty"><command>libiberty</command> contains routines used by various GNU
     241<para>contains routines used by various GNU
    176242programs, including getopt, obstack, strerror, strtol and strtoul.</para>
    177 
     243</listitem>
     244</varlistentry>
     245
     246<varlistentry>
     247<term id="libbfd"><command>libbfd</command></term>
     248<listitem>
    178249<indexterm zone="ch-system-binutils libbfd"><primary sortas="c-libbfd">libbfd</primary></indexterm>
    179 <para id="libbfd"><command>libbfd</command> is the Binary File Descriptor library.</para>
    180 
     250<para>is the Binary File Descriptor library.</para>
     251</listitem>
     252</varlistentry>
     253
     254<varlistentry>
     255<term id="libopcodes"><command>libopcodes</command></term>
     256<listitem>
    181257<indexterm zone="ch-system-binutils libopcodes"><primary sortas="c-libopcodes">libopcodes</primary></indexterm>
    182 <para id="libopcodes"><command>libopcodes</command> is a library for dealing with opcodes.
     258<para>is a library for dealing with opcodes.
    183259It is used for building utilities like objdump. Opcodes are the <quote>readable
    184260text</quote> versions of instructions for the processor.</para>
     261</listitem>
     262</varlistentry>
     263</variablelist>
    185264
    186265</sect2>
    187266
    188 
    189 
    190267</sect1>
Note: See TracChangeset for help on using the changeset viewer.