lib/libfdt/libfdt.h

71 	 * device tree has it's sub-blocks in an order that the
76 /* "Can't happen" error indicating a bug in libfdt */
79 	 * Should never be returned, if it is, it indicates a bug in
82 /* Errors in device tree content */
119 #ifndef SWIG /* This function is not useful in Python */
229  * iterator in the loop. The parent variable be constant or even a
275  * Return: size of DTB header in bytes
283  * Return: size of DTB header in bytes
306  * fdt_move - move a device tree around in memory
340  * returns the string's length in *lenp.
363  * fdt_find_max_phandle - find and return the highest phandle in a tree
365  * @phandle: return location for the highest phandle value found in the tree
367  * fdt_find_max_phandle() finds the highest phandle value in the given device
368  * tree. The value returned in @phandle is only valid if the function returns
377  * fdt_get_max_phandle - retrieves the highest phandle in a tree
380  * fdt_get_max_phandle retrieves the highest phandle in the given
384  * This function is deprecated in favour of fdt_find_max_phandle().
388  *      0, if no phandle was found in the device tree
410  * highest phandle value in the device tree blob) will be returned in the
421  * Returns the number of entries in the device tree blob's memory
438  * the n-th reserve map entry from the device tree blob, in
463 #ifndef SWIG /* Not available in Python */
475  * address, in which case fdt_subnode_offset() will find the subnode
476  * with that unit address, or the unit address may be omitted, in
504 #ifndef SWIG /* Not available in Python */
513  * fdt_path_offset() finds a node of a given path in the device tree.
541  * non-NULL, the length of this name is also returned, in the integer
589  *	-FDT_ERR_NOTFOUND, if the given property is the last in its node
618  * iterator in the loop. The node variable can be constant or even a
635  * also returned, in the integer pointed to by lenp.
671 #ifndef SWIG /* Not available in Python */
679  * fdt_get_property - find a given property in a given node
688  * non-NULL, the length of the property value is also returned, in the
727  * returned, in the integer pointed to by lenp.  If namep is non-NULL,
728  * the property's namne will also be returned in the char * pointed to
747 #ifndef SWIG /* This function is not useful in Python */
765 #ifndef SWIG /* Not available in Python */
788  * returned, in the integer pointed to by @lenp.
839 #ifndef SWIG /* Not available in Python */
850  * value of the property named @name in the node /aliases.
866  * nodeoffset, and records that path in the buffer at buf.
877  *		characters and will not fit in the given buffer.
968  * @proplen: length of the value in propval
973  * startoffset is -1, the very first such node in the tree.
985  * Note the -1 in the first call to the function, if 0 is used here
992  *	-FDT_ERR_NOTFOUND, no node matching the criterion exists in the
1011  * in the tree with the given phandle (an invalid tree), results are
1058  * very first such node in the tree.
1068  * Note the -1 in the first call to the function, if 0 is used here
1075  *	-FDT_ERR_NOTFOUND, no node matching the criterion exists in the
1093  * one or more strings, each terminated by \0, as is found in a device tree
1096  * Return: 1 if the string is found in the list, 0 not found, or invalid list
1101  * fdt_stringlist_count - count the number of strings in a string list
1107  *   the number of strings in the given property
1114  * fdt_stringlist_search - find a string in a string list and return its index
1118  * @string: string to look up in the string list
1127  *   the index of the string in the list of strings
1136  * fdt_stringlist_get() - obtain the string at a given index in a string list
1148  * (on failure) will be stored in the integer pointer to by lenp.
1151  *   A pointer to the string at the given index in the string list or NULL on
1152  *   failure. On success the length of the string will be stored in the memory
1154  *   the following negative error codes will be returned in the lenp parameter
1173  * Implementations may support larger values, but in practice higher
1179  * fdt_address_cells - retrieve address size for a bus represented in the tree
1199  * fdt_size_cells - retrieve address range size for a bus represented in the
1221 /* Write-in-place functions                                           */
1231  * @idx: index of the property to change in the array
1242 #ifndef SWIG /* Not available in Python */
1258  * the data in val, of length len.  This function cannot change the
1262  * This function will alter only the bytes in the blob which contain
1277 #ifndef SWIG /* Not available in Python */
1290  * with the 32-bit integer value in val, converting val to big-endian
1295  * This function will alter only the bytes in the blob which contain
1325  * with the 64-bit integer value in val, converting val to big-endian
1330  * This function will alter only the bytes in the blob which contain
1375  * in the blob with FDT_NOP tags, effectively removing it from the
1378  * This function will alter only the bytes in the blob which contain
1399  * fdt_nop_node() will replace a given node's representation in the
1403  * This function will alter only the bytes in the blob which contain
1425 	 * names in the fdt. This can result in faster creation times, but
1477 #ifndef SWIG /* Not available in Python */
1489  * @len: length of property value in bytes
1522  * therefore change the indexes of some entries in the table.
1526  *	-FDT_ERR_NOSPACE, there is insufficient free space in the blob to
1546  * therefore change the indexes of some entries in the table.
1578  *	-FDT_ERR_NOSPACE, there is insufficient free space in the blob
1595  * fdt_setprop() sets the value of the named property in the given
1604  *	-FDT_ERR_NOSPACE, there is insufficient free space in the blob to
1626  * fdt_setprop_placeholer() allocates the named property in the given node.
1627  * If the property exists it is resized. In either case a pointer to the
1635  *	-FDT_ERR_NOSPACE, there is insufficient free space in the blob to
1656  * fdt_setprop_u32() sets the value of the named property in the given
1666  *	-FDT_ERR_NOSPACE, there is insufficient free space in the blob to
1691  * fdt_setprop_u64() sets the value of the named property in the given
1701  *	-FDT_ERR_NOSPACE, there is insufficient free space in the blob to
1743  * fdt_setprop_string() sets the value of the named property in the
1753  *	-FDT_ERR_NOSPACE, there is insufficient free space in the blob to
1774  * fdt_setprop_empty() sets the value of the named property in the
1783  *	-FDT_ERR_NOSPACE, there is insufficient free space in the blob to
1805  * fdt_appendprop() appends the value to the named property in the
1813  *	-FDT_ERR_NOSPACE, there is insufficient free space in the blob to
1836  * property in the given node, or creates a new property with that
1844  *	-FDT_ERR_NOSPACE, there is insufficient free space in the blob to
1871  * property in the given node, or creates a new property with that
1879  *	-FDT_ERR_NOSPACE, there is insufficient free space in the blob to
1922  * the named property in the given node, or creates a new property
1930  *	-FDT_ERR_NOSPACE, there is insufficient free space in the blob to
1954  * address and size) to the value of the named property in the given
1974  *	-FDT_ERR_NOSPACE, there is insufficient free space in the blob to
2020 #ifndef SWIG /* Not available in Python */
2046  *	-FDT_ERR_NOSPACE, if there is insufficient free space in the
2094  *	-FDT_ERR_NOSPACE, there's not enough space in the base device tree
2096  *		properties in the base DT