CONFIG.COMMON
=============

.. note::
   You usually don't have to change the variables in the configuration files
   regarding directories. All programs are installed at the INSTALLTOP
   directory which is defined by :doc:`bin/setup.sh <setup>`,

Variables for building gcc/g++ with :doc:`build-gcc.sh <gcc>` are described
here:

:ref:`gcc configuration variables <gcc_config_variables>`

Variables for building Python 2 with :doc:`build-python2.sh <python2>` are
described here:

:ref:`Python 2 configuration variables <python2_config_variables>`

The remaining variables of the configuration file CONFIG.COMMON are:

.. _common_config_variables:

.. note::
  `$INSTALLTOP` is defined by :doc:`bin/setup.sh <setup>`,
  `$TOP` is the directory where rtems-from-scratch is located

+-------------------------------+---------------------------------------+------------------------------------------+
| Variable                      | default value                         | explanation                              |
+===============================+=======================================+==========================================+
| RTEMS_ARCH                    | rtems-powerpc                         | The CPU architecure which the cross      |
|                               |                                       | tools are built for                      |
+-------------------------------+---------------------------------------+------------------------------------------+
| RTEMS_CROSS_INSTALL_DIR       | $INSTALLTOP/crosstools/$RTEMS_VERSION | The directory where the cross tools      |
|                               |                                       | are installed                            |
+-------------------------------+---------------------------------------+------------------------------------------+
| RTEMS_CROSS_SRC_DIR           | $TOP/src/crosstools/$RTEMS_VERSION    | The directory where the cross tool       |
|                               |                                       | sources are put                          |
+-------------------------------+---------------------------------------+------------------------------------------+
| RTEMS_CROSS_USE_LOCAL_GCC     | "no"                                  | Use locally built gcc                    |
+-------------------------------+---------------------------------------+------------------------------------------+
| RTEMS_CROSS_USE_LOCAL_PYTHON2 | "no"                                  | Use locally built Python 2               |
+-------------------------------+---------------------------------------+------------------------------------------+
| RTEMS_CROSS_NICE              | "yes"                                 | Run processes with "nice", so they run   |
|                               |                                       | with low priority                        |
+-------------------------------+---------------------------------------+------------------------------------------+