source: general/prog/gcc-ada.xml@ da8e9f9

10.0 10.1 11.0 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind ken/refactor-virt lazarus perl-modules qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since da8e9f9 was da8e9f9, checked in by Thomas Trepl <thomas@…>, 4 years ago

Upgrade to gcc-7.3.0, gcc-ada-7.3.0

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

  • Property mode set to 100644
File size: 18.7 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 "&gnu-http;/gcc/gcc-&gcc-ada-version;/gcc-&gcc-ada-version;.tar.xz">
8 <!ENTITY gcc-download-ftp "&gnu-ftp;/gcc/gcc-&gcc-ada-version;/gcc-&gcc-ada-version;.tar.xz">
9 <!ENTITY gcc-md5sum "ff370482573133a7fcdd96cd2f552292">
10 <!ENTITY gcc-size "59 MB">
11 <!ENTITY gcc-ada-buildsize "6.6 GB (1.6 GB added if GNAT install dir is not removed)">
12 <!ENTITY gcc-ada-time "51 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/591c6d80c7a447af2deed1d7">
16 <!ENTITY gnat-64-md5sum "226dac83d9e6490fc8542ac0934a1db0">
17 <!ENTITY gnat-64-size "473 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 &lfs81_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 2017 (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;
282mkdir -pv /usr/share/gdb/auto-load/usr/lib &amp;&amp;
283mv -v /usr/lib/*gdb.py /usr/share/gdb/auto-load/usr/lib &amp;&amp;
284
285chown -v -R root:root \
286 /usr/lib/gcc/*linux-gnu/&gcc-ada-version;/include{,-fixed} \
287 /usr/lib/gcc/*linux-gnu/&gcc-ada-version;/ada{lib,include}</userinput></screen>
288
289 <para>
290 You should now remove the <application>GNAT</application>
291 installation and perform other cleanups. First, as the <systemitem
292 class="username">root</systemitem> user:
293 </para>
294
295<screen role="root"><userinput>rm -rf /opt/gnat</userinput></screen>
296
297 <para>
298 Then, as a normal user:
299 </para>
300
301<screen><userinput>export PATH=$PATH_HOLD &amp;&amp;
302unset PATH_HOLD</userinput></screen>
303
304 </sect2>
305
306 <sect2 role="commands">
307 <title>Command Explanations</title>
308
309 <para>
310 <command>mkdir build; cd build</command>: The
311 <application>GCC</application> documentation recommends
312 building the package in a dedicated build directory.
313 </para>
314
315 <para>
316 <parameter>--disable-multilib</parameter>: This parameter ensures
317 that files are created for the specific architecture of your computer.
318 </para>
319
320 <para>
321 <parameter>--with-system-zlib</parameter>: Uses the system
322 <application>zlib</application> instead of the bundled one.
323 <application>zlib</application> is used for compressing
324 and uncompressing <application>GCC</application>'s intermediate
325 language in LTO (Link Time Optimization) object files.
326 </para>
327
328 <para>
329 <parameter>--enable-languages=ada</parameter>: Instructs the build system
330 to build the Ada tools and compiler. It is unavoidable that the
331 <application>C</application> and <application>C++</application>
332 compilers be built too.
333 </para>
334
335 <para>
336 <option>--with-default-libstdcxx-abi=gcc4-compatible</option>: Use this
337 switch if you are building <application>GNAT</application> tools using a
338 <application>GCC</application> version prior to 5.1.0,
339 and you do not want to recompile all the libraries written in C++.
340 </para>
341
342 <para>
343 <command>ulimit -s 32768</command>: This command prevents several
344 tests from running out of stack space.
345 </para>
346
347 <para>
348 <command>make -k check</command>: This command runs the test suite
349 without stopping if any errors are encountered.
350 </para>
351
352 <para>
353 <command>../contrib/test_summary</command>: This
354 command will produce a summary of the test suite results. You can append
355 <command>| grep -A7 Summ</command> to the command to produce an even more
356 condensed version of the summary. You may also wish to redirect the output
357 to a file for review and comparison later on.
358 </para>
359
360 <para>
361 <command>chown -v -R root:root /usr/lib/gcc/*linux-gnu/...</command>:
362 If the package is built by a user other than root, the ownership of the
363 installed <filename class="directory">include</filename> and
364 <filename class="directory">adalib</filename> directories (and their
365 contents) will be incorrect. These commands change the ownership to the
366 <systemitem class="username">root</systemitem> user and group.
367 </para>
368
369 </sect2>
370
371 <sect2 role="content">
372 <title>Contents</title>
373
374 <segmentedlist>
375 <segtitle>Installed Programs</segtitle>
376 <segtitle>Installed Libraries</segtitle>
377 <segtitle>Installed Directories</segtitle>
378
379 <seglistitem>
380 <seg>
381 gnat, gnatbind, gnatchop, gnatclean, gnatfind, gnatkr,
382 gnatlink, gnatls, gnatmake, gnatname, gnatprep, gnatxref
383 </seg>
384 <seg>
385 libgnarl.{so,a}, libgnat.{so,a} in <filename class="directory">
386 /usr/lib/gcc/&lt;arch-triplet&gt;/&gcc-ada-version;/adalib</filename>
387 </seg>
388 <seg>
389 /usr/lib/gcc/&lt;arch-triplet&gt;/&gcc-ada-version;/ada{include,lib}
390 and /usr/lib/gcc/&lt;arch-triplet&gt;/&gcc-ada-version;/plugin/include/ada
391 </seg>
392 </seglistitem>
393 </segmentedlist>
394
395 <para>
396 Only the Ada specific files are listed here. Others can be found at
397 <ulink url="&lfs-root;/chapter06/gcc.html#contents-gcc"/> as they were
398 initially installed during the building of LFS.
399 </para>
400
401 <variablelist>
402 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
403 <?dbfo list-presentation="list"?>
404 <?dbhtml list-presentation="table"?>
405
406 <varlistentry id="gnat">
407 <term><command>gnat</command></term>
408 <listitem>
409 <para>
410 is a wrapper that accepts a number of commands and calls
411 the corresponding tool from the list below.
412 </para>
413 <indexterm zone="gcc-ada gnat">
414 <primary sortas="b-gnat">gnat</primary>
415 </indexterm>
416 </listitem>
417 </varlistentry>
418
419 <varlistentry id="gnatbind">
420 <term><command>gnatbind</command></term>
421 <listitem>
422 <para>
423 is used to bind compiled objects.
424 </para>
425 <indexterm zone="gcc-ada gnatbind">
426 <primary sortas="b-gnatbind">gnatbind</primary>
427 </indexterm>
428 </listitem>
429 </varlistentry>
430
431 <varlistentry id="gnatchop">
432 <term><command>gnatchop</command></term>
433 <listitem>
434 <para>
435 is useful for renaming files to meet the standard
436 <application>Ada</application> default file naming conventions.
437 </para>
438 <indexterm zone="gcc-ada gnatchop">
439 <primary sortas="b-gnatchop">gnatchop</primary>
440 </indexterm>
441 </listitem>
442 </varlistentry>
443
444 <varlistentry id="gnatclean">
445 <term><command>gnatclean</command></term>
446 <listitem>
447 <para>
448 is used to remove files associated with a
449 <application>GNAT</application> project.
450 </para>
451 <indexterm zone="gcc-ada gnatclean">
452 <primary sortas="b-gnatclean">gnatclean</primary>
453 </indexterm>
454 </listitem>
455 </varlistentry>
456
457 <varlistentry id="gnatfind">
458 <term><command>gnatfind</command></term>
459 <listitem>
460 <para>
461 is intended for locating definition and/or references to
462 specified entities in a <application>GNAT</application> project.
463 </para>
464 <indexterm zone="gcc-ada gnatfind">
465 <primary sortas="b-gnatfind">gnatfind</primary>
466 </indexterm>
467 </listitem>
468 </varlistentry>
469
470 <varlistentry id="gnatkr">
471 <term><command>gnatkr</command></term>
472 <listitem>
473 <para>
474 is used to determine the crunched name for a given file, when
475 crunched to a specified maximum length.
476 </para>
477 <indexterm zone="gcc-ada gnatkr">
478 <primary sortas="b-gnatkr">gnatkr</primary>
479 </indexterm>
480 </listitem>
481 </varlistentry>
482
483 <varlistentry id="gnatlink">
484 <term><command>gnatlink</command></term>
485 <listitem>
486 <para>
487 is used to link programs and build an executable file.
488 </para>
489 <indexterm zone="gcc-ada gnatlink">
490 <primary sortas="b-gnatlink">gnatlink</primary>
491 </indexterm>
492 </listitem>
493 </varlistentry>
494
495 <varlistentry id="gnatls">
496 <term><command>gnatls</command></term>
497 <listitem>
498 <para>
499 is the compiled unit browser.
500 </para>
501 <indexterm zone="gcc-ada gnatls">
502 <primary sortas="b-gnatls">gnatls</primary>
503 </indexterm>
504 </listitem>
505 </varlistentry>
506
507 <varlistentry id="gnatmake">
508 <term><command>gnatmake</command></term>
509 <listitem>
510 <para>
511 is the <application>Ada</application> compiler, which performs
512 compilation, binding and linking.
513 </para>
514 <indexterm zone="gcc-ada gnatmake">
515 <primary sortas="b-gnatmake">gnatmake</primary>
516 </indexterm>
517 </listitem>
518 </varlistentry>
519
520 <varlistentry id="gnatname">
521 <term><command>gnatname</command></term>
522 <listitem>
523 <para>
524 will list the files associated with a
525 <application>GNAT</application> project.
526 </para>
527 <indexterm zone="gcc-ada gnatname">
528 <primary sortas="b-gnatname">gnatname</primary>
529 </indexterm>
530 </listitem>
531 </varlistentry>
532
533 <varlistentry id="gnatprep">
534 <term><command>gnatprep</command></term>
535 <listitem>
536 <para>
537 is the <application>GNAT</application> external preprocessor.
538 </para>
539 <indexterm zone="gcc-ada gnatprep">
540 <primary sortas="b-gnatprep">gnatprep</primary>
541 </indexterm>
542 </listitem>
543 </varlistentry>
544
545 <varlistentry id="gnatxref">
546 <term><command>gnatxref</command></term>
547 <listitem>
548 <para>
549 is similar to <command>gnatfind</command>, but generates
550 a full report of all cross-references.
551 </para>
552 <indexterm zone="gcc-ada gnatxref">
553 <primary sortas="b-gnatxref">gnatxref</primary>
554 </indexterm>
555 </listitem>
556 </varlistentry>
557
558 </variablelist>
559
560 </sect2>
561
562</sect1>
Note: See TracBrowser for help on using the repository browser.