reorganizing into trunk,tag, branch directories

git-svn-id: https://svn.mcs.anl.gov/repos/darshan/trunk@21 3b7491f3-a168-0410-bf4b-c445ed680a29

INSTALL

+Compile and install example for BG/P:
+-------------------------------------
+
+# adjust these paths to suit
+export PREFIX=/home/carns/demo/install
+export LOGPATH=/home/carns/demo
+
+# configuring, compiling, and installing darshan
+./configure --with-mem-align=16 --with-log-path=$LOGPATH --prefix=$PREFIX CFLAGS="-O2"
+make
+make install
+
+# configuring, compiling, and installing libz for compute nodes
+cd extern
+tar -vxzf zlib-1.2.3.tar.gz
+cd zlib-1.2.3
+CC=/bgsys/drivers/ppcfloor/gnu-linux/bin/powerpc-bgp-linux-gcc CFLAGS="-O2" ./configure
+make
+cp libz.a $PREFIX/lib/
+
+Explanation of configure arguments:
+--------------------
+
+--with-log-path (manditory): specifies the directory where all of the
+application log files will be written.  
+
+--prefix (manditory): where compiler scripts and darshan libraries will be
+installed.
+
+--with-mem-align (manditory): memory alignment for the architecture you are
+building for; 16 is an interesting value on BG/P because that is the optimal
+alignment for tree network communication.
+
+Setting up the log directory
+----------------------------
+
+# create the directory that you specified in the --with-log-path argument to
+# configure (if it does not already exist)
+mkdir $LOGPATH
+# run a darshan script (no arguments needed) that will create subdirectories
+# for darshan to place output in.  The subdirectories are structured in
+# <year>/<month>/<day> format.  The last subdirectories will have the sticky 
+# bit set (1777 permissions, like /tmp) so that multiple users can write log
+# files to the same directories.
+darshan-mk-log-dirs.pl
+
+Using darshan:
+-------
+Once darshan is installed, compile your applications using the
+appropriate compiler from <prefix>/bin.  These compilers only modify the
+link steps.  If you have a previously compiled application you can simply
+relink it using the darshan compilers rather than recompiling from scratch.
+
+Example:
+
+install/bin/mpicc mpi-io-test.c -o mpi-io-test
+
+The log files that darshan generates at run time will be in
+a binary format with native gzip compression.  To get a human
+readable version of the log file, use the "$PREFIX/bin/darshan-parser
+$LOGPATH/<log_file_name>" utility from the bin directory.
+
+To generate some automatic graphs, go to the "utils" directory of the
+source tree and run "./darshan-aggregate-stats.pl" on a text file that
+contains the output from darshan-parser.  That perl script will generate
+a summary.pdf file with some graphs in it.  You will need pdflatex and
+a version of gnuplot with pdf support to use it.
+
+

Makefile.in

