Skip to content

Commit 8d1dc23

Browse files
committed
Doc: explain why the offsets in MPI-IO module may not be the true values
1 parent fa54c64 commit 8d1dc23

File tree

1 file changed

+7
-1
lines changed

1 file changed

+7
-1
lines changed

darshan-util/doc/darshan-util.rst

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1426,7 +1426,13 @@ understanding how MPI-IO read or write operations map to underlying POSIX read
14261426
or write operations issued to the traced file.
14271427

14281428
The output format for the DXT MPI-IO module is essentially identical to the DXT
1429-
POSIX module, except that the offset of file operations is not tracked.
1429+
POSIX module, except that the offsets of file operations may not reflect the
1430+
true file offsets used in individual I/O operations, due to the possibility of
1431+
a very complicate MPI fileview passed to the MPI-IO library from the
1432+
application or high-level I/O libraries. Decoding a complicate MPI derived
1433+
datatype can be expensive. In addition, for MPI-IO functions that make use of
1434+
shared file pointers, e.g. ``MPI_File_write_shared()``, it is difficult to
1435+
trace the offsets without inter-process communication.
14301436

14311437
Other darshan-util utilities
14321438
=======================================

0 commit comments

Comments
 (0)