1.5.1 (revision 4026)
Typedefs | Functions
otf2/OTF2_GlobalDefReaderCallbacks.h File Reference

This defines the callbacks for the global definition reader. More...

#include <stdint.h>
#include <otf2/OTF2_ErrorCodes.h>
#include <otf2/OTF2_GeneralDefinitions.h>
#include <otf2/OTF2_AttributeValue.h>
#include <otf2/OTF2_Definitions.h>

Go to the source code of this file.

Typedefs

typedef OTF2_CallbackCode(* OTF2_GlobalDefReaderCallback_Attribute )(void *userData, OTF2_AttributeRef self, OTF2_StringRef name, OTF2_StringRef description, OTF2_Type type)
 Function pointer definition for the callback which is triggered by a Attribute definition record.
typedef OTF2_CallbackCode(* OTF2_GlobalDefReaderCallback_CallingContext )(void *userData, OTF2_CallingContextRef self, uint64_t ip, OTF2_RegionRef region, uint32_t offsetLineNumber, OTF2_CallingContextRef parent)
 Function pointer definition for the callback which is triggered by a CallingContext definition record.
typedef OTF2_CallbackCode(* OTF2_GlobalDefReaderCallback_Callpath )(void *userData, OTF2_CallpathRef self, OTF2_CallpathRef parent, OTF2_RegionRef region)
 Function pointer definition for the callback which is triggered by a Callpath definition record.
typedef OTF2_CallbackCode(* OTF2_GlobalDefReaderCallback_Callsite )(void *userData, OTF2_CallsiteRef self, OTF2_StringRef sourceFile, uint32_t lineNumber, OTF2_RegionRef enteredRegion, OTF2_RegionRef leftRegion)
 Function pointer definition for the callback which is triggered by a Callsite definition record.
typedef OTF2_CallbackCode(* OTF2_GlobalDefReaderCallback_CartCoordinate )(void *userData, OTF2_CartTopologyRef cartTopology, uint32_t rank, uint8_t numberOfDimensions, const uint32_t *coordinates)
 Function pointer definition for the callback which is triggered by a CartCoordinate definition record.
typedef OTF2_CallbackCode(* OTF2_GlobalDefReaderCallback_CartDimension )(void *userData, OTF2_CartDimensionRef self, OTF2_StringRef name, uint32_t size, OTF2_CartPeriodicity cartPeriodicity)
 Function pointer definition for the callback which is triggered by a CartDimension definition record.
typedef OTF2_CallbackCode(* OTF2_GlobalDefReaderCallback_CartTopology )(void *userData, OTF2_CartTopologyRef self, OTF2_StringRef name, OTF2_CommRef communicator, uint8_t numberOfDimensions, const OTF2_CartDimensionRef *cartDimensions)
 Function pointer definition for the callback which is triggered by a CartTopology definition record.
typedef OTF2_CallbackCode(* OTF2_GlobalDefReaderCallback_ClockProperties )(void *userData, uint64_t timerResolution, uint64_t globalOffset, uint64_t traceLength)
 Function pointer definition for the callback which is triggered by a ClockProperties definition record.
typedef OTF2_CallbackCode(* OTF2_GlobalDefReaderCallback_Comm )(void *userData, OTF2_CommRef self, OTF2_StringRef name, OTF2_GroupRef group, OTF2_CommRef parent)
 Function pointer definition for the callback which is triggered by a Comm definition record.
typedef OTF2_CallbackCode(* OTF2_GlobalDefReaderCallback_Group )(void *userData, OTF2_GroupRef self, OTF2_StringRef name, OTF2_GroupType groupType, OTF2_Paradigm paradigm, OTF2_GroupFlag groupFlags, uint32_t numberOfMembers, const uint64_t *members)
 Function pointer definition for the callback which is triggered by a Group definition record.
typedef OTF2_CallbackCode(* OTF2_GlobalDefReaderCallback_InterruptGenerator )(void *userData, OTF2_InterruptGeneratorRef self, OTF2_StringRef name, OTF2_StringRef unit, uint64_t period)
 Function pointer definition for the callback which is triggered by a InterruptGenerator definition record.
typedef OTF2_CallbackCode(* OTF2_GlobalDefReaderCallback_Location )(void *userData, OTF2_LocationRef self, OTF2_StringRef name, OTF2_LocationType locationType, uint64_t numberOfEvents, OTF2_LocationGroupRef locationGroup)
 Function pointer definition for the callback which is triggered by a Location definition record.
typedef OTF2_CallbackCode(* OTF2_GlobalDefReaderCallback_LocationGroup )(void *userData, OTF2_LocationGroupRef self, OTF2_StringRef name, OTF2_LocationGroupType locationGroupType, OTF2_SystemTreeNodeRef systemTreeParent)
 Function pointer definition for the callback which is triggered by a LocationGroup definition record.
typedef OTF2_CallbackCode(* OTF2_GlobalDefReaderCallback_LocationGroupProperty )(void *userData, OTF2_LocationGroupRef locationGroup, OTF2_StringRef name, OTF2_StringRef value)
 Function pointer definition for the callback which is triggered by a LocationGroupProperty definition record.
typedef OTF2_CallbackCode(* OTF2_GlobalDefReaderCallback_LocationProperty )(void *userData, OTF2_LocationRef location, OTF2_StringRef name, OTF2_StringRef value)
 Function pointer definition for the callback which is triggered by a LocationProperty definition record.
typedef OTF2_CallbackCode(* OTF2_GlobalDefReaderCallback_MetricClass )(void *userData, OTF2_MetricRef self, uint8_t numberOfMetrics, const OTF2_MetricMemberRef *metricMembers, OTF2_MetricOccurrence metricOccurrence, OTF2_RecorderKind recorderKind)
 Function pointer definition for the callback which is triggered by a MetricClass definition record.
typedef OTF2_CallbackCode(* OTF2_GlobalDefReaderCallback_MetricClassRecorder )(void *userData, OTF2_MetricRef metricClass, OTF2_LocationRef recorder)
 Function pointer definition for the callback which is triggered by a MetricClassRecorder definition record.
typedef OTF2_CallbackCode(* OTF2_GlobalDefReaderCallback_MetricInstance )(void *userData, OTF2_MetricRef self, OTF2_MetricRef metricClass, OTF2_LocationRef recorder, OTF2_MetricScope metricScope, uint64_t scope)
 Function pointer definition for the callback which is triggered by a MetricInstance definition record.
typedef OTF2_CallbackCode(* OTF2_GlobalDefReaderCallback_MetricMember )(void *userData, OTF2_MetricMemberRef self, OTF2_StringRef name, OTF2_StringRef description, OTF2_MetricType metricType, OTF2_MetricMode metricMode, OTF2_Type valueType, OTF2_MetricBase metricBase, int64_t exponent, OTF2_StringRef unit)
 Function pointer definition for the callback which is triggered by a MetricMember definition record.
typedef OTF2_CallbackCode(* OTF2_GlobalDefReaderCallback_Paradigm )(void *userData, OTF2_Paradigm paradigm, OTF2_StringRef name, OTF2_ParadigmClass paradigmClass)
 Function pointer definition for the callback which is triggered by a Paradigm definition record.
typedef OTF2_CallbackCode(* OTF2_GlobalDefReaderCallback_ParadigmProperty )(void *userData, OTF2_Paradigm paradigm, OTF2_ParadigmProperty property, OTF2_Type type, OTF2_AttributeValue attributeValue)
 Function pointer definition for the callback which is triggered by a ParadigmProperty definition record.
typedef OTF2_CallbackCode(* OTF2_GlobalDefReaderCallback_Parameter )(void *userData, OTF2_ParameterRef self, OTF2_StringRef name, OTF2_ParameterType parameterType)
 Function pointer definition for the callback which is triggered by a Parameter definition record.
