Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 64808273 authored by Baruch Siach's avatar Baruch Siach Committed by Rob Herring
Browse files

of: base: improve of_get_next_child() kernel-doc 



Add two new facts to of_get_next_child() documentation:

   * of_get_next_child() returns NULL when there is not next child

   * of_get_next_child() decrements the refcount of prev

Signed-off-by: default avatarBaruch Siach <baruch@tkos.co.il>
Signed-off-by: default avatarRob Herring <robh@kernel.org>
parent 4155fc07

drivers/of/base.c

+3 −2
Original line number Original line Diff line number Diff line
@@ -663,8 +663,9 @@ static struct device_node *__of_get_next_child(const struct device_node *node, 
 *	@node:	parent node

 *	@node:	parent node

 *	@prev:	previous child of the parent node, or NULL to get first

 *	@prev:	previous child of the parent node, or NULL to get first

 *

 *

 *	Returns a node pointer with refcount incremented, use

 *	Returns a node pointer with refcount incremented, use of_node_put() on

 *	of_node_put() on it when done.

 *	it when done. Returns NULL when prev is the last child. Decrements the

 *	refcount of prev.

 */

 */

struct device_node *of_get_next_child(const struct device_node *node,

struct device_node *of_get_next_child(const struct device_node *node,

	struct device_node *prev)

	struct device_node *prev)