Ignore:
Timestamp:
09/22/2001 04:09:47 PM (23 years ago)
Author:
Mark Hymers <markh@…>
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, v3_1, v3_2, v3_3, v4_0, v4_1, v5_0, v5_1, v5_1_1, 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:
6fb47f4
Parents:
eb33fb1
Message:

[Bug 190] Put descs in alphabetical order

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

File:
1 edited

Legend:

Unmodified
Added
Removed

  • appendixa/binutils-desc.xml

    reb33fb1 r53ad30a  
    22<title>Contents</title>
    33
    4 <para>The Binutils package contains the gasp, gprof, ld, as, ar, nm, objcopy,
    5 objdump, ranlib, readelf,  size, strings, strip, c++filt and addr2line
     4<para>The Binutils package contains the addr2line, as, ar, c++filt, gasp,
     5gprof, ld, nm, objcopy, objdump, ranlib, readelf, size, strings and strip
    66programs</para>
    77
    … …  
    1010<sect2><title>Description</title>
    1111
    12 <sect3><title>gasp</title>
    13 
    14 <para>Gasp is the Assembler Macro Preprocessor.</para>
    15 
    16 </sect3>
    17 
    18 <sect3><title>gprof</title>
    19 
    20 <para>gprof displays call graph profile data.</para>
    21 
    22 </sect3>
    23 
    24 <sect3><title>ld</title>
    25 
    26 <para>ld combines a number of object and archive files,  relocates  their data
    27 and ties up symbol references. Often the last step in building a new compiled
    28 program to run is a call to ld.</para>
    29 
    30 </sect3>
     12<sect3><title>addr2line</title>
     13<para>addr2line translates program addresses into file names and line numbers.
     14Given an address and an executable, it uses the  debugging information in
     15the executable to figure out which file name and line number are associated
     16with a given address.</para></sect3>
    3117
    3218<sect3><title>as</title>
    33 
    3419<para>as is primarily intended to assemble the output of the GNU C compiler gcc
    35 for use by the linker ld.</para>
    36 
    37 </sect3>
     20for use by the linker ld.</para></sect3>
    3821
    3922<sect3><title>ar</title>
    40 
    4123<para>The ar program creates, modifies, and extracts from archives. An archive
    4224is a single file holding a collection of other files in a structure that makes
    4325it  possible to retrieve the original individual files (called members of
    44 the archive).</para>
     26the archive).</para></sect3>
    4527
    46 </sect3>
     28<sect3><title>c++filt</title>
     29<para>The C++ language provides function overloading, which means that it is
     30possible to
     31write many functions with the same name (providing each takes parameters
     32of different types).  All C++ function names are encoded into a low-level
     33assembly label (this process is known as mangling). The c++filt program
     34does the inverse mapping: it decodes (demangles) low-level names into
     35user-level names so that the linker can keep these overloaded functions
     36from clashing.</para></sect3>
     37
     38<sect3><title>gasp</title>
     39<para>Gasp is the Assembler Macro Preprocessor.</para></sect3>
     40
     41<sect3><title>gprof</title>
     42<para>gprof displays call graph profile data.</para></sect3>
     43
     44<sect3><title>ld</title>
     45<para>ld combines a number of object and archive files,  relocates  their data
     46and ties up symbol references. Often the last step in building a new compiled
     47program to run is a call to ld.</para></sect3>
    4748
    4849<sect3><title>nm</title>
    49 
    50 <para>nm lists the symbols from object files.</para>
    51 
    52 </sect3>
     50<para>nm lists the symbols from object files.</para></sect3>
    5351
    5452<sect3><title>objcopy</title>
    55 
    5653<para>objcopy utility copies the contents of an object file to another. objcopy
    5754uses the GNU BFD Library to read and write the object files. It can write
    5855the destination object file in a format different from that of the source
    59 object file.</para>
    60 
    61 </sect3>
     56object file.</para></sect3>
    6257
    6358<sect3><title>objdump</title>
    64 
    6559<para>objdump displays information about one or more object files. The options
    6660control what particular information to display. This information is mostly
    6761useful to programmers who are working on the compilation tools, as opposed to
    68 programmers who just want their program to compile and work.</para>
    69 
    70 </sect3>
     62programmers who just want their program to compile and work.</para></sect3>
    7163
    7264<sect3><title>ranlib</title>
    73 
    7465<para>ranlib generates an index to the contents of an archive, and stores it in
    7566the archive.  The index lists each symbol defined by a member of an archive
    76 that is a relocatable object file.</para>
    77 
    78 </sect3>
     67that is a relocatable object file.</para></sect3>
    7968
    8069<sect3><title>readelf</title>
    81 
    82 <para>readelf displays information about elf type binaries.</para>
    83 
    84 </sect3>
     70<para>readelf displays information about elf type binaries.</para></sect3>
    8571
    8672<sect3><title>size</title>
    87 
    8873<para>size lists the section sizes --and the total size-- for each of the
    8974object files objfile in its argument  list. By default, one line of output is
    90 generated for each object file or each module in an archive.</para>
    91 
    92 </sect3>
     75generated for each object file or each module in an archive.</para></sect3>
    9376
    9477<sect3><title>strings</title>
    95 
    9678<para>For each  file  given, strings prints the printable character sequences
    9779that are at least  4  characters  long (or the number specified with an
    … …  
    10183from the whole file.</para>
    10284
    103 <para>strings is mainly useful for determining the contents of non-text files.</para>
    104 
    105 </sect3>
     85<para>strings is mainly useful for determining the contents of non-text files.</para></sect3>
    10686
    10787<sect3><title>strip</title>
    108 
    10988<para>strip discards all or specific symbols from object files. The list of
    11089object files may include archives. At least one object file must be
    11190given. strip modifies the files named in its argument, rather than writing
    112 modified copies under different names.</para>
    113 
    114 </sect3>
    115 
    116 <sect3><title>c++filt</title>
    117 
    118 <para>The C++ language provides function overloading, which means that it is
    119 possible to
    120 write many functions with the same name (providing each takes parameters
    121 of different types).  All C++ function names are encoded into a low-level
    122 assembly label (this process is known as mangling). The c++filt program
    123 does the inverse mapping: it decodes (demangles) low-level names into
    124 user-level names so that the linker can keep these overloaded functions
    125 from clashing.</para>
    126 
    127 </sect3>
    128 
    129 <sect3><title>addr2line</title>
    130 
    131 <para>addr2line translates program addresses into file names and line numbers.
    132 Given an address and an executable, it uses the  debugging information in
    133 the executable to figure out which file name and line number are associated
    134 with a given address.</para>
    135 
    136 </sect3>
     91modified copies under different names.</para></sect3>
    13792
    13893</sect2>
Note: See TracChangeset for help on using the changeset viewer.