1 | .. SPDX-License-Identifier: CC-BY-SA-4.0 |
---|
2 | |
---|
3 | .. Copyright (C) 2019 embedded brains GmbH |
---|
4 | .. Copyright (C) 2019 Sebastian Huber |
---|
5 | .. Copyright (C) 2016 Chris Johns <chrisj@rtems.org> |
---|
6 | |
---|
7 | .. _QuickStartPrefixes: |
---|
8 | |
---|
9 | Choose an Installation Prefix |
---|
10 | ============================= |
---|
11 | |
---|
12 | .. index:: prefix |
---|
13 | |
---|
14 | You will see the term :ref:term:`prefix` referred to throughout this |
---|
15 | documentation and in a wide number of software packages you can download from |
---|
16 | the internet. It is also used in the |
---|
17 | `GNU Coding Standard <https://www.gnu.org/prep/standards/html_node/Directory-Variables.html>`_. |
---|
18 | A *prefix* is the path on your host computer a software package is installed |
---|
19 | under. Packages that have a prefix will place all parts under the prefix |
---|
20 | path. Packages for your host computer typically use a default prefix of |
---|
21 | :file:`/usr/local` on FreeBSD and Linux. |
---|
22 | |
---|
23 | You have to select a prefix for your RTEMS tool suite installation. The RTEMS |
---|
24 | tool suite consists of a cross tool chain (Binutils, GCC, GDB, Newlib, etc.) |
---|
25 | for your target architecture and :ref:`other tools <HostTools>` provided by the |
---|
26 | RTEMS Project. You build and install the tool suite with the |
---|
27 | :ref:`RTEMS Source Builder (RSB) <RSB>`. By default, the RSB will start the |
---|
28 | prefix path with a host operating system specific path plus :file:`rtems` plus |
---|
29 | the RTEMS version, e.g. :file:`/opt/rtems/5` on Linux and |
---|
30 | :file:`/usr/local/rtems/5` on FreeBSD and macOS. |
---|
31 | |
---|
32 | It is strongly recommended to run the RSB as a *normal user* and not with |
---|
33 | *root* privileges (also known as *super user* or *Administrator*). You have to |
---|
34 | make sure that your normal user has sufficient privileges to create files and |
---|
35 | directories under the prefix. For example, you can create a directory |
---|
36 | :file:`/opt/rtems` and give it to a developer group with read, write and |
---|
37 | execute permissions. Alternatively, you can choose a prefix in your home |
---|
38 | directory, e.g. :file:`$HOME/rtems/5` or with a project-specific component |
---|
39 | :file:`$HOME/project-x/rtems/5`. For more ideas, see the |
---|
40 | :ref:`project sandboxing <ProjectSandboxing>` section. In this quick start |
---|
41 | chapter, we will choose :file:`$HOME/quick-start/rtems/5` for the RTEMS tool |
---|
42 | suite prefix. |
---|
43 | |
---|
44 | .. warning:: |
---|
45 | |
---|
46 | The prefix must not contain space characters. |
---|