source: chapter06/libffi.xml@ bec76ac

10.0 10.0-rc1 10.1 10.1-rc1 11.0 11.0-rc1 11.0-rc2 11.0-rc3 11.1 11.1-rc1 11.2 11.2-rc1 9.1 9.1-rc1 arm cross-chap5 ml-11.0 multilib old-trunk s6-init trunk xry111/arm64 xry111/clfs-ng xry111/git-transition xry111/glibc-2.34 xry111/glibc-2.37 xry111/lfs-next xry111/pip3 xry111/queue-11.3 xry111/rust-wip-20221008 xry111/tester-nohack xry111/usr-move
Last change on this file since bec76ac was bec76ac, checked in by Bruce Dubbs <bdubbs@…>, 3 years ago

Add upstream fixes patch for bash.

Add a note about possible problems when changing
to the lfs user.

Update to vim-8.1.2361.
Update to meson-0.52.1.
Update to elfutils-0.178.
Update to iproute2-5.4.0.
Update to libffi-3.3.
Update to tcl-8.6.10.
Update to man-pages-5.04.
Update to perl-5.30.1.
Update to linux-5.4.1.
Update to bc-2.3.2.

git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@11702 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689

  • Property mode set to 100644
File size: 4.2 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>Six tests, all related to test-callback.c, are known to fail.</para>
96
97 <para>Install the package:</para>
98
99<screen><userinput remap="install">make install</userinput></screen>
100
101 </sect2>
102
103 <sect2 id="contents-libffi" role="content">
104 <title>Contents of Libffi</title>
105
106 <segmentedlist>
107 <segtitle>Installed library</segtitle>
108
109 <seglistitem>
110 <seg>libffi.so</seg>
111 </seglistitem>
112 </segmentedlist>
113
114 <variablelist>
115 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
116 <?dbfo list-presentation="list"?>
117 <?dbhtml list-presentation="table"?>
118
119 <varlistentry id="libffi">
120 <term><filename class="libraryfile">libffi</filename></term>
121 <listitem>
122 <para>contains the libffi API functions.</para>
123 <indexterm zone="ch-system-libffi">
124 <primary sortas="c-libffi">libffi</primary>
125 </indexterm>
126 </listitem>
127 </varlistentry>
128 </variablelist>
129
130 </sect2>
131
132</sect1>
133
Note: See TracBrowser for help on using the repository browser.