source: chapter06/libffi.xml@ ee1a413

multilib-10.1 multilib-before-cross
Last change on this file since ee1a413 was ee1a413, checked in by Thomas Trepl <thomas@…>, 3 years ago

Change profiling attribute to enable selection of m32 and/or mx32. Fixes #4452.

git-svn-id: http://svn.linuxfromscratch.org/LFS/branches/multilib@11571 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689

  • Property mode set to 100644
File size: 6.1 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-ch6-sbu;</seg>
36 <seg>&libffi-ch6-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>Modify the Makefile to install headers into the standard
54 <filename class="directory">/usr/include</filename> directory instead of
55 <filename class="directory">/usr/lib/libffi-&libffi-version;/include</filename>.</para>
56
57<screen><userinput remap="pre">sed -e '/^includesdir/ s/$(libdir).*$/$(includedir)/' \
58 -i include/Makefile.in
59
60sed -e '/^includedir/ s/=.*$/=@includedir@/' \
61 -e 's/^Cflags: -I${includedir}/Cflags:/' \
62 -i libffi.pc.in</userinput></screen>
63
64 <para>Prepare libffi for compilation:</para>
65
66<screen><userinput remap="configure">./configure --prefix=/usr --disable-static --with-gcc-arch=native</userinput></screen>
67
68 <variablelist>
69 <title>The meaning of the configure option:</title>
70
71 <varlistentry>
72 <term><parameter>--with-gcc-arch=native</parameter></term>
73 <listitem>
74 <para>Ensure gcc optimizes for the current system. If this
75 is not specified, the system is guessed and the code generated
76 may not be correct for some systems. If the generated code
77 will be copied from the native system to a less capable
78 system, use the less capable system as a parameter. For details
79 about alternative system types, see <ulink
80 url='https://gcc.gnu.org/onlinedocs/gcc-&gcc-version;/gcc/x86-Options.html'>
81 the x86 options in the gcc manual</ulink>.</para>
82 </listitem>
83 </varlistentry>
84
85 </variablelist>
86
87 <para>Compile the package:</para>
88
89<screen><userinput remap="make">make</userinput></screen>
90
91 <para>To test the results, issue:</para>
92
93<screen><userinput remap="test">make check</userinput></screen>
94
95 <para>Install the package:</para>
96
97<screen><userinput remap="install">make install</userinput></screen>
98
99 </sect2>
100
101 <!-- ~~~~~~~~~~~~~~~~~~~~ ABI 32 ~~~~~~~~~~~~~~~~~~~~ -->
102
103 <sect2 arch="ml_32,ml_all" role="installation">
104 <title>Installation of Libffi - 32-bit</title>
105
106 <para>Clean previous build:</para>
107
108<screen><userinput remap="pre">make distclean</userinput></screen>
109
110 <para>Prepare Libffi for compilation:</para>
111
112<screen><userinput remap="configure">CC="gcc -m32" CXX="g++ -m32" \
113./configure \
114 --prefix=/usr \
115 --disable-static \
116 --libdir=/usr/lib32 \
117 --with-gcc-arch=i686 \
118 --host=i686-pc-linux-gnu</userinput></screen>
119
120 <para>Compile the package:</para>
121
122<screen><userinput remap="make">make</userinput></screen>
123
124 <para>To test the results, issue:</para>
125
126<screen><userinput remap="test">make check</userinput></screen>
127
128 <para>Install the package:</para>
129
130<screen><userinput remap="install">make DESTDIR=$PWD/DESTDIR install
131cp -Rv DESTDIR/usr/lib32/* /usr/lib32
132rm -rf DESTDIR</userinput></screen>
133
134 </sect2>
135
136 <!-- ~~~~~~~~~~~~~~~~~~~~ ABI x32 ~~~~~~~~~~~~~~~~~~~~ -->
137
138 <sect2 arch="ml_x32,ml_all" role="installation">
139 <title>Installation of Libffi - x32-bit</title>
140
141 <para>Clean previous build:</para>
142
143<screen><userinput remap="pre">make distclean</userinput></screen>
144
145 <para>Prepare Libffi for compilation:</para>
146
147<screen><userinput remap="configure">CC="gcc -mx32" CXX="g++ -mx32" \
148./configure \
149 --prefix=/usr \
150 --disable-static \
151 --with-gcc-arch=x86_64 \
152 --libdir=/usr/libx32 \
153 --host=x86_64-unknown-linux-gnux32</userinput></screen>
154
155 <para>Compile the package:</para>
156
157<screen><userinput remap="make">make</userinput></screen>
158
159 <para>To test the results, issue:</para>
160
161<screen><userinput remap="test">make check</userinput></screen>
162
163 <para>Install the package:</para>
164
165<screen><userinput remap="install">make DESTDIR=$PWD/DESTDIR install
166cp -Rv DESTDIR/usr/libx32/* /usr/libx32
167rm -rf DESTDIR</userinput></screen>
168
169 </sect2>
170
171 <sect2 id="contents-libffi" role="content">
172 <title>Contents of Libffi</title>
173
174 <segmentedlist>
175 <segtitle>Installed library</segtitle>
176
177 <seglistitem>
178 <seg>libffi.so</seg>
179 </seglistitem>
180 </segmentedlist>
181
182 <variablelist>
183 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
184 <?dbfo list-presentation="list"?>
185 <?dbhtml list-presentation="table"?>
186
187 <varlistentry id="libffi">
188 <term><filename class="libraryfile">libffi</filename></term>
189 <listitem>
190 <para>contains the libffi API functions.</para>
191 <indexterm zone="ch-system-libffi">
192 <primary sortas="c-libffi">libffi</primary>
193 </indexterm>
194 </listitem>
195 </varlistentry>
196 </variablelist>
197
198 </sect2>
199
200</sect1>
201
Note: See TracBrowser for help on using the repository browser.