|
xmtc-documentation | The XMTC Manual and XMTC Tutorial. The XMTC language and all the tools included in this release are documented here. | ChangeLog |
xmtcc | XMTC Compiler. Compiles an XMTC program to a binary format for simulation. The source package of the compiler contains only the GPL licensed components of the compiler and thus does not provide all the source code necessarily to build the XMTC compiler from its source. | ChangeLog |
xmtsim | XMT Simulator. Enables cycle-accurate simulation of a 1024-processor XMT machine. | ChangeLog |
xmtc-memtools | XMTC Memory Tools. Creating memory image files to load application input data into the Simulator (file I/O is not supported at the present time). | ChangeLog |
xmtc-tools | XMTC Tools: (1) XMTC Serializer that can be used for debugging XMTC programs; (2) an XMTC-to-OpenMP convertor which generates C+OpenMP programs | ChangeLog |
There are three ways to use the XMT software tools:
If you are a linux user you can choose any of the three options, but if you are a Windows, or MacOS user your only option is the Virtual Box Option (3rd option).
Go to sourceforge and download and install the tools as described earlier. Each tool package contains a README file with installation instructions.
The advantage of this method is that it gives you maximum flexibility to decide which tools you want and which version of them to install. It is more tedious than the binary repository installation (option 2) however, and probably only makes sense if (i) you don't have svn installed (and cannot install it easily) (ii) don't have enough space for the tools, or (iii) want to mix and match versions of the tools (which in theory is not a good idea).
You need to have subversion (svn) installed. Then you can download the binary repository using the following command:
svn co https://xmtc.svn.sourceforge.net/svnroot/xmtc/xmtc.binary/linux/i386/xmt xmt-bin-reposThis will create a local directory called xmt-bin-repos
which will contain the latest versions of the binaries of all the XMT
tools. Next
you need to "install" the compiler. This is done by changing to the
compiler
(xmtcc) directory and running make
. This is done as
follows:
Finally you need to add the bin
directory under xmt-bin-repos
to your PATH
environment variable.
If you are using bash
as your shell, this can be done
with the following command:
Whenever you move your xmt-bin-repos
directory
you must
update your PATH
variable and "install" the compiler. But
this should rarely or never happen. Whenever you want to update to the
latest XMT tools, simply cd to the xmt-bin-repos
directory and type svn up. You are set!
The advantage of this option is that it is much easier to download and install all the tools and to update them. The only downside is that the svn repository will take more space (~60MB) and you need to have subversion (svn) installed on your computer. You also get less flexibility in mixing and matching tool versions (vs just using the latest), but this is probably not a good idea anyway.
If you are a Windows or Intel Mac user your only option to use our tools is through a virtual linux box that we provide, which has all the XMT tools pre-installed (v0.81) through the svn repository method (Option 2 above). PowerPC Macs are not supported because the virtualization software that we use (www.virtualbox.org) does not support PowerPC processors. Notice that the virtual box will not be routinely updated with the latest version of our tools but it is very easy for the users to do so, imply by issuing a simple command as explained in the virtual box HOWTO documentation
Using the virtual linux box is like having a window running a linux operating system from within your own operating system (e.g., Windows or Mac) and therefore it requires a significant amount of resources. Find below the minimum and recommended system requirements for using the virtual box.
System Requirements:To start using the XMT Virtual Box, follow the HOWTO to download and install the necessary components.
The virtual box probably has no advantage if you are a linux user since it requires significant amount of memory and processing power, compared to installing the tools natively. But for Windows or MacOS users it is the only option.