[Mpi-forum] Preprocessor Constants

[Hal Finkel]

On Wed, 2010-11-24 at 10:46 -0800, Adam T. Moody wrote:
> Hi Hal,
> Yes, the MISC WG would be a good place for this.
> 

I've collected the text of my proposal, its motivation and some notes
from the mailing-list thread on a Wiki page:

https://svn.mpi-forum.org/trac/mpi-forum-web/wiki/ReqPPMacro

I welcome additional feedback, and I'll submit a ticket in the near
future.

 -Hal

> Ultimately, the full contents for a proposal must be placed in a ticket.
>     https://svn.mpi-forum.org/trac/mpi-forum-web/report
> 
> There is a standard format for a ticket, as an example, see the layout for
>     https://svn.mpi-forum.org/trac/mpi-forum-web/ticket/45
> 
> Basically, there are certain sections to be filled in, with the main 
> portion being a listing of the exact changes to be made.  The location 
> of those changes should also be specified (page and line numbers).  For 
> now, base those changes on the MPI 2.2 standard.
> 
> Feel free to create the ticket yourself.  You'll need to register for an 
> account to post/update tickets (if you don't already have one).
>     https://svn.mpi-forum.org/trac/mpi-forum-web/register
> 
> Very early on in a proposal, when there is still a lot of discussion, 
> you may want to postpone the ticket and start the proposal in a wiki 
> instead.  The MISC wiki is here:
>     https://svn.mpi-forum.org/trac/mpi-forum-web/wiki/MPI3Misc
> (I need to move the scalability discussion that is currently there to 
> another page and replace it with a link from the main page.)
> 
> Either way, it'd be useful to boil down and capture the contents of the 
> discussion you've had with others on the mailing list.  No doubt others 
> will raise these same questions and suggestions, so it's useful to 
> include this content in the ticket or wiki page.
> -Adam
> 
> 
> Jeff Squyres wrote:
> 
> >Yes, "Misc" is probably the best bet.
> >
> >I think that WG is run by Adam Moody of Lawerence Livermore Labs... Adam?
> >
> >
> >On Nov 23, 2010, at 3:04 PM, Hal Finkel wrote:
> >
> >  
> >
> >>On Mon, 2010-11-22 at 18:51 -0500, Jeff Squyres wrote:
> >>    
> >>
> >>>It would be great to see your specific proposal to the MPI-3 Forum.  :-)
> >>>
> >>>      
> >>>
> >>What is the appropriate procedure for this? My best guess is to put it
> >>on the wiki under "Miscellaneous Items."
> >>
> >>-Hal
> >>
> >>    
> >>
> >>>That's both our way of passing the buck back to you :-), and also ensuring that there is a champion to ensure forward progress of each idea that that someone wants to go into MPI-3.  In short: if you want it, either drum up the support and get someone to champion it for you, or champion it yourself.  
> >>>
> >>>(please note: the above is not meant to be a snide remark.  There are *many* good ideas that we're trying to get into MPI-3.  But there are only so many of us and so many hours in a day.  The best way to make sure *your* idea gets in is to champion it yourself).
> >>>
> >>>As noted in New Orleans, you have a bit of a challenge with this idea in that some vendor MPI implementations do not use wrapper compilers, and therefore may have some difficulty in providing this macro.  While we don't mandate specific implementation models in the Forum, we do spend a bit of effort to try to ensure that the standard is implementable in some way in all reasonable environments.  My point here is that we already have implementations where this idea is problematic: can you come up with a way/technique for these problematic implementations to implement your idea?
> >>>
> >>>
> >>>
> >>>On Nov 18, 2010, at 6:25 PM, Hal Finkel wrote:
> >>>
> >>>      
> >>>
> >>>>Hello,
> >>>>
> >>>>Appendix A of the current MPI 3 draft (line 45 of page 545) indicates
> >>>>that MPI_VERSION and MPI_SUBVERSION are of type, "const int (or unnamed
> >>>>enum)". This text is identical to that of the the MPI 2.2 specfication
> >>>>(line 45 of page 523), and it should be changed. As the heading on the
> >>>>previous line implies, these should be "preprocessor constants," and
> >>>>must not be "const int (or unnamed enum)". I recommend replacing, "const
> >>>>int (or unnamed enum)" with "integer literal."
> >>>>
> >>>>Also, regarding the recommendation I made at the SC'10 BOF, I recommend
> >>>>adding the following text after line 19 of page 18 and after line 43 on
> >>>>page 18:
> >>>>User code may assume that mpi.h is unavailable to the preprocessor
> >>>>unless the preprocessor constant _MPI is defined prior to source-file
> >>>>processing.
> >>>>
> >>>>The practical implication is intended to be that wrapper programs such
> >>>>as mpicc will, in addition to adding the various include and linker
> >>>>flags, also add -D_MPI to the compiler command line. This will allow
> >>>>user programs to:
> >>>>
> >>>>#ifdef _MPI
> >>>>#include <mpi.h>
> >>>>#endif
> >>>>
> >>>>in a portable way (analogous to testing for _OMP prior to including
> >>>><omp.h> when using OpenMP, for example). If the implementation simply
> >>>>documents a set of flags which must be given to the compiler, that set
> >>>>of flags can simply be extended to include "-D_MPI". Since many codes
> >>>>have optional MPI support, this will allow them to use a common
> >>>>preprocessor constant, instead of some codes requiring -DMPI, some
> >>>>requiring -D_MPI, some requiring -DUSE_MPI, some requiring -DHAVE_MPI,
> >>>>some requiring -DHAVE_MPI_H, etc.
> >>>>
> >>>>Sincerely,
> >>>>Hal
> >>>>
> >>>>
> >>>>_______________________________________________
> >>>>mpi-forum mailing list
> >>>>mpi-forum at lists.mpi-forum.org
> >>>>http://lists.mpi-forum.org/mailman/listinfo.cgi/mpi-forum
> >>>>        
> >>>>
> >>>      
> >>>
> >>_______________________________________________
> >>mpi-forum mailing list
> >>mpi-forum at lists.mpi-forum.org
> >>http://lists.mpi-forum.org/mailman/listinfo.cgi/mpi-forum
> >>    
> >>
> >
> >
> >  
> >
> 
> _______________________________________________
> mpi-forum mailing list
> mpi-forum at lists.mpi-forum.org
> http://lists.mpi-forum.org/mailman/listinfo.cgi/mpi-forum