source: general/prog/gcc-ada.xml@ 9562b375

10.0 10.1 11.0 11.1 11.2 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind lazarus perl-modules plabs/python-mods qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since 9562b375 was 9562b375, checked in by Pierre Labastie <pieere@…>, 6 years ago

GCC-7.1.0; archive gcc-java, since
it is not anymore in the GCC sources

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@18694 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 18.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 <!ENTITY gcc-download-http "http://ftpmirror.gnu.org/gcc/gcc-&gcc-ada-version;/gcc-&gcc-ada-version;.tar.bz2">
8 <!ENTITY gcc-download-ftp "ftp://ftp.gnu.org/gnu/gcc/gcc-&gcc-ada-version;/gcc-&gcc-ada-version;.tar.bz2">
9 <!ENTITY gcc-md5sum "6bf56a2bca9dac9dbbf8e8d1036964a8">
10 <!ENTITY gcc-size "80 MB">
11 <!ENTITY gcc-ada-buildsize "6.4 GB (1.7 GB added if GNAT install dir is not removed)">
12 <!ENTITY gcc-ada-time "58 SBU (with tests and parallelism=4)">
13
14 <!ENTITY gnat-download-http "https://libre.adacore.com/download/">
15 <!ENTITY gnat-64-download-http "http://mirrors.cdn.adacore.com/art/5739cefdc7a447658e0b016b">
16 <!ENTITY gnat-64-md5sum "9741107cca1a6a4ddb0d5e8de824a90c">
17 <!ENTITY gnat-64-size "356 MB">
18 <!ENTITY gnat-32-download-http "http://mirrors.cdn.adacore.com/art/564b3e9dc8e196b040fbe248">
19 <!ENTITY gnat-32-md5sum "69423c7ad8d9759377d4fff71a78992d">
20 <!ENTITY gnat-32-size "222 MB">
21]>
22
23<sect1 id="gcc-ada" xreflabel="GCC-Ada-&gcc-ada-version;">
24 <?dbhtml filename="gcc-ada.html" ?>
25
26 <sect1info>
27 <othername>$LastChangedBy$</othername>
28 <date>$Date$</date>
29 </sect1info>
30
31 <title>GCC-Ada-&gcc-ada-version;</title>
32
33 <indexterm zone="gcc-ada">
34 <primary sortas="a-gcc-ada">GCC-Ada-&gcc-ada-version;</primary>
35 </indexterm>
36
37 <sect2 role="package">
38 <title>Introduction to the GCC Ada compiler</title>
39
40 <para>
41 Ada is a modern programming language designed for large, long-lived
42 applications &mdash; and embedded systems in particular &mdash; where
43 reliability and efficiency are essential. It has a set of unique technical
44 features that make it highly effective for use in large, complex and
45 safety-critical projects.
46 </para>
47
48 <para>
49 The compiler and associated tools on this page are known as the
50 <application>GNAT</application> technology, developed by the Adacore
51 company, using the <application>GCC</application> backend. Since
52 parts of the Ada compiler are written in Ada, there is a circular
53 dependency on an Ada compiler. The instructions below first install
54 a binary compiler. You do not need to do that if you already have built
55 <application>GNAT</application> tools.
56 </para>
57
58 &lfs80_checked;
59
60 <caution>
61 <para>
62 Using the instructions on this page will have the effect that
63 the C and C++ compiler and libraries will be reinstalled, overwriting
64 the ones on your system. This may lead to some issues. Please read the
65 notes and caution on the <xref linkend="gcc"/> page.
66 </para>
67 </caution>
68
69 <note>
70 <para>
71 If you want to install other compilers in the <application>GCC
72 </application> collection, do that first, or specify ada in the
73 <parameter>--enable-languages</parameter> switch to <command>
74 configure</command>. If you rebuild <application>GCC</application>
75 without enabling ada after running the instructions on this page,
76 the new compiler will not be able to compile ADA anymore.
77 </para>
78 </note>
79
80 <bridgehead renderas="sect3">Package Information</bridgehead>
81 <itemizedlist spacing="compact">
82 <listitem>
83 <para>
84 Download (HTTP): <ulink url="&gcc-download-http;"/>
85 </para>
86 </listitem>
87 <listitem>
88 <para>
89 Download (FTP): <ulink url="&gcc-download-ftp;"/>
90 </para>
91 </listitem>
92 <listitem>
93 <para>
94 Download MD5 sum: &gcc-md5sum;
95 </para>
96 </listitem>
97 <listitem>
98 <para>
99 Download size: &gcc-size;
100 </para>
101 </listitem>
102 <listitem>
103 <para>
104 Estimated disk space required: &gcc-ada-buildsize;
105 </para>
106 </listitem>
107 <listitem>
108 <para>
109 Estimated build time: &gcc-ada-time;
110 </para>
111 </listitem>
112 </itemizedlist>
113
114 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
115 <note>
116 <para>
117 You will need to install <application>GNAT</application>
118 temporarily to satisfy the circular dependency. You may point your
119 browser to the <ulink url="&gnat-download-http;">AdaCore download
120 page</ulink>, choose your platform and 2016 (64 bit machines) or
121 2014 (32 bit machines), then select the file
122 to download. Alternatively, direct links to the 64 bit and 32 bit
123 linux versions are given below.
124 </para>
125 </note>
126
127 <itemizedlist spacing="compact">
128 <listitem>
129 <para>
130 GNAT 64 bit binary: <ulink url="&gnat-64-download-http;"/>
131 </para>
132 </listitem>
133 <listitem>
134 <para>
135 GNAT 64 bit MD5 sum: &gnat-64-md5sum;
136 </para>
137 </listitem>
138 <listitem>
139 <para>
140 GNAT 64 bit size: &gnat-64-size;
141 </para>
142 </listitem>
143 <listitem>
144 <para>
145 GNAT 32 bit binary: <ulink url="&gnat-32-download-http;"/>
146 </para>
147 </listitem>
148 <listitem>
149 <para>
150 GNAT 32 bit MD5 sum: &gnat-32-md5sum;
151 </para>
152 </listitem>
153 <listitem>
154 <para>
155 GNAT 32 bit size: &gnat-32-size;
156 </para>
157 </listitem>
158<!--
159 <listitem>
160 <para>
161 Required patch:
162 <ulink url="&patch-root;/gcc-&gcc-ada-version;-upstream_fixes-1.patch"/>
163 </para>
164 </listitem>
165-->
166 </itemizedlist>
167
168 <bridgehead renderas="sect3">GCC Ada Dependencies</bridgehead>
169
170 <bridgehead renderas="sect4">Recommended</bridgehead>
171 <para role="recommended">
172 <xref linkend="dejagnu"/>, for tests
173 </para>
174
175 <para condition="html" role="usernotes">User Notes:
176 <ulink url="&blfs-wiki;/gcc-ada"/></para>
177
178 </sect2>
179
180 <sect2 role="installation">
181 <title>Installation of the GNAT binary</title>
182
183 <para>
184 Before unpacking and changing into the GCC source directory, first
185 unpack the <application>GNAT</application> tarball, and change to the
186 GNAT directory. Then, install the <application>GNAT</application> binary
187 by running the following command as the
188 <systemitem class="username">root</systemitem> user:
189 </para>
190
191<screen role="root"><userinput>make ins-all prefix=/opt/gnat</userinput></screen>
192
193 <para>
194 The <application>GNAT</application> compiler can be invoked by
195 executing the <command>gcc</command> binary installed in <filename
196 class="directory">/opt/gnat/bin</filename>.
197 </para>
198
199 <para>
200 You may now remove the <application>GNAT</application>
201 source directory if desired.
202 </para>
203
204 <para>
205 Prepare to compile <application>GCC</application> by placing the
206 <application>GNAT</application> version of <command>gcc</command> at the
207 beginning of the <envar>PATH</envar> variable by using the following
208 commands:
209 </para>
210
211<screen><userinput>PATH_HOLD=$PATH &amp;&amp;
212export PATH=/opt/gnat/bin:$PATH_HOLD</userinput></screen>
213
214 <para>
215 Doing so has the drawback that the <application>GCC</application>
216 and <application>Binutils</application> executables are taken
217 from the just installed <application>GNAT</application> package, but the
218 versions of those executables are outdated compared to those installed in
219 LFS. This is not important for the <application>GCC</application> compilers,
220 since they recompile themselves during the bootstrap process. On the other
221 hand, the outdated <command>ld</command> and <command>as</command> tools
222 are used all along. In order to use the LFS tools, issue as the
223 <systemitem class="username">root</systemitem> user:
224 </para>
225
226<screen role="root"><userinput>find /opt/gnat -name ld -exec mv -v {} {}.old \;
227find /opt/gnat -name as -exec mv -v {} {}.old \;</userinput></screen>
228
229 </sect2>
230
231 <sect2 role="installation">
232 <title>Installation of GCC Ada</title>
233
234 <para>
235 Install <application>GCC Ada</application> by running the
236 following commands:
237 </para>
238
239<screen><userinput>case $(uname -m) in
240 x86_64)
241 sed -e '/m64=/s/lib64/lib/' \
242 -i.orig gcc/config/i386/t-linux64
243 ;;
244esac
245
246mkdir build &amp;&amp;
247cd build &amp;&amp;
248
249../configure \
250 --prefix=/usr \
251 --disable-multilib \
252 --with-system-zlib \
253 --enable-languages=ada &amp;&amp;
254make</userinput></screen>
255
256 <para>
257 If you have installed additional packages such as
258 <application>Valgrind</application> and <application>GDB</application>,
259 the <application>GCC</application> part of the testsuite will run more
260 tests than in LFS. Some of those will report FAIL and others XPASS
261 (pass when expected to FAIL). To run the tests, issue:
262 </para>
263
264<screen><userinput>ulimit -s 32768 &amp;&amp;
265make -k check</userinput></screen>
266<!-- The command above may error out, so using && may prevent the summary
267to be run. -->
268
269 <para>
270 The tests are very long, and the results may be hard to find in the
271 logs, specially if you use parallel jobs with make. You can get a summary
272 of the tests with:
273 </para>
274
275<screen><userinput>../contrib/test_summary</userinput></screen>
276
277 <para>
278 Now, as the <systemitem class="username">root</systemitem> user:
279 </para>
280
281<screen role="root"><userinput>make install &amp;&amp;
282
283mkdir -pv /usr/share/gdb/auto-load/usr/lib &amp;&amp;
284mv -v /usr/lib/*gdb.py /usr/share/gdb/auto-load/usr/lib &amp;&amp;
285
286chown -v -R root:root \
287 /usr/lib/gcc/*linux-gnu/&gcc-ada-version;/include{,-fixed} \
288 /usr/lib/gcc/*linux-gnu/&gcc-ada-version;/ada{lib,include}</userinput></screen>
289
290 <para>
291 You should now remove the <application>GNAT</application>
292 installation and perform other cleanups. First, as the <systemitem
293 class="username">root</systemitem> user:
294 </para>
295
296<screen role="root"><userinput>rm -rf /opt/gnat</userinput></screen>
297
298 <para>
299 Then, as a normal user:
300 </para>
301
302<screen><userinput>export PATH=$PATH_HOLD &amp;&amp;
303unset PATH_HOLD</userinput></screen>
304
305 </sect2>
306
307 <sect2 role="commands">
308 <title>Command Explanations</title>
309
310 <para>
311 <command>mkdir build; cd build</command>: The
312 <application>GCC</application> documentation recommends
313 building the package in a dedicated build directory.
314 </para>
315
316 <para>
317 <parameter>--disable-multilib</parameter>: This parameter ensures
318 that files are created for the specific architecture of your computer.
319 </para>
320
321 <para>
322 <parameter>--with-system-zlib</parameter>: Uses the system
323 <application>zlib</application> instead of the bundled one.
324 <application>zlib</application> is used for compressing
325 and uncompressing <application>GCC</application>'s intermediate
326 language in LTO (Link Time Optimization) object files.
327 </para>
328
329 <para>
330 <parameter>--enable-languages=ada</parameter>: Instructs the build system
331 to build the Ada tools and compiler. It is unavoidable that the
332 <application>C</application> and <application>C++</application>
333 compilers be built too.
334 </para>
335
336 <para>
337 <option>--with-default-libstdcxx-abi=gcc4-compatible</option>: Use this
338 switch if you are building <application>GNAT</application> tools using a
339 <application>GCC</application> version prior to 5.1.0,
340 and you do not want to recompile all the libraries written in C++.
341 </para>
342
343 <para>
344 <command>ulimit -s 32768</command>: This command prevents several
345 tests from running out of stack space.
346 </para>
347
348 <para>
349 <command>make -k check</command>: This command runs the test suite
350 without stopping if any errors are encountered.
351 </para>
352
353 <para>
354 <command>../contrib/test_summary</command>: This
355 command will produce a summary of the test suite results. You can append
356 <command>| grep -A7 Summ</command> to the command to produce an even more
357 condensed version of the summary. You may also wish to redirect the output
358 to a file for review and comparison later on.
359 </para>
360
361 <para>
362 <command>chown -v -R root:root /usr/lib/gcc/*linux-gnu/...</command>:
363 If the package is built by a user other than root, the ownership of the
364 installed <filename class="directory">include</filename> and
365 <filename class="directory">adalib</filename> directories (and their
366 contents) will be incorrect. These commands change the ownership to the
367 <systemitem class="username">root</systemitem> user and group.
368 </para>
369
370 </sect2>
371
372 <sect2 role="content">
373 <title>Contents</title>
374
375 <segmentedlist>
376 <segtitle>Installed Programs</segtitle>
377 <segtitle>Installed Libraries</segtitle>
378 <segtitle>Installed Directories</segtitle>
379
380 <seglistitem>
381 <seg>
382 gnat, gnatbind, gnatchop, gnatclean, gnatfind, gnatkr,
383 gnatlink, gnatls, gnatmake, gnatname, gnatprep, gnatxref
384 </seg>
385 <seg>
386 libgnarl.{so,a}, libgnat.{so,a} in <filename class="directory">
387 /usr/lib/gcc/&lt;arch-triplet&gt;/&gcc-ada-version;/adalib</filename>
388 </seg>
389 <seg>
390 /usr/lib/gcc/&lt;arch-triplet&gt;/&gcc-ada-version;/ada{include,lib}
391 and /usr/lib/gcc/&lt;arch-triplet&gt;/&gcc-ada-version;/plugin/include/ada
392 </seg>
393 </seglistitem>
394 </segmentedlist>
395
396 <para>
397 Only the Ada specific files are listed here. Others can be found at
398 <ulink url="&lfs-root;/chapter06/gcc.html#contents-gcc"/> as they were
399 initially installed during the building of LFS.
400 </para>
401
402 <variablelist>
403 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
404 <?dbfo list-presentation="list"?>
405 <?dbhtml list-presentation="table"?>
406
407 <varlistentry id="gnat">
408 <term><command>gnat</command></term>
409 <listitem>
410 <para>
411 is a wrapper that accepts a number of commands and calls
412 the corresponding tool from the list below.
413 </para>
414 <indexterm zone="gcc-ada gnat">
415 <primary sortas="b-gnat">gnat</primary>
416 </indexterm>
417 </listitem>
418 </varlistentry>
419
420 <varlistentry id="gnatbind">
421 <term><command>gnatbind</command></term>
422 <listitem>
423 <para>
424 is used to bind compiled objects.
425 </para>
426 <indexterm zone="gcc-ada gnatbind">
427 <primary sortas="b-gnatbind">gnatbind</primary>
428 </indexterm>
429 </listitem>
430 </varlistentry>
431
432 <varlistentry id="gnatchop">
433 <term><command>gnatchop</command></term>
434 <listitem>
435 <para>
436 is useful for renaming files to meet the standard
437 <application>Ada</application> default file naming conventions.
438 </para>
439 <indexterm zone="gcc-ada gnatchop">
440 <primary sortas="b-gnatchop">gnatchop</primary>
441 </indexterm>
442 </listitem>
443 </varlistentry>
444
445 <varlistentry id="gnatclean">
446 <term><command>gnatclean</command></term>
447 <listitem>
448 <para>
449 is used to remove files associated with a
450 <application>GNAT</application> project.
451 </para>
452 <indexterm zone="gcc-ada gnatclean">
453 <primary sortas="b-gnatclean">gnatclean</primary>
454 </indexterm>
455 </listitem>
456 </varlistentry>
457
458 <varlistentry id="gnatfind">
459 <term><command>gnatfind</command></term>
460 <listitem>
461 <para>
462 is intended for locating definition and/or references to
463 specified entities in a <application>GNAT</application> project.
464 </para>
465 <indexterm zone="gcc-ada gnatfind">
466 <primary sortas="b-gnatfind">gnatfind</primary>
467 </indexterm>
468 </listitem>
469 </varlistentry>
470
471 <varlistentry id="gnatkr">
472 <term><command>gnatkr</command></term>
473 <listitem>
474 <para>
475 is used to determine the crunched name for a given file, when
476 crunched to a specified maximum length.
477 </para>
478 <indexterm zone="gcc-ada gnatkr">
479 <primary sortas="b-gnatkr">gnatkr</primary>
480 </indexterm>
481 </listitem>
482 </varlistentry>
483
484 <varlistentry id="gnatlink">
485 <term><command>gnatlink</command></term>
486 <listitem>
487 <para>
488 is used to link programs and build an executable file.
489 </para>
490 <indexterm zone="gcc-ada gnatlink">
491 <primary sortas="b-gnatlink">gnatlink</primary>
492 </indexterm>
493 </listitem>
494 </varlistentry>
495
496 <varlistentry id="gnatls">
497 <term><command>gnatls</command></term>
498 <listitem>
499 <para>
500 is the compiled unit browser.
501 </para>
502 <indexterm zone="gcc-ada gnatls">
503 <primary sortas="b-gnatls">gnatls</primary>
504 </indexterm>
505 </listitem>
506 </varlistentry>
507
508 <varlistentry id="gnatmake">
509 <term><command>gnatmake</command></term>
510 <listitem>
511 <para>
512 is the <application>Ada</application> compiler, which performs
513 compilation, binding and linking.
514 </para>
515 <indexterm zone="gcc-ada gnatmake">
516 <primary sortas="b-gnatmake">gnatmake</primary>
517 </indexterm>
518 </listitem>
519 </varlistentry>
520
521 <varlistentry id="gnatname">
522 <term><command>gnatname</command></term>
523 <listitem>
524 <para>
525 will list the files associated with a
526 <application>GNAT</application> project.
527 </para>
528 <indexterm zone="gcc-ada gnatname">
529 <primary sortas="b-gnatname">gnatname</primary>
530 </indexterm>
531 </listitem>
532 </varlistentry>
533
534 <varlistentry id="gnatprep">
535 <term><command>gnatprep</command></term>
536 <listitem>
537 <para>
538 is the <application>GNAT</application> external preprocessor.
539 </para>
540 <indexterm zone="gcc-ada gnatprep">
541 <primary sortas="b-gnatprep">gnatprep</primary>
542 </indexterm>
543 </listitem>
544 </varlistentry>
545
546 <varlistentry id="gnatxref">
547 <term><command>gnatxref</command></term>
548 <listitem>
549 <para>
550 is similar to <command>gnatfind</command>, but generates
551 a full report of all cross-references.
552 </para>
553 <indexterm zone="gcc-ada gnatxref">
554 <primary sortas="b-gnatxref">gnatxref</primary>
555 </indexterm>
556 </listitem>
557 </varlistentry>
558
559 </variablelist>
560
561 </sect2>
562
563</sect1>
Note: See TracBrowser for help on using the repository browser.