BufferFlush

This event signals that the internal buffer was flushed at the given time.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_TimeStamp	stopTime	The time the buffer flush finished.

See also: OTF2_EvtWriter_BufferFlush(); OTF2_GlobalEvtReaderCallbacks_SetBufferFlushCallback(); OTF2_EvtReaderCallbacks_SetBufferFlushCallback()

Since: Version 1.0

MeasurementOnOff

This event signals where the measurement system turned measurement on or off.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_MeasurementMode	measurementMode	Is the measurement turned on (OTF2_MEASUREMENT_ON) or off (OTF2_MEASUREMENT_OFF)?

See also: OTF2_EvtWriter_MeasurementOnOff(); OTF2_GlobalEvtReaderCallbacks_SetMeasurementOnOffCallback(); OTF2_EvtReaderCallbacks_SetMeasurementOnOffCallback()

Since: Version 1.0

Enter

An Enter record indicates that the program enters a code region.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_RegionRef	region	Needs to be defined in a definition record References a Region definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_REGION is available.

See also: OTF2_EvtWriter_Enter(); OTF2_GlobalEvtReaderCallbacks_SetEnterCallback(); OTF2_EvtReaderCallbacks_SetEnterCallback()

Since: Version 1.0

Leave

A Leave record indicates that the program leaves a code region.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_RegionRef	region	Needs to be defined in a definition record References a Region definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_REGION is available.

See also: OTF2_EvtWriter_Leave(); OTF2_GlobalEvtReaderCallbacks_SetLeaveCallback(); OTF2_EvtReaderCallbacks_SetLeaveCallback()

Since: Version 1.0

MpiSend

An MpiSend record indicates that an MPI send operation was initiated (MPI_SEND). It keeps the necessary information for this event: receiver of the message, communicator, and the message tag. You can optionally add further information like the message length (size of the send buffer).

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
uint32_t	receiver	MPI rank of receiver in `communicator`.
OTF2_CommRef	communicator	Communicator ID. References a Comm, or a InterComm definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_COMM is available.
uint32_t	msgTag	Message tag
uint64_t	msgLength	Message length

See also: OTF2_EvtWriter_MpiSend(); OTF2_GlobalEvtReaderCallbacks_SetMpiSendCallback(); OTF2_EvtReaderCallbacks_SetMpiSendCallback()

Since: Version 1.0

MpiIsend

An MpiIsend record indicates that a non-blocking MPI send operation was initiated (MPI_ISEND). It keeps the necessary information for this event: receiver of the message, communicator, and the message tag. You can optionally add further information like the message length (size of the send buffer).

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
uint32_t	receiver	MPI rank of receiver in `communicator`.
OTF2_CommRef	communicator	Communicator ID. References a Comm, or a InterComm definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_COMM is available.
uint32_t	msgTag	Message tag
uint64_t	msgLength	Message length
uint64_t	requestID	ID of the related request

See also: OTF2_EvtWriter_MpiIsend(); OTF2_GlobalEvtReaderCallbacks_SetMpiIsendCallback(); OTF2_EvtReaderCallbacks_SetMpiIsendCallback()

Since: Version 1.0

MpiIsendComplete

An MpiIsendComplete record indicates the completion of a non- blocking MPI send operation. In the case where the send request is released before it is completed by MPI, this record will only indicate the release, as it becomes impossible to track the completion of the send operation afterwards. This case may be identified by the surrounding events.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
uint64_t	requestID	ID of the related request

See also: OTF2_EvtWriter_MpiIsendComplete(); OTF2_GlobalEvtReaderCallbacks_SetMpiIsendCompleteCallback(); OTF2_EvtReaderCallbacks_SetMpiIsendCompleteCallback()

Since: Version 1.0

MpiIrecvRequest

An MpiIrecvRequest record indicates that a non-blocking MPI receive operation was initiated (MPI_IRECV).

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
uint64_t	requestID	ID of the requested receive

See also: OTF2_EvtWriter_MpiIrecvRequest(); OTF2_GlobalEvtReaderCallbacks_SetMpiIrecvRequestCallback(); OTF2_EvtReaderCallbacks_SetMpiIrecvRequestCallback()

Since: Version 1.0

MpiRecv

An MpiRecv record indicates that an MPI message was received (MPI_RECV). It keeps the necessary information for this event: sender of the message, communicator, and the message tag. You can optionally add further information like the message length (size of the receive buffer).

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
uint32_t	sender	MPI rank of sender in `communicator`.
OTF2_CommRef	communicator	Communicator ID. References a Comm, or a InterComm definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_COMM is available.
uint32_t	msgTag	Message tag
uint64_t	msgLength	Message length

See also: OTF2_EvtWriter_MpiRecv(); OTF2_GlobalEvtReaderCallbacks_SetMpiRecvCallback(); OTF2_EvtReaderCallbacks_SetMpiRecvCallback()

Since: Version 1.0

MpiIrecv

An MpiIrecv record indicates the completion of a non-blocking MPI receive operation completed (MPI_IRECV). It keeps the necessary information for this event: sender of the message, communicator, and the message tag. You can optionally add further information like the message length (size of the receive buffer).

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
uint32_t	sender	MPI rank of sender in `communicator`.
OTF2_CommRef	communicator	Communicator ID. References a Comm, or a InterComm definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_COMM is available.
uint32_t	msgTag	Message tag
uint64_t	msgLength	Message length
uint64_t	requestID	ID of the related request

See also: OTF2_EvtWriter_MpiIrecv(); OTF2_GlobalEvtReaderCallbacks_SetMpiIrecvCallback(); OTF2_EvtReaderCallbacks_SetMpiIrecvCallback()

Since: Version 1.0

MpiRequestTest

This events appears if the program tests if a request has already completed but the test failed.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
uint64_t	requestID	ID of the related request

See also: OTF2_EvtWriter_MpiRequestTest(); OTF2_GlobalEvtReaderCallbacks_SetMpiRequestTestCallback(); OTF2_EvtReaderCallbacks_SetMpiRequestTestCallback()

Since: Version 1.0

MpiRequestCancelled

This events appears if the program canceled a request.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
uint64_t	requestID	ID of the related request

See also: OTF2_EvtWriter_MpiRequestCancelled(); OTF2_GlobalEvtReaderCallbacks_SetMpiRequestCancelledCallback(); OTF2_EvtReaderCallbacks_SetMpiRequestCancelledCallback()

