include/linux/libfdt.h

1 /* SPDX-License-Identifier: GPL-2.0 */
10 /* U-Boot local hacks */
90  * fdt_find_regions() - find regions in device tree
92  * Given a list of nodes to include and properties to exclude, find
97  * for all nodes but exclude the property "data", then you will get the
100  * This function can be used to produce a byte-stream to send to a hashing
110  * it prevents the root node from changing at all Any change to non-excluded
130  * @exc_prop:	List of properties names to exclude
131  * @exc_prop_count:	Number of properties in exclude list
149  * fdt_first_region() - find regions in device tree
151  * Given a nodes and properties to include and properties to exclude, find
155  * way of performing a structure-aware grep of the tree. For example it is
159  * This is useful for small resource-constrained systems, such as boot
166  * for all nodes but exclude the property "data", then you will get the
169  * This function can be used to produce a byte-stream to send to a hashing
173  * from source, and nodes are reordered (the bytes-stream will be emitted
178  * The nodes/properties to include/exclude are defined by a function
182  *    0 - to exclude this part
183  *    1 - to include this part
184  *   -1 - for FDT_IS_PROP only: no information is available, so include
188  * included if its containing node is included - this is the case where
189  * -1 is returned.. However if the property is specifically required to be
206  * root node from changing at all. Any change to non-excluded properties,
240  *		@return 0 to exclude, 1 to include, -1 if no information is
256  * On error a -ve value is return, which can be:
258  *	-FDT_ERR_BADSTRUCTURE (too deep or more END tags than BEGIN tags
259  *	-FDT_ERR_BADLAYOUT
260  *	-FDT_ERR_NOSPACE (path area is too small)
269 /** fdt_next_region() - find next region
275  * This function can additionally return -FDT_ERR_NOTFOUND when there are no
286  * fdt_add_alias_regions() - find aliases that point to existing regions
304  * or -FDT_ERR_NOSPACE if there was not enough space.