<html xmlns:v="urn:schemas-microsoft-com:vml" xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns:m="http://schemas.microsoft.com/office/2004/12/omml" xmlns="http://www.w3.org/TR/REC-html40">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
<meta name="Generator" content="Microsoft Word 14 (filtered medium)">
<style><!--
/* Font Definitions */
@font-face
        {font-family:Helvetica;
        panose-1:2 11 6 4 2 2 2 2 2 4;}
@font-face
        {font-family:Helvetica;
        panose-1:2 11 6 4 2 2 2 2 2 4;}
@font-face
        {font-family:Calibri;
        panose-1:2 15 5 2 2 2 4 3 2 4;}
@font-face
        {font-family:Tahoma;
        panose-1:2 11 6 4 3 5 4 4 2 4;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
        {margin:0in;
        margin-bottom:.0001pt;
        font-size:12.0pt;
        font-family:"Times New Roman","serif";}
a:link, span.MsoHyperlink
        {mso-style-priority:99;
        color:blue;
        text-decoration:underline;}
a:visited, span.MsoHyperlinkFollowed
        {mso-style-priority:99;
        color:purple;
        text-decoration:underline;}
p.MsoAcetate, li.MsoAcetate, div.MsoAcetate
        {mso-style-priority:99;
        mso-style-link:"Balloon Text Char";
        margin:0in;
        margin-bottom:.0001pt;
        font-size:8.0pt;
        font-family:"Tahoma","sans-serif";}
span.EmailStyle17
        {mso-style-type:personal-reply;
        font-family:"Calibri","sans-serif";
        color:#1F497D;}
span.BalloonTextChar
        {mso-style-name:"Balloon Text Char";
        mso-style-priority:99;
        mso-style-link:"Balloon Text";
        font-family:"Tahoma","sans-serif";}
.MsoChpDefault
        {mso-style-type:export-only;
        font-size:10.0pt;}
@page WordSection1
        {size:8.5in 11.0in;
        margin:1.0in 1.0in 1.0in 1.0in;}
div.WordSection1
        {page:WordSection1;}
--></style><!--[if gte mso 9]><xml>
<o:shapedefaults v:ext="edit" spidmax="1026" />
</xml><![endif]--><!--[if gte mso 9]><xml>
<o:shapelayout v:ext="edit">
<o:idmap v:ext="edit" data="1" />
</o:shapelayout></xml><![endif]-->
</head>
<body lang="EN-US" link="blue" vlink="purple">
<div class="WordSection1">
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1F497D">Comments inline<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1F497D"><o:p> </o:p></span></p>
<div>
<div style="border:none;border-top:solid #B5C4DF 1.0pt;padding:3.0pt 0in 0in 0in">
<p class="MsoNormal"><b><span style="font-size:10.0pt;font-family:"Tahoma","sans-serif"">From:</span></b><span style="font-size:10.0pt;font-family:"Tahoma","sans-serif""> mpi3-tools-bounces@lists.mpi-forum.org [mailto:mpi3-tools-bounces@lists.mpi-forum.org]
<b>On Behalf Of </b>Kathryn Mohror<br>
<b>Sent:</b> Wednesday, May 22, 2013 1:44 PM<br>
<b>To:</b> mpi3-tools@lists.mpi-forum.org<br>
<b>Subject:</b> Re: [Mpi3-tools] latest draft of mqs<o:p></o:p></span></p>
</div>
</div>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">Hi Ahn,<o:p></o:p></p>
<div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">comments inline: <o:p></o:p></p>
</div>
<div>
<p class="MsoNormal">Page 2, Comment JD4<br>
John's comments about lots of hyphenated identifiers at end of line. Some of it are artifacts of converting PDF -> Word, but I think this is a common (and widely accepted) problems of latex documents. So we will probably have to live with it unless there're
 some magic way to make it nicer. <o:p></o:p></p>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<p class="MsoNormal">I searched the standard (with PDF viewer search) and didn't see any broken hyphenated identifiers at the ends of lines. I noted that in the standard type and function names are like so: MPI\_COMM\_WORLD  while in MPIR and MQS they are like
 so: MPI\_\-COMM\_\-WORLD.  If you remove the \- will it do the right thing? I am not a Latex guru so I don't know. <o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><span style="color:#1F497D">[anhvo]: Yes, I think I mainly followed the practice of the latex in MPIR and put the \- there, it basically tells Latex it can break off the lines there. Not sure which one is more desirable?</span><br>
<br>
<o:p></o:p></p>
<p class="MsoNormal">Page 9 (Page 14 in Word), Comment JD18<br>
John recommended the formatted table similar to what the MPIR document had. For example:<br>
<br>
Char MPIR_dll_name[]<br>
Definition is required<br>
Definition is contained within the address space of the MPI process<br>
Variable is written by the MPI process, and read by the tool<br>
<br>
I thought I did ask about this in the conf call at some point (or maybe it was an email, I can't remember the exact time and place) and we agreed that we would not be using that format because many people in the forum thought it was weird looking.<o:p></o:p></p>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<p class="MsoNormal">Well, my opinion is that it should be consistent with what is in MPIR since it's supposed to be part of the same document.  I don't remember the 'weird looking' comment, but I wouldn't be surprised if someone made it.<o:p></o:p></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1F497D">[anhvo] I think Jeff mentioned this in the scanned PDF he sent back to me. And I agreed with Jeff so I removed it. I might be in the minority but I don’t necessarily
 agree that we should have similar format with the MPIR Document. They’re both side documents but they’re quite different. In MPIR there are many variables so it’s quite important to mention where they should stay and who is writing, reading it. In MQS we separate
 callbacks by debugger and DLL so it’s quite clear who should define what<o:p></o:p></span></p>
</div>
<div>
<p class="MsoNormal"><br>
<br>
<o:p></o:p></p>
<p class="MsoNormal">Page 9 (Page 14 in Word), Comment JD19:<br>
I think we agreed that we would not include the mpimsgq_dll_locations in this version and leave all extensions/improvements to document V1.1 or V2.0<o:p></o:p></p>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<p class="MsoNormal">Right, I agree that we're only trying to document what the state of things is. However, he says the at OpenMPI implements this. Is that so Jeff? And does a debugger support it? If so, I'd think we want to mention it.<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><span style="color:#1F497D">[anhvo]: I’ll let Jeff comment on this.</span><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1F497D"><o:p></o:p></span></p>
<p class="MsoNormal"><br>
<br>
<o:p></o:p></p>
<p class="MsoNormal">Page 15 (Page 21 in Word),Comment JD26<br>
Should we include semicolon at the end of the typedef definition? When I first created the document, I also debated a bit between this. I ended up following the style of the MPI standard where it lists the C declaration without any ; I'm fine either way, but
 would like to hear others' opinions on this.<o:p></o:p></p>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<p class="MsoNormal">I think the standard does use ; . At least I didn't see any -- did I miss what you mean?<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><span style="color:#1F497D">[anhvo]: The standard does not put semicolon after a C definition. Randomly picking: page 38, C definition of MPI_BSend:<o:p></o:p></span></p>
<p class="MsoNormal"><span style="color:#1F497D">int MPI_Bsend(…) (no semicolon at the end)<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1F497D"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1F497D"><o:p> </o:p></span></p>
</div>
<div>
<p class="MsoNormal">Thanks for your hard work Ahn!<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal">Kathryn<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<blockquote style="margin-top:5.0pt;margin-bottom:5.0pt">
<p class="MsoNormal"><br>
I'm leaving for lunch now. More comments after I'm back. In the meantime, if folks can comments on what I've sent so far, that'd be great!!<br>
<br>
Thanks<br>
Anh<br>
<br>
-----Original Message-----<br>
From: <a href="mailto:mpi3-tools-bounces@lists.mpi-forum.org">mpi3-tools-bounces@lists.mpi-forum.org</a> [mailto:mpi3-<a href="mailto:tools-bounces@lists.mpi-forum.org">tools-bounces@lists.mpi-forum.org</a>] On Behalf Of Anh Vo<br>
Sent: Wednesday, May 22, 2013 8:10 AM<br>
To: <a href="mailto:mpi3-tools@lists.mpi-forum.org">mpi3-tools@lists.mpi-forum.org</a><br>
Subject: Re: [Mpi3-tools] latest draft of mqs<br>
<br>
The definitions John provide look great for me. Unless there are other opinions, I will use those.<br>
<br>
--Anh <br>
<br>
-----Original Message-----<br>
From: <a href="mailto:mpi3-tools-bounces@lists.mpi-forum.org">mpi3-tools-bounces@lists.mpi-forum.org</a> [mailto:mpi3-<a href="mailto:tools-bounces@lists.mpi-forum.org">tools-bounces@lists.mpi-forum.org</a>] On Behalf Of Ahn, Dong H.<br>
Sent: Wednesday, May 22, 2013 7:54 AM<br>
To: <a href="mailto:mpi3-tools@lists.mpi-forum.org">mpi3-tools@lists.mpi-forum.org</a><br>
Subject: Re: [Mpi3-tools] latest draft of mqs<br>
<br>
Hi John,<br>
<br>
This works for me and should clarify a few things in the current draft. <br>
<br>
Best,<br>
Dong<br>
<br>
<br>
<o:p></o:p></p>
<p class="MsoNormal">-----Original Message-----<br>
From: <a href="mailto:mpi3-tools-bounces@lists.mpi-forum.org">mpi3-tools-bounces@lists.mpi-forum.org</a><br>
[mailto:mpi3-<a href="mailto:tools-bounces@lists.mpi-forum.org">tools-bounces@lists.mpi-forum.org</a>] On Behalf Of John
<br>
DelSignore<br>
Sent: Wednesday, May 22, 2013 9:55 AM<br>
To: <a href="mailto:mpi3-tools@lists.mpi-forum.org">mpi3-tools@lists.mpi-forum.org</a><br>
Subject: Re: [Mpi3-tools] latest draft of mqs<br>
<br>
I prefer to not muddy up the "standard definitions" (or maybe <br>
"common-sense definitions") of commonly used term, such as "image <br>
file", to make them conform to the MQD interface. Instead, I like to define the MQD typedefs in terms of the standard definitions. So, WRT to the document, I think we should include the following definitions:<br>
<br>
* An "image file" is an executable or shared library file, that may contain symbol definitions needed by the MQD interface.<br>
<br>
* An "MPI process" consists of an "address space" and a collection of execution contexts (threads or lightweight processes).<br>
<br>
* An "address space" is a region of memory that consists of executable <br>
code and data, and is partially composed of a collection of image <br>
files. The collection of image files may change at any point during the execution of the MPI process, and image files may be relocated at runtime within the address space at the point they are loaded into memory.<br>
<br>
Then we can say:<br>
<br>
* An "mqs_image" is an abstract concept that represents the collection <br>
of image files loaded into the address space of the MPI process at any <br>
given time, and is debugger implementation defined. In static <br>
execution environments, where shared libraries are not supported, an <br>
mqs_image can represent an executable image file. However, in dynamic <br>
execution environments, where shared libraries, dynamically loaded shared libraries, and runtime relocation of shared libraries are supported, an mqs_image should represent the collection of image files loaded into the address space of the MPI process at any
 given point in time; in this situation, mqs_image may in fact represent the MPI process itself.<br>
<br>
Cheers, John D.<br>
<br>
<br>
Anh Vo wrote:<br>
<br>
<o:p></o:p></p>
<p class="MsoNormal" style="margin-bottom:12.0pt">Thanks Kathryn for starting up the discussion.<br>
<br>
<br>
<br>
I'll start with my existing definition of mqs_image in the document, <br>
which definitely is not adequate.<br>
<br>
<br>
<br>
Existing definition:<br>
<br>
An image is an executable file that was loaded into memory when<br>
<br>
a process is started.  For SIMD-style programs, all MPI processes <br>
have<br>
<br>
the same image. For MIMD-style programs, MPI processes might have<br>
<br>
different images.<br>
<br>
<br>
<br>
Dong's comments:<br>
<br>
The definition of "Image" isn't all that rigorous here. I think this <br>
creates some confusion somewhere down this document. Is an image <br>
really an executable file? Which  typically means the base <br>
executable or does this refer to both the based executable and DSOs <br>
being loaded into the process address space? Though it sounds <br>
hair-splitting, even the SPMD remark, the statement is only true if <br>
the image is defined to be the base executable.<br>
<br>
<br>
<br>
John's comments:<br>
<br>
I think we should be more general with the term "image" to mean <br>
executable or shared library. The reason is that we do not want to <br>
require symbols to reside in the executable. We should allow symbols <br>
to reside in shared libraries.<br>
<br>
Also, I think we need to define the "address space" of a process, <br>
and an "image list" as a collection of image files that have been <br>
loaded in the address space, and possibly relocated at runtime.<br>
<br>
<br>
<br>
I think I agree with both comments. Image should not refer to a <br>
single executable image (a.out or a.exe), but rather the base <br>
executable and the shared libraries that were loaded into the process address space.<br>
<br>
<br>
<br>
So how about this new definition:<br>
<br>
An image represents the executable (e.g., a.out) and the collection <br>
of dynamically loaded libraries that were loaded into the process <br>
address space.<br>
<br>
<br>
<br>
--Anh<br>
<br>
*From:* <a href="mailto:mpi3-tools-bounces@lists.mpi-forum.org">mpi3-tools-bounces@lists.mpi-forum.org</a><br>
[mailto:mpi3-<a href="mailto:tools-bounces@lists.mpi-forum.org">tools-bounces@lists.mpi-forum.org</a>] *On Behalf Of
<br>
*Kathryn Mohror<br>
*Sent:* Tuesday, May 21, 2013 6:27 PM<br>
*To:* <a href="mailto:mpi3-tools@lists.mpi-forum.org">mpi3-tools@lists.mpi-forum.org</a><br>
*Subject:* Re: [Mpi3-tools] latest draft of mqs<br>
<br>
<br>
<br>
Hi John,<br>
<br>
<br>
<br>
Thank you for the extensive feedback and help with the document! I'm <br>
sure you will get the 'nod' you referred to on page 1 :-)<br>
<br>
<br>
<br>
For the definition of mqs_image, I agree that it needs work.  Dong <br>
Ahn also mentioned that it needed to be more rigorously defined.<br>
However if possible, I think it would be beneficial if we could at <br>
least start the conversation before next week so that we have a <br>
better chance of having it nailed down in advance of the next meeting.<br>
<br>
<br>
<br>
So, that said -- does anyone want to take a first stab at a <br>
definition to get us started?<br>
<br>
<br>
<br>
Kathryn<br>
<br>
<br>
<br>
On May 21, 2013, at 2:18 PM, John DelSignore <br>
<<a href="mailto:John.DelSignore@roguewave.com">John.DelSignore@roguewave.com</a>
<br>
<<a href="mailto:John.DelSignore@roguewave.com">mailto:John.DelSignore@roguewave.com</a>>><br>
wrote:<br>
<br>
<br>
<br>
   Hi,<br>
<br>
   Attached are my edits and comments on the MPI Message Queue<br>
   document. Anh provided me with a Word document generated from the<br>
   LaTex, so the formatting is funky in some places. I enabled change<br>
   tracking in Word before making my edits, and I added many comments<br>
   to the document in places where I think we have more work to do.<br>
   Unfortunately, I think the changes might be somewhat extensive.<br>
<br>
   The volume of edits and comments aside, I think Anh did a great job!<br>
   The first draft of the document closely reflects the 10+ year-old<br>
   description of the interface pretty well. Unfortunately, the<br>
   original interface has some problem that we need to resolve, most<br>
   critically, we have to resolve how to describe the concept of<br>
   "mqs_image". We can talk about this during the next concall.<br>
<br>
   Cheers, John D.<br>
<br>
<br>
   Anh Vo wrote:<br>
<br>
       Hi all,<br>
<br>
       As mentioned on the tool WG call today, I'm re-sending the<br>
       latest draft.<br>
       Feedbacks are appreciated. We'll send this one out to the wider<br>
       audience<br>
       on Tuesday 5/21 to meet the requirement for first reading in <br>
June<br>
<br>
<br>
<br>
       --Anh<br>
<br>
   <MPI-MQD-JVD-2013-05-17.doc>_______________________________________________<br>
   Mpi3-tools mailing list<br>
   <a href="mailto:Mpi3-tools@lists.mpi-forum.org">Mpi3-tools@lists.mpi-forum.org</a> <<a href="mailto:Mpi3-tools@lists.mpi-forum.org">mailto:Mpi3-tools@lists.mpi-forum.org</a>><br>
   <a href="http://lists.mpi-forum.org/mailman/listinfo.cgi/mpi3-tools">http://lists.mpi-forum.org/mailman/listinfo.cgi/mpi3-tools</a><br>
<br>
<br>
<br>
______________________________________________________________<br>
Kathryn Mohror, <a href="mailto:kathryn@llnl.gov">kathryn@llnl.gov</a><br>
<<a href="mailto:kathryn@llnl.gov">mailto:kathryn@llnl.gov</a>>, <a href="http://people.llnl.gov/mohror1">
http://people.llnl.gov/mohror1</a> CASC @ <br>
Lawrence Livermore National Laboratory, Livermore, CA, USA<br>
<br>
<br>
<br>
<br>
<br>
<br>
<o:p></o:p></p>
<p class="MsoNormal">_______________________________________________<br>
Mpi3-tools mailing list<br>
<a href="mailto:Mpi3-tools@lists.mpi-forum.org">Mpi3-tools@lists.mpi-forum.org</a><br>
<a href="http://lists.mpi-forum.org/mailman/listinfo.cgi/mpi3-tools">http://lists.mpi-forum.org/mailman/listinfo.cgi/mpi3-tools</a><o:p></o:p></p>
<p class="MsoNormal"><br>
_______________________________________________<br>
Mpi3-tools mailing list<br>
<a href="mailto:Mpi3-tools@lists.mpi-forum.org">Mpi3-tools@lists.mpi-forum.org</a><br>
<a href="http://lists.mpi-forum.org/mailman/listinfo.cgi/mpi3-tools">http://lists.mpi-forum.org/mailman/listinfo.cgi/mpi3-tools</a><br>
<br>
<br>
<br>
<br>
_______________________________________________<br>
Mpi3-tools mailing list<br>
<a href="mailto:Mpi3-tools@lists.mpi-forum.org">Mpi3-tools@lists.mpi-forum.org</a><br>
<a href="http://lists.mpi-forum.org/mailman/listinfo.cgi/mpi3-tools">http://lists.mpi-forum.org/mailman/listinfo.cgi/mpi3-tools</a><br>
<br>
<br>
<msgq.pdf>_______________________________________________<br>
Mpi3-tools mailing list<br>
<a href="mailto:Mpi3-tools@lists.mpi-forum.org">Mpi3-tools@lists.mpi-forum.org</a><br>
<a href="http://lists.mpi-forum.org/mailman/listinfo.cgi/mpi3-tools">http://lists.mpi-forum.org/mailman/listinfo.cgi/mpi3-tools</a><o:p></o:p></p>
</blockquote>
</div>
<p class="MsoNormal"><o:p> </o:p></p>
<div>
<div>
<div>
<p class="MsoNormal"><span style="font-size:13.5pt;font-family:"Helvetica","sans-serif";color:black">______________________________________________________________<br>
Kathryn Mohror, <a href="mailto:kathryn@llnl.gov">kathryn@llnl.gov</a>, <a href="http://people.llnl.gov/mohror1">http://people.llnl.gov/mohror1</a><br>
CASC @ Lawrence Livermore National Laboratory, Livermore, CA, USA<o:p></o:p></span></p>
</div>
<div>
<p class="MsoNormal"><span style="font-size:13.5pt;font-family:"Helvetica","sans-serif";color:black"><o:p> </o:p></span></p>
</div>
</div>
<p class="MsoNormal" style="margin-bottom:12.0pt"><o:p> </o:p></p>
</div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
</div>
</body>
</html>