LLVM OpenMP 20.0.0git
kmp_omp.h
Go to the documentation of this file.
1#if USE_DEBUGGER
2/*
3 * kmp_omp.h -- OpenMP definition for kmp_omp_struct_info_t.
4 * This is for information about runtime library structures.
5 */
6
7//===----------------------------------------------------------------------===//
8//
9// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
10// See https://llvm.org/LICENSE.txt for license information.
11// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
12//
13//===----------------------------------------------------------------------===//
14
15/* THIS FILE SHOULD NOT BE MODIFIED IN IDB INTERFACE LIBRARY CODE
16 It should instead be modified in the OpenMP runtime and copied to the
17 interface library code. This way we can minimize the problems that this is
18 sure to cause having two copies of the same file.
19
20 Files live in libomp and libomp_db/src/include */
21
22/* CHANGE THIS WHEN STRUCTURES BELOW CHANGE
23 Before we release this to a customer, please don't change this value. After
24 it is released and stable, then any new updates to the structures or data
25 structure traversal algorithms need to change this value. */
26#define KMP_OMP_VERSION 9
27
28typedef struct {
29 kmp_int32 offset;
30 kmp_int32 size;
31} offset_and_size_t;
32
33typedef struct {
34 kmp_uint64 addr;
35 kmp_int32 size;
36 kmp_int32 padding;
37} addr_and_size_t;
38
39typedef struct {
40 kmp_uint64 flags; // Flags for future extensions.
41 kmp_uint64
42 file; // Pointer to name of source file where the parallel region is.
43 kmp_uint64 func; // Pointer to name of routine where the parallel region is.
44 kmp_int32 begin; // Beginning of source line range.
45 kmp_int32 end; // End of source line range.
46 kmp_int32 num_threads; // Specified number of threads.
47} kmp_omp_nthr_item_t;
48
49typedef struct {
50 kmp_int32 num; // Number of items in the array.
51 kmp_uint64 array; // Address of array of kmp_omp_num_threads_item_t.
52} kmp_omp_nthr_info_t;
53
54/* This structure is known to the idb interface library */
55typedef struct {
56
57 /* Change this only if you make a fundamental data structure change here */
58 kmp_int32 lib_version;
59
60 /* sanity check. Only should be checked if versions are identical
61 * This is also used for backward compatibility to get the runtime
62 * structure size if it the runtime is older than the interface */
63 kmp_int32 sizeof_this_structure;
64
65 /* OpenMP RTL version info. */
66 addr_and_size_t major;
67 addr_and_size_t minor;
68 addr_and_size_t build;
69 addr_and_size_t openmp_version;
70 addr_and_size_t banner;
71
72 /* Various globals. */
73 addr_and_size_t threads; // Pointer to __kmp_threads.
74 addr_and_size_t roots; // Pointer to __kmp_root.
75 addr_and_size_t capacity; // Pointer to __kmp_threads_capacity.
76#if KMP_USE_MONITOR
77 addr_and_size_t monitor; // Pointer to __kmp_monitor.
78#endif
79#if !KMP_USE_DYNAMIC_LOCK
80 addr_and_size_t lock_table; // Pointer to __kmp_lock_table.
81#endif
82 addr_and_size_t func_microtask;
83 addr_and_size_t func_fork;
84 addr_and_size_t func_fork_teams;
85 addr_and_size_t team_counter;
86 addr_and_size_t task_counter;
87 addr_and_size_t nthr_info;
88 kmp_int32 address_width;
89 kmp_int32 indexed_locks;
90 kmp_int32 last_barrier; // The end in enum barrier_type
91 kmp_int32 deque_size; // TASK_DEQUE_SIZE
92
93 /* thread structure information. */
94 kmp_int32 th_sizeof_struct;
95 offset_and_size_t th_info; // descriptor for thread
96 offset_and_size_t th_team; // team for this thread
97 offset_and_size_t th_root; // root for this thread
98 offset_and_size_t th_serial_team; // serial team under this thread
99 offset_and_size_t th_ident; // location for this thread (if available)
100 offset_and_size_t th_spin_here; // is thread waiting for lock (if available)
101 offset_and_size_t
102 th_next_waiting; // next thread waiting for lock (if available)
103 offset_and_size_t th_task_team; // task team struct
104 offset_and_size_t th_current_task; // innermost task being executed
105 offset_and_size_t
106 th_task_state; // alternating 0/1 for task team identification
107 offset_and_size_t th_bar;
108 offset_and_size_t th_b_worker_arrived; // the worker increases it by 1 when it
109 // arrives to the barrier
110
111 /* teams information */
112 offset_and_size_t th_teams_microtask; // entry address for teams construct
113 offset_and_size_t th_teams_level; // initial level of teams construct
114 offset_and_size_t th_teams_nteams; // number of teams in a league
115 offset_and_size_t
116 th_teams_nth; // number of threads in each team of the league
117
118 /* kmp_desc structure (for info field above) */
119 kmp_int32 ds_sizeof_struct;
120 offset_and_size_t ds_tid; // team thread id
121 offset_and_size_t ds_gtid; // global thread id
122 offset_and_size_t ds_thread; // native thread id
123
124 /* team structure information */
125 kmp_int32 t_sizeof_struct;
126 offset_and_size_t t_master_tid; // tid of primary thread in parent team
127 offset_and_size_t t_ident; // location of parallel region
128 offset_and_size_t t_parent; // parent team
129 offset_and_size_t t_nproc; // # team threads
130 offset_and_size_t t_threads; // array of threads
131 offset_and_size_t t_serialized; // # levels of serialized teams
132 offset_and_size_t t_id; // unique team id
133 offset_and_size_t t_pkfn;
134 offset_and_size_t t_task_team; // task team structure
135 offset_and_size_t t_implicit_task; // taskdata for the thread's implicit task
136 offset_and_size_t t_cancel_request;
137 offset_and_size_t t_bar;
138 offset_and_size_t
139 t_b_master_arrived; // incremented when primary thread reaches barrier
140 offset_and_size_t
141 t_b_team_arrived; // increased by one when all the threads arrived
142
143 /* root structure information */
144 kmp_int32 r_sizeof_struct;
145 offset_and_size_t r_root_team; // team at root
146 offset_and_size_t r_hot_team; // hot team for this root
147 offset_and_size_t r_uber_thread; // root thread
148 offset_and_size_t r_root_id; // unique root id (if available)
149
150 /* ident structure information */
151 kmp_int32 id_sizeof_struct;
152 offset_and_size_t
153 id_psource; /* address of string ";file;func;line1;line2;;". */
154 offset_and_size_t id_flags;
155
156 /* lock structure information */
157 kmp_int32 lk_sizeof_struct;
158 offset_and_size_t lk_initialized;
159 offset_and_size_t lk_location;
160 offset_and_size_t lk_tail_id;
161 offset_and_size_t lk_head_id;
162 offset_and_size_t lk_next_ticket;
163 offset_and_size_t lk_now_serving;
164 offset_and_size_t lk_owner_id;
165 offset_and_size_t lk_depth_locked;
166 offset_and_size_t lk_lock_flags;
167
168#if !KMP_USE_DYNAMIC_LOCK
169 /* lock_table_t */
170 kmp_int32 lt_size_of_struct; /* Size and layout of kmp_lock_table_t. */
171 offset_and_size_t lt_used;
172 offset_and_size_t lt_allocated;
173 offset_and_size_t lt_table;
174#endif
175
176 /* task_team_t */
177 kmp_int32 tt_sizeof_struct;
178 offset_and_size_t tt_threads_data;
179 offset_and_size_t tt_found_tasks;
180 offset_and_size_t tt_nproc;
181 offset_and_size_t tt_unfinished_threads;
182 offset_and_size_t tt_active;
183
184 /* kmp_taskdata_t */
185 kmp_int32 td_sizeof_struct;
186 offset_and_size_t td_task_id; // task id
187 offset_and_size_t td_flags; // task flags
188 offset_and_size_t td_team; // team for this task
189 offset_and_size_t td_parent; // parent task
190 offset_and_size_t td_level; // task testing level
191 offset_and_size_t td_ident; // task identifier
192 offset_and_size_t td_allocated_child_tasks; // child tasks (+ current task)
193 // not yet deallocated
194 offset_and_size_t td_incomplete_child_tasks; // child tasks not yet complete
195
196 /* Taskwait */
197 offset_and_size_t td_taskwait_ident;
198 offset_and_size_t td_taskwait_counter;
199 offset_and_size_t
200 td_taskwait_thread; // gtid + 1 of thread encountered taskwait
201
202 /* Taskgroup */
203 offset_and_size_t td_taskgroup; // pointer to the current taskgroup
204 offset_and_size_t
205 td_task_count; // number of allocated and not yet complete tasks
206 offset_and_size_t td_cancel; // request for cancellation of this taskgroup
207
208 /* Task dependency */
209 offset_and_size_t
210 td_depnode; // pointer to graph node if the task has dependencies
211 offset_and_size_t dn_node;
212 offset_and_size_t dn_next;
213 offset_and_size_t dn_successors;
214 offset_and_size_t dn_task;
215 offset_and_size_t dn_npredecessors;
216 offset_and_size_t dn_nrefs;
217 offset_and_size_t dn_routine;
218
219 /* kmp_thread_data_t */
220 kmp_int32 hd_sizeof_struct;
221 offset_and_size_t hd_deque;
222 offset_and_size_t hd_deque_size;
223 offset_and_size_t hd_deque_head;
224 offset_and_size_t hd_deque_tail;
225 offset_and_size_t hd_deque_ntasks;
226 offset_and_size_t hd_deque_last_stolen;
227
228 // The last field of stable version.
229 kmp_uint64 last_field;
230
231} kmp_omp_struct_info_t;
232
233#endif /* USE_DEBUGGER */
234
235/* end of file */
end
void const char const char int ITT_FORMAT __itt_group_sync x void const char ITT_FORMAT __itt_group_sync s void ITT_FORMAT __itt_group_sync p void ITT_FORMAT p void ITT_FORMAT p no args __itt_suppress_mode_t unsigned int void size_t ITT_FORMAT d void ITT_FORMAT p void ITT_FORMAT p __itt_model_site __itt_model_site_instance ITT_FORMAT p __itt_model_task __itt_model_task_instance ITT_FORMAT p void ITT_FORMAT p void ITT_FORMAT p void size_t ITT_FORMAT d void ITT_FORMAT p const wchar_t ITT_FORMAT s const char ITT_FORMAT s const char ITT_FORMAT s const char ITT_FORMAT s no args void ITT_FORMAT p size_t ITT_FORMAT d no args const wchar_t const wchar_t ITT_FORMAT s __itt_heap_function void size_t int ITT_FORMAT d __itt_heap_function void ITT_FORMAT p __itt_heap_function void void size_t int ITT_FORMAT d no args no args unsigned int ITT_FORMAT u const __itt_domain __itt_id ITT_FORMAT lu const __itt_domain __itt_id __itt_id __itt_string_handle ITT_FORMAT p const __itt_domain __itt_id ITT_FORMAT p const __itt_domain __itt_id __itt_timestamp __itt_timestamp end
Definition: ittnotify_static.h:365
begin
void const char const char int ITT_FORMAT __itt_group_sync x void const char ITT_FORMAT __itt_group_sync s void ITT_FORMAT __itt_group_sync p void ITT_FORMAT p void ITT_FORMAT p no args __itt_suppress_mode_t unsigned int void size_t ITT_FORMAT d void ITT_FORMAT p void ITT_FORMAT p __itt_model_site __itt_model_site_instance ITT_FORMAT p __itt_model_task __itt_model_task_instance ITT_FORMAT p void ITT_FORMAT p void ITT_FORMAT p void size_t ITT_FORMAT d void ITT_FORMAT p const wchar_t ITT_FORMAT s const char ITT_FORMAT s const char ITT_FORMAT s const char ITT_FORMAT s no args void ITT_FORMAT p size_t ITT_FORMAT d no args const wchar_t const wchar_t ITT_FORMAT s __itt_heap_function void size_t int ITT_FORMAT d __itt_heap_function void ITT_FORMAT p __itt_heap_function void void size_t int ITT_FORMAT d no args no args unsigned int ITT_FORMAT u const __itt_domain __itt_id ITT_FORMAT lu const __itt_domain __itt_id __itt_id __itt_string_handle ITT_FORMAT p const __itt_domain __itt_id ITT_FORMAT p const __itt_domain __itt_id __itt_timestamp begin
Definition: ittnotify_static.h:364
addr
void * addr
Definition: ittnotify_static.h:152
size
void const char const char int ITT_FORMAT __itt_group_sync x void const char ITT_FORMAT __itt_group_sync s void ITT_FORMAT __itt_group_sync p void ITT_FORMAT p void ITT_FORMAT p no args __itt_suppress_mode_t unsigned int void size_t size
Definition: ittnotify_static.h:198
kmp_uint64
unsigned long long kmp_uint64
Definition: kmp_detach_tasks_t1.c:12
kmp_int32
int32_t kmp_int32
Definition: omp__kmpc_fork_call_if.c:6
func
void func(int *num_exec)
Definition: omp_record_replay.cpp:21
Generated on Wed Feb 19 2025 16:04:41 for LLVM OpenMP by doxygen 1.9.6