File: PAPI_enum_cmp_event.3

package info (click to toggle)
papi 6.0.0~dfsg-2
  • links: PTS, VCS
  • area: main
  • in suites: bullseye
  • size: 11,056 kB
  • sloc: ansic: 103,847; fortran: 3,015; xml: 2,460; cpp: 1,845; f90: 1,360; makefile: 977; sh: 591; python: 274
file content (173 lines) | stat: -rw-r--r-- 4,311 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
.TH "PAPI_enum_cmp_event" 3 "Thu Feb 27 2020" "Version 6.0.0.0" "PAPI" \" -*- nroff -*-
.ad l
.nh
.SH NAME
PAPI_enum_cmp_event \- 
.PP
Enumerate PAPI preset or native events for a given component\&.  

.SH SYNOPSIS
.br
.PP
.SH "Detailed Description"
.PP 

.PP
.nf
@par C Interface:
\#include <papi.h> @n
int PAPI_enum_cmp_event( int *EventCode, int  modifier, int cidx );

Given an event code, PAPI_enum_event replaces the event 
code with the next available event.

The modifier argument affects which events are returned. 
For all platforms and event types, a value of PAPI_ENUM_ALL (zero) 
directs the function to return all possible events. @n

For native events, the effect of the modifier argument may be
   different on each platform. 
See the discussion below for platform-specific definitions.

@param *EventCode
    A defined preset or native event such as PAPI_TOT_INS.
@param modifier 
    Modifies the search logic. See below for full list.
    For native events, each platform behaves differently. 
    See platform-specific documentation for details.

   @param cidx
           Specifies the component to search in 

@retval PAPI_ENOEVNT 
    The next requested PAPI preset or native event is not available on 
    the underlying hardware.

@par Examples:

.fi
.PP
 
.PP
.nf
*   // Scan for all supported native events on the first component
*   printf( "Name\t\t\t       Code\t   Description\n" );
*   do {
*       retval = PAPI_get_event_info( i, &info );
*       if ( retval == PAPI_OK ) {
*       printf( "%-30s %#-10x\n%s\n", info\&.symbol, info\&.event_code, info\&.long_descr );
*       }
*   } while ( PAPI_enum_cmp_event( &i, PAPI_ENUM_ALL, 0 ) == PAPI_OK );
*   

.fi
.PP
.PP
\fBGeneric Modifiers\fP
.RS 4
The following values are implemented for preset events 
.PD 0

.IP "\(bu" 2
PAPI_ENUM_EVENTS -- Enumerate all (default) 
.IP "\(bu" 2
PAPI_ENUM_FIRST -- Enumerate first event (preset or native) preset/native chosen based on type of EventCode 
.PP
.RE
.PP
\fBNative Modifiers\fP
.RS 4
The following values are implemented for native events 
.PD 0

.IP "\(bu" 2
PAPI_NTV_ENUM_UMASKS -- Given an event, iterate through possible umasks one at a time 
.IP "\(bu" 2
PAPI_NTV_ENUM_UMASK_COMBOS -- Given an event, iterate through all possible combinations of umasks\&. This is not implemented on libpfm4\&. 
.PP
.RE
.PP
\fBPreset Modifiers\fP
.RS 4
The following values are implemented for preset events 
.PD 0

.IP "\(bu" 2
PAPI_PRESET_ENUM_AVAIL -- enumerate only available presets 
.IP "\(bu" 2
PAPI_PRESET_ENUM_MSC -- Miscellaneous preset events 
.IP "\(bu" 2
PAPI_PRESET_ENUM_INS -- Instruction related preset events 
.IP "\(bu" 2
PAPI_PRESET_ENUM_IDL -- Stalled or Idle preset events 
.IP "\(bu" 2
PAPI_PRESET_ENUM_BR -- Branch related preset events 
.IP "\(bu" 2
PAPI_PRESET_ENUM_CND -- Conditional preset events 
.IP "\(bu" 2
PAPI_PRESET_ENUM_MEM -- Memory related preset events 
.IP "\(bu" 2
PAPI_PRESET_ENUM_CACH -- Cache related preset events 
.IP "\(bu" 2
PAPI_PRESET_ENUM_L1 -- L1 cache related preset events 
.IP "\(bu" 2
PAPI_PRESET_ENUM_L2 -- L2 cache related preset events 
.IP "\(bu" 2
PAPI_PRESET_ENUM_L3 -- L3 cache related preset events 
.IP "\(bu" 2
PAPI_PRESET_ENUM_TLB -- Translation Lookaside Buffer events 
.IP "\(bu" 2
PAPI_PRESET_ENUM_FP -- Floating Point related preset events 
.PP
.RE
.PP
\fBITANIUM Modifiers\fP
.RS 4
The following values are implemented for modifier on Itanium: 
.PD 0

.IP "\(bu" 2
PAPI_NTV_ENUM_IARR - Enumerate IAR (instruction address ranging) events 
.IP "\(bu" 2
PAPI_NTV_ENUM_DARR - Enumerate DAR (data address ranging) events 
.IP "\(bu" 2
PAPI_NTV_ENUM_OPCM - Enumerate OPC (opcode matching) events 
.IP "\(bu" 2
PAPI_NTV_ENUM_IEAR - Enumerate IEAR (instr event address register) events 
.IP "\(bu" 2
PAPI_NTV_ENUM_DEAR - Enumerate DEAR (data event address register) events 
.PP
.RE
.PP
\fBPOWER Modifiers\fP
.RS 4
The following values are implemented for POWER 
.PD 0

.IP "\(bu" 2
PAPI_NTV_ENUM_GROUPS - Enumerate groups to which an event belongs 
.PP
.RE
.PP
\fBSee Also:\fP
.RS 4
PAPI 
.br
 PAPIF 
.br
 \fBPAPI_enum_event\fP 
.br
 \fBPAPI_get_event_info\fP 
.br
 \fBPAPI_event_name_to_code\fP 
.br
 PAPI_preset 
.br
 PAPI_native 
.RE
.PP


.SH "Author"
.PP 
Generated automatically by Doxygen for PAPI from the source code\&.