Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
MPE_Describe_info_state(4)	      MPE	    MPE_Describe_info_state(4)

NAME
       MPE_Describe_info_state -  Describe attributes of a state with byte in-
       formational data	in MPI_COMM_WORLD.

SYNOPSIS
       int MPE_Describe_info_state( int	state_startID, int state_finalID,
				    const char *name, const char *color,
				    const char *format )

INPUT PARAMETERS
       state_startID
	      -	event number for the beginning of the state.
       state_finalID
	      -	event number for the ending of the state.
       name   -	name of	the state, the maximum length of  the  NULL-terminated
	      string is, sizeof(CLOG_DESC), 32.
       color  -	 color of the state, the maximum length	of the NULL-terminated
	      string is, sizeof(CLOG_COLOR), 24.
       format -	printf style %-token format control string for the state,  the
	      maximum	 length	   of	 the	NULL-terminated	  string   is,
	      sizeof(CLOG_FORMAT), 40.	If format is NULL, it is equivalent to
	      calling  MPE_Describe_state().   The  fortran  interface of this
	      routine considers	the zero-length	string,	"",  and  single-blank
	      string, "	", as NULL.

NOTES
       Adds  a state definition	to the logfile.	 States	are added to a logfile
       by calling 'MPE_Log_event()' for	the start and end event	numbers.   The
       function	 is  provided  for  backward compatibility purpose.  Users are
       urged to	use 'MPE_Describe_comm_state' and  'MPE_Log_comm_event()'  in-
       stead.

       This function is	threadsafe.

NOTES ON STORAGE FORMAT	CONTROL	SUPPORT
       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.

       %s : variable length string, byte buffer	size is	length of string + 2.

       %h : 2-byte integer, printed as decimal integer,	byte buffer size is 2.

       %d : 4-byte integer, printed as decimal integer,	byte buffer size is 4.

       %l : 8-byte integer, printed as decimal integer,	byte buffer size is 8.

       %x : 4-byte integer, printed as hexadecimal integer, byte  buffer  size
       is 4.

       %X  :  8-byte integer, printed as hexadecimal integer, byte buffer size
       is 8.

       %e : 4-byte float, printed as decimal float, byte buffer	size is	4.

       %E : 8-byte float, printed as decimal float, byte buffer	size is	8.

SEE ALSO
       MPE_Log_get_state_eventIDs().

LOCATION
				   6/15/2009	    MPE_Describe_info_state(4)

NAME | SYNOPSIS | INPUT PARAMETERS | NOTES | NOTES ON STORAGE FORMAT CONTROL SUPPORT | SEE ALSO | LOCATION

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=MPE_Describe_info_state&sektion=4&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help