Setting-up GranSim

[WARNING: THIS IS VERY DRAFTY FOR NOW. IF YOU HAVE SEVERE INSTALLATION PROBLEMS PLEASE LET ME KNOW.]

This chapter describes how to get the latest version of GranSim, and how to install it.

The system requirements are basically the same as for GHC itself. So far, GranSim has been tested on SUNs under SunOS 4.1 and Solaris 2, and on DEC Alphas under OSF 1 and OSF 3.2. The visualisation tools require Perl, Bash and Gnuplot (only for granularity profiles).

• Retrieving
• Installing
• Trouble Shooting

Retrieving

The important addresses to check for the latest information about GHC and GranSim:

• GranSim Home Page -- http://www.dcs.glasgow.ac.uk/fp/software/gransim.html GranSim Home Page -- http://www.dcs.glasgow.ac.uk/fp/software/gransim.html
• Anonymous FTP Server -- ftp://ftp.dcs.glasgow.ac.uk/pub/haskell/glasgow/ Anonymous FTP Server -- ftp://ftp.dcs.glasgow.ac.uk/pub/haskell/glasgow/
• GHC home page -- http://www.dcs.glasgow.ac.uk/fp/software/ghc.html GHC home page -- http://www.dcs.glasgow.ac.uk/fp/software/ghc.html
• Glasgow FP group page -- http://www.dcs.glasgow.ac.uk/fp/ Glasgow FP group page -- http://www.dcs.glasgow.ac.uk/fp/

To get the current version of GranSim go to the anonymous FTP Server at Glasgow and retrieve version 0.29 of GHC. The sources of the compiler with GranSim support are in

ghc-0.29-src.tar.gz

Only if you don't already have an installed version of GHC for bootstrapping the new version you'll have to download the HC files in that directory, too.

Check the README file on the FTP server to get more information about the different versions you can download. There should be at least one binary installation of GranSim available for Suns. If you have the right machine and operating system you can just download and unpack this version.

Installing

Follow the instructions in the GHC Installation Guide (in the subdirectory `ghc/docs/install_guide'.

Note that so far GranSim has only been tested with Haskell 1.2. I recommend using that version until I have had a closer look at the interaction of GranSim with the new, shiny GHC for 1.3.

The only things different from a normal installation are:

• Call the configure script with the additional option

  --enable-gransim

• Typing

  make all

  (after `configure' and `STARTUP') should create all necessary libraries. All GranSim specific libraries (and hi files) have the extension `_mg.a' (`_mg.hi').

You can find a copy of the GranSim User's Guide in the subdirectory `ghc/docs/gransim'.

Trouble Shooting

If an installation with make all doesn't run through smoothly, try to build the components by hand. Often it's just a problem with dependencies or old interface files. Try to recompile the modules by hand on which the failing module depends.

The top level files for the installation are

• `hsc' in the directory `ghc/compiler/': the compiler proper.
• The libraries `libHS_mg.a' and `libHS13_mg.a' in the directory `ghc/lib/': these are the necessary built-in libraries (preludes). The libraries `libHSghc_mg.a' and `libHShbc_mg.a' are optional.
• `libHSrts_mg.a' in the directory `ghc/runtime/': the runtime-system.

You can create a version of the RTS with debugging information (and all GranSim debugging options) by typing

make EXTRA_HC_OPTS="-optcO-DGRAN -optcO-DGRAN_CHECK -optcO-DDEBUG -optcO-g" 
     libHSrts_mg.a

For those Bravehearts who want to actually hack on the RTS I recommend first having a closer look at the hackers sections of the general GHC User's Guide (@xref{(ghc-user-guide.info)Top}). Eventually, I'll add GranSim specific stuff to the chapter about the internals of GranSim (@xref{GranSim Internals}) but for now there is not much in this chapter.

Go to the first, previous, next, last section, table of contents.