Since: Version 1.0

MpiCollectiveBegin

An MpiCollectiveBegin record marks the begin of an MPI collective operation (MPI_GATHER, MPI_SCATTER etc.).

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.

See also: OTF2_EvtWriter_MpiCollectiveBegin(); OTF2_GlobalEvtReaderCallbacks_SetMpiCollectiveBeginCallback(); OTF2_EvtReaderCallbacks_SetMpiCollectiveBeginCallback()

Since: Version 1.0

MpiCollectiveEnd

An MpiCollectiveEnd record marks the end of an MPI collective operation (MPI_GATHER, MPI_SCATTER etc.). It keeps the necessary information for this event: type of collective operation, communicator, the root of this collective operation. You can optionally add further information like sent and received bytes.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_CollectiveOp	collectiveOp	Determines which collective operation it is.
OTF2_CommRef	communicator	Communicator References a Comm, or a InterComm definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_COMM is available.
uint32_t	root	Rank of root in `communicator` or any predefined constant of OTF2_CollectiveRoot.
uint64_t	sizeSent	Size of the sent message.
uint64_t	sizeReceived	Size of the received message.

See also: OTF2_EvtWriter_MpiCollectiveEnd(); OTF2_GlobalEvtReaderCallbacks_SetMpiCollectiveEndCallback(); OTF2_EvtReaderCallbacks_SetMpiCollectiveEndCallback()

Since: Version 1.0

OmpFork

An OmpFork record marks that an OpenMP Thread forks a thread team.

This event record is superseded by the ThreadFork event record and should not be used when the ThreadFork event record is in use.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
uint32_t	numberOfRequestedThreads	Requested size of the team.

See also: OTF2_EvtWriter_OmpFork(); OTF2_GlobalEvtReaderCallbacks_SetOmpForkCallback(); OTF2_EvtReaderCallbacks_SetOmpForkCallback()

Since: Version 1.0

Deprecated:: In version 1.2

OmpJoin

An OmpJoin record marks that a team of threads is joint and only the master thread continues execution.

This event record is superseded by the ThreadJoin event record and should not be used when the ThreadJoin event record is in use.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.

See also: OTF2_EvtWriter_OmpJoin(); OTF2_GlobalEvtReaderCallbacks_SetOmpJoinCallback(); OTF2_EvtReaderCallbacks_SetOmpJoinCallback()

Since: Version 1.0

Deprecated:: In version 1.2

OmpAcquireLock

An OmpAcquireLock record marks that a thread acquires an OpenMP lock.

This event record is superseded by the ThreadAcquireLock event record and should not be used when the ThreadAcquireLock event record is in use.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
uint32_t	lockID	ID of the lock.
uint32_t	acquisitionOrder	A monotonically increasing number to determine the order of lock acquisitions (with unsynchronized clocks this is otherwise not possible). Corresponding acquire-release events have same number.

See also: OTF2_EvtWriter_OmpAcquireLock(); OTF2_GlobalEvtReaderCallbacks_SetOmpAcquireLockCallback(); OTF2_EvtReaderCallbacks_SetOmpAcquireLockCallback()

Since: Version 1.0

Deprecated:: In version 1.2

OmpReleaseLock

An OmpReleaseLock record marks that a thread releases an OpenMP lock.

This event record is superseded by the ThreadReleaseLock event record and should not be used when the ThreadReleaseLock event record is in use.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
uint32_t	lockID	ID of the lock.
uint32_t	acquisitionOrder	A monotonically increasing number to determine the order of lock acquisitions (with unsynchronized clocks this is otherwise not possible). Corresponding acquire-release events have same number.

See also: OTF2_EvtWriter_OmpReleaseLock(); OTF2_GlobalEvtReaderCallbacks_SetOmpReleaseLockCallback(); OTF2_EvtReaderCallbacks_SetOmpReleaseLockCallback()

Since: Version 1.0

Deprecated:: In version 1.2

OmpTaskCreate

An OmpTaskCreate record marks that an OpenMP Task was/will be created in the current region.

This event record is superseded by the ThreadTaskCreate event record and should not be used when the ThreadTaskCreate event record is in use.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
uint64_t	taskID	Identifier of the newly created task instance.

See also: OTF2_EvtWriter_OmpTaskCreate(); OTF2_GlobalEvtReaderCallbacks_SetOmpTaskCreateCallback(); OTF2_EvtReaderCallbacks_SetOmpTaskCreateCallback()

Since: Version 1.0

Deprecated:: In version 1.2

OmpTaskSwitch

An OmpTaskSwitch record indicates that the execution of the current task will be suspended and another task starts/restarts its execution. Please note that this may change the current call stack of the executing location.

This event record is superseded by the ThreadTaskSwitch event record and should not be used when the ThreadTaskSwitch event record is in use.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
uint64_t	taskID	Identifier of the now active task instance.

See also: OTF2_EvtWriter_OmpTaskSwitch(); OTF2_GlobalEvtReaderCallbacks_SetOmpTaskSwitchCallback(); OTF2_EvtReaderCallbacks_SetOmpTaskSwitchCallback()

Since: Version 1.0

Deprecated:: In version 1.2

OmpTaskComplete

An OmpTaskComplete record indicates that the execution of an OpenMP task has finished.

This event record is superseded by the ThreadTaskComplete event record and should not be used when the ThreadTaskComplete event record is in use.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
uint64_t	taskID	Identifier of the completed task instance.

See also: OTF2_EvtWriter_OmpTaskComplete(); OTF2_GlobalEvtReaderCallbacks_SetOmpTaskCompleteCallback(); OTF2_EvtReaderCallbacks_SetOmpTaskCompleteCallback()

Since: Version 1.0

Deprecated:: In version 1.2

Metric

A Metric event is always stored at the location that recorded the metric. The event can reference a MetricClass or MetricInstance. Therefore, metric classes and instances share same ID space. Synchronous metrics are always located right immediately the corresponding Enter and Leave event.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_MetricRef	metric	Could be a metric class or a metric instance. References a MetricClass, or a MetricInstance definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_METRIC is available.
uint8_t	numberOfMetrics	Number of metrics with in the set.
OTF2_Type	typeIDs [ numberOfMetrics ]	List of metric types. These types must match that of the corresponding MetricMember definitions.
OTF2_MetricValue	metricValues [ numberOfMetrics ]	List of metric values.

