drivers/of/resolver.c - linux - Git at Google

 /*
  * Functions for dealing with DT resolution
  *
  * Copyright (C) 2012 Pantelis Antoniou <panto@antoniou-consulting.com>
  * Copyright (C) 2012 Texas Instruments Inc.
  *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of the GNU General Public License
  * version 2 as published by the Free Software Foundation.
  */

 #define pr_fmt(fmt)	"OF: resolver: " fmt

 #include <linux/kernel.h>
 #include <linux/module.h>
 #include <linux/of.h>
 #include <linux/of_device.h>
 #include <linux/string.h>
 #include <linux/ctype.h>
 #include <linux/errno.h>
 #include <linux/string.h>
 #include <linux/slab.h>

 /* illegal phandle value (set when unresolved) */
 #define OF_PHANDLE_ILLEGAL	0xdeadbeef

 /**
  * Find a node with the give full name by recursively following any of
  * the child node links.
  */
 static struct device_node *__of_find_node_by_full_name(struct device_node *node,
 		const char *full_name)
 {
 	struct device_node *child, *found;

 	if (node == NULL)
 		return NULL;

 	if (of_node_cmp(node->full_name, full_name) == 0)
 		return of_node_get(node);

 	for_each_child_of_node(node, child) {
 		found = __of_find_node_by_full_name(child, full_name);
 		if (found != NULL) {
 			of_node_put(child);
 			return found;
 		}
 	}

 	return NULL;
 }

 /*
  * Find live tree's maximum phandle value.
  */
 static phandle of_get_tree_max_phandle(void)
 {
 	struct device_node *node;
 	phandle phandle;
 	unsigned long flags;

 	raw_spin_lock_irqsave(&devtree_lock, flags);
 	phandle = 0;
 	for_each_of_allnodes(node) {
 		if (node->phandle != OF_PHANDLE_ILLEGAL &&
 				node->phandle > phandle)
 			phandle = node->phandle;
 	}
 	raw_spin_unlock_irqrestore(&devtree_lock, flags);

 	return phandle;
 }

 /*
  * Adjust a subtree's phandle values by a given delta.
  */
 static void __of_adjust_tree_phandles(struct device_node *node,
 		int phandle_delta)
 {
 	struct device_node *child;
 	struct property *prop;
 	phandle phandle;

 	if (node->phandle != 0 && node->phandle != OF_PHANDLE_ILLEGAL)
 		node->phandle += phandle_delta;

 	for_each_property_of_node(node, prop) {

 		if (of_prop_cmp(prop->name, "phandle") != 0 &&
 		    of_prop_cmp(prop->name, "linux,phandle") != 0)
 			continue;

 		if (prop->length < 4)
 			continue;

 		phandle = be32_to_cpup(prop->value);
 		if (phandle == OF_PHANDLE_ILLEGAL)
 			continue;

 		*(uint32_t *)prop->value = cpu_to_be32(node->phandle);
 	}

 	for_each_child_of_node(node, child)
 		__of_adjust_tree_phandles(child, phandle_delta);
 }

 static int __of_adjust_phandle_ref(struct device_node *node,
 		struct property *rprop, int value)
 {
 	phandle phandle;
 	struct device_node *refnode;
 	struct property *sprop;
 	char *propval, *propcur, *propend, *nodestr, *propstr, *s;
 	int offset, propcurlen;
 	int err = 0;

 	propval = kmalloc(rprop->length, GFP_KERNEL);
 	if (!propval)
 		return -ENOMEM;
 	memcpy(propval, rprop->value, rprop->length);

 	propend = propval + rprop->length;
 	for (propcur = propval; propcur < propend; propcur += propcurlen + 1) {
 		propcurlen = strlen(propcur);

 		nodestr = propcur;
 		s = strchr(propcur, ':');
 		if (!s) {
 			err = -EINVAL;
 			goto err_fail;
 		}
 		*s++ = '\0';

 		propstr = s;
 		s = strchr(s, ':');
 		if (!s) {
 			err = -EINVAL;
 			goto err_fail;
 		}

 		*s++ = '\0';
 		err = kstrtoint(s, 10, &offset);
 		if (err != 0)
 			goto err_fail;

 		refnode = __of_find_node_by_full_name(node, nodestr);
 		if (!refnode)
 			continue;

 		for_each_property_of_node(refnode, sprop) {
 			if (of_prop_cmp(sprop->name, propstr) == 0)
 				break;
 		}
 		of_node_put(refnode);

 		if (!sprop) {
 			err = -ENOENT;
 			goto err_fail;
 		}

 		phandle = value;
 		*(__be32 *)(sprop->value + offset) = cpu_to_be32(phandle);
 	}

 err_fail:
 	kfree(propval);
 	return err;
 }

 /* compare nodes taking into account that 'name' strips out the @ part */
 static int __of_node_name_cmp(const struct device_node *dn1,
 		const struct device_node *dn2)
 {
 	const char *n1 = strrchr(dn1->full_name, '/') ? : "/";
 	const char *n2 = strrchr(dn2->full_name, '/') ? : "/";

 	return of_node_cmp(n1, n2);
 }

 /*
  * Adjust the local phandle references by the given phandle delta.
  * Assumes the existances of a __local_fixups__ node at the root.
  * Assumes that __of_verify_tree_phandle_references has been called.
  * Does not take any devtree locks so make sure you call this on a tree
  * which is at the detached state.
  */
 static int __of_adjust_tree_phandle_references(struct device_node *node,
 		struct device_node *target, int phandle_delta)
 {
 	struct device_node *child, *childtarget;
 	struct property *rprop, *sprop;
 	int err, i, count;
 	unsigned int off;
 	phandle phandle;

 	if (node == NULL)
 		return 0;

 	for_each_property_of_node(node, rprop) {

 		/* skip properties added automatically */
 		if (of_prop_cmp(rprop->name, "name") == 0 ||
 		    of_prop_cmp(rprop->name, "phandle") == 0 ||
 		    of_prop_cmp(rprop->name, "linux,phandle") == 0)
 			continue;

 		if ((rprop->length % 4) != 0 || rprop->length == 0)
 			return -EINVAL;
 		count = rprop->length / sizeof(__be32);

 		for_each_property_of_node(target, sprop) {
 			if (of_prop_cmp(sprop->name, rprop->name) == 0)
 				break;
 		}

 		if (sprop == NULL)
 			return -EINVAL;

 		for (i = 0; i < count; i++) {
 			off = be32_to_cpu(((__be32 *)rprop->value)[i]);
 			if (off >= sprop->length || (off + 4) > sprop->length)
 				return -EINVAL;

 			if (phandle_delta) {
 				phandle = be32_to_cpu(*(__be32 *)(sprop->value + off));
 				phandle += phandle_delta;
 				*(__be32 *)(sprop->value + off) = cpu_to_be32(phandle);
 			}
 		}
 	}

 	for_each_child_of_node(node, child) {

 		for_each_child_of_node(target, childtarget)
 			if (__of_node_name_cmp(child, childtarget) == 0)
 				break;

 		if (!childtarget)
 			return -EINVAL;

 		err = __of_adjust_tree_phandle_references(child, childtarget,
 				phandle_delta);
 		if (err != 0)
 			return err;
 	}

 	return 0;
 }

 /**
  * of_resolve	- Resolve the given node against the live tree.
  *
  * @resolve:	Node to resolve
  *
  * Perform dynamic Device Tree resolution against the live tree
  * to the given node to resolve. This depends on the live tree
  * having a __symbols__ node, and the resolve node the __fixups__ &
  * __local_fixups__ nodes (if needed).
  * The result of the operation is a resolve node that it's contents
  * are fit to be inserted or operate upon the live tree.
  * Returns 0 on success or a negative error value on error.
  */
 int of_resolve_phandles(struct device_node *resolve)
 {
 	struct device_node *child, *childroot, *refnode;
 	struct device_node *root_sym, *resolve_sym, *resolve_fix;
 	struct property *rprop;
 	const char *refpath;
 	phandle phandle, phandle_delta;
 	int err;

 	if (!resolve)
 		pr_err("%s: null node\n", __func__);
 	if (resolve && !of_node_check_flag(resolve, OF_DETACHED))
 		pr_err("%s: node %s not detached\n", __func__,
 			 resolve->full_name);
 	if (!resolve || !of_node_check_flag(resolve, OF_DETACHED))
 		return -EINVAL;

 	phandle_delta = of_get_tree_max_phandle() + 1;
 	__of_adjust_tree_phandles(resolve, phandle_delta);

 	childroot = NULL;
 	for_each_child_of_node(resolve, childroot)
 		if (of_node_cmp(childroot->name, "__local_fixups__") == 0)
 			break;

 	if (childroot != NULL) {
 		err = __of_adjust_tree_phandle_references(childroot,
 				resolve, 0);
 		if (err != 0)
 			return err;

 		BUG_ON(__of_adjust_tree_phandle_references(childroot,
 				resolve, phandle_delta));
 	}

 	root_sym = NULL;
 	resolve_sym = NULL;
 	resolve_fix = NULL;

 	root_sym = of_find_node_by_path("/__symbols__");

 	for_each_child_of_node(resolve, child) {

 		if (!resolve_sym &&
 				of_node_cmp(child->name, "__symbols__") == 0)
 			resolve_sym = child;

 		if (!resolve_fix &&
 				of_node_cmp(child->name, "__fixups__") == 0)
 			resolve_fix = child;

 		if (resolve_sym && resolve_fix)
 			break;
 	}

 	if (!resolve_fix) {
 		err = 0;
 		goto out;
 	}

 	if (!root_sym) {
 		pr_err("%s: no symbols in root of device tree.\n", __func__);
 		err = -EINVAL;
 		goto out;
 	}

 	for_each_property_of_node(resolve_fix, rprop) {

 		/* skip properties added automatically */
 		if (of_prop_cmp(rprop->name, "name") == 0)
 			continue;

 		err = of_property_read_string(root_sym,
 				rprop->name, &refpath);
 		if (err != 0)
 			goto out;

 		refnode = of_find_node_by_path(refpath);
 		if (!refnode) {
 			err = -ENOENT;
 			goto out;
 		}

 		phandle = refnode->phandle;
 		of_node_put(refnode);

 		err = __of_adjust_phandle_ref(resolve, rprop, phandle);
 		if (err)
 			break;
 	}

 out:
 	of_node_put(root_sym);

 	return err;
 }
 EXPORT_SYMBOL_GPL(of_resolve_phandles);
	/*
	* Functions for dealing with DT resolution
	*
	* Copyright (C) 2012 Pantelis Antoniou <panto@antoniou-consulting.com>
	* Copyright (C) 2012 Texas Instruments Inc.
	*
	* This program is free software; you can redistribute it and/or
	* modify it under the terms of the GNU General Public License
	* version 2 as published by the Free Software Foundation.
	*/

	#define pr_fmt(fmt) "OF: resolver: " fmt

	#include <linux/kernel.h>
	#include <linux/module.h>
	#include <linux/of.h>
	#include <linux/of_device.h>
	#include <linux/string.h>
	#include <linux/ctype.h>
	#include <linux/errno.h>
	#include <linux/string.h>
	#include <linux/slab.h>

	/* illegal phandle value (set when unresolved) */
	#define OF_PHANDLE_ILLEGAL 0xdeadbeef

	/**
	* Find a node with the give full name by recursively following any of
	* the child node links.
	*/
	static struct device_node __of_find_node_by_full_name(struct device_node node,
	const char *full_name)
	{
	struct device_node child, found;

	if (node == NULL)
	return NULL;

	if (of_node_cmp(node->full_name, full_name) == 0)
	return of_node_get(node);

	for_each_child_of_node(node, child) {
	found = __of_find_node_by_full_name(child, full_name);
	if (found != NULL) {
	of_node_put(child);
	return found;
	}
	}

	return NULL;
	}

	/*
	* Find live tree's maximum phandle value.
	*/
	static phandle of_get_tree_max_phandle(void)
	{
	struct device_node *node;
	phandle phandle;
	unsigned long flags;

	raw_spin_lock_irqsave(&devtree_lock, flags);
	phandle = 0;
	for_each_of_allnodes(node) {
	if (node->phandle != OF_PHANDLE_ILLEGAL &&
	node->phandle > phandle)
	phandle = node->phandle;
	}
	raw_spin_unlock_irqrestore(&devtree_lock, flags);

	return phandle;
	}

	/*
	* Adjust a subtree's phandle values by a given delta.
	*/
	static void __of_adjust_tree_phandles(struct device_node *node,
	int phandle_delta)
	{
	struct device_node *child;
	struct property *prop;
	phandle phandle;

	if (node->phandle != 0 && node->phandle != OF_PHANDLE_ILLEGAL)
	node->phandle += phandle_delta;

	for_each_property_of_node(node, prop) {

	if (of_prop_cmp(prop->name, "phandle") != 0 &&
	of_prop_cmp(prop->name, "linux,phandle") != 0)
	continue;

	if (prop->length < 4)
	continue;

	phandle = be32_to_cpup(prop->value);
	if (phandle == OF_PHANDLE_ILLEGAL)
	continue;

	(uint32_t )prop->value = cpu_to_be32(node->phandle);
	}

	for_each_child_of_node(node, child)
	__of_adjust_tree_phandles(child, phandle_delta);
	}

	static int __of_adjust_phandle_ref(struct device_node *node,
	struct property *rprop, int value)
	{
	phandle phandle;
	struct device_node *refnode;
	struct property *sprop;
	char propval, propcur, propend, nodestr, propstr, s;
	int offset, propcurlen;
	int err = 0;

	propval = kmalloc(rprop->length, GFP_KERNEL);
	if (!propval)
	return -ENOMEM;
	memcpy(propval, rprop->value, rprop->length);

	propend = propval + rprop->length;
	for (propcur = propval; propcur < propend; propcur += propcurlen + 1) {
	propcurlen = strlen(propcur);

	nodestr = propcur;
	s = strchr(propcur, ':');
	if (!s) {
	err = -EINVAL;
	goto err_fail;
	}
	*s++ = '\0';

	propstr = s;
	s = strchr(s, ':');
	if (!s) {
	err = -EINVAL;
	goto err_fail;
	}

	*s++ = '\0';
	err = kstrtoint(s, 10, &offset);
	if (err != 0)
	goto err_fail;

	refnode = __of_find_node_by_full_name(node, nodestr);
	if (!refnode)
	continue;

	for_each_property_of_node(refnode, sprop) {
	if (of_prop_cmp(sprop->name, propstr) == 0)
	break;
	}
	of_node_put(refnode);

	if (!sprop) {
	err = -ENOENT;
	goto err_fail;
	}

	phandle = value;
	(__be32 )(sprop->value + offset) = cpu_to_be32(phandle);
	}

	err_fail:
	kfree(propval);
	return err;
	}

	/* compare nodes taking into account that 'name' strips out the @ part */
	static int __of_node_name_cmp(const struct device_node *dn1,
	const struct device_node *dn2)
	{
	const char *n1 = strrchr(dn1->full_name, '/') ? : "/";
	const char *n2 = strrchr(dn2->full_name, '/') ? : "/";

	return of_node_cmp(n1, n2);
	}

	/*
	* Adjust the local phandle references by the given phandle delta.
	* Assumes the existances of a __local_fixups__ node at the root.
	* Assumes that __of_verify_tree_phandle_references has been called.
	* Does not take any devtree locks so make sure you call this on a tree
	* which is at the detached state.
	*/
	static int __of_adjust_tree_phandle_references(struct device_node *node,
	struct device_node *target, int phandle_delta)
	{
	struct device_node child, childtarget;
	struct property rprop, sprop;
	int err, i, count;
	unsigned int off;
	phandle phandle;

	if (node == NULL)
	return 0;

	for_each_property_of_node(node, rprop) {

	/* skip properties added automatically */
	if (of_prop_cmp(rprop->name, "name") == 0 \|\|
	of_prop_cmp(rprop->name, "phandle") == 0 \|\|
	of_prop_cmp(rprop->name, "linux,phandle") == 0)
	continue;

	if ((rprop->length % 4) != 0 \|\| rprop->length == 0)
	return -EINVAL;
	count = rprop->length / sizeof(__be32);

	for_each_property_of_node(target, sprop) {
	if (of_prop_cmp(sprop->name, rprop->name) == 0)
	break;
	}

	if (sprop == NULL)
	return -EINVAL;

	for (i = 0; i < count; i++) {
	off = be32_to_cpu(((__be32 *)rprop->value)[i]);
	if (off >= sprop->length \|\| (off + 4) > sprop->length)
	return -EINVAL;

	if (phandle_delta) {
	phandle = be32_to_cpu((__be32 )(sprop->value + off));
	phandle += phandle_delta;
	(__be32 )(sprop->value + off) = cpu_to_be32(phandle);
	}
	}
	}

	for_each_child_of_node(node, child) {

	for_each_child_of_node(target, childtarget)
	if (__of_node_name_cmp(child, childtarget) == 0)
	break;

	if (!childtarget)
	return -EINVAL;

	err = __of_adjust_tree_phandle_references(child, childtarget,
	phandle_delta);
	if (err != 0)
	return err;
	}

	return 0;
	}

	/**
	* of_resolve - Resolve the given node against the live tree.
	*
	* @resolve: Node to resolve
	*
	* Perform dynamic Device Tree resolution against the live tree
	* to the given node to resolve. This depends on the live tree
	* having a __symbols__ node, and the resolve node the __fixups__ &
	* __local_fixups__ nodes (if needed).
	* The result of the operation is a resolve node that it's contents
	* are fit to be inserted or operate upon the live tree.
	* Returns 0 on success or a negative error value on error.
	*/
	int of_resolve_phandles(struct device_node *resolve)
	{
	struct device_node child, childroot, *refnode;
	struct device_node root_sym, resolve_sym, *resolve_fix;
	struct property *rprop;
	const char *refpath;
	phandle phandle, phandle_delta;
	int err;

	if (!resolve)
	pr_err("%s: null node\n", __func__);
	if (resolve && !of_node_check_flag(resolve, OF_DETACHED))
	pr_err("%s: node %s not detached\n", __func__,
	resolve->full_name);
	if (!resolve \|\| !of_node_check_flag(resolve, OF_DETACHED))
	return -EINVAL;

	phandle_delta = of_get_tree_max_phandle() + 1;
	__of_adjust_tree_phandles(resolve, phandle_delta);

	childroot = NULL;
	for_each_child_of_node(resolve, childroot)
	if (of_node_cmp(childroot->name, "__local_fixups__") == 0)
	break;

	if (childroot != NULL) {
	err = __of_adjust_tree_phandle_references(childroot,
	resolve, 0);
	if (err != 0)
	return err;

	BUG_ON(__of_adjust_tree_phandle_references(childroot,
	resolve, phandle_delta));
	}

	root_sym = NULL;
	resolve_sym = NULL;
	resolve_fix = NULL;

	root_sym = of_find_node_by_path("/__symbols__");

	for_each_child_of_node(resolve, child) {

	if (!resolve_sym &&
	of_node_cmp(child->name, "__symbols__") == 0)
	resolve_sym = child;

	if (!resolve_fix &&
	of_node_cmp(child->name, "__fixups__") == 0)
	resolve_fix = child;

	if (resolve_sym && resolve_fix)
	break;
	}

	if (!resolve_fix) {
	err = 0;
	goto out;
	}

	if (!root_sym) {
	pr_err("%s: no symbols in root of device tree.\n", __func__);
	err = -EINVAL;
	goto out;
	}

	for_each_property_of_node(resolve_fix, rprop) {

	/* skip properties added automatically */
	if (of_prop_cmp(rprop->name, "name") == 0)
	continue;

	err = of_property_read_string(root_sym,
	rprop->name, &refpath);
	if (err != 0)
	goto out;

	refnode = of_find_node_by_path(refpath);
	if (!refnode) {
	err = -ENOENT;
	goto out;
	}

	phandle = refnode->phandle;
	of_node_put(refnode);

	err = __of_adjust_phandle_ref(resolve, rprop, phandle);
	if (err)
	break;
	}

	out:
	of_node_put(root_sym);

	return err;
	}
	EXPORT_SYMBOL_GPL(of_resolve_phandles);