[Mpi3-tools] Question about mqs document

[Anh Vo]

Hi all,

Issue number 1:
I'd like to get some feedback on the msq writeup about function definition and their description. Please take a look at 6.8.3, for example

mqs_fetch_data_ft
Function type definition:
typedef int (*mqs_fetch_data_ft) (mqs_process*, mqs_taddr_t, int, void*);

This is how things are defined in the existing interface. Would it actually be more helpful if we do this in the document.

Function type definition
typedef int (*mqs_fetch_data_ft) (mqs_process* pProcess, mqs_taddr_t address, int numBytes, void* buf);

I.e., give each parameter a name, so that it's easier to explain each of them? Right now my explanation of each of the field is kinda ... meh. With each of them having a name, we can probably structure them into IN and OUT fields (similar to the standard).
Note that this will not change the existing interface, just how we present things in the document. The two definitions are completely equivalent as far as the compilers and the code generated are concerned (please shout if this is not true)

Last time on the call everyone kinda insisted that the document should stay as close to the existing interface as possible so I'd like to get an opinion on this.

Issue number 2:
I don't see the definition (implementation) of mqs_get_comm_group in our existing code and the existing MPICH code. This should be a functionality provided by the DLL, and not the debugger, am I correct?

--Anh

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.mpi-forum.org/pipermail/mpiwg-tools/attachments/20130412/9698ef2c/attachment.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: mpi-tools-wg-report.pdf
Type: application/pdf
Size: 242567 bytes
Desc: mpi-tools-wg-report.pdf
URL: <http://lists.mpi-forum.org/pipermail/mpiwg-tools/attachments/20130412/9698ef2c/attachment.pdf>