See also: OTF2_EvtWriter_Metric(); OTF2_GlobalEvtReaderCallbacks_SetMetricCallback(); OTF2_EvtReaderCallbacks_SetMetricCallback()

Since: Version 1.0

ParameterString

A ParameterString record marks that in the current region, the specified string parameter has the specified value.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_ParameterRef	parameter	Parameter ID. References a Parameter definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_PARAMETER is available.
OTF2_StringRef	string	Value: Handle of a string definition References a String definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_STRING is available.

See also: OTF2_EvtWriter_ParameterString(); OTF2_GlobalEvtReaderCallbacks_SetParameterStringCallback(); OTF2_EvtReaderCallbacks_SetParameterStringCallback()

Since: Version 1.0

ParameterInt

A ParameterInt record marks that in the current region, the specified integer parameter has the specified value.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_ParameterRef	parameter	Parameter ID. References a Parameter definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_PARAMETER is available.
int64_t	value	Value of the recorded parameter.

See also: OTF2_EvtWriter_ParameterInt(); OTF2_GlobalEvtReaderCallbacks_SetParameterIntCallback(); OTF2_EvtReaderCallbacks_SetParameterIntCallback()

Since: Version 1.0

ParameterUnsignedInt

A ParameterUnsignedInt record marks that in the current region, the specified unsigned integer parameter has the specified value.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_ParameterRef	parameter	Parameter ID. References a Parameter definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_PARAMETER is available.
uint64_t	value	Value of the recorded parameter.

See also: OTF2_EvtWriter_ParameterUnsignedInt(); OTF2_GlobalEvtReaderCallbacks_SetParameterUnsignedIntCallback(); OTF2_EvtReaderCallbacks_SetParameterUnsignedIntCallback()

Since: Version 1.0

RmaWinCreate

An RmaWinCreate record denotes the creation of an RMA window. Only valid if the RmaWin definition was flagged with OTF2_RMA_WIN_FLAG_CREATE_DESTROY_EVENTS. This event can be enclosed by an RmaCollectiveBegin and RmaCollectiveEnd event pair either with OTF2_COLLECTIVE_OP_CREATE_HANDLE or OTF2_COLLECTIVE_OP_CREATE_HANDLE_AND_ALLOCATE as the operation type.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_RmaWinRef	win	ID of the window created. References a RmaWin definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_RMA_WIN is available.

See also: OTF2_EvtWriter_RmaWinCreate(); OTF2_GlobalEvtReaderCallbacks_SetRmaWinCreateCallback(); OTF2_EvtReaderCallbacks_SetRmaWinCreateCallback()

Since: Version 1.2

RmaWinDestroy

An RmaWinDestroy record denotes the destruction of an RMA window. Only valid if the RmaWin definition was flagged with OTF2_RMA_WIN_FLAG_CREATE_DESTROY_EVENTS. This event can be enclosed by an RmaCollectiveBegin and RmaCollectiveEnd event pair either with OTF2_COLLECTIVE_OP_DESTROY_HANDLE or OTF2_COLLECTIVE_OP_DESTROY_HANDLE_AND_DEALLOCATE as the operation type. In this case the RMA window is only marked for destruction, which will happen with the RmaCollectiveEnd event.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_RmaWinRef	win	ID of the window destructed. References a RmaWin definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_RMA_WIN is available.

See also: OTF2_EvtWriter_RmaWinDestroy(); OTF2_GlobalEvtReaderCallbacks_SetRmaWinDestroyCallback(); OTF2_EvtReaderCallbacks_SetRmaWinDestroyCallback()

Since: Version 1.2

RmaCollectiveBegin

An RmaCollectiveBegin record denotes the beginning of a collective RMA operation.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.

See also: OTF2_EvtWriter_RmaCollectiveBegin(); OTF2_GlobalEvtReaderCallbacks_SetRmaCollectiveBeginCallback(); OTF2_EvtReaderCallbacks_SetRmaCollectiveBeginCallback()

Since: Version 1.2

RmaCollectiveEnd

An RmaCollectiveEnd record denotes the end of a collective RMA operation.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_CollectiveOp	collectiveOp	Determines which collective operation it is.
OTF2_RmaSyncLevel	syncLevel	Synchronization level of this collective operation.
OTF2_RmaWinRef	win	ID of the window used for this operation. References a RmaWin definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_RMA_WIN is available.
uint32_t	root	Root process for this operation or any predefined constant of OTF2_CollectiveRoot.
uint64_t	bytesSent	Bytes sent in operation.
uint64_t	bytesReceived	Bytes receives in operation.

See also: OTF2_EvtWriter_RmaCollectiveEnd(); OTF2_GlobalEvtReaderCallbacks_SetRmaCollectiveEndCallback(); OTF2_EvtReaderCallbacks_SetRmaCollectiveEndCallback()

Since: Version 1.2

RmaGroupSync

An RmaGroupSync record denotes the synchronization with a subgroup of processes on an RMA window.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_RmaSyncLevel	syncLevel	Synchronization level of this collective operation.
OTF2_RmaWinRef	win	ID of the window used for this operation. References a RmaWin definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_RMA_WIN is available.
OTF2_GroupRef	group	Group of remote processes involved in synchronization. References a Group definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_GROUP is available.

See also: OTF2_EvtWriter_RmaGroupSync(); OTF2_GlobalEvtReaderCallbacks_SetRmaGroupSyncCallback(); OTF2_EvtReaderCallbacks_SetRmaGroupSyncCallback()

Since: Version 1.2

RmaRequestLock

An RmaRequestLock record denotes the time a lock was requested and with it the earliest time it could have been granted. It is used to mark (possibly) non-blocking lock request, as defined by the MPI standard.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_RmaWinRef	win	ID of the window used for this operation. References a RmaWin definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_RMA_WIN is available.
uint32_t	remote	Rank of the locked remote process or OTF2_UNDEFINED_UINT32 if all processes of the specified window are locked.
uint64_t	lockId	ID of the lock acquired, if multiple locks are defined on a window.
OTF2_LockType	lockType	Type of lock acquired.

See also: OTF2_EvtWriter_RmaRequestLock(); OTF2_GlobalEvtReaderCallbacks_SetRmaRequestLockCallback(); OTF2_EvtReaderCallbacks_SetRmaRequestLockCallback()

Since: Version 1.2

RmaAcquireLock

