123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120 |
- <?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-libffi" role="wrap">
- <?dbhtml filename="libffi.html"?>
- <sect1info condition="script">
- <productname>libffi</productname>
- <productnumber>&libffi-version;</productnumber>
- <address>&libffi-url;</address>
- </sect1info>
- <title>Libffi-&libffi-version;</title>
- <indexterm zone="ch-system-libffi">
- <primary sortas="a-libffi">libffi</primary>
- </indexterm>
- <sect2 role="package">
- <title/>
- <para>The Libffi library provides a portable, high level programming
- interface to various calling conventions. This allows a programmer to call
- any function specified by a call interface description at run time.</para>
- <segmentedlist>
- <segtitle>&buildtime;</segtitle>
- <segtitle>&diskspace;</segtitle>
- <seglistitem>
- <seg>&libffi-fin-sbu;</seg>
- <seg>&libffi-fin-du;</seg>
- </seglistitem>
- </segmentedlist>
- </sect2>
- <sect2 role="installation">
- <title>Installation of Libffi</title>
- <note>
- <para>Similar to GMP, libffi builds with optimizations specific
- to the proccesor in use. If building for another system, export
- CFLAGS and CXXFLAGS to specify a generic build for your architecture.
- If this is not done, all applications that link to libffi will trigger
- Illegal Operation Errors.</para>
- </note>
- <para>Prepare libffi for compilation:</para>
- <screen><userinput remap="configure">./configure --prefix=/usr --disable-static --with-gcc-arch=native</userinput></screen>
- <variablelist>
- <title>The meaning of the configure option:</title>
- <varlistentry>
- <term><parameter>--with-gcc-arch=native</parameter></term>
- <listitem>
- <para>Ensure GCC optimizes for the current system. If this
- is not specified, the system is guessed and the code generated
- may not be correct for some systems. If the generated code
- will be copied from the native system to a less capable
- system, use the less capable system as a parameter. For details
- about alternative system types, see <ulink
- url='https://gcc.gnu.org/onlinedocs/gcc-&gcc-version;/gcc/x86-Options.html'>
- the x86 options in the GCC manual</ulink>.</para>
- </listitem>
- </varlistentry>
- </variablelist>
- <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>Install the package:</para>
- <screen><userinput remap="install">make install</userinput></screen>
- </sect2>
- <sect2 id="contents-libffi" role="content">
- <title>Contents of Libffi</title>
- <segmentedlist>
- <segtitle>Installed library</segtitle>
- <seglistitem>
- <seg>libffi.so</seg>
- </seglistitem>
- </segmentedlist>
- <variablelist>
- <bridgehead renderas="sect3">Short Descriptions</bridgehead>
- <?dbfo list-presentation="list"?>
- <?dbhtml list-presentation="table"?>
- <varlistentry id="libffi">
- <term><filename class="libraryfile">libffi</filename></term>
- <listitem>
- <para>contains the foreign function interface API functions</para>
- <indexterm zone="ch-system-libffi">
- <primary sortas="c-libffi">libffi</primary>
- </indexterm>
- </listitem>
- </varlistentry>
- </variablelist>
- </sect2>
- </sect1>
|