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 | |
---|
8 | Bootstrap the RTEMS Sources |
---|
9 | =========================== |
---|
10 | |
---|
11 | You installed the tool suite in your installation prefix and cloned two RTEMS |
---|
12 | repositories 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 | |
---|
16 | If you use source archives of a released RTEMS version, then you can skip this |
---|
17 | section. |
---|
18 | |
---|
19 | Before you can build a :ref:`Board Support Package (BSP) <BSPs>` for your |
---|
20 | target hardware, you have to bootstrap the build system in the RTEMS sources. |
---|
21 | This is only necessary, if you use a Git repository clone of the RTEMS sources. |
---|
22 | You have to do this after a fresh repository clone and sometimes after build |
---|
23 | system file updates (e.g. after a ``git pull``). If you are not a build |
---|
24 | system expert, then do the bootstrap after each update of build system files. |
---|
25 | This is a bit annoying, but improving the build system is a complex and time |
---|
26 | consuming undertaking. Feel free to help the RTEMS Project to improve it. For |
---|
27 | the bootstrap it is important that the right version of Autotools |
---|
28 | (:file:`autoconf` and :file:`automake`) are in your ``$PATH``. The right |
---|
29 | version of Autotools is shipped with the RTEMS tool suite you already |
---|
30 | installed. |
---|
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 | |
---|
39 | These 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 |
---|