An RmaAcquireLock record denotes the time a lock was acquired by the process.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_RmaWinRef	win	ID of the window used for this operation. References a RmaWin definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_RMA_WIN is available.
uint32_t	remote	Rank of the locked remote process or OTF2_UNDEFINED_UINT32 if all processes of the specified window are locked.
uint64_t	lockId	ID of the lock acquired, if multiple locks are defined on a window.
OTF2_LockType	lockType	Type of lock acquired.

See also: OTF2_EvtWriter_RmaAcquireLock(); OTF2_GlobalEvtReaderCallbacks_SetRmaAcquireLockCallback(); OTF2_EvtReaderCallbacks_SetRmaAcquireLockCallback()

Since: Version 1.2

RmaTryLock

An RmaTryLock record denotes the time of an unsuccessful attempt to acquire the lock.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_RmaWinRef	win	ID of the window used for this operation. References a RmaWin definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_RMA_WIN is available.
uint32_t	remote	Rank of the locked remote process or OTF2_UNDEFINED_UINT32 if all processes of the specified window are locked.
uint64_t	lockId	ID of the lock acquired, if multiple locks are defined on a window.
OTF2_LockType	lockType	Type of lock acquired.

See also: OTF2_EvtWriter_RmaTryLock(); OTF2_GlobalEvtReaderCallbacks_SetRmaTryLockCallback(); OTF2_EvtReaderCallbacks_SetRmaTryLockCallback()

Since: Version 1.2

RmaReleaseLock

An RmaReleaseLock record denotes the time the lock was released.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_RmaWinRef	win	ID of the window used for this operation. References a RmaWin definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_RMA_WIN is available.
uint32_t	remote	Rank of the locked remote process or OTF2_UNDEFINED_UINT32 if all processes of the specified window are locked.
uint64_t	lockId	ID of the lock released, if multiple locks are defined on a window.

See also: OTF2_EvtWriter_RmaReleaseLock(); OTF2_GlobalEvtReaderCallbacks_SetRmaReleaseLockCallback(); OTF2_EvtReaderCallbacks_SetRmaReleaseLockCallback()

Since: Version 1.2

RmaSync

An RmaSync record denotes the direct synchronization with a possibly remote process.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_RmaWinRef	win	ID of the window used for this operation. References a RmaWin definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_RMA_WIN is available.
uint32_t	remote	Rank of the locked remote process.
OTF2_RmaSyncType	syncType	Type of synchronization.

See also: OTF2_EvtWriter_RmaSync(); OTF2_GlobalEvtReaderCallbacks_SetRmaSyncCallback(); OTF2_EvtReaderCallbacks_SetRmaSyncCallback()

Since: Version 1.2

RmaWaitChange

An RmaWaitChange record denotes the change of a window that was waited for.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_RmaWinRef	win	ID of the window used for this operation. References a RmaWin definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_RMA_WIN is available.

See also: OTF2_EvtWriter_RmaWaitChange(); OTF2_GlobalEvtReaderCallbacks_SetRmaWaitChangeCallback(); OTF2_EvtReaderCallbacks_SetRmaWaitChangeCallback()

Since: Version 1.2

RmaPut

An RmaPut record denotes the time a put operation was issued.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_RmaWinRef	win	ID of the window used for this operation. References a RmaWin definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_RMA_WIN is available.
uint32_t	remote	Rank of the target process.
uint64_t	bytes	Bytes sent to target.
uint64_t	matchingId	ID used for matching the corresponding completion record.

See also: OTF2_EvtWriter_RmaPut(); OTF2_GlobalEvtReaderCallbacks_SetRmaPutCallback(); OTF2_EvtReaderCallbacks_SetRmaPutCallback()

Since: Version 1.2

RmaGet

An RmaGet record denotes the time a get operation was issued.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_RmaWinRef	win	ID of the window used for this operation. References a RmaWin definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_RMA_WIN is available.
uint32_t	remote	Rank of the target process.
uint64_t	bytes	Bytes received from target.
uint64_t	matchingId	ID used for matching the corresponding completion record.

See also: OTF2_EvtWriter_RmaGet(); OTF2_GlobalEvtReaderCallbacks_SetRmaGetCallback(); OTF2_EvtReaderCallbacks_SetRmaGetCallback()

Since: Version 1.2

RmaAtomic

An RmaAtomic record denotes the time an atomic RMA operation was issued.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_RmaWinRef	win	ID of the window used for this operation. References a RmaWin definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_RMA_WIN is available.
uint32_t	remote	Rank of the target process.
OTF2_RmaAtomicType	type	Type of atomic operation.
uint64_t	bytesSent	Bytes sent to target.
uint64_t	bytesReceived	Bytes received from target.
uint64_t	matchingId	ID used for matching the corresponding completion record.

See also: OTF2_EvtWriter_RmaAtomic(); OTF2_GlobalEvtReaderCallbacks_SetRmaAtomicCallback(); OTF2_EvtReaderCallbacks_SetRmaAtomicCallback()

Since: Version 1.2

RmaOpCompleteBlocking

An RmaOpCompleteBlocking record denotes the local completion of a blocking RMA operation.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_RmaWinRef	win	ID of the window used for this operation. References a RmaWin definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_RMA_WIN is available.
uint64_t	matchingId	ID used for matching the corresponding RMA operation record.

See also: OTF2_EvtWriter_RmaOpCompleteBlocking(); OTF2_GlobalEvtReaderCallbacks_SetRmaOpCompleteBlockingCallback(); OTF2_EvtReaderCallbacks_SetRmaOpCompleteBlockingCallback()

Since: Version 1.2

RmaOpCompleteNonBlocking

An RmaOpCompleteNonBlocking record denotes the local completion of a non-blocking RMA operation.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_RmaWinRef	win	ID of the window used for this operation. References a RmaWin definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_RMA_WIN is available.
uint64_t	matchingId	ID used for matching the corresponding RMA operation record.

See also: OTF2_EvtWriter_RmaOpCompleteNonBlocking(); OTF2_GlobalEvtReaderCallbacks_SetRmaOpCompleteNonBlockingCallback(); OTF2_EvtReaderCallbacks_SetRmaOpCompleteNonBlockingCallback()

Since: Version 1.2

RmaOpTest

An RmaOpTest record denotes that a non-blocking RMA operation has been tested for completion unsuccessfully.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_RmaWinRef	win	ID of the window used for this operation. References a RmaWin definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_RMA_WIN is available.
uint64_t	matchingId	ID used for matching the corresponding RMA operation record.

