SCOREP_SubstrateEvents.h

Go to the documentation of this file.

/*
 * SPDX-FileCopyrightText: (c) 2016 Technische Universität Dresden <tu-dresden.de>
 * SPDX-FileCopyrightText: (c) 2015 Technische Universität München <tum.de>
 * SPDX-FileCopyrightText: (c) 2018 Forschungszentrum Jülich GmbH <fz-juelich.de>
 * SPDX-FileCopyrightText: (c) 2022 Deutsches Zentrum für Luft- und Raumfahrt <dlr.de>
 *
 * SPDX-License-Identifier: BSD-3-Clause
 *
 */


#ifndef SCOREP_SUBSTRATE_EVENTS_H
#define SCOREP_SUBSTRATE_EVENTS_H

#include <stdbool.h>
#include <stddef.h>

#include <scorep/SCOREP_MetricTypes.h>
#include <scorep/SCOREP_PublicTypes.h>
#include <scorep/SCOREP_PublicHandles.h>


typedef void ( * SCOREP_Substrates_Callback )( void );

struct SCOREP_Location;

typedef enum SCOREP_Substrates_Mode
{
    SCOREP_SUBSTRATES_RECORDING_ENABLED = 0, 
    SCOREP_SUBSTRATES_RECORDING_DISABLED,    
    SCOREP_SUBSTRATES_NUM_MODES              
} SCOREP_Substrates_Mode;

