Changeset 673b0d8 for chapter06/binutils.xml
- Timestamp:
- 05/03/2004 10:59:46 AM (20 years ago)
- 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, 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:
- 0c43171, 2ec64b3, a4a675f
- Parents:
- 287ea55
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
chapter06/binutils.xml
r287ea55 r673b0d8 1 <?xml version="1.0" encoding="ISO-8859-1"?> 2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [ 3 <!ENTITY % general-entities SYSTEM "../general.ent"> 4 %general-entities; 5 ]> 1 6 <sect1 id="ch-system-binutils" xreflabel="Binutils"> 2 <title>Installing Binutils-&binutils-version;</title> 3 <?dbhtml filename="binutils.html" dir="chapter06"?> 7 <title>Binutils-&binutils-version;</title> 8 <?dbhtml filename="binutils.html"?> 9 10 <indexterm zone="ch-system-binutils"><primary sortas="a-Binutils">Binutils</primary></indexterm> 4 11 5 12 <para>The Binutils package contains a linker, an assembler, and other tools for 6 13 handling object files.</para> 7 14 8 <screen>&buildtime; &binutils-time;9 &diskspace; &binutils-compsize;</screen>15 <screen>&buildtime; 1.4 SBU 16 &diskspace; 167 MB</screen> 10 17 11 &aa-binutils-down; 12 &aa-binutils-dep; 18 <para>Binutils installation depends on: Bash, Coreutils, Diffutils, GCC, Gettext, 19 Glibc, Grep, Make, Perl, Sed, Texinfo.</para> 13 20 14 <sect2><title> </title><para> </para></sect2> 21 15 22 16 23 <sect2><title>Installation of Binutils</title> … … 35 42 default optimization flags (including the -march and -mcpu options). 36 43 Therefore, if you have defined any environment variables that override 37 default optimizations, such as CFLAGS and CXXFLAGS, we recommend un setting44 default optimizations, such as CFLAGS and CXXFLAGS, we recommend un-setting 38 45 or modifying them when building Binutils.</para> 39 46 … … 46 53 <para>Now prepare Binutils for compilation:</para> 47 54 48 <screen><userinput>../ &binutils-dir;/configure --prefix=/usr --enable-shared</userinput></screen>55 <screen><userinput>../binutils-&binutils-version;/configure --prefix=/usr --enable-shared</userinput></screen> 49 56 50 57 <para>Compile the package:</para> … … 79 86 some packages:</para> 80 87 81 <screen><userinput>cp ../ &binutils-dir;/include/libiberty.h /usr/include</userinput></screen>88 <screen><userinput>cp ../binutils-&binutils-version;/include/libiberty.h /usr/include</userinput></screen> 82 89 83 90 </sect2> 84 91 85 &aa-binutils-shortdesc; 86 &aa-binutils-desc; 92 93 <sect2 id="contents-binutils"><title>Contents of Binutils</title> 94 95 <para><emphasis>Installed programs</emphasis>: addr2line, ar, as, c++filt, 96 gprof, ld, nm, objcopy, objdump, ranlib, readelf, size, strings and 97 strip</para> 98 99 <para><emphasis>Installed libraries</emphasis>: libiberty.a, libbfd.[a,so] and 100 libopcodes.[a,so]</para> 101 102 </sect2> 103 104 105 <sect2><title>Short descriptions</title> 106 107 <indexterm zone="ch-system-binutils addr2line"><primary sortas="b-addr2line">addr2line</primary></indexterm> 108 <para id="addr2line"><command>addr2line</command> translates program addresses to file 109 names and line numbers. Given an address and the name of an executable, it 110 uses the debugging information in the executable to figure out which source 111 file and line number are associated with the address.</para> 112 113 <indexterm zone="ch-system-binutils ar"><primary sortas="b-ar">ar</primary></indexterm> 114 <para id="ar"><command>ar</command> creates, modifies, and extracts from archives. An archive 115 is a single file holding a collection of other files in a structure that makes 116 it possible to retrieve the original individual files (called members of 117 the archive).</para> 118 119 <indexterm zone="ch-system-binutils as"><primary sortas="b-as">as</primary></indexterm> 120 <para id="as"><command>as</command> is an assembler. It assembles the output of 121 gcc into object files.</para> 122 123 <indexterm zone="ch-system-binutils c-filt"><primary sortas="b-c++filt">c++filt</primary></indexterm> 124 <para id="c-filt"><command>c++filt</command> is used by the linker to de-mangle C++ and 125 Java symbols, to keep overloaded functions from clashing.</para> 126 127 <indexterm zone="ch-system-binutils gprof"><primary sortas="b-gprof">gprof</primary></indexterm> 128 <para id="gprof"><command>gprof</command> displays call graph profile data.</para> 129 130 <indexterm zone="ch-system-binutils ld"><primary sortas="b-ld">ld</primary></indexterm> 131 <para id="ld"><command>ld</command> is a linker. It combines a number of object 132 and archive files into a single file, relocating their data and tying up symbol 133 references.</para> 134 135 <indexterm zone="ch-system-binutils nm"><primary sortas="b-nm">nm</primary></indexterm> 136 <para id="nm"><command>nm</command> lists the symbols occurring in a given object file.</para> 137 138 <indexterm zone="ch-system-binutils objcopy"><primary sortas="b-objcopy">objcopy</primary></indexterm> 139 <para id="objcopy"><command>objcopy</command> is used to translate one type of object 140 file into another.</para> 141 142 <indexterm zone="ch-system-binutils objdump"><primary sortas="b-objdump">objdump</primary></indexterm> 143 <para id="objdump"><command>objdump</command> displays information about the given 144 object file, with options controlling what particular information to display. 145 The information shown is mostly only useful to programmers who are working on 146 the compilation tools.</para> 147 148 <indexterm zone="ch-system-binutils ranlib"><primary sortas="b-ranlib">ranlib</primary></indexterm> 149 <para id="ranlib"><command>ranlib</command> generates an index of the contents of an 150 archive, and stores it in the archive. The index lists all the symbols defined 151 by archive members that are relocatable object files.</para> 152 153 <indexterm zone="ch-system-binutils readelf"><primary sortas="b-readelf">readelf</primary></indexterm> 154 <para id="readelf"><command>readelf</command> displays information about elf type binaries.</para> 155 156 <indexterm zone="ch-system-binutils size"><primary sortas="b-size">size</primary></indexterm> 157 <para id="size"><command>size</command> lists the section sizes -- and the grand 158 total -- for the given object files.</para> 159 160 <indexterm zone="ch-system-binutils strings"><primary sortas="b-strings">strings</primary></indexterm> 161 <para id="strings"><command>strings</command> outputs, for each given file, the sequences 162 of printable characters that are of at least the specified length (defaulting to 4). 163 For object files it prints, by default, only the strings from the initializing 164 and loading sections. For other types of files it scans the whole file.</para> 165 166 <indexterm zone="ch-system-binutils strip"><primary sortas="b-strip">strip</primary></indexterm> 167 <para id="strip"><command>strip</command> discards symbols from object files.</para> 168 169 <indexterm zone="ch-system-binutils libiberty"><primary sortas="c-libiberty">libiberty</primary></indexterm> 170 <para id="libiberty"><command>libiberty</command> contains routines used by various GNU 171 programs, including getopt, obstack, strerror, strtol and strtoul.</para> 172 173 <indexterm zone="ch-system-binutils libbfd"><primary sortas="c-libbfd">libbfd</primary></indexterm> 174 <para id="libbfd"><command>libbfd</command> is the Binary File Descriptor library.</para> 175 176 <indexterm zone="ch-system-binutils libopcodes"><primary sortas="c-libopcodes">libopcodes</primary></indexterm> 177 <para id="libopcodes"><command>libopcodes</command> is a library for dealing with opcodes. 178 It is used for building utilities like objdump. Opcodes are the <quote>readable 179 text</quote> versions of instructions for the processor.</para> 180 181 </sect2> 182 183 87 184 88 185 </sect1> 89
Note:
See TracChangeset
for help on using the changeset viewer.