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 made ready the |
---|
12 | source for two RTEMS source packages in the previous sections. We installed |
---|
13 | the tool suite in :file:`$HOME/quick-start/rtems/5` and unpacked the RSB source |
---|
14 | in :file:`$HOME/quick-start/src`. |
---|
15 | |
---|
16 | You only need to *bootstrap* the RTEMS sources if you have used |
---|
17 | :ref:`QuickStartSources_Git` to get the sources. If you use source archives of |
---|
18 | a released RTEMS version you can skip this section and move to |
---|
19 | :ref:`QuickStartBSPBuild`. |
---|
20 | |
---|
21 | Before you can build a :ref:`Board Support Package (BSP) <BSPs>` for your |
---|
22 | target hardware from Git cloned RTEMS sources, you have to bootstrap the build |
---|
23 | system in the RTEMS sources. This is only necessary if you use a Git |
---|
24 | repository clone of the RTEMS sources. You have to do this after a fresh |
---|
25 | repository clone and sometimes after build system file updates (e.g. after a |
---|
26 | ``git pull``). If you are not a build system expert, then do the bootstrap |
---|
27 | after each update of build system files. This is a bit annoying, but improving |
---|
28 | the build system is a complex and time consuming undertaking. Feel free to |
---|
29 | help the RTEMS Project to improve it. For the bootstrap it is important that |
---|
30 | the right version of Autotools (:file:`autoconf` and :file:`automake`) are in |
---|
31 | your ``$PATH``. The right version of Autotools is shipped with the RTEMS tool |
---|
32 | suite you already installed. Set the path to the tool suite installed under |
---|
33 | your selected *prefix*: |
---|
34 | |
---|
35 | .. code-block:: none |
---|
36 | |
---|
37 | export PATH=$HOME/quick-start/rtems/5/bin:"$PATH" |
---|
38 | |
---|
39 | Change into the RTEMS source tree to *bootstrap* the build system: |
---|
40 | |
---|
41 | .. code-block:: none |
---|
42 | |
---|
43 | cd $HOME/quick-start/src/rtems |
---|
44 | ./rtems-bootstrap |
---|
45 | |
---|
46 | This command should output something like this (omitted lines are denoted by |
---|
47 | ``...``): |
---|
48 | |
---|
49 | .. code-block:: none |
---|
50 | |
---|
51 | RTEMS Bootstrap, 1.0 |
---|
52 | 1/122: autoreconf: configure.ac |
---|
53 | 2/122: autoreconf: testsuites/configure.ac |
---|
54 | 3/122: autoreconf: testsuites/fstests/configure.ac |
---|
55 | 4/122: autoreconf: testsuites/smptests/configure.ac |
---|
56 | 5/122: autoreconf: testsuites/psxtests/configure.ac |
---|
57 | 6/122: autoreconf: testsuites/mptests/configure.ac |
---|
58 | ... |
---|
59 | 121/122: autoreconf: c/src/lib/libbsp/lm32/milkymist/configure.ac |
---|
60 | 122/122: autoreconf: c/src/make/configure.ac |
---|
61 | Bootstrap time: 0:00:46.404643 |
---|