typedef enum SCOREP_Substrates_EventType
{
    SCOREP_EVENT_ENABLE_RECORDING = 0,                 
    SCOREP_EVENT_DISABLE_RECORDING,                    
    SCOREP_EVENT_ON_TRACING_BUFFER_FLUSH_BEGIN,        
    SCOREP_EVENT_ON_TRACING_BUFFER_FLUSH_END,          
    SCOREP_EVENT_ENTER_REGION,                         
    SCOREP_EVENT_EXIT_REGION,                          
    SCOREP_EVENT_SAMPLE,                               
    SCOREP_EVENT_CALLING_CONTEXT_ENTER,                
    SCOREP_EVENT_CALLING_CONTEXT_EXIT,                 
    SCOREP_EVENT_ENTER_REWIND_REGION,                  
    SCOREP_EVENT_EXIT_REWIND_REGION,                   
    SCOREP_EVENT_MPI_SEND,                             
    SCOREP_EVENT_MPI_RECV,                             
    SCOREP_EVENT_MPI_COLLECTIVE_BEGIN,                 
    SCOREP_EVENT_MPI_COLLECTIVE_END,                   
    SCOREP_EVENT_MPI_ISEND_COMPLETE,                   
    SCOREP_EVENT_MPI_IRECV_REQUEST,                    
    SCOREP_EVENT_MPI_REQUEST_TESTED,                   
    SCOREP_EVENT_MPI_REQUEST_CANCELLED,                
    SCOREP_EVENT_MPI_ISEND,                            
    SCOREP_EVENT_MPI_IRECV,                            
    SCOREP_EVENT_RMA_WIN_CREATE,                       
    SCOREP_EVENT_RMA_WIN_DESTROY,                      
    SCOREP_EVENT_RMA_COLLECTIVE_BEGIN,                 
    SCOREP_EVENT_RMA_COLLECTIVE_END,                   
    SCOREP_EVENT_RMA_TRY_LOCK,                         
    SCOREP_EVENT_RMA_ACQUIRE_LOCK,                     
    SCOREP_EVENT_RMA_REQUEST_LOCK,                     
    SCOREP_EVENT_RMA_RELEASE_LOCK,                     
    SCOREP_EVENT_RMA_SYNC,                             
    SCOREP_EVENT_RMA_GROUP_SYNC,                       
    SCOREP_EVENT_RMA_PUT,                              
    SCOREP_EVENT_RMA_GET,                              
    SCOREP_EVENT_RMA_ATOMIC,                           
    SCOREP_EVENT_RMA_WAIT_CHANGE,                      
    SCOREP_EVENT_RMA_OP_COMPLETE_BLOCKING,             
    SCOREP_EVENT_RMA_OP_COMPLETE_NON_BLOCKING,         
    SCOREP_EVENT_RMA_OP_TEST,                          
    SCOREP_EVENT_RMA_OP_COMPLETE_REMOTE,               
    SCOREP_EVENT_THREAD_ACQUIRE_LOCK,                  
    SCOREP_EVENT_THREAD_RELEASE_LOCK,                  
    SCOREP_EVENT_TRIGGER_COUNTER_INT64,                
    SCOREP_EVENT_TRIGGER_COUNTER_UINT64,               
    SCOREP_EVENT_TRIGGER_COUNTER_DOUBLE,               
    SCOREP_EVENT_TRIGGER_PARAMETER_INT64,              
    SCOREP_EVENT_TRIGGER_PARAMETER_UINT64,             
    SCOREP_EVENT_TRIGGER_PARAMETER_STRING,             
    SCOREP_EVENT_THREAD_FORK_JOIN_FORK,                
    SCOREP_EVENT_THREAD_FORK_JOIN_JOIN,                
    SCOREP_EVENT_THREAD_FORK_JOIN_TEAM_BEGIN,          
    SCOREP_EVENT_THREAD_FORK_JOIN_TEAM_END,            
    SCOREP_EVENT_THREAD_FORK_JOIN_TASK_CREATE,         
    SCOREP_EVENT_THREAD_FORK_JOIN_TASK_SWITCH,         
    SCOREP_EVENT_THREAD_FORK_JOIN_TASK_BEGIN,          
    SCOREP_EVENT_THREAD_FORK_JOIN_TASK_END,            
    SCOREP_EVENT_THREAD_CREATE_WAIT_CREATE,            
    SCOREP_EVENT_THREAD_CREATE_WAIT_WAIT,              
    SCOREP_EVENT_THREAD_CREATE_WAIT_BEGIN,             
    SCOREP_EVENT_THREAD_CREATE_WAIT_END,               
    SCOREP_EVENT_TRACK_ALLOC,                          
    SCOREP_EVENT_TRACK_REALLOC,                        
    SCOREP_EVENT_TRACK_FREE,                           
    SCOREP_EVENT_WRITE_POST_MORTEM_METRICS,            
    SCOREP_EVENT_PROGRAM_BEGIN,                        
    SCOREP_EVENT_PROGRAM_END,                          
    SCOREP_EVENT_IO_CREATE_HANDLE,                     
    SCOREP_EVENT_IO_DESTROY_HANDLE,                    
    SCOREP_EVENT_IO_DUPLICATE_HANDLE,                  
    SCOREP_EVENT_IO_SEEK,                              
    SCOREP_EVENT_IO_CHANGE_STATUS_FLAGS,               
    SCOREP_EVENT_IO_DELETE_FILE,                       
    SCOREP_EVENT_IO_OPERATION_BEGIN,                   
    SCOREP_EVENT_IO_OPERATION_ISSUED,                  
    SCOREP_EVENT_IO_OPERATION_TEST,                    
    SCOREP_EVENT_IO_OPERATION_COMPLETE,                
    SCOREP_EVENT_IO_OPERATION_CANCELLED,               
    SCOREP_EVENT_IO_ACQUIRE_LOCK,                      
    SCOREP_EVENT_IO_TRY_LOCK,                          
    SCOREP_EVENT_IO_RELEASE_LOCK,                      
    SCOREP_EVENT_MPI_NON_BLOCKING_COLLECTIVE_REQUEST,  
    SCOREP_EVENT_MPI_NON_BLOCKING_COLLECTIVE_COMPLETE, 
    SCOREP_EVENT_COMM_CREATE,                          
    SCOREP_EVENT_COMM_DESTROY,                         
    SCOREP_EVENT_MPI_PROBE,                            
    SCOREP_EVENT_MPI_MRECV,                            
    SCOREP_EVENT_MPI_IMRECV_REQUEST,                   
    SCOREP_EVENT_MPI_IMRECV,                           
    SCOREP_SUBSTRATES_NUM_EVENTS                       
} SCOREP_Substrates_EventType;


typedef void ( * SCOREP_Substrates_EnableRecordingCb )(
    struct SCOREP_Location* location,
    uint64_t                timestamp,
    SCOREP_RegionHandle     regionHandle,
    uint64_t*               metricValues );

