aboutsummaryrefslogtreecommitdiffstats
path: root/doc/getting/GCC.rst
diff options
context:
space:
mode:
Diffstat (limited to 'doc/getting/GCC.rst')
-rw-r--r--doc/getting/GCC.rst75
1 files changed, 0 insertions, 75 deletions
diff --git a/doc/getting/GCC.rst b/doc/getting/GCC.rst
deleted file mode 100644
index 7a8cd9b56..000000000
--- a/doc/getting/GCC.rst
+++ /dev/null
@@ -1,75 +0,0 @@
-.. _BUILD:gcc:
-
-GCC backend
-###########
-
-.. TODO :: Instructions to build GHDL with GCC backend on Windows are not available yet.
-
-.. rubric:: Requirements
-
-* GCC (Gnu Compiler Collection)
-* GNAT (Ada compiler for GCC)
-* GCC source files. Download and untar the sources of version 4.9.x, 5.x, 6.x, 7.x, 8.x, 9.x or 10.x.
-
-.. HINT :: There are some dependencies for building GCC (``gmp``, ``mpfr`` and ``mpc``). If you have not installed them on your system, you can either build them manually or use the ``download_prerequisites`` script provided in the GCC source tree (recommended): ``cd /path/to/gcc/source/dir && ./contrib/download_prerequisites``.
-
-* First configure GHDL, specify GCC source directory and installation prefix (like ``/usr/local`` or ``/opt/ghdl``).
-* Next, invoke ``make copy-sources`` to copy GHDL sources in the source directory.
-* Then, configure GCC. The list of ``--disable`` configure options can be adjusted to your needs. GHDL does not require all these optional libraries and disabling them will speed up the build.
-* Now, build and install GCC with ``make``.
-* Last, build and install GHDL libraries.
-
-.. rubric:: Example:
-
-.. code-block:: Bash
-
- $ cd <ghdl>
- $ mkdir build
- $ cd build
- $ ../configure --with-gcc=/path/to/gcc/source/dir --prefix=/usr/local
- $ make copy-sources
- $ mkdir gcc-objs; cd gcc-objs
- $ /path/to/gcc/source/dir/configure --prefix=/usr/local --enable-languages=c,vhdl \
- --disable-bootstrap --disable-lto --disable-multilib --disable-libssp \
- --disable-libgomp --disable-libquadmath
- $ make -j2 && make install
- $ cd /path/to/ghdl/source/dir/build
- $ make ghdllib
- $ make install
-
-.. HINT :: Note that the prefix directory to configure ``gcc`` must be the same as the one used to configure GHDL. If you have manually built ``gmp``/``mpfr``/``mpc`` (without using the script in ``contrib``), and, if you have installed them in a non-standard directory, you may need to add ``--with-gmp=GMP_INSTALL_DIR``.
-
-.. HINT :: If your system gcc was configured with ``--enable-default-pie`` (check if that option appears in the output of ``gcc -v``), you should also add it.
-
-.. HINT :: If you don't want to install ``makeinfo``, do ``make install MAKEINFO=true`` instead.
-
-.. HINT :: Once GCC (with GHDL) has been built once, it is possible to work on the GHDL source tree without copying it in the GCC tree. Commands are::
-
- $ make ghdl1-gcc # Build the compiler
- $ make ghdl_gcc # Build the driver
- $ make libs.vhdl.local_gcc # Compile the vhdl libraries
- $ make grt-all # Build the GHDL runtime
- $ make install.vpi.local # Locally install vpi files
-
- In ``src/ortho/gcc``, create a ``Makefile.conf`` file that sets the following
- variables:
-
- .. CODE:: Bash
-
- AGCC_GCCSRC_DIR=/path/to/gcc/sources
- AGCC_GCCOBJ_DIR=/path/to/gcc/build
-
- If your system gcc was built with ``--enable-default-pie``, add
- ``-no-pie`` option for linking.
-
-.. HINT :: For ppc64/ppc64le platform, the object file format contains an identifier for the source language. Because gcc doesn't know about VHDL, gcc crashes very early. This could be fixed with a very simple change in ``gcc/config/rs6000/rs6000.c`` (``gcc/config/rs6000/rs6000-logue.c`` since gcc 10), function ``rs6000_output_function_epilogue``:
-
- .. CODE:: diff
-
- || ! strcmp (language_string, "GNU GIMPLE")
- || ! strcmp (language_string, "GNU Go")
- || ! strcmp (language_string, "GNU D")
- - || ! strcmp (language_string, "libgccjit"))
- + || ! strcmp (language_string, "libgccjit")
- + || ! strcmp (language_string, "vhdl"))
- i = 0;