WebSVN – HelenOS – Diff – /trunk/kernel/genarch/src/ofw/ofw_tree.c



    ofw_root = root;
}
 
/** Get OpenFirmware node property.
 *
 * @param node      Node in which to lookup the property.
 * @param name      Name of the property.
 *
 * @return      Pointer to the property structure or NULL if no such
 *          property.
 */
ofw_tree_property_t *
ofw_tree_getprop(const ofw_tree_node_t *node, const char *name)
{
    unsigned int i;
   
    for (i = 0; i < node->properties; i++) {
        if (strcmp(node->property[i].name, name) == 0)

    return NULL;
}
 
/** Return value of the 'name' property.
 *
 * @param node      Node of interest.
 *
 * @return      Value of the 'name' property belonging to the node.
 */
const char *ofw_tree_node_name(const ofw_tree_node_t *node)
{
    ofw_tree_property_t *prop;
   

    return prop->value;
}
 
/** Lookup child of given name.
 *
 * @param node      Node whose child is being looked up.
 * @param name      Name of the child being looked up.
 *
 * @return      NULL if there is no such child or pointer to the
 *          matching child node.
 */
ofw_tree_node_t *ofw_tree_find_child(ofw_tree_node_t *node, const char *name)
{
    ofw_tree_node_t *cur;
   

    return NULL;
}
 
/** Lookup first child of given device type.
 *
 * @param node      Node whose child is being looked up.
 * @param name      Device type of the child being looked up.
 *
 * @return      NULL if there is no such child or pointer to the
 *          matching child node.
 */
ofw_tree_node_t *
ofw_tree_find_child_by_device_type(ofw_tree_node_t *node, const char *name)
{
    ofw_tree_node_t *cur;
    ofw_tree_property_t *prop;
   
    for (cur = node->child; cur; cur = cur->peer) {

/** Lookup node with matching node_handle.
 *
 * Child nodes are looked up recursively contrary to peer nodes that
 * are looked up iteratively to avoid stack overflow.
 *
 * @param root      Root of the searched subtree.
 * @param handle    OpenFirmware handle.
 *
 * @return      NULL if there is no such node or pointer to the matching
 *          node.
 */
ofw_tree_node_t *
ofw_tree_find_node_by_handle(ofw_tree_node_t *root, uint32_t handle)
{
    ofw_tree_node_t *cur;
 
    for (cur = root; cur; cur = cur->peer) {       
        if (cur->node_handle == handle)

    return NULL;   
}
 
/** Lookup first peer of given device type.
 *
 * @param node      Node whose peer is being looked up.
 * @param name      Device type of the child being looked up.
 *
 * @return      NULL if there is no such child or pointer to the
 *          matching child node.
 */
ofw_tree_node_t *
ofw_tree_find_peer_by_device_type(ofw_tree_node_t *node, const char *name)
{
    ofw_tree_node_t *cur;
    ofw_tree_property_t *prop;
   
    for (cur = node->peer; cur; cur = cur->peer) {

           
    return NULL;
}
 
 
/** Lookup first peer of given name.
 *
 * @param node      Node whose peer is being looked up.
 * @param name      Name of the child being looked up.
 *
 * @return      NULL if there is no such peer or pointer to the matching
 *          peer node.
 */
ofw_tree_node_t *
ofw_tree_find_peer_by_name(ofw_tree_node_t *node, const char *name)
{
    ofw_tree_node_t *cur;
    ofw_tree_property_t *prop;
   
    for (cur = node->peer; cur; cur = cur->peer) {
        prop = ofw_tree_getprop(cur, "name");
        if (!prop || !prop->value)
            continue;
        if (strcmp(prop->value, name) == 0)
            return cur;
    }
           
    return NULL;
}
 
/** Lookup OpenFirmware node by its path.
 *
 * @param path      Path to the node.
 *
 * @return      NULL if there is no such node or pointer to the leaf
 *          node.
 */
ofw_tree_node_t *ofw_tree_lookup(const char *path)
{
    char buf[NAME_BUF_LEN + 1];
    ofw_tree_node_t *node = ofw_root;
    index_t i, j;
   
    if (path[0] != '/')
        return NULL;

/** Print OpenFirmware device subtree rooted in a node.
 *
 * Child nodes are processed recursively and peer nodes are processed
 * iteratively in order to avoid stack overflow.
 *
 * @param node      Root of the subtree.
 * @param path      Current path, NULL for the very root of the entire tree.
 */
static void ofw_tree_node_print(const ofw_tree_node_t *node, const char *path)
{
    char *p;
    const ofw_tree_node_t *cur;

Rev 2745	Rev 3672
Line 52...	Line 52...
52	ofw_root = root;	52	ofw_root = root;
53	}	53	}
54		54
55	/** Get OpenFirmware node property.	55	/** Get OpenFirmware node property.
56	*	56	*
57	* @param node Node in which to lookup the property.	57	* @param node Node in which to lookup the property.
58	* @param name Name of the property.	58	* @param name Name of the property.
59	*	59	*
60	* @return Pointer to the property structure or NULL if no such property.	60	* @return Pointer to the property structure or NULL if no such
-		61	* property.
61	*/	62	*/
-		63	ofw_tree_property_t *
62	ofw_tree_property_t ofw_tree_getprop(const ofw_tree_node_t node, const char *name)	64	ofw_tree_getprop(const ofw_tree_node_t node, const char name)
63	{	65	{
64	unsigned int i;	66	unsigned int i;
65		67
66	for (i = 0; i < node->properties; i++) {	68	for (i = 0; i < node->properties; i++) {
67	if (strcmp(node->property[i].name, name) == 0)	69	if (strcmp(node->property[i].name, name) == 0)
Line 71...	Line 73...
71	return NULL;	73	return NULL;
72	}	74	}
73		75
74	/** Return value of the 'name' property.	76	/** Return value of the 'name' property.
75	*	77	*
76	* @param node Node of interest.	78	* @param node Node of interest.
77	*	79	*
78	* @return Value of the 'name' property belonging to the node.	80	* @return Value of the 'name' property belonging to the node.
79	*/	81	*/
80	const char ofw_tree_node_name(const ofw_tree_node_t node)	82	const char ofw_tree_node_name(const ofw_tree_node_t node)
81	{	83	{
82	ofw_tree_property_t *prop;	84	ofw_tree_property_t *prop;
83		85
Line 91...	Line 93...
91	return prop->value;	93	return prop->value;
92	}	94	}
93		95
94	/** Lookup child of given name.	96	/** Lookup child of given name.
95	*	97	*
96	* @param node Node whose child is being looked up.	98	* @param node Node whose child is being looked up.
97	* @param name Name of the child being looked up.	99	* @param name Name of the child being looked up.
98	*	100	*
99	* @return NULL if there is no such child or pointer to the matching child node.	101	* @return NULL if there is no such child or pointer to the
-		102	* matching child node.
100	*/	103	*/
101	ofw_tree_node_t ofw_tree_find_child(ofw_tree_node_t node, const char *name)	104	ofw_tree_node_t ofw_tree_find_child(ofw_tree_node_t node, const char *name)
102	{	105	{
103	ofw_tree_node_t *cur;	106	ofw_tree_node_t *cur;
104		107
Line 125...	Line 128...
125	return NULL;	128	return NULL;
126	}	129	}
127		130
128	/** Lookup first child of given device type.	131	/** Lookup first child of given device type.
129	*	132	*
130	* @param node Node whose child is being looked up.	133	* @param node Node whose child is being looked up.
131	* @param name Device type of the child being looked up.	134	* @param name Device type of the child being looked up.
132	*	135	*
133	* @return NULL if there is no such child or pointer to the matching child node.	136	* @return NULL if there is no such child or pointer to the
-		137	* matching child node.
134	*/	138	*/
-		139	ofw_tree_node_t *
135	ofw_tree_node_t ofw_tree_find_child_by_device_type(ofw_tree_node_t node, const char *name)	140	ofw_tree_find_child_by_device_type(ofw_tree_node_t node, const char name)
136	{	141	{
137	ofw_tree_node_t *cur;	142	ofw_tree_node_t *cur;
138	ofw_tree_property_t *prop;	143	ofw_tree_property_t *prop;
139		144
140	for (cur = node->child; cur; cur = cur->peer) {	145	for (cur = node->child; cur; cur = cur->peer) {
Line 151...	Line 156...
151	/** Lookup node with matching node_handle.	156	/** Lookup node with matching node_handle.
152	*	157	*
153	* Child nodes are looked up recursively contrary to peer nodes that	158	* Child nodes are looked up recursively contrary to peer nodes that
154	* are looked up iteratively to avoid stack overflow.	159	* are looked up iteratively to avoid stack overflow.
155	*	160	*
156	* @param root Root of the searched subtree.	161	* @param root Root of the searched subtree.
157	* @param handle OpenFirmware handle.	162	* @param handle OpenFirmware handle.
158	*	163	*
159	* @return NULL if there is no such node or pointer to the matching node.	164	* @return NULL if there is no such node or pointer to the matching
-		165	* node.
160	*/	166	*/
-		167	ofw_tree_node_t *
161	ofw_tree_node_t ofw_tree_find_node_by_handle(ofw_tree_node_t root, uint32_t handle)	168	ofw_tree_find_node_by_handle(ofw_tree_node_t *root, uint32_t handle)
162	{	169	{
163	ofw_tree_node_t *cur;	170	ofw_tree_node_t *cur;
164		171
165	for (cur = root; cur; cur = cur->peer) {	172	for (cur = root; cur; cur = cur->peer) {
166	if (cur->node_handle == handle)	173	if (cur->node_handle == handle)
Line 178...	Line 185...
178	return NULL;	185	return NULL;
179	}	186	}
180		187
181	/** Lookup first peer of given device type.	188	/** Lookup first peer of given device type.
182	*	189	*
183	* @param node Node whose peer is being looked up.	190	* @param node Node whose peer is being looked up.
184	* @param name Device type of the child being looked up.	191	* @param name Device type of the child being looked up.
185	*	192	*
186	* @return NULL if there is no such child or pointer to the matching child node.	193	* @return NULL if there is no such child or pointer to the
-		194	* matching child node.
187	*/	195	*/
-		196	ofw_tree_node_t *
188	ofw_tree_node_t ofw_tree_find_peer_by_device_type(ofw_tree_node_t node, const char *name)	197	ofw_tree_find_peer_by_device_type(ofw_tree_node_t node, const char name)
189	{	198	{
190	ofw_tree_node_t *cur;	199	ofw_tree_node_t *cur;
191	ofw_tree_property_t *prop;	200	ofw_tree_property_t *prop;
192		201
193	for (cur = node->peer; cur; cur = cur->peer) {	202	for (cur = node->peer; cur; cur = cur->peer) {
Line 200...	Line 209...
200		209
201	return NULL;	210	return NULL;
202	}	211	}
203		212
204		213
-		214	/** Lookup first peer of given name.
-		215	*
-		216	* @param node Node whose peer is being looked up.
-		217	* @param name Name of the child being looked up.
-		218	*
-		219	* @return NULL if there is no such peer or pointer to the matching
-		220	* peer node.
-		221	*/
-		222	ofw_tree_node_t *
-		223	ofw_tree_find_peer_by_name(ofw_tree_node_t node, const char name)
-		224	{
-		225	ofw_tree_node_t *cur;
-		226	ofw_tree_property_t *prop;
-		227
-		228	for (cur = node->peer; cur; cur = cur->peer) {
-		229	prop = ofw_tree_getprop(cur, "name");
-		230	if (!prop \|\| !prop->value)
-		231	continue;
-		232	if (strcmp(prop->value, name) == 0)
-		233	return cur;
-		234	}
-		235
-		236	return NULL;
-		237	}
-		238
205	/** Lookup OpenFirmware node by its path.	239	/** Lookup OpenFirmware node by its path.
206	*	240	*
207	* @param path Path to the node.	241	* @param path Path to the node.
208	*	242	*
209	* @return NULL if there is no such node or pointer to the leaf node.	243	* @return NULL if there is no such node or pointer to the leaf
-		244	* node.
210	*/	245	*/
211	ofw_tree_node_t ofw_tree_lookup(const char path)	246	ofw_tree_node_t ofw_tree_lookup(const char path)
212	{	247	{
213	char buf[NAME_BUF_LEN+1];	248	char buf[NAME_BUF_LEN + 1];
214	ofw_tree_node_t *node = ofw_root;	249	ofw_tree_node_t *node = ofw_root;
215	index_t i, j;	250	index_t i, j;
216		251
217	if (path[0] != '/')	252	if (path[0] != '/')
218	return NULL;	253	return NULL;
Line 234...	Line 269...
234	/** Print OpenFirmware device subtree rooted in a node.	269	/** Print OpenFirmware device subtree rooted in a node.
235	*	270	*
236	* Child nodes are processed recursively and peer nodes are processed	271	* Child nodes are processed recursively and peer nodes are processed
237	* iteratively in order to avoid stack overflow.	272	* iteratively in order to avoid stack overflow.
238	*	273	*
239	* @param node Root of the subtree.	274	* @param node Root of the subtree.
240	* @param path Current path, NULL for the very root of the entire tree.	275	* @param path Current path, NULL for the very root of the entire tree.
241	*/	276	*/
242	static void ofw_tree_node_print(const ofw_tree_node_t node, const char path)	277	static void ofw_tree_node_print(const ofw_tree_node_t node, const char path)
243	{	278	{
244	char *p;	279	char *p;
245	const ofw_tree_node_t *cur;	280	const ofw_tree_node_t *cur;

Subversion Repositories HelenOS

(root)/trunk/kernel/genarch/src/ofw/ofw_tree.c – Rev 2745 → 3672