[an error occurred while processing this directive]
Node:<a name="Cross-DJGPP">Cross-DJGPP</a>,
Next:<a rel=next href="faq22_10.html">0xfe+0x20</a>,
Previous:<a rel=previous href="faq22_8.html">Upload</a>,
Up:<a rel=up href="faq22.html">Miscellany</a>
<br>

<h2>22.9 DJGPP as cross-compiler</h2>

<p><em><strong>Q</strong>: I want to use DJGPP as a cross-compiler for Motorola 68K targets. 
How should I proceed about this?</em>

<br><p>
<p><em><strong>Q</strong>: I want to build GCC as a Unix-to-DOS cross-compiler.  What should I
do?</em>

<br><p>
<p><strong>A</strong>:  If you want a cross-compiler for m68k on a DOS machine, you need
DJGPP configured as <code>host=i386-go32</code>, and <code>target=m68k-coff.</code>
Such a package <a href="ftp://ftp.lysator.liu.se/pub/msdos/gnu/gcc-dos-m68k/">is already available</a>.  The binaries there are
based on GCC 2.7.2.  This package is reportedly no longer supported, but
if you have questions about it, you can send them to <a href="mailto:jk55@cornell.edu">Jim Karpinski</a>.  You can also try to contact <a href="mailto:karuottu@freenet.hut.fi">Kai Ruottu</a>, who is the provider of DOS-hosted
gcc-m68k.  Note that this package has only basic support for C<tt>++</tt>:
the compiler is included, but the libraries, including <code>libstc++</code>
and <code>libg++</code>, and the C<tt>++</tt> headers are missing, so even
<code>cin</code> and <code>cout</code> don't work.

<p>A <a href="http://www.calm.hw.ac.uk/davidf/coldfire.htm">Win32-hosted gcc-m68k</a> is
another possibility.  It was created by David Fiddes.  The Cygwin port
of GCC can also be configured as a cross-compiler with m68k as the
target.  See <a href="faq3_6.html">the description of the Cygwin project</a>, for more details about the Cygwin
port.

<a href="http://www.objsw.com/CrossGCC/">Object Software Inc.</a> is a company that
supports cross-builds based on GCC and DJGPP.  Pre-built binaries of the
compiler and some minimal development tools are available from this site
for m68k, PowerPC, and Hitachi's SH-3 targets, all based on DJGPP v2. 
The CrossGCC FAQ, available from the same site, includes detailed
instructions for building a cross-compiler for any target.

<p>DJGPP can be built and installed as a cross-compiler running on a Unix
machine and targeting DOS/Windows platforms.  Detailed instructions for
doing this on Linux can be found in the <a href="http://www.delorie.com/howto/djgpp/linux-x-djgpp.html">DJGPP HOWTO Repository</a>.  Here is the summary of
the necessary steps to do that:

<ol type=1 start=1>
</p><li>Download the cross-compiler toolkit
<code>v2/djcrx203.zip</code> from the usual DJGPP sites.

<li>Unpack <code>djcrx203.zip</code> on the Unix machine using
<code>unzip -a</code>.

<p>You <strong>must</strong> use the <code>-a</code> switch, to force <code>unzip</code> to
convert any DOS-style text file with CR-LF pairs at the end of each line
to Unix-style text files.  If you don't, things will break for you.

<p><code>unzip</code> is available in source form from many FTP sites.  Linux
systems generally come with <code>unzip</code>, but if your system doesn't,
download the sources and build it.

</p><li>Link or move the files in the <code>cross</code> directory to the top-level
directory, where you unzipped <code>djcrxNNN.zip</code>.

<li>Download the latest GCC and Binutils distributions from your favorite
GNU FTP site.

<p>The main GNU site is <a href="ftp://ftp.gnu.org/gnu/">at ftp.gnu.org</a>.

</p><li>Unpack GCC and Binutils from the same directory where you unzipped
<code>djcrxNNN.zip</code>.

<li>You might need to edit the Makefile, either to choose an installation
directory as appropriate for your machine, or to change the names of the
directories where the GCC and Binutils distributions are unpacked (e.g.,
because their version numbers are different from those for which the
Makefile was prepared).

<li>Follow instructions in the file <code>cross/install</code> that was unpacked
from <code>djcrx203.zip</code> to build and install the
cross compiler.
</ol>

<p>The cross-compiler you build is installed as <code>dos-gcc</code>, so to
compile programs with it, use <code>dos-gcc</code> rather than <code>cc</code> or
<code>gcc</code>, or set <code>CC=dos-gcc</code> when invoking Make.

<p>The file <code>cross/readme</code> has some usage info for <code>dos-gcc</code>.  It
is generally correct, except that the version numbers for the various
packages might not be up to date.  You should always use the latest
releases of every package.

<p>Another alternative is the <code>build.cross</code> script included in the
source distribution of the DJGPP port of GCC, <code>gccNNNs.zip</code>.  This
script was tested on GNU/Linux systems, and it allows to build GCC as a
cross compiler hosted on a GNU/Linux system whose target is
DJGPP-supported platforms.  To use this script "out of the box", you
will need to take care of some preliminaries:

<ul>
<li>the <code>stubify</code> program is somewhere on your <code>PATH</code>;

<li>DJGPP headers (from the <code>djcrxNNNb.zip</code> package) are in the
<code><var>prefix</var>/i586-pc-msdosdjgpp/include</code> directory;

<li>DJGPP C<tt>++</tt> headers (from the <code>gppNNNb.zip</code> package) are in the
<code><var>prefix</var>/i586-pc-msdosdjgpp/lang/cxx</code> directory;

<li>DJGPP libraries are in the <code><var>prefix</var>/i586-pc-msdosdjgpp/lib</code>
directory;

<li>cross-binutils for the target <code>i586-pc-msdosdjgpp</code> are on your
<code>PATH</code>;

<li>the directory <code><var>prefix</var>/i586-pc-msdosdjgpp/<var>version</var></code>,
where <var>version</var> is the version of GCC, exists. 
</ul>

<p>Here, <var>prefix</var> is the root of your cross-development installation,
usually <code>/usr</code> or <code>/usr/local</code>.

<p><hr>
[an error occurred while processing this directive]