typedef void ( * SCOREP_Substrates_DisableRecordingCb )(
    struct SCOREP_Location* location,
    uint64_t                timestamp,
    SCOREP_RegionHandle     regionHandle,
    uint64_t*               metricValues );

typedef void ( * SCOREP_Substrates_OnTracingBufferFlushBeginCb )(
    struct SCOREP_Location* location,
    uint64_t                timestamp,
    SCOREP_RegionHandle     regionHandle,
    uint64_t*               metricValues );

typedef void ( * SCOREP_Substrates_OnTracingBufferFlushEndCb )(
    struct SCOREP_Location* location,
    uint64_t                timestamp,
    SCOREP_RegionHandle     regionHandle,
    uint64_t*               metricValues );

typedef void ( * SCOREP_Substrates_ProgramBeginCb )(
    struct SCOREP_Location* location,
    uint64_t                timestamp,
    SCOREP_StringHandle     programName,
    uint32_t                numberOfProgramArgs,
    SCOREP_StringHandle*    programArguments,
    SCOREP_RegionHandle     programRegionHandle,
    uint64_t                processId,
    uint64_t                threadId );
typedef void ( * SCOREP_Substrates_ProgramEndCb )(
    struct SCOREP_Location* location,
    uint64_t                timestamp,
    SCOREP_ExitStatus       exitStatus,
    SCOREP_RegionHandle     programRegionHandle );

typedef void ( * SCOREP_Substrates_EnterRegionCb )(
    struct SCOREP_Location* location,
    uint64_t                timestamp,
    SCOREP_RegionHandle     regionHandle,
    uint64_t*               metricValues );

typedef void ( * SCOREP_Substrates_ExitRegionCb )(
    struct SCOREP_Location* location,
    uint64_t                timestamp,
    SCOREP_RegionHandle     regionHandle,
    uint64_t*               metricValues );

typedef void ( * SCOREP_Substrates_SampleCb )(
    struct SCOREP_Location*         location,
    uint64_t                        timestamp,
    SCOREP_CallingContextHandle     callingContext,
    SCOREP_CallingContextHandle     previousCallingContext,
    uint32_t                        unwindDistance,
    SCOREP_InterruptGeneratorHandle interruptGeneratorHandle,
    uint64_t*                       metricValues );

typedef void ( * SCOREP_Substrates_CallingContextEnterCb )(
    struct SCOREP_Location*     location,
    uint64_t                    timestamp,
    SCOREP_CallingContextHandle callingContext,
    SCOREP_CallingContextHandle previousCallingContext,
    uint32_t                    unwindDistance,
    uint64_t*                   metricValues );

typedef void ( * SCOREP_Substrates_CallingContextExitCb )(
    struct SCOREP_Location*     location,
    uint64_t                    timestamp,
    SCOREP_CallingContextHandle callingContext,
    SCOREP_CallingContextHandle previousCallingContext,
    uint32_t                    unwindDistance,
    uint64_t*                   metricValues );

typedef void ( * SCOREP_Substrates_EnterRewindRegionCb )(
    struct SCOREP_Location* location,
    uint64_t                timestamp,
    SCOREP_RegionHandle     regionHandle );

typedef void ( * SCOREP_Substrates_ExitRewindRegionCb )(
    struct SCOREP_Location* location,
    uint64_t                timestamp,
    SCOREP_RegionHandle     regionHandle,
    bool                    doRewind );

typedef void ( * SCOREP_Substrates_MpiSendCb )(
    struct SCOREP_Location*          location,
    uint64_t                         timestamp,
    SCOREP_MpiRank                   destinationRank,
    SCOREP_InterimCommunicatorHandle communicatorHandle,
    uint32_t                         tag,
    uint64_t                         bytesSent );

typedef void ( * SCOREP_Substrates_MpiRecvCb )(
    struct SCOREP_Location*          location,
    uint64_t                         timestamp,
    SCOREP_MpiRank                   sourceRank,
    SCOREP_InterimCommunicatorHandle communicatorHandle,
    uint32_t                         tag,
    uint64_t                         bytesReceived );

typedef void ( * SCOREP_Substrates_MpiCollectiveBeginCb )(
    struct SCOREP_Location* location,
    uint64_t                timestamp );


