source: chapter08/gmp.xml@ 360fdfca

12.1 12.1-rc1 multilib trunk xry111/arm64 xry111/clfs-ng xry111/loongarch xry111/loongarch-12.1 xry111/mips64el xry111/update-glibc
Last change on this file since 360fdfca was 360fdfca, checked in by Pierre Labastie <pierre.labastie@…>, 4 months ago

Fix punctuation in quotes, and quote signs

  • period and comma inside quotes
  • " to <quote>
  • some " to <literal> when it is a var value
  • Property mode set to 100644
File size: 5.6 KB
Line 
1<?xml version="1.0" encoding="UTF-8"?>
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-gmp" role="wrap">
9 <?dbhtml filename="gmp.html"?>
10
11 <sect1info condition="script">
12 <productname>gmp</productname>
13 <productnumber>&gmp-version;</productnumber>
14 <address>&gmp-url;</address>
15 </sect1info>
16
17 <title>GMP-&gmp-version;</title>
18
19 <indexterm zone="ch-system-gmp">
20 <primary sortas="a-GMP">GMP</primary>
21 </indexterm>
22
23 <sect2 role="package">
24 <title/>
25
26 <para>The GMP package contains math libraries. These have useful functions
27 for arbitrary precision arithmetic.</para>
28
29 <segmentedlist>
30 <segtitle>&buildtime;</segtitle>
31 <segtitle>&diskspace;</segtitle>
32
33 <seglistitem>
34 <seg>&gmp-fin-sbu;</seg>
35 <seg>&gmp-fin-du;</seg>
36 </seglistitem>
37 </segmentedlist>
38
39 </sect2>
40
41 <sect2 role="installation">
42 <title>Installation of GMP</title>
43
44 <note>
45 <para>If you are building for 32-bit x86, but you have a CPU which is
46 capable of running 64-bit code <emphasis>and</emphasis> you have specified
47 <envar>CFLAGS</envar> in the environment, the configure script will
48 attempt to configure for 64-bits and fail.
49 Avoid this by invoking the configure command below with
50<screen role="nodump"><userinput><parameter>ABI=32</parameter> ./configure ...</userinput></screen></para>
51 </note>
52
53 <note>
54 <para>The default settings of GMP produce libraries optimized for
55 the host processor. If libraries suitable for processors less
56 capable than the host's CPU are desired, generic libraries can be
57 created by appending the <option>--host=none-linux-gnu</option> option
58 to the <command>configure</command> command.</para>
59
60 <!-- To editors: the configure script says "the none host is obsolete,
61 use - -disable-assembly," but don't believe it: with the latter
62 CFLAGS is still automatically set to -march=something. -->
63 </note>
64
65 <para>Prepare GMP for compilation:</para>
66
67<screen><userinput remap="configure">./configure --prefix=/usr \
68 --enable-cxx \
69 --disable-static \
70 --docdir=/usr/share/doc/gmp-&gmp-version;</userinput></screen>
71
72 <variablelist>
73 <title>The meaning of the new configure options:</title>
74
75 <varlistentry>
76 <term><parameter>--enable-cxx</parameter></term>
77 <listitem>
78 <para>This parameter enables C++ support</para>
79 </listitem>
80 </varlistentry>
81
82 <varlistentry>
83 <term><parameter>--docdir=/usr/share/doc/gmp-&gmp-version;</parameter></term>
84 <listitem>
85 <para>This variable specifies the correct place for the
86 documentation.</para>
87 </listitem>
88 </varlistentry>
89
90 </variablelist>
91
92 <para>Compile the package and generate the HTML documentation:</para>
93
94<screen><userinput remap="make">make
95make html</userinput></screen>
96
97 <important>
98 <para>The test suite for GMP in this section is considered critical.
99 Do not skip it under any circumstances.</para>
100 </important>
101
102 <para>Test the results:</para>
103
104<screen><userinput remap="test">make check 2>&amp;1 | tee gmp-check-log</userinput></screen>
105
106 <caution><para>The code in gmp is highly optimized for the processor where
107 it is built. Occasionally, the code that detects the processor misidentifies
108 the system capabilities and there will be errors in the tests or other
109 applications using the gmp libraries with the message
110 <computeroutput>Illegal instruction</computeroutput>.
111 In this case, gmp should be reconfigured with the option
112 <option>--host=none-linux-gnu</option> and rebuilt.</para></caution>
113
114 <!-- Some tests PASS on a specific uarch but SKIP on other CPUs.
115 For example on K8 the following command outputs 200. -->
116 <para>Ensure that at least 199 tests in the test suite passed.
117 Check the results by issuing the following command:</para>
118
119<screen><userinput remap="test">awk '/# PASS:/{total+=$3} ; END{print total}' gmp-check-log</userinput></screen>
120
121 <para>Install the package and its documentation:</para>
122
123<screen><userinput remap="install">make install
124make install-html</userinput></screen>
125
126 </sect2>
127
128 <sect2 id="contents-gmp" role="content">
129 <title>Contents of GMP</title>
130
131 <segmentedlist>
132 <segtitle>Installed libraries</segtitle>
133 <segtitle>Installed directory</segtitle>
134
135 <seglistitem>
136 <seg>libgmp.so and libgmpxx.so</seg>
137 <seg>/usr/share/doc/gmp-&gmp-version;</seg>
138 </seglistitem>
139 </segmentedlist>
140
141 <variablelist>
142 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
143 <?dbfo list-presentation="list"?>
144 <?dbhtml list-presentation="table"?>
145
146 <varlistentry id="libgmp">
147 <term><filename class="libraryfile">libgmp</filename></term>
148 <listitem>
149 <para>Contains precision math functions</para>
150 <indexterm zone="ch-system-gmp libgmp">
151 <primary sortas="c-libgmp">libgmp</primary>
152 </indexterm>
153 </listitem>
154 </varlistentry>
155
156 <varlistentry id="libgmpxx">
157 <term><filename class="libraryfile">libgmpxx</filename></term>
158 <listitem>
159 <para>Contains C++ precision math functions</para>
160 <indexterm zone="ch-system-gmp libgmpxx">
161 <primary sortas="c-libgmpxx">libgmpxx</primary>
162 </indexterm>
163 </listitem>
164 </varlistentry>
165 </variablelist>
166
167 </sect2>
168
169</sect1>
Note: See TracBrowser for help on using the repository browser.