File tree Expand file tree Collapse file tree 1 file changed +15
-1
lines changed
libsyclinterface/include/syclinterface/Support Expand file tree Collapse file tree 1 file changed +15
-1
lines changed Original file line number Diff line number Diff line change 28
28
29
29
#pragma once
30
30
31
+ /* *
32
+ * @defgroup MemorySemantics Self-documenting memory ownership semantics tokens
33
+ */
34
+
31
35
/* *
32
36
* @def __dpctl_give
33
37
* @brief The __dpctl_give attribute indicates that a new object is returned and
38
42
* free the object, he/she should make sure to use it exactly once as a value
39
43
* for a __dpctl_take argument. However, the user is free to use the object as
40
44
* he/she likes as a value to __dpctl_keep arguments.
45
+ *
46
+ * @ingroup MemorySemantics
41
47
*/
42
48
#ifndef __dpctl_give
43
49
#define __dpctl_give
44
50
#endif
51
+
45
52
/* !
46
53
* @def __dpctl_take
47
54
* @brief The __dpctl_take attribute indicates that the function "takes" over
53
60
* function. If the pointer annotated with __dpctl_take is NULL then it is
54
61
* treated as an error, since it may prevent the normal behavior of the
55
62
* function.
63
+ *
64
+ * @ingroup MemorySemantics
56
65
*/
57
66
#ifndef __dpctl_take
58
67
#define __dpctl_take
59
68
#endif
60
- # ifndef __dpctl_keep
69
+
61
70
/* !
62
71
* @def __dpctl_keep
63
72
* @brief The __dpctl_keep attribute indicates that the function only uses the
64
73
* object and does not destroy it before returning.
74
+ *
75
+ * @ingroup MemorySemantics
65
76
*/
77
+ #ifndef __dpctl_keep
66
78
#define __dpctl_keep
67
79
#endif
80
+
68
81
/* !
69
82
* @def __dpctl_null
70
83
* @brief The __dpctl_null attribute indicates that a NULL value is returned.
84
+ * @ingroup MemorySemantics
71
85
*/
72
86
#ifndef __dpctl_null
73
87
#define __dpctl_null
You can’t perform that action at this time.
0 commit comments