typedef void ( * SCOREP_Substrates_MpiCollectiveEndCb )(
    struct SCOREP_Location*          location,
    uint64_t                         timestamp,
    SCOREP_InterimCommunicatorHandle communicatorHandle,
    SCOREP_MpiRank                   rootRank,
    SCOREP_CollectiveType            collectiveType,
    uint64_t                         bytesSent,
    uint64_t                         bytesReceived );

typedef void ( * SCOREP_Substrates_MpiNonBlockingCollectiveRequestCb )(
    struct SCOREP_Location* location,
    uint64_t                timestamp,
    SCOREP_MpiRequestId     requestId );


typedef void ( * SCOREP_Substrates_MpiNonBlockingCollectiveCompleteCb )(
    struct SCOREP_Location*          location,
    uint64_t                         timestamp,
    SCOREP_InterimCommunicatorHandle communicatorHandle,
    SCOREP_MpiRank                   rootRank,
    SCOREP_CollectiveType            collectiveType,
    uint64_t                         bytesSent,
    uint64_t                         bytesReceived,
    SCOREP_MpiRequestId              requestId );

typedef void ( * SCOREP_Substrates_MpiIsendCompleteCb )(
    struct SCOREP_Location* location,
    uint64_t                timestamp,
    SCOREP_MpiRequestId     requestId );

typedef void ( * SCOREP_Substrates_MpiIrecvRequestCb )(
    struct SCOREP_Location* location,
    uint64_t                timestamp,
    SCOREP_MpiRequestId     requestId );

typedef void ( * SCOREP_Substrates_MpiRequestTestedCb )(
    struct SCOREP_Location* location,
    uint64_t                timestamp,
    SCOREP_MpiRequestId     requestId );

typedef void ( * SCOREP_Substrates_MpiRequestCancelledCb )(
    struct SCOREP_Location* location,
    uint64_t                timestamp,
    SCOREP_MpiRequestId     requestId );

typedef void ( * SCOREP_Substrates_MpiIsendCb )(
    struct SCOREP_Location*          location,
    uint64_t                         timestamp,
    SCOREP_MpiRank                   destinationRank,
    SCOREP_InterimCommunicatorHandle communicatorHandle,
    uint32_t                         tag,
    uint64_t                         bytesSent,
    SCOREP_MpiRequestId              requestId );

typedef void ( * SCOREP_Substrates_MpiIrecvCb )(
    struct SCOREP_Location*          location,
    uint64_t                         timestamp,
    SCOREP_MpiRank                   sourceRank,
    SCOREP_InterimCommunicatorHandle communicatorHandle,
    uint32_t                         tag,
    uint64_t                         bytesReceived,
    SCOREP_MpiRequestId              requestId );

typedef void ( * SCOREP_Substrates_RmaWinCreateCb )(
    struct SCOREP_Location* location,
    uint64_t                timestamp,
    SCOREP_RmaWindowHandle  windowHandle );

typedef void ( * SCOREP_Substrates_RmaWinDestroyCb )(
    struct SCOREP_Location* location,
    uint64_t                timestamp,
    SCOREP_RmaWindowHandle  windowHandle );

typedef void ( * SCOREP_Substrates_RmaCollectiveBeginCb )(
    struct SCOREP_Location* location,
    uint64_t                timestamp,
    SCOREP_RmaSyncLevel     syncLevel );

typedef void ( * SCOREP_Substrates_RmaCollectiveEndCb )(
    struct SCOREP_Location* location,
    uint64_t                timestamp,
    SCOREP_CollectiveType   collectiveOp,
    SCOREP_RmaSyncLevel     syncLevel,
    SCOREP_RmaWindowHandle  windowHandle,
    uint32_t                root,
    uint64_t                bytesSent,
    uint64_t                bytesReceived );

typedef void ( * SCOREP_Substrates_RmaTryLockCb )(
    struct SCOREP_Location* location,
    uint64_t                timestamp,
    SCOREP_RmaWindowHandle  windowHandle,
    uint32_t                remote,
    uint64_t                lockId,
    SCOREP_LockType         lockType );

