Changeset 7f89df8 in rtems-docs


Ignore:
Timestamp:
May 24, 2017, 3:07:21 AM (12 months ago)
Author:
Chris Johns <chrisj@…>
Branches:
master
Children:
d224b11
Parents:
39773ce
Message:

User Manual: Update the rtems-bsp-builder command.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • user/tools/bsp-builder.rst

    r39773ce r7f89df8  
    1818
    1919There are a number of RTEMS developers each with a different view or expertise
    20 in RTEMS. Developer can work in the generic areas such as scheduling, file
    21 systems or the shell, then there are users turned developers adding a new BSP,
    22 or even a new port to a new architecture. A common approach for all these
    23 developers is to select a BSP and to work with that BSP. Developers working in
    24 a generic areas of RTEMS tend to select a BSP that has good simulator support
    25 with good debugging such as QEMU, while developers of a new BSP or a new port
    26 tend to work on target hardware. This type of development does not check the
    27 other architectures, BSP, and build options and a change may change the number
    28 of warnings or introduce build errors. It is important for the RTEMS project to
    29 have developers fix these issues before pushing the changes to master
     20in RTEMS. Developers can work in the generic areas such as scheduling, file
     21systems or the shell, or users can become developers adding a new BSP, or even
     22a new port to a new architecture. A common approach for all these developers is
     23to select a BSP and to work with that BSP. Developers working in a generic
     24areas of RTEMS tend to select a BSP that has good simulator support with good
     25debugging such as QEMU, while developers of a new BSP or a new port tend to
     26work on target hardware. This type of development does not check the other
     27architectures, BSP, and build options and a change may change the number of
     28warnings or introduce build errors. It is important for the RTEMS project to
     29have developers fix these issues before pushing the changes to the master
    3030repository to avoid breaking the code for other developers. It is best for a
    3131developer to resolve as many issues as they work on changes because comming
     
    4545#. Board Support Package (BSP)
    4646
    47 #. Build Configuration options
     47#. Build options
    4848
    4949#. BSP Options
    5050
    51 The BSP Builder provides a template of build variation to try and reduce the
    52 possble combinations to something manageable. It is not realistic to build all
    53 possible combinations on a single machine in reasonible time.
     51The BSP Builder provides a template of builds to try and reduce the possble
     52combinations to something manageable. It is not realistic to build all possible
     53combinations on a single machine in reasonible time.
    5454
    5555The RTEMS BSP Builder specifies it builds in terms of:
     
    5757#. Profiles
    5858
     59#. Architectures
     60
     61#. BSPs
     62
    5963#. Builds
    6064
    61 The RTEMS BSP Builder will build a list of builds for a profile of board
    62 support packages.
     65The RTEMS BSP Builder builds are created by user options that vary these parameters.
    6366
    6467Profiles
     
    6972in the specified architectures.
    7073
    71 The default configuration provides standard profiles based on
    72 :ref:`Tiers`. They are:
     74The default configuration provides standard profiles for :ref:`Tiers`. They are:
    7375
    7476#. ``tier-1`` (default)
     
    7981
    8082#. ``tier-4``
     83
     84The ``everythings`` profile allows all BSPs to be built.
    8185
    8286Builds
    8387^^^^^^
    8488
    85 A build is a list of builds and each BSP in a profiles is built using each
    86 build in the builds list.
     89A build is a list of builds or a build set and each BSP in a profile,
     90architecture of BSP is built with.
    8791
    8892The default configuration provides standard builds based around the commonly
     
    9397#. ``all`` (default)
    9498
    95 #. ``basic``
    96 
    97 A ``basic`` build is the ``standard`` or default set configure options.
     99#. ``tests``
     100
     101#. ``standard``, also ``no-tests``
     102
     103#. ``debug``
     104
     105#. ``profiling``
     106
     107#. ``smp``
     108
     109#. ``smp-debug``
     110
     111#. ``posix``
     112
     113#. ``no-posix``
     114
     115#. ``posix-debug``
     116
     117#. ``posix-profiling``
     118
     119#. ``network``
     120
     121#. ``no-network``
     122
     123#. ``network-debug``
     124
     125#. ``smp-network``
     126
     127#. ``smp-network-debug``
     128
     129All Build
     130~~~~~~~~~
    98131
    99132The ``all`` build is:
    100133
    101  +-----------------------+-----------------------------------------------------+
    102  | Label                 | Configure Options                                   |
    103  +-----------------------+-----------------------------------------------------+
    104  | ``debug``             | ``--enable-debug``                                  |
    105  +-----------------------+-----------------------------------------------------+
    106  | ``profiling``         | ``--enable-profiling``                              |
    107  +-----------------------+-----------------------------------------------------+
    108  | ``smp``               | ``--enable-sm``                                     |
    109  +-----------------------+-----------------------------------------------------+
    110  | ``smp-debug``         | ``--enable-smp --enable-debug``                     |
    111  +-----------------------+-----------------------------------------------------+
    112  | ``posix``             | ``--enable-posix``                                  |
    113  +-----------------------+-----------------------------------------------------+
    114  | ``no-posix``          | ``--disable-posix``                                 |
    115  +-----------------------+-----------------------------------------------------+
    116  | ``posix-debug``       | ``--enable-posix --enable-debug``                   |
    117  +-----------------------+-----------------------------------------------------+
    118  | ``posix-profiling``   | ``--enable-posix --enable-profiling``               |
    119  +-----------------------+-----------------------------------------------------+
    120  | ``posix-smp``         | ``--enable-posix --enable-smp``                     |
    121  +-----------------------+-----------------------------------------------------+
    122  | ``network``           | ``--enable-networking``                             |
    123  +-----------------------+-----------------------------------------------------+
    124  | ``no-network``        | ``--disable-networking``                            |
    125  +-----------------------+-----------------------------------------------------+
    126  | ``network-debug``     | ``--disable-networking``                            |
    127  +-----------------------+-----------------------------------------------------+
    128  | ``network-debug``     | ``--enable-debug --enable-networking``              |
    129  +-----------------------+-----------------------------------------------------+
    130  | ``smp-network``       | ``--enable-smp --enable-networking``                |
    131  +-----------------------+-----------------------------------------------------+
    132  | ``smp-network-debug`` | ``--enable-smp --enable-debug --enable-networking`` |
    133  +-----------------------+-----------------------------------------------------+
     134- ``debug``
     135- ``profiling``
     136- ``smp``
     137- ``smp-debug``
     138- ``posix``
     139- ``no-posix``
     140- ``posix-debug``
     141- ``posix-profiling``
     142- ``network``
     143- ``no-network``
     144- ``network-debug``
     145- ``smp-network``
     146- ``smp-network-debug``
     147
     148A build maps to specific configuration options. The mappings are:
     149
     150 +-----------------------+-----------------------------------------------------+
     151 | ``debug``             | ``config:base``, ``config:debug``                   |
     152 +-----------------------+-----------------------------------------------------+
     153 | ``profiling``         | ``config:base``, ``config:profiling``               |
     154 +-----------------------+-----------------------------------------------------+
     155 | ``smp``               | ``config:base``, ``config:smp``                     |
     156 +-----------------------+-----------------------------------------------------+
     157 | ``smp-debug``         | ``config:base``, ``config:smp``, ``config:debug``   |
     158 +-----------------------+-----------------------------------------------------+
     159 | ``posix``             | ``config:base``, ``config:posix``                   |
     160 +-----------------------+-----------------------------------------------------+
     161 | ``no-posix``          | ``config:base``, ``config:no-posix``                |
     162 +-----------------------+-----------------------------------------------------+
     163 | ``posix-debug``       | ``config:base``, ``config:posix``, ``config:debug`` |
     164 +-----------------------+-----------------------------------------------------+
     165 | ``posix-profiling``   | ``config:base``, ``config:posix``,                  |
     166 |                       | ``config:profiling``                                |
     167 +-----------------------+-----------------------------------------------------+
     168 | ``network``           | ``config:base``, ``config:network``                 |
     169 +-----------------------+-----------------------------------------------------+
     170 | ``no-network``        | ``config:base``, ``config:no-network``              |
     171 +-----------------------+-----------------------------------------------------+
     172 | ``network-debug``     | ``config:base``, ``config:network``,                |
     173 |                       | ``config:debug``                                    |
     174 +-----------------------+-----------------------------------------------------+
     175 | ``smp-network``       | ``config:base``, ``config:smp``, ``config:network`` |
     176 +-----------------------+-----------------------------------------------------+
     177 | ``smp-network-debug`` | ``config:base``, ``config:smp``,                    |
     178 |                       | ``config:network``, ``config:debug``                |
     179 +-----------------------+-----------------------------------------------------+
     180
     181Build Configurations
     182--------------------
     183
     184Build configurations are ``configure`` options. These are mapped to the various
     185builds. The configurations are:
     186
     187 +------------------+----------------------------------------------------------+
     188 | ``base``         | ``--target=@ARCH@-rtems@RTEMS_VERSION@``                 |
     189 |                  | ``--enable-rtemsbsp=@BSP@``                              |
     190 |                  | ``--prefix=@PREFIX@``                                    |
     191 +------------------+----------------------------------------------------------+
     192 | ``tests``        | ``--enable-tests``                                       |
     193 +------------------+----------------------------------------------------------+
     194 | ``debug``        | ``--enable-debug``                                       |
     195 +------------------+----------------------------------------------------------+
     196 | ``no-debug``     | ``--disable-debug``                                      |
     197 +------------------+----------------------------------------------------------+
     198 | ``profiling``    | ``--enable-profiling``                                   |
     199 +------------------+----------------------------------------------------------+
     200 | ``no-profiling`` | ``--disable-profiling``                                  |
     201 +------------------+----------------------------------------------------------+
     202 | ``smp``          | ``--enable-smp``                                         |
     203 +------------------+----------------------------------------------------------+
     204 | ``no-smp``       | ``--disable-smp``                                        |
     205 +------------------+----------------------------------------------------------+
     206 | ``posix``        | ``--enable-posix``                                       |
     207 +------------------+----------------------------------------------------------+
     208 | ``no-posix``     | ``--disable-posix``                                      |
     209 +------------------+----------------------------------------------------------+
     210 | ``network``      | ``--enable-networking``                                  |
     211 +------------------+----------------------------------------------------------+
     212 | ``no-network``   | ``--disable-networking``                                 |
     213 +------------------+----------------------------------------------------------+
     214
     215Performance
     216-----------
     217
     218The RTEMS BSP Builder is designed to extract the maximum performance from your
     219hardware when building RTEMS. The RTEMS build system is based on ``autoconf``,
     220``automake`` and GNU ``make``. Building consists of two phases:
     221
     222#. Configuring
     223
     224#. Building
     225
     226The Configuring phase and the start of the Build phase runs autoconf's
     227``configure`` scripts. These execute as a single linear process and are not run
     228in parallel even if you specify more than one job to ``make``. The configure
     229part of a build is approximately 30% of the total time and higher if building
     230the tests. Performing a single build at a time will not fully utilized a
     231multi-core machine because of the large amount of time the system is idle.
     232
     233The RTEMS BSP Builder can run more than one build in parallel. A build can also
     234request ``make`` run its build with more than one job. The ``--jobs`` option
     235lets a user specify the number of build jobs to run at once and the number of
     236``make`` jobs each build runs with. Together these options can fully load a
     237system and can overload a machine.
     238
     239Tuning the best ratio of buld jobs to make jobs requires running some builds
     240and observing the system's performance. If the build job count is too low the
     241system will show idle periods and if you have too many build jobs with too many
     242make jobs the system will have too many processing running and the operating
     243system's overheads in administting too processes at once lowers the overall
     244performance.
     245
     246A fast eight core machine where the operating system shows sixteen cores can
     247support a build option of ``--jobs=5/10``. The machine will be fully loaded the
     248average build time is around 18 seconds.
     249
     250The type of build selected effects the optimum jobs option. For example
     251building the tests changes the percentage of time spent configuring copmared to
     252bulding so the make jobs parameter becomes a dominant factor. Lowering the make
     253jobs value avoids having too many active processes running at once.
    134254
    135255Command
     
    170290   The log file.
    171291
     292.. option:: --config-report
     293
     294   Print a configuration report and exit.
     295
     296.. option:: --warnings-report
     297
     298   Create a warnings report once all builds have finished.
     299
    172300.. option:: --stop-on-error
    173301
     
    183311.. option:: --profiles
    184312
    185    Build the list of profiles. The default is ``tier-1``.
     313   Build the comma separated list of profiles. The default is ``tier-1``.
     314
     315.. option:: --arch
     316
     317   A comma separated list of architecures to build using the selected build.
     318
     319.. option:: --bsp
     320
     321   A comma separated list of BSPs to build where a BSP is of the format
     322   ``arch/bsp`` using the selected build.
    186323
    187324.. option:: --build
    188325
    189    The build to be used. The default is ``all``.
    190 
    191 .. option:: --arch
    192 
    193    Specify an architecure for a BSP to build instead of using a profile.
    194 
    195 .. option:: --bsp
    196 
    197    The a specific BSP to build instead of using a profile.
     326   The build to be used. The default is ``all``. See ``--config-report`` for a
     327   list of vlaid builds.
     328
     329.. option:: --jobs
     330
     331   The jobs options where the format is ``build-jobs/make-jobs``. The default
     332   is ``1/num-cores`` where ``num-cores`` is the operating system reported
     333   number of cores.
    198334
    199335.. option:: --dry-run
     
    207343source and tools are located on fast SSD disks and the build happens on a
    208344spinning disk mounted under `build`. The build uses a development source tree
    209 that is configured and ready to build. The source can have local patches that
     345that is bootstrapped and ready to build. The source can have local patches that
    210346need to be regression tested:
    211347
     
    215351            --rtems-tools=/opt/work/rtems/4.12 \
    216352            --rtems=/opt/work/chris/rtems/kernel/rtems.git \
    217             --profiles=tier-1
    218   RTEMS Tools Project - RTEMS Kernel BSP Builder, 4.12 (31e22e337cf3 modified)
    219   ]] Profile: tier-1
    220   ] BSP: arm/altcycv_devkit
    221   . Creating: build/arm/altcycv_devkit
    222   . Configuring: debug
    223   . Building: debug
    224   + Pass: debug: warnings:99  exes:560  objs:2760  libs:76
    225     Status: configure:0 build:0
    226   . Cleaning: build/arm/altcycv_devkit/debug
    227   ^ Time 0:03:45.450099
    228   . Configuring: no-posix
    229   . Building: no-posix
    230   + Pass: no-posix: warnings:99  exes:560  objs:2760  libs:76
    231     Status: configure:0 build:0
    232   . Cleaning: build/arm/altcycv_devkit/no-posix
    233   ^ Time 0:03:39.598817
    234   . Configuring: posix
    235   . Building: posix
    236   + Pass: posix: warnings:99  exes:560  objs:2760  libs:76
    237     Status: configure:0 build:0
    238   . Cleaning: build/arm/altcycv_devkit/posix
    239   ^ Time 0:03:40.242016
    240   . Configuring: posix-debug
    241   . Building: posix-debug
    242   + Pass: posix-debug: warnings:99  exes:560  objs:2760  libs:76
    243     Status: configure:0 build:0
    244   . Cleaning: build/arm/altcycv_devkit/posix-debug
    245   ^ Time 0:03:40.325694
    246   . Configuring: posix-profiling
    247   . Building: posix-profiling
    248   + Pass: posix-profiling: warnings:99  exes:560  objs:2760  libs:76
    249     Status: configure:0 build:0
    250   . Cleaning: build/arm/altcycv_devkit/posix-profiling
    251   ^ Time 0:03:39.999044
    252   . Configuring: posix-smp
    253   . Building: posix-smp
    254   + Pass: posix-smp: warnings:99  exes:560  objs:2760  libs:76
    255     Status: configure:0 build:0
    256   . Cleaning: build/arm/altcycv_devkit/posix-smp
    257   ^ Time 0:03:39.462674
    258   . Configuring: profiling
    259   . Building: profiling
    260   + Pass: profiling: warnings:99  exes:560  objs:2760  libs:76
    261     Status: configure:0 build:0
    262   . Cleaning: build/arm/altcycv_devkit/profiling
    263   ^ Time 0:03:39.860434
    264   . Configuring: smp
    265   . Building: smp
    266   + Pass: smp: warnings:99  exes:560  objs:2760  libs:76
    267     Status: configure:0 build:0
    268   . Cleaning: build/arm/altcycv_devkit/smp
    269   ^ Time 0:03:39.928132
    270   . Configuring: smp-debug
    271   . Building: smp-debug
    272   + Pass: smp-debug: warnings:99  exes:560  objs:2760  libs:76
    273     Status: configure:0 build:0
    274   . Cleaning: build/arm/altcycv_devkit/smp-debug
    275   ^ Time 0:03:40.414716
    276   ^ BSP Time 0:33:09.399355
    277   ] BSP: arm/altcycv_devkit_smp
    278   . Creating: build/arm/altcycv_devkit_smp
    279   . Configuring: debug
    280   . Building: debug
    281   + Pass: debug: warnings:99  exes:560  objs:2760  libs:76
    282     Status: configure:0 build:0
    283   . Cleaning: build/arm/altcycv_devkit_smp/debug
    284   ^ Time 0:03:39.891703
    285   . Configuring: no-posix
    286   . Building: no-posix
    287   + Pass: no-posix: warnings:99  exes:560  objs:2760  libs:76
    288     Status: configure:0 build:0
    289   . Cleaning: build/arm/altcycv_devkit_smp/no-posix
    290   ^ Time 0:03:40.730781
    291   . Configuring: posix
    292   . Building: posix
    293   + Pass: posix: warnings:99  exes:560  objs:2760  libs:76
    294     Status: configure:0 build:0
    295   . Cleaning: build/arm/altcycv_devkit_smp/posix
    296   ^ Time 0:03:39.966778
    297   . Configuring: posix-debug
    298   . Building: posix-debug
    299   + Pass: posix-debug: warnings:99  exes:560  objs:2760  libs:76
    300     Status: configure:0 build:0
    301   . Cleaning: build/arm/altcycv_devkit_smp/posix-debug
    302   ^ Time 0:03:39.871038
    303   . Configuring: posix-profiling
    304   . Building: posix-profiling
    305   + Pass: posix-profiling: warnings:99  exes:560  objs:2760  libs:76
    306     Status: configure:0 build:0
    307   . Cleaning: build/arm/altcycv_devkit_smp/posix-profiling
    308   ^ Time 0:03:39.626562
    309   . Configuring: posix-smp
    310   . Building: posix-smp
    311   + Pass: posix-smp: warnings:99  exes:560  objs:2760  libs:76
    312     Status: configure:0 build:0
    313   . Cleaning: build/arm/altcycv_devkit_smp/posix-smp
    314   ^ Time 0:04:00.433920
    315   . Configuring: profiling
    316   . Building: profiling
    317   + Pass: profiling: warnings:99  exes:560  objs:2760  libs:76
    318     Status: configure:0 build:0
    319   . Cleaning: build/arm/altcycv_devkit_smp/profiling
    320   ^ Time 0:04:07.316248
    321   . Configuring: smp
    322   . Building: smp
    323   + Pass: smp: warnings:99  exes:560  objs:2760  libs:76
    324     Status: configure:0 build:0
    325   . Cleaning: build/arm/altcycv_devkit_smp/smp
    326   ^ Time 0:04:02.147503
    327   . Configuring: smp-debug
    328   . Building: smp-debug
    329   + Pass: smp-debug: warnings:99  exes:560  objs:2760  libs:76
    330     Status: configure:0 build:0
    331   . Cleaning: build/arm/altcycv_devkit_smp/smp-debug
    332   ^ Time 0:03:46.626848
    333   ^ BSP Time 0:34:20.797975
    334   ] BSP: arm/xilinx_zynq_zc702
    335   . Creating: build/arm/xilinx_zynq_zc702
    336   . Configuring: debug
    337   . Building: debug
    338   + Pass: debug: warnings:99  exes:560  objs:2749  libs:76
    339     Status: configure:0 build:0
    340   . Cleaning: build/arm/xilinx_zynq_zc702/debug
    341   ^ Time 0:04:48.221615
    342   . Configuring: no-posix
    343   . Building: no-posix
    344   + Pass: no-posix: warnings:99  exes:560  objs:2749  libs:76
    345     Status: configure:0 build:0
    346   . Cleaning: build/arm/xilinx_zynq_zc702/no-posix
    347   ^ Time 0:03:38.480575
    348   . Configuring: posix
    349   . Building: posix
    350   + Pass: posix: warnings:99  exes:560  objs:2749  libs:76
    351     Status: configure:0 build:0
    352   . Cleaning: build/arm/xilinx_zynq_zc702/posix
    353   ^ Time 0:03:39.993491
    354   . Configuring: posix-debug
    355   . Building: posix-debug
    356   + Pass: posix-debug: warnings:99  exes:560  objs:2749  libs:76
    357     Status: configure:0 build:0
    358   . Cleaning: build/arm/xilinx_zynq_zc702/posix-debug
    359   ^ Time 0:03:42.712069
    360   . Configuring: posix-profiling
    361   . Building: posix-profiling
    362   + Pass: posix-profiling: warnings:99  exes:560  objs:2749  libs:76
    363     Status: configure:0 build:0
    364   . Cleaning: build/arm/xilinx_zynq_zc702/posix-profiling
    365   ^ Time 0:03:40.859795
    366   . Configuring: posix-smp
    367   . Building: posix-smp
    368   + Pass: posix-smp: warnings:99  exes:560  objs:2749  libs:76
    369     Status: configure:0 build:0
    370   . Cleaning: build/arm/xilinx_zynq_zc702/posix-smp
    371   ^ Time 0:03:37.047568
    372   . Configuring: profiling
    373   . Building: profiling
    374   + Pass: profiling: warnings:99  exes:560  objs:2749  libs:76
    375     Status: configure:0 build:0
    376   . Cleaning: build/arm/xilinx_zynq_zc702/profiling
    377   ^ Time 0:03:37.822230
    378   . Configuring: smp
    379   . Building: smp
    380   + Pass: smp: warnings:99  exes:560  objs:2749  libs:76
    381     Status: configure:0 build:0
    382   . Cleaning: build/arm/xilinx_zynq_zc702/smp
    383   ^ Time 0:03:36.921624
    384   . Configuring: smp-debug
    385   . Building: smp-debug
    386   + Pass: smp-debug: warnings:99  exes:560  objs:2749  libs:76
    387     Status: configure:0 build:0
    388   . Cleaning: build/arm/xilinx_zynq_zc702/smp-debug
    389   ^ Time 0:03:37.072002
    390   ^ BSP Time 0:34:03.305717
    391   ] BSP: arm/xilinx_zynq_zc706
    392   . Creating: build/arm/xilinx_zynq_zc706
    393   . Configuring: debug
    394   . Building: debug
    395   + Pass: debug: warnings:99  exes:560  objs:2749  libs:76
    396     Status: configure:0 build:0
    397   . Cleaning: build/arm/xilinx_zynq_zc706/debug
    398   ^ Time 0:03:41.005831
    399   . Configuring: no-posix
    400   . Building: no-posix
    401   + Pass: no-posix: warnings:99  exes:560  objs:2749  libs:76
    402     Status: configure:0 build:0
    403   . Cleaning: build/arm/xilinx_zynq_zc706/no-posix
    404   ^ Time 0:03:36.625042
    405   . Configuring: posix
    406   . Building: posix
    407   + Pass: posix: warnings:99  exes:560  objs:2749  libs:76
    408     Status: configure:0 build:0
    409   . Cleaning: build/arm/xilinx_zynq_zc706/posix
    410   ^ Time 0:03:36.811815
    411   . Configuring: posix-debug
    412   . Building: posix-debug
    413   + Pass: posix-debug: warnings:99  exes:560  objs:2749  libs:76
    414     Status: configure:0 build:0
    415   . Cleaning: build/arm/xilinx_zynq_zc706/posix-debug
    416   ^ Time 0:03:36.997970
    417   . Configuring: posix-profiling
    418   . Building: posix-profiling
    419   + Pass: posix-profiling: warnings:99  exes:560  objs:2749  libs:76
    420     Status: configure:0 build:0
    421   . Cleaning: build/arm/xilinx_zynq_zc706/posix-profiling
    422   ^ Time 0:03:37.051871
    423   . Configuring: posix-smp
    424   . Building: posix-smp
    425   + Pass: posix-smp: warnings:99  exes:560  objs:2749  libs:76
    426     Status: configure:0 build:0
    427   . Cleaning: build/arm/xilinx_zynq_zc706/posix-smp
    428   ^ Time 0:03:37.525090
    429   . Configuring: profiling
    430   . Building: profiling
    431   + Pass: profiling: warnings:99  exes:560  objs:2749  libs:76
    432     Status: configure:0 build:0
    433   . Cleaning: build/arm/xilinx_zynq_zc706/profiling
    434   ^ Time 0:03:37.398436
    435   . Configuring: smp
    436   . Building: smp
    437   + Pass: smp: warnings:99  exes:560  objs:2749  libs:76
    438     Status: configure:0 build:0
    439   . Cleaning: build/arm/xilinx_zynq_zc706/smp
    440   ^ Time 0:03:36.341299
    441   . Configuring: smp-debug
    442   . Building: smp-debug
    443   + Pass: smp-debug: warnings:99  exes:560  objs:2749  libs:76
    444     Status: configure:0 build:0
    445   . Cleaning: build/arm/xilinx_zynq_zc706/smp-debug
    446   ^ Time 0:03:37.991431
    447   ^ BSP Time 0:32:41.878632
    448   ] BSP: arm/xilinx_zynq_zedboard
    449   . Creating: build/arm/xilinx_zynq_zedboard
    450   . Configuring: debug
    451   . Building: debug
    452   + Pass: debug: warnings:99  exes:560  objs:2749  libs:76
    453     Status: configure:0 build:0
    454   . Cleaning: build/arm/xilinx_zynq_zedboard/debug
    455   ^ Time 0:03:36.807900
    456   . Configuring: no-posix
    457   . Building: no-posix
    458   + Pass: no-posix: warnings:99  exes:560  objs:2749  libs:76
    459     Status: configure:0 build:0
    460   . Cleaning: build/arm/xilinx_zynq_zedboard/no-posix
    461   ^ Time 0:03:37.808461
    462   . Configuring: posix
    463   . Building: posix
    464   + Pass: posix: warnings:99  exes:560  objs:2749  libs:76
    465     Status: configure:0 build:0
    466   . Cleaning: build/arm/xilinx_zynq_zedboard/posix
    467   ^ Time 0:03:36.583274
    468   . Configuring: posix-debug
    469   . Building: posix-debug
    470   + Pass: posix-debug: warnings:99  exes:560  objs:2749  libs:76
    471     Status: configure:0 build:0
    472   . Cleaning: build/arm/xilinx_zynq_zedboard/posix-debug
    473   ^ Time 0:03:37.305808
    474   . Configuring: posix-profiling
    475   . Building: posix-profiling
    476   + Pass: posix-profiling: warnings:99  exes:560  objs:2749  libs:76
    477     Status: configure:0 build:0
    478   . Cleaning: build/arm/xilinx_zynq_zedboard/posix-profiling
    479   ^ Time 0:03:38.172598
    480   . Configuring: posix-smp
    481   . Building: posix-smp
    482   + Pass: posix-smp: warnings:99  exes:560  objs:2749  libs:76
    483     Status: configure:0 build:0
    484   . Cleaning: build/arm/xilinx_zynq_zedboard/posix-smp
    485   ^ Time 0:03:36.840879
    486   . Configuring: profiling
    487   . Building: profiling
    488   + Pass: profiling: warnings:99  exes:560  objs:2749  libs:76
    489     Status: configure:0 build:0
    490   . Cleaning: build/arm/xilinx_zynq_zedboard/profiling
    491   ^ Time 0:03:37.557138
    492   . Configuring: smp
    493   . Building: smp
    494   + Pass: smp: warnings:99  exes:560  objs:2749  libs:76
    495     Status: configure:0 build:0
    496   . Cleaning: build/arm/xilinx_zynq_zedboard/smp
    497   ^ Time 0:03:37.215842
    498   . Configuring: smp-debug
    499   . Building: smp-debug
    500   + Pass: smp-debug: warnings:99  exes:560  objs:2749  libs:76
    501     Status: configure:0 build:0
    502   . Cleaning: build/arm/xilinx_zynq_zedboard/smp-debug
    503   ^ Time 0:03:36.580128
    504   ^ BSP Time 0:32:38.996825
    505   ] BSP: i386/pc686
    506   . Creating: build/i386/pc686
    507   . Configuring: debug
    508   . Building: debug
    509   + Pass: debug: warnings:118  exes:560  objs:2770  libs:76
    510     Status: configure:0 build:0
    511   . Cleaning: build/i386/pc686/debug
    512   ^ Time 0:03:30.095820
    513   . Configuring: no-posix
    514   . Building: no-posix
    515   + Pass: no-posix: warnings:118  exes:560  objs:2770  libs:76
    516     Status: configure:0 build:0
    517   . Cleaning: build/i386/pc686/no-posix
    518   ^ Time 0:03:29.235921
    519   . Configuring: posix
    520   . Building: posix
    521   + Pass: posix: warnings:118  exes:560  objs:2770  libs:76
    522     Status: configure:0 build:0
    523   . Cleaning: build/i386/pc686/posix
    524   ^ Time 0:03:30.413376
    525   . Configuring: posix-debug
    526   . Building: posix-debug
    527   + Pass: posix-debug: warnings:118  exes:560  objs:2770  libs:76
    528     Status: configure:0 build:0
    529   . Cleaning: build/i386/pc686/posix-debug
    530   ^ Time 0:03:29.512518
    531   . Configuring: posix-profiling
    532   . Building: posix-profiling
    533   + Pass: posix-profiling: warnings:118  exes:560  objs:2770  libs:76
    534     Status: configure:0 build:0
    535   + Pass: posix-profiling: warnings:118  exes:560  objs:2770  libs:76
    536     Status: configure:0 build:0
    537   . Cleaning: build/i386/pc686/posix-profiling
    538   ^ Time 0:03:30.870472
    539   . Configuring: profiling
    540   . Building: profiling
    541   + Pass: profiling: warnings:118  exes:560  objs:2770  libs:76
    542     Status: configure:0 build:0
    543   . Cleaning: build/i386/pc686/profiling
    544   ^ Time 0:03:30.768413
    545   ^ BSP Time 0:21:03.174394
    546   ] BSP: sparc/erc32
    547   . Creating: build/sparc/erc32
    548   . Configuring: debug
    549   . Building: debug
    550   + Pass: debug: warnings:96  exes:559  objs:2769  libs:77
    551     Status: configure:0 build:0
    552   . Cleaning: build/sparc/erc32/debug
    553   ^ Time 0:03:10.233967
    554   . Configuring: no-posix
    555   . Building: no-posix
    556   + Pass: no-posix: warnings:96  exes:559  objs:2769  libs:77
    557     Status: configure:0 build:0
    558   . Cleaning: build/sparc/erc32/no-posix
    559   ^ Time 0:03:11.151673
    560   . Configuring: posix
    561   . Building: posix
    562   + Pass: posix: warnings:96  exes:559  objs:2769  libs:77
    563     Status: configure:0 build:0
    564   . Cleaning: build/sparc/erc32/posix
    565   ^ Time 0:03:10.069584
    566   . Configuring: posix-debug
    567   . Building: posix-debug
    568   + Pass: posix-debug: warnings:96  exes:559  objs:2769  libs:77
    569     Status: configure:0 build:0
    570   . Cleaning: build/sparc/erc32/posix-debug
    571   ^ Time 0:03:10.661856
    572   . Configuring: posix-profiling
    573   . Building: posix-profiling
    574   + Pass: posix-profiling: warnings:96  exes:559  objs:2769  libs:77
    575     Status: configure:0 build:0
    576   . Cleaning: build/sparc/erc32/posix-profiling
    577   ^ Time 0:03:11.079471
    578   . Configuring: profiling
    579   . Building: profiling
    580   + Pass: profiling: warnings:96  exes:559  objs:2769  libs:77
    581     Status: configure:0 build:0
    582   . Cleaning: build/sparc/erc32/profiling
    583   ^ Time 0:03:10.630353
    584   ^ BSP Time 0:19:06.556621
    585   ^ Profile Time 3:27:04.111801
    586     warnings:5739  exes:559  objs:2769  libs:77
    587   * Passes: 57   Failures: 0
     353            --profiles=tier-1 \
     354            --jobs=5/10
     355  RTEMS Tools Project - RTEMS Kernel BSP Builder, 4.12 (61ddcfc8f057)
     356  Profile(s): tier-1
     357  Cleaning: bsp-builds
     358  [  1/655] arm/altcycv_devkit (debug)                         Start
     359  [  1/655] arm/altcycv_devkit (debug)                         Creating: bsp-builds/arm/altcycv_devkit.debug
     360  [  2/655] arm/altcycv_devkit (no-posix)                      Start
     361  [  2/655] arm/altcycv_devkit (no-posix)                      Creating: bsp-builds/arm/altcycv_devkit.no-posix
     362  [  3/655] arm/altcycv_devkit (posix)                         Start
     363  [  1/655] arm/altcycv_devkit (debug)                         Configuring
     364  [  3/655] arm/altcycv_devkit (posix)                         Creating: bsp-builds/arm/altcycv_devkit.posix
     365  [  2/655] arm/altcycv_devkit (no-posix)                      Configuring
     366  [  4/655] arm/altcycv_devkit (posix-debug)                   Start
     367  [  1/655] arm/altcycv_devkit (debug)                         Building
     368  [  3/655] arm/altcycv_devkit (posix)                         Configuring
     369  [  4/655] arm/altcycv_devkit (posix-debug)                   Creating: bsp-builds/arm/altcycv_devkit.posix-debug
     370  [  2/655] arm/altcycv_devkit (no-posix)                      Building
     371  [  5/655] arm/altcycv_devkit (posix-profiling)               Start
     372  [  4/655] arm/altcycv_devkit (posix-debug)                   Configuring
     373  [  3/655] arm/altcycv_devkit (posix)                         Building
     374   ....
     375  [654/655] sparc/ngmp (posix-profiling)                       PASS
     376  [654/655] sparc/ngmp (posix-profiling)                       Warnings:0  exes:0  objs:0  libs:0
     377  [654/655] sparc/ngmp (posix-profiling)                       Finished (duration:0:01:49.002189)
     378  [654/655] sparc/ngmp (posix-profiling)                       Status: Pass:  655  Fail:    0 (configure:0 build:0)
     379  [655/655] sparc/ngmp (profiling)                             PASS
     380  [655/655] sparc/ngmp (profiling)                             Warnings:0  exes:0  objs:0  libs:0
     381  [655/655] sparc/ngmp (profiling)                             Finished (duration:0:01:260.002098)
     382  [655/655] sparc/ngmp (profiling)                             Status: Pass:  655  Fail:    0 (configure:0 build:0)
     383  [651/655] sparc/ngmp (no-posix)                              Cleaning: bsp-builds/sparc/ngmp.no-posix
     384  [652/655] sparc/ngmp (posix)                                 Cleaning: bsp-builds/sparc/ngmp.posix
     385  [653/655] sparc/ngmp (posix-debug)                           Cleaning: bsp-builds/sparc/ngmp.posix-debug
     386  [654/655] sparc/ngmp (posix-profiling)                       Cleaning: bsp-builds/sparc/ngmp.posix-profiling
     387  [655/655] sparc/ngmp (profiling)                             Cleaning: bsp-builds/sparc/ngmp.profiling
     388  Total: Warnings:31689  exes:6291  objs:793839  libs:37897
     389  Failures:
     390   No failure(s)
     391  Average BSP Build Time: 0:00:18.165000
     392  Total Time 3:41:48.075006
     393  Passes: 655   Failures: 0
     394
     395To build a couple of BSPs you are interested in with tests:
     396
     397.. code-block:: shell
     398
     399  $ /opt/rtems/4.12/bin/rtems-bsp-builder --build-path=/build/rtems \
     400            --rtems-tools=/opt/work/rtems/4.12 \
     401            --rtems=/opt/work/chris/rtems/kernel/rtems.git \
     402            ----log=lpc-log \
     403            --bsp=arm/lpc2362,arm/lpc23xx_tli800 \
     404            --build=tests \
     405            --jobs=5/12
     406  RTEMS Tools Project - RTEMS Kernel BSP Builder, 4.12 (61ddcfc8f057 modified)
     407  BSPS(s): arm/lpc2362, arm/lpc23xx_tli800
     408  Cleaning: bsp-builds
     409  [1/2] arm/lpc2362 (tests)        Start
     410  [1/2] arm/lpc2362 (tests)        Creating: bsp-builds/arm/lpc2362.tests
     411  [2/2] arm/lpc23xx_tli800 (tests) Start
     412  [2/2] arm/lpc23xx_tli800 (tests) Creating: bsp-builds/arm/lpc23xx_tli800.tests
     413  [1/2] arm/lpc2362 (tests)        Configuring
     414  [2/2] arm/lpc23xx_tli800 (tests) Configuring
     415  [1/2] arm/lpc2362 (tests)        Building
     416  [2/2] arm/lpc23xx_tli800 (tests) Building
     417  [1/2] arm/lpc2362 (tests)        FAIL
     418  [1/2] arm/lpc2362 (tests)        Warnings:74  exes:58  objs:1645  libs:74
     419  [1/2] arm/lpc2362 (tests)        Finished (duration:0:01:31.708252)
     420  [1/2] arm/lpc2362 (tests)        Status: Pass:    0  Fail:    2 (configure:0 build:2)
     421  [2/2] arm/lpc23xx_tli800 (tests) FAIL
     422  [2/2] arm/lpc23xx_tli800 (tests) Warnings:74  exes:51  objs:1632  libs:74
     423  [2/2] arm/lpc23xx_tli800 (tests) Finished (duration:0:01:31.747582)
     424  [2/2] arm/lpc23xx_tli800 (tests) Status: Pass:    0  Fail:    2 (configure:0 build:2)
     425  [1/2] arm/lpc2362 (tests)        Cleaning: bsp-builds/arm/lpc2362.tests
     426  [2/2] arm/lpc23xx_tli800 (tests) Cleaning: bsp-builds/arm/lpc23xx_tli800.tests
     427  Total: Warnings:74  exes:109  objs:3277  libs:148
     428  Failures:
     429     1 tests arm/lpc2362 build:
     430        configure: /opt/work/chris/rtems/kernel/rtems.git/configure --target\
     431        =arm-rtems4.12 --enable-rtemsbsp=lpc2362 --prefix=/opt/rtems/4.12\
     432        --enable-tests
     433       error: ld/collect2:0 error: math.exe section '.rodata' will not fit
     434              in region 'ROM_INT'; region 'ROM_INT' overflowed by 7284 bytes
     435
     436     2 tests arm/lpc23xx_tli800 build:
     437        configure: /opt/work/chris/rtems/kernel/rtems.git/configure --target\
     438        =arm-rtems4.12 --enable-rtemsbsp=lpc23xx_tli800\
     439        --prefix=/opt/rtems/4.12 --enable-tests
     440       error: ld/collect2:0 error: math.exe section '.text' will not fit in
     441              region 'ROM_INT'; region 'ROM_INT' overflowed by 13972 bytes
     442
     443  Average BSP Build Time: 0:00:46.658257
     444  Total Time 0:01:33.316514
     445  Passes: 0   Failures: 2
     446
     447The summary report printed shows both BSP builds failed with the error detail
     448shown. In this case both are linker related errors where the test do not fit
     449into the target's available resources.
Note: See TracChangeset for help on using the changeset viewer.