Require target lra in gcc.dg/pr108095.c
[official-gcc.git] / include / gomp-constants.h
blob8d4e8e813031884c9cdf285050db55a24db0e9dc
1 /* Communication between GCC and libgomp.
3 Copyright (C) 2014-2023 Free Software Foundation, Inc.
5 Contributed by Mentor Embedded.
7 This file is part of the GNU Offloading and Multi Processing Library
8 (libgomp).
10 Libgomp is free software; you can redistribute it and/or modify it
11 under the terms of the GNU General Public License as published by
12 the Free Software Foundation; either version 3, or (at your option)
13 any later version.
15 Libgomp is distributed in the hope that it will be useful, but WITHOUT ANY
16 WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
17 FOR A PARTICULAR PURPOSE. See the GNU General Public License for
18 more details.
20 Under Section 7 of GPL version 3, you are granted additional
21 permissions described in the GCC Runtime Library Exception, version
22 3.1, as published by the Free Software Foundation.
24 You should have received a copy of the GNU General Public License and
25 a copy of the GCC Runtime Library Exception along with this program;
26 see the files COPYING3 and COPYING.RUNTIME respectively. If not, see
27 <http://www.gnu.org/licenses/>. */
29 #ifndef GOMP_CONSTANTS_H
30 #define GOMP_CONSTANTS_H 1
32 /* Memory mapping types. */
34 /* One byte. */
35 #define GOMP_MAP_LAST (1 << 8)
37 #define GOMP_MAP_FLAG_TO (1 << 0)
38 #define GOMP_MAP_FLAG_FROM (1 << 1)
39 /* Special map kinds, enumerated starting here. */
40 #define GOMP_MAP_FLAG_SPECIAL_0 (1 << 2)
41 #define GOMP_MAP_FLAG_SPECIAL_1 (1 << 3)
42 #define GOMP_MAP_FLAG_SPECIAL_2 (1 << 4)
43 #define GOMP_MAP_FLAG_SPECIAL_3 (1 << 5)
44 #define GOMP_MAP_FLAG_SPECIAL_4 (1 << 6)
45 #define GOMP_MAP_FLAG_SPECIAL_5 (1 << 7)
46 #define GOMP_MAP_FLAG_SPECIAL (GOMP_MAP_FLAG_SPECIAL_1 \
47 | GOMP_MAP_FLAG_SPECIAL_0)
48 #define GOMP_MAP_DEEP_COPY (GOMP_MAP_FLAG_SPECIAL_4 \
49 | GOMP_MAP_FLAG_SPECIAL_2)
50 /* This value indicates the map was created implicitly according to
51 OpenMP rules. */
52 #define GOMP_MAP_IMPLICIT (GOMP_MAP_FLAG_SPECIAL_3 \
53 | GOMP_MAP_FLAG_SPECIAL_4)
54 /* Mask for entire set of special map kind bits. */
55 #define GOMP_MAP_FLAG_SPECIAL_BITS (GOMP_MAP_FLAG_SPECIAL_0 \
56 | GOMP_MAP_FLAG_SPECIAL_1 \
57 | GOMP_MAP_FLAG_SPECIAL_2 \
58 | GOMP_MAP_FLAG_SPECIAL_3 \
59 | GOMP_MAP_FLAG_SPECIAL_4 \
60 | GOMP_MAP_FLAG_SPECIAL_5)
61 /* Flag to force a specific behavior (or else, trigger a run-time error). */
62 #define GOMP_MAP_FLAG_FORCE (GOMP_MAP_FLAG_SPECIAL_5)
63 #define GOMP_MAP_FLAG_PRESENT (GOMP_MAP_FLAG_SPECIAL_5 \
64 | GOMP_MAP_FLAG_SPECIAL_0)
65 #define GOMP_MAP_FLAG_ALWAYS_PRESENT (GOMP_MAP_FLAG_SPECIAL_2 \
66 | GOMP_MAP_FLAG_PRESENT)
68 enum gomp_map_kind
70 /* If not already present, allocate. */
71 GOMP_MAP_ALLOC = 0,
72 /* ..., and copy to device. */
73 GOMP_MAP_TO = (GOMP_MAP_ALLOC | GOMP_MAP_FLAG_TO),
74 /* ..., and copy from device. */
75 GOMP_MAP_FROM = (GOMP_MAP_ALLOC | GOMP_MAP_FLAG_FROM),
76 /* ..., and copy to and from device. */
77 GOMP_MAP_TOFROM = (GOMP_MAP_TO | GOMP_MAP_FROM),
78 /* The following kind is an internal only map kind, used for pointer based
79 array sections. OMP_CLAUSE_SIZE for these is not the pointer size,
80 which is implicitly POINTER_SIZE_UNITS, but the bias. */
81 GOMP_MAP_POINTER = (GOMP_MAP_FLAG_SPECIAL_0 | 0),
82 /* Also internal, behaves like GOMP_MAP_TO, but additionally any
83 GOMP_MAP_POINTER records consecutive after it which have addresses
84 falling into that range will not be ignored if GOMP_MAP_TO_PSET wasn't
85 mapped already.
86 For OpenACC attach operations (e.g. copyin of struct members),
87 GOMP_MAP_TO_PSET is followed by a single GOMP_MAP_ATTACH mapping
88 instead. */
89 GOMP_MAP_TO_PSET = (GOMP_MAP_FLAG_SPECIAL_0 | 1),
90 /* Must already be present. */
91 GOMP_MAP_FORCE_PRESENT = (GOMP_MAP_FLAG_SPECIAL_0 | 2),
92 /* Deallocate a mapping, without copying from device. */
93 GOMP_MAP_DELETE = (GOMP_MAP_FLAG_SPECIAL_0 | 3),
94 /* Is a device pointer. OMP_CLAUSE_SIZE for these is unused; is implicitly
95 POINTER_SIZE_UNITS. */
96 GOMP_MAP_FORCE_DEVICEPTR = (GOMP_MAP_FLAG_SPECIAL_1 | 0),
97 /* OpenACC device_resident. */
98 GOMP_MAP_DEVICE_RESIDENT = (GOMP_MAP_FLAG_SPECIAL_1 | 1),
99 /* OpenACC link. */
100 GOMP_MAP_LINK = (GOMP_MAP_FLAG_SPECIAL_1 | 2),
101 /* Use device data if present, fall back to host address otherwise. */
102 GOMP_MAP_IF_PRESENT = (GOMP_MAP_FLAG_SPECIAL_1 | 3),
103 /* Do not map, copy bits for firstprivate instead. */
104 GOMP_MAP_FIRSTPRIVATE = (GOMP_MAP_FLAG_SPECIAL | 0),
105 /* Similarly, but store the value in the pointer rather than
106 pointed by the pointer. */
107 GOMP_MAP_FIRSTPRIVATE_INT = (GOMP_MAP_FLAG_SPECIAL | 1),
108 /* Pointer translate host address into device address and copy that
109 back to host. */
110 GOMP_MAP_USE_DEVICE_PTR = (GOMP_MAP_FLAG_SPECIAL | 2),
111 /* Allocate a zero length array section. Prefer next non-zero length
112 mapping over previous non-zero length mapping over zero length mapping
113 at the address. If not already mapped, do nothing (and pointer translate
114 to NULL). */
115 GOMP_MAP_ZERO_LEN_ARRAY_SECTION = (GOMP_MAP_FLAG_SPECIAL | 3),
116 /* Allocate. */
117 GOMP_MAP_FORCE_ALLOC = (GOMP_MAP_FLAG_FORCE | GOMP_MAP_ALLOC),
118 /* ..., and copy to device. */
119 GOMP_MAP_FORCE_TO = (GOMP_MAP_FLAG_FORCE | GOMP_MAP_TO),
120 /* ..., and copy from device. */
121 GOMP_MAP_FORCE_FROM = (GOMP_MAP_FLAG_FORCE | GOMP_MAP_FROM),
122 /* ..., and copy to and from device. */
123 GOMP_MAP_FORCE_TOFROM = (GOMP_MAP_FLAG_FORCE | GOMP_MAP_TOFROM),
124 /* Like GOMP_MAP_USE_DEVICE_PTR above, translate a host to a device
125 address. If translation fails because the target is not mapped,
126 continue using the host address. */
127 GOMP_MAP_USE_DEVICE_PTR_IF_PRESENT = (GOMP_MAP_FLAG_SPECIAL_2 | 0),
128 /* If not already present, allocate. And unconditionally copy to
129 device. */
130 GOMP_MAP_ALWAYS_TO = (GOMP_MAP_FLAG_SPECIAL_2 | GOMP_MAP_TO),
131 /* If not already present, allocate. And unconditionally copy from
132 device. */
133 GOMP_MAP_ALWAYS_FROM = (GOMP_MAP_FLAG_SPECIAL_2
134 | GOMP_MAP_FROM),
135 /* If not already present, allocate. And unconditionally copy to and from
136 device. */
137 GOMP_MAP_ALWAYS_TOFROM = (GOMP_MAP_FLAG_SPECIAL_2
138 | GOMP_MAP_TOFROM),
139 /* Must already be present, unconditionally copy to device. */
140 GOMP_MAP_ALWAYS_PRESENT_TO = (GOMP_MAP_FLAG_ALWAYS_PRESENT
141 | GOMP_MAP_TO),
142 /* Must already be present, unconditionally copy from device. */
143 GOMP_MAP_ALWAYS_PRESENT_FROM = (GOMP_MAP_FLAG_ALWAYS_PRESENT
144 | GOMP_MAP_FROM),
145 /* Must already be present, unconditionally copy to and from device. */
146 GOMP_MAP_ALWAYS_PRESENT_TOFROM = (GOMP_MAP_FLAG_ALWAYS_PRESENT
147 | GOMP_MAP_TOFROM),
148 /* Map a sparse struct; the address is the base of the structure, alignment
149 it's required alignment, and size is the number of adjacent entries
150 that belong to the struct. The adjacent entries should be sorted by
151 increasing address, so it is easy to determine lowest needed address
152 (address of the first adjacent entry) and highest needed address
153 (address of the last adjacent entry plus its size). */
154 GOMP_MAP_STRUCT = (GOMP_MAP_FLAG_SPECIAL_2
155 | GOMP_MAP_FLAG_SPECIAL | 0),
156 /* On a location of a pointer/reference that is assumed to be already mapped
157 earlier, store the translated address of the preceeding mapping.
158 No refcount is bumped by this, and the store is done unconditionally. */
159 GOMP_MAP_ALWAYS_POINTER = (GOMP_MAP_FLAG_SPECIAL_2
160 | GOMP_MAP_FLAG_SPECIAL | 1),
161 /* Like GOMP_MAP_POINTER, but allow zero-length array section, i.e. set to
162 NULL if target is not mapped. */
163 GOMP_MAP_POINTER_TO_ZERO_LENGTH_ARRAY_SECTION
164 = (GOMP_MAP_FLAG_SPECIAL_2
165 | GOMP_MAP_FLAG_SPECIAL | 2),
166 /* Forced deallocation of zero length array section. */
167 GOMP_MAP_DELETE_ZERO_LEN_ARRAY_SECTION
168 = (GOMP_MAP_FLAG_SPECIAL_2
169 | GOMP_MAP_FLAG_SPECIAL | 3),
170 /* Decrement usage count and deallocate if zero. */
171 GOMP_MAP_RELEASE = (GOMP_MAP_FLAG_SPECIAL_2
172 | GOMP_MAP_DELETE),
173 /* The attach/detach mappings below use the OMP_CLAUSE_SIZE field as a
174 bias. This will typically be zero, except when mapping an array slice
175 with a non-zero base. In that case the bias will indicate the
176 (positive) difference between the start of the actual mapped data and
177 the "virtual" origin of the array.
178 In OpenACC, attach a pointer to a mapped struct field. */
179 GOMP_MAP_ATTACH = (GOMP_MAP_DEEP_COPY | 0),
180 /* In OpenACC, detach a pointer to a mapped struct field. */
181 GOMP_MAP_DETACH = (GOMP_MAP_DEEP_COPY | 1),
182 /* In OpenACC, detach a pointer to a mapped struct field. */
183 GOMP_MAP_FORCE_DETACH = (GOMP_MAP_DEEP_COPY
184 | GOMP_MAP_FLAG_FORCE | 1),
186 /* Like GOMP_MAP_ATTACH, but allow attaching to zero-length array sections
187 (i.e. set to NULL when array section is not mapped) Currently only used
188 by OpenMP. */
189 GOMP_MAP_ATTACH_ZERO_LENGTH_ARRAY_SECTION
190 = (GOMP_MAP_DEEP_COPY | 2),
192 /* Internal to GCC, not used in libgomp. */
193 /* Do not map, but pointer assign a pointer instead. */
194 GOMP_MAP_FIRSTPRIVATE_POINTER = (GOMP_MAP_LAST | 1),
195 /* Do not map, but pointer assign a reference instead. */
196 GOMP_MAP_FIRSTPRIVATE_REFERENCE = (GOMP_MAP_LAST | 2),
197 /* An attach or detach operation. Rewritten to the appropriate type during
198 gimplification, depending on directive (i.e. "enter data" or
199 parallel/kernels region vs. "exit data"). */
200 GOMP_MAP_ATTACH_DETACH = (GOMP_MAP_LAST | 3),
201 /* Must already be present - all of following map to GOMP_MAP_FORCE_PRESENT
202 as no data transfer is needed. */
203 GOMP_MAP_PRESENT_ALLOC = (GOMP_MAP_LAST | 4),
204 GOMP_MAP_PRESENT_TO = (GOMP_MAP_LAST | 5),
205 GOMP_MAP_PRESENT_FROM = (GOMP_MAP_LAST | 6),
206 GOMP_MAP_PRESENT_TOFROM = (GOMP_MAP_LAST | 7)
209 #define GOMP_MAP_COPY_TO_P(X) \
210 ((!((X) & GOMP_MAP_FLAG_SPECIAL) || GOMP_MAP_PRESENT_P (X)) \
211 && ((X) & GOMP_MAP_FLAG_TO))
213 #define GOMP_MAP_COPY_FROM_P(X) \
214 ((!((X) & GOMP_MAP_FLAG_SPECIAL) || GOMP_MAP_PRESENT_P (X)) \
215 && ((X) & GOMP_MAP_FLAG_FROM))
217 #define GOMP_MAP_ALWAYS_POINTER_P(X) \
218 ((X) == GOMP_MAP_ALWAYS_POINTER)
220 #define GOMP_MAP_POINTER_P(X) \
221 ((X) == GOMP_MAP_POINTER \
222 || (X) == GOMP_MAP_POINTER_TO_ZERO_LENGTH_ARRAY_SECTION)
224 #define GOMP_MAP_ALWAYS_TO_P(X) \
225 (((X) == GOMP_MAP_ALWAYS_TO) || ((X) == GOMP_MAP_ALWAYS_TOFROM) \
226 || ((X) == GOMP_MAP_ALWAYS_PRESENT_TO) \
227 || ((X) == GOMP_MAP_ALWAYS_PRESENT_TOFROM))
229 #define GOMP_MAP_ALWAYS_FROM_P(X) \
230 (((X) == GOMP_MAP_ALWAYS_FROM) || ((X) == GOMP_MAP_ALWAYS_TOFROM) \
231 || ((X) == GOMP_MAP_ALWAYS_PRESENT_FROM) \
232 || ((X) == GOMP_MAP_ALWAYS_PRESENT_TOFROM))
234 #define GOMP_MAP_ALWAYS_P(X) \
235 (GOMP_MAP_ALWAYS_TO_P (X) || GOMP_MAP_ALWAYS_FROM_P (X))
237 #define GOMP_MAP_IMPLICIT_P(X) \
238 (((X) & GOMP_MAP_FLAG_SPECIAL_BITS) == GOMP_MAP_IMPLICIT)
240 #define GOMP_MAP_FORCE_P(X) \
241 (((X) & GOMP_MAP_FLAG_SPECIAL_BITS) == GOMP_MAP_FLAG_FORCE)
243 #define GOMP_MAP_PRESENT_P(X) \
244 (((X) & GOMP_MAP_FLAG_PRESENT) == GOMP_MAP_FLAG_PRESENT \
245 || (X) == GOMP_MAP_FORCE_PRESENT)
248 /* Asynchronous behavior. Keep in sync with
249 libgomp/{openacc.h,openacc.f90,openacc_lib.h}:acc_async_t. */
251 #define GOMP_ASYNC_NOVAL -1
252 #define GOMP_ASYNC_SYNC -2
255 /* Device codes. Keep in sync with
256 libgomp/{openacc.h,openacc.f90,openacc_lib.h}:acc_device_t as well as
257 libgomp/libgomp-plugin.h. */
258 #define GOMP_DEVICE_NONE 0
259 #define GOMP_DEVICE_DEFAULT 1
260 #define GOMP_DEVICE_HOST 2
261 /* #define GOMP_DEVICE_HOST_NONSHM 3 removed. */
262 #define GOMP_DEVICE_NOT_HOST 4
263 #define GOMP_DEVICE_NVIDIA_PTX 5
264 /* #define GOMP_DEVICE_INTEL_MIC 6 removed. */
265 /* #define GOMP_DEVICE_HSA 7 removed. */
266 #define GOMP_DEVICE_GCN 8
268 /* We have a compatibility issue. OpenMP 5.2 introduced
269 omp_initial_device with value of -1 which clashes with our
270 GOMP_DEVICE_ICV, so we need to remap user supplied device
271 ids, -1 (aka omp_initial_device) to GOMP_DEVICE_HOST_FALLBACK,
272 and -2 (one of many non-conforming device numbers, but with
273 OMP_TARGET_OFFLOAD=mandatory needs to be treated a
274 omp_invalid_device) to -3 (so that for dev_num >= -2U we can
275 subtract 1). -4 is then what we use for omp_invalid_device,
276 which unlike the other non-conforming device numbers results
277 in fatal error regardless of OMP_TARGET_OFFLOAD. */
278 #define GOMP_DEVICE_ICV -1
279 #define GOMP_DEVICE_HOST_FALLBACK -2
280 #define GOMP_DEVICE_INVALID -4
282 /* GOMP_task/GOMP_taskloop* flags argument. */
283 #define GOMP_TASK_FLAG_UNTIED (1 << 0)
284 #define GOMP_TASK_FLAG_FINAL (1 << 1)
285 #define GOMP_TASK_FLAG_MERGEABLE (1 << 2)
286 #define GOMP_TASK_FLAG_DEPEND (1 << 3)
287 #define GOMP_TASK_FLAG_PRIORITY (1 << 4)
288 #define GOMP_TASK_FLAG_UP (1 << 8)
289 #define GOMP_TASK_FLAG_GRAINSIZE (1 << 9)
290 #define GOMP_TASK_FLAG_IF (1 << 10)
291 #define GOMP_TASK_FLAG_NOGROUP (1 << 11)
292 #define GOMP_TASK_FLAG_REDUCTION (1 << 12)
293 #define GOMP_TASK_FLAG_DETACH (1 << 13)
294 #define GOMP_TASK_FLAG_STRICT (1 << 14)
296 /* GOMP_target{_ext,update_ext,enter_exit_data} flags argument. */
297 #define GOMP_TARGET_FLAG_NOWAIT (1 << 0)
298 #define GOMP_TARGET_FLAG_EXIT_DATA (1 << 1)
299 /* Internal to libgomp. */
300 #define GOMP_TARGET_FLAG_UPDATE (1U << 31)
303 /* OpenACC construct flags. */
305 /* Force host fallback execution. */
306 #define GOACC_FLAG_HOST_FALLBACK (1 << 0)
308 /* For legacy reasons, in the ABI, the GOACC_FLAGs are encoded as an inverted
309 bitmask. */
310 #define GOACC_FLAGS_MARSHAL_OP BIT_NOT_EXPR
311 #define GOACC_FLAGS_UNMARSHAL(X) (~(X))
314 /* Versions of libgomp and device-specific plugins. GOMP_VERSION
315 should be incremented whenever an ABI-incompatible change is introduced
316 to the plugin interface defined in libgomp/libgomp.h. */
317 #define GOMP_VERSION 2
318 #define GOMP_VERSION_NVIDIA_PTX 1
319 #define GOMP_VERSION_GCN 3
321 #define GOMP_VERSION_PACK(LIB, DEV) (((LIB) << 16) | (DEV))
322 #define GOMP_VERSION_LIB(PACK) (((PACK) >> 16) & 0xffff)
323 #define GOMP_VERSION_DEV(PACK) ((PACK) & 0xffff)
325 #define GOMP_DIM_GANG 0
326 #define GOMP_DIM_WORKER 1
327 #define GOMP_DIM_VECTOR 2
328 #define GOMP_DIM_MAX 3
329 #define GOMP_DIM_MASK(X) (1u << (X))
331 /* Varadic launch arguments. End of list is marked by a zero. */
332 #define GOMP_LAUNCH_DIM 1 /* Launch dimensions, op = mask */
333 #define GOMP_LAUNCH_ASYNC 2 /* Async, op = cst val if not MAX */
334 #define GOMP_LAUNCH_WAIT 3 /* Waits, op = num waits. */
335 #define GOMP_LAUNCH_CODE_SHIFT 28
336 #define GOMP_LAUNCH_DEVICE_SHIFT 16
337 #define GOMP_LAUNCH_OP_SHIFT 0
338 #define GOMP_LAUNCH_PACK(CODE,DEVICE,OP) \
339 (((CODE) << GOMP_LAUNCH_CODE_SHIFT) \
340 | ((DEVICE) << GOMP_LAUNCH_DEVICE_SHIFT) \
341 | ((OP) << GOMP_LAUNCH_OP_SHIFT))
342 #define GOMP_LAUNCH_CODE(X) (((X) >> GOMP_LAUNCH_CODE_SHIFT) & 0xf)
343 #define GOMP_LAUNCH_DEVICE(X) (((X) >> GOMP_LAUNCH_DEVICE_SHIFT) & 0xfff)
344 #define GOMP_LAUNCH_OP(X) (((X) >> GOMP_LAUNCH_OP_SHIFT) & 0xffff)
345 #define GOMP_LAUNCH_OP_MAX 0xffff
347 /* Bitmask to apply in order to find out the intended device of a target
348 argument. */
349 #define GOMP_TARGET_ARG_DEVICE_MASK ((1 << 7) - 1)
350 /* The target argument is significant for all devices. */
351 #define GOMP_TARGET_ARG_DEVICE_ALL 0
353 /* Flag set when the subsequent element in the device-specific argument
354 values. */
355 #define GOMP_TARGET_ARG_SUBSEQUENT_PARAM (1 << 7)
357 /* Bitmask to apply to a target argument to find out the value identifier. */
358 #define GOMP_TARGET_ARG_ID_MASK (((1 << 8) - 1) << 8)
359 /* Target argument index of NUM_TEAMS. */
360 #define GOMP_TARGET_ARG_NUM_TEAMS (1 << 8)
361 /* Target argument index of THREAD_LIMIT. */
362 #define GOMP_TARGET_ARG_THREAD_LIMIT (2 << 8)
364 /* If the value is directly embeded in target argument, it should be a 16-bit
365 at most and shifted by this many bits. */
366 #define GOMP_TARGET_ARG_VALUE_SHIFT 16
368 /* Dependence types in omp_depend_t objects. */
369 #define GOMP_DEPEND_IN 1
370 #define GOMP_DEPEND_OUT 2
371 #define GOMP_DEPEND_INOUT 3
372 #define GOMP_DEPEND_MUTEXINOUTSET 4
373 #define GOMP_DEPEND_INOUTSET 5
375 /* Flag values for OpenMP 'requires' directive features. */
376 #define GOMP_REQUIRES_UNIFIED_ADDRESS 0x10
377 #define GOMP_REQUIRES_UNIFIED_SHARED_MEMORY 0x20
378 #define GOMP_REQUIRES_REVERSE_OFFLOAD 0x80
379 #define GOMP_REQUIRES_TARGET_USED 0x200
381 /* HSA specific data structures. */
383 /* Identifiers of device-specific target arguments. */
384 #define GOMP_TARGET_ARG_HSA_KERNEL_ATTRIBUTES (1 << 8)
386 #endif