See also: OTF2_EvtWriter_RmaOpTest(); OTF2_GlobalEvtReaderCallbacks_SetRmaOpTestCallback(); OTF2_EvtReaderCallbacks_SetRmaOpTestCallback()

Since: Version 1.2

RmaOpCompleteRemote

An RmaOpCompleteRemote record denotes the remote completion of an RMA operation.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_RmaWinRef	win	ID of the window used for this operation. References a RmaWin definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_RMA_WIN is available.
uint64_t	matchingId	ID used for matching the corresponding RMA operation record.

See also: OTF2_EvtWriter_RmaOpCompleteRemote(); OTF2_GlobalEvtReaderCallbacks_SetRmaOpCompleteRemoteCallback(); OTF2_EvtReaderCallbacks_SetRmaOpCompleteRemoteCallback()

Since: Version 1.2

ThreadFork

A ThreadFork record marks that a thread forks a thread team.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_Paradigm	model	The threading paradigm this event took place.
uint32_t	numberOfRequestedThreads	Requested size of the team.

See also: OTF2_EvtWriter_ThreadFork(); OTF2_GlobalEvtReaderCallbacks_SetThreadForkCallback(); OTF2_EvtReaderCallbacks_SetThreadForkCallback()

Since: Version 1.2

ThreadJoin

A ThreadJoin record marks that a team of threads is joint and only the master thread continues execution.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_Paradigm	model	The threading paradigm this event took place.

See also: OTF2_EvtWriter_ThreadJoin(); OTF2_GlobalEvtReaderCallbacks_SetThreadJoinCallback(); OTF2_EvtReaderCallbacks_SetThreadJoinCallback()

Since: Version 1.2

ThreadTeamBegin

The current location enters the specified thread team.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_CommRef	threadTeam	Thread team References a Comm, or a InterComm definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_COMM is available.

See also: OTF2_EvtWriter_ThreadTeamBegin(); OTF2_GlobalEvtReaderCallbacks_SetThreadTeamBeginCallback(); OTF2_EvtReaderCallbacks_SetThreadTeamBeginCallback()

Since: Version 1.2

ThreadTeamEnd

The current location leaves the specified thread team.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_CommRef	threadTeam	Thread team References a Comm, or a InterComm definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_COMM is available.

See also: OTF2_EvtWriter_ThreadTeamEnd(); OTF2_GlobalEvtReaderCallbacks_SetThreadTeamEndCallback(); OTF2_EvtReaderCallbacks_SetThreadTeamEndCallback()

Since: Version 1.2

ThreadAcquireLock

A ThreadAcquireLock record marks that a thread acquires a lock.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_Paradigm	model	The threading paradigm this event took place.
uint32_t	lockID	ID of the lock.
uint32_t	acquisitionOrder	A monotonically increasing number to determine the order of lock acquisitions (with unsynchronized clocks this is otherwise not possible). Corresponding acquire-release events have same number.

See also: OTF2_EvtWriter_ThreadAcquireLock(); OTF2_GlobalEvtReaderCallbacks_SetThreadAcquireLockCallback(); OTF2_EvtReaderCallbacks_SetThreadAcquireLockCallback()

Since: Version 1.2

ThreadReleaseLock

A ThreadReleaseLock record marks that a thread releases a lock.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_Paradigm	model	The threading paradigm this event took place.
uint32_t	lockID	ID of the lock.
uint32_t	acquisitionOrder	A monotonically increasing number to determine the order of lock acquisitions (with unsynchronized clocks this is otherwise not possible). Corresponding acquire-release events have same number.

See also: OTF2_EvtWriter_ThreadReleaseLock(); OTF2_GlobalEvtReaderCallbacks_SetThreadReleaseLockCallback(); OTF2_EvtReaderCallbacks_SetThreadReleaseLockCallback()

Since: Version 1.2

ThreadTaskCreate

A ThreadTaskCreate record marks that a task in was/will be created and will be processed by the specified thread team.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_CommRef	threadTeam	Thread team References a Comm, or a InterComm definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_COMM is available.
uint32_t	creatingThread	Creating thread of this task.
uint32_t	generationNumber	Thread-private generation number of task's creating thread.

See also: OTF2_EvtWriter_ThreadTaskCreate(); OTF2_GlobalEvtReaderCallbacks_SetThreadTaskCreateCallback(); OTF2_EvtReaderCallbacks_SetThreadTaskCreateCallback()

Since: Version 1.2

ThreadTaskSwitch

A ThreadTaskSwitch record indicates that the execution of the current task will be suspended and another task starts/restarts its execution. Please note that this may change the current call stack of the executing location.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_CommRef	threadTeam	Thread team References a Comm, or a InterComm definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_COMM is available.
uint32_t	creatingThread	Creating thread of this task.
uint32_t	generationNumber	Thread-private generation number of task's creating thread.

See also: OTF2_EvtWriter_ThreadTaskSwitch(); OTF2_GlobalEvtReaderCallbacks_SetThreadTaskSwitchCallback(); OTF2_EvtReaderCallbacks_SetThreadTaskSwitchCallback()

Since: Version 1.2

ThreadTaskComplete

A ThreadTaskComplete record indicates that the execution of an OpenMP task has finished.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_CommRef	threadTeam	Thread team References a Comm, or a InterComm definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_COMM is available.
uint32_t	creatingThread	Creating thread of this task.
uint32_t	generationNumber	Thread-private generation number of task's creating thread.

See also: OTF2_EvtWriter_ThreadTaskComplete(); OTF2_GlobalEvtReaderCallbacks_SetThreadTaskCompleteCallback(); OTF2_EvtReaderCallbacks_SetThreadTaskCompleteCallback()

Since: Version 1.2

ThreadCreate

The location created successfully a new thread.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_CommRef	threadContingent	The thread contingent. References a Comm, or a InterComm definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_COMM is available.
uint64_t	sequenceCount	A `threadContingent` unique number. The corresponding ThreadBegin event does have the same number.

See also: OTF2_EvtWriter_ThreadCreate(); OTF2_GlobalEvtReaderCallbacks_SetThreadCreateCallback(); OTF2_EvtReaderCallbacks_SetThreadCreateCallback()

Since: Version 1.3

ThreadBegin

Marks the begin of a thread created by another thread.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_CommRef	threadContingent	The thread contingent. References a Comm, or a InterComm definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_COMM is available.
uint64_t	sequenceCount	A `threadContingent` unique number. The corresponding ThreadCreate event does have the same number.