typedef void ( * SCOREP_Substrates_RmaAcquireLockCb )(
    struct SCOREP_Location* location,
    uint64_t                timestamp,
    SCOREP_RmaWindowHandle  windowHandle,
    uint32_t                remote,
    uint64_t                lockId,
    SCOREP_LockType         lockType );


typedef void ( * SCOREP_Substrates_RmaRequestLockCb )(
    struct SCOREP_Location* location,
    uint64_t                timestamp,
    SCOREP_RmaWindowHandle  windowHandle,
    uint32_t                remote,
    uint64_t                lockId,
    SCOREP_LockType         lockType );


typedef void ( * SCOREP_Substrates_RmaReleaseLockCb )(
    struct SCOREP_Location* location,
    uint64_t                timestamp,
    SCOREP_RmaWindowHandle  windowHandle,
    uint32_t                remote,
    uint64_t                lockId );

typedef void ( * SCOREP_Substrates_RmaSyncCb )(
    struct SCOREP_Location* location,
    uint64_t                timestamp,
    SCOREP_RmaWindowHandle  windowHandle,
    uint32_t                remote,
    SCOREP_RmaSyncType      syncType );

typedef void ( * SCOREP_Substrates_RmaGroupSyncCb )(
    struct SCOREP_Location* location,
    uint64_t                timestamp,
    SCOREP_RmaSyncLevel     syncLevel,
    SCOREP_RmaWindowHandle  windowHandle,
    SCOREP_GroupHandle      groupHandle );

typedef void ( * SCOREP_Substrates_RmaPutCb )(
    struct SCOREP_Location* location,
    uint64_t                timestamp,
    SCOREP_RmaWindowHandle  windowHandle,
    uint32_t                remote,
    uint64_t                bytes,
    uint64_t                matchingId );

typedef void ( * SCOREP_Substrates_RmaGetCb )(
    struct SCOREP_Location* location,
    uint64_t                timestamp,
    SCOREP_RmaWindowHandle  windowHandle,
    uint32_t                remote,
    uint64_t                bytes,
    uint64_t                matchingId );

typedef void ( * SCOREP_Substrates_RmaAtomicCb )(
    struct SCOREP_Location* location,
    uint64_t                timestamp,
    SCOREP_RmaWindowHandle  windowHandle,
    uint32_t                remote,
    SCOREP_RmaAtomicType    type,
    uint64_t                bytesSent,
    uint64_t                bytesReceived,
    uint64_t                matchingId );

typedef void ( * SCOREP_Substrates_RmaWaitChangeCb )(
    struct SCOREP_Location* location,
    uint64_t                timestamp,
    SCOREP_RmaWindowHandle  windowHandle );

typedef void ( * SCOREP_Substrates_RmaOpCompleteBlockingCb )(
    struct SCOREP_Location* location,
    uint64_t                timestamp,
    SCOREP_RmaWindowHandle  windowHandle,
    uint64_t                matchingId );

typedef void ( * SCOREP_Substrates_RmaOpCompleteNonBlockingCb )(
    struct SCOREP_Location* location,
    uint64_t                timestamp,
    SCOREP_RmaWindowHandle  windowHandle,
    uint64_t                matchingId );

typedef void ( * SCOREP_Substrates_RmaOpTestCb )(
    struct SCOREP_Location* location,
    uint64_t                timestamp,
    SCOREP_RmaWindowHandle  windowHandle,
    uint64_t                matchingId );


typedef void ( * SCOREP_Substrates_RmaOpCompleteRemoteCb )(
    struct SCOREP_Location* location,
    uint64_t                timestamp,
    SCOREP_RmaWindowHandle  windowHandle,
    uint64_t                matchingId );


typedef void ( * SCOREP_Substrates_ThreadAcquireLockCb )(
    struct SCOREP_Location* location,
    uint64_t                timestamp,
    SCOREP_ParadigmType     paradigm,
    uint32_t                lockId,
    uint32_t                acquisitionOrder );


typedef void ( * SCOREP_Substrates_ThreadReleaseLockCb )(
    struct SCOREP_Location* location,
    uint64_t                timestamp,
    SCOREP_ParadigmType     paradigm,
    uint32_t                lockId,
    uint32_t                acquisitionOrder );

