Editing Cartographer Agent Build Instructions (section)

== Required Environment Variable ==

The source code is as portable as can be given the requirement that it work across UNIX and Windows.  Where necessary, platform-specific code is ''ifdef'd'' by platform name.  We use an environment variable '''''SYSTEM''''' which feeds into make files to distinguish which platform we are building on.  The following values are recognized:

* '''LINUX''' is used to signify 32-bit x86 Linux.  Builds on this platform are then currently used on 32-bit and 64-bit x86 and x86_64 systems.
* '''WIN32''' is used to signify 32-bit Windows on x86.
* '''SOLARIS''' is used to signify 64-bit Solaris 9+ on Sparc V9 chipsets and 32-bit Solaris 9+ on x86.

In ''csh'' and ''tcsh'', the following snippet can be used to set the '''''SYSTEM''''' environment variable.  Translating to other shells is left as an exercise for the reader.

<pre>
setenv SYSTEM "unknown"
if (-e /bin/uname) then
   set os_name  = `/bin/uname -r`
   set os_sysname = `/bin/uname -s`
else
   set os_name  = `/usr/bin/uname -r`
   set os_sysname = `/usr/bin/uname -s`
endif
if ( `expr $os_name : '5.*'` ) then
   setenv SYSTEM "SOLARIS"
endif
if ( `expr $os_sysname : 'Linux'` ) then
   setenv SYSTEM "LINUX"
endif
</pre>