+all: checkpath lib/libdarshan-posix.a lib/libdarshan-mpi-io.a darshan-parser darshan-diff test/gztest test/gz-bench 
+
+DESTDIR =
+srcdir = @srcdir@
+prefix = @prefix@
+datarootdir = @datarootdir@
+exec_prefix = @exec_prefix@
+includedir = $(DESTDIR)@includedir@
+mandir = $(DESTDIR)@mandir@
+sbindir = $(DESTDIR)@sbindir@
+bindir = $(DESTDIR)@bindir@
+libdir = $(DESTDIR)@libdir@
+
+VPATH = $(srcdir)
+
+darshan_lib_path = @darshan_lib_path@
+
+CFLAGS = -I . -I $(srcdir) @CFLAGS@ @CPPFLAGS@ -D_FILE_OFFSET_BITS=64 -D_LARGEFILE64_SOURCE -Wall
+CC=@MPICC@
+LD=@MPICC@
+
+checkpath::
+ifneq ($(darshan_lib_path),$(libdir)) 
+	@echo "Error: <libdir> must match <prefix>/lib, don't use --libdir!"
+	@exit 1
+endif
+
+mklibdir::
+	mkdir -p lib
+
+mktestdir::
+	mkdir -p test
+
+darshan-parser: darshan-parser.c darshan.h darshan-log-format.h
+	gcc $(CFLAGS) -lz $< -o $@
+
+darshan-diff: darshan-diff.o darshan.h darshan-log-format.h darshan-logutils.o darshan-logutils.h
+	gcc $(CFLAGS) -lz $< darshan-logutils.o -o $@
+darshan-diff.o: darshan-diff.c
+	gcc $(CFLAGS) -c  $< -o $@
+darshan-logutils.o: darshan-logutils.c
+	gcc $(CFLAGS) -c  $< -o $@
+
+test/gztest: test/gztest.c mktestdir
+	gcc $(CFLAGS) -lz $< -o $@
+
+test/gz-bench: test/gz-bench.c mktestdir
+	gcc $(CFLAGS) -lz $< -o $@
+
+lib/darshan-mpi-io.o: darshan.h darshan-log-format.h mklibdir
+
+lib/darshan-posix.o: darshan.h darshan-log-format.h mklibdir
+
+lookup3.o: lookup3.c
+
+lookup8.o: lookup8.c
+
+lib/libdarshan-mpi-io.a: lib/darshan-mpi-io.o
+	ar rcs $@ $^
+
+lib/libdarshan-posix.a: lib/darshan-posix.o lib/lookup3.o lib/lookup8.o
+	ar rcs $@ $^
+
+install:: all
+	install -d $(libdir)
+	install -m 755 lib/libdarshan-posix.a $(libdir)
+	install -m 755 lib/libdarshan-mpi-io.a $(libdir)
+	install -d $(bindir)
+	install -m 755 darshan-parser $(bindir)
+	install -m 755 darshan-mk-log-dirs.pl $(bindir)
+	install -m 755 compilers/mpicc-trace-bgp $(bindir)/mpicc
+	install -m 755 compilers/mpicxx-trace-bgp $(bindir)/mpicxx
+	install -m 755 compilers/mpif77-trace-bgp $(bindir)/mpif77
+	install -m 755 compilers/mpif90-trace-bgp $(bindir)/mpif90
+	install -m 755 compilers/mpixlc-trace-bgp $(bindir)/mpixlc
+	install -m 755 compilers/mpixlcxx-trace-bgp $(bindir)/mpixlcxx
+	install -m 755 compilers/mpixlf2003-trace-bgp $(bindir)/mpixlf2003
+	install -m 755 compilers/mpixlf77-trace-bgp $(bindir)/mpixlf77
+	install -m 755 compilers/mpixlf90-trace-bgp $(bindir)/mpixlf90
+
+clean::
+	rm -f *.o *.a lib/*.o lib/*.a darshan-parser darshan-diff

compilers/mpicc-trace-bgp.in

+#! /bin/sh
+# 
+# (C) 2006 by Argonne National Laboratory.
+#     See COPYRIGHT in top-level directory.
+#
+# mpicc
+# Simple script to compile and/or link MPI programs.
+# This script knows the default flags and libraries, and can handle
+# alternative C compilers and the associated flags and libraries.
+# The important terms are:
+#    includedir, libdir - Directories containing an *installed* mpich2
+#    prefix, execprefix - Often used to define includedir and libdir
+#    CC                 - C compiler
+#    WRAPPER_CFLAGS        - Any special flags needed to compile 
+#    WRAPPER_LDFLAGS       - Any special flags needed to link
+#    MPILIBNAME         - Name of the MPI library
+#    MPI_OTHERLIBS      - Other libraries needed in order to link 
+#    
+# We assume that (a) the C compiler can both compile and link programs
+#
+# Handling of command-line options:
+#   This is a little tricky because some options may contain blanks.
+#
+# Special issues with shared libraries - todo
+#
+# --------------------------------------------------------------------------
+# Set the default values of all variables.
+#
+# Directory locations: Fixed for any MPI implementation.
+# Set from the directory arguments to configure (e.g., --prefix=/usr/local)
+prefix=/bgsys/drivers/V1R3M0_460_2008-081112P/ppc/comm/default
+exec_prefix=${prefix}
+sysconfdir=${prefix}/etc
+includedir=${prefix}/include
+libdir=${exec_prefix}/lib
+
+CP_WRAPPERS=@CP_WRAPPERS@
+DARSHAN_LIB_PATH=@darshan_lib_path@
+
+#
+# Default settings for compiler, flags, and libraries.
+# Determined by a combination of environment variables and tests within
+# configure (e.g., determining whehter -lsocket is needee)
+CC=" /bgsys/drivers/V1R3M0_460_2008-081112P/ppc/gnu-linux/bin/powerpc-bgp-linux-gcc"
+C_LINKPATH_SHL="-Wl,-rpath,"
+WRAPPER_CFLAGS="-I/bgsys/drivers/V1R3M0_460_2008-081112P/ppc/comm/sys/include"
+WRAPPER_LDFLAGS="${CP_WRAPPERS}"
+MPILIBNAME="mpich.cnk"
+PMPILIBNAME="pmpich.cnk"
+MPI_OTHERLIBS=" -L/bgsys/drivers/V1R3M0_460_2008-081112P/ppc/comm/sys/lib -Wl,-rpath,/bgsys/drivers/V1R3M0_460_2008-081112P/ppc/comm/sys/lib -ldcmfcoll.cnk      -ldcmf.cnk      -lpthread -L/bgsys/drivers/V1R3M0_460_2008-081112P/ppc/runtime/SPI -Wl,-rpath,/bgsys/drivers/V1R3M0_460_2008-081112P/ppc/runtime/SPI -lSPI.cna -lrt -L${DARSHAN_LIB_PATH} -ldarshan-posix "
+NEEDSPLIB="no"
+# MPIVERSION is the version of the MPICH2 library that mpicc is intended for
+MPIVERSION="1.0.7"
+#
+# Internal variables
+# Show is set to echo to cause the compilation command to be echoed instead 
+# of executed.
+Show=
+#
+# End of initialization of variables
+#---------------------------------------------------------------------
+# Environment Variables.
+# The environment variables MPICH_CC may be used to override the 
+# default choices.
+# In addition, if there is a file $sysconfdir/mpicc-$CCname.conf, 
+# where CCname is the name of the compiler with all spaces replaced by hyphens
+# (e.g., "cc -64" becomes "cc--64", that file is sources, allowing other
+# changes to the compilation environment.  See the variables used by the 
+# script (defined above)
+if [ -n "$MPICH_CC" ] ; then
+    CC="$MPICH_CC"
+    CCname=`echo $CC | sed 's/ /-/g'`
+    if [ -s $sysconfdir/mpicc-$CCname.conf ] ; then
+        . $sysconfdir/mpicc-$CCname.conf
+    fi
+fi
+# Allow a profiling option to be selected through an environment variable
+if [ -n "$MPICC_PROFILE" ] ; then
+    profConf=$MPICC_PROFILE
+fi
+#
+# ------------------------------------------------------------------------
+# Argument processing.
+# This is somewhat awkward because of the handling of arguments within
+# the shell.  We want to handle arguments that include spaces without 
+# loosing the spacing (an alternative would be to use a more powerful
+# scripting language that would allow us to retain the array of values, 
+# which the basic (rather than enhanced) Bourne shell does not.  
+#
+# Look through the arguments for arguments that indicate compile only.
+# If these are *not* found, add the library options
+
+linking=yes
+allargs=("$@")
+argno=0
+for arg in "$@" ; do
+    # Set addarg to no if this arg should be ignored by the C compiler
+    addarg=yes
+    case "$arg" in 
+ 	# ----------------------------------------------------------------
+	# Compiler options that affect whether we are linking or no
+    -c|-S|-E|-M|-MM)
+    # The compiler links by default
+    linking=no
+    ;;
+	# ----------------------------------------------------------------
+	# Options that control how we use mpicc (e.g., -show, 
+	# -cc=* -config=*
+    -echo)
+    addarg=no
+    set -x
+    ;;
+    -cc=*)
+    CC=`echo A$arg | sed -e 's/A-cc=//g'`
+    addarg=no
+    ;;
+    -show)
+    addarg=no
+    Show=echo
+    ;;
+    -config=*)
+    addarg=no
+    CCname=`echo A$arg | sed -e 's/A-config=//g'`
+    if [ -s "$sysconfdir/mpicc-$CCname.conf" ] ; then
+        . "$sysconfdir/mpicc-$CCname.conf"
+    else
+	echo "Configuration file mpicc-$CCname.conf not found"
+    fi
+    ;;
+    -compile-info|-compile_info)
+    # -compile_info included for backward compatibility
+    Show=echo
+    addarg=no
+    ;;
+    -link-info|-link_info)
+    # -link_info included for backward compatibility
+    Show=echo
+    addarg=no
+    ;;
+    -v)
+    # Pass this argument to the compiler as well.
+    echo "mpicc for $MPIVERSION"
+    linking=no
+    ;;
+    -profile=*)
+    # Pass the name of a profiling configuration.  As
+    # a special case, lib<name>.so or lib<name>.la may be used
+    # if the library is in $libdir
+    profConf=`echo A$arg | sed -e 's/A-profile=//g'`
+    addarg=no
+    # Loading the profConf file is handled below
+    ;;
+    -mpe=*)
+    # Pass the name of a profiling configuration; this is a special
+    # case for the MPE libs.  See -profile
+    profConf=`echo A$arg | sed -e 's/A-mpe=//g'`
+    profConf="mpe_$profConf"
+    addarg=no
+    # Loading the profConf file is handled below
+    ;;
+	# -help
+    -help)
+    ;;
+    *)
+    ;;
+
+    esac
+    if [ $addarg = no ] ; then
+	unset allargs[$argno]
+    fi
+    # Some versions of bash do not accept ((argno++))
+    argno=`expr $argno + 1`
+done
+
+# -----------------------------------------------------------------------
+# Derived variables.  These are assembled from variables set from the
+# default, environment, configuration file (if any) and command-line
+# options (if any)
+if [ "$NEEDSPLIB" = yes ] ; then
+    mpilibs="-l$PMPILIBNAME -l$MPILIBNAME"
+else
+    mpilibs="-l$MPILIBNAME"
+fi
+#
+# Init with the ones needed by MPI
+CFLAGS="$WRAPPER_CFLAGS"
+LDFLAGS="$WRAPPER_LDFLAGS"
+#
+# Handle the case of a profile switch
+if [ -n "$profConf" ] ; then
+    profConffile=
+    if [ -s "$libdir/lib$profConf.a" -o -s "$libdir/lib$profConf.so" ] ; then
+	mpilibs="-l$profConf $mpilibs"
+    elif [ -s "$sysconfdir/$profConf.conf" ] ; then
+	profConffile="$sysconfdir/$profConf.conf"
+    elif [ -s "$profConf.conf" ] ; then
+        profConffile="$profConf.conf"
+    else
+        echo "Profiling configuration file $profConf.conf not found in $sysconfdir"
+    fi
+    if [ -n "$profConffile" -a -s "$profConffile" ] ; then
+	. $profConffile
+	if [ -n "$PROFILE_INCPATHS" ] ; then
+	    CFLAGS="$PROFILE_INCPATHS $CFLAGS"
+        fi
+        if [ -n "$PROFILE_PRELIB" ] ; then
+	    mpilibs="$PROFILE_PRELIB $mpilibs"
+        fi
+        if [ -n "$PROFILE_POSTLIB" ] ; then
+	    mpilibs="$mpilibs $PROFILE_POSTLIB"
+        fi
+    fi
+fi
+
+# -----------------------------------------------------------------------
+#
+# A temporary statement to invoke the compiler
+# Place the -L before any args incase there are any mpi libraries in there.
+# Eventually, we'll want to move this after any non-MPI implementation 
+# libraries.
+# We use a single invocation of the compiler.  This will be adequate until
+# we run into a system that uses a separate linking command.  With any luck,
+# such archaic systems are no longer with us.  This also lets us
+# accept any argument; we don't need to know if we've seen a source
+# file or an object file.  Instead, we just check for an option that
+# suppressing linking, such as -c or -M.
+if [ "$linking" = yes ] ; then
+    if [ -n "$C_LINKPATH_SHL" ] ; then
+	# prepend the path for the shared libraries to the library list
+	mpilibs="$C_LINKPATH_SHL$libdir $mpilibs"
+    fi
+    $Show $CC "${allargs[@]}"  -L${DARSHAN_LIB_PATH} -ldarshan-mpi-io -lz -I$includedir $CFLAGS $LDFLAGS -L$libdir $mpilibs $MPI_OTHERLIBS
+    rc=$?
+else
+    $Show $CC "${allargs[@]}" -I$includedir $CFLAGS 
+    rc=$?
+fi
+
+exit $rc

compilers/mpicc-trace-pcarns.in

+#! /bin/bash
+# 
+# (C) 2006 by Argonne National Laboratory.
+#     See COPYRIGHT in top-level directory.
+#
+# mpicc
+# Simple script to compile and/or link MPI programs.
+# This script knows the default flags and libraries, and can handle
+# alternative C compilers and the associated flags and libraries.
+# The important terms are:
+#    includedir, libdir - Directories containing an *installed* mpich2
+#    prefix, execprefix - Often used to define includedir and libdir
+#    CC                 - C compiler
+#    WRAPPER_CFLAGS        - Any special flags needed to compile 
+#    WRAPPER_LDFLAGS       - Any special flags needed to link
+#    MPILIBNAME         - Name of the MPI library
+#    MPI_OTHERLIBS      - Other libraries needed in order to link 
+#    
+# We assume that (a) the C compiler can both compile and link programs
+#
+# Handling of command-line options:
+#   This is a little tricky because some options may contain blanks.
+#
+# Special issues with shared libraries - todo
+#
+# --------------------------------------------------------------------------
+# Set the default values of all variables.
+#
+# Directory locations: Fixed for any MPI implementation.
+# Set from the directory arguments to configure (e.g., --prefix=/usr/local)
+prefix=/usr/local
+exec_prefix=${prefix}
+sysconfdir=${prefix}/etc
+includedir=/home/pcarns/working/mpich2/build-ufs-fortran-1.0.7/src/include
+libdir=/home/pcarns/working/mpich2/build-ufs-fortran-1.0.7/lib
+
+CP_WRAPPERS=@CP_WRAPPERS@
+DARSHAN_LIB_PATH=@darshan_lib_path@
+
+#
+# Default settings for compiler, flags, and libraries.
+# Determined by a combination of environment variables and tests within
+# configure (e.g., determining whehter -lsocket is needee)
+CC="ccache gcc"
+C_LINKPATH_SHL=""
+WRAPPER_CFLAGS=" " 
+WRAPPER_LDFLAGS="-lrt ${CP_WRAPPERS}"
+MPILIBNAME="mpich"
+PMPILIBNAME="pmpich"
+MPI_OTHERLIBS="-lpthread  -lrt    -lrt  -L${DARSHAN_LIB_PATH} -ldarshan-posix  "
+NEEDSPLIB="no"
+# MPIVERSION is the version of the MPICH2 library that mpicc is intended for
+MPIVERSION="1.0.7"
+#
+# Internal variables
+# Show is set to echo to cause the compilation command to be echoed instead 
+# of executed.
+Show=
+#
+# End of initialization of variables
+#---------------------------------------------------------------------
+# Environment Variables.
+# The environment variables MPICH_CC may be used to override the 
+# default choices.
+# In addition, if there is a file $sysconfdir/mpicc-$CCname.conf, 
+# where CCname is the name of the compiler with all spaces replaced by hyphens
+# (e.g., "cc -64" becomes "cc--64", that file is sources, allowing other
+# changes to the compilation environment.  See the variables used by the 
+# script (defined above)
+if [ -n "$MPICH_CC" ] ; then
+    CC="$MPICH_CC"
+    CCname=`echo $CC | sed 's/ /-/g'`
+    if [ -s $sysconfdir/mpicc-$CCname.conf ] ; then
+        . $sysconfdir/mpicc-$CCname.conf
+    fi
+fi
+# Allow a profiling option to be selected through an environment variable
+if [ -n "$MPICC_PROFILE" ] ; then
+    profConf=$MPICC_PROFILE
+fi
+#
+# ------------------------------------------------------------------------
+# Argument processing.
+# This is somewhat awkward because of the handling of arguments within
+# the shell.  We want to handle arguments that include spaces without 
+# loosing the spacing (an alternative would be to use a more powerful
+# scripting language that would allow us to retain the array of values, 
+# which the basic (rather than enhanced) Bourne shell does not.  
+#
+# Look through the arguments for arguments that indicate compile only.
+# If these are *not* found, add the library options
+
+linking=yes
+allargs=("$@")
+argno=0
+for arg in "$@" ; do
+    # Set addarg to no if this arg should be ignored by the C compiler
+    addarg=yes
+    case "$arg" in 
+ 	# ----------------------------------------------------------------
+	# Compiler options that affect whether we are linking or no
+    -c|-S|-E|-M|-MM)
+    # The compiler links by default
+    linking=no
+    ;;
+	# ----------------------------------------------------------------
+	# Options that control how we use mpicc (e.g., -show, 
+	# -cc=* -config=*
+    -echo)
+    addarg=no
+    set -x
+    ;;
+    -cc=*)
+    CC=`echo A$arg | sed -e 's/A-cc=//g'`
+    addarg=no
+    ;;
+    -show)
+    addarg=no
+    Show=echo
+    ;;
+    -config=*)
+    addarg=no
+    CCname=`echo A$arg | sed -e 's/A-config=//g'`
+    if [ -s "$sysconfdir/mpicc-$CCname.conf" ] ; then
+        . "$sysconfdir/mpicc-$CCname.conf"
+    else
+	echo "Configuration file mpicc-$CCname.conf not found"
+    fi
+    ;;
+    -compile-info|-compile_info)
+    # -compile_info included for backward compatibility
+    Show=echo
+    addarg=no
+    ;;
+    -link-info|-link_info)
+    # -link_info included for backward compatibility
+    Show=echo
+    addarg=no
+    ;;
+    -v)
+    # Pass this argument to the compiler as well.
+    echo "mpicc for $MPIVERSION"
+    linking=no
+    ;;
+    -profile=*)
+    # Pass the name of a profiling configuration.  As
+    # a special case, lib<name>.so or lib<name>.la may be used
+    # if the library is in $libdir
+    profConf=`echo A$arg | sed -e 's/A-profile=//g'`
+    addarg=no
+    # Loading the profConf file is handled below
+    ;;
+    -mpe=*)
+    # Pass the name of a profiling configuration; this is a special
+    # case for the MPE libs.  See -profile
+    profConf=`echo A$arg | sed -e 's/A-mpe=//g'`
+    profConf="mpe_$profConf"
+    addarg=no
+    # Loading the profConf file is handled below
+    ;;
+	# -help
+    -help)
+    ;;
+    *)
+    ;;
+
+    esac
+    if [ $addarg = no ] ; then
+	unset allargs[$argno]
+    fi
+    # Some versions of bash do not accept ((argno++))
+    argno=`expr $argno + 1`
+done
+
+# -----------------------------------------------------------------------
+# Derived variables.  These are assembled from variables set from the
+# default, environment, configuration file (if any) and command-line
+# options (if any)
+if [ "$NEEDSPLIB" = yes ] ; then
+    mpilibs="-l$PMPILIBNAME -l$MPILIBNAME"
+else
+    mpilibs="-l$MPILIBNAME"
+fi
+#
+# Init with the ones needed by MPI
+CFLAGS="$WRAPPER_CFLAGS"
+LDFLAGS="$WRAPPER_LDFLAGS"
+#
+# Handle the case of a profile switch
+if [ -n "$profConf" ] ; then
+    profConffile=
+    if [ -s "$libdir/lib$profConf.a" -o -s "$libdir/lib$profConf.so" ] ; then
+	mpilibs="-l$profConf $mpilibs"
+    elif [ -s "$sysconfdir/$profConf.conf" ] ; then
+	profConffile="$sysconfdir/$profConf.conf"
+    elif [ -s "$profConf.conf" ] ; then
+        profConffile="$profConf.conf"
+    else
+        echo "Profiling configuration file $profConf.conf not found in $sysconfdir"
+    fi
+    if [ -n "$profConffile" -a -s "$profConffile" ] ; then
+	. $profConffile
+	if [ -n "$PROFILE_INCPATHS" ] ; then
+	    CFLAGS="$PROFILE_INCPATHS $CFLAGS"
+        fi
+        if [ -n "$PROFILE_PRELIB" ] ; then
+	    mpilibs="$PROFILE_PRELIB $mpilibs"
+        fi
+        if [ -n "$PROFILE_POSTLIB" ] ; then
+	    mpilibs="$mpilibs $PROFILE_POSTLIB"
+        fi
+    fi
+fi
+
+# -----------------------------------------------------------------------
+#
+# A temporary statement to invoke the compiler
+# Place the -L before any args incase there are any mpi libraries in there.
+# Eventually, we'll want to move this after any non-MPI implementation 
+# libraries.
+# We use a single invocation of the compiler.  This will be adequate until
+# we run into a system that uses a separate linking command.  With any luck,
+# such archaic systems are no longer with us.  This also lets us
+# accept any argument; we don't need to know if we've seen a source
+# file or an object file.  Instead, we just check for an option that
+# suppressing linking, such as -c or -M.
+if [ "$linking" = yes ] ; then
+    if [ -n "$C_LINKPATH_SHL" ] ; then
+	# prepend the path for the shared libraries to the library list
+	mpilibs="$C_LINKPATH_SHL$libdir $mpilibs"
+    fi
+    $Show $CC $CFLAGS $LDFLAGS "${allargs[@]}"  -L${DARSHAN_LIB_PATH} -ldarshan-mpi-io -lz -I$includedir -L$libdir $mpilibs $MPI_OTHERLIBS
+    rc=$?
+else
+    $Show $CC $CFLAGS "${allargs[@]}" -I$includedir
+    rc=$?