lfs/chapter08/libelf.xml
2021-03-31 18:41:39 +08:00

153 lines
4.1 KiB
XML

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities;
]>
<sect1 id="ch-system-libelf" role="wrap">
<?dbhtml filename="libelf.html"?>
<sect1info condition="script">
<productname>libelf</productname>
<productnumber>&elfutils-version;</productnumber>
<address>&elfutils-url;</address>
</sect1info>
<title>Libelf from Elfutils-&elfutils-version;</title>
<indexterm zone="ch-system-libelf">
<primary sortas="a-Libelf">Libelf</primary>
</indexterm>
<sect2 role="package">
<title/>
<para>Libelf is a library for handling ELF (Executable and Linkable Format)
files.</para>
<segmentedlist>
<segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<seglistitem>
<seg>&elfutils-fin-sbu;</seg>
<seg>&elfutils-fin-du;</seg>
</seglistitem>
</segmentedlist>
</sect2>
<sect2 role="installation">
<title>Installation of Libelf</title>
<para>Libelf is part of elfutils-&elfutils-version; package. Use
the elfutils-&elfutils-version;.tar.bz2 as the source tarball.</para>
<para>Prepare Libelf for compilation:</para>
<screen><userinput remap="configure">./configure --prefix=/usr --disable-debuginfod --libdir=/lib</userinput></screen>
<para>Compile the package:</para>
<screen><userinput remap="make">make</userinput></screen>
<para>To test the results, issue:</para>
<screen><userinput remap="test">make check</userinput></screen>
<!-- <para>One test, run-elfclassify.sh, is known to fail.</para>-->
<para>Install only Libelf:</para>
<screen><userinput remap="install">make -C libelf install
install -vm644 config/libelf.pc /usr/lib/pkgconfig
rm /lib/libelf.a</userinput></screen>
</sect2>
<!-- - - - - - - - - - -->
<!-- Multilib - 32bit -->
<!-- - - - - - - - - - -->
<sect2 arch="ml_32,ml_all" role="installation">
<title>Installation of Libelf - 32bit</title>
<para>Clean previous build:</para>
<screen><userinput remap="pre">make distclean</userinput></screen>
<para>Prepare Libtool for compilation:</para>
<screen><userinput remap="configure">CC="gcc -m32" ./configure \
--prefix=/usr \
--libdir=&usr-lib-m32; \
--host=i686-pc-linux-gnu \
--disable-debuginfod</userinput></screen>
<para>Compile the package:</para>
<screen><userinput remap="make">make</userinput></screen>
<para>Install the package:</para>
<screen><userinput remap="install">make DESTDIR=$PWD/DESTDIR -C libelf install
install -vDm644 config/libelf.pc DESTDIR&usr-lib-m32;/pkgconfig/libelf.pc
cp -Rv DESTDIR&usr-lib-m32;/* &usr-lib-m32;
rm -rf DESTDIR</userinput></screen>
</sect2><!-- m32 -->
<!-- - - - - - - - - - -->
<!-- Multilib - x32bit -->
<!-- - - - - - - - - - -->
<sect2 arch="ml_x32,ml_all" role="installation">
<title>Installation of Libelf - x32bit</title>
<para>Clean previous build:</para>
<screen><userinput remap="pre">make distclean</userinput></screen>
<para>Prepare Libtool for compilation:</para>
<screen><userinput remap="configure">CC="gcc -mx32" ./configure \
--prefix=/usr \
--libdir=&usr-lib-m32; \
--host=x86_64-pc-linux-gnux32 \
--disable-debuginfod</userinput></screen>
<para>Compile the package:</para>
<screen><userinput remap="make">make</userinput></screen>
<para>Install the package:</para>
<screen><userinput remap="install">make DESTDIR=$PWD/DESTDIR -C libelf install
install -vDm644 config/libelf.pc DESTDIR&usr-lib-mx32;/pkgconfig/libelf.pc
cp -Rv DESTDIR&usr-lib-mx32;/* &usr-lib-mx32;
rm -rf DESTDIR</userinput></screen>
</sect2><!-- mx32 -->
<sect2 id="contents-elfutils" role="content">
<title>Contents of Libelf</title>
<segmentedlist>
<segtitle>Installed Library</segtitle>
<segtitle>Installed Directory</segtitle>
<seglistitem>
<seg>
libelf.so
</seg>
<seg>
/usr/include/elfutils
</seg>
</seglistitem>
</segmentedlist>
</sect2>
</sect1>