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
|
/* SPDX-License-Identifier: BSD-2-Clause */
/*
* Copyright (c) 2018, Linaro Limited
*/
#ifndef __SCATTERED_ARRAY_H
#define __SCATTERED_ARRAY_H
#include <compiler.h>
#include <keep.h>
/*
* A scattered array is assembled from items declared in different source
* files depending on something like "SORT(.scattered_array*)" in the link
* script to get everything assembled in the right order.
*
* Whenever a new scattered array is created with the macros below there's
* no need to update the link script.
*/
#define __SCT_ARRAY_DEF_ITEM3(element_type, element_name, section_name) \
static const element_type element_name; \
DECLARE_KEEP_INIT(element_name); \
static const element_type element_name __used \
__section(section_name)
#define __SCT_ARRAY_DEF_PG_ITEM3(element_type, element_name, section_name) \
static const element_type element_name __used \
__section(section_name)
#define __SCT_ARRAY_DEF_ITEM2(array_name, order, id, element_type) \
__SCT_ARRAY_DEF_ITEM3(element_type, \
__scattered_array_ ## id ## array_name, \
".scattered_array_" #array_name "_1_" #order)
#define __SCT_ARRAY_DEF_PG_ITEM2(array_name, order, id, element_type) \
__SCT_ARRAY_DEF_PG_ITEM3(element_type, \
__scattered_array_ ## id ## array_name, \
".scattered_array_" #array_name "_1_" #order)
#define __SCT_ARRAY_DEF_ITEM1(array_name, order, id, element_type) \
__SCT_ARRAY_DEF_ITEM2(array_name, order, id, element_type)
#define __SCT_ARRAY_DEF_PG_ITEM1(array_name, order, id, element_type) \
__SCT_ARRAY_DEF_PG_ITEM2(array_name, order, id, element_type)
/*
* Defines an item in a scattered array, sorted based on @order.
* @array_name: Name of the scattered array
* @order: Tag on which this item is sorted in the array
* @element_type: The type of the elemenet
*/
#define SCATTERED_ARRAY_DEFINE_ITEM_ORDERED(array_name, order, element_type) \
__SCT_ARRAY_DEF_ITEM1(array_name, order, __COUNTER__, element_type)
/*
* Same as SCATTERED_ARRAY_DEFINE_ITEM_ORDERED except that references
* to other objects (for instance null terminated strings) are allowed
* to reside in the paged area without residing in the init area
*/
#define SCATTERED_ARRAY_DEFINE_PG_ITEM_ORDERED(array_name, order, \
element_type) \
__SCT_ARRAY_DEF_PG_ITEM1(array_name, order, __COUNTER__, element_type)
/*
* Defines an item in a scattered array
* @array_name: Name of the scattered array
* @element_type: The type of the elemenet
*/
#define SCATTERED_ARRAY_DEFINE_ITEM(array_name, element_type) \
__SCT_ARRAY_DEF_ITEM1(array_name, 0, __COUNTER__, element_type)
/*
* Same as SCATTERED_ARRAY_DEFINE_ITEM except that references to other
* objects (for instance null terminated strings) are allowed to reside in
* the paged area without residing in the init area
*/
#define SCATTERED_ARRAY_DEFINE_PG_ITEM(array_name, element_type) \
__SCT_ARRAY_DEF_PG_ITEM1(array_name, 0, __COUNTER__, element_type)
/*
* Returns the first element in a scattered array
* @array_name: Name of the scattered array
* @element_type: The type of the elemenet
*/
#define SCATTERED_ARRAY_BEGIN(array_name, element_type) (__extension__({ \
static const element_type __scattered_array_begin[0] __unused \
__section(".scattered_array_" #array_name "_0"); \
\
(const element_type *)scattered_array_relax_ptr( \
__scattered_array_begin); \
}))
/*
* Returns one entry past the last element in a scattered array
* @array_name: Name of the scattered array
* @element_type: The type of the elemenet
*/
#define SCATTERED_ARRAY_END(array_name, element_type) (__extension__({ \
static const element_type __scattered_array_end[0] __unused \
__section(".scattered_array_" #array_name "_2"); \
\
__scattered_array_end; \
}))
/*
* Loop over all elements in the scattered array
* @elem: Iterator
* @array_name: Name of the scattered array
* @element_type: The type of the elemenet
*/
#define SCATTERED_ARRAY_FOREACH(elem, array_name, element_type) \
for ((elem) = SCATTERED_ARRAY_BEGIN(array_name, element_type); \
(elem) < SCATTERED_ARRAY_END(array_name, element_type); (elem)++)
/*
* scattered_array_relax_ptr() - relax pointer attributes
* @p pointer to return
*
* If the pointer returned from the array __scattered_array_begin[] in
* SCATTERED_ARRAY_BEGIN() is passed directly the compiler may notice that
* it's an empty array and emit warnings. With the address passed via this
* function the compiler will have no such knowledge about the pointer.
*
* Returns supplied pointer.
*/
const void *scattered_array_relax_ptr(const void *p) __attr_const;
#endif /*__SCATTERED_ARRAY_H*/
|
