2.3 (revision 117c8d5b)
OTF2_Definitions.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-2012,
5  * RWTH Aachen University, Germany
6  *
7  * Copyright (c) 2009-2012,
8  * Gesellschaft fuer numerische Simulation mbH Braunschweig, Germany
9  *
10  * Copyright (c) 2009-2012,
11  * Technische Universitaet Dresden, Germany
12  *
13  * Copyright (c) 2009-2012,
14  * University of Oregon, Eugene, USA
15  *
16  * Copyright (c) 2009-2012,
17  * Forschungszentrum Juelich GmbH, Germany
18  *
19  * Copyright (c) 2009-2012,
20  * German Research School for Simulation Sciences GmbH, Juelich/Aachen, Germany
21  *
22  * Copyright (c) 2009-2012,
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_DEFINITIONS_H
33 #define OTF2_DEFINITIONS_H
34 
35 
44 #include <otf2/OTF2_ErrorCodes.h>
45 
46 
48 
49 
50 #ifdef __cplusplus
51 extern "C" {
52 #endif /* __cplusplus */
53 
54 
56 typedef uint8_t OTF2_SystemTreeDomain;
57 
64 {
91 };
92 
93 
95 typedef uint8_t OTF2_LocationGroupType;
96 
103 {
110 };
111 
112 
114 typedef uint8_t OTF2_LocationType;
115 
122 {
135 };
136 
137 
139 typedef uint8_t OTF2_RegionRole;
140 
147 {
283 };
284 
285 
287 typedef uint32_t OTF2_RegionFlag;
288 
295 {
307 };
308 
309 
311 typedef uint8_t OTF2_GroupType;
312 
319 {
362 };
363 
364 
366 typedef uint32_t OTF2_GroupFlag;
367 
374 {
384 };
385 
386 
388 typedef uint8_t OTF2_Base;
389 
396 {
403 };
404 
405 
407 typedef uint8_t OTF2_MetricOccurrence;
408 
415 {
427 };
428 
429 
431 typedef uint8_t OTF2_MetricType;
432 
439 {
452 };
453 
454 
456 typedef uint8_t OTF2_MetricValueProperty;
457 
465 {
476 
481 };
482 
483 
485 typedef uint8_t OTF2_MetricTiming;
486 
495 {
512 
517 };
518 
519 
521 typedef uint8_t OTF2_MetricMode;
522 
529 {
560 };
561 
562 
564 typedef uint8_t OTF2_MetricScope;
565 
572 {
585 };
586 
587 
589 typedef uint8_t OTF2_RecorderKind;
590 
597 {
613 };
614 
615 
617 typedef uint8_t OTF2_ParameterType;
618 
625 {
635 };
636 
637 
639 typedef uint8_t OTF2_CartPeriodicity;
640 
647 {
654 };
655 
656 
659 
666 {
673 };
674 
675 
677 typedef uint8_t OTF2_IoParadigmClass;
678 
685 {
701 };
702 
703 
705 typedef uint32_t OTF2_IoParadigmFlag;
706 
713 {
721 };
722 
723 
725 typedef uint8_t OTF2_IoParadigmProperty;
726 
733 {
739 };
740 
741 
743 typedef uint32_t OTF2_IoHandleFlag;
744 
752 {
780 };
781 
782 
784 typedef uint8_t OTF2_IoAccessMode;
785 
793 {
825 };
826 
827 
829 typedef uint32_t OTF2_IoStatusFlag;
830 
839 {
902 };
903 
904 
905 #ifdef __cplusplus
906 }
907 #endif /* __cplusplus */
908 
909 
910 #endif /* OTF2_DEFINITIONS_H */
Collective 1:N communication operation.
Definition: OTF2_Definitions.h:219
uint32_t OTF2_GroupFlag
Wrapper for enum OTF2_GroupFlag_enum.
Definition: OTF2_Definitions.h:366
Accumulated metric, 'START' timing.
Definition: OTF2_Definitions.h:532
Metric occurs only at a region enter and leave, but does not need to occur at every enter/leave...
Definition: OTF2_Definitions.h:422
Scope of a metric is a generic group of locations.
Definition: OTF2_Definitions.h:584
uint8_t OTF2_ParameterType
Wrapper for enum OTF2_ParameterType_enum.
Definition: OTF2_Definitions.h:617
Explicit barrier.
Definition: OTF2_Definitions.h:195
E.g. OpenMP "flush" construct.
Definition: OTF2_Definitions.h:201
OTF2_CartPeriodicity_enum
Periodicity types of a cartesian topology dimension.
Definition: OTF2_Definitions.h:646
Each time this region is entered it will get an individual call path in the profile.
Definition: OTF2_Definitions.h:302
Cache. Can be L1i, L1d, L2, L3, ...
Definition: OTF2_Definitions.h:83
Scope of a metric is a location group.
Definition: OTF2_Definitions.h:578
uint8_t OTF2_MetricValueProperty
Wrapper for enum OTF2_MetricValueProperty_enum.
Definition: OTF2_Definitions.h:456
Enable signal-driven I/O.
Definition: OTF2_Definitions.h:870
A function which waits for the completion of one thread.
Definition: OTF2_Definitions.h:255
OTF2_Base_enum
Metric base types.
Definition: OTF2_Definitions.h:395
uint8_t OTF2_MetricMode
Wrapper for enum OTF2_MetricMode_enum.
Definition: OTF2_Definitions.h:521
OTF2_RecorderKind_enum
List of possible kinds a MetricClass can be recorded by.
Definition: OTF2_Definitions.h:596
E.g. OpenMP "ordered" construct (structured block)
Definition: OTF2_Definitions.h:207
This mask can be used to get lower half-byte in OTF2_MetricMode that is used to indicate metric value...
Definition: OTF2_Definitions.h:480
Relative metric, 'LAST' timing.
Definition: OTF2_Definitions.h:556
This mask can be used to get the upper half-byte in OTF2_MetricMode that is used to indicate metric t...
Definition: OTF2_Definitions.h:516
Parallel.
Definition: OTF2_Definitions.h:700
Write operations on the file will complete according to the requirements of synchronized I/O data int...
Definition: OTF2_Definitions.h:883
uint8_t OTF2_Base
Wrapper for enum OTF2_Base_enum.
Definition: OTF2_Definitions.h:388
Scope of a metric is another location.
Definition: OTF2_Definitions.h:575
Metric value is valid from now until the next counter sample, i.e. the future right ahead...
Definition: OTF2_Definitions.h:511
Read-write access.
Definition: OTF2_Definitions.h:814
Relative metric, 'NEXT' timing.
Definition: OTF2_Definitions.h:559
Denotes that the interrupts generated are count based.
Definition: OTF2_Definitions.h:672
OTF2_IoStatusFlag_enum
Special characteristics associated to an IoHandle at the time the handle was created with the IoCreat...
Definition: OTF2_Definitions.h:838
OTF2_MetricValueProperty_enum
Information about whether the metric value is accumulated, absolute, or relative. Used for the lower ...
Definition: OTF2_Definitions.h:464
uint8_t OTF2_RecorderKind
Wrapper for enum OTF2_RecorderKind_enum.
Definition: OTF2_Definitions.h:589
"untied task" construct (structured block)
Definition: OTF2_Definitions.h:260
Parameter is of type signed 8-byte integer.
Definition: OTF2_Definitions.h:631
Metric value is related to the time interval since the last counter sample of the same metric...
Definition: OTF2_Definitions.h:507
OTF2_MetricOccurrence_enum
Metric occurrence.
Definition: OTF2_Definitions.h:414
Collective N:1 communication operation.
Definition: OTF2_Definitions.h:222
uint8_t OTF2_RegionRole
Wrapper for enum OTF2_RegionRole_enum.
Definition: OTF2_Definitions.h:139
Group of regions.
Definition: OTF2_Definitions.h:328
Search only.
Definition: OTF2_Definitions.h:824
An entire function/subroutine.
Definition: OTF2_Definitions.h:153
Individual "section" inside an OpenMP "sections" construct.
Definition: OTF2_Definitions.h:171
A function which deallocates memory.
Definition: OTF2_Definitions.h:270
OTF2_GroupType_enum
List of available group types.
Definition: OTF2_Definitions.h:318
uint32_t OTF2_IoHandleFlag
Wrapper for enum OTF2_IoHandleFlag_enum.
Definition: OTF2_Definitions.h:743
Group of metrics.
Definition: OTF2_Definitions.h:331
Enable close-on-exec flag.
Definition: OTF2_Definitions.h:851
E.g. OpenMP "single" construct.
Definition: OTF2_Definitions.h:177
Dimension is periodic.
Definition: OTF2_Definitions.h:653
E.g. OpenMP "critical" construct.
Definition: OTF2_Definitions.h:186
uint32_t OTF2_IoStatusFlag
Wrapper for enum OTF2_IoStatusFlag_enum.
Definition: OTF2_Definitions.h:829
Execute only.
Definition: OTF2_Definitions.h:819
Read-only access.
Definition: OTF2_Definitions.h:800
Absolute metric (i.e., temperature, rate, mean value, etc.).
Definition: OTF2_Definitions.h:472
Scope of a metric is a system tree node.
Definition: OTF2_Definitions.h:581
Each time this region is entered it will get an individual root node in the profile.
Definition: OTF2_Definitions.h:306
This header file provides general definitions which should be accessible in all internal and external...
All nodes below a node with this attribute encompass a tightly coupled HPC system.
Definition: OTF2_Definitions.h:68
A location group of unknown type.
Definition: OTF2_Definitions.h:106
Decimal base.
Definition: OTF2_Definitions.h:402
Version of the implementation. Optional for all I/O paradigms.
Definition: OTF2_Definitions.h:738
A function which changes a previous memory allocation to either increase or decrease the amount...
Definition: OTF2_Definitions.h:276
Metric can occur at any place i.e. it is not related to region enter and leaves.
Definition: OTF2_Definitions.h:426
This I/O handle is a proxy to a group of I/O paradigm specific handles. The referenced IoFile definit...
Definition: OTF2_Definitions.h:779
OTF2_IoParadigmClass_enum
List of I/O paradigm classes.
Definition: OTF2_Definitions.h:684
Any metric of a type not explicitly listed below.
Definition: OTF2_Definitions.h:442
Write-only access.
Definition: OTF2_Definitions.h:807
A remote memory access communication operation.
Definition: OTF2_Definitions.h:237
uint8_t OTF2_MetricType
Wrapper for enum OTF2_MetricType_enum.
Definition: OTF2_Definitions.h:431
A region of unknown role.
Definition: OTF2_Definitions.h:150
E.g. OpenMP "single" construct (structured block)
Definition: OTF2_Definitions.h:180
Special group type to efficiently handle self-like communicators (i.e., MPI_COMM_SELF and friends)...
Definition: OTF2_Definitions.h:361
No flags set.
Definition: OTF2_Definitions.h:755
Write operations on the file will complete according to the requirements of synchronized I/O file int...
Definition: OTF2_Definitions.h:877
OTF2_LocationType_enum
List of possible definitions of type Location.
Definition: OTF2_Definitions.h:121
A data transfer operation in memory.
Definition: OTF2_Definitions.h:240
Accumulated metric is monotonously increasing (i.e., PAPI counter for number of executed floating poi...
Definition: OTF2_Definitions.h:469
Absolute metric, 'LAST' timing.
Definition: OTF2_Definitions.h:547
"task" construct (creation)
Definition: OTF2_Definitions.h:213
Dimension is not periodic.
Definition: OTF2_Definitions.h:650
E.g. OpenMP "critical" construct (structured block)
Definition: OTF2_Definitions.h:189
E.g. OpenMP "master" construct.
Definition: OTF2_Definitions.h:183
A numa domain. A set of processors around memory which the processors can directly access...
Definition: OTF2_Definitions.h:76
OTF2_ParameterType_enum
List of possible for definitions of type Parameter.
Definition: OTF2_Definitions.h:624
An arbitrary section of code.
Definition: OTF2_Definitions.h:162
uint8_t OTF2_InterruptGeneratorMode
Wrapper for enum OTF2_InterruptGeneratorMode_enum.
Definition: OTF2_Definitions.h:658
Metric value belongs to the time interval since the beginning of the measurement. ...
Definition: OTF2_Definitions.h:499
A location of unknown type.
Definition: OTF2_Definitions.h:125
I/O operations (including the creation) will fail if they would block the issuing process...
Definition: OTF2_Definitions.h:865
Core. A computation unit (may be shared by several logical processors).
Definition: OTF2_Definitions.h:87
uint8_t OTF2_LocationType
Wrapper for enum OTF2_LocationType_enum.
Definition: OTF2_Definitions.h:114
uint8_t OTF2_MetricOccurrence
Wrapper for enum OTF2_MetricOccurrence_enum.
Definition: OTF2_Definitions.h:407
uint8_t OTF2_LocationGroupType
Wrapper for enum OTF2_LocationGroupType_enum.
Definition: OTF2_Definitions.h:95
E.g. OpenMP "ordered" construct.
Definition: OTF2_Definitions.h:204
OTF2_MetricScope_enum
List of available metric scopes.
Definition: OTF2_Definitions.h:571
A point-to-point communication function.
Definition: OTF2_Definitions.h:234
OTF2_MetricMode_enum
Metric mode is a combination of value property and timing information.
Definition: OTF2_Definitions.h:528
uint8_t OTF2_IoParadigmClass
Wrapper for enum OTF2_IoParadigmClass_enum.
Definition: OTF2_Definitions.h:677
Accumulated metric, 'POINT' timing.
Definition: OTF2_Definitions.h:535
OTF2_GroupFlag_enum
List of possible flags to specify special characteristics of a Group.
Definition: OTF2_Definitions.h:373
No flag is set.
Definition: OTF2_Definitions.h:842
OTF2_MetricType_enum
List of available metric types.
Definition: OTF2_Definitions.h:438
A CPU thread.
Definition: OTF2_Definitions.h:128
OTF2_IoParadigmFlag_enum
List of I/O paradigm flags.
Definition: OTF2_Definitions.h:712
Collective M:N communication operation.
Definition: OTF2_Definitions.h:228
OTF2_MetricTiming_enum
Determines when the values have been collected or for which interval of time they are valid...
Definition: OTF2_Definitions.h:494
Parameter is of type string.
Definition: OTF2_Definitions.h:628
This I/O paradigm denotes an interface to the operating system. Thus, no further I/O paradigms below ...
Definition: OTF2_Definitions.h:720
A metadata-only file I/O operation (e.g., IoSeek, IoChangeStatusFlags event).
Definition: OTF2_Definitions.h:282
uint8_t OTF2_GroupType
Wrapper for enum OTF2_GroupType_enum.
Definition: OTF2_Definitions.h:311
Accumulated metric, 'LAST' timing.
Definition: OTF2_Definitions.h:538
Read access to a file won't update its last access time.
Definition: OTF2_Definitions.h:893
OTF2_IoParadigmProperty_enum
List of I/O paradigm properties.
Definition: OTF2_Definitions.h:732
A metric only location e.g. an external device.
Definition: OTF2_Definitions.h:134
Socket, physical package, or chip. In the physical meaning, i.e. that you can add or remove physicall...
Definition: OTF2_Definitions.h:80
This metric class will only be recorded by locations of type OTF2_LOCATION_TYPE_GPU.
Definition: OTF2_Definitions.h:612
A group without special characterization.
Definition: OTF2_Definitions.h:377
E.g. OpenMP "workshare" construct.
Definition: OTF2_Definitions.h:174
"task" construct (structured block)
Definition: OTF2_Definitions.h:210
uint8_t OTF2_MetricScope
Wrapper for enum OTF2_MetricScope_enum.
Definition: OTF2_Definitions.h:564
OTF2_IoAccessMode_enum
Determines how the resulting I/O handle can be accessed with subsequent I/O operations.
Definition: OTF2_Definitions.h:792
Delete the file when closing the IoHandle.
Definition: OTF2_Definitions.h:901
OTF2_InterruptGeneratorMode_enum
List of possible modes of InterruptGenerator.
Definition: OTF2_Definitions.h:665
Metric value is only valid at a point in time but not necessarily for any interval of time...
Definition: OTF2_Definitions.h:503
Parameter is of type unsigned 8-byte integer.
Definition: OTF2_Definitions.h:634
No specific kind of recorder.
Definition: OTF2_Definitions.h:600
Processing Unit (A non-shared ALU, FPU, ...)
Definition: OTF2_Definitions.h:90
An API function wrapped by Score-P.
Definition: OTF2_Definitions.h:156
A GPU location.
Definition: OTF2_Definitions.h:131
Group of unknown type.
Definition: OTF2_Definitions.h:322
Serial.
Definition: OTF2_Definitions.h:693
uint32_t OTF2_IoParadigmFlag
Wrapper for enum OTF2_IoParadigmFlag_enum.
Definition: OTF2_Definitions.h:705
All nodes below a node with this attribute encompass a system where processes can communicate via har...
Definition: OTF2_Definitions.h:72
uint8_t OTF2_CartPeriodicity
Wrapper for enum OTF2_CartPeriodicity_enum.
Definition: OTF2_Definitions.h:639
A loop in the code.
Definition: OTF2_Definitions.h:159
An artificial region, mostly used by the monitor software.
Definition: OTF2_Definitions.h:245
This metric class will only be recorded by locations of type OTF2_LOCATION_TYPE_CPU_THREAD.
Definition: OTF2_Definitions.h:608
Group of locations.
Definition: OTF2_Definitions.h:325
List of locations which participated in the paradigm specified by the group definition.
Definition: OTF2_Definitions.h:350
Binary base.
Definition: OTF2_Definitions.h:399
The metric class will only be recorded via a MetricInstance definitions.
Definition: OTF2_Definitions.h:604
Implicit barrier.
Definition: OTF2_Definitions.h:198
E.g. OpenMP "atomic" construct.
Definition: OTF2_Definitions.h:192
uint32_t OTF2_RegionFlag
Wrapper for enum OTF2_RegionFlag_enum.
Definition: OTF2_Definitions.h:287
Relative metric, 'POINT' timing.
Definition: OTF2_Definitions.h:553
A function which creates one thread.
Definition: OTF2_Definitions.h:250
Absolute metric, 'POINT' timing.
Definition: OTF2_Definitions.h:544
Denotes that the interrupts generated are time based.
Definition: OTF2_Definitions.h:669
A sub-group of the corresponding group definition with type OTF2_GROUP_TYPE_COMM_LOCATIONS and the sa...
Definition: OTF2_Definitions.h:356
"taskwait" construct
Definition: OTF2_Definitions.h:216
OTF2_LocationGroupType_enum
List of possible definitions of type LocationGroup.
Definition: OTF2_Definitions.h:102
Accumulated metric, 'NEXT' timing.
Definition: OTF2_Definitions.h:541
No translation of ranks in event records needs to be done when a group of type OTF2_GROUP_TYPE_COMM_G...
Definition: OTF2_Definitions.h:383
Absolute metric, 'NEXT' timing.
Definition: OTF2_Definitions.h:550
OTF2_RegionRole_enum
List of possible roles of a Region.
Definition: OTF2_Definitions.h:146
OTF2_RegionFlag_enum
List of possible flags to specify special characteristics of a Region.
Definition: OTF2_Definitions.h:294
OTF2_IoHandleFlag_enum
List of possible flags to specify special characteristics of an IoHandle definition.
Definition: OTF2_Definitions.h:751
uint8_t OTF2_IoAccessMode
Wrapper for enum OTF2_IoAccessMode_enum.
Definition: OTF2_Definitions.h:784
OTF2_SystemTreeDomain_enum
List of available system tree node domains.
Definition: OTF2_Definitions.h:63
Instruct I/O operations to reduce caching effects.
Definition: OTF2_Definitions.h:888
Collective N:N communication operation.
Definition: OTF2_Definitions.h:225
Relative metric.
Definition: OTF2_Definitions.h:475
This I/O handle was already created by the system. No IoCreateHandle event occurs with the handle to ...
Definition: OTF2_Definitions.h:765
Error codes and error handling.
E.g. OpenMP "sections" construct.
Definition: OTF2_Definitions.h:168
A data file I/O operation.
Definition: OTF2_Definitions.h:231
uint8_t OTF2_IoParadigmProperty
Wrapper for enum OTF2_IoParadigmProperty_enum.
Definition: OTF2_Definitions.h:725
E.g. OpenMP "parallel" construct (structured block)
Definition: OTF2_Definitions.h:165
Resource usage counter.
Definition: OTF2_Definitions.h:448
uint8_t OTF2_MetricTiming
Wrapper for enum OTF2_MetricTiming_enum.
Definition: OTF2_Definitions.h:485
I/O write operations are automatically performed at the end of the file.
Definition: OTF2_Definitions.h:859
A region without special characterization.
Definition: OTF2_Definitions.h:298
No flags set.
Definition: OTF2_Definitions.h:716
PAPI counter.
Definition: OTF2_Definitions.h:445
Metric occurs at every region enter and leave.
Definition: OTF2_Definitions.h:418
A process.
Definition: OTF2_Definitions.h:109
User metrics.
Definition: OTF2_Definitions.h:451
uint8_t OTF2_SystemTreeDomain
Wrapper for enum OTF2_SystemTreeDomain_enum.
Definition: OTF2_Definitions.h:56
A function which allocates memory.
Definition: OTF2_Definitions.h:265