3.0-rc2 (revision 337012f1)
OTF2_Reader.h
Go to the documentation of this file.
1 /*
2  * This file is part of the Score-P software (http://www.score-p.org)
3  *
4  * Copyright (c) 2009-2013,
5  * RWTH Aachen University, Germany
6  *
7  * Copyright (c) 2009-2013,
8  * Gesellschaft fuer numerische Simulation mbH Braunschweig, Germany
9  *
10  * Copyright (c) 2009-2014, 2021,
11  * Technische Universitaet Dresden, Germany
12  *
13  * Copyright (c) 2009-2013,
14  * University of Oregon, Eugene, USA
15  *
16  * Copyright (c) 2009-2014,
17  * Forschungszentrum Juelich GmbH, Germany
18  *
19  * Copyright (c) 2009-2013,
20  * German Research School for Simulation Sciences GmbH, Juelich/Aachen, Germany
21  *
22  * Copyright (c) 2009-2013,
23  * Technische Universitaet Muenchen, Germany
24  *
25  * This software may be modified and distributed under the terms of
26  * a BSD-style license. See the COPYING file in the package base
27  * directory for details.
28  *
29  */
30 
31 
32 #ifndef OTF2_READER_H
33 #define OTF2_READER_H
34 
35 
175 #include <stdint.h>
176 
177 
178 #include "otf2_compiler.h"
179 
180 
181 #include <otf2/OTF2_ErrorCodes.h>
182 
183 
184 #include <otf2/OTF2_Archive.h>
185 
186 
187 #ifdef __cplusplus
188 extern "C" {
189 #endif /* __cplusplus */
190 
191 
193 typedef struct OTF2_Reader_struct OTF2_Reader;
194 
195 
208 OTF2_Reader_Open( const char* anchorFilePath );
209 
210 
221 OTF2_Reader_Close( OTF2_Reader* reader );
222 
223 
251  OTF2_Hint hint,
252  void* value );
253 
254 
275  const OTF2_CollectiveCallbacks* collectiveCallbacks,
276  void* collectiveData,
277  OTF2_CollectiveContext* globalCommContext,
278  OTF2_CollectiveContext* localCommContext );
279 
280 
290 
291 
313  const OTF2_LockingCallbacks* lockingCallbacks,
314  void* lockingData );
315 
316 
328  OTF2_EvtReader* evtReader,
329  const OTF2_EvtReaderCallbacks* callbacks,
330  void* userData );
331 
332 
345  OTF2_GlobalEvtReader* evtReader,
346  const OTF2_GlobalEvtReaderCallbacks* callbacks,
347  void* userData );
348 
349 
361  OTF2_DefReader* defReader,
362  const OTF2_DefReaderCallbacks* callbacks,
363  void* userData );
364 
365 
377  OTF2_GlobalDefReader* defReader,
378  const OTF2_GlobalDefReaderCallbacks* callbacks,
379  void* userData );
380 
381 
395  OTF2_SnapReader* snapReader,
396  const OTF2_SnapReaderCallbacks* callbacks,
397  void* userData );
398 
399 
414  OTF2_GlobalSnapReader* evtReader,
415  const OTF2_GlobalSnapReaderCallbacks* callbacks,
416  void* userData );
417 
418 
432  OTF2_MarkerReader* markerReader,
433  const OTF2_MarkerReaderCallbacks* callbacks,
434  void* userData );
435 
436 
448  OTF2_EvtReader* evtReader,
449  uint64_t eventsToRead,
450  uint64_t* eventsRead );
451 
452 
463  OTF2_EvtReader* evtReader,
464  uint64_t* eventsRead );
465 
466 
478  OTF2_EvtReader* evtReader,
479  uint64_t eventsToRead,
480  uint64_t* eventsRead );
481 
482 
492  OTF2_GlobalEvtReader* evtReader );
493 
494 
507  OTF2_GlobalEvtReader* evtReader,
508  int* flag );
509 
510 
522  OTF2_GlobalEvtReader* evtReader,
523  uint64_t eventsToRead,
524  uint64_t* eventsRead );
525 
526 
537  OTF2_GlobalEvtReader* evtReader,
538  uint64_t* eventsRead );
539 
540 
560  OTF2_DefReader* defReader,
561  uint64_t definitionsToRead,
562  uint64_t* definitionsRead );
563 
564 
583  OTF2_DefReader* defReader,
584  uint64_t* definitionsRead );
585 
586 
599  OTF2_GlobalDefReader* defReader,
600  uint64_t definitionsToRead,
601  uint64_t* definitionsRead );
602 
603 
615  OTF2_GlobalDefReader* defReader,
616  uint64_t* definitionsRead );
617 
618 
632  OTF2_SnapReader* snapReader,
633  uint64_t recordsToRead,
634  uint64_t* recordsRead );
635 
636 
649  OTF2_SnapReader* snapReader,
650  uint64_t* recordsRead );
651 
652 
667  OTF2_GlobalSnapReader* snapReader,
668  uint64_t recordsToRead,
669  uint64_t* recordsRead );
670 
671 
684  OTF2_GlobalSnapReader* snapReader,
685  uint64_t* recordsRead );
686 
687 
702  OTF2_MarkerReader* markerReader,
703  uint64_t markersToRead,
704  uint64_t* markersRead );
705 
706 
720  OTF2_MarkerReader* markerReader,
721  uint64_t* markersRead );
722 
723 
734  OTF2_LocationRef location );
735 
736 
746 
747 
758  OTF2_LocationRef location );
759 
760 
770 
771 
783  OTF2_LocationRef location );
784 
785 
796 
797 
810  uint32_t number );
811 
812 
824 
825 
837 
838 
848  OTF2_EvtReader* evtReader );
849 
850 
862  OTF2_GlobalEvtReader* globalEvtReader );
863 
864 
874  OTF2_DefReader* defReader );
875 
876 
886  OTF2_GlobalDefReader* globalDefReader );
887 
888 
900  OTF2_SnapReader* snapReader );
901 
902 
914  OTF2_GlobalSnapReader* globalSnapReader );
915 
916 
928  OTF2_ThumbReader* thumbReader );
929 
930 
942  OTF2_MarkerReader* markerReader );
943 
944 
956  OTF2_MarkerWriter* markerWriter );
957 
958 
970  uint8_t* major,
971  uint8_t* minor,
972  uint8_t* bugfix );
973 
974 
985  uint64_t* chunkSizeEvents,
986  uint64_t* chunkSizeDefinitions );
987 
988 
998  OTF2_FileSubstrate* substrate );
999 
1000 
1010  OTF2_Compression* compression );
1011 
1012 
1022  uint64_t* numberOfLocations );
1023 
1024 
1034  uint64_t* numberOfDefinitions );
1035 
1036 
1046  char** machineName );
1047 
1048 
1058  char** creator );
1059 
1060 
1070  char** description );
1071 
1072 
1085  uint32_t* numberOfProperties,
1086  char*** names );
1087 
1088 
1104  const char* name,
1105  char** value );
1106 
1107 
1124  const char* name,
1125  bool* value );
1126 
1127 
1137  uint64_t* id );
1138 
1139 
1151  uint32_t* number );
1152 
1153 
1165  uint32_t* number );
1166 
1167 
1181 
1182 
1198 
1199 
1213 
1214 
1230 
1231 
1245 
1246 
1262 
1263 
1276  OTF2_LocationRef location );
1277 
1278 
1289  bool* result );
1290 
1291 
1292 
1304  bool* result );
1305 
1306 
1307 
1308 #ifdef __cplusplus
1309 }
1310 #endif /* __cplusplus */
1311 
1312 
1313 #endif /* !OTF2_READER_H */
OTF2_ErrorCode OTF2_Reader_RegisterGlobalSnapCallbacks(OTF2_Reader *reader, OTF2_GlobalSnapReader *evtReader, const OTF2_GlobalSnapReaderCallbacks *callbacks, void *userData)
Register global event reader callbacks.
OTF2_ErrorCode OTF2_Reader_CloseMarkerReader(OTF2_Reader *reader, OTF2_MarkerReader *markerReader)
Closes the marker reader.
struct OTF2_MarkerReader_struct OTF2_MarkerReader
OTF2 marker reader handle.
Definition: OTF2_GeneralDefinitions.h:271
OTF2_ErrorCode OTF2_Reader_CloseSnapFiles(OTF2_Reader *reader)
Closes the snapshots file container.
OTF2_ErrorCode OTF2_Reader_CloseGlobalSnapReader(OTF2_Reader *reader, OTF2_GlobalSnapReader *globalSnapReader)
Closes the global snapshot reader.
struct OTF2_GlobalDefReaderCallbacks_struct OTF2_GlobalDefReaderCallbacks
Opaque struct which holds all global definition record callbacks.
Definition: OTF2_GlobalDefReaderCallbacks.h:65
OTF2_ErrorCode OTF2_Reader_HasGlobalEvent(OTF2_Reader *reader, OTF2_GlobalEvtReader *evtReader, int *flag)
Has the global event reader at least one more event to deliver.
struct OTF2_GlobalDefReader_struct OTF2_GlobalDefReader
OTF2 global definition reader handle.
Definition: OTF2_GeneralDefinitions.h:259
OTF2_ErrorCode OTF2_Reader_ReadMarkers(OTF2_Reader *reader, OTF2_MarkerReader *markerReader, uint64_t markersToRead, uint64_t *markersRead)
Read a given number of markers via a marker reader.
struct OTF2_GlobalSnapReaderCallbacks_struct OTF2_GlobalSnapReaderCallbacks
Opaque struct which holds all snap record callbacks.
Definition: OTF2_GlobalSnapReaderCallbacks.h:45
OTF2_ErrorCode OTF2_Reader_SetSerialCollectiveCallbacks(OTF2_Reader *reader)
Convenient function to set the collective callbacks to a serial implementation.
OTF2_ErrorCode OTF2_Reader_GetBoolProperty(OTF2_Reader *reader, const char *name, bool *value)
Get the value of the named trace file property as boolean.
OTF2_GlobalSnapReader * OTF2_Reader_GetGlobalSnapReader(OTF2_Reader *reader)
Get a global snap reader.
uint64_t OTF2_LocationRef
Type used to indicate a reference to a Location definition.
Definition: OTF2_GeneralDefinitions.h:142
OTF2_ErrorCode OTF2_Reader_ReadAllLocalDefinitions(OTF2_Reader *reader, OTF2_DefReader *defReader, uint64_t *definitionsRead)
Read all definitions via a local definition reader.
OTF2_ErrorCode OTF2_Reader_IsMaster(OTF2_Reader *reader, bool *result)
Same as OTF2_Reader_IsPrimary.
struct OTF2_GlobalEvtReaderCallbacks_struct OTF2_GlobalEvtReaderCallbacks
Opaque struct which holds all event record callbacks.
Definition: OTF2_GlobalEvtReaderCallbacks.h:62
OTF2_Reader * OTF2_Reader_Open(const char *anchorFilePath)
Create a new reader handle.
OTF2_ErrorCode OTF2_Reader_ReadLocalEvents(OTF2_Reader *reader, OTF2_EvtReader *evtReader, uint64_t eventsToRead, uint64_t *eventsRead)
Read a given number of events via a local event reader.
OTF2_EvtReader * OTF2_Reader_GetEvtReader(OTF2_Reader *reader, OTF2_LocationRef location)
Get a local event reader.
OTF2_ErrorCode OTF2_Reader_CloseMarkerWriter(OTF2_Reader *reader, OTF2_MarkerWriter *markerWriter)
Closes the marker writer.
OTF2_ErrorCode OTF2_Reader_GetMachineName(OTF2_Reader *reader, char **machineName)
Get machine name.
OTF2_MarkerReader * OTF2_Reader_GetMarkerReader(OTF2_Reader *reader)
Get a marker reader.
OTF2_ErrorCode OTF2_Reader_CloseDefFiles(OTF2_Reader *reader)
Closes the local definitions file container.
OTF2_ErrorCode OTF2_Reader_ReadGlobalSnapshots(OTF2_Reader *reader, OTF2_GlobalSnapReader *snapReader, uint64_t recordsToRead, uint64_t *recordsRead)
Read a given number of records via a global snapshot reader.
OTF2_ErrorCode OTF2_Reader_RegisterSnapCallbacks(OTF2_Reader *reader, OTF2_SnapReader *snapReader, const OTF2_SnapReaderCallbacks *callbacks, void *userData)
Register snapshot event reader callbacks.
OTF2_GlobalEvtReader * OTF2_Reader_GetGlobalEvtReader(OTF2_Reader *reader)
Get a global event reader.
uint8_t OTF2_Hint
Wrapper for enum OTF2_Hint_enum.
Definition: OTF2_GeneralDefinitions.h:386
OTF2_GlobalDefReader * OTF2_Reader_GetGlobalDefReader(OTF2_Reader *reader)
Get a global definition reader.
OTF2_ErrorCode OTF2_Reader_RegisterGlobalEvtCallbacks(OTF2_Reader *reader, OTF2_GlobalEvtReader *evtReader, const OTF2_GlobalEvtReaderCallbacks *callbacks, void *userData)
Register global event reader callbacks.
Struct which holds all collective callbacks.
Definition: OTF2_Callbacks.h:497
struct OTF2_ThumbReader_struct OTF2_ThumbReader
Keeps all necessary information about the event reader. See OTF2_ThumbReader_struct for detailed info...
Definition: OTF2_Thumbnail.h:43
OTF2_ErrorCode OTF2_Reader_RegisterGlobalDefCallbacks(OTF2_Reader *reader, OTF2_GlobalDefReader *defReader, const OTF2_GlobalDefReaderCallbacks *callbacks, void *userData)
Register global definition reader callbacks.
OTF2_ErrorCode OTF2_Reader_GetFileSubstrate(OTF2_Reader *reader, OTF2_FileSubstrate *substrate)
Get file substrate information.
OTF2_DefReader * OTF2_Reader_GetDefReader(OTF2_Reader *reader, OTF2_LocationRef location)
Get a local definition reader.
OTF2_ErrorCode OTF2_Reader_SetCollectiveCallbacks(OTF2_Reader *reader, const OTF2_CollectiveCallbacks *collectiveCallbacks, void *collectiveData, OTF2_CollectiveContext *globalCommContext, OTF2_CollectiveContext *localCommContext)
Set the collective callbacks for the reader.
OTF2_ErrorCode
Definition: OTF2_ErrorCodes.h:54
OTF2_ErrorCode OTF2_Reader_CloseGlobalEvtReader(OTF2_Reader *reader, OTF2_GlobalEvtReader *globalEvtReader)
Closes the global event reader.
OTF2_ErrorCode OTF2_Reader_SetHint(OTF2_Reader *reader, OTF2_Hint hint, void *value)
Set the hint in the reader to the given value.
OTF2_ErrorCode OTF2_Reader_CloseEvtReader(OTF2_Reader *reader, OTF2_EvtReader *evtReader)
Close a local event reader.
OTF2_ErrorCode OTF2_Reader_ReadGlobalEvent(OTF2_Reader *reader, OTF2_GlobalEvtReader *evtReader)
Read an event via a global event reader.
OTF2_ErrorCode OTF2_Reader_RegisterDefCallbacks(OTF2_Reader *reader, OTF2_DefReader *defReader, const OTF2_DefReaderCallbacks *callbacks, void *userData)
Register local definition reader callbacks.
OTF2_ErrorCode OTF2_Reader_CloseSnapReader(OTF2_Reader *reader, OTF2_SnapReader *snapReader)
Close a local snapshot reader.
OTF2_ErrorCode OTF2_Reader_RegisterEvtCallbacks(OTF2_Reader *reader, OTF2_EvtReader *evtReader, const OTF2_EvtReaderCallbacks *callbacks, void *userData)
Register event reader callbacks.
OTF2_ErrorCode OTF2_Reader_OpenEvtFiles(OTF2_Reader *reader)
Open the events file container.
OTF2_ErrorCode OTF2_Reader_ReadAllGlobalEvents(OTF2_Reader *reader, OTF2_GlobalEvtReader *evtReader, uint64_t *eventsRead)
Read all events via a global event reader.
OTF2_ErrorCode OTF2_Reader_GetCreator(OTF2_Reader *reader, char **creator)
Get creator name.
struct OTF2_DefReaderCallbacks_struct OTF2_DefReaderCallbacks
Opaque struct which holds all definition record callbacks.
Definition: OTF2_DefReaderCallbacks.h:65
OTF2_ErrorCode OTF2_Reader_ReadAllMarkers(OTF2_Reader *reader, OTF2_MarkerReader *markerReader, uint64_t *markersRead)
Read all markers via a marker reader.
OTF2_ErrorCode OTF2_Reader_GetProperty(OTF2_Reader *reader, const char *name, char **value)
Get the value of the named trace file property.
OTF2_ErrorCode OTF2_Reader_GetNumberOfSnapshots(OTF2_Reader *reader, uint32_t *number)
Get number of snapshots.
struct OTF2_MarkerWriter_struct OTF2_MarkerWriter
Handle definition for the external marker writer.
Definition: OTF2_MarkerWriter.h:42
OTF2_SnapReader * OTF2_Reader_GetSnapReader(OTF2_Reader *reader, OTF2_LocationRef location)
Get a local snapshot reader.
OTF2_ErrorCode OTF2_Reader_RegisterMarkerCallbacks(OTF2_Reader *reader, OTF2_MarkerReader *markerReader, const OTF2_MarkerReaderCallbacks *callbacks, void *userData)
Register marker reader callbacks.
OTF2_MarkerWriter * OTF2_Reader_GetMarkerWriter(OTF2_Reader *reader)
Get a marker writer.
OTF2_ErrorCode OTF2_Reader_ReadGlobalEvents(OTF2_Reader *reader, OTF2_GlobalEvtReader *evtReader, uint64_t eventsToRead, uint64_t *eventsRead)
Read a given number of events via a global event reader.
struct OTF2_SnapReader_struct OTF2_SnapReader
OTF2 local snap reader handle.
Definition: OTF2_GeneralDefinitions.h:263
struct OTF2_GlobalSnapReader_struct OTF2_GlobalSnapReader
OTF2 global snap reader handle.
Definition: OTF2_GeneralDefinitions.h:267
Compiler feature test macros.
struct OTF2_Reader_struct OTF2_Reader
Keeps all necessary information for the reader.
Definition: OTF2_Reader.h:193
OTF2_ErrorCode OTF2_Reader_ReadGlobalDefinitions(OTF2_Reader *reader, OTF2_GlobalDefReader *defReader, uint64_t definitionsToRead, uint64_t *definitionsRead)
Read a given number of definitions via a global definition reader.
OTF2_ErrorCode OTF2_Reader_Close(OTF2_Reader *reader)
Close a reader handle.
OTF2_ErrorCode OTF2_Reader_GetCompression(OTF2_Reader *reader, OTF2_Compression *compression)
Get compression mode.
OTF2_ErrorCode OTF2_Reader_CloseGlobalDefReader(OTF2_Reader *reader, OTF2_GlobalDefReader *globalDefReader)
Closes the global definition reader.
struct OTF2_DefReader_struct OTF2_DefReader
OTF2 local definition reader handle.
Definition: OTF2_GeneralDefinitions.h:255
OTF2_ErrorCode OTF2_Reader_CloseEvtFiles(OTF2_Reader *reader)
Closes the events file container.
Struct which holds all locking callbacks.
Definition: OTF2_Callbacks.h:643
OTF2_ErrorCode OTF2_Reader_GetDescription(OTF2_Reader *reader, char **description)
Get description.
OTF2_ErrorCode OTF2_Reader_GetChunkSize(OTF2_Reader *reader, uint64_t *chunkSizeEvents, uint64_t *chunkSizeDefinitions)
Get event and definition chunk sizes.
OTF2_ErrorCode OTF2_Reader_ReadLocalSnapshots(OTF2_Reader *reader, OTF2_SnapReader *snapReader, uint64_t recordsToRead, uint64_t *recordsRead)
Read a given number of records via a local snapshot reader.
struct OTF2_MarkerReaderCallbacks_struct OTF2_MarkerReaderCallbacks
Opaque struct which holds all definition record callbacks.
Definition: OTF2_MarkerReaderCallbacks.h:45
OTF2_ErrorCode OTF2_Reader_SelectLocation(OTF2_Reader *reader, OTF2_LocationRef location)
Select a location to be read.
Writing interface for OTF2 archives.
uint8_t OTF2_FileSubstrate
Wrapper for enum OTF2_FileSubstrate_enum.
Definition: OTF2_GeneralDefinitions.h:477
uint8_t OTF2_Compression
Defines which compression is used. Please see OTF2_Compression_enum for a detailed description...
Definition: OTF2_GeneralDefinitions.h:304
OTF2_ErrorCode OTF2_Reader_ReadLocalDefinitions(OTF2_Reader *reader, OTF2_DefReader *defReader, uint64_t definitionsToRead, uint64_t *definitionsRead)
Read a given number of definitions via a local definition reader.
OTF2_ErrorCode OTF2_Reader_ReadAllLocalSnapshots(OTF2_Reader *reader, OTF2_SnapReader *snapReader, uint64_t *recordsRead)
Read all records via a local snapshot reader.
OTF2_ErrorCode OTF2_Reader_ReadAllLocalEvents(OTF2_Reader *reader, OTF2_EvtReader *evtReader, uint64_t *eventsRead)
Read all events via a local event reader.
OTF2_ErrorCode OTF2_Reader_GetPropertyNames(OTF2_Reader *reader, uint32_t *numberOfProperties, char ***names)
Get the names of all trace file properties.
OTF2_ErrorCode OTF2_Reader_OpenSnapFiles(OTF2_Reader *reader)
Open the snapshots file container.
OTF2_ErrorCode OTF2_Reader_GetNumberOfLocations(OTF2_Reader *reader, uint64_t *numberOfLocations)
Get number of locations.
OTF2_ErrorCode OTF2_Reader_ReadLocalEventsBackward(OTF2_Reader *reader, OTF2_EvtReader *evtReader, uint64_t eventsToRead, uint64_t *eventsRead)
Read a given number of events via a local event reader backwards.
struct OTF2_CollectiveContext OTF2_CollectiveContext
User provided type for collective groups.
Definition: OTF2_Callbacks.h:310
OTF2_ErrorCode OTF2_Reader_ReadAllGlobalDefinitions(OTF2_Reader *reader, OTF2_GlobalDefReader *defReader, uint64_t *definitionsRead)
Read all definitions via a global definition reader.
OTF2_ErrorCode OTF2_Reader_GetTraceId(OTF2_Reader *reader, uint64_t *id)
Get the identifier of the trace file.
struct OTF2_SnapReaderCallbacks_struct OTF2_SnapReaderCallbacks
Opaque struct which holds all snap event record callbacks.
Definition: OTF2_SnapReaderCallbacks.h:45
OTF2_ErrorCode OTF2_Reader_GetNumberOfGlobalDefinitions(OTF2_Reader *reader, uint64_t *numberOfDefinitions)
Get number of global definitions.
OTF2_ErrorCode OTF2_Reader_GetVersion(OTF2_Reader *reader, uint8_t *major, uint8_t *minor, uint8_t *bugfix)
Get OTF2 version.
OTF2_ThumbReader * OTF2_Reader_GetThumbReader(OTF2_Reader *reader, uint32_t number)
Get a thumb reader.
OTF2_ErrorCode OTF2_Reader_IsPrimary(OTF2_Reader *reader, bool *result)
Determines if this reader is the primary archive which handles the global archive state (anchor file...
Error codes and error handling.
OTF2_ErrorCode OTF2_Reader_OpenDefFiles(OTF2_Reader *reader)
Open the local definitions file container.
OTF2_ErrorCode OTF2_Reader_CloseDefReader(OTF2_Reader *reader, OTF2_DefReader *defReader)
Close a local definition reader.
OTF2_ErrorCode OTF2_Reader_CloseThumbReader(OTF2_Reader *reader, OTF2_ThumbReader *thumbReader)
Close an opened thumbnail reader.
OTF2_ErrorCode OTF2_Reader_GetNumberOfThumbnails(OTF2_Reader *reader, uint32_t *number)
Get number of thumbs.
struct OTF2_EvtReader_struct OTF2_EvtReader
OTF2 local event reader handle.
Definition: OTF2_GeneralDefinitions.h:247
struct OTF2_EvtReaderCallbacks_struct OTF2_EvtReaderCallbacks
Opaque struct which holds all event record callbacks.
Definition: OTF2_EvtReaderCallbacks.h:62
struct OTF2_GlobalEvtReader_struct OTF2_GlobalEvtReader
OTF2 global event reader handle.
Definition: OTF2_GeneralDefinitions.h:251
OTF2_ErrorCode OTF2_Reader_ReadAllGlobalSnapshots(OTF2_Reader *reader, OTF2_GlobalSnapReader *snapReader, uint64_t *recordsRead)
Read all records via a global snapshot reader.
OTF2_ErrorCode OTF2_Reader_SetLockingCallbacks(OTF2_Reader *reader, const OTF2_LockingCallbacks *lockingCallbacks, void *lockingData)
Set the locking callbacks for the reader.