typedef void ( * SCOREP_Substrates_TriggerCounterInt64Cb )(
    struct SCOREP_Location*  location,
    uint64_t                 timestamp,
    SCOREP_SamplingSetHandle counterHandle,
    int64_t                  value );

typedef void ( * SCOREP_Substrates_TriggerCounterUint64Cb )(
    struct SCOREP_Location*  location,
    uint64_t                 timestamp,
    SCOREP_SamplingSetHandle counterHandle,
    uint64_t                 value );

typedef void ( * SCOREP_Substrates_TriggerCounterDoubleCb )(
    struct SCOREP_Location*  location,
    uint64_t                 timestamp,
    SCOREP_SamplingSetHandle counterHandle,
    double                   value );
typedef void ( * SCOREP_Substrates_TriggerParameterInt64Cb )(
    struct SCOREP_Location* location,
    uint64_t                timestamp,
    SCOREP_ParameterHandle  parameterHandle,
    int64_t                 value );

typedef void ( * SCOREP_Substrates_TriggerParameterUint64Cb )(
    struct SCOREP_Location* location,
    uint64_t                timestamp,
    SCOREP_ParameterHandle  parameterHandle,
    uint64_t                value );
typedef void ( * SCOREP_Substrates_TriggerParameterStringCb )(
    struct SCOREP_Location* location,
    uint64_t                timestamp,
    SCOREP_ParameterHandle  parameterHandle,
    SCOREP_StringHandle     string_handle );

typedef void ( * SCOREP_Substrates_ThreadForkJoinForkCb )(
    struct SCOREP_Location* location,
    uint64_t                timestamp,
    SCOREP_ParadigmType     paradigm,
    uint32_t                nRequestedThreads,
    uint32_t                forkSequenceCount );

typedef void ( * SCOREP_Substrates_ThreadForkJoinJoinCb )(
    struct SCOREP_Location* location,
    uint64_t                timestamp,
    SCOREP_ParadigmType     paradigm );

typedef void ( * SCOREP_Substrates_ThreadForkJoinTeamBeginCb )(
    struct SCOREP_Location*          location,
    uint64_t                         timestamp,
    SCOREP_ParadigmType              paradigm,
    SCOREP_InterimCommunicatorHandle threadTeam,
    uint64_t                         threadId );

typedef void ( * SCOREP_Substrates_ThreadForkJoinTeamEndCb )(
    struct SCOREP_Location*          location,
    uint64_t                         timestamp,
    SCOREP_ParadigmType              paradigm,
    SCOREP_InterimCommunicatorHandle threadTeam );

typedef void ( * SCOREP_Substrates_ThreadForkJoinTaskCreateCb )(
    struct SCOREP_Location*          location,
    uint64_t                         timestamp,
    SCOREP_ParadigmType              paradigm,
    SCOREP_InterimCommunicatorHandle threadTeam,
    uint32_t                         threadId,
    uint32_t                         generationNumber );

typedef void ( * SCOREP_Substrates_ThreadForkJoinTaskSwitchCb )(
    struct SCOREP_Location*          location,
    uint64_t                         timestamp,
    uint64_t*                        metricValues,
    SCOREP_ParadigmType              paradigm,
    SCOREP_InterimCommunicatorHandle threadTeam,
    uint32_t                         threadId,
    uint32_t                         generationNumber,
    SCOREP_TaskHandle                taskHandle );

typedef void ( * SCOREP_Substrates_ThreadForkJoinTaskBeginCb )(
    struct SCOREP_Location*          location,
    uint64_t                         timestamp,
    SCOREP_RegionHandle              regionHandle,
    uint64_t*                        metricValues,
    SCOREP_ParadigmType              paradigm,
    SCOREP_InterimCommunicatorHandle threadTeam,
    uint32_t                         threadId,
    uint32_t                         generationNumber,
    SCOREP_TaskHandle                taskHandle );

typedef void ( * SCOREP_Substrates_ThreadForkJoinTaskEndCb )(
    struct SCOREP_Location*          location,
    uint64_t                         timestamp,
    SCOREP_RegionHandle              regionHandle,
    uint64_t*                        metricValues,
    SCOREP_ParadigmType              paradigm,
    SCOREP_InterimCommunicatorHandle threadTeam,
    uint32_t                         threadId,
    uint32_t                         generationNumber,
    SCOREP_TaskHandle                taskHandle );