typedef OTF2_CallbackCode(* OTF2_GlobalDefReaderCallback_Region )(void *userData, OTF2_RegionRef self, OTF2_StringRef name, OTF2_StringRef canonicalName, OTF2_StringRef description, OTF2_RegionRole regionRole, OTF2_Paradigm paradigm, OTF2_RegionFlag regionFlags, OTF2_StringRef sourceFile, uint32_t beginLineNumber, uint32_t endLineNumber)
 Function pointer definition for the callback which is triggered by a Region definition record.
typedef OTF2_CallbackCode(* OTF2_GlobalDefReaderCallback_RmaWin )(void *userData, OTF2_RmaWinRef self, OTF2_StringRef name, OTF2_CommRef comm)
 Function pointer definition for the callback which is triggered by a RmaWin definition record.
typedef OTF2_CallbackCode(* OTF2_GlobalDefReaderCallback_SourceCodeLocation )(void *userData, OTF2_SourceCodeLocationRef self, OTF2_StringRef file, uint32_t lineNumber)
 Function pointer definition for the callback which is triggered by a SourceCodeLocation definition record.
typedef OTF2_CallbackCode(* OTF2_GlobalDefReaderCallback_String )(void *userData, OTF2_StringRef self, const char *string)
 Function pointer definition for the callback which is triggered by a String definition record.
typedef OTF2_CallbackCode(* OTF2_GlobalDefReaderCallback_SystemTreeNode )(void *userData, OTF2_SystemTreeNodeRef self, OTF2_StringRef name, OTF2_StringRef className, OTF2_SystemTreeNodeRef parent)
 Function pointer definition for the callback which is triggered by a SystemTreeNode definition record.
typedef OTF2_CallbackCode(* OTF2_GlobalDefReaderCallback_SystemTreeNodeDomain )(void *userData, OTF2_SystemTreeNodeRef systemTreeNode, OTF2_SystemTreeDomain systemTreeDomain)
 Function pointer definition for the callback which is triggered by a SystemTreeNodeDomain definition record.
typedef OTF2_CallbackCode(* OTF2_GlobalDefReaderCallback_SystemTreeNodeProperty )(void *userData, OTF2_SystemTreeNodeRef systemTreeNode, OTF2_StringRef name, OTF2_StringRef value)
 Function pointer definition for the callback which is triggered by a SystemTreeNodeProperty definition record.
typedef OTF2_CallbackCode(* OTF2_GlobalDefReaderCallback_Unknown )(void *userData)
 Function pointer definition for the callback which is triggered by an unknown definition record.
typedef struct
OTF2_GlobalDefReaderCallbacks_struct 
OTF2_GlobalDefReaderCallbacks
 Opaque struct which holdes all global definition record callbacks.

Functions

void OTF2_GlobalDefReaderCallbacks_Clear (OTF2_GlobalDefReaderCallbacks *globalDefReaderCallbacks)
 Clears a struct for the global definition callbacks.
void OTF2_GlobalDefReaderCallbacks_Delete (OTF2_GlobalDefReaderCallbacks *globalDefReaderCallbacks)
 Deallocates a struct for the global definition callbacks.
OTF2_GlobalDefReaderCallbacksOTF2_GlobalDefReaderCallbacks_New (void)
 Allocates a new struct for the global definition callbacks.
OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetAttributeCallback (OTF2_GlobalDefReaderCallbacks *globalDefReaderCallbacks, OTF2_GlobalDefReaderCallback_Attribute attributeCallback)
 Registers the callback for the Attribute definition.
OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetCallingContextCallback (OTF2_GlobalDefReaderCallbacks *globalDefReaderCallbacks, OTF2_GlobalDefReaderCallback_CallingContext callingContextCallback)
 Registers the callback for the CallingContext definition.
OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetCallpathCallback (OTF2_GlobalDefReaderCallbacks *globalDefReaderCallbacks, OTF2_GlobalDefReaderCallback_Callpath callpathCallback)
 Registers the callback for the Callpath definition.
OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetCallsiteCallback (OTF2_GlobalDefReaderCallbacks *globalDefReaderCallbacks, OTF2_GlobalDefReaderCallback_Callsite callsiteCallback)
 Registers the callback for the Callsite definition.
OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetCartCoordinateCallback (OTF2_GlobalDefReaderCallbacks *globalDefReaderCallbacks, OTF2_GlobalDefReaderCallback_CartCoordinate cartCoordinateCallback)
 Registers the callback for the CartCoordinate definition.
OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetCartDimensionCallback (OTF2_GlobalDefReaderCallbacks *globalDefReaderCallbacks, OTF2_GlobalDefReaderCallback_CartDimension cartDimensionCallback)
 Registers the callback for the CartDimension definition.
OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetCartTopologyCallback (OTF2_GlobalDefReaderCallbacks *globalDefReaderCallbacks, OTF2_GlobalDefReaderCallback_CartTopology cartTopologyCallback)
 Registers the callback for the CartTopology definition.
OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetClockPropertiesCallback (OTF2_GlobalDefReaderCallbacks *globalDefReaderCallbacks, OTF2_GlobalDefReaderCallback_ClockProperties clockPropertiesCallback)
 Registers the callback for the ClockProperties definition.
OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetCommCallback (OTF2_GlobalDefReaderCallbacks *globalDefReaderCallbacks, OTF2_GlobalDefReaderCallback_Comm commCallback)
 Registers the callback for the Comm definition.
OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetGroupCallback (OTF2_GlobalDefReaderCallbacks *globalDefReaderCallbacks, OTF2_GlobalDefReaderCallback_Group groupCallback)
 Registers the callback for the Group definition.
OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetInterruptGeneratorCallback (OTF2_GlobalDefReaderCallbacks *globalDefReaderCallbacks, OTF2_GlobalDefReaderCallback_InterruptGenerator interruptGeneratorCallback)
 Registers the callback for the InterruptGenerator definition.
OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetLocationCallback (OTF2_GlobalDefReaderCallbacks *globalDefReaderCallbacks, OTF2_GlobalDefReaderCallback_Location locationCallback)
 Registers the callback for the Location definition.
OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetLocationGroupCallback (OTF2_GlobalDefReaderCallbacks *globalDefReaderCallbacks, OTF2_GlobalDefReaderCallback_LocationGroup locationGroupCallback)
 Registers the callback for the LocationGroup definition.
OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetLocationGroupPropertyCallback (OTF2_GlobalDefReaderCallbacks *globalDefReaderCallbacks, OTF2_GlobalDefReaderCallback_LocationGroupProperty locationGroupPropertyCallback)
 Registers the callback for the LocationGroupProperty definition.
OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetLocationPropertyCallback (OTF2_GlobalDefReaderCallbacks *globalDefReaderCallbacks, OTF2_GlobalDefReaderCallback_LocationProperty locationPropertyCallback)
 Registers the callback for the LocationProperty definition.
OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetMetricClassCallback (OTF2_GlobalDefReaderCallbacks *globalDefReaderCallbacks, OTF2_GlobalDefReaderCallback_MetricClass metricClassCallback)
 Registers the callback for the MetricClass definition.
OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetMetricClassRecorderCallback (OTF2_GlobalDefReaderCallbacks *globalDefReaderCallbacks, OTF2_GlobalDefReaderCallback_MetricClassRecorder metricClassRecorderCallback)
 Registers the callback for the MetricClassRecorder definition.
OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetMetricInstanceCallback (OTF2_GlobalDefReaderCallbacks *globalDefReaderCallbacks, OTF2_GlobalDefReaderCallback_MetricInstance metricInstanceCallback)
 Registers the callback for the MetricInstance definition.
OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetMetricMemberCallback (OTF2_GlobalDefReaderCallbacks *globalDefReaderCallbacks, OTF2_GlobalDefReaderCallback_MetricMember metricMemberCallback)
 Registers the callback for the MetricMember definition.
OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetParadigmCallback (OTF2_GlobalDefReaderCallbacks *globalDefReaderCallbacks, OTF2_GlobalDefReaderCallback_Paradigm paradigmCallback)
 Registers the callback for the Paradigm definition.
OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetParadigmPropertyCallback (OTF2_GlobalDefReaderCallbacks *globalDefReaderCallbacks, OTF2_GlobalDefReaderCallback_ParadigmProperty paradigmPropertyCallback)
 Registers the callback for the ParadigmProperty definition.
OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetParameterCallback (OTF2_GlobalDefReaderCallbacks *globalDefReaderCallbacks, OTF2_GlobalDefReaderCallback_Parameter parameterCallback)
 Registers the callback for the Parameter definition.
OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetRegionCallback (OTF2_GlobalDefReaderCallbacks *globalDefReaderCallbacks, OTF2_GlobalDefReaderCallback_Region regionCallback)
 Registers the callback for the Region definition.
OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetRmaWinCallback (OTF2_GlobalDefReaderCallbacks *globalDefReaderCallbacks, OTF2_GlobalDefReaderCallback_RmaWin rmaWinCallback)
 Registers the callback for the RmaWin definition.
OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetSourceCodeLocationCallback (OTF2_GlobalDefReaderCallbacks *globalDefReaderCallbacks, OTF2_GlobalDefReaderCallback_SourceCodeLocation sourceCodeLocationCallback)
 Registers the callback for the SourceCodeLocation definition.
OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetStringCallback (OTF2_GlobalDefReaderCallbacks *globalDefReaderCallbacks, OTF2_GlobalDefReaderCallback_String stringCallback)
 Registers the callback for the String definition.
OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetSystemTreeNodeCallback (OTF2_GlobalDefReaderCallbacks *globalDefReaderCallbacks, OTF2_GlobalDefReaderCallback_SystemTreeNode systemTreeNodeCallback)
 Registers the callback for the SystemTreeNode definition.
OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetSystemTreeNodeDomainCallback (OTF2_GlobalDefReaderCallbacks *globalDefReaderCallbacks, OTF2_GlobalDefReaderCallback_SystemTreeNodeDomain systemTreeNodeDomainCallback)
 Registers the callback for the SystemTreeNodeDomain definition.
OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetSystemTreeNodePropertyCallback (OTF2_GlobalDefReaderCallbacks *globalDefReaderCallbacks, OTF2_GlobalDefReaderCallback_SystemTreeNodeProperty systemTreeNodePropertyCallback)
 Registers the callback for the SystemTreeNodeProperty definition.
OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetUnknownCallback (OTF2_GlobalDefReaderCallbacks *globalDefReaderCallbacks, OTF2_GlobalDefReaderCallback_Unknown unknownCallback)
 Registers the callback for an unknown definition.

Detailed Description

This defines the callbacks for the global definition reader.

Source Template:
templates/OTF2_GlobalDefReaderCallbacks.tmpl.h

Typedef Documentation

Function pointer definition for the callback which is triggered by a Attribute definition record.

The attribute definition.

Parameters:
userDataUser data as set by OTF2_Reader_RegisterGlobalDefCallbacks or OTF2_GlobalDefReader_SetCallbacks.
selfThe unique identifier for this Attribute definition.
nameName of the attribute. References a String definition.
descriptionDescription of the attribute. References a String definition. Since version 1.4.
typeType of the attribute value.
Since:
Version 1.0
Returns:
OTF2_CALLBACK_SUCCESS or OTF2_CALLBACK_INTERRUPT.
typedef OTF2_CallbackCode( * OTF2_GlobalDefReaderCallback_CallingContext)(void *userData, OTF2_CallingContextRef self, uint64_t ip, OTF2_RegionRef region, uint32_t offsetLineNumber, OTF2_CallingContextRef parent)

Function pointer definition for the callback which is triggered by a CallingContext definition record.

Parameters:
userDataUser data as set by OTF2_Reader_RegisterGlobalDefCallbacks or OTF2_GlobalDefReader_SetCallbacks.
selfThe unique identifier for this CallingContext definition.
ipInstruction pointer as the offset to the start of the function.
regionThe region. References a Region definition.
offsetLineNumberThe line offset inside the region.
parentParent id of this context. References a CallingContext definition.
Since:
Version 1.5
Returns:
OTF2_CALLBACK_SUCCESS or OTF2_CALLBACK_INTERRUPT.

Function pointer definition for the callback which is triggered by a Callpath definition record.

The callpath definition.

Parameters:
userDataUser data as set by OTF2_Reader_RegisterGlobalDefCallbacks or OTF2_GlobalDefReader_SetCallbacks.
selfThe unique identifier for this Callpath definition.
parentThe parent of this callpath. References a Callpath definition.
regionThe region of this callpath. References a Region definition.
Since:
Version 1.0
Returns:
OTF2_CALLBACK_SUCCESS or OTF2_CALLBACK_INTERRUPT.
typedef OTF2_CallbackCode( * OTF2_GlobalDefReaderCallback_Callsite)(void *userData, OTF2_CallsiteRef self, OTF2_StringRef sourceFile, uint32_t lineNumber, OTF2_RegionRef enteredRegion, OTF2_RegionRef leftRegion)

Function pointer definition for the callback which is triggered by a Callsite definition record.

The callsite definition.

Parameters:
userDataUser data as set by OTF2_Reader_RegisterGlobalDefCallbacks or OTF2_GlobalDefReader_SetCallbacks.
selfThe unique identifier for this Callsite definition.
sourceFileThe source file where this call was made. References a String definition.
lineNumberLine number in the source file where this call was made.
enteredRegionThe region which was called. References a Region definition.
leftRegionThe region which made the call. References a Region definition.
Since:
Version 1.0
Returns:
OTF2_CALLBACK_SUCCESS or OTF2_CALLBACK_INTERRUPT.
typedef OTF2_CallbackCode( * OTF2_GlobalDefReaderCallback_CartCoordinate)(void *userData, OTF2_CartTopologyRef cartTopology, uint32_t rank, uint8_t numberOfDimensions, const uint32_t *coordinates)

Function pointer definition for the callback which is triggered by a CartCoordinate definition record.

Defines the coordinate of the location referenced by the given rank (w.r.t. the communicator associated to the topology) in the referenced topology.

Parameters:
userDataUser data as set by OTF2_Reader_RegisterGlobalDefCallbacks or OTF2_GlobalDefReader_SetCallbacks.
cartTopologyParent CartTopology definition to which this one is a supplementary definition. References a CartTopology definition.
rankThe rank w.r.t. the communicator associated to the topology referencing this coordinate.
numberOfDimensionsNumber of dimensions.
coordinatesCoordinates, indexed by dimension.
Since:
Version 1.3
Returns:
OTF2_CALLBACK_SUCCESS or OTF2_CALLBACK_INTERRUPT.
typedef OTF2_CallbackCode( * OTF2_GlobalDefReaderCallback_CartDimension)(void *userData, OTF2_CartDimensionRef self, OTF2_StringRef name, uint32_t size, OTF2_CartPeriodicity cartPeriodicity)

Function pointer definition for the callback which is triggered by a CartDimension definition record.

Each dimension in a Cartesian topology is composed of a global id, a name, its size, and whether it is periodic or not.