See also: OTF2_EvtWriter_ThreadBegin(); OTF2_GlobalEvtReaderCallbacks_SetThreadBeginCallback(); OTF2_EvtReaderCallbacks_SetThreadBeginCallback()

Since: Version 1.3

ThreadWait

The location waits for the completion of another thread.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_CommRef	threadContingent	The thread contingent. References a Comm, or a InterComm definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_COMM is available.
uint64_t	sequenceCount	A `threadContingent` unique number. The corresponding ThreadEnd event does have the same number.

See also: OTF2_EvtWriter_ThreadWait(); OTF2_GlobalEvtReaderCallbacks_SetThreadWaitCallback(); OTF2_EvtReaderCallbacks_SetThreadWaitCallback()

Since: Version 1.3

ThreadEnd

Marks the end of a thread.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_CommRef	threadContingent	The thread contingent. References a Comm, or a InterComm definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_COMM is available.
uint64_t	sequenceCount	A `threadContingent` unique number. The corresponding ThreadWait event does have the same number. OTF2_UNDEFINED_UINT64 in case no corresponding ThreadWait event exists.

See also: OTF2_EvtWriter_ThreadEnd(); OTF2_GlobalEvtReaderCallbacks_SetThreadEndCallback(); OTF2_EvtReaderCallbacks_SetThreadEndCallback()

Since: Version 1.3

CallingContextEnter

The thread entered an instrumented region, represented by the referenced CallingContext. In contrast to the Enter event, it gives the full calling context through the CallingContext tree.

Events based on the CallingContext definition are mutually exclusive with the Enter/Leave events in a trace.

If no callback for this event is set but a callback for Enter events is defined, the reader will automatically generate an Enter callback call for the Region referenced by the CallingContext attribute of this event. Note that this emulation does not re-create the full calling context! It only re-creates the event order for instrumented regions.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_CallingContextRef	callingContext	The entered region as referenced by the CallingContext definition. References a CallingContext definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_CALLING_CONTEXT is available.
uint32_t	unwindDistance	The unwindDistance for this `callingContext`. See the description in CallingContext.

See also: OTF2_EvtWriter_CallingContextEnter(); OTF2_GlobalEvtReaderCallbacks_SetCallingContextEnterCallback(); OTF2_EvtReaderCallbacks_SetCallingContextEnterCallback()

Since: Version 2.0

CallingContextLeave

The thread left an instrumented region, represented by the referenced CallingContext. In contrast to the Leave event, it gives the full calling context through the CallingContext tree.

The unwind distance for this CallingContext is defined to be 1. Because it must be assumed that the instrumented region made progress since the previous CallingContext event.

Events based on the CallingContext definition are mutually exclusive with the Enter/Leave events in a trace.

The parent of the CallingContext must be used as the previous calling context for the next event.

If no callback for this event is set but a callback for Leave events is defined, the reader will automatically generate an Leave callback call for the Region referenced by the CallingContext attribute of this event. Note that this emulation does not re-create the full calling context! It only re-creates the event order for instrumented regions.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_CallingContextRef	callingContext	The left region as referenced by the CallingContext definition. References a CallingContext definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_CALLING_CONTEXT is available.

See also: OTF2_EvtWriter_CallingContextLeave(); OTF2_GlobalEvtReaderCallbacks_SetCallingContextLeaveCallback(); OTF2_EvtReaderCallbacks_SetCallingContextLeaveCallback()

Since: Version 2.0

CallingContextSample

The thread was interrupted to take a sample of its current state (region and source code location).

Events based on the CallingContext definition are mutually exclusive with the Enter/Leave events in a trace.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_CallingContextRef	callingContext	Describes the calling context of the thread when it was interrupted. References a CallingContext definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_CALLING_CONTEXT is available.
uint32_t	unwindDistance	The unwindDistance for this `callingContext`. See the description in CallingContext.
OTF2_InterruptGeneratorRef	interruptGenerator	References a InterruptGenerator definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_INTERRUPT_GENERATOR is available.

See also: OTF2_EvtWriter_CallingContextSample(); OTF2_GlobalEvtReaderCallbacks_SetCallingContextSampleCallback(); OTF2_EvtReaderCallbacks_SetCallingContextSampleCallback()

Since: Version 1.5

IoCreateHandle

An IoCreateHandle record marks the creation of a new active I/O handle that can be used by subsequent I/O operation events.

An IoHandle is active between a pair of consecutive IoCreateHandle and IoDestroyHandle events. All Locations of a LocationGroup have access to an active IoHandle.

If the Comm attribute of the IoHandle handle is not OTF2_UNDEFINED_COMM, this is a collective operation over Comm.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_IoHandleRef	handle	A previously inactive I/O handle which will be activated by this record. References a IoHandle definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_IO_HANDLE is available.
OTF2_IoAccessMode	mode	Determines which I/O operations can be applied to this I/O handle (e.g., read-only, write-only, read-write).
OTF2_IoCreationFlag	creationFlags	Requested I/O handle creation flags (e.g., create, exclusive, etc.).
OTF2_IoStatusFlag	statusFlags	I/O handle status flags which will be associated with the `handle` attribute (e.g., append, create, close-on-exec, async, etc).

See also: OTF2_EvtWriter_IoCreateHandle(); OTF2_GlobalEvtReaderCallbacks_SetIoCreateHandleCallback(); OTF2_EvtReaderCallbacks_SetIoCreateHandleCallback()

Since: Version 2.1

IoDestroyHandle

An IoDestroyHandle record marks the end of an active I/O handle's lifetime.

An IoHandle is active between a pair of consecutive IoCreateHandle and IoDestroyHandle events. All Locations of a LocationGroup have access to an active IoHandle.

If the Comm attribute of the IoHandle handle is not OTF2_UNDEFINED_COMM, this is a collective operation over Comm.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_IoHandleRef	handle	An active I/O handle which will be inactivated by this records. References a IoHandle definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_IO_HANDLE is available.

See also: OTF2_EvtWriter_IoDestroyHandle(); OTF2_GlobalEvtReaderCallbacks_SetIoDestroyHandleCallback(); OTF2_EvtReaderCallbacks_SetIoDestroyHandleCallback()

Since: Version 2.1

IoDuplicateHandle

An IoDuplicateHandle record marks the duplication of an already existing active I/O handle.

