dtc/libfdt/libfdt.h

42 	/* FDT_ERR_BADPHANDLE: Function was passed an invalid phandle.
43 	 * This can be caused either by an invalid phandle property
44 	 * length, or the phandle value was either 0 or -1, which are
99 	 * phandle available anymore without causing an overflow */
370  * fdt_find_max_phandle - find and return the highest phandle in a tree
372  * @phandle: return location for the highest phandle value found in the tree
374  * fdt_find_max_phandle() finds the highest phandle value in the given device
375  * tree. The value returned in @phandle is only valid if the function returns
381 int fdt_find_max_phandle(const void *fdt, uint32_t *phandle);
384  * fdt_get_max_phandle - retrieves the highest phandle in a tree
387  * fdt_get_max_phandle retrieves the highest phandle in the given
394  *      the highest phandle on success
395  *      0, if no phandle was found in the device tree
400 	uint32_t phandle;
403 	err = fdt_find_max_phandle(fdt, &phandle);
407 	return phandle;
411  * fdt_generate_phandle - return a new, unused phandle for a device tree blob
413  * @phandle: return location for the new phandle
415  * Walks the device tree blob and looks for the highest phandle value. On
416  * success, the new, unused phandle value (one higher than the previously
417  * highest phandle value in the device tree blob) will be returned in the
418  * @phandle parameter.
422 int fdt_generate_phandle(const void *fdt, uint32_t *phandle);
828  * fdt_get_phandle - retrieve the phandle of a given node
832  * fdt_get_phandle() retrieves the phandle of the device tree node at
836  *	the phandle of the node at nodeoffset, on success (!= 0, != -1)
837  *	0, if the node has no phandle, or another error occurs
1019  * fdt_node_offset_by_phandle - find the node with a given phandle
1021  * @phandle: phandle value
1024  * which has the given phandle value.  If there is more than one node
1025  * in the tree with the given phandle (an invalid tree), results are
1030  *	-FDT_ERR_NOTFOUND, no node with that phandle exists
1031  *	-FDT_ERR_BADPHANDLE, given phandle value was invalid (0 or -1)
1037 int fdt_node_offset_by_phandle(const void *fdt, uint32_t phandle);
2135  * done (through a phandle or a path)