Parameters:
userDataUser data as set by OTF2_Reader_RegisterGlobalDefCallbacks or OTF2_GlobalDefReader_SetCallbacks.
selfThe unique identifier for this CartDimension definition.
nameThe name of the cartesian topology dimension. References a String definition.
sizeThe size of the cartesian topology dimension.
cartPeriodicityPeriodicity of the cartesian topology dimension.
Since:
Version 1.3
Returns:
OTF2_CALLBACK_SUCCESS or OTF2_CALLBACK_INTERRUPT.
typedef OTF2_CallbackCode( * OTF2_GlobalDefReaderCallback_CartTopology)(void *userData, OTF2_CartTopologyRef self, OTF2_StringRef name, OTF2_CommRef communicator, uint8_t numberOfDimensions, const OTF2_CartDimensionRef *cartDimensions)

Function pointer definition for the callback which is triggered by a CartTopology definition record.

Each topology is described by a global id, a reference to its name, a reference to a communicator, the number of dimensions, and references to those dimensions. The topology type is defined by the paradigm of the group referenced by the associated communicator.

Parameters:
userDataUser data as set by OTF2_Reader_RegisterGlobalDefCallbacks or OTF2_GlobalDefReader_SetCallbacks.
selfThe unique identifier for this CartTopology definition.
nameThe name of the topology. References a String definition.
communicatorCommunicator object used to create the topology. References a Comm definition.
numberOfDimensionsNumber of dimensions.
cartDimensionsThe dimensions of this topology. References a CartDimension definition.
Since:
Version 1.3
Returns:
OTF2_CALLBACK_SUCCESS or OTF2_CALLBACK_INTERRUPT.
typedef OTF2_CallbackCode( * OTF2_GlobalDefReaderCallback_ClockProperties)(void *userData, uint64_t timerResolution, uint64_t globalOffset, uint64_t traceLength)

Function pointer definition for the callback which is triggered by a ClockProperties definition record.

Defines the timer resolution and time range of this trace. There will be no event with a timestamp less than globalOffset, and no event with timestamp greater than (globalOffset + traceLength).

Parameters:
userDataUser data as set by OTF2_Reader_RegisterGlobalDefCallbacks or OTF2_GlobalDefReader_SetCallbacks.
timerResolutionTicks per seconds.
globalOffsetA timestamp smaller than all event timestamps.
traceLengthA timespan which includes the timespan between the smallest and greatest timestamp of all event timestamps.
Since:
Version 1.0
Returns:
OTF2_CALLBACK_SUCCESS or OTF2_CALLBACK_INTERRUPT.

Function pointer definition for the callback which is triggered by a Comm definition record.

The communicator definition.

Parameters:
userDataUser data as set by OTF2_Reader_RegisterGlobalDefCallbacks or OTF2_GlobalDefReader_SetCallbacks.
selfThe unique identifier for this Comm definition.
nameThe name given by calling MPI_Comm_set_name on this communicator. Or the empty name to indicate that no name was given. References a String definition.
groupThe describing MPI group of this MPI communicator The group needs to be of type OTF2_GROUP_TYPE_COMM_GROUP or OTF2_GROUP_TYPE_COMM_SELF. References a Group definition.
parentThe parent MPI communicator from which this communicator was created, if any. Use OTF2_UNDEFINED_COMM to indicate no parent. References a Comm definition.
Since:
Version 1.0
Returns:
OTF2_CALLBACK_SUCCESS or OTF2_CALLBACK_INTERRUPT.
typedef OTF2_CallbackCode( * OTF2_GlobalDefReaderCallback_Group)(void *userData, OTF2_GroupRef self, OTF2_StringRef name, OTF2_GroupType groupType, OTF2_Paradigm paradigm, OTF2_GroupFlag groupFlags, uint32_t numberOfMembers, const uint64_t *members)

Function pointer definition for the callback which is triggered by a Group definition record.

The group definition.

Parameters:
userDataUser data as set by OTF2_Reader_RegisterGlobalDefCallbacks or OTF2_GlobalDefReader_SetCallbacks.
selfThe unique identifier for this Group definition.
nameName of this group References a String definition.
groupTypeThe type of this group. Since version 1.2.
paradigmThe paradigm of this communication group. Since version 1.2.
groupFlagsFlags for this group. Since version 1.2.
numberOfMembersThe number of members in this group.
membersThe identifiers of the group members.
Since:
Version 1.0
Returns:
OTF2_CALLBACK_SUCCESS or OTF2_CALLBACK_INTERRUPT.

Function pointer definition for the callback which is triggered by a InterruptGenerator definition record.

Parameters:
userDataUser data as set by OTF2_Reader_RegisterGlobalDefCallbacks or OTF2_GlobalDefReader_SetCallbacks.
selfThe unique identifier for this InterruptGenerator definition.
nameThe name of this interrupt generator. References a String definition.
unitThe unit used by this interrupt generator for the period. References a String definition.
periodThe period this interrupt generator generates interrupts.
Since:
Version 1.5
Returns:
OTF2_CALLBACK_SUCCESS or OTF2_CALLBACK_INTERRUPT.
typedef OTF2_CallbackCode( * OTF2_GlobalDefReaderCallback_Location)(void *userData, OTF2_LocationRef self, OTF2_StringRef name, OTF2_LocationType locationType, uint64_t numberOfEvents, OTF2_LocationGroupRef locationGroup)

Function pointer definition for the callback which is triggered by a Location definition record.

The location definition.

Parameters:
userDataUser data as set by OTF2_Reader_RegisterGlobalDefCallbacks or OTF2_GlobalDefReader_SetCallbacks.
selfThe unique identifier for this Location definition.
nameName of the location References a String definition.
locationTypeLocation type.
numberOfEventsNumber of events this location has recorded.
locationGroupLocation group which includes this location. References a LocationGroup definition.
Since:
Version 1.0
Returns:
OTF2_CALLBACK_SUCCESS or OTF2_CALLBACK_INTERRUPT.

Function pointer definition for the callback which is triggered by a LocationGroup definition record.

The location group definition.

Parameters:
userDataUser data as set by OTF2_Reader_RegisterGlobalDefCallbacks or OTF2_GlobalDefReader_SetCallbacks.
selfThe unique identifier for this LocationGroup definition.
nameName of the group. References a String definition.
locationGroupTypeType of this group.
systemTreeParentParent of this location group in the system tree. References a SystemTreeNode definition.
Since:
Version 1.0
Returns:
OTF2_CALLBACK_SUCCESS or OTF2_CALLBACK_INTERRUPT.

Function pointer definition for the callback which is triggered by a LocationGroupProperty definition record.

An arbitrary key/value property for a LocationGroup definition.

Parameters:
userDataUser data as set by OTF2_Reader_RegisterGlobalDefCallbacks or OTF2_GlobalDefReader_SetCallbacks.
locationGroupParent LocationGroup definition to which this one is a supplementary definition. References a LocationGroup definition.
nameName of the property. References a String definition.
valueProperty value. References a String definition.
Since:
Version 1.3
Returns:
OTF2_CALLBACK_SUCCESS or OTF2_CALLBACK_INTERRUPT.

Function pointer definition for the callback which is triggered by a LocationProperty definition record.

An arbitrary key/value property for a Location definition.

Parameters:
userDataUser data as set by OTF2_Reader_RegisterGlobalDefCallbacks or OTF2_GlobalDefReader_SetCallbacks.
locationParent Location definition to which this one is a supplementary definition. References a Location definition.
nameName of the property. References a String definition.
valueProperty value. References a String definition.
Since:
Version 1.3
Returns:
OTF2_CALLBACK_SUCCESS or OTF2_CALLBACK_INTERRUPT.
typedef OTF2_CallbackCode( * OTF2_GlobalDefReaderCallback_MetricClass)(void *userData, OTF2_MetricRef self, uint8_t numberOfMetrics, const OTF2_MetricMemberRef *metricMembers, OTF2_MetricOccurrence metricOccurrence, OTF2_RecorderKind recorderKind)

