Changeset 2fb86e2 in rtems-docs


Ignore:
Timestamp:
Sep 25, 2020, 5:43:08 AM (5 weeks ago)
Author:
Sebastian Huber <sebastian.huber@…>
Branches:
master
Children:
647bfdd
Parents:
5a20671
git-author:
Sebastian Huber <sebastian.huber@…> (09/25/20 05:43:08)
git-committer:
Sebastian Huber <sebastian.huber@…> (09/25/20 16:56:28)
Message:

user: Add migration hints from old build system

Update #3818.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • user/bld/index.rst

    r5a20671 r2fb86e2  
    11.. SPDX-License-Identifier: CC-BY-SA-4.0
    22
    3 .. Copyright (C) 2019 embedded brains GmbH
    4 .. Copyright (C) 2019 Sebastian Huber
     3.. Copyright (C) 2019, 2020 embedded brains GmbH
     4.. Copyright (C) 2019, 2020 Sebastian Huber
    55
    66.. index:: BSP build system
     
    284284
    285285    [riscv/griscv]
     286
     287Migration from Autoconf/Automake
     288================================
     289
     290The Autoconf/Automake based build system used a ``configure`` command to
     291configure a single target architecture and one or more BSPs.  The ``make``
     292command was used to build it.  The ``configure`` command is replaced by a
     293``./waf configure`` invocation with configuration file.  The ``make`` command
     294is replaced by ``./waf`` and ``make install`` is replaced by ``./waf install``.
     295
     296Here are some hints for how a configure command line can be converted to
     297options in the configuration file of the ``waf`` based build system.  BSP
     298options given at the configure command line have to be added to the BSP section
     299in the configuration file.
     300
     301``--target=${arch}-rtems6`` ``--enable-rtembsp=${bsp}``
     302        To build a BSP add ``[${arch}/${bsp}]`` to the configuration file.
     303
     304``--enable-ada`` | ``--disable-ada``
     305        Set ``__RTEMS_ADA__`` to ``True`` or ``False`` in the BSP section of
     306        the configuration file.
     307
     308``--enable-multiprocessing`` | ``--disable-multiprocessing``
     309        Set ``RTEMS_MULTIPROCESSING`` to ``True`` or ``False`` in the BSP
     310        section of the configuration file.
     311
     312``--enable-networking`` | ``--disable-networking``
     313        Set ``RTEMS_NETWORKING`` to ``True`` or ``False`` in the BSP section of
     314        the configuration file.
     315
     316``--enable-paravirt`` | ``--disable-paravirt``
     317        Set ``RTEMS_PARAVIRT`` to ``True`` or ``False`` in the BSP section of
     318        the configuration file.
     319
     320``--enable-profiling`` | ``--disable-profiling``
     321        Set ``RTEMS_PROFILING`` to ``True`` or ``False`` in the BSP section of
     322        the configuration file.
     323
     324``--enable-posix`` | ``--disable-posix``
     325        Set ``RTEMS_POSIX_API`` to ``True`` or ``False`` in the BSP section of
     326        the configuration file.
     327
     328``--enable-rtems-debug`` | ``--disable-rtems-debug``
     329        Set ``RTEMS_DEBUG`` to ``True`` or ``False`` in the BSP section of the
     330        configuration file.
     331
     332``--enable-smp`` | ``--disable-smp``
     333        Set ``RTEMS_SMP`` to ``True`` or ``False`` in the BSP section of the
     334        configuration file.
     335
     336``--enable-tests`` | ``--disable-tests``
     337        Set ``BUILD_TESTS`` to ``True`` or ``False`` in the BSP section of the
     338        configuration file.
     339
     340``--enable-tests=samples``
     341        Set ``BUILD_SAMPLES`` to ``True`` or ``False`` in the BSP section of
     342        the configuration file.
     343
     344Please have a look at the following example configuration file.
     345
     346.. code-block:: ini
     347
     348    # --target=sparc-rtems6 --enable-rtemsbsp=erc32
     349    [sparc/erc32]
     350
     351    # --enable-ada
     352    __RTEMS_ADA__ = True
     353
     354    # --enable-multiprocessing
     355    RTEMS_MULTIPROCESSING = False
     356
     357    # --enable-networking
     358    RTEMS_NETWORKING = True
     359
     360    # --disable-paravirt
     361    RTEMS_PARAVIRT = False
     362
     363    # --enable-profiling
     364    RTEMS_PROFILING = True
     365
     366    # --disable-posix
     367    RTEMS_POSIX_API = False
     368
     369    # --enable-rtems-debug
     370    RTEMS_DEBUG = True
     371
     372    # --disable-smp
     373    RTEMS_SMP = False
     374
     375    # --enable-tests
     376    BUILD_TESTS = True
     377
     378    # BSP_POWER_DOWN_AT_FATAL_HALT=
     379    BSP_POWER_DOWN_AT_FATAL_HALT = False
Note: See TracChangeset for help on using the changeset viewer.