111
|
1 /* The libgomp plugin API.
|
|
2
|
145
|
3 Copyright (C) 2014-2020 Free Software Foundation, Inc.
|
111
|
4
|
|
5 Contributed by Mentor Embedded.
|
|
6
|
|
7 This file is part of the GNU Offloading and Multi Processing Library
|
|
8 (libgomp).
|
|
9
|
|
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.
|
|
14
|
|
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.
|
|
19
|
|
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.
|
|
23
|
|
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/>. */
|
|
28
|
|
29 #ifndef LIBGOMP_PLUGIN_H
|
|
30 #define LIBGOMP_PLUGIN_H 1
|
|
31
|
|
32 #include <stdbool.h>
|
|
33 #include <stddef.h>
|
|
34 #include <stdint.h>
|
|
35
|
|
36 #ifdef __cplusplus
|
|
37 extern "C" {
|
|
38 #endif
|
|
39
|
|
40 /* Capabilities of offloading devices. */
|
|
41 #define GOMP_OFFLOAD_CAP_SHARED_MEM (1 << 0)
|
|
42 #define GOMP_OFFLOAD_CAP_NATIVE_EXEC (1 << 1)
|
|
43 #define GOMP_OFFLOAD_CAP_OPENMP_400 (1 << 2)
|
|
44 #define GOMP_OFFLOAD_CAP_OPENACC_200 (1 << 3)
|
|
45
|
|
46 /* Type of offload target device. Keep in sync with include/gomp-constants.h. */
|
|
47 enum offload_target_type
|
|
48 {
|
|
49 OFFLOAD_TARGET_TYPE_HOST = 2,
|
|
50 /* OFFLOAD_TARGET_TYPE_HOST_NONSHM = 3 removed. */
|
|
51 OFFLOAD_TARGET_TYPE_NVIDIA_PTX = 5,
|
|
52 OFFLOAD_TARGET_TYPE_INTEL_MIC = 6,
|
145
|
53 OFFLOAD_TARGET_TYPE_HSA = 7,
|
|
54 OFFLOAD_TARGET_TYPE_GCN = 8
|
|
55 };
|
|
56
|
|
57 /* Opaque type to represent plugin-dependent implementation of an
|
|
58 OpenACC asynchronous queue. */
|
|
59 struct goacc_asyncqueue;
|
|
60
|
|
61 /* Used to keep a list of active asynchronous queues. */
|
|
62 struct goacc_asyncqueue_list
|
|
63 {
|
|
64 struct goacc_asyncqueue *aq;
|
|
65 struct goacc_asyncqueue_list *next;
|
111
|
66 };
|
|
67
|
145
|
68 typedef struct goacc_asyncqueue *goacc_aq;
|
|
69 typedef struct goacc_asyncqueue_list *goacc_aq_list;
|
|
70
|
|
71
|
|
72 /* OpenACC 'acc_get_property' support. */
|
|
73
|
|
74 /* Device property values. Keep in sync with
|
|
75 'libgomp/{openacc.h,openacc.f90}:acc_device_property_t'. */
|
|
76 enum goacc_property
|
|
77 {
|
|
78 /* Mask to tell numeric and string values apart. */
|
|
79 #define GOACC_PROPERTY_STRING_MASK 0x10000
|
|
80
|
|
81 /* Start from 1 to catch uninitialized use. */
|
|
82 GOACC_PROPERTY_MEMORY = 1,
|
|
83 GOACC_PROPERTY_FREE_MEMORY = 2,
|
|
84 GOACC_PROPERTY_NAME = GOACC_PROPERTY_STRING_MASK | 1,
|
|
85 GOACC_PROPERTY_VENDOR = GOACC_PROPERTY_STRING_MASK | 2,
|
|
86 GOACC_PROPERTY_DRIVER = GOACC_PROPERTY_STRING_MASK | 3
|
|
87 };
|
|
88
|
|
89 /* Container type for passing device properties. */
|
|
90 union goacc_property_value
|
|
91 {
|
|
92 const char *ptr;
|
|
93 size_t val;
|
|
94 };
|
|
95
|
|
96
|
111
|
97 /* Auxiliary struct, used for transferring pairs of addresses from plugin
|
|
98 to libgomp. */
|
|
99 struct addr_pair
|
|
100 {
|
|
101 uintptr_t start;
|
|
102 uintptr_t end;
|
|
103 };
|
|
104
|
|
105 /* Miscellaneous functions. */
|
|
106 extern void *GOMP_PLUGIN_malloc (size_t) __attribute__ ((malloc));
|
|
107 extern void *GOMP_PLUGIN_malloc_cleared (size_t) __attribute__ ((malloc));
|
|
108 extern void *GOMP_PLUGIN_realloc (void *, size_t);
|
|
109 void GOMP_PLUGIN_target_task_completion (void *);
|
|
110
|
|
111 extern void GOMP_PLUGIN_debug (int, const char *, ...)
|
|
112 __attribute__ ((format (printf, 2, 3)));
|
|
113 extern void GOMP_PLUGIN_error (const char *, ...)
|
|
114 __attribute__ ((format (printf, 1, 2)));
|
|
115 extern void GOMP_PLUGIN_fatal (const char *, ...)
|
|
116 __attribute__ ((noreturn, format (printf, 1, 2)));
|
|
117
|
|
118 /* Prototypes for functions implemented by libgomp plugins. */
|
|
119 extern const char *GOMP_OFFLOAD_get_name (void);
|
|
120 extern unsigned int GOMP_OFFLOAD_get_caps (void);
|
|
121 extern int GOMP_OFFLOAD_get_type (void);
|
|
122 extern int GOMP_OFFLOAD_get_num_devices (void);
|
|
123 extern bool GOMP_OFFLOAD_init_device (int);
|
|
124 extern bool GOMP_OFFLOAD_fini_device (int);
|
|
125 extern unsigned GOMP_OFFLOAD_version (void);
|
|
126 extern int GOMP_OFFLOAD_load_image (int, unsigned, const void *,
|
|
127 struct addr_pair **);
|
|
128 extern bool GOMP_OFFLOAD_unload_image (int, unsigned, const void *);
|
|
129 extern void *GOMP_OFFLOAD_alloc (int, size_t);
|
|
130 extern bool GOMP_OFFLOAD_free (int, void *);
|
|
131 extern bool GOMP_OFFLOAD_dev2host (int, void *, const void *, size_t);
|
|
132 extern bool GOMP_OFFLOAD_host2dev (int, void *, const void *, size_t);
|
|
133 extern bool GOMP_OFFLOAD_dev2dev (int, void *, const void *, size_t);
|
|
134 extern bool GOMP_OFFLOAD_can_run (void *);
|
|
135 extern void GOMP_OFFLOAD_run (int, void *, void *, void **);
|
|
136 extern void GOMP_OFFLOAD_async_run (int, void *, void *, void **, void *);
|
145
|
137
|
111
|
138 extern void GOMP_OFFLOAD_openacc_exec (void (*) (void *), size_t, void **,
|
145
|
139 void **, unsigned *, void *);
|
111
|
140 extern void *GOMP_OFFLOAD_openacc_create_thread_data (int);
|
|
141 extern void GOMP_OFFLOAD_openacc_destroy_thread_data (void *);
|
145
|
142 extern struct goacc_asyncqueue *GOMP_OFFLOAD_openacc_async_construct (int);
|
|
143 extern bool GOMP_OFFLOAD_openacc_async_destruct (struct goacc_asyncqueue *);
|
|
144 extern int GOMP_OFFLOAD_openacc_async_test (struct goacc_asyncqueue *);
|
|
145 extern bool GOMP_OFFLOAD_openacc_async_synchronize (struct goacc_asyncqueue *);
|
|
146 extern bool GOMP_OFFLOAD_openacc_async_serialize (struct goacc_asyncqueue *,
|
|
147 struct goacc_asyncqueue *);
|
|
148 extern void GOMP_OFFLOAD_openacc_async_queue_callback (struct goacc_asyncqueue *,
|
|
149 void (*)(void *), void *);
|
|
150 extern void GOMP_OFFLOAD_openacc_async_exec (void (*) (void *), size_t, void **,
|
|
151 void **, unsigned *, void *,
|
|
152 struct goacc_asyncqueue *);
|
|
153 extern bool GOMP_OFFLOAD_openacc_async_dev2host (int, void *, const void *, size_t,
|
|
154 struct goacc_asyncqueue *);
|
|
155 extern bool GOMP_OFFLOAD_openacc_async_host2dev (int, void *, const void *, size_t,
|
|
156 struct goacc_asyncqueue *);
|
111
|
157 extern void *GOMP_OFFLOAD_openacc_cuda_get_current_device (void);
|
|
158 extern void *GOMP_OFFLOAD_openacc_cuda_get_current_context (void);
|
145
|
159 extern void *GOMP_OFFLOAD_openacc_cuda_get_stream (struct goacc_asyncqueue *);
|
|
160 extern int GOMP_OFFLOAD_openacc_cuda_set_stream (struct goacc_asyncqueue *,
|
|
161 void *);
|
|
162 extern union goacc_property_value
|
|
163 GOMP_OFFLOAD_openacc_get_property (int, enum goacc_property);
|
111
|
164
|
|
165 #ifdef __cplusplus
|
|
166 }
|
|
167 #endif
|
|
168
|
|
169 #endif
|