Function pointer definition for the callback which is triggered by a MetricClass definition record.

For a metric class it is implicitly given that the event stream that records the metric is also the scope. A metric class can contain multiple different metrics.

Parameters:
userDataUser data as set by OTF2_Reader_RegisterGlobalDefCallbacks or OTF2_GlobalDefReader_SetCallbacks.
selfThe unique identifier for this MetricClass definition.
numberOfMetricsNumber of metrics within the set.
metricMembersList of metric members. References a MetricMember definition.
metricOccurrenceDefines occurrence of a metric set.
recorderKindWhat kind of locations will record this metric class, or will this metric class only be recorded by metric instances. Since version 1.2.
Since:
Version 1.0
Returns:
OTF2_CALLBACK_SUCCESS or OTF2_CALLBACK_INTERRUPT.

Function pointer definition for the callback which is triggered by a MetricClassRecorder definition record.

The metric class recorder definition.

Parameters:
userDataUser data as set by OTF2_Reader_RegisterGlobalDefCallbacks or OTF2_GlobalDefReader_SetCallbacks.
metricClassParent MetricClass definition to which this one is a supplementary definition. References a MetricClass definition.
recorderThe location which recorded the referenced metric class. References a Location definition.
Since:
Version 1.2
Returns:
OTF2_CALLBACK_SUCCESS or OTF2_CALLBACK_INTERRUPT.
typedef OTF2_CallbackCode( * OTF2_GlobalDefReaderCallback_MetricInstance)(void *userData, OTF2_MetricRef self, OTF2_MetricRef metricClass, OTF2_LocationRef recorder, OTF2_MetricScope metricScope, uint64_t scope)

Function pointer definition for the callback which is triggered by a MetricInstance definition record.

A metric instance is used to define metrics that are recorded at one location for multiple locations or for another location. The occurrence of a metric instance is implicitly of type OTF2_METRIC_ASYNCHRONOUS.

Parameters:
userDataUser data as set by OTF2_Reader_RegisterGlobalDefCallbacks or OTF2_GlobalDefReader_SetCallbacks.
selfThe unique identifier for this MetricClass definition.
metricClassThe instanced MetricClass. This metric class must be of kind OTF2_RECORDER_KIND_ABSTRACT. References a MetricClass definition.
recorderRecorder of the metric: location ID. References a Location definition.
metricScopeDefines type of scope: location, location group, system tree node, or a generic group of locations.
scopeScope of metric: ID of a location, location group, system tree node, or a generic group of locations.
Since:
Version 1.0
Returns:
OTF2_CALLBACK_SUCCESS or OTF2_CALLBACK_INTERRUPT.
typedef OTF2_CallbackCode( * OTF2_GlobalDefReaderCallback_MetricMember)(void *userData, OTF2_MetricMemberRef self, OTF2_StringRef name, OTF2_StringRef description, OTF2_MetricType metricType, OTF2_MetricMode metricMode, OTF2_Type valueType, OTF2_MetricBase metricBase, int64_t exponent, OTF2_StringRef unit)

Function pointer definition for the callback which is triggered by a MetricMember definition record.

A metric is defined by a metric member definition. A metric member is always a member of a metric class. Therefore, a single metric is a special case of a metric class with only one member. It is not allowed to reference a metric member id in a metric event, but only metric class IDs.

Parameters:
userDataUser data as set by OTF2_Reader_RegisterGlobalDefCallbacks or OTF2_GlobalDefReader_SetCallbacks.
selfThe unique identifier for this MetricMember definition.
nameName of the metric. References a String definition.
descriptionDescription of the metric. References a String definition.
metricTypeMetric type: PAPI, etc.
metricModeMetric mode: accumulative, fix, relative, etc.
valueTypeType of the value. Only OTF2_TYPE_INT64, OTF2_TYPE_UINT64, and OTF2_TYPE_DOUBLE are valid types. If this metric member is recorded in an Metric event, than this type and the type in the event must match.
metricBaseThe recorded values should be handled in this given base, either binary or decimal. This information can be used if the value needs to be scaled.
exponentThe values inside the Metric events should be scaled by the factor base^exponent, to get the value in its base unit. For example, if the metric values come in as KiBi, than the base should be OTF2_BASE_BINARY and the exponent 10. Than the writer does not need to scale the values up to bytes, but can directly write the KiBi values into the Metric event. At reading time, the reader can apply the scaling factor to get the value in its base unit, ie. in bytes.
unitUnit of the metric. This needs to be the scale free base unit, ie. "bytes", "operations", or "seconds". In particular this unit should not have any scale prefix. References a String definition.
Since:
Version 1.0
Returns:
OTF2_CALLBACK_SUCCESS or OTF2_CALLBACK_INTERRUPT.

Function pointer definition for the callback which is triggered by a Paradigm definition record.

Attests that the following parallel paradigm was available at the time when the trace was recorded, and vice versa. Note that this does not attest that the paradigm was used. For convenience, this also includes a proper name for the paradigm and a classification. This definition is only allowed to appear at most once in the definitions per Paradigm.

Parameters:
userDataUser data as set by OTF2_Reader_RegisterGlobalDefCallbacks or OTF2_GlobalDefReader_SetCallbacks.
paradigmThe paradigm to attest.
nameThe name of the paradigm. References a String definition.
paradigmClassThe class of this paradigm.
Since:
Version 1.5
Returns:
OTF2_CALLBACK_SUCCESS or OTF2_CALLBACK_INTERRUPT.

Function pointer definition for the callback which is triggered by a ParadigmProperty definition record.

Extensible annotation for the Paradigm definition.

The tuple (paradigm, property) must be unique.

Parameters:
userDataUser data as set by OTF2_Reader_RegisterGlobalDefCallbacks or OTF2_GlobalDefReader_SetCallbacks.
paradigmThe paradigm to annotate.
propertyThe property.
typeThe type of this property. Must match with the defined type of the property.
attributeValueThe value of this property.value
Since:
Version 1.5
Returns:
OTF2_CALLBACK_SUCCESS or OTF2_CALLBACK_INTERRUPT.

Function pointer definition for the callback which is triggered by a Parameter definition record.

The parameter definition.

Parameters:
userDataUser data as set by OTF2_Reader_RegisterGlobalDefCallbacks or OTF2_GlobalDefReader_SetCallbacks.
selfThe unique identifier for this Parameter definition.
nameName of the parameter (variable name etc.) References a String definition.
parameterTypeType of the parameter, OTF2_ParameterType for possible types.
Since:
Version 1.0
Returns:
OTF2_CALLBACK_SUCCESS or OTF2_CALLBACK_INTERRUPT.
typedef OTF2_CallbackCode( * OTF2_GlobalDefReaderCallback_Region)(void *userData, OTF2_RegionRef self, OTF2_StringRef name, OTF2_StringRef canonicalName, OTF2_StringRef description, OTF2_RegionRole regionRole, OTF2_Paradigm paradigm, OTF2_RegionFlag regionFlags, OTF2_StringRef sourceFile, uint32_t beginLineNumber, uint32_t endLineNumber)

Function pointer definition for the callback which is triggered by a Region definition record.

The region definition.

Parameters:
userDataUser data as set by OTF2_Reader_RegisterGlobalDefCallbacks or OTF2_GlobalDefReader_SetCallbacks.
selfThe unique identifier for this Region definition.
nameName of the region (demangled name if available). References a String definition.
canonicalNameAlternative name of the region (e.g. mangled name). References a String definition. Since version 1.1.
descriptionA more detailed description of this region. References a String definition.
regionRoleRegion role. Since version 1.1.
paradigmParadigm. Since version 1.1.
regionFlagsRegion flags. Since version 1.1.
sourceFileThe source file where this region was declared. References a String definition.
beginLineNumberStarting line number of this region in the source file.
endLineNumberEnding line number of this region in the source file.
Since:
Version 1.0
Returns:
OTF2_CALLBACK_SUCCESS or OTF2_CALLBACK_INTERRUPT.

