Status

The standardization of MPI 3.1 is complete and the new version of the standard is available at MPI Forum Document Page.

Scope

Provide small additions to MPI 3.0 and integrate them together with identified errata items into a new version of the MPI standard.


Note

The information below reflects the state of the MPI 3.1 efforts up to the ratification on June 4th 2015. It is no longer maintained, but kept for historical reasons.


Timeline

As of the December 2014 meeting, we completed all additions to the MPI 3.1 standard and the expectation was that we vote on the standard at the March 2015 meeting. However, due to technical issues found, this was postponed and is now scheduled for the June 2015 meeting. Here is the timeline for this process:

  • Starting Dec. 2014: Start integrating passed tickets into golden copy
    • Has to be done by chapter committee chairs
    • Changes to be reviewed by chapter committees
    • Text edits must follow http://meetings.mpi-forum.org/2014-12-instructions.pdf
    • The location of the SVN repo listed in the instructions
    • WARNING: start with current version of the golden copy (Fortran changes already in)
  • By February 2nd (4 weeks before MPI Forum)
    • Chapter committee chairs publish draft of each chapter
    • Commit to golden copy for MPI 3.1 in the repo
    • Some kind of diff with old chapter (what ever works for the chapter)
    • To be sent to MPI forum email list
    • Full draft will be on the forum page for review
  • By February 16th (2 weeks before MPI Forum)
    • Chapter committees collect and integrate feedback
    • Chapter committee chairs publish final chapter proposal for MPI 3.1
  • Starting March 2nd (MPI forum meeting in Portland)
    • Reading of all chapters (i.e., going through the diffs)
    • Creation of list of open issues
  • By May 4th (4 weeks before MPI Forum)
    • Chapter committees finish fixing open issues
    • Chapter committee chairs publish final chapter proposal for MPI 3.1
  • By May 11th (3 weeks before MPI Forum)
    • MPI Editor publishes final MPI 3.1 draft
  • Starting June 1st (MPI forum meeting in Chicago)
    • Discussion of fixes to open issues
    • Final vote on document

Document Intergration Process and Chaper Committee Responsibilities

Chapter committees will be responsible for integrating and reviewing all changes into the standard document. For already voted in tickets, errata items, and ticket 0 changes, this process can start immediately, at the latest, though, this work needs to be done between the September and December meetings. For this, one member of eacg chapter committee (the chair a designee) will have write access to the MPI 3.1 tree.

We decided to no longer use the Latex change macros for adding the new text, since those led to bad document quality (feel free to still use them for working group documents and ticket presentations - I am just talking about the main document). Instead we will rely on "svn diff" for change tracking. To make this work, please don’t reflow any text! Also, please make sure you follow the document instructions contained in the MPI document repository (see README) to make sure we get a consistent document.

At the end of the process, every chapter committee chair is expected to provide:

  • A new PDF of the chapter with all changes integrated (clean document, without any change bars)
  • An SVN diff document (informal to help people track things)
  • A side document detailing the changes (tickets, errata item, ticket 0 items beyond typos, e.g., examples)

These documents need to be reviewed by the chapter committee and made available at least two weeks before the forum meeting.

A longer description of these procedures and documentation on how to write/build the MPI document is available here.

Chapter Committees

# Chapter Chair Members
  Front Matter Bill Gropp Rolf Rabenseifner, Martin Schulz
1 Introduction Bill Gropp Rolf Rabenseifner, Martin Schulz
2 MPI Terms and Conventions Rolf Rabenseifner Bill Gropp, Martin Schulz, Dan Holmes, Jim Dinan
3 Point to Point Communcation Dan Holmes”, “Bill Gropp, Sayantan Sur, Rich Graham, Pavan Balaji  
4 Datatypes George Bosilca Jeff Hammond, Rich Graham, David Solt, Bill Gropp, Jim Dinan
5 Collective Communication Torsten Hoefler George Bosilca, Purushotham Bangalore, Jeff Hammond
6 Groups, Contexts, Communicators, Caching Pavan Balaji Bill Gropp, Sayantan Sur, Sreeram Potluri
7 Process Topologies Torsten Hoefler Rolf Rabenseifner, Purushotham Bangalore, Chulho Kim, Pavan Balaji
8 MPI Environmental Management George Bosilca Martin Schulz, Rolf Rabenseifner, Chulho Kim
9 The Info Object Jeff Hammond Torsten Hoefler, David Solt, Pavan Balaji
10 Process Creation and Mangement David Solt Jeff Hammond, Wesley Bland, Howard Pritchard
11 One-Sided Communication Bill Gropp Pavan Balaji, Torsten Hoefler, Rajeev Thakur, Sayantan Sur
12 External Interfaces Pavan Balaji Dries Kimpe, Jeff Hammond, Jim Dinan, Aurélien Bouteiller
13 I/O Quincey Koziol Mohamad Chaarawi, Rajeev Thakur, Dries Kimpe
14 Tool Support Kathryn Mohror Martin Schulz, Marc-Andre Hermanns, Adam Moody
15 Deprecated Functions Rolf Rabenseifner  
16 Removed Interfaces Rolf Rabenseifner  
17 Language Bindings Jeff Squyres Jeff Hammond, Rolf Rabenseifner, Craig Rasmussen
A Language Bindings Summary Rolf Rabenseifner Jeff Hammond, Craig Rasmussen
B Change-Log Rolf Rabenseifner  

Draft Chapters for MPI 3.1 (as of the March 2015 Meeting)

