source: archive/elfutils.xml@ fa91d2e

11.0 ken/refactor-virt lazarus qt5new trunk
Last change on this file since fa91d2e was 45ab6c7, checked in by Xi Ruoyao <xry111@…>, 5 months ago

more SVN prop clean up

Remove "$LastChanged$" everywhere, and also some unused $Date$

  • Property mode set to 100644
File size: 10.7 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 <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 &lfs81_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 One test, run-strip-nothing.sh, is known to fail.
110 </para>
111
112 <para>
113 Now, as the <systemitem class="username">root</systemitem> user:
114 </para>
115
116<screen role="root"><userinput>make install</userinput></screen>
117
118 </sect2>
119
120 <sect2 role="commands">
121 <title>Command Explanations</title>
122
123 <para>
124 <parameter>--program-prefix="eu-"</parameter>: This switch renames
125 installed programs to avoid conflict with
126 <application>Binutils</application> programs installed in LFS.
127 </para>
128
129 <para>
130 <option>--enable-valgrind</option>: Run all tests under valgrind.
131 </para>
132
133 </sect2>
134
135 <sect2 role="content">
136 <title>Contents</title>
137
138 <segmentedlist>
139 <segtitle>Installed Programs</segtitle>
140 <segtitle>Installed Libraries</segtitle>
141 <segtitle>Installed Directories</segtitle>
142
143 <seglistitem>
144 <seg>
145 eu-addr2line, eu-ar, eu-elfcmp, eu-elfcompress, eu-elflint,
146 eu-findtextrel, eu-make-debug-archive, eu-nm, eu-objdump,
147 eu-ranlib, eu-readelf, eu-size, eu-stack, eu-strings, eu-strip, and
148 eu-unstrip
149 </seg>
150 <seg>
151 libasm.{a,so}, libdw.{a,so}, libebl.a, libelf.{a,so}, and
152 some for different architectures under /usr/lib/elfutils
153 </seg>
154 <seg>
155 /usr/include/elfutils and
156 /usr/lib/elfutils
157 </seg>
158 </seglistitem>
159 </segmentedlist>
160
161 <variablelist>
162 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
163 <?dbfo list-presentation="list"?>
164 <?dbhtml list-presentation="table"?>
165
166 <varlistentry id="eu-addr2line">
167 <term><command>eu-addr2line</command></term>
168 <listitem>
169 <para>
170 converts addresses into file names and line numbers.
171 </para>
172 <indexterm zone="elfutils eu-addr2line">
173 <primary sortas="b-eu-addr2line">eu-addr2line</primary>
174 </indexterm>
175 </listitem>
176 </varlistentry>
177
178 <varlistentry id="eu-ar">
179 <term><command>eu-ar</command></term>
180 <listitem>
181 <para>
182 creates, modifies, and extracts from archives.
183 </para>
184 <indexterm zone="elfutils eu-ar">
185 <primary sortas="b-eu-ar">eu-ar</primary>
186 </indexterm>
187 </listitem>
188 </varlistentry>
189
190 <varlistentry id="eu-elfcmp">
191 <term><command>eu-elfcmp</command></term>
192 <listitem>
193 <para>
194 compares relevant parts of two ELF files for equality.
195 </para>
196 <indexterm zone="elfutils eu-elfcmp">
197 <primary sortas="b-eu-elfcmp">eu-elfcmp</primary>
198 </indexterm>
199 </listitem>
200 </varlistentry>
201
202 <varlistentry id="eu-elfcompress">
203 <term><command>eu-elfcompress</command></term>
204 <listitem>
205 <para>
206 compresses or decompresses sections in an ELF file.
207 </para>
208 <indexterm zone="elfutils eu-elfcompress">
209 <primary sortas="b-eu-elfcompress">eu-elfcompress</primary>
210 </indexterm>
211 </listitem>
212 </varlistentry>
213
214 <varlistentry id="eu-elflint">
215 <term><command>eu-elflint</command></term>
216 <listitem>
217 <para>
218 does pedantic checking of ELF files compliance with gABI/psABI spec.
219 </para>
220 <indexterm zone="elfutils eu-elflint">
221 <primary sortas="b-eu-elflint">eu-elflint</primary>
222 </indexterm>
223 </listitem>
224 </varlistentry>
225
226 <varlistentry id="eu-findtextrel">
227 <term><command>eu-findtextrel</command></term>
228 <listitem>
229 <para>
230 locates the source of text relocations in FILEs (a.out by default).
231 </para>
232 <indexterm zone="elfutils eu-findtextrel">
233 <primary sortas="b-eu-findtextrel">eu-findtextrel</primary>
234 </indexterm>
235 </listitem>
236 </varlistentry>
237
238<!--
239 <varlistentry id="eu-ld">
240 <term><command>eu-ld</command></term>
241 <listitem>
242 <para>
243 combines object and archive files.
244 </para>
245 <indexterm zone="elfutils eu-ld">
246 <primary sortas="b-eu-ld">eu-ld</primary>
247 </indexterm>
248 </listitem>
249 </varlistentry>
250-->
251
252 <varlistentry id="eu-nm">
253 <term><command>eu-nm</command></term>
254 <listitem>
255 <para>
256 lists symbols from FILEs (a.out by default).
257 </para>
258 <indexterm zone="elfutils eu-nm">
259 <primary sortas="b-eu-nm">eu-nm</primary>
260 </indexterm>
261 </listitem>
262 </varlistentry>
263
264 <varlistentry id="eu-objdump">
265 <term><command>eu-objdump</command></term>
266 <listitem>
267 <para>
268 shows information from FILEs (a.out by default).
269 </para>
270 <indexterm zone="elfutils eu-objdump">
271 <primary sortas="b-eu-objdump">eu-objdump</primary>
272 </indexterm>
273 </listitem>
274 </varlistentry>
275
276 <varlistentry id="eu-ranlib">
277 <term><command>eu-ranlib</command></term>
278 <listitem>
279 <para>
280 generates an index to speed up access to archives.
281 </para>
282 <indexterm zone="elfutils eu-ranlib">
283 <primary sortas="b-eu-ranlib">eu-ranlib</primary>
284 </indexterm>
285 </listitem>
286 </varlistentry>
287
288 <varlistentry id="eu-readelf">
289 <term><command>eu-readelf</command></term>
290 <listitem>
291 <para>
292 prints information from ELF files in human-readable form.
293 </para>
294 <indexterm zone="elfutils eu-readelf">
295 <primary sortas="b-eu-readelf">eu-readelf</primary>
296 </indexterm>
297 </listitem>
298 </varlistentry>
299
300 <varlistentry id="eu-size">
301 <term><command>eu-size</command></term>
302 <listitem>
303 <para>
304 lists section sizes of FILEs (a.out by default).
305 </para>
306 <indexterm zone="elfutils eu-size">
307 <primary sortas="b-eu-size">eu-size</primary>
308 </indexterm>
309 </listitem>
310 </varlistentry>
311
312 <varlistentry id="eu-stack">
313 <term><command>eu-stack</command></term>
314 <listitem>
315 <para>
316 prints a stack for each thread in a process or core file.
317 </para>
318 <indexterm zone="elfutils eu-stack">
319 <primary sortas="b-eu-stack">eu-stack</primary>
320 </indexterm>
321 </listitem>
322 </varlistentry>
323
324 <varlistentry id="eu-strings">
325 <term><command>eu-strings</command></term>
326 <listitem>
327 <para>
328 prints the strings of printable characters in files.
329 </para>
330 <indexterm zone="elfutils eu-strings">
331 <primary sortas="b-eu-strings">eu-strings</primary>
332 </indexterm>
333 </listitem>
334 </varlistentry>
335
336 <varlistentry id="eu-strip">
337 <term><command>eu-strip</command></term>
338 <listitem>
339 <para>
340 discards symbols from object files.
341 </para>
342 <indexterm zone="elfutils eu-strip">
343 <primary sortas="b-eu-strip">eu-strip</primary>
344 </indexterm>
345 </listitem>
346 </varlistentry>
347
348 <varlistentry id="eu-unstrip">
349 <term><command>eu-unstrip</command></term>
350 <listitem>
351 <para>
352 combines stripped files with separate symbols and debug information.
353 </para>
354 <indexterm zone="elfutils eu-unstrip">
355 <primary sortas="b-eu-unstrip">eu-unstrip</primary>
356 </indexterm>
357 </listitem>
358 </varlistentry>
359
360 </variablelist>
361
362 </sect2>
363
364</sect1>
Note: See TracBrowser for help on using the repository browser.