AMPI: use ampi compiler wrappers for tests/examples and encourage its use in docs 88/2488/4
authorSam White <white67@illinois.edu>
Wed, 3 May 2017 01:44:07 +0000 (20:44 -0500)
committerRonak Buch <rabuch2@illinois.edu>
Wed, 3 May 2017 20:11:06 +0000 (15:11 -0500)
AMPI's compiler wrappers do more than 'charmc -language ampi', see ampiCC.in

Change-Id: I42f187e2e7089c53a38aad4f57de9875b78959a3

README.ampi
doc/ampi/manual.tex
examples/ampi/alltoall/Makefile
examples/ampi/onesided/Makefile
examples/ampi/pingpong/Makefile
tests/ampi/chkpt/Makefile
tests/ampi/fallreduce/Makefile
tests/ampi/speed/Makefile

index 3d419a329a861b2cc6a8b468b6f60ffedb408088..939563f27666e41d509d8e98bd75d76bc6350b49 100644 (file)
@@ -23,8 +23,7 @@ For example:
 Compiling and Linking AMPI Programs
 -----------------------------------
 AMPI source files can be compiled and linked with the wrappers found
-in bin/, such as ampicc, ampicxx, ampif77, and ampif90, or with
-"charmc -language ampi". For example:
+in bin/, such as ampicc, ampicxx, ampif77, and ampif90:
 
     ampif90 pgm.f90 -o pgm
 
index 00dc19038cacacbbd530a4dfdcb8fa3b6f1ac3bb..542d26e6b7c4a29faeae410edc44d0d3905e7b7f 100644 (file)
@@ -1273,21 +1273,21 @@ See the Projections manual for information on how to visualize traces.
 
 \subsection{Compiling AMPI Programs}
 
-\charmpp{} provides a cross-platform compile-and-link script called \charmc{}
-to compile C, \CC{}, Fortran, \charmpp{} and \ampi{} programs.  This script
+\ampi{} provides a cross-platform compile-and-link script called \emph{ampicc}
+to compile C, \CC{}, and Fortran \ampi{} programs.  This script
 resides in the \texttt{bin} subdirectory in the \charmpp{} installation
 directory. The main purpose of this script is to deal with the differences of
 various compiler names and command-line options across various machines on
-which \charmpp{} runs. It is recommended that \charmc{} or the \ampi{} compiler
+which \ampi{} runs. It is recommended that the \ampi{} compiler
 scripts be used to compile and link \ampi{} programs. One major advantage of
 using these is that one does not have to specify which libraries are to be
 linked for ensuring that \CC{} and Fortran90 codes are linked together
 correctly. Appropriate libraries required for linking such modules together
-are known to \charmc{} for various machines.
+are known to \emph{ampicc} for various machines.
 
-In spite of the platform-neutral syntax of \charmc{}, one may have to specify
+In spite of the platform-neutral syntax of \emph{ampicc}, one may have to specify
 some platform-specific options for compiling and building \ampi{} codes.
-Fortunately, if \charmc{} does not recognize any particular options on its
+Fortunately, if \emph{ampicc} does not recognize any particular options on its
 command line, it promptly passes it to all the individual compilers and linkers
 it invokes to compile the program. See the appendix for more details on
 building and running AMPI programs.
@@ -1354,18 +1354,16 @@ before running a job to override the default specified at build time.
 
 \section{Building and Running AMPI Programs}
 \subsection{Building}
-\charmpp{} provides a compiler called charmc in your charm/bin/ directory.
+\ampi{} provides a compiler called \emph{ampicc} in your charm/bin/ directory.
 You can use this compiler to build your AMPI program the same way as other
-compilers like cc. To build an AMPI program, the command line option
-\emph{-language ampi} should be applied, which the \ampi{} compiler wrappers
-in charm/bin do automatically. All the command line flags that you would use
+compilers like cc. All the command line flags that you would use
 for other compilers can be used with the \ampi{} compilers the same way.
 For example:
 
 \begin{alltt}
 > ampicc -c pgm.c -O3
 > ampif90 -c pgm.f90 -O0 -g
-> charmc -language ampi -o pgm pgm.o -lm -O3 
+> ampicc -o pgm pgm.o -lm -O3 
 \end{alltt}
 
 To use Isomalloc for transparently migrating user heap data, link with
@@ -1381,7 +1379,7 @@ or a suite of strategies in with \emph{-module \textless LB\textgreater}. For ex
 The \charmpp{} distribution contains a script called \texttt{charmrun} that
 makes the job of running \ampi{} programs portable and easier across all
 parallel machines supported by \charmpp{}. \texttt{charmrun} is copied to a
-directory where an \ampi{} program is built using \charmc{}. It takes a command
+directory where an \ampi{} program is built using \emph{ampicc}. It takes a command
 line parameter specifying number of processors, and the name of the program
 followed by \ampi{} options (such as number of ranks to create, and the stack size
 of every user-level thread) and the program arguments. A typical invocation of an \ampi{}
