source: general/prog/elfutils.xml@ a3f014c

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since a3f014c was a3f014c, checked in by Bruce Dubbs <bdubbs@…>, 7 years ago

Update to elfutils-0.170.
Update to libpng-1.6.31.
Update to autovivification-0.17 (Perl Module).
Update to wayland-protocols-1.10.

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