28 /// A `FwNode` instance represents a valid `struct fwnode_handle` created by the
32 /// `fwnode_handle_get` ensures that the allocation remains valid at least until
67         // valid `struct fwnode_handle`.  in is_of_node()
81                 // SAFETY: `self` is valid by its type invariant.  in display_name()
87                 // - `fwnode_get_name` returns null or a valid C string.  in display_name()
107         // - `self.as_raw()` is valid because `self` is valid.  in property_read_bool()
116         // - `self.as_raw` is valid because `self` is valid.  in property_match_string()
203         // SAFETY: `self` and `name` are valid by their type invariants.  in get_child_by_name()
234             // - `self.as_raw()` is valid by its type invariant.  in children()
236             //   getting the first child. Otherwise, `prev_ptr` is valid, as it  in children()
246             // - `next` is valid because `fwnode_get_next_child_node` returns a  in children()
272         // - `self.0.get()` is valid.  in property_get_reference_args()
273         // - `prop.as_char_ptr()` is valid and zero-terminated.  in property_get_reference_args()
274         // - `nargs_prop` is valid and zero-terminated if `nargs`  in property_get_reference_args()
278         //   - It may fill the field `fwnode` with a valid pointer,  in property_get_reference_args()
314 /// If the field `fwnode` is valid, it owns an increment of its refcount.
339         // is the minimum number of elements in `args` that is valid.  in as_slice()
385         // SAFETY: `self.as_raw()` is valid by its type invariant.  in fmt()
392                 // SAFETY: `self.as_raw()` is valid.  in fmt()
396                 //   within the valid range, so the returned pointer is  in fmt()
410             // SAFETY: `fwnode` is valid by its type invariant.  in fmt()
414                 // valid C string.  in fmt()
450         // - `fwnode.as_raw` is valid because `fwnode` is valid.  in read_from_fwnode_property()
457         // - `pstr` is a valid pointer to a NUL-terminated C string.  in read_from_fwnode_property()
458         // - It is valid for at least as long as `fwnode`, but it's only used  in read_from_fwnode_property()
502                 // - `fwnode`, `name` and `out` are all valid by their type
504                 // - `out.len()` is a valid bound for the memory pointed to by
526                 // - `fwnode` and `name` are valid by their type invariants.