RTEMS 4.8.1 On-Line Library

Cygwin

Getting Started with RTEMS

7.2: Cygwin

For RTEMS development, the recommended approach is to use Cygwin 1.0 or later. Cygwin is available from http://sources.redhat.com/cygwin Recent versions of Cygwin are vastly improved over the beta versions. Most of the oddities, instabilities, and performance problems have been resolved. The installation procedure is much simpler. However, there are a handful of issues that remain to successfully use Cygwin as an RTEMS development environment.

There is no cc program by default. The GNU configure scripts used by RTEMS require this to be present to work properly. The solution is to link gcc.exe to cc.exe as follows:
```
ln -s /bin/gcc.exe  /bin/cc.exe
```
Make sure /bin/sh.exe is GNU Bash. Some Cygwin versions provide a light Bourne shell which is insufficient to build RTEMS. To see which shell is installed as /bin/sh.exe, execute the command /bin/sh --version. If it looks similar to the following, then it is GNU Bash and you are OK:
```
GNU bash, version 2.04.5(12)-release (i686-pc-cygwin)
Copyright 1999 Free Software Foundation, Inc.
```
If you get an error or it claims to be any other shell, you need to copy it to a fake name and copy /bin/bash.exe to /bin/sh.exe:
```
cd /bin
mv sh.exe old_sh.exe
cp bash.exe sh.exe
```
The Bourne shell has to be present in /bin directory to run shell scripts properly.
Make sure you unarchive and build in a binary mounted filesystem (e.g. mounted with the -b option). Otherwise, many confusing errors will result.
A user has reported that they needed to set CYGWIN=ntsec for chmod to work correctly, but had to set CYGWIN=nontsec for compile to work properly (otherwise there were complaints about permissions on a temporary file).
If you want to build the tools from source, you have the same options as UNIX users.
You may have to uncompress archives during this process. You must NOT use WinZip or PKZip. Instead the un-archiving process uses the GNU zip and tar programs as shown below:
```
tar -xzvf archive.tgz
```
tar is provided with Cygwin.

Getting Started with RTEMS