[Darshan-commits] [Darshan] branch, dev-modular, updated. darshan-2.3.1-102-g6ef99ac
Service Account
git at mcs.anl.gov
Thu Apr 9 15:32:15 CDT 2015
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, dev-modular has been updated
via 6ef99ac9fec17bebfdabe8f4b47be25532e410fe (commit)
from 451114027638f9dac2a2a3c5282362dc26055539 (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 6ef99ac9fec17bebfdabe8f4b47be25532e410fe
Author: Shane Snyder <ssnyder at mcs.anl.gov>
Date: Thu Apr 9 15:31:51 2015 -0500
revamp docs, including runtime block diagram
-----------------------------------------------------------------------
Summary of changes:
doc/darshan-dev-modular-runtime.png | Bin 0 -> 30933 bytes
doc/darshan-modularization.txt | 14 ++++++++++++--
2 files changed, 12 insertions(+), 2 deletions(-)
create mode 100644 doc/darshan-dev-modular-runtime.png
Diff of changes:
diff --git a/doc/darshan-dev-modular-runtime.png b/doc/darshan-dev-modular-runtime.png
new file mode 100644
index 0000000..86a8f34
Binary files /dev/null and b/doc/darshan-dev-modular-runtime.png differ
diff --git a/doc/darshan-modularization.txt b/doc/darshan-modularization.txt
index b558fd9..08304f1 100644
--- a/doc/darshan-modularization.txt
+++ b/doc/darshan-modularization.txt
@@ -1,4 +1,4 @@
-:sectlinks:
+:data-uri:
Darshan modularization branch development notes
===============================================
@@ -77,6 +77,12 @@ In general, instrumentation modules are composed of:
* a set of functions for interfacing with the Darshan runtime environment, including an optional
reduction operation to condense I/O data shared on all processes into a single data record.
+A block diagram illustrating the interaction of an example POSIX instrumentation module and the
+Darshan runtime environment is given below in Figure 1.
+
+.Darshan runtime environment
+image::darshan-dev-modular-runtime.png[align="center"]
+
==== Instrumentation modules
The wrapper functions used to intercept I/O function calls of interest are central to the design of
@@ -172,7 +178,11 @@ all internal data structures.
Within darshan-runtime, the darshan-core component manages the initialization and shutdown of the
Darshan environment, provides instrumentation module developers an interface for registering modules
with Darshan, and manages the compressing and the writing of the resultant I/O characterization.
-Each of the functions defined by this interface are explained in detail below.
+As illustrated in Figure 1, the darshan-core runtime environment intercepts `MPI_Init` and
+`MPI_Finalize` routines to initialze and shutdown the darshan runtime environment, respectively.
+
+Each of the functions provided by darshan-core to interface with instrumentation modules are
+described in detail below.
[source,c]
void darshan_core_register_module(
hooks/post-receive
--
More information about the Darshan-commits
mailing list