7 The ADAPTOR Compiler Driver

The sources for the compiler driver are stored in the subdirectory src1. The sources are all written in C and should run on all UNIX machines.

The executable adaptor for the driver is generated by simply typing .

   cd $PHOME/src1
   make

7.1 Configuration of the Compiler Driver

The comiler driver 6#1adaptor reads a configuration file .adaptorrc every time when it is called. It starts to look for such a file in the $PHOME directory where such a file is provided with the installation of ADAPTOR. This file will be automatically generated by the installation script configure. In the following, the different entries are explained.

• The MPI library is needed for the HPF runtime system if distributed memory parallelism is exploited. The necessary flags for linking the MPI library are specified with the entry DM:mpi.

  DM:mpi = @MPI_LIB@       
  DM:mpi = -L/opt/mpich/lib -lpmpich -lmpich -lpmpich
  DM:mpi = -F:mpxlf -L/usr/lpp/ppe.poe/lib -lmpi         ! IBM SP
  

• The PThreads library is needed for the HPF runtime system if shared memory parallelism is exploited. The necessary flags for linking the PThreads library are specified with the entry SM:pthreads.

  SM:pthreads = @THR_LIB@
  SM:pthreads = -lpthread
  

• The ADAPTOR runtime system provides performance monitoring support for all kind of programs. If access to hardware performance counters is needed, PAPI and/or PCL can be exploited.

  PM:papi = @PAPI_LIB@
  PM:papi = -lpapi
  PM:papi = -L/uhome/scaibran/papi-2.3.4.3/src/ -lpapi -L/usr/pmapi/lib -lpmapi
  PM:pcl  = @PCL_LIB@
  PM:pcl  = -lpcl
  PM:pcl  = -L/uhome/scaibran/pcl_2.2/bin/powerpc-ibm-aix5.1.0.0 -lpcl -lpmapi
  

  It is possible to use other hardware performance counter libraries by specifying PM:<name> = <pm_lib>. But then it is necessary to realize also a new LIBADP interface lib_pm_<name>.

  PM:hpm  = -lhpm    # lib_pm_hpm.a must availalbe as runtime support
  

• ADAPTOR supports tracing of serial and parallel programs with VampirTrace. This feature has not been tested well on many platforms but it should be simple to specifiy the correct flags for linking here.

  TRACE:vt =-L/opt/vampirtrace-3.1.0.3/lib -lVT -ldwarf -lnsl -lm -lelf -lpthread
  TRACE:vtsample =-L/opt/vampirtrace-3.1.0.3/lib -lVTsample -lVT -ldwarf -lnsl -lm -lelf -lpthrea
  d
  TRACE:vtsp =-L/opt/vampirtrace-3.1.0.3/lib -lVTsp -ldwarf -lnsl -lm -lelf -lpthread
  

• The entry FC specifies the native Fortran compiler to be used for Fortran compilation.

     FC=f77
  

• The entry FC_FREE specifies the flag to be used for the Fortran compilation with free source format.

     FC_FREE=-qfree
  

• The entry FC_EXTEND specifies the compilation flag for extended source format and FC_EXTEND_LENGHT the corresponding number of relevant columnns.

     FC_EXTEND=-qfixed=132
     FC_EXTEND_LENGTH=132
  

• The entry FC_OPT specifies the optimization flag to be used.

     FC_OPT=-O3 -qstrict
  

• The entry FC_MP should specify the flag that guarantees that local variables are put on the stack.

     FC_MP=-qnosave
  

• Additional flags can be specified via FC_FLAGS.

     FC_FLAGS=-w
  

• The entry LD specifies the linker. It should be the same as the Fortran compiler as it guarantees that the link step will find the Fortran runtime libraries.

     LD=f77
  

• Via LD_FLAGS it is possible to specifiy additional libraries to be linked. Very common is the possibility that the native Fortran compiler might not be able to find C libraries in the link step.

    LD_FLAGS=-L/opt/sfw/lib/gcc-lib/sparc-sun-solaris2.9/2.95.3/ -lgcc
  

In the configuration file, there is also the possibility to define compound flags that make any kind of ADAPTOR compilation more convenient. Some compound flags are already defined and should not be modified at all as they are needed for the test and example programs:

• compiling HPF programs for a serial model

  -hpf_1=-Wa"-HPF"
  

• compiling HPF programs for a parallel model

  -hpf=-Wa"-HPF" -hpflib
  

• compiling OpenMP programs

  -omp=-Wa"-OMP"
  

• compiling for a distributed memory machine using MPI (HPF only):

  -dm=-Wa"-dm" -dm=mpi
  

• compiling for shared memory parallelism (exploiting PThreads):

  -sm=-Wa"-sm" -sm=pthreads
  

• compiling for cache blocking (emulation of processors):

  -cb=-Wa"-cb"
  

• compiling OpenMP programs for shared memory parallelism:

  -openmp=-Wa"-OMP -sm" -sm=pthreads
  

You get help and info about the actual configuration settings of adaptor with the commands:

      adaptor -help
      adaptor -settings

The flag -settings can be used in combination with other flags to get an overview of all flags and libraries that will be used for an ADAPTOR compilation.

  $  adaptor -openmp -pm=papi -trace=vt -settings
   ...
   current settings for driver: verbose = 0, dryrun = 0, keep = 0
      CPP_FLAGS        : -P -traditional
      FADAPT_FLAGS     : -omp -1
      FC_FLAGS         : -w -O
      LD_FLAGS (dalib) : -ladp_hpf_null -ladp_dm_null -ladp_sm_pthreads 
                         -ladp_pm_papi -ladp_trace_vt
      LD_FLAGS (user)  : -lpthread -lpapi -L/opt/vampirtrace-3.1.0.3/lib 
                         -lVT -ldwarf -lnsl -lm -lelf -lpthread -lPEPCF90