From f6720264ea8ebfdd3a6b7819650520a2d18e7c31 Mon Sep 17 00:00:00 2001 From: Chris Johns Date: Thu, 12 Mar 2020 15:13:39 +1100 Subject: user: Update Quick Start Guide - Add support for release source archives - Add building the BSP using the RSB - Add building packages using the RSB - Add an application Closes #2998 --- user/start/bootstrap.rst | 72 ++++++++++++++++++++++++++---------------------- 1 file changed, 39 insertions(+), 33 deletions(-) (limited to 'user/start/bootstrap.rst') diff --git a/user/start/bootstrap.rst b/user/start/bootstrap.rst index 9fcf79b..1594f89 100644 --- a/user/start/bootstrap.rst +++ b/user/start/bootstrap.rst @@ -8,48 +8,54 @@ Bootstrap the RTEMS Sources =========================== -You installed the tool suite in your installation prefix and cloned two RTEMS -repositories in the previous sections. We installed the tool suite in -:file:`$HOME/quick-start/rtems/5` and cloned the repositories in -:file:`$HOME/quick-start/src`. +You installed the tool suite in your installation prefix and made ready the +source for two RTEMS source packages in the previous sections. We installed +the tool suite in :file:`$HOME/quick-start/rtems/5` and unpacked the RSB source +in :file:`$HOME/quick-start/src`. -If you use source archives of a released RTEMS version, then you can skip this -section. +You only need to *bootstrap* the RTEMS sources if you have used +:ref:`QuickStartSources_Git` to get the sources. If you use source archives of +a released RTEMS version you can skip this section and move to +:ref:`QuickStartBSPBuild`. Before you can build a :ref:`Board Support Package (BSP) ` for your -target hardware, you have to bootstrap the build system in the RTEMS sources. -This is only necessary, if you use a Git repository clone of the RTEMS sources. -You have to do this after a fresh repository clone and sometimes after build -system file updates (e.g. after a ``git pull``). If you are not a build -system expert, then do the bootstrap after each update of build system files. -This is a bit annoying, but improving the build system is a complex and time -consuming undertaking. Feel free to help the RTEMS Project to improve it. For -the bootstrap it is important that the right version of Autotools -(:file:`autoconf` and :file:`automake`) are in your ``$PATH``. The right -version of Autotools is shipped with the RTEMS tool suite you already -installed. +target hardware from Git cloned RTEMS sources, you have to bootstrap the build +system in the RTEMS sources. This is only necessary if you use a Git +repository clone of the RTEMS sources. You have to do this after a fresh +repository clone and sometimes after build system file updates (e.g. after a +``git pull``). If you are not a build system expert, then do the bootstrap +after each update of build system files. This is a bit annoying, but improving +the build system is a complex and time consuming undertaking. Feel free to +help the RTEMS Project to improve it. For the bootstrap it is important that +the right version of Autotools (:file:`autoconf` and :file:`automake`) are in +your ``$PATH``. The right version of Autotools is shipped with the RTEMS tool +suite you already installed. Set the path to the tool suite installed under +your selected *prefix*: .. code-block:: none - cd $HOME/quick-start/src/rtems export PATH=$HOME/quick-start/rtems/5/bin:"$PATH" - ./bootstrap -c - $HOME/quick-start/src/rsb/source-builder/sb-bootstrap -These commands should output something like this (omitted lines are denoted by -...): +Change into the RTEMS source tree to *bootstrap* the build system: + +.. code-block:: none + + cd $HOME/quick-start/src/rtems + ./rtems-bootstrap + +This command should output something like this (omitted lines are denoted by +``...``): .. code-block:: none - removing automake generated Makefile.in files - removing configure files - removing aclocal.m4 files - $ $HOME/quick-start/src/rsb/source-builder/sb-bootstrap - RTEMS Source Builder - RTEMS Bootstrap, 5 (f07504d27192) - 1/120: autoreconf: configure.ac - 2/120: autoreconf: c/configure.ac - 3/120: autoreconf: c/src/configure.ac - 4/120: autoreconf: c/src/lib/libbsp/arm/configure.ac + RTEMS Bootstrap, 1.0 + 1/122: autoreconf: configure.ac + 2/122: autoreconf: testsuites/configure.ac + 3/122: autoreconf: testsuites/fstests/configure.ac + 4/122: autoreconf: testsuites/smptests/configure.ac + 5/122: autoreconf: testsuites/psxtests/configure.ac + 6/122: autoreconf: testsuites/mptests/configure.ac ... - 120/120: autoreconf: testsuites/tmtests/configure.ac - Bootstrap time: 0:00:48.744222 + 121/122: autoreconf: c/src/lib/libbsp/lm32/milkymist/configure.ac + 122/122: autoreconf: c/src/make/configure.ac + Bootstrap time: 0:00:46.404643 -- cgit v1.2.3