Welcome to Darshan’s Documentation

The Darshan source tree is divided into two parts:

• darshan-runtime: to be installed on systems where you intend to instrument MPI applications.

• darshan-util: to be installed on systems where you intend to analyze log files produced by darshan-runtime.

  • darshan-util/pydarshan: a Python package providing interfaces to Darshan log file.

Modularized I/O characterization using Darshan 3.x gives details on the design of the new modularized version of Darshan (3.x) and how new instrumentation modules may be developed within Darshan.

Site-specific documentation for facilities that deploy Darshan in production:

• Argonne Leadership Computing Facility (ALCF): Theta, Cooley.

• National Energy Research Scientific Computing Center (NERSC)

• National Center for Supercomputing Applications (NCSA)

• Oak Ridge Leadership Computing Facility (OLCF): darshan-runtime, darshan-util.

• King Abdullah University of Science and Technology (KAUST)

• European Centre for Medium-Range Weather Forecasts (ECMWF)

• Ohio Supercomputer Center (OSC)

• Julich Supercomputing Centre (JSC)

Darshan Runtime

• Darshan-runtime installation and usage
  • Introduction
  • Requirements
  • Conventional installation
  • Spack installation
  • Instrumenting applications
  • Using the Darshan eXtended Tracing (DXT) module
  • Using AutoPerf instrumentation modules
  • Configuring Darshan library at runtime
  • Darshan installation recipes
  • Debugging

Darshan Utilities

• Darshan-util installation and usage
  • Introduction
  • Requirements
  • Compilation and installation
  • Analyzing log files

Modularized I/O characterization

• Modularized I/O characterization using Darshan 3.x
  • Introduction
  • Overview of Darshan’s modularized architecture
  • Adding new instrumentation modules
  • Shared record reductions
  • Other resources

PyDarshan

• PyDarshan Documentation
  • Features
  • Usage
  • Installation
  • Testing
  • Documentation
  • File List
• Installation
  • Stable release (PyPI)
  • From Spack
  • From sources
• Usage
  • Darshan job summary tool
  • Other Darshan CLI tools
  • Darshan Report interface
  • Darshan CFFI backend interface
• PyDarshan API Reference
  • darshan package

Indices and tables

• Index

• Module Index

• Search Page