source: chapter08/libffi.xml@ 0ebda11

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

Remove entities for multilib pathes
Add usage of libc_cv_rtlddir

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