index 5e799ce278cd1fc70310c644c4cb33de263d18c8..d9ec7e0289e5c153174f6acb36c29b0198a2693e 100644 (file)
@@ -1,5 +1,6 @@
 OPTS = -O3
-CHARMC = ../../../bin/charmc -language ampi
+CHARMC = ../../../bin/ampicc
+CHARMF = ../../../bin/ampif90
 MPICC = mpicc
 
 all: mpibench mpibench.mpi
@@ -33,8 +34,8 @@ alltoall_VPtest: alltoall_VPtest.c
        $(CHARMC) -o alltoall_VPtest alltoall_VPtest.o $(OPTS) $(LIBS)
 
 alltoall_VPtest_f: alltoall_VPtest.f
-       $(CHARMC) -c alltoall_VPtest.f  -language ampif -swapglobals  $(OPTS)
-       $(CHARMC) -o alltoall_VPtest_f alltoall_VPtest.o -language ampif -swapglobals $(OPTS) $(LIBS)
+       $(CHARMF) -c alltoall_VPtest.f -swapglobals  $(OPTS)
+       $(CHARMF) -o alltoall_VPtest_f alltoall_VPtest.o -swapglobals $(OPTS) $(LIBS)
 
 clean:
        rm -rf *~ *.o alltoall mpibench charmrun conv-host allgather
index 2fd954a6f32ef050bd26b2f0be27fdaeeb9eacd0..2f4256122f3a41727e7badf75066fbfdc45c1f1f 100644 (file)
@@ -1,17 +1,17 @@
 -include ../../common.mk
 OPTS=-O3
 CHARMBASE=../../../
-CHARMC=../../../bin/charmc -language ampi $(OPTS)
+CHARMC=../../../bin/ampicxx $(OPTS)
 MPICC=mpicc $(OPTS)
 TOKENS=6
 
 all: GetPutTest IgetTest
 
 GetPutTest: GetPutTest.C
-       $(CHARMC) GetPutTest.C -language ampi  -o GetPutTest
+       $(CHARMC) GetPutTest.C -o GetPutTest
 #      $(MPICC) GetPutTest.C -o GetPutTest-mpi
 IgetTest: IgetTest.C
-       $(CHARMC) IgetTest.C -language ampi  -o IgetTest
+       $(CHARMC) IgetTest.C -o IgetTest
 
 IgetTest-tokens:
        cd $(CHARMBASE)/tmp; touch machine.c; touch ckfutures.C; make AMPI OPTS="-DIGET_FLOWCONTROL=1 -DIGET_TOKENNUM=$(TOKENS) $(OPTS)"; cd -;
index 793572f558876d3101e26b5b5cd19ba17a4ec1bb..bbf097ea8ddd3a99dde648e26a7bbf0e22bc3ce7 100644 (file)
@@ -1,6 +1,6 @@
 -include ../../common.mk
 OPTS=-O3 
-CHARMC=../../../bin/charmc -language ampi $(OPTS)
+CHARMC=../../../bin/ampicxx $(OPTS)
 MPICC=mpicc $(OPTS)
 
 #all : pingpong-2way.c
index 2d65e89c4d69ebc22ee2f4a48af9b754e7cb8713..4359a2ef91b4a97c3ea45d400c2faa4f83014ee0 100644 (file)
@@ -1,5 +1,5 @@
 -include ../../common.mk
-CHARMC=../../../bin/charmc
+CHARMC=../../../bin/ampicc
 
 all: hello
 
index db5c876bf23c2b23c708f4248f1b7443907c7663..71c66061d56dcd451c71312a487ba0790c363934 100644 (file)
@@ -1,10 +1,10 @@
 -include ../../common.mk
-CHARMC=../../../bin/charmc $(OPTS)
+CHARMC=../../../bin/ampif90 $(OPTS)
 
 all: pgm
 
 pgm: pgm.o
-       $(CHARMC) -o pgm pgm.o -language ampif
+       $(CHARMC) -o pgm pgm.o
 
 pgm.o: pgm.f90
        $(CHARMC) -c pgm.f90
index b0243d637915fea7f8f5469c41f77cb8b020d0bd..370cb405d7f83eb9749e061b163d7872f3845aea 100644 (file)
@@ -1,12 +1,12 @@
 -include ../../common.mk
-CHARMC=../../../bin/charmc $(OPTS)
+CHARMC=../../../bin/ampicxx $(OPTS)
 
 OBJS = hello.o msgspeed.o test_mpi.o
 
 all: hello
 
 hello: $(OBJS)
-       $(CHARMC) -language charm++ -module ampi -o hello $(OBJS)
+       $(CHARMC) -language charm++ -o hello $(OBJS)
 
 hello.decl.h: hello.ci
        $(CHARMC)  hello.ci