Note, sections marked with “rev” are revised versions of the chapters submitted after the two week mark. We will discuss the implications of these chapters at the meeting.

# Chapter Contact Draft Text Diff Text Tickets
0 Front Matter Bill Gropp     Version number changed. Credits need to be updated.
0rev Front Matter Bill Gropp     Version, Difference to 3.0 and credits added.
1 Introduction Bill Gropp     no tickets / no diff since r1750
1rev Introduction Bill Gropp     Added background
2 MPI Terms and Conventions Rolf Rabenseifner   Gist 421, 431, 447, 449, 450, 451, 452, 453, 455, 349, 404 Not affected by #388 / BIND(C) errata
3 Point to Point Communcation Dan Holmes     446, 388, 415, 424, 388
4 Datatypes George Bosilca   Gist 102, 349, 404, 421, 431, 443, 388
5 Collective Communication Torsten Hoefler     388
6 Groups, Contexts, Communicators, Caching Pavan Balaji     388, 345
7 Process Topologies Torsten Hoefler   Gist 388, 419, 420
7rev Process Topologies Torsten Hoefler   Gist removed the 20-year old outdated reference to EXPRESS; slight wording change in advice to users on MPI_WEIGHTS_EMPTY; slight wording change in example of graph_neighbors; slight wording change in first sentence of 7.5.6. Diff for only whitespace changes
8 MPI Environmental Management George Bosilca     388, 357, 390
8rev MPI Environmental Management George Bosilca   Gist Switched to subversion 3.1 (svn r2013)
9 The Info Object Jeff Hammond     388
10 Process Creation and Mangement David Solt     388
11 One-Sided Communication Bill Gropp     348, 350, 355, 359, 362, 367, 369, 349, 402, 433, 458, 413, 388, 390 SVN Revisions: 348, 350, 355, 359, 362, 367 - r 1767; 369 - r 1962; 349/402 - r 1963; 433 - r 1964; 458 - r 1955; 413 - r 1965 Additional Changes Diff for additional changes #388 implemented in r1835 and r1933
12 External Interfaces Pavan Balaji     388, 357
13 I/O Quincey Koziol   Diff 273, 388, 440 Note 440 is still missing in the chapter draft
14 Tool Support Kathryn Mohror   Gist 354, 377, 378, 383, 385, 386, 387, 391, 394, 400, 405, 406, 388
15 Deprecated Functions Rolf Rabenseifner     no tickets / no diff since r1750
16 Removed Interfaces Rolf Rabenseifner     no tickets / no diff since r1750
17 Language Bindings Jeff Squyres   Gist 444, 441, 393, 445, 388, 345, 403
A Language Bindings Summary Rolf Rabenseifner   Gist 345, 347, 354, 369, 377, 388, 389, 400 Missing #390, see revisions appA3-all-mpif08-routines appA234_MPI_CONVERSION_FN_NULL-annotated appA.3.4-f08-annotated appLang-Const-annotated
Arev Language Bindings Summary Rolf Rabenseifner     390 #390 added as of r2009
B Change-Log Rolf Rabenseifner   Gist 345, 349, 402, 404, 421, 350, 355, 362, 369, 377, 378, 383, 386, 388, 389, 391, 400, 424, 273, 357, 415, 419
Brev Change-Log Rolf Rabenseifner     Fixed page numbers in chancge log

Potential issues/changes to completed tickets - to be discussed

Ticket Chapter Issue
  0 Changes to frontmatter/credits
  1 Changes to chapter 1
453 2 TBD - Proper distinction between declared vs. defined functions for the use of PMPI - discussion to back out #453
  2 READ - Added Bind-C back into text, which is removed incorrectly - r2008 - error was in implementing the ticket
  4 READ - restoring BIND(C) back to MPI-3.0 page 106 lines 14 and 24 - error was in implementing the ticket
  7 READ - Changes to chapter 7, discussed an approved as chapter committee changes
  8 READ - Changes to chapter 8
390 8 READ - Updates for Annex A4.6 and A4.9
357 8 READ - MPI_Get_version and MPI_Get_library_version were done only partially.
  8 READ - New subversion 3.1 in (2x) MPI_SUBVERSION and MPI_GET_VERSION
  8 TBD - Sentence on thread safety - three times in the text - should change from from threads to from multiple thread - requires change in 12.4 as well
  11 Open issues in RMA - Bill will discuss the details
390 11 Updates for Annex A4.6 and A4.9
357 11 MPI_Get_version and MPI_Get_library_version were done only partially.
357 12 TBD - added line in the CC, which causes discussion
440 13 READ - Preferred way to cross reference - ticket 0, but unclear which option was intended - discussion on how to implement ticket
377 14 READ/TBD - Missing statement that an error happens if no variable »>in that class«< is found - needs to be fixed
  17 READ - restoring BIND(C) back to MPI-3.0 - error was in implementing the ticket
  A READ - Changes to annex A, only #390, just simple bug fix
  B READ - Changes to annex B - decided on keeping the full log
  B READ - font fix
  B TBD - B 2.1, bullet 5, add editorial note that we have now 13.5.3 instead of 13.5.2
  B TBD - two RMA tickets missing in change log
    TBD - White space control for all chapters (r1673 and later)
    White space control for all chapters (r1673 and later)

Draft Chapters for MPI 3.1 (as of the June 2015 Meeting)

Updates to the MPI standard, following the list of open issues, are published as part of the agenda for the June 2015 meeting.