Documentation | Add Example of Building RTEMS Out of Tree (#166)

Joel Sherrill (@joel) gitlab at rtems.org
Tue Sep 15 17:36:13 UTC 2026



Issue created by Joel Sherrill: https://gitlab.rtems.org/rtems/docs/rtems-docs/-/work_items/166



## Summary
RTEMS can be built out of tree but there does not appear to be an example of doing this in the Users Guide. The following set of commands builds RTEMS out of tree. 

```
rm -rf /tmp/bsp
mkdir  /tmp/bsp
../rtems/waf configure --prefix=/tmp/bsp-install \
                --rtems-config=config-default.ini \
                --top=$HOME/rtems-work/rtems \
                --out=/tmp/bsp && \
../rtems/waf --top=$HOME/rtems-work/rtems >/dev/null && \
../rtems/waf --top=$HOME/rtems-work/rtems install >/dev/null
echo $?
```

This command sequence assumes the ini file is at the top of the RTEMS source. This should not be assumed. This script needs to be further tested and tweaked to be an example where nothing user related is in the RTEMS source tree.


<!-- Pre-set options
- milestone
-->

-- 
View it on GitLab: https://gitlab.rtems.org/rtems/docs/rtems-docs/-/work_items/166
You're receiving this email because of your account on gitlab.rtems.org. Unsubscribe from this thread: https://gitlab.rtems.org/-/namespace/19/sent_notifications/5-4ox59rv9varrcrqlswg4sqozx-j/unsubscribe | Manage all notifications: https://gitlab.rtems.org/-/profile/notifications | Help: https://gitlab.rtems.org/help


-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.rtems.org/pipermail/bugs/attachments/20260915/aeb0bb0d/attachment-0001.htm>


More information about the bugs mailing list