source: general/prog/elfutils.xml@ 54aaa89

systemd-13485
Last change on this file since 54aaa89 was 54aaa89, checked in by Douglas R. Reno <renodr@…>, 8 years ago

Sync to trunk r17213
Added entity for GNOME-3.20

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