Function pointer definition for the callback which is triggered by a RmaWin definition record.

A window defines the communication context for any remote-memory access operation.

Parameters:
userDataUser data as set by OTF2_Reader_RegisterGlobalDefCallbacks or OTF2_GlobalDefReader_SetCallbacks.
selfThe unique identifier for this RmaWin definition.
nameName, e.g. 'GASPI Queue 1', 'NVidia Card 2', etc.. References a String definition.
commCommunicator object used to create the window. References a Comm definition.
Since:
Version 1.2
Returns:
OTF2_CALLBACK_SUCCESS or OTF2_CALLBACK_INTERRUPT.

Function pointer definition for the callback which is triggered by a SourceCodeLocation definition record.

The definition of a source code location as tuple of the corresponding file name and line number.

When used to attach source code annotations to events, use the OTF2_AttributeList with a Attribute definition named "SOURCE_CODE_LOCATION" and typed OTF2_TYPE_SOURCE_CODE_LOCATION.

Parameters:
userDataUser data as set by OTF2_Reader_RegisterGlobalDefCallbacks or OTF2_GlobalDefReader_SetCallbacks.
selfThe unique identifier for this SourceCodeLocation definition.
fileThe name of the file for the source code location. References a String definition.
lineNumberThe line number for the source code location.
Since:
Version 1.5
Returns:
OTF2_CALLBACK_SUCCESS or OTF2_CALLBACK_INTERRUPT.
typedef OTF2_CallbackCode( * OTF2_GlobalDefReaderCallback_String)(void *userData, OTF2_StringRef self, const char *string)

Function pointer definition for the callback which is triggered by a String definition record.

The string definition.

Parameters:
userDataUser data as set by OTF2_Reader_RegisterGlobalDefCallbacks or OTF2_GlobalDefReader_SetCallbacks.
selfThe unique identifier for this String definition.
stringThe string, null terminated.
Since:
Version 1.0
Returns:
OTF2_CALLBACK_SUCCESS or OTF2_CALLBACK_INTERRUPT.

Function pointer definition for the callback which is triggered by a SystemTreeNode definition record.

The system tree node definition.

Parameters:
userDataUser data as set by OTF2_Reader_RegisterGlobalDefCallbacks or OTF2_GlobalDefReader_SetCallbacks.
selfThe unique identifier for this SystemTreeNode definition.
nameFree form instance name of this node. References a String definition.
classNameFree form class name of this node References a String definition.
parentParent id of this node. May be OTF2_UNDEFINED_SYSTEM_TREE_NODE to indicate that there is no parent. References a SystemTreeNode definition.
Since:
Version 1.0
Returns:
OTF2_CALLBACK_SUCCESS or OTF2_CALLBACK_INTERRUPT.

Function pointer definition for the callback which is triggered by a SystemTreeNodeDomain definition record.

The system tree node domain definition.

Parameters:
userDataUser data as set by OTF2_Reader_RegisterGlobalDefCallbacks or OTF2_GlobalDefReader_SetCallbacks.
systemTreeNodeParent SystemTreeNode definition to which this one is a supplementary definition. References a SystemTreeNode definition.
systemTreeDomainThe domain in which the referenced SystemTreeNode operates in.
Since:
Version 1.2
Returns:
OTF2_CALLBACK_SUCCESS or OTF2_CALLBACK_INTERRUPT.

Function pointer definition for the callback which is triggered by a SystemTreeNodeProperty definition record.

An arbitrary key/value property for a SystemTreeNode definition.

Parameters:
userDataUser data as set by OTF2_Reader_RegisterGlobalDefCallbacks or OTF2_GlobalDefReader_SetCallbacks.
systemTreeNodeParent SystemTreeNode definition to which this one is a supplementary definition. References a SystemTreeNode definition.
nameName of the property. References a String definition.
valueProperty value. References a String definition.
Since:
Version 1.2
Returns:
OTF2_CALLBACK_SUCCESS or OTF2_CALLBACK_INTERRUPT.

Function pointer definition for the callback which is triggered by an unknown definition record.

Parameters:
userDataUser data as set by OTF2_Reader_RegisterGlobalDefCallbacks or OTF2_GlobalDefReader_SetCallbacks.
Returns:
OTF2_CALLBACK_SUCCESS or OTF2_CALLBACK_INTERRUPT.

Function Documentation

void OTF2_GlobalDefReaderCallbacks_Clear ( OTF2_GlobalDefReaderCallbacks globalDefReaderCallbacks)

Clears a struct for the global definition callbacks.

Parameters:
globalDefReaderCallbacksHandle to a struct previously allocated with OTF2_GlobalDefReaderCallbacks_New.
void OTF2_GlobalDefReaderCallbacks_Delete ( OTF2_GlobalDefReaderCallbacks globalDefReaderCallbacks)

Deallocates a struct for the global definition callbacks.

Parameters:
globalDefReaderCallbacksHandle to a struct previously allocated with OTF2_GlobalDefReaderCallbacks_New.
Examples:
otf2_mpi_reader_example.c, otf2_mpi_reader_example.cc, and otf2_reader_example.c.
OTF2_GlobalDefReaderCallbacks* OTF2_GlobalDefReaderCallbacks_New ( void  )

Allocates a new struct for the global definition callbacks.

Returns:
A newly allocated struct of type OTF2_GlobalDefReaderCallbacks.
Examples:
otf2_mpi_reader_example.c, otf2_mpi_reader_example.cc, and otf2_reader_example.c.
OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetAttributeCallback ( OTF2_GlobalDefReaderCallbacks globalDefReaderCallbacks,
OTF2_GlobalDefReaderCallback_Attribute  attributeCallback 
)

Registers the callback for the Attribute definition.

Parameters:
globalDefReaderCallbacksStruct for all callbacks.
attributeCallbackFunction which should be called for all Attribute definitions.
Since:
Version 1.0
Returns:
OTF2_SUCCESS

if successful

OTF2_ERROR_INVALID_ARGUMENT

for an invalid defReaderCallbacks argument

OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetCallingContextCallback ( OTF2_GlobalDefReaderCallbacks globalDefReaderCallbacks,
OTF2_GlobalDefReaderCallback_CallingContext  callingContextCallback 
)

Registers the callback for the CallingContext definition.

Parameters:
globalDefReaderCallbacksStruct for all callbacks.
callingContextCallbackFunction which should be called for all CallingContext definitions.
Since:
Version 1.5
Returns:
OTF2_SUCCESS

if successful

OTF2_ERROR_INVALID_ARGUMENT

for an invalid defReaderCallbacks argument

OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetCallpathCallback ( OTF2_GlobalDefReaderCallbacks globalDefReaderCallbacks,
OTF2_GlobalDefReaderCallback_Callpath  callpathCallback 
)

Registers the callback for the Callpath definition.

Parameters:
globalDefReaderCallbacksStruct for all callbacks.
callpathCallbackFunction which should be called for all Callpath definitions.
Since:
Version 1.0
Returns:
OTF2_SUCCESS

if successful

OTF2_ERROR_INVALID_ARGUMENT

for an invalid defReaderCallbacks argument

OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetCallsiteCallback ( OTF2_GlobalDefReaderCallbacks globalDefReaderCallbacks,
OTF2_GlobalDefReaderCallback_Callsite  callsiteCallback 
)

Registers the callback for the Callsite definition.

Parameters:
globalDefReaderCallbacksStruct for all callbacks.
callsiteCallbackFunction which should be called for all Callsite definitions.
Since:
Version 1.0
Returns:
OTF2_SUCCESS

