Home

MPI-Bash documentation

MPI-Bash adds a number of MPI commands and a number of Libcircle commands to GNU Bash. The following documents are intended to help you learn how to compile MPI-Bash (and its companion, Circle-Bash) and how to use those to write parallel shell scripts.

• Introductory material
• MPI functions supported
• Libcircle functions supported
• Sample MPI-Bash scripts:
  • Examples of MPI functions
  • Examples of Libcircle functions
  • MPI ping-pong benchmark
• Copyright and license

MPI-Bash includes parallel version of a few Unix commands, which are implemented as scripts that wrap the sequential versions of the commands. These are intended to be useful in their own right as high-performance tools as well as further examples of how to write MPI-Bash scripts.

• mbcp (manual page and MPI-Bash script)
• mbtar (manual page and MPI-Bash script)
• mbxz (manual page and MPI-Bash script)

For a more scholarly discussion of MPI-Bash, including some performance data, see the following publication:

• Scott Pakin, "Parallel Post-Processing with MPI-Bash". Proceedings of the First International Workshop on HPC User Support Tools (HUST-14), New Orleans, Lousiana, pp. 1-12, November 2014. IEEE Press, Piscataway, New Jersey, USA. ISBN: 978-1-4799-7023-0, URL: http://dl.acm.org/citation.cfm?id=2691137, DOI: 10.1109/HUST.2014.9.