carbidecpp22devenv/configuration/org.eclipse.osgi/bundles/309/1/.cp/concepts/cdt_c_before_you_begin.htm
author cawthron
Fri, 04 Dec 2009 10:01:33 -0600
changeset 5 684bf18fdedf
permissions -rw-r--r--
add files for RCL_2_2
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
5
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
     1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
     2
<html lang="en">
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
     3
<head>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
     4
	<meta http-equiv="Content-Language" content="en-us">
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
     5
	<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
     6
	<title>Before you begin</title>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
     7
	<link rel="stylesheet" type="text/css" href="../help.css">
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
     8
</head>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
     9
<body>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    10
<h2>Before you begin</h2>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    11
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    12
<p>Depending on how you obtained the CDT, you might have also received
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    13
a toolchain with a built-in CDT integration.
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    14
However, if you downloaded the CDT from an update site, then you will require a toolchain before
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    15
you can build and debug any projects.</p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    16
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    17
<p>The base CDT supports integration with the GNU toolchain.
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    18
This includes GNU's make, gcc compiler, and gdb debugger utilities.
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    19
If you require a toolchain to build software for your development host, this
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    20
is the best choice to get started.
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    21
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    22
<p>Each platform that runs the CDT requires different steps to acquire this toolchain.</p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    23
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    24
<h3>Linux</h3>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    25
<p>All Linux distributions include the GNU toolchain. They may not, however, be installed by default.
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    26
For instructions about installing the GNU toolchain for Linux, see the instructions for your particular distribution.</p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    27
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    28
<h3>Windows</h3>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    29
<p>For windows, MinGW, and Cygwin are the two main choices for acquiring the GNU toolchain:</p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    30
<ul>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    31
<li><a href="http://www.cygwin.com"><b>Cygwin</b></a> is a port of the Linux environment to Windows.
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    32
It provides a compatibility layer in a set of DLLs. These DLLs are
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    33
<a href="http://www.gnu.org/copyleft/gpl.html">GPL licensed</a>,
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    34
making any code that links to them also subject to the GPL.
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    35
Cygwin, however, does provide the fullest implementation of the GNU toolchain
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    36
by supporting the GNU libc C runtime library. 
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    37
Note: currently Cygwin &gt;= version 3.4.4-999 is not supported since gcc and g++ commands cannot 
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    38
be launched from the windows' native shell.
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    39
<p> <br></p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    40
</li>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    41
<li><p><a href="http://www.mingw.org"><b>MinGW</b></a> is a port of the GNU toolchain to the Windows platform.
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    42
The biggest difference over Cygwin is that MinGW uses the Windows C runtime libraries (mscvrt) instead
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    43
of GNU's libc. As a result, a compatibility layer is not required, thus avoiding the GPL issues
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    44
with Cygwin. There are differences, though, between the Windows and GNU C runtime libraries that will make
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    45
writing portable applications more difficult.</p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    46
<br>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    47
<p>However, MinGW provides the best integration support with the CDT
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    48
due to it's direct support for the Windows environment.</p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    49
<br>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    50
<p>The following are instructions and links on how to install the current version
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    51
of MinGW. Note that these links may become inaccurate over time as new versions of
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    52
MinGW components are introduced. Please check the
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    53
<a href="http://sourceforge.net/project/showfiles.php?group_id=2435">
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    54
MinGW File Release</a> section for the latest versions.</p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    55
<br>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    56
<ol>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    57
  <li>Download and run the MinGW setup program,
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    58
  <a href="http://downloads.sourceforge.net/mingw/MinGW-5.1.3.exe">MinGW-5.1.3.exe</a>.
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    59
  <li>Select download and install the MinGW base tools and the g++ compiler.
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    60
  You may select the Current or Candidate version of these tools.
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    61
  You may also install any of the other available compilers as well.
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    62
  <p><b>Do not install the MinGW Make feature</b> as the MSYS version of make from step 5
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    63
  is a more complete implementation of make.</p></li>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    64
  <li>The MinGW setup program currently does not install the gdb debugger.
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    65
  To install the debugger, download the file from the following location: 
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    66
  <a href="http://downloads.sourceforge.net/mingw/gdb-6.6.tar.bz2">gdb-6.6.tar.bz2</a>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    67
  <li>Extract the contents of the file gdb-6.6.tar.bz2 to the same location where you installed MinGW.</li>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    68
  <li>If you want to use Makefile projects, download and run the setup program from the following location: 
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    69
  <a href="http://downloads.sourceforge.net/mingw/MSYS-1.0.10.exe">MSYS-1.0.10.exe</a>.
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    70
  MSYS provides an implementation of make and related command line tools.
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    71
  This is not required for other types of projects with the MinGW toolchain,
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    72
  which use CDT's internal build tools to perform the build.</li>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    73
</ol>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    74
</ul>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    75
<br>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    76
<h3>Other Platforms</h3>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    77
<p>The GNU toolchain is supported on all platforms that the CDT supports. For instructions about installing the GNU toolchain
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    78
on your platform, see your platform vendor.</p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    79
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    80
<p align="left"> <img border="0" src="../images/ngref.gif" ALT="Related reference" width="143" height="21">  <br>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    81
  <a href="../concepts/cdt_o_home.htm">CDT Home</a><br>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    82
  
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    83
<p align="left"> <img border="0" src="../images/ngtasks.gif" ALT="Related tasks"> <br>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    84
  <a href="../tasks/cdt_t_manualbuild.htm">Building Manually</a>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    85
</p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    86
<p><img src="../images/ng00_04a.gif" ALT="QNX Copyright Statement" > 
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    87
</p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    88
</body>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    89
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    90
</html>