= RTEMS Source Builder =

[[TOC(Developer/Tools/RSB, depth=2)]]

The RTEMS Source Builder or RSB builds RTEMS tool sets for a range of hosts from source. It is an easy to use tool complete with [https://docs.rtems.org/rsb documentation] that gives you a ready to use RTEMS tool set for your architecture. It is actively being maintained so you get a current tool set that works with RTEMS releases as well as RTEMS's development branches.

The RTEMS Source Builder builds using the source code for the tools by downloading it plus any patches. The source is left on disk after the build and you can archive it along with all the other source in your project. Any time in the future you can rebuild the exact tools and if you have a long life project and your build host need replacing you can rebuild the tools from source.

The RSB is part of the [wiki:Developer/Tools RTEMS Tool Project].

Source Builder was created and is maintained by Chris Johns. Feel free to ask about it on the RTEMS User and Development mailing lists.

The RSB repository is https://git.rtems.org/rtems-source-builder.

== Documentation ==

The RSB documentation and the Quick Start to get going can be found at https://docs.rtems.org/rsb/.

== Building a Tools set with RTEMS ==

To build a tool set checkout the RSB repo and then get the RSB to build the tools and RTEMS. 

{{{
$ cd
$ mkdir -p development/rtems/rsb
$ cd development/rtems/rsb
$ git clone git://git.rtems.org/rtems-source-builder.git
$ cd rtems-source-builder
$ cd rtems
$ ../source-builder/sb-set-builder --prefix=$HOME/development/rtems/4.11 4.11/rtems-sparc
}}}

== Supported Hosts ==

* Archlinux
* Centos
* Fedora
* FreeBSD
* NetBSD
* MacOS
* Linux Mint
* openSUSE
* Raspbian
* Ubuntu
* Windows (MSYS2)
* Xubuntu

== CentOS 7 and Debian 8 (Jessie) - Building Notes ==

The note below is valid if you plan to generate the tools for RTEMS 4.10 on CentOS 7 or Debian 8 (Jessie) using RTEMS Source Builder 0.5.0.

The current version of CentOS 7 uses texinfo version 5.1 as its default textinfo package. Debian 8 uses version 5.2. The makeinfo >= 5.0 are currently not supported for 4.10/rtems-*, for instance. Use the following workaround if your compilation fails in consequence of incompatible makeinfo check on CentOS 7 and Debian 8:
{{{
$ cd ~/Downloads
$ wget http://ftp.gnu.org/gnu/texinfo/texinfo-4.13.tar.gz
$ tar -xzf texinfo-4.13.tar.gz
$ cd texinfo-4.13
$ ./configure --prefix=$HOME/development/textinfo-4.13
$ make 
$ make install
}}}
If you succeeded to build textinfo 4.13:
{{{
$ export PATH=$HOME/development/textinfo-4.13/bin:$PATH
}}}
You are now ready to re-run RSB with 4.10/rtems-[your-favorite-arch].