u-boot/include/linker_lists.h

1 /* SPDX-License-Identifier: GPL-2.0+ */
5  * Implementation of linker-generated arrays
23  * llsym() - Access a linker-generated array entry
24  * @_type:	Data type of the entry
25  * @_name:	Name of the entry
26  * @_list:	name of the list. Should contain only characters allowed
27  *		in a C variable name!
33  * ll_entry_declare() - Declare linker-generated array entry
34  * @_type:	Data type of the entry
35  * @_name:	Name of the entry
36  * @_list:	name of the list. Should contain only characters allowed
37  *		in a C variable name!
39  * This macro declares a variable that is placed into a linker-generated
40  * array. This is a basic building block for more advanced use of linker-
44  * A variable declared using this macro must be compile-time initialized.
49  *    entry is generated and can be iterated but is listed in the map
50  *    file and cannot be retrieved by name.
76  * ll_entry_declare_list() - Declare a list of link-generated array entries
77  * @_type:	Data type of each entry
78  * @_name:	Name of the entry
79  * @_list:	name of the list. Should contain only characters allowed
80  *		in a C variable name!
99  * We need a 0-byte-size type for iterator symbols, and the compiler
103  * thing: zero-sized arrays, which are both 0-byte-size and exempt from
108  * ll_entry_start() - Point to first entry of linker-generated array
109  * @_type:	Data type of the entry
110  * @_list:	Name of the list in which this entry is placed
112  * This function returns ``(_type *)`` pointer to the very first entry of a
113  * linker-generated array placed into subsection of .u_boot_list section
133  * ll_entry_end() - Point after last entry of linker-generated array
134  * @_type:	Data type of the entry
135  * @_list:	Name of the list in which this entry is placed
138  * This function returns ``(_type *)`` pointer after the very last entry of
139  * a linker-generated array placed into subsection of .u_boot_list
158  * ll_entry_count() - Return the number of elements in linker-generated array
159  * @_type:	Data type of the entry
160  * @_list:	Name of the list of which the number of elements is computed
162  * This function returns the number of elements of a linker-generated array
174  *           printf("Entry %i, x=%i y=%i\n", i, msc->x, msc->y);
180 		unsigned int _ll_result = end - start;			\
185  * ll_entry_get() - Retrieve entry from linker-generated array by name
186  * @_type:	Data type of the entry
187  * @_name:	Name of the entry
188  * @_list:	Name of the list in which this entry is placed
190  * This function returns a pointer to a particular entry in linker-generated
191  * array identified by the subsection of u_boot_list where the entry resides
192  * and it's name.
214  * ll_start() - Point to first entry of first linker-generated array
215  * @_type:	Data type of the entry
217  * This function returns ``(_type *)`` pointer to the very first entry of
218  * the very first linker-generated array.
220  * Since this macro defines the start of the linker-generated arrays,
237  * ll_end() - Point after last entry of last linker-generated array
238  * @_type:	Data type of the entry
240  * This function returns ``(_type *)`` pointer after the very last entry of
241  * the very last linker-generated array.
243  * Since this macro defines the end of the linker-generated arrays,