Sophie: mpich2-doc-1.0.8-2mdv2010.0 i586

mpich2-doc-1.0.8-2mdv2010.0.i586.rpm

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML3.2 EN">
<HTML>
<HEAD>
<META NAME="GENERATOR" CONTENT="DOCTEXT">
<TITLE>MPE_Describe_comm_event</TITLE>
</HEAD>
<BODY BGCOLOR="FFFFFF">
<A NAME="MPE_Describe_comm_event"><H1>MPE_Describe_comm_event</H1></A>
Describe the attributes of an event with byte informational data in a specified MPI_Comm and on the thread that the function is invoked. 
<H2>Synopsis</H2>
<PRE>
int MPE_Describe_comm_event( MPI_Comm comm, int eventID,
                             const char *name, const char *color,
                             const char *format )
</PRE>
<H2>Input Parameters</H2>
<DL>
<DT><B>comm         </B><DD>MPI_Comm where this process is part of.

<DT><B>eventID      </B><DD>event number for the event.

<DT><B>name         </B><DD>name of the event,
the maximum length of the NULL-terminated string is,
sizeof(CLOG_DESC), 32.

<DT><B>color        </B><DD>color of the event,
the maximum length of the NULL-terminated string is,
sizeof(CLOG_COLOR), 24.

<DT><B>format       </B><DD>printf style %-token format control string for the event,
the maximum length of the NULL-terminated string is,
sizeof(CLOG_FORMAT), 40.  If format is NULL, it is
equivalent to calling MPE_Describe_event(). The fortran
interface of this routine considers the zero-length string,
"", and single-blank string, " ", as NULL.
</DL>
<P>
<H2>Notes</H2>
Adds a event definition to the logfile.
<P>
This function is threadsafe.
<P>
<H2>Notes on storage format control support</H2>
The format control string is printf like, e.g. "Comment = %s".
All the MPE %-token storage support is provided by SLOG-2.  That is
whatever supported by SLOG-2 will be supported by MPE.  Currently,
the following is supported.
<P>
%s : variable length string, byte buffer size is length of string + 2.
<P>
%h : 2-byte integer, printed as decimal integer, byte buffer size is 2.
<P>
%d : 4-byte integer, printed as decimal integer, byte buffer size is 4.
<P>
%l : 8-byte integer, printed as decimal integer, byte buffer size is 8.
<P>
%x : 4-byte integer, printed as hexadecimal integer, byte buffer size is 4.
<P>
%X : 8-byte integer, printed as hexadecimal integer, byte buffer size is 8.
<P>
%e : 4-byte float, printed as decimal float, byte buffer size is 4.
<P>
%E : 8-byte float, printed as decimal float, byte buffer size is 8.
<BR>
<P>
<P>
<H2>See Also</H2>
 MPE_Log_get_solo_eventID()
<BR><P><B>Location:</B>../src/logging/src/mpe_log.c<P>
</BODY></HTML>