2 * tree.c: Basic device tree traversal/scanning for the Linux
5 * Copyright (C) 1995 David S. Miller (davem@caip.rutgers.edu)
6 * Copyright (C) 1996,1997 Jakub Jelinek (jj@sunsite.mff.cuni.cz)
9 #include <linux/string.h>
10 #include <linux/types.h>
11 #include <linux/kernel.h>
12 #include <linux/sched.h>
13 #include <linux/module.h>
15 #include <asm/openprom.h>
16 #include <asm/oplib.h>
19 static phandle prom_node_to_node(const char *type, phandle node)
21 unsigned long args[5];
23 args[0] = (unsigned long) type;
26 args[3] = (unsigned int) node;
27 args[4] = (unsigned long) -1;
29 p1275_cmd_direct(args);
31 return (phandle) args[4];
34 /* Return the child of node 'node' or zero if no this node has no
37 inline phandle __prom_getchild(phandle node)
39 return prom_node_to_node("child", node);
42 phandle prom_getchild(phandle node)
48 cnode = __prom_getchild(node);
53 EXPORT_SYMBOL(prom_getchild);
55 inline phandle prom_getparent(phandle node)
61 cnode = prom_node_to_node("parent", node);
67 /* Return the next sibling of node 'node' or zero if no more siblings
68 * at this level of depth in the tree.
70 inline phandle __prom_getsibling(phandle node)
72 return prom_node_to_node(prom_peer_name, node);
75 phandle prom_getsibling(phandle node)
81 sibnode = __prom_getsibling(node);
82 if ((s32)sibnode == -1)
87 EXPORT_SYMBOL(prom_getsibling);
89 /* Return the length in bytes of property 'prop' at node 'node'.
92 int prom_getproplen(phandle node, const char *prop)
94 unsigned long args[6];
99 args[0] = (unsigned long) "getproplen";
102 args[3] = (unsigned int) node;
103 args[4] = (unsigned long) prop;
104 args[5] = (unsigned long) -1;
106 p1275_cmd_direct(args);
108 return (int) args[5];
110 EXPORT_SYMBOL(prom_getproplen);
112 /* Acquire a property 'prop' at node 'node' and place it in
113 * 'buffer' which has a size of 'bufsize'. If the acquisition
114 * was successful the length will be returned, else -1 is returned.
116 int prom_getproperty(phandle node, const char *prop,
117 char *buffer, int bufsize)
119 unsigned long args[8];
122 plen = prom_getproplen(node, prop);
123 if ((plen > bufsize) || (plen == 0) || (plen == -1))
126 args[0] = (unsigned long) prom_getprop_name;
129 args[3] = (unsigned int) node;
130 args[4] = (unsigned long) prop;
131 args[5] = (unsigned long) buffer;
133 args[7] = (unsigned long) -1;
135 p1275_cmd_direct(args);
137 return (int) args[7];
139 EXPORT_SYMBOL(prom_getproperty);
141 /* Acquire an integer property and return its value. Returns -1
144 int prom_getint(phandle node, const char *prop)
148 if (prom_getproperty(node, prop, (char *) &intprop, sizeof(int)) != -1)
153 EXPORT_SYMBOL(prom_getint);
155 /* Acquire an integer property, upon error return the passed default
159 int prom_getintdefault(phandle node, const char *property, int deflt)
163 retval = prom_getint(node, property);
169 EXPORT_SYMBOL(prom_getintdefault);
171 /* Acquire a boolean property, 1=TRUE 0=FALSE. */
172 int prom_getbool(phandle node, const char *prop)
176 retval = prom_getproplen(node, prop);
181 EXPORT_SYMBOL(prom_getbool);
183 /* Acquire a property whose value is a string, returns a null
184 * string on error. The char pointer is the user supplied string
187 void prom_getstring(phandle node, const char *prop, char *user_buf,
192 len = prom_getproperty(node, prop, user_buf, ubuf_size);
197 EXPORT_SYMBOL(prom_getstring);
199 /* Does the device at node 'node' have name 'name'?
202 int prom_nodematch(phandle node, const char *name)
205 prom_getproperty(node, "name", namebuf, sizeof(namebuf));
206 if (strcmp(namebuf, name) == 0)
211 /* Search siblings at 'node_start' for a node with name
212 * 'nodename'. Return node if successful, zero if not.
214 phandle prom_searchsiblings(phandle node_start, const char *nodename)
218 char promlib_buf[128];
220 for(thisnode = node_start; thisnode;
221 thisnode=prom_getsibling(thisnode)) {
222 error = prom_getproperty(thisnode, "name", promlib_buf,
223 sizeof(promlib_buf));
224 /* Should this ever happen? */
225 if(error == -1) continue;
226 if(strcmp(nodename, promlib_buf)==0) return thisnode;
231 EXPORT_SYMBOL(prom_searchsiblings);
233 static const char *prom_nextprop_name = "nextprop";
235 /* Return the first property type for node 'node'.
236 * buffer should be at least 32B in length
238 char *prom_firstprop(phandle node, char *buffer)
240 unsigned long args[7];
246 args[0] = (unsigned long) prom_nextprop_name;
249 args[3] = (unsigned int) node;
251 args[5] = (unsigned long) buffer;
252 args[6] = (unsigned long) -1;
254 p1275_cmd_direct(args);
258 EXPORT_SYMBOL(prom_firstprop);
260 /* Return the property type string after property type 'oprop'
261 * at node 'node' . Returns NULL string if no more
262 * property types for this node.
264 char *prom_nextprop(phandle node, const char *oprop, char *buffer)
266 unsigned long args[7];
269 if ((s32)node == -1) {
273 if (oprop == buffer) {
278 args[0] = (unsigned long) prom_nextprop_name;
281 args[3] = (unsigned int) node;
282 args[4] = (unsigned long) oprop;
283 args[5] = (unsigned long) buffer;
284 args[6] = (unsigned long) -1;
286 p1275_cmd_direct(args);
290 EXPORT_SYMBOL(prom_nextprop);
292 phandle prom_finddevice(const char *name)
294 unsigned long args[5];
298 args[0] = (unsigned long) "finddevice";
301 args[3] = (unsigned long) name;
302 args[4] = (unsigned long) -1;
304 p1275_cmd_direct(args);
306 return (int) args[4];
308 EXPORT_SYMBOL(prom_finddevice);
310 int prom_node_has_property(phandle node, const char *prop)
316 prom_nextprop(node, buf, buf);
317 if (!strcmp(buf, prop))
322 EXPORT_SYMBOL(prom_node_has_property);
324 /* Set property 'pname' at node 'node' to value 'value' which has a length
325 * of 'size' bytes. Return the number of bytes the prom accepted.
328 prom_setprop(phandle node, const char *pname, char *value, int size)
330 unsigned long args[8];
334 if ((pname == 0) || (value == 0))
337 #ifdef CONFIG_SUN_LDOMS
338 if (ldom_domaining_enabled) {
339 ldom_set_var(pname, value);
343 args[0] = (unsigned long) "setprop";
346 args[3] = (unsigned int) node;
347 args[4] = (unsigned long) pname;
348 args[5] = (unsigned long) value;
350 args[7] = (unsigned long) -1;
352 p1275_cmd_direct(args);
354 return (int) args[7];
356 EXPORT_SYMBOL(prom_setprop);
358 inline phandle prom_inst2pkg(int inst)
360 unsigned long args[5];
363 args[0] = (unsigned long) "instance-to-package";
366 args[3] = (unsigned int) inst;
367 args[4] = (unsigned long) -1;
369 p1275_cmd_direct(args);
371 node = (int) args[4];
377 int prom_ihandle2path(int handle, char *buffer, int bufsize)
379 unsigned long args[7];
381 args[0] = (unsigned long) "instance-to-path";
384 args[3] = (unsigned int) handle;
385 args[4] = (unsigned long) buffer;
387 args[6] = (unsigned long) -1;
389 p1275_cmd_direct(args);
391 return (int) args[6];