summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorSebastian Huber <sebastian.huber@embedded-brains.de>2020-09-25 07:43:08 +0200
committerSebastian Huber <sebastian.huber@embedded-brains.de>2020-09-25 18:56:28 +0200
commit2fb86e27ce4dc4bf061867efa9df11131c357939 (patch)
treef05fdb52d1fcbf89b07560fc2877c79258088ba7
parent5a206711c013afddb0ca8d03adb96e506a6a8900 (diff)
downloadrtems-docs-2fb86e27ce4dc4bf061867efa9df11131c357939.tar.bz2
user: Add migration hints from old build system
Update #3818.
-rw-r--r--user/bld/index.rst98
1 files changed, 96 insertions, 2 deletions
diff --git a/user/bld/index.rst b/user/bld/index.rst
index b47cee8..ebedf5a 100644
--- a/user/bld/index.rst
+++ b/user/bld/index.rst
@@ -1,7 +1,7 @@
.. SPDX-License-Identifier: CC-BY-SA-4.0
-.. Copyright (C) 2019 embedded brains GmbH
-.. Copyright (C) 2019 Sebastian Huber
+.. Copyright (C) 2019, 2020 embedded brains GmbH
+.. Copyright (C) 2019, 2020 Sebastian Huber
.. index:: BSP build system
.. index:: build system
@@ -283,3 +283,97 @@ example configuration file, building of the tests is enabled for the
[sparc/erc32]
[riscv/griscv]
+
+Migration from Autoconf/Automake
+================================
+
+The Autoconf/Automake based build system used a ``configure`` command to
+configure a single target architecture and one or more BSPs. The ``make``
+command was used to build it. The ``configure`` command is replaced by a
+``./waf configure`` invocation with configuration file. The ``make`` command
+is replaced by ``./waf`` and ``make install`` is replaced by ``./waf install``.
+
+Here are some hints for how a configure command line can be converted to
+options in the configuration file of the ``waf`` based build system. BSP
+options given at the configure command line have to be added to the BSP section
+in the configuration file.
+
+``--target=${arch}-rtems6`` ``--enable-rtembsp=${bsp}``
+ To build a BSP add ``[${arch}/${bsp}]`` to the configuration file.
+
+``--enable-ada`` | ``--disable-ada``
+ Set ``__RTEMS_ADA__`` to ``True`` or ``False`` in the BSP section of
+ the configuration file.
+
+``--enable-multiprocessing`` | ``--disable-multiprocessing``
+ Set ``RTEMS_MULTIPROCESSING`` to ``True`` or ``False`` in the BSP
+ section of the configuration file.
+
+``--enable-networking`` | ``--disable-networking``
+ Set ``RTEMS_NETWORKING`` to ``True`` or ``False`` in the BSP section of
+ the configuration file.
+
+``--enable-paravirt`` | ``--disable-paravirt``
+ Set ``RTEMS_PARAVIRT`` to ``True`` or ``False`` in the BSP section of
+ the configuration file.
+
+``--enable-profiling`` | ``--disable-profiling``
+ Set ``RTEMS_PROFILING`` to ``True`` or ``False`` in the BSP section of
+ the configuration file.
+
+``--enable-posix`` | ``--disable-posix``
+ Set ``RTEMS_POSIX_API`` to ``True`` or ``False`` in the BSP section of
+ the configuration file.
+
+``--enable-rtems-debug`` | ``--disable-rtems-debug``
+ Set ``RTEMS_DEBUG`` to ``True`` or ``False`` in the BSP section of the
+ configuration file.
+
+``--enable-smp`` | ``--disable-smp``
+ Set ``RTEMS_SMP`` to ``True`` or ``False`` in the BSP section of the
+ configuration file.
+
+``--enable-tests`` | ``--disable-tests``
+ Set ``BUILD_TESTS`` to ``True`` or ``False`` in the BSP section of the
+ configuration file.
+
+``--enable-tests=samples``
+ Set ``BUILD_SAMPLES`` to ``True`` or ``False`` in the BSP section of
+ the configuration file.
+
+Please have a look at the following example configuration file.
+
+.. code-block:: ini
+
+ # --target=sparc-rtems6 --enable-rtemsbsp=erc32
+ [sparc/erc32]
+
+ # --enable-ada
+ __RTEMS_ADA__ = True
+
+ # --enable-multiprocessing
+ RTEMS_MULTIPROCESSING = False
+
+ # --enable-networking
+ RTEMS_NETWORKING = True
+
+ # --disable-paravirt
+ RTEMS_PARAVIRT = False
+
+ # --enable-profiling
+ RTEMS_PROFILING = True
+
+ # --disable-posix
+ RTEMS_POSIX_API = False
+
+ # --enable-rtems-debug
+ RTEMS_DEBUG = True
+
+ # --disable-smp
+ RTEMS_SMP = False
+
+ # --enable-tests
+ BUILD_TESTS = True
+
+ # BSP_POWER_DOWN_AT_FATAL_HALT=
+ BSP_POWER_DOWN_AT_FATAL_HALT = False