next up previous
Next: 6 The ADAPTOR Runtime Up: ADAPTOR Installation Guide Previous: 4 Configuration of the

Subsections


5 The ADAPTOR Source-to-Source Translation

The sources for the transformation tool \fbox{fadapt} are stored in the subdirectory src. The sources are all written in C and should run on all UNIX machines. The fadapt executable will be generated in the following way:

   cd $PHOME/src
   make

5.1 Information about the Source Files

Most files of the source to source transformation have been generated by compiler tools (compiler toolbox Cocktail (see http://www.cocolab.de). The ADAPTOR distribution provides only the generated sources and not the compiler specifications. Otherwise, it would be necessary to buy and install the compiler toolbox.

We do not provide the compiler specifications of ADAPTOR by public domain. Beside some copyrights, we do not want to have different versions of the ADAPTOR tool. Nevertheless, we can provide the ADAPTOR frontend and backend specifications for people who want to build other tools based on this compiler technology.


5.2 The Makefile

The Makefile will be generated automatically by the configure script from the template file Makefile.in. Therefore the script identifies values for the following variables:

5.3 Successful Compilation

After successful compilation, the following command

    $PHOME/bin/fadapt -settings
    fadapt -settings                ! $PHOME/bin must be in PATH

should print the default settings of the source-to-source translation:

initial configuration read from: /home/brandes/adaptor/.fadaptrc
ADAPTOR runtime features:
  supported INTEGER (kind):  1 2 4 8
  supported LOGICAL (kind):  1 2 4 8
  supported    REAL (kind):  4 8
  Fortran-C interface: int=INTEGER*4, float=REAL*4, void*=INTEGER*4

OPTIONS input source
  enabled directives   : !$ !HPF$ !ADP$ !TRA$ !$OMP
  source format        : fixed form, 72 relevant columns [-fix 72])
  INTEGER              : -> INTEGER*4 (input_int_size)
  REAL                 : -> REAL*4 (-sp, input_real_size)
  semantic checks      : strict

OPTIONS output source
  keep old source      : 0
  target language      : Fortran 90 [-F90]
  source format        : fixed form, 72 relevant columns [-strip 72])
  INTEGER              : <- INTEGER*4 (output_int_size)
  REAL                 : <- REAL*4    (output_real_size)

OPTIONS translation
  translation command  : Fortran translatin [-fortran]
  loop parallelization : NoAuto  [-noauto]
  gen descriptors      : auto [-dsp=auto]
  double arguments     : yes [-args=double]
  pseudo dynamic array : auto [-pseudo=auto]
  profiling routines   : enabled + data [-dataprof]
  optimization         : enabled [-opt]

OPTIONS HPF translation
  HPF mapping          : ignored

OPTIONS OpenMP translation
  OpenMP directives    : ignored

OPTIONS miscellaneous
  verbose = 0, debug = 0, list = 0, warning = 1, info = 1

The different options of fadapt are described in the ADAPTOR User's Guide [Bra04].

    $PHOME/bin/fadapt -settings
    fadapt -settings                ! $PHOME/bin must be in PATH


5.4 Configuration of fadapt

The translation tool fadapt reads a configuration file .fadaptrc every time when it is called. It starts to look for such a file in the $PHOME directory.

      .fadaptrc

As the configuration file contains a lot of machine dependencies, it will be generated automatically with the configure script. The user guide explains the different values in a more detailled manner.

   /*******************************************
   *  support for INTEGER*<K>                 *
   *******************************************/
supported_integer_1=@SUPPORTED_INTEGER_1@
supported_integer_2=@SUPPORTED_INTEGER_2@
supported_integer_4=@SUPPORTED_INTEGER_4@
supported_integer_8=@SUPPORTED_INTEGER_8@
supported_integer_16=0

...

/***************************************************************
*     definition of new options (upper case)                   *
***************************************************************/
-G=-v -debug -list
-HPF=-off:TRA -off:OMP -off: -on:ADP -on:HPF -hpf
-OMP=-on:OMP -on: -off:TRA -off:HPF -omp
-OMP_SIM=-on:OMP -on: -off:TRA -off:HPF -omp -submain=APPL_MAIN
-INSTR=-update -prof:SUB -prof:PAR
-DINSTR=-instr -prof:SUB -prof:DATA -dsp=yes -pseudo=no -args=single


next up previous
Next: 6 The ADAPTOR Runtime Up: ADAPTOR Installation Guide Previous: 4 Configuration of the
Thomas Brandes 2004-03-19