Lines Matching +full:a +full:- +full:child +full:- +full:node +full:- +full:property
1 /* SPDX-License-Identifier: GPL-2.0+ */
8 * Copyright (C) 1996-2005 Paul Mackerras.
22 #include <linux/property.h>
31 struct property { struct
35 struct property *next; argument
57 struct property *properties; argument
58 struct property *deadprops; /* removed properties */
60 struct device_node *child; member
94 struct device_node *node; member
99 struct property *prop;
100 struct property *old_prop;
103 /* initialize a node */
106 static inline void of_node_init(struct device_node *node) in of_node_init() argument
109 kobject_init(&node->kobj, &of_node_ktype); in of_node_init()
111 node->fwnode.ops = &of_fwnode_ops; in of_node_init()
115 #define of_node_kobj(n) (&(n)->kobj)
121 extern struct device_node *of_node_get(struct device_node *node);
122 extern void of_node_put(struct device_node *node);
124 /* Dummy ref counting routines - to be implemented later */
125 static inline struct device_node *of_node_get(struct device_node *node) in of_node_get() argument
127 return node; in of_node_get()
129 static inline void of_node_put(struct device_node *node) { } in of_node_put() argument
150 #define OF_BAD_ADDR ((u64)-1)
157 return !IS_ERR_OR_NULL(fwnode) && fwnode->ops == &of_fwnode_ops; in is_of_node()
170 #define of_fwnode_handle(node) \ argument
172 typeof(node) __of_fwnode_handle_node = (node); \
175 &__of_fwnode_handle_node->fwnode : NULL; \
183 static inline bool of_node_is_root(const struct device_node *node) in of_node_is_root() argument
185 return node && (node->parent == NULL); in of_node_is_root()
190 return test_bit(flag, &n->_flags); in of_node_check_flag()
196 return test_and_set_bit(flag, &n->_flags); in of_node_test_and_set_flag()
201 set_bit(flag, &n->_flags); in of_node_set_flag()
206 clear_bit(flag, &n->_flags); in of_node_clear_flag()
210 static inline int of_property_check_flag(struct property *p, unsigned long flag) in of_property_check_flag()
212 return test_bit(flag, &p->_flags); in of_property_check_flag()
215 static inline void of_property_set_flag(struct property *p, unsigned long flag) in of_property_set_flag()
217 set_bit(flag, &p->_flags); in of_property_set_flag()
220 static inline void of_property_clear_flag(struct property *p, unsigned long flag) in of_property_clear_flag()
222 clear_bit(flag, &p->_flags); in of_property_clear_flag()
233 /* Helper to read a big number; size is in cells (not bytes) */
237 for (; size--; cell++) in of_read_number()
253 #define OF_IS_DYNAMIC(x) test_bit(OF_DYNAMIC, &x->_flags)
254 #define OF_MARK_DYNAMIC(x) set_bit(OF_DYNAMIC, &x->_flags)
261 return np ? np->full_name : "<no-node>"; in of_node_full_name()
286 extern struct device_node *of_get_parent(const struct device_node *node);
287 extern struct device_node *of_get_next_parent(struct device_node *node);
288 extern struct device_node *of_get_next_child(const struct device_node *node,
291 const struct device_node *node, struct device_node *prev);
295 extern struct device_node *of_get_child_by_name(const struct device_node *node,
304 extern struct property *of_find_property(const struct device_node *np,
349 extern const void *of_get_property(const struct device_node *node,
358 for (pp = dn->properties; pp != NULL; pp = pp->next)
363 const struct of_device_id *matches, const struct device_node *node);
364 extern int of_modalias_node(struct device_node *node, char *modalias, int len);
402 extern int of_add_property(struct device_node *np, struct property *prop);
403 extern int of_remove_property(struct device_node *np, struct property *prop);
404 extern int of_update_property(struct device_node *np, struct property *newprop);
419 * of_property_read_u8_array - Find and read an array of u8 from a property.
421 * @np: device node from which the property value is to be read.
422 * @propname: name of the property to be searched.
426 * Search for a property in a device node and read 8-bit value(s) from
427 * it. Returns 0 on success, -EINVAL if the property does not exist,
428 * -ENODATA if property does not have a value, and -EOVERFLOW if the
429 * property data isn't large enough.
432 * property = /bits/ 8 <0x50 0x60 0x70>;
434 * The out_values is modified only if a valid u8 value can be decoded.
449 * of_property_read_u16_array - Find and read an array of u16 from a property.
451 * @np: device node from which the property value is to be read.
452 * @propname: name of the property to be searched.
456 * Search for a property in a device node and read 16-bit value(s) from
457 * it. Returns 0 on success, -EINVAL if the property does not exist,
458 * -ENODATA if property does not have a value, and -EOVERFLOW if the
459 * property data isn't large enough.
462 * property = /bits/ 16 <0x5000 0x6000 0x7000>;
464 * The out_values is modified only if a valid u16 value can be decoded.
479 * of_property_read_u32_array - Find and read an array of 32 bit integers
480 * from a property.
482 * @np: device node from which the property value is to be read.
483 * @propname: name of the property to be searched.
487 * Search for a property in a device node and read 32-bit value(s) from
488 * it. Returns 0 on success, -EINVAL if the property does not exist,
489 * -ENODATA if property does not have a value, and -EOVERFLOW if the
490 * property data isn't large enough.
492 * The out_values is modified only if a valid u32 value can be decoded.
507 * of_property_read_u64_array - Find and read an array of 64 bit integers
508 * from a property.
510 * @np: device node from which the property value is to be read.
511 * @propname: name of the property to be searched.
515 * Search for a property in a device node and read 64-bit value(s) from
516 * it. Returns 0 on success, -EINVAL if the property does not exist,
517 * -ENODATA if property does not have a value, and -EOVERFLOW if the
518 * property data isn't large enough.
520 * The out_values is modified only if a valid u64 value can be decoded.
535 * struct property *prop;
542 const __be32 *of_prop_next_u32(struct property *prop, const __be32 *cur,
545 * struct property *prop;
551 const char *of_prop_next_string(struct property *prop, const char *cur);
589 return "<no-node>"; in of_node_full_name()
628 static inline struct device_node *of_get_parent(const struct device_node *node) in of_get_parent() argument
633 static inline struct device_node *of_get_next_parent(struct device_node *node) in of_get_next_parent() argument
639 const struct device_node *node, struct device_node *prev) in of_get_next_child() argument
645 const struct device_node *node, struct device_node *prev) in of_get_next_available_child() argument
656 #define of_fwnode_handle(node) NULL argument
670 const struct device_node *node, in of_get_child_by_name() argument
698 static inline struct property *of_find_property(const struct device_node *np, in of_find_property()
716 return -ENOSYS; in of_property_count_elems_of_size()
722 return -ENOSYS; in of_property_read_u8_array()
728 return -ENOSYS; in of_property_read_u16_array()
735 return -ENOSYS; in of_property_read_u32_array()
742 return -ENOSYS; in of_property_read_u64_array()
748 return -ENOSYS; in of_property_read_u32_index()
754 return -ENOSYS; in of_property_read_u64_index()
757 static inline const void *of_get_property(const struct device_node *node, in of_get_property() argument
795 return -ENOSYS; in of_property_read_variable_u8_array()
802 return -ENOSYS; in of_property_read_variable_u16_array()
811 return -ENOSYS; in of_property_read_variable_u32_array()
817 return -ENOSYS; in of_property_read_u64()
826 return -ENOSYS; in of_property_read_variable_u64_array()
833 return -ENOSYS; in of_property_read_string()
840 return -ENOSYS; in of_property_match_string()
847 return -ENOSYS; in of_property_read_string_helper()
863 return -ENOSYS; in of_parse_phandle_with_args()
872 return -ENOSYS; in of_parse_phandle_with_args_map()
879 return -ENOSYS; in of_parse_phandle_with_fixed_args()
886 return -ENOSYS; in of_count_phandle_with_args()
895 return -ENOSYS; in of_phandle_iterator_init()
900 return -ENOSYS; in of_phandle_iterator_next()
912 return -ENOSYS; in of_alias_get_id()
917 return -ENOSYS; in of_alias_get_highest_id()
924 return -ENOSYS; in of_alias_get_alias_list()
932 static inline int of_remove_property(struct device_node *np, struct property *prop) in of_remove_property()
942 static inline const __be32 *of_prop_next_u32(struct property *prop, in of_prop_next_u32()
948 static inline const char *of_prop_next_string(struct property *prop, in of_prop_next_string()
973 static inline int of_property_check_flag(struct property *p, unsigned long flag) in of_property_check_flag()
978 static inline void of_property_set_flag(struct property *p, unsigned long flag) in of_property_set_flag()
982 static inline void of_property_clear_flag(struct property *p, unsigned long flag) in of_property_clear_flag()
988 return -ENODEV; in of_cpu_node_to_id()
995 return -EINVAL; in of_map_id()
1009 static inline int of_prop_val_eq(struct property *p1, struct property *p2) in of_prop_val_eq()
1011 return p1->length == p2->length && in of_prop_val_eq()
1012 !memcmp(p1->value, p2->value, (size_t)p1->length); in of_prop_val_eq()
1029 return -ENOSYS; in of_numa_init()
1053 * of_property_count_u8_elems - Count the number of u8 elements in a property
1055 * @np: device node from which the property value is to be read.
1056 * @propname: name of the property to be searched.
1058 * Search for a property in a device node and count the number of u8 elements
1059 * in it. Returns number of elements on sucess, -EINVAL if the property does
1060 * not exist or its length does not match a multiple of u8 and -ENODATA if the
1061 * property does not have a value.
1070 * of_property_count_u16_elems - Count the number of u16 elements in a property
1072 * @np: device node from which the property value is to be read.
1073 * @propname: name of the property to be searched.
1075 * Search for a property in a device node and count the number of u16 elements
1076 * in it. Returns number of elements on sucess, -EINVAL if the property does
1077 * not exist or its length does not match a multiple of u16 and -ENODATA if the
1078 * property does not have a value.
1087 * of_property_count_u32_elems - Count the number of u32 elements in a property
1089 * @np: device node from which the property value is to be read.
1090 * @propname: name of the property to be searched.
1092 * Search for a property in a device node and count the number of u32 elements
1093 * in it. Returns number of elements on sucess, -EINVAL if the property does
1094 * not exist or its length does not match a multiple of u32 and -ENODATA if the
1095 * property does not have a value.
1104 * of_property_count_u64_elems - Count the number of u64 elements in a property
1106 * @np: device node from which the property value is to be read.
1107 * @propname: name of the property to be searched.
1109 * Search for a property in a device node and count the number of u64 elements
1110 * in it. Returns number of elements on sucess, -EINVAL if the property does
1111 * not exist or its length does not match a multiple of u64 and -ENODATA if the
1112 * property does not have a value.
1121 * of_property_read_string_array() - Read an array of strings from a multiple
1122 * strings property.
1123 * @np: device node from which the property value is to be read.
1124 * @propname: name of the property to be searched.
1128 * Search for a property in a device tree node and retrieve a list of
1129 * terminated string values (pointer to data, not a copy) in that property.
1131 * If @out_strs is NULL, the number of strings in the property is returned.
1141 * of_property_count_strings() - Find and return the number of strings from a
1142 * multiple strings property.
1143 * @np: device node from which the property value is to be read.
1144 * @propname: name of the property to be searched.
1146 * Search for a property in a device tree node and retrieve the number of null
1148 * success, -EINVAL if the property does not exist, -ENODATA if property
1149 * does not have a value, and -EILSEQ if the string is not null-terminated
1150 * within the length of the property data.
1159 * of_property_read_string_index() - Find and read a string from a multiple
1160 * strings property.
1161 * @np: device node from which the property value is to be read.
1162 * @propname: name of the property to be searched.
1167 * Search for a property in a device tree node and retrieve a null
1168 * terminated string value (pointer to data, not a copy) in the list of strings
1169 * contained in that property.
1170 * Returns 0 on success, -EINVAL if the property does not exist, -ENODATA if
1171 * property does not have a value, and -EILSEQ if the string is not
1172 * null-terminated within the length of the property data.
1174 * The out_string pointer is modified only if a valid string can be decoded.
1185 * of_property_read_bool - Find a property
1186 * @np: device node from which the property value is to be read.
1187 * @propname: name of the property to be searched.
1189 * Search for a property in a device node.
1190 * Returns true if the property exists false otherwise.
1195 struct property *prop = of_find_property(np, propname, NULL); in of_property_read_bool()
1262 #define for_each_child_of_node(parent, child) \ argument
1263 for (child = of_get_next_child(parent, NULL); child != NULL; \
1264 child = of_get_next_child(parent, child))
1265 #define for_each_available_child_of_node(parent, child) \ argument
1266 for (child = of_get_next_available_child(parent, NULL); child != NULL; \
1267 child = of_get_next_available_child(parent, child))
1279 struct device_node *child; in of_get_child_count() local
1282 for_each_child_of_node(np, child) in of_get_child_count()
1290 struct device_node *child; in of_get_available_child_count() local
1293 for_each_available_child_of_node(np, child) in of_get_available_child_count()
1325 * struct of_changeset_entry - Holds a changeset entry
1327 * @node: list_head for the log list
1329 * @np: pointer to the device node affected
1330 * @prop: pointer to the property affected
1331 * @old_prop: hold a pointer to the original property
1333 * Every modification of the device tree during a changeset
1334 * is held in a list of of_changeset_entry structures.
1335 * That way we can recover from a partial application, or we can
1339 struct list_head node; member
1342 struct property *prop;
1343 struct property *old_prop;
1347 * struct of_changeset - changeset tracker structure
1351 * changesets are a convenient way to apply bulk changes to the
1352 * live tree. In case of an error, changes are rolled-back.
1379 struct property *prop);
1394 struct device_node *np, struct property *prop) in of_changeset_add_property()
1400 struct device_node *np, struct property *prop) in of_changeset_remove_property()
1406 struct device_node *np, struct property *prop) in of_changeset_update_property()
1413 return -EINVAL; in of_reconfig_notifier_register()
1417 return -EINVAL; in of_reconfig_notifier_unregister()
1422 return -EINVAL; in of_reconfig_notify()
1427 return -EINVAL; in of_reconfig_get_state_change()
1432 * of_device_is_system_power_controller - Tells if system-power-controller is found for device_node
1439 return of_property_read_bool(np, "system-power-controller"); in of_device_is_system_power_controller()
1473 return -ENOTSUPP; in of_overlay_fdt_apply()
1478 return -ENOTSUPP; in of_overlay_remove()
1483 return -ENOTSUPP; in of_overlay_remove_all()