if successful

OTF2_ERROR_INVALID_ARGUMENT

for an invalid defReaderCallbacks argument

OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetCartCoordinateCallback ( OTF2_GlobalDefReaderCallbacks globalDefReaderCallbacks,
OTF2_GlobalDefReaderCallback_CartCoordinate  cartCoordinateCallback 
)

Registers the callback for the CartCoordinate definition.

Parameters:
globalDefReaderCallbacksStruct for all callbacks.
cartCoordinateCallbackFunction which should be called for all CartCoordinate definitions.
Since:
Version 1.3
Returns:
OTF2_SUCCESS

if successful

OTF2_ERROR_INVALID_ARGUMENT

for an invalid defReaderCallbacks argument

OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetCartDimensionCallback ( OTF2_GlobalDefReaderCallbacks globalDefReaderCallbacks,
OTF2_GlobalDefReaderCallback_CartDimension  cartDimensionCallback 
)

Registers the callback for the CartDimension definition.

Parameters:
globalDefReaderCallbacksStruct for all callbacks.
cartDimensionCallbackFunction which should be called for all CartDimension definitions.
Since:
Version 1.3
Returns:
OTF2_SUCCESS

if successful

OTF2_ERROR_INVALID_ARGUMENT

for an invalid defReaderCallbacks argument

OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetCartTopologyCallback ( OTF2_GlobalDefReaderCallbacks globalDefReaderCallbacks,
OTF2_GlobalDefReaderCallback_CartTopology  cartTopologyCallback 
)

Registers the callback for the CartTopology definition.

Parameters:
globalDefReaderCallbacksStruct for all callbacks.
cartTopologyCallbackFunction which should be called for all CartTopology definitions.
Since:
Version 1.3
Returns:
OTF2_SUCCESS

if successful

OTF2_ERROR_INVALID_ARGUMENT

for an invalid defReaderCallbacks argument

OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetClockPropertiesCallback ( OTF2_GlobalDefReaderCallbacks globalDefReaderCallbacks,
OTF2_GlobalDefReaderCallback_ClockProperties  clockPropertiesCallback 
)

Registers the callback for the ClockProperties definition.

Parameters:
globalDefReaderCallbacksStruct for all callbacks.
clockPropertiesCallbackFunction which should be called for all ClockProperties definitions.
Since:
Version 1.0
Returns:
OTF2_SUCCESS

if successful

OTF2_ERROR_INVALID_ARGUMENT

for an invalid defReaderCallbacks argument

OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetCommCallback ( OTF2_GlobalDefReaderCallbacks globalDefReaderCallbacks,
OTF2_GlobalDefReaderCallback_Comm  commCallback 
)

Registers the callback for the Comm definition.

Parameters:
globalDefReaderCallbacksStruct for all callbacks.
commCallbackFunction which should be called for all Comm definitions.
Since:
Version 1.0
Returns:
OTF2_SUCCESS

if successful

OTF2_ERROR_INVALID_ARGUMENT

for an invalid defReaderCallbacks argument

OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetGroupCallback ( OTF2_GlobalDefReaderCallbacks globalDefReaderCallbacks,
OTF2_GlobalDefReaderCallback_Group  groupCallback 
)

Registers the callback for the Group definition.

Parameters:
globalDefReaderCallbacksStruct for all callbacks.
groupCallbackFunction which should be called for all Group definitions.
Since:
Version 1.0
Returns:
OTF2_SUCCESS

if successful

OTF2_ERROR_INVALID_ARGUMENT

for an invalid defReaderCallbacks argument

OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetInterruptGeneratorCallback ( OTF2_GlobalDefReaderCallbacks globalDefReaderCallbacks,
OTF2_GlobalDefReaderCallback_InterruptGenerator  interruptGeneratorCallback 
)

Registers the callback for the InterruptGenerator definition.

Parameters:
globalDefReaderCallbacksStruct for all callbacks.
interruptGeneratorCallbackFunction which should be called for all InterruptGenerator definitions.
Since:
Version 1.5
Returns:
OTF2_SUCCESS

if successful

OTF2_ERROR_INVALID_ARGUMENT

for an invalid defReaderCallbacks argument

OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetLocationCallback ( OTF2_GlobalDefReaderCallbacks globalDefReaderCallbacks,
OTF2_GlobalDefReaderCallback_Location  locationCallback 
)

Registers the callback for the Location definition.

Parameters:
globalDefReaderCallbacksStruct for all callbacks.
locationCallbackFunction which should be called for all Location definitions.
Since:
Version 1.0
Returns:
OTF2_SUCCESS

if successful

OTF2_ERROR_INVALID_ARGUMENT

for an invalid defReaderCallbacks argument

Examples:
otf2_mpi_reader_example.c, otf2_mpi_reader_example.cc, and otf2_reader_example.c.
OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetLocationGroupCallback ( OTF2_GlobalDefReaderCallbacks globalDefReaderCallbacks,
OTF2_GlobalDefReaderCallback_LocationGroup  locationGroupCallback 
)

Registers the callback for the LocationGroup definition.

Parameters:
globalDefReaderCallbacksStruct for all callbacks.
locationGroupCallbackFunction which should be called for all LocationGroup definitions.
Since:
Version 1.0
Returns:
OTF2_SUCCESS

if successful

OTF2_ERROR_INVALID_ARGUMENT

for an invalid defReaderCallbacks argument

OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetLocationGroupPropertyCallback ( OTF2_GlobalDefReaderCallbacks globalDefReaderCallbacks,
OTF2_GlobalDefReaderCallback_LocationGroupProperty  locationGroupPropertyCallback 
)

Registers the callback for the LocationGroupProperty definition.

Parameters:
globalDefReaderCallbacksStruct for all callbacks.
locationGroupPropertyCallbackFunction which should be called for all LocationGroupProperty definitions.
Since:
Version 1.3
Returns:
OTF2_SUCCESS

if successful

OTF2_ERROR_INVALID_ARGUMENT

for an invalid defReaderCallbacks argument

OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetLocationPropertyCallback ( OTF2_GlobalDefReaderCallbacks globalDefReaderCallbacks,
OTF2_GlobalDefReaderCallback_LocationProperty  locationPropertyCallback 
)

Registers the callback for the LocationProperty definition.

Parameters:
globalDefReaderCallbacksStruct for all callbacks.
locationPropertyCallbackFunction which should be called for all LocationProperty definitions.
Since:
Version 1.3
Returns:
OTF2_SUCCESS

if successful

OTF2_ERROR_INVALID_ARGUMENT

for an invalid defReaderCallbacks argument

OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetMetricClassCallback ( OTF2_GlobalDefReaderCallbacks globalDefReaderCallbacks,
OTF2_GlobalDefReaderCallback_MetricClass  metricClassCallback 
)

Registers the callback for the MetricClass definition.

Parameters:
globalDefReaderCallbacksStruct for all callbacks.
metricClassCallbackFunction which should be called for all MetricClass definitions.
Since:
Version 1.0
Returns:
OTF2_SUCCESS

if successful

OTF2_ERROR_INVALID_ARGUMENT

for an invalid defReaderCallbacks argument

OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetMetricClassRecorderCallback ( OTF2_GlobalDefReaderCallbacks globalDefReaderCallbacks,
OTF2_GlobalDefReaderCallback_MetricClassRecorder  metricClassRecorderCallback 
)

Registers the callback for the MetricClassRecorder definition.

Parameters:
globalDefReaderCallbacksStruct for all callbacks.
metricClassRecorderCallbackFunction which should be called for all MetricClassRecorder definitions.
Since:
Version 1.2
Returns:
OTF2_SUCCESS

if successful

