<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html lang="en">
<head>
<meta http-equiv="Content-Language" content="en-us">
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Before you begin</title>
<link rel="stylesheet" type="text/css" href="../help.css">
</head>
<body>
<h2>Before you begin</h2>
<p>Depending on how you obtained the CDT, you might have also received
a toolchain with a built-in CDT integration.
However, if you downloaded the CDT from an update site, then you will require a toolchain before
you can build and debug any projects.</p>
<p>The base CDT supports integration with the GNU toolchain.
This includes GNU's make, gcc compiler, and gdb debugger utilities.
If you require a toolchain to build software for your development host, this
is the best choice to get started.
<p>Each platform that runs the CDT requires different steps to acquire this toolchain.</p>
<h3>Linux</h3>
<p>All Linux distributions include the GNU toolchain. They may not, however, be installed by default.
For instructions about installing the GNU toolchain for Linux, see the instructions for your particular distribution.</p>
<h3>Windows</h3>
<p>For windows, MinGW, and Cygwin are the two main choices for acquiring the GNU toolchain:</p>
<ul>
<li><a href="http://www.cygwin.com"><strong>Cygwin</strong></a> is a port of the Linux environment to Windows.
It provides a compatibility layer in a set of DLLs. These DLLs are
<a href="http://www.gnu.org/copyleft/gpl.html">GPL licensed</a>,
making any code that links to them also subject to the GPL.
Cygwin, however, does provide the fullest implementation of the GNU toolchain
by supporting the GNU libc C runtime library.
Note: currently Cygwin >= version 3.4.4-999 is not supported since gcc and g++ commands cannot
be launched from the windows' native shell.
<p> <br></p>
</li>
<li><p><a href="http://www.mingw.org"><strong>MinGW</strong></a> is a port of the GNU toolchain to the Windows platform.
The biggest difference over Cygwin is that MinGW uses the Windows C runtime libraries (mscvrt) instead
of GNU's libc. As a result, a compatibility layer is not required, thus avoiding the GPL issues
with Cygwin. There are differences, though, between the Windows and GNU C runtime libraries that will make
writing portable applications more difficult.</p>
<br>
<p>However, MinGW provides the best integration support with the CDT
due to it's direct support for the Windows environment.</p>
<br>
<p>The following are instructions and links on how to install the current version
of MinGW. Note that these links may become inaccurate over time as new versions of
MinGW components are introduced. Please check the
<a href="http://sourceforge.net/project/showfiles.php?group_id=2435">
MinGW File Release</a> section for the latest versions.</p>
<br>
<ol>
<li>Download and run the MinGW setup program,
<a href="http://downloads.sourceforge.net/mingw/MinGW-5.1.3.exe">MinGW-5.1.3.exe</a>.
<li>Select download and install the MinGW base tools and the g++ compiler.
You may select the Current or Candidate version of these tools.
You may also install any of the other available compilers as well.
<p><strong>Do not install the MinGW Make feature</strong> as the MSYS version of make from step 5
is a more complete implementation of make.</p></li>
<li>The MinGW setup program currently does not install the gdb debugger.
To install the debugger, download the file from the following location:
<a href="http://downloads.sourceforge.net/mingw/gdb-6.6.tar.bz2">gdb-6.6.tar.bz2</a>
<li>Extract the contents of the file gdb-6.6.tar.bz2 to the same location where you installed MinGW.</li>
<li>If you want to use Makefile projects, download and run the setup program from the following location:
<a href="http://downloads.sourceforge.net/mingw/MSYS-1.0.10.exe">MSYS-1.0.10.exe</a>.
MSYS provides an implementation of make and related command line tools.
This is not required for other types of projects with the MinGW toolchain,
which use CDT's internal build tools to perform the build.</li>
</ol>
</ul>
<br>
<h3>Other Platforms</h3>
<p>The GNU toolchain is supported on all platforms that the CDT supports. For instructions about installing the GNU toolchain
on your platform, see your platform vendor.</p>
<p align="left"> <img border="0" src="../images/ngref.gif" ALT="Related reference" width="143" height="21"> <br>
<a href="../concepts/cdt_o_home.htm">CDT Home</a><br>
<p align="left"> <img border="0" src="../images/ngtasks.gif" ALT="Related tasks"> <br>
<a href="../tasks/cdt_t_manualbuild.htm">Building Manually</a>
</p>
<p><img src="../images/ng00_04a.gif" ALT="QNX Copyright Statement" >
</p>
</body>
</html>
