source: chapter08/libffi.xml@ b51c338

ml-11.0 multilib
Last change on this file since b51c338 was b51c338, checked in by Thomas Trepl (Moody) <thomas@…>, 12 months ago

Automatic merge of trunk into multilib

  • Property mode set to 100644
File size: 6.3 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
8<sect1 id="ch-system-libffi" role="wrap">
9 <?dbhtml filename="libffi.html"?>
10
11 <sect1info condition="script">
12 <productname>libffi</productname>
13 <productnumber>&libffi-version;</productnumber>
14 <address>&libffi-url;</address>
15 </sect1info>
16
17 <title>Libffi-&libffi-version;</title>
18
19 <indexterm zone="ch-system-libffi">
20 <primary sortas="a-libffi">libffi</primary>
21 </indexterm>
22
23 <sect2 role="package">
24 <title/>
25
26 <para>The Libffi library provides a portable, high level programming
27 interface to various calling conventions. This allows a programmer to call
28 any function specified by a call interface description at run time.</para>
29
30 <segmentedlist>
31 <segtitle>&buildtime;</segtitle>
32 <segtitle>&diskspace;</segtitle>
33
34 <seglistitem>
35 <seg>&libffi-fin-sbu;</seg>
36 <seg>&libffi-fin-du;</seg>
37 </seglistitem>
38 </segmentedlist>
39
40 </sect2>
41
42 <sect2 role="installation">
43 <title>Installation of Libffi</title>
44
45 <note>
46 <para>Similar to GMP, libffi builds with optimizations specific
47 to the proccesor in use. If building for another system, export
48 CFLAGS and CXXFLAGS to specify a generic build for your architecture.
49 If this is not done, all applications that link to libffi will trigger
50 Illegal Operation Errors.</para>
51 </note>
52
53 <para>Prepare libffi for compilation:</para>
54
55 <screen><userinput remap="configure">./configure --prefix=/usr \
56 --disable-static \
57 --with-gcc-arch=native \
58 --disable-exec-static-tramp</userinput></screen>
59
60 <variablelist>
61 <title>The meaning of the configure option:</title>
62
63 <varlistentry>
64 <term><parameter>--with-gcc-arch=native</parameter></term>
65 <listitem>
66 <para>Ensure GCC optimizes for the current system. If this
67 is not specified, the system is guessed and the code generated
68 may not be correct for some systems. If the generated code
69 will be copied from the native system to a less capable
70 system, use the less capable system as a parameter. For details
71 about alternative system types, see <ulink
72 url='https://gcc.gnu.org/onlinedocs/gcc-&gcc-version;/gcc/x86-Options.html'>
73 the x86 options in the GCC manual</ulink>.</para>
74 </listitem>
75 </varlistentry>
76
77 <varlistentry>
78 <!-- To editors: remove it when downstreams are properly
79 fixed. -->
80 <term><parameter>--disable-exec-static-tramp</parameter></term>
81 <listitem>
82 <para>Disable static trampoline support. It's a new security
83 feature in libffi, but some BLFS packages (notably
84 <application>GJS</application> and
85 <application>gobject-introspection</application>) have not been
86 adapted for it.</para>
87 </listitem>
88 </varlistentry>
89
90 </variablelist>
91
92 <para>Compile the package:</para>
93
94<screen><userinput remap="make">make</userinput></screen>
95
96 <para>To test the results, issue:</para>
97
98<screen><userinput remap="test">make check</userinput></screen>
99
100 <para>Install the package:</para>
101
102<screen><userinput remap="install">make install</userinput></screen>
103
104 </sect2>
105
106 <!-- - - - - - - - - - -->
107 <!-- Multilib - 32bit -->
108 <!-- - - - - - - - - - -->
109
110 <sect2 arch="ml_32,ml_all" role="installation">
111 <title>Installation of Libffi - 32bit</title>
112
113 <para>Clean previous build:</para>
114
115<screen><userinput remap="pre">make distclean</userinput></screen>
116
117 <para>Prepare Libffi for compilation:</para>
118
119<screen><userinput remap="configure">CC="gcc -m32" CXX="g++ -m32" ./configure \
120 --prefix=/usr \
121 --disable-static \
122 --libdir=/usr/lib32 \
123 --with-gcc-arch=i686 \
124 --host=i686-pc-linux-gnu</userinput></screen>
125
126 <para>Compile the package:</para>
127
128<screen><userinput remap="make">make</userinput></screen>
129
130 <para>To test the results, issue:</para>
131
132<screen><userinput remap="test">make check</userinput></screen>
133
134 <para>Install the package:</para>
135
136<screen><userinput remap="install">make DESTDIR=$PWD/DESTDIR install
137cp -Rv DESTDIR/usr/lib32/* /usr/lib32
138rm -rf DESTDIR</userinput></screen>
139
140 </sect2><!-- m32 -->
141
142 <!-- - - - - - - - - - -->
143 <!-- Multilib - x32bit -->
144 <!-- - - - - - - - - - -->
145
146 <sect2 arch="ml_x32,ml_all" role="installation">
147 <title>Installation of Libffi - x32bit</title>
148
149 <para>Clean previous build:</para>
150
151<screen><userinput remap="pre">make distclean</userinput></screen>
152
153 <para>Prepare Libffi for compilation:</para>
154
155<screen><userinput remap="configure">CC="gcc -mx32" CXX="g++ -mx32" ./configure \
156 --prefix=/usr \
157 --disable-static \
158 --libdir=/usr/libx32 \
159 --with-gcc-arch=x86_64 \
160 --host=x86_64-unknown-linux-gnux32</userinput></screen>
161
162 <para>Compile the package:</para>
163
164<screen><userinput remap="make">make</userinput></screen>
165
166 <para>To test the results, issue:</para>
167
168<screen><userinput remap="test">make check</userinput></screen>
169
170 <para>Install the package:</para>
171
172<screen><userinput remap="install">make DESTDIR=$PWD/DESTDIR install
173cp -Rv DESTDIR/usr/libx32/* /usr/libx32
174rm -rf DESTDIR</userinput></screen>
175
176 </sect2><!-- mx32 -->
177
178 <sect2 id="contents-libffi" role="content">
179 <title>Contents of Libffi</title>
180
181 <segmentedlist>
182 <segtitle>Installed library</segtitle>
183
184 <seglistitem>
185 <seg>libffi.so</seg>
186 </seglistitem>
187 </segmentedlist>
188
189 <variablelist>
190 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
191 <?dbfo list-presentation="list"?>
192 <?dbhtml list-presentation="table"?>
193
194 <varlistentry id="libffi">
195 <term><filename class="libraryfile">libffi</filename></term>
196 <listitem>
197 <para>contains the foreign function interface API functions</para>
198 <indexterm zone="ch-system-libffi">
199 <primary sortas="c-libffi">libffi</primary>
200 </indexterm>
201 </listitem>
202 </varlistentry>
203 </variablelist>
204
205 </sect2>
206
207</sect1>
208
Note: See TracBrowser for help on using the repository browser.