The new I/O handle newHandle is active after this event.

Both IoHandles must reference the same Comm definition or be OTF2_UNDEFINED_COMM. If the Comm attribute of the IoHandle handles is not OTF2_UNDEFINED_COMM, this is a collective operation over Comm.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_IoHandleRef	oldHandle	An active I/O handle. References a IoHandle definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_IO_HANDLE is available.
OTF2_IoHandleRef	newHandle	A previously inactive I/O handle which will be activated by this record. References a IoHandle definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_IO_HANDLE is available.
OTF2_IoStatusFlag	statusFlags	The status flag for the new I/O handle `newHandle`. No status flags will be inherited from the I/O handle `oldHandle`.

See also: OTF2_EvtWriter_IoDuplicateHandle(); OTF2_GlobalEvtReaderCallbacks_SetIoDuplicateHandleCallback(); OTF2_EvtReaderCallbacks_SetIoDuplicateHandleCallback()

Since: Version 2.1

IoSeek

An IoSeek record marks a change of the position, e.g., within a file.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_IoHandleRef	handle	An active I/O handle. References a IoHandle definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_IO_HANDLE is available.
int64_t	offsetRequest	Requested offset.
OTF2_IoSeekOption	whence	Position inside the file from where `offsetRequest` should be applied (e.g., absolute from the start or end, relative to the current position).
uint64_t	offsetResult	Resulting offset, e.g., within the file relative to the beginning of the file.

See also: OTF2_EvtWriter_IoSeek(); OTF2_GlobalEvtReaderCallbacks_SetIoSeekCallback(); OTF2_EvtReaderCallbacks_SetIoSeekCallback()

Since: Version 2.1

IoChangeStatusFlags

An IoChangeStatusFlags record marks a change to the status flags associated with an active I/O handle.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_IoHandleRef	handle	An active I/O handle. References a IoHandle definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_IO_HANDLE is available.
OTF2_IoStatusFlag	statusFlags	Set flags (e.g., close-on-exec, append, etc.).

See also: OTF2_EvtWriter_IoChangeStatusFlags(); OTF2_GlobalEvtReaderCallbacks_SetIoChangeStatusFlagsCallback(); OTF2_EvtReaderCallbacks_SetIoChangeStatusFlagsCallback()

Since: Version 2.1

IoDeleteFile

An IoDeleteFile record marks the deletion of an I/O file.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_IoParadigmRef	ioParadigm	The I/O paradigm which induced the deletion. References a IoParadigm definition.
OTF2_IoFileRef	file	File identifier. References a IoRegularFile, or a IoDirectory definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_IO_FILE is available.

See also: OTF2_EvtWriter_IoDeleteFile(); OTF2_GlobalEvtReaderCallbacks_SetIoDeleteFileCallback(); OTF2_EvtReaderCallbacks_SetIoDeleteFileCallback()

Since: Version 2.1

IoOperationBegin

An IoOperationBegin record marks the begin of a file operation (read, write, etc.).

See Event order for I/O operation records for the possible event orders.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_IoHandleRef	handle	An active I/O handle. References a IoHandle definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_IO_HANDLE is available.
OTF2_IoOperationMode	mode	Mode of an I/O handle operation (e.g., read or write).
OTF2_IoOperationFlag	operationFlags	Special semantic of this operation.
uint64_t	bytesRequest	Requested bytes to write/read.
uint64_t	matchingId	Identifier used to correlate associated event records of an I/O operation. This identifier is unique for the referenced IoHandle.

See also: OTF2_EvtWriter_IoOperationBegin(); OTF2_GlobalEvtReaderCallbacks_SetIoOperationBeginCallback(); OTF2_EvtReaderCallbacks_SetIoOperationBeginCallback()

Since: Version 2.1

IoOperationTest

An IoOperationTest record marks an unsuccessful test whether an I/O operation has already finished.

See Event order for I/O operation records for the possible event orders.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_IoHandleRef	handle	An active I/O handle. References a IoHandle definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_IO_HANDLE is available.
uint64_t	matchingId	Identifier used to correlate associated event records of an I/O operation. This identifier is unique for the referenced IoHandle.

See also: OTF2_EvtWriter_IoOperationTest(); OTF2_GlobalEvtReaderCallbacks_SetIoOperationTestCallback(); OTF2_EvtReaderCallbacks_SetIoOperationTestCallback()

Since: Version 2.1

IoOperationIssued

An IoOperationIssued record marks the successful initiation of a non-blocking operation (read, write, etc.) on an active I/O handle.

See Event order for I/O operation records for the possible event orders.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_IoHandleRef	handle	An active I/O handle. References a IoHandle definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_IO_HANDLE is available.
uint64_t	matchingId	Identifier used to correlate associated event records of an I/O operation. This identifier is unique for the referenced IoHandle.

See also: OTF2_EvtWriter_IoOperationIssued(); OTF2_GlobalEvtReaderCallbacks_SetIoOperationIssuedCallback(); OTF2_EvtReaderCallbacks_SetIoOperationIssuedCallback()

Since: Version 2.1

IoOperationComplete

An IoOperationComplete record marks the end of a file operation (read, write, etc.) on an active I/O handle.

See Event order for I/O operation records for the possible event orders.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_IoHandleRef	handle	An active I/O handle. References a IoHandle definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_IO_HANDLE is available.
uint64_t	bytesResult	Number of actual transferred bytes.
uint64_t	matchingId	Identifier used to correlate associated event records of an I/O operation. This identifier is unique for the referenced IoHandle.

See also: OTF2_EvtWriter_IoOperationComplete(); OTF2_GlobalEvtReaderCallbacks_SetIoOperationCompleteCallback(); OTF2_EvtReaderCallbacks_SetIoOperationCompleteCallback()

Since: Version 2.1

IoOperationCancelled

An IoOperationCancelled record marks the successful cancellation of a non-blocking operation (read, write, etc.) on an active I/O handle.

See Event order for I/O operation records for the possible event orders.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_IoHandleRef	handle	An active I/O handle. References a IoHandle definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_IO_HANDLE is available.
uint64_t	matchingId	Identifier used to correlate associated event records of an I/O operation. This identifier is unique for the referenced IoHandle.

See also: OTF2_EvtWriter_IoOperationCancelled(); OTF2_GlobalEvtReaderCallbacks_SetIoOperationCancelledCallback(); OTF2_EvtReaderCallbacks_SetIoOperationCancelledCallback()

