diff options
author | Sebastian Huber <sebastian.huber@embedded-brains.de> | 2020-09-25 07:43:08 +0200 |
---|---|---|
committer | Sebastian Huber <sebastian.huber@embedded-brains.de> | 2020-09-25 18:56:28 +0200 |
commit | 2fb86e27ce4dc4bf061867efa9df11131c357939 (patch) | |
tree | f05fdb52d1fcbf89b07560fc2877c79258088ba7 /user/bld/index.rst | |
parent | i386: tweak grammar and style (diff) | |
download | rtems-docs-2fb86e27ce4dc4bf061867efa9df11131c357939.tar.bz2 |
user: Add migration hints from old build system
Update #3818.
Diffstat (limited to '')
-rw-r--r-- | user/bld/index.rst | 98 |
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 |