Commit 669a3630 authored by Gaurav Minocha's avatar Gaurav Minocha Committed by Grant Likely

To remove non-ascii characters in of_selftest.txt

This patch removes the non-ascii characters in
Documentation/devicetree/of_selftest.txt
Signed-off-by: default avatarGaurav Minocha <gaurav.minocha.os@gmail.com>
[grant.likely: Fix: s/of_fdt_unflatten_device_tree()/of_fdt_unflatten_tree()/]
Signed-off-by: default avatarGrant Likely <grant.likely@linaro.org>
parent 2eb46da2
...@@ -67,14 +67,14 @@ struct device_node { ...@@ -67,14 +67,14 @@ struct device_node {
... ...
}; };
Figure 1, describes a generic structure of machines un-flattened device tree Figure 1, describes a generic structure of machine's un-flattened device tree
considering only child and sibling pointers. There exists another pointer, considering only child and sibling pointers. There exists another pointer,
*parent, that is used to traverse the tree in the reverse direction. So, at *parent, that is used to traverse the tree in the reverse direction. So, at
a particular level the child node and all the sibling nodes will have a parent a particular level the child node and all the sibling nodes will have a parent
pointer pointing to a common node (e.g. child1, sibling2, sibling3, sibling4s pointer pointing to a common node (e.g. child1, sibling2, sibling3, sibling4's
parent points to root node) parent points to root node)
root (‘/’) root ('/')
| |
child1 -> sibling2 -> sibling3 -> sibling4 -> null child1 -> sibling2 -> sibling3 -> sibling4 -> null
| | | | | | | |
...@@ -113,8 +113,8 @@ via the following kernel symbols: ...@@ -113,8 +113,8 @@ via the following kernel symbols:
__dtb_testcases_begin - address marking the start of test data blob __dtb_testcases_begin - address marking the start of test data blob
__dtb_testcases_end - address marking the end of test data blob __dtb_testcases_end - address marking the end of test data blob
Secondly, it calls of_fdt_unflatten_device_tree() to unflatten the flattened Secondly, it calls of_fdt_unflatten_tree() to unflatten the flattened
blob. And finally, if the machines device tree (i.e live tree) is present, blob. And finally, if the machine's device tree (i.e live tree) is present,
then it attaches the unflattened test data tree to the live tree, else it then it attaches the unflattened test data tree to the live tree, else it
attaches itself as a live device tree. attaches itself as a live device tree.
...@@ -122,7 +122,7 @@ attach_node_and_children() uses of_attach_node() to attach the nodes into the ...@@ -122,7 +122,7 @@ attach_node_and_children() uses of_attach_node() to attach the nodes into the
live tree as explained below. To explain the same, the test data tree described live tree as explained below. To explain the same, the test data tree described
in Figure 2 is attached to the live tree described in Figure 1. in Figure 2 is attached to the live tree described in Figure 1.
root (‘/’) root ('/')
| |
testcase-data testcase-data
| |
...@@ -138,8 +138,8 @@ root->testcase-data->test-child0->test-child01->test-sibling1->test-sibling2 ...@@ -138,8 +138,8 @@ root->testcase-data->test-child0->test-child01->test-sibling1->test-sibling2
Figure 2: Example test data tree to be attached to live tree. Figure 2: Example test data tree to be attached to live tree.
According to the scenario above, the live tree is already present so it isnt According to the scenario above, the live tree is already present so it isn't
required to attach the root(‘/’) node. All other nodes are attached by calling required to attach the root('/') node. All other nodes are attached by calling
of_attach_node() on each node. of_attach_node() on each node.
In the function of_attach_node(), the new node is attached as the child of the In the function of_attach_node(), the new node is attached as the child of the
...@@ -148,7 +148,7 @@ replaces the current child and turns it into its sibling. So, when the testcase ...@@ -148,7 +148,7 @@ replaces the current child and turns it into its sibling. So, when the testcase
data node is attached to the live tree above (Figure 1), the final structure is data node is attached to the live tree above (Figure 1), the final structure is
as shown in Figure 3. as shown in Figure 3.
root (‘/’) root ('/')
| |
testcase-data -> child1 -> sibling2 -> sibling3 -> sibling4 -> null testcase-data -> child1 -> sibling2 -> sibling3 -> sibling4 -> null
| | | | | | | | | |
...@@ -170,7 +170,7 @@ testcase-data -> child1 -> sibling2 -> sibling3 -> sibling4 -> null ...@@ -170,7 +170,7 @@ testcase-data -> child1 -> sibling2 -> sibling3 -> sibling4 -> null
null null
----------------------------------------------------------------------- -----------------------------------------------------------------------
root (‘/’) root ('/')
| |
testcase-data -> child1 -> sibling2 -> sibling3 -> sibling4 -> null testcase-data -> child1 -> sibling2 -> sibling3 -> sibling4 -> null
| | | | | | | | | |
...@@ -191,8 +191,8 @@ test-child0 the test-sibling1 is attached that pushes the child node ...@@ -191,8 +191,8 @@ test-child0 the test-sibling1 is attached that pushes the child node
as mentioned above. as mentioned above.
If a duplicate node is found (i.e. if a node with same full_name property is If a duplicate node is found (i.e. if a node with same full_name property is
already present in the live tree), then the node isnt attached rather its already present in the live tree), then the node isn't attached rather its
properties are updated to the live trees node by calling the function properties are updated to the live tree's node by calling the function
update_node_properties(). update_node_properties().
...@@ -205,7 +205,7 @@ whole tree). selftest_data_remove() calls detach_node_and_children() that uses ...@@ -205,7 +205,7 @@ whole tree). selftest_data_remove() calls detach_node_and_children() that uses
of_detach_node() to detach the nodes from the live device tree. of_detach_node() to detach the nodes from the live device tree.
To detach a node, of_detach_node() first updates all_next linked list, by To detach a node, of_detach_node() first updates all_next linked list, by
attaching the previous node’s allnext to current node’s allnext pointer. And attaching the previous node's allnext to current node's allnext pointer. And
then, it either updates the child pointer of given nodes parent to its then, it either updates the child pointer of given node's parent to its
sibling or attaches the previous sibling to the given nodes sibling, as sibling or attaches the previous sibling to the given node's sibling, as
appropriate. That is it :) appropriate. That is it :)
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment