summaryrefslogtreecommitdiffstats
path: root/user/tools
diff options
context:
space:
mode:
authorChris Johns <chrisj@rtems.org>2017-03-21 10:32:18 +1100
committerChris Johns <chrisj@rtems.org>2017-03-21 10:32:18 +1100
commite82055bfd5ed008c05e2deba19fddecfaa03f939 (patch)
tree5eece4d2e3ec2b5b3f96d0a54d9d1037747a3f4e /user/tools
parentconf: Update the copyright year. (diff)
downloadrtems-docs-e82055bfd5ed008c05e2deba19fddecfaa03f939.tar.bz2
user: Add an example of the rtems-bsp-builder running.
Diffstat (limited to 'user/tools')
-rw-r--r--user/tools/bsp-builder.rst391
1 files changed, 389 insertions, 2 deletions
diff --git a/user/tools/bsp-builder.rst b/user/tools/bsp-builder.rst
index f27cb68..0b0f18c 100644
--- a/user/tools/bsp-builder.rst
+++ b/user/tools/bsp-builder.rst
@@ -147,12 +147,13 @@ Command
.. option:: --prefix
- Prefix to pass to configure then building a BSP.
+ Prefix to pass to configure when building a BSP.
.. option:: --rtems-tools
The path the RTEMS tools such as the C compiler. This option avoid polluting
- your path.
+ your path. This path is to the tool's prefix used to build and install the
+ tools and not exact path to an executable.
.. option:: --rtems
@@ -198,3 +199,389 @@ Command
.. option:: --dry-run
Do not do the actual builds just show what would be built.
+
+Examples
+^^^^^^^^
+
+The following is a *tier-1* profile build of *all* on a machine where all the
+source and tools are located on fast SSD disks and the build happens an a
+spinning disk mounted under `build`. The build uses a development source tree
+that is configured and ready to build. The source can have local patches that
+need to be regression tested:
+
+.. code-block:: shell
+
+ $ /opt/rtems/4.12/bin/rtems-bsp-builder --build-path=/build/rtems \
+ --rtems-tools=/opt/work/rtems/4.12 \
+ --rtems=/opt/work/chris/rtems/kernel/rtems.git \
+ --profiles=tier-1
+ RTEMS Tools Project - RTEMS Kernel BSP Builder, 4.12 (31e22e337cf3 modified)
+ ]] Profile: tier-1
+ ] BSP: arm/altcycv_devkit
+ . Creating: build/arm/altcycv_devkit
+ . Configuring: debug
+ . Building: debug
+ + Pass: debug: warnings:99 exes:560 objs:2760 libs:76
+ Status: configure:0 build:0
+ . Cleaning: build/arm/altcycv_devkit/debug
+ ^ Time 0:03:45.450099
+ . Configuring: no-posix
+ . Building: no-posix
+ + Pass: no-posix: warnings:99 exes:560 objs:2760 libs:76
+ Status: configure:0 build:0
+ . Cleaning: build/arm/altcycv_devkit/no-posix
+ ^ Time 0:03:39.598817
+ . Configuring: posix
+ . Building: posix
+ + Pass: posix: warnings:99 exes:560 objs:2760 libs:76
+ Status: configure:0 build:0
+ . Cleaning: build/arm/altcycv_devkit/posix
+ ^ Time 0:03:40.242016
+ . Configuring: posix-debug
+ . Building: posix-debug
+ + Pass: posix-debug: warnings:99 exes:560 objs:2760 libs:76
+ Status: configure:0 build:0
+ . Cleaning: build/arm/altcycv_devkit/posix-debug
+ ^ Time 0:03:40.325694
+ . Configuring: posix-profiling
+ . Building: posix-profiling
+ + Pass: posix-profiling: warnings:99 exes:560 objs:2760 libs:76
+ Status: configure:0 build:0
+ . Cleaning: build/arm/altcycv_devkit/posix-profiling
+ ^ Time 0:03:39.999044
+ . Configuring: posix-smp
+ . Building: posix-smp
+ + Pass: posix-smp: warnings:99 exes:560 objs:2760 libs:76
+ Status: configure:0 build:0
+ . Cleaning: build/arm/altcycv_devkit/posix-smp
+ ^ Time 0:03:39.462674
+ . Configuring: profiling
+ . Building: profiling
+ + Pass: profiling: warnings:99 exes:560 objs:2760 libs:76
+ Status: configure:0 build:0
+ . Cleaning: build/arm/altcycv_devkit/profiling
+ ^ Time 0:03:39.860434
+ . Configuring: smp
+ . Building: smp
+ + Pass: smp: warnings:99 exes:560 objs:2760 libs:76
+ Status: configure:0 build:0
+ . Cleaning: build/arm/altcycv_devkit/smp
+ ^ Time 0:03:39.928132
+ . Configuring: smp-debug
+ . Building: smp-debug
+ + Pass: smp-debug: warnings:99 exes:560 objs:2760 libs:76
+ Status: configure:0 build:0
+ . Cleaning: build/arm/altcycv_devkit/smp-debug
+ ^ Time 0:03:40.414716
+ ^ BSP Time 0:33:09.399355
+ ] BSP: arm/altcycv_devkit_smp
+ . Creating: build/arm/altcycv_devkit_smp
+ . Configuring: debug
+ . Building: debug
+ + Pass: debug: warnings:99 exes:560 objs:2760 libs:76
+ Status: configure:0 build:0
+ . Cleaning: build/arm/altcycv_devkit_smp/debug
+ ^ Time 0:03:39.891703
+ . Configuring: no-posix
+ . Building: no-posix
+ + Pass: no-posix: warnings:99 exes:560 objs:2760 libs:76
+ Status: configure:0 build:0
+ . Cleaning: build/arm/altcycv_devkit_smp/no-posix
+ ^ Time 0:03:40.730781
+ . Configuring: posix
+ . Building: posix
+ + Pass: posix: warnings:99 exes:560 objs:2760 libs:76
+ Status: configure:0 build:0
+ . Cleaning: build/arm/altcycv_devkit_smp/posix
+ ^ Time 0:03:39.966778
+ . Configuring: posix-debug
+ . Building: posix-debug
+ + Pass: posix-debug: warnings:99 exes:560 objs:2760 libs:76
+ Status: configure:0 build:0
+ . Cleaning: build/arm/altcycv_devkit_smp/posix-debug
+ ^ Time 0:03:39.871038
+ . Configuring: posix-profiling
+ . Building: posix-profiling
+ + Pass: posix-profiling: warnings:99 exes:560 objs:2760 libs:76
+ Status: configure:0 build:0
+ . Cleaning: build/arm/altcycv_devkit_smp/posix-profiling
+ ^ Time 0:03:39.626562
+ . Configuring: posix-smp
+ . Building: posix-smp
+ + Pass: posix-smp: warnings:99 exes:560 objs:2760 libs:76
+ Status: configure:0 build:0
+ . Cleaning: build/arm/altcycv_devkit_smp/posix-smp
+ ^ Time 0:04:00.433920
+ . Configuring: profiling
+ . Building: profiling
+ + Pass: profiling: warnings:99 exes:560 objs:2760 libs:76
+ Status: configure:0 build:0
+ . Cleaning: build/arm/altcycv_devkit_smp/profiling
+ ^ Time 0:04:07.316248
+ . Configuring: smp
+ . Building: smp
+ + Pass: smp: warnings:99 exes:560 objs:2760 libs:76
+ Status: configure:0 build:0
+ . Cleaning: build/arm/altcycv_devkit_smp/smp
+ ^ Time 0:04:02.147503
+ . Configuring: smp-debug
+ . Building: smp-debug
+ + Pass: smp-debug: warnings:99 exes:560 objs:2760 libs:76
+ Status: configure:0 build:0
+ . Cleaning: build/arm/altcycv_devkit_smp/smp-debug
+ ^ Time 0:03:46.626848
+ ^ BSP Time 0:34:20.797975
+ ] BSP: arm/xilinx_zynq_zc702
+ . Creating: build/arm/xilinx_zynq_zc702
+ . Configuring: debug
+ . Building: debug
+ + Pass: debug: warnings:99 exes:560 objs:2749 libs:76
+ Status: configure:0 build:0
+ . Cleaning: build/arm/xilinx_zynq_zc702/debug
+ ^ Time 0:04:48.221615
+ . Configuring: no-posix
+ . Building: no-posix
+ + Pass: no-posix: warnings:99 exes:560 objs:2749 libs:76
+ Status: configure:0 build:0
+ . Cleaning: build/arm/xilinx_zynq_zc702/no-posix
+ ^ Time 0:03:38.480575
+ . Configuring: posix
+ . Building: posix
+ + Pass: posix: warnings:99 exes:560 objs:2749 libs:76
+ Status: configure:0 build:0
+ . Cleaning: build/arm/xilinx_zynq_zc702/posix
+ ^ Time 0:03:39.993491
+ . Configuring: posix-debug
+ . Building: posix-debug
+ + Pass: posix-debug: warnings:99 exes:560 objs:2749 libs:76
+ Status: configure:0 build:0
+ . Cleaning: build/arm/xilinx_zynq_zc702/posix-debug
+ ^ Time 0:03:42.712069
+ . Configuring: posix-profiling
+ . Building: posix-profiling
+ + Pass: posix-profiling: warnings:99 exes:560 objs:2749 libs:76
+ Status: configure:0 build:0
+ . Cleaning: build/arm/xilinx_zynq_zc702/posix-profiling
+ ^ Time 0:03:40.859795
+ . Configuring: posix-smp
+ . Building: posix-smp
+ + Pass: posix-smp: warnings:99 exes:560 objs:2749 libs:76
+ Status: configure:0 build:0
+ . Cleaning: build/arm/xilinx_zynq_zc702/posix-smp
+ ^ Time 0:03:37.047568
+ . Configuring: profiling
+ . Building: profiling
+ + Pass: profiling: warnings:99 exes:560 objs:2749 libs:76
+ Status: configure:0 build:0
+ . Cleaning: build/arm/xilinx_zynq_zc702/profiling
+ ^ Time 0:03:37.822230
+ . Configuring: smp
+ . Building: smp
+ + Pass: smp: warnings:99 exes:560 objs:2749 libs:76
+ Status: configure:0 build:0
+ . Cleaning: build/arm/xilinx_zynq_zc702/smp
+ ^ Time 0:03:36.921624
+ . Configuring: smp-debug
+ . Building: smp-debug
+ + Pass: smp-debug: warnings:99 exes:560 objs:2749 libs:76
+ Status: configure:0 build:0
+ . Cleaning: build/arm/xilinx_zynq_zc702/smp-debug
+ ^ Time 0:03:37.072002
+ ^ BSP Time 0:34:03.305717
+ ] BSP: arm/xilinx_zynq_zc706
+ . Creating: build/arm/xilinx_zynq_zc706
+ . Configuring: debug
+ . Building: debug
+ + Pass: debug: warnings:99 exes:560 objs:2749 libs:76
+ Status: configure:0 build:0
+ . Cleaning: build/arm/xilinx_zynq_zc706/debug
+ ^ Time 0:03:41.005831
+ . Configuring: no-posix
+ . Building: no-posix
+ + Pass: no-posix: warnings:99 exes:560 objs:2749 libs:76
+ Status: configure:0 build:0
+ . Cleaning: build/arm/xilinx_zynq_zc706/no-posix
+ ^ Time 0:03:36.625042
+ . Configuring: posix
+ . Building: posix
+ + Pass: posix: warnings:99 exes:560 objs:2749 libs:76
+ Status: configure:0 build:0
+ . Cleaning: build/arm/xilinx_zynq_zc706/posix
+ ^ Time 0:03:36.811815
+ . Configuring: posix-debug
+ . Building: posix-debug
+ + Pass: posix-debug: warnings:99 exes:560 objs:2749 libs:76
+ Status: configure:0 build:0
+ . Cleaning: build/arm/xilinx_zynq_zc706/posix-debug
+ ^ Time 0:03:36.997970
+ . Configuring: posix-profiling
+ . Building: posix-profiling
+ + Pass: posix-profiling: warnings:99 exes:560 objs:2749 libs:76
+ Status: configure:0 build:0
+ . Cleaning: build/arm/xilinx_zynq_zc706/posix-profiling
+ ^ Time 0:03:37.051871
+ . Configuring: posix-smp
+ . Building: posix-smp
+ + Pass: posix-smp: warnings:99 exes:560 objs:2749 libs:76
+ Status: configure:0 build:0
+ . Cleaning: build/arm/xilinx_zynq_zc706/posix-smp
+ ^ Time 0:03:37.525090
+ . Configuring: profiling
+ . Building: profiling
+ + Pass: profiling: warnings:99 exes:560 objs:2749 libs:76
+ Status: configure:0 build:0
+ . Cleaning: build/arm/xilinx_zynq_zc706/profiling
+ ^ Time 0:03:37.398436
+ . Configuring: smp
+ . Building: smp
+ + Pass: smp: warnings:99 exes:560 objs:2749 libs:76
+ Status: configure:0 build:0
+ . Cleaning: build/arm/xilinx_zynq_zc706/smp
+ ^ Time 0:03:36.341299
+ . Configuring: smp-debug
+ . Building: smp-debug
+ + Pass: smp-debug: warnings:99 exes:560 objs:2749 libs:76
+ Status: configure:0 build:0
+ . Cleaning: build/arm/xilinx_zynq_zc706/smp-debug
+ ^ Time 0:03:37.991431
+ ^ BSP Time 0:32:41.878632
+ ] BSP: arm/xilinx_zynq_zedboard
+ . Creating: build/arm/xilinx_zynq_zedboard
+ . Configuring: debug
+ . Building: debug
+ + Pass: debug: warnings:99 exes:560 objs:2749 libs:76
+ Status: configure:0 build:0
+ . Cleaning: build/arm/xilinx_zynq_zedboard/debug
+ ^ Time 0:03:36.807900
+ . Configuring: no-posix
+ . Building: no-posix
+ + Pass: no-posix: warnings:99 exes:560 objs:2749 libs:76
+ Status: configure:0 build:0
+ . Cleaning: build/arm/xilinx_zynq_zedboard/no-posix
+ ^ Time 0:03:37.808461
+ . Configuring: posix
+ . Building: posix
+ + Pass: posix: warnings:99 exes:560 objs:2749 libs:76
+ Status: configure:0 build:0
+ . Cleaning: build/arm/xilinx_zynq_zedboard/posix
+ ^ Time 0:03:36.583274
+ . Configuring: posix-debug
+ . Building: posix-debug
+ + Pass: posix-debug: warnings:99 exes:560 objs:2749 libs:76
+ Status: configure:0 build:0
+ . Cleaning: build/arm/xilinx_zynq_zedboard/posix-debug
+ ^ Time 0:03:37.305808
+ . Configuring: posix-profiling
+ . Building: posix-profiling
+ + Pass: posix-profiling: warnings:99 exes:560 objs:2749 libs:76
+ Status: configure:0 build:0
+ . Cleaning: build/arm/xilinx_zynq_zedboard/posix-profiling
+ ^ Time 0:03:38.172598
+ . Configuring: posix-smp
+ . Building: posix-smp
+ + Pass: posix-smp: warnings:99 exes:560 objs:2749 libs:76
+ Status: configure:0 build:0
+ . Cleaning: build/arm/xilinx_zynq_zedboard/posix-smp
+ ^ Time 0:03:36.840879
+ . Configuring: profiling
+ . Building: profiling
+ + Pass: profiling: warnings:99 exes:560 objs:2749 libs:76
+ Status: configure:0 build:0
+ . Cleaning: build/arm/xilinx_zynq_zedboard/profiling
+ ^ Time 0:03:37.557138
+ . Configuring: smp
+ . Building: smp
+ + Pass: smp: warnings:99 exes:560 objs:2749 libs:76
+ Status: configure:0 build:0
+ . Cleaning: build/arm/xilinx_zynq_zedboard/smp
+ ^ Time 0:03:37.215842
+ . Configuring: smp-debug
+ . Building: smp-debug
+ + Pass: smp-debug: warnings:99 exes:560 objs:2749 libs:76
+ Status: configure:0 build:0
+ . Cleaning: build/arm/xilinx_zynq_zedboard/smp-debug
+ ^ Time 0:03:36.580128
+ ^ BSP Time 0:32:38.996825
+ ] BSP: i386/pc686
+ . Creating: build/i386/pc686
+ . Configuring: debug
+ . Building: debug
+ + Pass: debug: warnings:118 exes:560 objs:2770 libs:76
+ Status: configure:0 build:0
+ . Cleaning: build/i386/pc686/debug
+ ^ Time 0:03:30.095820
+ . Configuring: no-posix
+ . Building: no-posix
+ + Pass: no-posix: warnings:118 exes:560 objs:2770 libs:76
+ Status: configure:0 build:0
+ . Cleaning: build/i386/pc686/no-posix
+ ^ Time 0:03:29.235921
+ . Configuring: posix
+ . Building: posix
+ + Pass: posix: warnings:118 exes:560 objs:2770 libs:76
+ Status: configure:0 build:0
+ . Cleaning: build/i386/pc686/posix
+ ^ Time 0:03:30.413376
+ . Configuring: posix-debug
+ . Building: posix-debug
+ + Pass: posix-debug: warnings:118 exes:560 objs:2770 libs:76
+ Status: configure:0 build:0
+ . Cleaning: build/i386/pc686/posix-debug
+ ^ Time 0:03:29.512518
+ . Configuring: posix-profiling
+ . Building: posix-profiling
+ + Pass: posix-profiling: warnings:118 exes:560 objs:2770 libs:76
+ Status: configure:0 build:0
+ + Pass: posix-profiling: warnings:118 exes:560 objs:2770 libs:76
+ Status: configure:0 build:0
+ . Cleaning: build/i386/pc686/posix-profiling
+ ^ Time 0:03:30.870472
+ . Configuring: profiling
+ . Building: profiling
+ + Pass: profiling: warnings:118 exes:560 objs:2770 libs:76
+ Status: configure:0 build:0
+ . Cleaning: build/i386/pc686/profiling
+ ^ Time 0:03:30.768413
+ ^ BSP Time 0:21:03.174394
+ ] BSP: sparc/erc32
+ . Creating: build/sparc/erc32
+ . Configuring: debug
+ . Building: debug
+ + Pass: debug: warnings:96 exes:559 objs:2769 libs:77
+ Status: configure:0 build:0
+ . Cleaning: build/sparc/erc32/debug
+ ^ Time 0:03:10.233967
+ . Configuring: no-posix
+ . Building: no-posix
+ + Pass: no-posix: warnings:96 exes:559 objs:2769 libs:77
+ Status: configure:0 build:0
+ . Cleaning: build/sparc/erc32/no-posix
+ ^ Time 0:03:11.151673
+ . Configuring: posix
+ . Building: posix
+ + Pass: posix: warnings:96 exes:559 objs:2769 libs:77
+ Status: configure:0 build:0
+ . Cleaning: build/sparc/erc32/posix
+ ^ Time 0:03:10.069584
+ . Configuring: posix-debug
+ . Building: posix-debug
+ + Pass: posix-debug: warnings:96 exes:559 objs:2769 libs:77
+ Status: configure:0 build:0
+ . Cleaning: build/sparc/erc32/posix-debug
+ ^ Time 0:03:10.661856
+ . Configuring: posix-profiling
+ . Building: posix-profiling
+ + Pass: posix-profiling: warnings:96 exes:559 objs:2769 libs:77
+ Status: configure:0 build:0
+ . Cleaning: build/sparc/erc32/posix-profiling
+ ^ Time 0:03:11.079471
+ . Configuring: profiling
+ . Building: profiling
+ + Pass: profiling: warnings:96 exes:559 objs:2769 libs:77
+ Status: configure:0 build:0
+ . Cleaning: build/sparc/erc32/profiling
+ ^ Time 0:03:10.630353
+ ^ BSP Time 0:19:06.556621
+ ^ Profile Time 3:27:04.111801
+ warnings:5739 exes:559 objs:2769 libs:77
+ * Passes: 57 Failures: 0