source: rtems-docs/user/start/bootstrap.rst @ cb4e4e2

Last change on this file since cb4e4e2 was 158d905, checked in by Sebastian Huber <sebastian.huber@…>, on Jan 23, 2019 at 1:21:39 PM

user: Add "Bootstrap the RTEMS Sources"

  • Property mode set to 100644
File size: 2.1 KB
RevLine 
[158d905]1.. SPDX-License-Identifier: CC-BY-SA-4.0
2
3.. Copyright (C) 2019 embedded brains GmbH
4.. Copyright (C) 2019 Sebastian Huber
5
6.. _QuickStartBootstrap:
7
8Bootstrap the RTEMS Sources
9===========================
10
11You installed the tool suite in your installation prefix and cloned two RTEMS
12repositories in the previous sections.  We installed the tool suite in
13:file:`$HOME/quick-start/rtems/5` and cloned the repositories in
14:file:`$HOME/quick-start/src`.
15
16If you use source archives of a released RTEMS version, then you can skip this
17section.
18
19Before you can build a :ref:`Board Support Package (BSP) <BSPs>` for your
20target hardware, you have to bootstrap the build system in the RTEMS sources.
21This is only necessary, if you use a Git repository clone of the RTEMS sources.
22You have to do this after a fresh repository clone and sometimes after build
23system file updates (e.g.  after a ``git pull``).  If you are not a build
24system expert, then do the bootstrap after each update of build system files.
25This is a bit annoying, but improving the build system is a complex and time
26consuming undertaking.  Feel free to help the RTEMS Project to improve it.  For
27the bootstrap it is important that the right version of Autotools
28(:file:`autoconf` and :file:`automake`) are in your ``$PATH``.  The right
29version of Autotools is shipped with the RTEMS tool suite you already
30installed.
31
32.. code-block:: none
33
34    cd $HOME/quick-start/src/rtems
35    export PATH=$HOME/quick-start/rtems/5/bin:"$PATH"
36    ./bootstrap -c
37    $HOME/quick-start/src/rsb/source-builder/sb-bootstrap
38
39These commands should output something like this (omitted lines are denoted by
40...):
41
42.. code-block:: none
43
44    removing automake generated Makefile.in files
45    removing configure files
46    removing aclocal.m4 files
47    $ $HOME/quick-start/src/rsb/source-builder/sb-bootstrap
48    RTEMS Source Builder - RTEMS Bootstrap, 5 (f07504d27192)
49      1/120: autoreconf: configure.ac
50      2/120: autoreconf: c/configure.ac
51      3/120: autoreconf: c/src/configure.ac
52      4/120: autoreconf: c/src/lib/libbsp/arm/configure.ac
53    ...
54    120/120: autoreconf: testsuites/tmtests/configure.ac
55    Bootstrap time: 0:00:48.744222
Note: See TracBrowser for help on using the repository browser.