OTF2_ERROR_INVALID_ARGUMENT

for an invalid defReaderCallbacks argument

OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetMetricInstanceCallback ( OTF2_GlobalDefReaderCallbacks globalDefReaderCallbacks,
OTF2_GlobalDefReaderCallback_MetricInstance  metricInstanceCallback 
)

Registers the callback for the MetricInstance definition.

Parameters:
globalDefReaderCallbacksStruct for all callbacks.
metricInstanceCallbackFunction which should be called for all MetricInstance definitions.
Since:
Version 1.0
Returns:
OTF2_SUCCESS

if successful

OTF2_ERROR_INVALID_ARGUMENT

for an invalid defReaderCallbacks argument

OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetMetricMemberCallback ( OTF2_GlobalDefReaderCallbacks globalDefReaderCallbacks,
OTF2_GlobalDefReaderCallback_MetricMember  metricMemberCallback 
)

Registers the callback for the MetricMember definition.

Parameters:
globalDefReaderCallbacksStruct for all callbacks.
metricMemberCallbackFunction which should be called for all MetricMember definitions.
Since:
Version 1.0
Returns:
OTF2_SUCCESS

if successful

OTF2_ERROR_INVALID_ARGUMENT

for an invalid defReaderCallbacks argument

OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetParadigmCallback ( OTF2_GlobalDefReaderCallbacks globalDefReaderCallbacks,
OTF2_GlobalDefReaderCallback_Paradigm  paradigmCallback 
)

Registers the callback for the Paradigm definition.

Parameters:
globalDefReaderCallbacksStruct for all callbacks.
paradigmCallbackFunction which should be called for all Paradigm definitions.
Since:
Version 1.5
Returns:
OTF2_SUCCESS

if successful

OTF2_ERROR_INVALID_ARGUMENT

for an invalid defReaderCallbacks argument

OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetParadigmPropertyCallback ( OTF2_GlobalDefReaderCallbacks globalDefReaderCallbacks,
OTF2_GlobalDefReaderCallback_ParadigmProperty  paradigmPropertyCallback 
)

Registers the callback for the ParadigmProperty definition.

Parameters:
globalDefReaderCallbacksStruct for all callbacks.
paradigmPropertyCallbackFunction which should be called for all ParadigmProperty definitions.
Since:
Version 1.5
Returns:
OTF2_SUCCESS

if successful

OTF2_ERROR_INVALID_ARGUMENT

for an invalid defReaderCallbacks argument

OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetParameterCallback ( OTF2_GlobalDefReaderCallbacks globalDefReaderCallbacks,
OTF2_GlobalDefReaderCallback_Parameter  parameterCallback 
)

Registers the callback for the Parameter definition.

Parameters:
globalDefReaderCallbacksStruct for all callbacks.
parameterCallbackFunction which should be called for all Parameter definitions.
Since:
Version 1.0
Returns:
OTF2_SUCCESS

if successful

OTF2_ERROR_INVALID_ARGUMENT

for an invalid defReaderCallbacks argument

OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetRegionCallback ( OTF2_GlobalDefReaderCallbacks globalDefReaderCallbacks,
OTF2_GlobalDefReaderCallback_Region  regionCallback 
)

Registers the callback for the Region definition.

Parameters:
globalDefReaderCallbacksStruct for all callbacks.
regionCallbackFunction which should be called for all Region definitions.
Since:
Version 1.0
Returns:
OTF2_SUCCESS

if successful

OTF2_ERROR_INVALID_ARGUMENT

for an invalid defReaderCallbacks argument

OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetRmaWinCallback ( OTF2_GlobalDefReaderCallbacks globalDefReaderCallbacks,
OTF2_GlobalDefReaderCallback_RmaWin  rmaWinCallback 
)

Registers the callback for the RmaWin definition.

Parameters:
globalDefReaderCallbacksStruct for all callbacks.
rmaWinCallbackFunction which should be called for all RmaWin definitions.
Since:
Version 1.2
Returns:
OTF2_SUCCESS

if successful

OTF2_ERROR_INVALID_ARGUMENT

for an invalid defReaderCallbacks argument

OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetSourceCodeLocationCallback ( OTF2_GlobalDefReaderCallbacks globalDefReaderCallbacks,
OTF2_GlobalDefReaderCallback_SourceCodeLocation  sourceCodeLocationCallback 
)

Registers the callback for the SourceCodeLocation definition.

Parameters:
globalDefReaderCallbacksStruct for all callbacks.
sourceCodeLocationCallbackFunction which should be called for all SourceCodeLocation definitions.
Since:
Version 1.5
Returns:
OTF2_SUCCESS

if successful

OTF2_ERROR_INVALID_ARGUMENT

for an invalid defReaderCallbacks argument

OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetStringCallback ( OTF2_GlobalDefReaderCallbacks globalDefReaderCallbacks,
OTF2_GlobalDefReaderCallback_String  stringCallback 
)

Registers the callback for the String definition.

Parameters:
globalDefReaderCallbacksStruct for all callbacks.
stringCallbackFunction which should be called for all String definitions.
Since:
Version 1.0
Returns:
OTF2_SUCCESS

if successful

OTF2_ERROR_INVALID_ARGUMENT

for an invalid defReaderCallbacks argument

OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetSystemTreeNodeCallback ( OTF2_GlobalDefReaderCallbacks globalDefReaderCallbacks,
OTF2_GlobalDefReaderCallback_SystemTreeNode  systemTreeNodeCallback 
)

Registers the callback for the SystemTreeNode definition.

Parameters:
globalDefReaderCallbacksStruct for all callbacks.
systemTreeNodeCallbackFunction which should be called for all SystemTreeNode definitions.
Since:
Version 1.0
Returns:
OTF2_SUCCESS

if successful

OTF2_ERROR_INVALID_ARGUMENT

for an invalid defReaderCallbacks argument

OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetSystemTreeNodeDomainCallback ( OTF2_GlobalDefReaderCallbacks globalDefReaderCallbacks,
OTF2_GlobalDefReaderCallback_SystemTreeNodeDomain  systemTreeNodeDomainCallback 
)

Registers the callback for the SystemTreeNodeDomain definition.

Parameters:
globalDefReaderCallbacksStruct for all callbacks.
systemTreeNodeDomainCallbackFunction which should be called for all SystemTreeNodeDomain definitions.
Since:
Version 1.2
Returns:
OTF2_SUCCESS

if successful

OTF2_ERROR_INVALID_ARGUMENT

for an invalid defReaderCallbacks argument

OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetSystemTreeNodePropertyCallback ( OTF2_GlobalDefReaderCallbacks globalDefReaderCallbacks,
OTF2_GlobalDefReaderCallback_SystemTreeNodeProperty  systemTreeNodePropertyCallback 
)

Registers the callback for the SystemTreeNodeProperty definition.

Parameters:
globalDefReaderCallbacksStruct for all callbacks.
systemTreeNodePropertyCallbackFunction which should be called for all SystemTreeNodeProperty definitions.
Since:
Version 1.2
Returns:
OTF2_SUCCESS

if successful

OTF2_ERROR_INVALID_ARGUMENT

for an invalid defReaderCallbacks argument

OTF2_ErrorCode OTF2_GlobalDefReaderCallbacks_SetUnknownCallback ( OTF2_GlobalDefReaderCallbacks globalDefReaderCallbacks,
OTF2_GlobalDefReaderCallback_Unknown  unknownCallback 
)

Registers the callback for an unknown definition.

Parameters:
globalDefReaderCallbacksStruct for all callbacks.
unknownCallbackFunction which should be called for all Unknown definitions.
Returns:
OTF2_SUCCESS

if successful

OTF2_ERROR_INVALID_ARGUMENT

for an invalid defReaderCallbacks argument