Rechercher une page de manuel
MPE_Describe_info_state
Langue: en
Version: 173534 (fedora - 06/07/09)
Section: 4 (Pilotes et protocoles réseau)
NAME
MPE_Describe_info_state - Describe attributes of a state with byte informational 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()' instead.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
Contenus ©2006-2024 Benjamin Poulain
Design ©2006-2024 Maxime Vantorre