MiniPolaris home page

Setup

Initial Setup

The MiniPolaris skeleton files are installed on the departmental linux server (linux.cs.tamu.edu). On this machine you will also do most of your work. You need to create the Minipolaris environment in your local directory. First, login in to linux (.cs.tamu.edu). Second, setup your work directory by running the following (output is shown in bold) :

/pub/courses/cpsc605/config/setup

This will create a bunch of files in directory:

/user/login/minipolaris

where login is your login name

In your newly created minipolaris directory there is a sub directory named config which contains scripts that update your environment with some necessary variables. Before running mini_polaris you need to source the scipts.

Compiling MiniPolaris:

cd ~/minipolaris
make [mini_polaris] >& make.log &
tail -f make.log

The above method of saving the output to make.log while also reading it allows you to monitor the progress, yet keep the output on file so you may closely scrutinize it if necessary. If you compile from within emacs, this is not necessary.

Also, note that since tail -f continues to wait for anything appended to the file, you will have to hit Control-C to exit.

For a more thorough description of the compilation process, see Project 1a.

Running MiniPolaris

When your $PATH is correctly set, you may run mini_polaris from any directory.

 mini_polaris [ -s <switches> -f <switch file> -v [ file.f ... ]

-s   Indicates that a set of switch  specifications  follow.
      The  format is token=value,...,token=value.

-f   Indicates that the next argument on the command line is
      a  file containing the declaration of tokens for use as
      switche values in polaris.

-v   Print the version.

A sample switch file would contain several switches, including the following :

pu_start     0   skip until PROGRAM-UNIT-(pu_start)
pu_stop      0   skip after PROGRAM-UNIT-(pu_stop)
prom_logical 1  1= promote LOGICALs to INTEGERs in arithmetic exprs
prom_integer 1  1= promote INTEGERs to LOGICALs in logical exprs
integer_len  4  default length of INTEGER variables.
logical_len  4  default length of LOGICAL variables.
real_len     8  default length of REAL variables.
double_len   8  default length of DOUBLE PRECISION variables.
complex_len  8  default length of COMPLEX variables.

removegoto   1  control flow normalization to create IF-ENDIF blocks.
equiv        1  replace real references with equivalenced complex
equiv_debug  0  debug level of equivalence normalizer

The output of mini_polaris is a list file, which includes diagnostic information. You may convert this output to a FORTRAN program with the list2src command :

polaris file.f > file.list
list2src < file.list > file.new.f

This can then be input into a native compiler.

Department of Computer Science and Engineering | Dwight Look College of Engineering | Texas A&M University
Privacy statement: Computer Science and Engineering Engineering TAMU