[mpiwg-tools] Meeting reminder - performance tools

[Marc-Andre Hermanns]

Hi all,

This is your friendly (short-notice) reminder of our regularly
scheduled Tools WG call *today*.

This week's focus is performance tools.

The link is here:
https://cisco.webex.com/ciscosales/j.php?MTID=m0fb3e4a68162bff5874849e4700b806a

Agenda for today is pretty short, as I just wanted to over and get
some feedback on an initial draft of the MPI_T event API.

I attached the draft.

An then, whatever comes up as well.

Looking forward to talking to you.

Cheers,
Marc-Andre
-- 
Marc-Andre Hermanns
Jülich Aachen Research Alliance,
High Performance Computing (JARA-HPC)
Jülich Supercomputing Centre (JSC)

Schinkelstrasse 2
52062 Aachen
Germany

Phone: +49 2461 61 2509 | +49 241 80 24381
Fax: +49 2461 80 6 99753
www.jara.org/jara-hpc
email: hermanns at jara.rwth-aachen.de


-------------- next part --------------
/// @brief Indicates whether an event is raised directly or raised at a later point in time
///
typedef enum {
  MPI_T_EVENT_CLASS_SYNCHRONOUS,
  MPI_T_EVENT_CLASS_ASYNCHRONOUS
} MPI_T_event_class;

/// @brief Get number of supported events
/// 
/// @param[out] num_events
///     Number of events defined
///
int
MPI_T_Event_get_num(int* num_events);

/// @brief Get event information for an event at a given index
///
/// @param[in] index,
///     Event index
/// @param[out] name
///     Unique name of the event
/// @param[out] name_len
///     Length of the name
/// @param[out] desc
///     Description of the event
/// @param[out[ desc_len
///     Length of the string/buffer %desc
/// @param[out] class
///     Event class
/// @param[out] list_of_datatypes
///     List of datatypes used to encode event data
/// @param[out] bind
///     Object type this event is bound to
///
/// @return
///     MPI_T return code
///
int
MPI_T_Event_get_info(int                index,
                     char*              name,
                     int*               name_len,
                     char*              desc,
                     int*               desc_len,
                     int*               verbosity,
                     MPI_T_Event_type*  class,
                     MPI_Datatype*      list_of_datatypes,
                     int*               bind);

/// @brief Get event index for a given name
///
/// @param[in] name
///     NULL-terminated string specifying the event name
/// @param[out] index
///     Event index
///
/// @return
///     MPI_T return code
///
int
MPI_T_Event_get_index(char* name, int* index);

/// @brief Create an event session
///
/// @param[out] session
///     Session handle
///
/// @return
///     MPI_T return code
///
int
MPI_T_Event_session_create(MPI_T_Event_session* session);

/// @brief Free a session and de-register all associated events
///
/// @param[in,out] session
///     Session handle
///
/// @return
///     MPI_T return code
///
int
MPI_T_Event_session_free(MPI_T_Event_session* session);

/// @brief Register an event for a specific session
///
/// @param[in] session
///     Session handle
/// @param[in] index
///     Event index
/// @param[in] user_data
///     Pointer to user data for this registration
/// @param[out] event_handle
///     New event handle
///
/// @return
///     MPI_T return code
///
int
MPI_T_Event_register(MPI_T_Event_session session,
                     int                 index,
                     void*               user_data,
                     MPI_T_Event*        event_handle);

/// @brief Start signaling the given event in the given session.
///
/// @param[in]  session
///     Session handle
/// @param[in]  event
///     Event handle
///
/// @return
///     MPI_T return code
///
int
MPI_T_Event_start(MPI_T_Event_session session,
                  MPI_T_Event_handle  event);

/// @brief Stop signaling the given event in the given session.
///
/// @param[in]  session
///     Session handle
/// @param[in]  event
///     Event handle
///
/// @return
///     MPI_T return code
///
int
MPI_T_Event_stop(MPI_T_Event_session session,
                 MPI_T_Event_handle  event);

/// @brief Read next value from event handle
///
/// @param[in] event_handle
///     Event handle
/// @param[in] datatype
///     Datatype to be read from event data
/// @param[in,out] buffer
///     User-allocated buffer where data is copied to.
///
/// @return
///     MPI_T return code
int
MPI_T_Event_read(MPI_T_Event_handle event,
                 MPI_Datatype       datatype,
                 void*              buffer);

-------------- next part --------------
A non-text attachment was scrubbed...
Name: smime.p7s
Type: application/pkcs7-signature
Size: 4899 bytes
Desc: S/MIME Cryptographic Signature
URL: <http://lists.mpi-forum.org/pipermail/mpiwg-tools/attachments/20160721/7b628584/attachment.bin>