View source for Add support for more compilers to distcc

== Project Name ==

Add support for more compilers to distcc

== Project Description ==

An earlier project added multi-compiler support to distcc, and then MSVC support. The framework is now in place to support even more compilers. Add support for another compiler; either Java or C#.

Necessary Skills: C, Python, Makefile

== Project Leader(s) ==

[[User:Pcallaghan|Peter Callaghan (pcal)]]

== Project Contributor(s) ==
<ul>
<li>[[User:Rueen|Rueen Fiez]]</li>
<li>[[User:tjduavis|Timothy Duavis]]</li>
<li>[[User:Vlam6|Vincent Lam]]</li>
<li>[[User:Vbala|Vijey Balasundaram]]</li>
</ul>

Some options for contributions:
<ul>
 <li>publish/find some more c# files to test with</li>
 <li>test this on different OSs</li>
 <li>Make a comprehensive list of the set-up steps on one page, unlike the scattered links there are now</li>
 <li>more to be added later</li>
</ul>

== Project Details/News ==

===Goal for 0.2 release===
Continue work on the previously identified functions.  As of 0.1 several were still little more than shells, by the completion of 0.2 all except dcc_mcs_scan_args should be fully completed.  A supplementary goal is to set up the source as a branch of the existing trunk on cdot, so testers may just check out the new code rather than having to check out the trunk and patch it.

=== 0.1 Release ===
A patch[http://docs.google.com/Doc?id=dfkp8fkz_0hdwb6s] has been created.
Note that it is by no means anywhere near completion.
That's why this is the 0.1 release.

This patch has been tested on Windows XP, using cygwin to tell distcc to compile a single, simple c# file.  To use it:
<ol>
 <li>get cygwin[http://www.cygwin.com/]</li>
 <li>configure cygwin[http://developer.mozilla.org/en/docs/Windows_build_prerequisites_using_cygwin]</li>
 <li>download the Mono C# compiler[http://www.mono-project.com/Main_Page]</li>
  <ul>
   <li>put mono in your PATH</li>
  </ul>
 <li>set up an environment variable DISTCC_MCS_HOSTS=localhost</li>
 <li>Checkout the distcc source</li>
  <ul>
   <li>svn co svn://cdot.senecac.on.ca/distcc/trunk</li>
   <li>cd trunk && ./configure && make && make install</li>
   <li>put distcc in your PATH, before cygwin</lI>
  </ul>
 <li>get the 0.1 patch[http://docs.google.com/Doc?id=dfkp8fkz_0hdwb6s]</li>
 <li>apply the patch</li>
  <ul>
   <li>from the trunk directory</li>
   <li>patch -p0 < pcallaghanzeropointone.txt</li>
  </ul>
 <li>configure and build distcc</li>
  <ul>
   <li>from the trunk directory</li>
   <li>./configure && make && make install</li>
  </ul>
 <li>get a simple C# file[http://docs.google.com/Doc?id=dfkp8fkz_1hbrfkk]</li>
 <li>compile it</li>
  <ul>
   <li>distcc mcs hello.cs</li>
  </ul>
 <li>run it</li>
  <ul>
   <li>./hello</li>
  </ul>
</ol>

=== Goal for 0.1 Release ===
- Add support for Mono's cSharp compiler[http://www.mono-project.com/CSharp_Compiler].  By the 0.1 release, Distcc should be able to at least compile C# locally.  While the earlier work done on [[Distcc With MSVC]] suggests that only a hand-full of functions need to be coded in order for it to add a new compiler, both Java and C# compile in a manner significantly different than C.  This will likely cause some trouble shortly...regardless, the following functions are the minimum which need to be created:

<ul>
 <li>arg.c
  <ul>
   <li>dcc_<compilerName>_set_action_opt</li>
   <li>dcc_<compilerName>_set_output</li>
   <li>dcc_<compilerName>_scan_args</li>
  </ul>
 </li>
 <li>strip.c
  <ul>
   <li>dcc_<compilerName>_strip_local_args</li>
   <li>dcc_<compilerName>_strip_dasho</li>
  </ul>
 </li>
 <li>filename.c
  <ul>
   <li>dcc_<compilerName>_is_source</li>
   <li>dcc_<compilerName>_is_preprocessed</li>
   <li>dcc_<compilerName>_is_object</li>
   <li>dcc_<compilerName>_preproc_exten</li>
  </ul>
</li>
<li>hosts.c
 <ul>
  <li>dcc_<compilerName>_get_hostlist</li>
 </ul>
</li>
</ul>

===Known Bugs ===
See the list within [[Distcc With MSVC]]