[Darshan-commits] [Darshan] branch, master, updated. darshan-2.3.1-pre2-13-gbcb8d88

[Service Account]

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "".

The branch, master has been updated
       via  bcb8d88ffcfca049e7a6ca5b18f37a660cb7a801 (commit)
      from  dbd2b689af83e45ac1fed2778b6f067b8b7797b0 (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
commit bcb8d88ffcfca049e7a6ca5b18f37a660cb7a801
Author: Phil Carns <carns at mcs.anl.gov>
Date:   Fri Mar 13 12:49:44 2015 -0400

    document profiling conf file method on BG

-----------------------------------------------------------------------

Summary of changes:
 darshan-runtime/doc/darshan-runtime.txt |   21 +++++++++++++++++----
 1 files changed, 17 insertions(+), 4 deletions(-)


Diff of changes:
diff --git a/darshan-runtime/doc/darshan-runtime.txt b/darshan-runtime/doc/darshan-runtime.txt
index 2996a1e..e5f4a82 100644
--- a/darshan-runtime/doc/darshan-runtime.txt
+++ b/darshan-runtime/doc/darshan-runtime.txt
@@ -153,6 +153,7 @@ the darshan-enabled MPI compiler scripts.
 
 === Using a profile configuration 
 
+[[static-prof]]
 The MPICH MPI implementation supports the specification of a profiling library
 configuration, then it can be used to insert Darshan instrumentation without
 modifying the existing MPI compiler script.  Example profiling configuration
@@ -185,6 +186,7 @@ mpif90 -profile=$DARSHAN_PREFIX/share/mpi-profile/darshan-f <args>
 
 === Using customized compiler wrapper scripts
 
+[[static-wrapper]]
 For MPICH-based MPI libraries, such as MPICH1, MPICH2, or MVAPICH,
 custom wrapper scripts can be generated to automatically include Darshan
 instrumentation.  The following example illustrates how to produce
@@ -283,10 +285,21 @@ than the login node.  The `--host` argument is used to force cross-compilation
 of Darshan.  The `CC` variable is set to point to a stock MPI compiler.
 ====
 
-Once Darshan has been installed, use the `darshan-gen-*.pl` scripts as
-described earlier in this document to produce darshan-enabled MPI compilers.
-This method has been widely used and tested with both the GNU and IBM XL
-compilers.
+Once Darshan has been installed, you can use one of the static
+instrumentation methods described earlier in this document.  If you
+use the profiling configuration file method, then please note that the
+Darshan installation includes profiling configuration files that have been
+adapted specifically for the Blue Gene environment.  Set the following
+environment variables to enable them, and then use your normal compiler
+scripts.  This method is compatible with both GNU and IBM compilers.
+
+Blue Gene profiling configuration example:
+----
+export MPICC_PROFILE=$DARSHAN_PREFIX/share/mpi-profile/darshan-bg-cc
+export MPICXX_PROFILE=$DARSHAN_PREFIX/share/mpi-profile/darshan-bg-cxx
+export MPICF77_PROFILE=$DARSHAN_PREFIX/share/mpi-profile/darshan-bg-f
+export MPICF90_PROFILE=$DARSHAN_PREFIX/share/mpi-profile/darshan-bg-f
+----
 
 === Cray platforms (XE, XC, or similar)
 


hooks/post-receive
--