source: archive/elfutils.xml@ f81d69a2

10.0 10.1 11.0 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind perl-modules qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since f81d69a2 was f81d69a2, checked in by Bruce Dubbs <bdubbs@…>, 4 years ago

Just tags and cleanup

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@19813 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 10.8 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY elfutils-download-http
8 "https://sourceware.org/ftp/elfutils/&elfutils-version;/elfutils-&elfutils-version;.tar.bz2">
9 <!ENTITY elfutils-download-ftp
10 "ftp://sourceware.org/pub/elfutils/&elfutils-version;/elfutils-&elfutils-version;.tar.bz2">
11 <!ENTITY elfutils-md5sum "03599aee98c9b726c7a732a2dd0245d5">
12 <!ENTITY elfutils-size "8.0 MB">
13 <!ENTITY elfutils-buildsize "78 MB (with tests)">
14 <!ENTITY elfutils-time "0.9 SBU (with tests)">
15]>
16
17<sect1 id="elfutils" xreflabel="elfutils-&elfutils-version;">
18 <?dbhtml filename="elfutils.html"?>
19
20 <sect1info>
21 <othername>$LastChangedBy$</othername>
22 <date>$Date$</date>
23 </sect1info>
24
25 <title>elfutils-&elfutils-version;</title>
26
27 <indexterm zone="elfutils">
28 <primary sortas="a-elfutils">elfutils</primary>
29 </indexterm>
30
31 <sect2 role="package">
32 <title>Introduction to elfutils</title>
33
34 <para>
35 The <application>elfutils</application> package contains a set of
36 utilities and libraries for handling ELF (Executable and Linkable Format)
37 files.
38 </para>
39
40 &lfs81_checked;
41
42 <bridgehead renderas="sect3">Package Information</bridgehead>
43 <itemizedlist spacing="compact">
44 <listitem>
45 <para>
46 Download (HTTP): <ulink url="&elfutils-download-http;"/>
47 </para>
48 </listitem>
49 <listitem>
50 <para>
51 Download (FTP): <ulink url="&elfutils-download-ftp;"/>
52 </para>
53 </listitem>
54 <listitem>
55 <para>
56 Download MD5 sum: &elfutils-md5sum;
57 </para>
58 </listitem>
59 <listitem>
60 <para>
61 Download size: &elfutils-size;
62 </para>
63 </listitem>
64 <listitem>
65 <para>
66 Estimated disk space required: &elfutils-buildsize;
67 </para>
68 </listitem>
69 <listitem>
70 <para>
71 Estimated build time: &elfutils-time;
72 </para>
73 </listitem>
74 </itemizedlist>
75
76 <bridgehead renderas="sect3">elfutils Dependencies</bridgehead>
77
78 <bridgehead renderas="sect4">Optional</bridgehead>
79 <para role="optional">
80 <xref linkend="valgrind"/>
81 </para>
82
83 <para condition="html" role="usernotes">
84 User Notes: <ulink url="&blfs-wiki;/elfutils"/>
85 </para>
86 </sect2>
87
88 <sect2 role="installation">
89 <title>Installation of elfutils</title>
90
91 <para>
92 Install <application>elfutils</application> by running the following
93 commands:
94 </para>
95
96<!-- don't disable static libs, disable-static switch doesn't work anyways -->
97<screen><userinput>./configure --prefix=/usr --program-prefix="eu-" &amp;&amp;
98make</userinput></screen>
99<!--
100 <para>
101 If you wish to run the test suite, first fix it to skip two failing tests:
102 </para>
103
104<screen><userinput>sed -i '/srcdir/ iexit 77\n' \
105 tests/run-backtrace-native.sh \
106 tests/run-backtrace-native-core.sh</userinput></screen>-->
107
108 <para>
109 To test the results, issue: <command>make check</command>.
110 One test, run-strip-nothing.sh, is known to fail.
111 </para>
112
113 <para>
114 Now, as the <systemitem class="username">root</systemitem> user:
115 </para>
116
117<screen role="root"><userinput>make install</userinput></screen>
118
119 </sect2>
120
121 <sect2 role="commands">
122 <title>Command Explanations</title>
123
124 <para>
125 <parameter>--program-prefix="eu-"</parameter>: This switch renames
126 installed programs to avoid conflict with
127 <application>Binutils</application> programs installed in LFS.
128 </para>
129
130 <para>
131 <option>--enable-valgrind</option>: Run all tests under valgrind.
132 </para>
133
134 </sect2>
135
136 <sect2 role="content">
137 <title>Contents</title>
138
139 <segmentedlist>
140 <segtitle>Installed Programs</segtitle>
141 <segtitle>Installed Libraries</segtitle>
142 <segtitle>Installed Directories</segtitle>
143
144 <seglistitem>
145 <seg>
146 eu-addr2line, eu-ar, eu-elfcmp, eu-elfcompress, eu-elflint,
147 eu-findtextrel, eu-make-debug-archive, eu-nm, eu-objdump,
148 eu-ranlib, eu-readelf, eu-size, eu-stack, eu-strings, eu-strip, and
149 eu-unstrip
150 </seg>
151 <seg>
152 libasm.{a,so}, libdw.{a,so}, libebl.a, libelf.{a,so}, and
153 some for different architectures under /usr/lib/elfutils
154 </seg>
155 <seg>
156 /usr/include/elfutils and
157 /usr/lib/elfutils
158 </seg>
159 </seglistitem>
160 </segmentedlist>
161
162 <variablelist>
163 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
164 <?dbfo list-presentation="list"?>
165 <?dbhtml list-presentation="table"?>
166
167 <varlistentry id="eu-addr2line">
168 <term><command>eu-addr2line</command></term>
169 <listitem>
170 <para>
171 converts addresses into file names and line numbers.
172 </para>
173 <indexterm zone="elfutils eu-addr2line">
174 <primary sortas="b-eu-addr2line">eu-addr2line</primary>
175 </indexterm>
176 </listitem>
177 </varlistentry>
178
179 <varlistentry id="eu-ar">
180 <term><command>eu-ar</command></term>
181 <listitem>
182 <para>
183 creates, modifies, and extracts from archives.
184 </para>
185 <indexterm zone="elfutils eu-ar">
186 <primary sortas="b-eu-ar">eu-ar</primary>
187 </indexterm>
188 </listitem>
189 </varlistentry>
190
191 <varlistentry id="eu-elfcmp">
192 <term><command>eu-elfcmp</command></term>
193 <listitem>
194 <para>
195 compares relevant parts of two ELF files for equality.
196 </para>
197 <indexterm zone="elfutils eu-elfcmp">
198 <primary sortas="b-eu-elfcmp">eu-elfcmp</primary>
199 </indexterm>
200 </listitem>
201 </varlistentry>
202
203 <varlistentry id="eu-elfcompress">
204 <term><command>eu-elfcompress</command></term>
205 <listitem>
206 <para>
207 compresses or decompresses sections in an ELF file.
208 </para>
209 <indexterm zone="elfutils eu-elfcompress">
210 <primary sortas="b-eu-elfcompress">eu-elfcompress</primary>
211 </indexterm>
212 </listitem>
213 </varlistentry>
214
215 <varlistentry id="eu-elflint">
216 <term><command>eu-elflint</command></term>
217 <listitem>
218 <para>
219 does pedantic checking of ELF files compliance with gABI/psABI spec.
220 </para>
221 <indexterm zone="elfutils eu-elflint">
222 <primary sortas="b-eu-elflint">eu-elflint</primary>
223 </indexterm>
224 </listitem>
225 </varlistentry>
226
227 <varlistentry id="eu-findtextrel">
228 <term><command>eu-findtextrel</command></term>
229 <listitem>
230 <para>
231 locates the source of text relocations in FILEs (a.out by default).
232 </para>
233 <indexterm zone="elfutils eu-findtextrel">
234 <primary sortas="b-eu-findtextrel">eu-findtextrel</primary>
235 </indexterm>
236 </listitem>
237 </varlistentry>
238
239<!--
240 <varlistentry id="eu-ld">
241 <term><command>eu-ld</command></term>
242 <listitem>
243 <para>
244 combines object and archive files.
245 </para>
246 <indexterm zone="elfutils eu-ld">
247 <primary sortas="b-eu-ld">eu-ld</primary>
248 </indexterm>
249 </listitem>
250 </varlistentry>
251-->
252
253 <varlistentry id="eu-nm">
254 <term><command>eu-nm</command></term>
255 <listitem>
256 <para>
257 lists symbols from FILEs (a.out by default).
258 </para>
259 <indexterm zone="elfutils eu-nm">
260 <primary sortas="b-eu-nm">eu-nm</primary>
261 </indexterm>
262 </listitem>
263 </varlistentry>
264
265 <varlistentry id="eu-objdump">
266 <term><command>eu-objdump</command></term>
267 <listitem>
268 <para>
269 shows information from FILEs (a.out by default).
270 </para>
271 <indexterm zone="elfutils eu-objdump">
272 <primary sortas="b-eu-objdump">eu-objdump</primary>
273 </indexterm>
274 </listitem>
275 </varlistentry>
276
277 <varlistentry id="eu-ranlib">
278 <term><command>eu-ranlib</command></term>
279 <listitem>
280 <para>
281 generates an index to speed up access to archives.
282 </para>
283 <indexterm zone="elfutils eu-ranlib">
284 <primary sortas="b-eu-ranlib">eu-ranlib</primary>
285 </indexterm>
286 </listitem>
287 </varlistentry>
288
289 <varlistentry id="eu-readelf">
290 <term><command>eu-readelf</command></term>
291 <listitem>
292 <para>
293 prints information from ELF files in human-readable form.
294 </para>
295 <indexterm zone="elfutils eu-readelf">
296 <primary sortas="b-eu-readelf">eu-readelf</primary>
297 </indexterm>
298 </listitem>
299 </varlistentry>
300
301 <varlistentry id="eu-size">
302 <term><command>eu-size</command></term>
303 <listitem>
304 <para>
305 lists section sizes of FILEs (a.out by default).
306 </para>
307 <indexterm zone="elfutils eu-size">
308 <primary sortas="b-eu-size">eu-size</primary>
309 </indexterm>
310 </listitem>
311 </varlistentry>
312
313 <varlistentry id="eu-stack">
314 <term><command>eu-stack</command></term>
315 <listitem>
316 <para>
317 prints a stack for each thread in a process or core file.
318 </para>
319 <indexterm zone="elfutils eu-stack">
320 <primary sortas="b-eu-stack">eu-stack</primary>
321 </indexterm>
322 </listitem>
323 </varlistentry>
324
325 <varlistentry id="eu-strings">
326 <term><command>eu-strings</command></term>
327 <listitem>
328 <para>
329 prints the strings of printable characters in files.
330 </para>
331 <indexterm zone="elfutils eu-strings">
332 <primary sortas="b-eu-strings">eu-strings</primary>
333 </indexterm>
334 </listitem>
335 </varlistentry>
336
337 <varlistentry id="eu-strip">
338 <term><command>eu-strip</command></term>
339 <listitem>
340 <para>
341 discards symbols from object files.
342 </para>
343 <indexterm zone="elfutils eu-strip">
344 <primary sortas="b-eu-strip">eu-strip</primary>
345 </indexterm>
346 </listitem>
347 </varlistentry>
348
349 <varlistentry id="eu-unstrip">
350 <term><command>eu-unstrip</command></term>
351 <listitem>
352 <para>
353 combines stripped files with separate symbols and debug information.
354 </para>
355 <indexterm zone="elfutils eu-unstrip">
356 <primary sortas="b-eu-unstrip">eu-unstrip</primary>
357 </indexterm>
358 </listitem>
359 </varlistentry>
360
361 </variablelist>
362
363 </sect2>
364
365</sect1>
Note: See TracBrowser for help on using the repository browser.