[Darshan-commits] [Darshan] branch, master, updated. darshan-2.3.1-pre1-23-g3421534

[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  3421534f9f6293c3aca1603162d09849028b5d93 (commit)
      from  f0d7be0fefc9431cc3245cd4632c8f6c7a27c1c4 (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 3421534f9f6293c3aca1603162d09849028b5d93
Author: Phil Carns <carns at mcs.anl.gov>
Date:   Fri Feb 6 13:40:03 2015 -0500

    doc update for MPICH 3.1 - 3.1.3

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

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


Diff of changes:
diff --git a/ChangeLog b/ChangeLog
index 415f444..2928195 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -28,6 +28,7 @@ darshan-2.3.1-pre2
   - workstation-static and workstation-dynamic test environments supported
 * update darshan-gen-fortran.pl and darshan-gen-cxx.pl to support new library
   naming conventions in MPICH 3.1.1 and higher
+* update documentation to reflect known issues with some versions of MPICH
 
 darshan-2.3.0
 =============
diff --git a/darshan-runtime/doc/darshan-runtime.txt b/darshan-runtime/doc/darshan-runtime.txt
index 5864574..da01a47 100644
--- a/darshan-runtime/doc/darshan-runtime.txt
+++ b/darshan-runtime/doc/darshan-runtime.txt
@@ -379,12 +379,30 @@ http://software.intel.com/en-us/forums/showthread.php?t=103447&o=a&s=lr
 
 === Linux clusters using MPICH 
 
-Follow the generic instructions provided at the top of this document.  The
-only modification is to make sure that the `CC` used for compilation is
+Follow the generic instructions provided at the top of this document.  For MPICH versions 3.1 and
+later, MPICH uses shared libraries by default, so you may need to consider the dynamic linking
+instrumentation approach.  
+
+The static linking method can be used if MPICH is configured to use static
+linking by default, or if you are using a version prior to 3.1.
+The only modification is to make sure that the `CC` used for compilation is
 based on a GNU compiler.  Once Darshan has been installed, it should be
 capable of instrumenting executables built with GNU, Intel, and PGI
 compilers.
 
+[NOTE]
+Darshan is not capable of instrumenting Fortran applications build with MPICH versions 3.1.1, 3.1.2,
+or 3.1.3 due to a library symbol name compatibility issue.  Consider using a newer version of
+MPICH if you wish to instrument Fortran applications.  Please see
+http://trac.mpich.org/projects/mpich/ticket/2209 for more details.
+
+[NOTE]
+MPICH versions 3.1, 3.1.1, 3.1.2, and 3.1.3 may produce link-time errors when building static
+executables (i.e. using the -static option) if MPICH is built with shared library support.
+Please see http://trac.mpich.org/projects/mpich/ticket/2190 for more details.  The workaround if you
+wish to use static linking is to configure MPICH with `--enable-shared=no --enable-static=yes` to
+force it to use static MPI libraries with correct dependencies.
+
 === Linux clusters using Open MPI
 
 Follow the generic instructions provided at the top of this document for


hooks/post-receive
--