Since: Version 2.1

IoAcquireLock

An IoAcquireLock record marks the acquisition of an I/O lock.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_IoHandleRef	handle	An active I/O handle. References a IoHandle definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_IO_HANDLE is available.
OTF2_LockType	lockType	Type of the lock.

See also: OTF2_EvtWriter_IoAcquireLock(); OTF2_GlobalEvtReaderCallbacks_SetIoAcquireLockCallback(); OTF2_EvtReaderCallbacks_SetIoAcquireLockCallback()

Since: Version 2.1

IoReleaseLock

An IoReleaseLock record marks the release of an I/O lock.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_IoHandleRef	handle	An active I/O handle. References a IoHandle definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_IO_HANDLE is available.
OTF2_LockType	lockType	Type of the lock.

See also: OTF2_EvtWriter_IoReleaseLock(); OTF2_GlobalEvtReaderCallbacks_SetIoReleaseLockCallback(); OTF2_EvtReaderCallbacks_SetIoReleaseLockCallback()

Since: Version 2.1

IoTryLock

An IoTryLock record marks when an I/O lock was requested but not granted.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_IoHandleRef	handle	An active I/O handle. References a IoHandle definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_IO_HANDLE is available.
OTF2_LockType	lockType	Type of the lock.

See also: OTF2_EvtWriter_IoTryLock(); OTF2_GlobalEvtReaderCallbacks_SetIoTryLockCallback(); OTF2_EvtReaderCallbacks_SetIoTryLockCallback()

Since: Version 2.1

ProgramBegin

The ProgramBegin record marks the begin of the program.

This event is restricted to happen at most once on any Location in a LocationGroup that is of type OTF2_LOCATION_GROUP_TYPE_PROCESS.

If there is a ProgramBegin record, a corresponding ProgramEnd record on any Location in the same LocationGroup is mandatory and vice versa.

None of the timestamps recorded within the same LocationGroup must be smaller than ProgramBegin's timestamp.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_StringRef	programName	The name of the program. References a String definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_STRING is available.
uint32_t	numberOfArguments	Number of additional arguments to the program.
OTF2_StringRef	programArguments [ numberOfArguments ]	List of additional arguments to the program.

See also: OTF2_EvtWriter_ProgramBegin(); OTF2_GlobalEvtReaderCallbacks_SetProgramBeginCallback(); OTF2_EvtReaderCallbacks_SetProgramBeginCallback()

Since: Version 2.1

ProgramEnd

The ProgramEnd record marks the end of the program.

This event is restricted to happen at most once on any Location in a LocationGroup that is of type OTF2_LOCATION_GROUP_TYPE_PROCESS.

If there is a ProgramEnd record, a corresponding ProgramBegin record on any Location in the same LocationGroup is mandatory, and vice versa.

None of the timestamps recorded within the same LocationGroup must be larger than ProgramEnd's timestamp.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
int64_t	exitStatus	The exit status of the program. Note, that on some systems only the least significant 8 bits may be visible to other processes. Use OTF2_UNDEFINED_INT64, if the exit status was not available.

See also: OTF2_EvtWriter_ProgramEnd(); OTF2_GlobalEvtReaderCallbacks_SetProgramEndCallback(); OTF2_EvtReaderCallbacks_SetProgramEndCallback()

Since: Version 2.1

NonBlockingCollectiveRequest

A NonBlockingCollectiveRequest record indicates that a non-blocking collective operation was initiated.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
uint64_t	requestID	ID of the requested operation.

See also: OTF2_EvtWriter_NonBlockingCollectiveRequest(); OTF2_GlobalEvtReaderCallbacks_SetNonBlockingCollectiveRequestCallback(); OTF2_EvtReaderCallbacks_SetNonBlockingCollectiveRequestCallback()

Since: Version 3.0

NonBlockingCollectiveComplete

A NonBlockingCollectiveComplete record indicates that a non- blocking collective operation completed.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_CollectiveOp	collectiveOp	Determines which collective operation it is.
OTF2_CommRef	communicator	Communicator ID. References a Comm, or a InterComm definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_COMM is available.
uint32_t	root	Rank of root in `communicator` or any predefined constant of OTF2_CollectiveRoot.
uint64_t	sizeSent	Size of the sent data.
uint64_t	sizeReceived	Size of the received data.
uint64_t	requestID	ID of the requested operation.

See also: OTF2_EvtWriter_NonBlockingCollectiveComplete(); OTF2_GlobalEvtReaderCallbacks_SetNonBlockingCollectiveCompleteCallback(); OTF2_EvtReaderCallbacks_SetNonBlockingCollectiveCompleteCallback()

Since: Version 3.0

CommCreate

A CommCreate record denotes the creation of a communicator. Only valid if the Comm definition was flagged with OTF2_COMM_FLAG_CREATE_DESTROY_EVENTS. This event must be enclosed by an MpiCollectiveBegin and MpiCollectiveEnd or NonBlockingCollectiveRequest and NonBlockingCollectiveComplete event pair with OTF2_COLLECTIVE_OP_CREATE_HANDLE as the operation type.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_CommRef	communicator	Communicator ID. References a Comm, or a InterComm definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_COMM is available.

See also: OTF2_EvtWriter_CommCreate(); OTF2_GlobalEvtReaderCallbacks_SetCommCreateCallback(); OTF2_EvtReaderCallbacks_SetCommCreateCallback()

Since: Version 3.0

CommDestroy

A CommDestroy record marks the communicator for destruction at the end of the enclosing MpiCollectiveBegin and MpiCollectiveEnd event pair. Only valid if the Comm definition was flagged with OTF2_COMM_FLAG_CREATE_DESTROY_EVENTS. This event must be enclosed by an MpiCollectiveBegin and MpiCollectiveEnd event pair with OTF2_COLLECTIVE_OP_DESTROY_HANDLE as the operation type.

Attributes

OTF2_LocationRef	location	The location where this event happened.
OTF2_TimeStamp	timestamp	The time when this event happened.
OTF2_CommRef	communicator	Communicator ID. References a Comm, or a InterComm definition and will be mapped to the global definition if a mapping table of type OTF2_MAPPING_COMM is available.

See also: OTF2_EvtWriter_CommDestroy(); OTF2_GlobalEvtReaderCallbacks_SetCommDestroyCallback(); OTF2_EvtReaderCallbacks_SetCommDestroyCallback()

Since: Version 3.0