typedef void ( * SCOREP_Substrates_ThreadCreateWaitCreateCb )(
    struct SCOREP_Location*          location,
    uint64_t                         timestamp,
    SCOREP_ParadigmType              paradigm,
    SCOREP_InterimCommunicatorHandle threadTeam,
    uint32_t                         createSequenceCount );

typedef void ( * SCOREP_Substrates_ThreadCreateWaitWaitCb )(
    struct SCOREP_Location*          location,
    uint64_t                         timestamp,
    SCOREP_ParadigmType              paradigm,
    SCOREP_InterimCommunicatorHandle threadTeam,
    uint32_t                         createSequenceCount );

typedef void ( * SCOREP_Substrates_ThreadCreateWaitBeginCb )(
    struct SCOREP_Location*          location,
    uint64_t                         timestamp,
    SCOREP_ParadigmType              paradigm,
    SCOREP_InterimCommunicatorHandle threadTeam,
    uint32_t                         createSequenceCount,
    uint64_t                         threadId );

typedef void ( * SCOREP_Substrates_ThreadCreateWaitEndCb )(
    struct SCOREP_Location*          location,
    uint64_t                         timestamp,
    SCOREP_ParadigmType              paradigm,
    SCOREP_InterimCommunicatorHandle threadTeam,
    uint32_t                         createSequenceCount );

typedef void ( * SCOREP_Substrates_TrackAllocCb )(
    struct SCOREP_Location* location,
    uint64_t                timestamp,
    uint64_t                addrAllocated,
    size_t                  bytesAllocated,
    void*                   substrateData[],
    size_t                  bytesAllocatedMetric,
    size_t                  bytesAllocatedProcess );

typedef void ( * SCOREP_Substrates_TrackReallocCb )(
    struct SCOREP_Location* location,
    uint64_t                timestamp,
    uint64_t                oldAddr,
    size_t                  oldBytesAllocated,
    void*                   oldSubstrateData[],
    uint64_t                newAddr,
    size_t                  newBytesAllocated,
    void*                   newSubstrateData[],
    size_t                  bytesAllocatedMetric,
    size_t                  bytesAllocatedProcess );

typedef void ( * SCOREP_Substrates_TrackFreeCb )(
    struct SCOREP_Location* location,
    uint64_t                timestamp,
    uint64_t                addrFreed,
    size_t                  bytesFreed,
    void*                   substrateData[],
    size_t                  bytesAllocatedMetric,
    size_t                  bytesAllocatedProcess );


typedef void ( * SCOREP_Substrates_WriteMetricsCb )(
    struct SCOREP_Location*  location,
    uint64_t                 timestamp,
    SCOREP_SamplingSetHandle samplingSet,
    const uint64_t*          metricValues );


typedef void ( * SCOREP_Substrates_IoCreateHandleCb )(
    struct SCOREP_Location* location,
    uint64_t                timestamp,
    SCOREP_IoHandleHandle   handle,
    SCOREP_IoAccessMode     mode,
    SCOREP_IoCreationFlag   creationFlags,
    SCOREP_IoStatusFlag     statusFlags );

typedef void ( * SCOREP_Substrates_IoDestroyHandleCb )(
    struct SCOREP_Location* location,
    uint64_t                timestamp,
    SCOREP_IoHandleHandle   handle );

typedef void ( * SCOREP_Substrates_IoDuplicateHandleCb )(
    struct SCOREP_Location* location,
    uint64_t                timestamp,
    SCOREP_IoHandleHandle   oldHandle,
    SCOREP_IoHandleHandle   newHandle,
    SCOREP_IoStatusFlag     statusFlags );

typedef void ( * SCOREP_Substrates_IoSeekCb )(
    struct SCOREP_Location* location,
    uint64_t                timestamp,
    SCOREP_IoHandleHandle   handle,
    int64_t                 offsetRequest,
    SCOREP_IoSeekOption     whence,
    uint64_t                offsetResult );

