The sources for the transformation tool 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
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.
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:
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
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