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 inline 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 inline 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 inline 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 inline 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 inline 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 inline 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 inline 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];