# HPC IO Benchmark Repository [![Build Status](https://travis-ci.org/hpc/ior.svg?branch=master)](https://travis-ci.org/hpc/ior)

This repository contains the IOR and mdtest parallel I/O benchmarks.  The
[official IOR/mdtest documentation][] can be found in the `docs/` subdirectory
or on Read the Docs.

## Building

1. If `configure` is missing from the top level directory, you probably
   retrieved this code directly from the repository.  Run `./bootstrap`
   to generate the configure script.  Alternatively, download an
   [official IOR release][] which includes the configure script.

1. Run `./configure`.  For a full list of configuration options, use
   `./configure --help`.

2. Run `make`

3. Optionally, run `make install`.  The installation prefix
   can be changed via `./configure --prefix=...`.

## Testing

* Run `make check` to invoke the unit tests.
* More comprehensive functionality tests are included in `testing/`.  These
  scripts will launch IOR and mdtest via MPI.
* Docker scripts are also provided in `testing/docker/` to test various
  distributions at once.  

[official IOR release]: https://github.com/hpc/ior/releases
[official IOR/mdtest documentation]: http://ior.readthedocs.org/