[PATCH] Add Windows Subsystem for Linux to RSB Doc

Alan Cudmore alan.cudmore at gmail.com
Thu Aug 18 03:48:49 UTC 2016

 doc/source-builder.txt | 56
 1 file changed, 44 insertions(+), 12 deletions(-)

diff --git a/doc/source-builder.txt b/doc/source-builder.txt
index 3bcc397..d676e63 100644
--- a/doc/source-builder.txt
+++ b/doc/source-builder.txt
@@ -39,7 +39,7 @@ from source and taught this tool. The RTEMS Source
Builder has been tested on:
 * <<_freebsd,FreeBSD>>
 * <<_netbsd,NetBSD>>
 * <<_macos,MacOS>>
-* <<_mint,Linux Mint>>
+* <<_linuxmint,LinuxMint>>
 * <<_opensuse,openSUSE>>
 * <<_raspbian,Raspbian>>
 * <<_ubuntu,Ubuntu>>
@@ -3112,6 +3112,15 @@ $ sudo apt-get build-dep binutils gcc g++ gdb unzip
 $ sudo apt-get install python2.7-dev

+zlib package is required on Linux Mint. It has a different name (other
+than the usual zlib-dev):
+# sudo apt-get install zlib1g-dev

@@ -3157,16 +3166,6 @@ The RTEMS Source Builder has been tested on Mountain
Lion. You will need to
 install the Xcode app using the _App Store_ tool, run Xcode and install the
 Developers Tools package within Xcode.

-Linux Mint
-zlib package is required on Linux Mint. It has a different name (other
-than the usual zlib-dev):
-# sudo apt-get install zlib1g-dev

@@ -3204,13 +3203,15 @@ debugging experiences may vary and if this is an
issue please raised the topic
 on the RTEMS Users mailing list.

 Building the tools or some other packages may require a Unix or POSIX type
-shell. There are a few options, Cygwin and MSYS2. I recommend MSYS2.
+shell. There are a few options, Cygwin, MSYS2, and Windows Subsystem for
+(WSL) on Windows 10 with the 2016 Windows Anniversary Update. I recommend

 .Ready To Go Windows Tools
 NOTE: From time to time I provide tools for Windows at


 This is a new version of the old MinGW project's original MSYS based
around the
 Arch Linux pacman packager. MSYS and MSYS2 are a specific fork of the
@@ -3237,6 +3238,7 @@ Install a suitable version of Python from
http://www.python.org/ and add it to
 the start of your path. The MSYS2 python does not work with waf.


 Building on Windows is a little more complicated because the Cygwin shell
 used rather than the MSYS2 shell. The MSYS2 shell is simpler because the
@@ -3352,6 +3354,36 @@ reasons they cannot be avoided in all cases. Cygwin
and it's fork MSYS are
 fantastic pieces of software in a difficult environment. I have found
 a single tool tends to work, building all at once is harder.

+Windows Subsystem for Linux (WSL)
+The Windows Subsystem for Linux is a port of the user mode binaries from
+Ubuntu 14.04 LTS to Windows 10. It was first made available in the August
+Windows 10 Anniversary Update.
+WSL installs a Bash shell and many of the Ubuntu command line linux
+including a fully working apt-get command. Graphical or X-Windows
+are not supported.
+.Installing WSL
+NOTE: There are many articles on the internet describing how to install
+Here is an example:
+Once WSL is installed, using the RTEMS Source Builder is nearly the same as
+as using it on Ubuntu Linux 14.04. I had to install the following packages
+to allow RSB to work on WSL
+$ sudo apt-get install autoconf automake bison flex binutils gcc \
+g++ gdb texinfo unzip ncurses-dev python-dev git zlib1g-dev make
+Once the RSB toolchain is compiled, I was able to add the toolchain to my
+by editing .bashrc in my WSL home directory. For some reason, .profile was
+run when starting a bash shell like it does when logging into a real Ubuntu

 Build Status By Host
2.7.4 (Apple Git-66)
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.rtems.org/pipermail/devel/attachments/20160817/1ae93c46/attachment-0001.html>

More information about the devel mailing list