Install LEX

For Ubuntu Users :

sudo apt-get update
sudo apt-get install flex

For Fedora Users :

yum install flex flex-devel

Install YACC

For Ubuntu Users :

sudo apt-get update
sudo apt-get install bison

For Fedora Users :

yum install bison bison-devel byacc

Install XSM Machine Simulator

The compiler's target code needs to be run on a simulator and the installation steps are given below.

Let us install XSM

Step 1 :

Download XSM Simulator : Version 1

Step 2 :

Extract this file and navigate into the folder xsm_expl through the terminal.

Do the following steps:

• 1. Type "make".

  You may get some warnings and they can be ignored. If you get any fatal error, then install the following dependencies and try running "make" again :
  sudo apt-get install libreadline-dev
  sudo apt-get install libc6-dev
  sudo dnf install readline-devel # for fedora
  If any other dependencies are missing (this depends on your system configuration), you have to install the missing dependencies and run "make" again. (Optional) While running "./xsm" after Step 2 if you get this error:
  /usr/bin/ld: cannot find -ll collect2: error: ld returned 1 exit status Then you need to install:
  sudo apt-get install libfl-dev
  and edit the Makefile of xsm_dev folder, to proceed find the line where "-ll" is used as option and update it to "-lfl" to use the "flex" library we installed above. Now you can run "make" again after navigating into the folder xsm_expl through the terminal.

  If you run into errors pretaining to /usr/include/readline/*, Update xfs-interface/interface.c and include stdio.h before readline headers

  
  
• 2. Type "cd ../xfs-interface/" and type "./init".


• 3.(Optional) Add this line #!/usr/bin/env bash as first line to the xsm file in xsm_expl folder.
This step is for those who don't have bash or sh as their "default shell" and therefore may be using other customizable shells like zsh, etc as their default shell. You can check your default shell by using echo $SHELL in terminal.

The usage instructions for the XSM simulator can be found here.

Please report installation errors to kmurali@nitc.ac.in