typedef void ( * SCOREP_Substrates_IoChangeStatusFlagsCb )(
    struct SCOREP_Location* location,
    uint64_t                timestamp,
    SCOREP_IoHandleHandle   handle,
    SCOREP_IoStatusFlag     statusFlags );

typedef void ( * SCOREP_Substrates_IoDeleteFileCb )(
    struct SCOREP_Location* location,
    uint64_t                timestamp,
    SCOREP_IoParadigmType   ioParadigm,
    SCOREP_IoFileHandle     ioFile );

typedef void ( * SCOREP_Substrates_IoOperationBeginCb )(
    struct SCOREP_Location* location,
    uint64_t                timestamp,
    SCOREP_IoHandleHandle   handle,
    SCOREP_IoOperationMode  mode,
    SCOREP_IoOperationFlag  operationFlags,
    uint64_t                bytesRequest,
    uint64_t                matchingId,
    uint64_t                offset );

typedef void ( * SCOREP_Substrates_IoOperationIssuedCb )(
    struct SCOREP_Location* location,
    uint64_t                timestamp,
    SCOREP_IoHandleHandle   handle,
    uint64_t                matchingId );

typedef void ( * SCOREP_Substrates_IoOperationTestCb )(
    struct SCOREP_Location* location,
    uint64_t                timestamp,
    SCOREP_IoHandleHandle   handle,
    uint64_t                matchingId );

typedef void ( * SCOREP_Substrates_IoOperationCompleteCb )(
    struct SCOREP_Location* location,
    uint64_t                timestamp,
    SCOREP_IoHandleHandle   handle,
    SCOREP_IoOperationMode  mode,
    uint64_t                bytesResult,
    uint64_t                matchingId );

typedef void ( * SCOREP_Substrates_IoOperationCancelledCb )(
    struct SCOREP_Location* location,
    uint64_t                timestamp,
    SCOREP_IoHandleHandle   handle,
    uint64_t                matchingId );

typedef void ( * SCOREP_Substrates_IoAcquireLockCb )(
    struct SCOREP_Location* location,
    uint64_t                timestamp,
    SCOREP_IoHandleHandle   handle,
    SCOREP_LockType         lockType );

typedef void ( * SCOREP_Substrates_IoReleaseLockCb )(
    struct SCOREP_Location* location,
    uint64_t                timestamp,
    SCOREP_IoHandleHandle   handle,
    SCOREP_LockType         lockType );

typedef void ( * SCOREP_Substrates_IoTryLockCb )(
    struct SCOREP_Location* location,
    uint64_t                timestamp,
    SCOREP_IoHandleHandle   handle,
    SCOREP_LockType         lockType );

typedef void ( * SCOREP_Substrates_CommCreateCb )(
    struct SCOREP_Location*          location,
    uint64_t                         timestamp,
    SCOREP_InterimCommunicatorHandle communicatorHandle );

typedef void ( * SCOREP_Substrates_CommDestroyCb )(
    struct SCOREP_Location*          location,
    uint64_t                         timestamp,
    SCOREP_InterimCommunicatorHandle communicatorHandle );


typedef void (* SCOREP_Substrates_MpiProbeCb )( struct SCOREP_Location*          location,
                                                uint64_t                         timestamp,
                                                SCOREP_MpiRank                   sender,
                                                SCOREP_InterimCommunicatorHandle communicator,
                                                uint32_t                         tag,
                                                SCOREP_MpiMessageId              messageId );

typedef void (* SCOREP_Substrates_MpiMrecvCb )( struct SCOREP_Location* location,
                                                uint64_t                timestamp,
                                                SCOREP_MpiMessageId     messageId,
                                                uint64_t                bytesReceived );

typedef void (* SCOREP_Substrates_MpiImrecvRequestCb )( struct SCOREP_Location* location,
                                                        uint64_t                timestamp,
                                                        SCOREP_MpiMessageId     messageId,
                                                        SCOREP_MpiRequestId     requestId );

typedef void (* SCOREP_Substrates_MpiImrecvCb )( struct SCOREP_Location* location,
                                                 uint64_t                timestamp,
                                                 SCOREP_MpiRequestId     requestId,
                                                 uint64_t                bytesReceived );

#endif /* SCOREP_SUBSTRATE_EVENTS_H */