1 /* $Id: tree.c,v 1.26 2000/08/26 02:38:03 anton Exp $
2 * tree.c: Basic device tree traversal/scanning for the Linux
5 * Copyright (C) 1995 David S. Miller (davem@caip.rutgers.edu)
8 #define PROMLIB_INTERNAL
10 #include <linux/string.h>
11 #include <linux/types.h>
12 #include <linux/kernel.h>
13 #include <linux/sched.h>
14 #include <linux/ctype.h>
16 #include <asm/openprom.h>
17 #include <asm/oplib.h>
19 extern void restore_current(void);
21 static char promlib_buf[128];
23 /* Internal version of prom_getchild that does not alter return values. */
24 int __prom_getchild(int node)
29 spin_lock_irqsave(&prom_lock, flags);
30 cnode = prom_nodeops->no_child(node);
32 spin_unlock_irqrestore(&prom_lock, flags);
37 /* Return the child of node 'node' or zero if no this node has no
40 int prom_getchild(int node)
47 cnode = __prom_getchild(node);
48 if (cnode == 0 || cnode == -1)
54 /* Internal version of prom_getsibling that does not alter return values. */
55 int __prom_getsibling(int node)
60 spin_lock_irqsave(&prom_lock, flags);
61 cnode = prom_nodeops->no_nextnode(node);
63 spin_unlock_irqrestore(&prom_lock, flags);
68 /* Return the next sibling of node 'node' or zero if no more siblings
69 * at this level of depth in the tree.
71 int prom_getsibling(int node)
78 sibnode = __prom_getsibling(node);
79 if (sibnode == 0 || sibnode == -1)
85 /* Return the length in bytes of property 'prop' at node 'node'.
88 int prom_getproplen(int node, char *prop)
93 if((!node) || (!prop))
96 spin_lock_irqsave(&prom_lock, flags);
97 ret = prom_nodeops->no_proplen(node, prop);
99 spin_unlock_irqrestore(&prom_lock, flags);
103 /* Acquire a property 'prop' at node 'node' and place it in
104 * 'buffer' which has a size of 'bufsize'. If the acquisition
105 * was successful the length will be returned, else -1 is returned.
107 int prom_getproperty(int node, char *prop, char *buffer, int bufsize)
112 plen = prom_getproplen(node, prop);
113 if((plen > bufsize) || (plen == 0) || (plen == -1))
115 /* Ok, things seem all right. */
116 spin_lock_irqsave(&prom_lock, flags);
117 ret = prom_nodeops->no_getprop(node, prop, buffer);
119 spin_unlock_irqrestore(&prom_lock, flags);
123 /* Acquire an integer property and return its value. Returns -1
126 int prom_getint(int node, char *prop)
130 if(prom_getproperty(node, prop, (char *) &intprop, sizeof(int)) != -1)
136 /* Acquire an integer property, upon error return the passed default
139 int prom_getintdefault(int node, char *property, int deflt)
143 retval = prom_getint(node, property);
144 if(retval == -1) return deflt;
149 /* Acquire a boolean property, 1=TRUE 0=FALSE. */
150 int prom_getbool(int node, char *prop)
154 retval = prom_getproplen(node, prop);
155 if(retval == -1) return 0;
159 /* Acquire a property whose value is a string, returns a null
160 * string on error. The char pointer is the user supplied string
163 void prom_getstring(int node, char *prop, char *user_buf, int ubuf_size)
167 len = prom_getproperty(node, prop, user_buf, ubuf_size);
168 if(len != -1) return;
174 /* Does the device at node 'node' have name 'name'?
177 int prom_nodematch(int node, char *name)
181 static char namebuf[128];
182 error = prom_getproperty(node, "name", namebuf, sizeof(namebuf));
183 if (error == -1) return 0;
184 if(strcmp(namebuf, name) == 0) return 1;
188 /* Search siblings at 'node_start' for a node with name
189 * 'nodename'. Return node if successful, zero if not.
191 int prom_searchsiblings(int node_start, char *nodename)
196 for(thisnode = node_start; thisnode;
197 thisnode=prom_getsibling(thisnode)) {
198 error = prom_getproperty(thisnode, "name", promlib_buf,
199 sizeof(promlib_buf));
200 /* Should this ever happen? */
201 if(error == -1) continue;
202 if(strcmp(nodename, promlib_buf)==0) return thisnode;
208 /* Gets name in the form prom v2+ uses it (name@x,yyyyy or name (if no reg)) */
209 int prom_getname (int node, char *buffer, int len)
212 struct linux_prom_registers reg[PROMREG_MAX];
214 i = prom_getproperty (node, "name", buffer, len);
215 if (i <= 0) return -1;
218 i = prom_getproperty (node, "reg", (char *)reg, sizeof (reg));
219 if (i <= 0) return 0;
220 if (len < 11) return -1;
221 buffer = strchr (buffer, 0);
222 sprintf (buffer, "@%x,%x", reg[0].which_io, (uint)reg[0].phys_addr);
226 /* Interal version of nextprop that does not alter return values. */
227 char * __prom_nextprop(int node, char * oprop)
232 spin_lock_irqsave(&prom_lock, flags);
233 prop = prom_nodeops->no_nextprop(node, oprop);
235 spin_unlock_irqrestore(&prom_lock, flags);
240 /* Return the first property name for node 'node'. */
241 /* buffer is unused argument, but as v9 uses it, we need to have the same interface */
242 char * prom_firstprop(int node, char *bufer)
244 if (node == 0 || node == -1)
247 return __prom_nextprop(node, "");
250 /* Return the property type string after property type 'oprop'
251 * at node 'node' . Returns empty string if no more
252 * property types for this node.
254 char * prom_nextprop(int node, char *oprop, char *buffer)
256 if (node == 0 || node == -1)
259 return __prom_nextprop(node, oprop);
262 int prom_finddevice(char *name)
266 int node = prom_root_node, node2;
267 unsigned int which_io, phys_addr;
268 struct linux_prom_registers reg[PROMREG_MAX];
271 if (!*s) return node; /* path '.../' is legal */
272 node = prom_getchild(node);
274 for (d = nbuf; *s != 0 && *s != '@' && *s != '/';)
278 node = prom_searchsiblings(node, nbuf);
283 if (isxdigit(s[1]) && s[2] == ',') {
284 which_io = simple_strtoul(s+1, NULL, 16);
285 phys_addr = simple_strtoul(s+3, &d, 16);
286 if (d != s + 3 && (!*d || *d == '/')
289 while (node2 && node2 != -1) {
290 if (prom_getproperty (node2, "reg", (char *)reg, sizeof (reg)) > 0) {
291 if (which_io == reg[0].which_io && phys_addr == reg[0].phys_addr) {
296 node2 = prom_getsibling(node2);
297 if (!node2 || node2 == -1)
299 node2 = prom_searchsiblings(prom_getsibling(node2), nbuf);
303 while (*s != 0 && *s != '/') s++;
309 int prom_node_has_property(int node, char *prop)
311 char *current_property = "";
314 current_property = prom_nextprop(node, current_property, NULL);
315 if(!strcmp(current_property, prop))
317 } while (*current_property);
321 /* Set property 'pname' at node 'node' to value 'value' which has a length
322 * of 'size' bytes. Return the number of bytes the prom accepted.
324 int prom_setprop(int node, char *pname, char *value, int size)
329 if(size == 0) return 0;
330 if((pname == 0) || (value == 0)) return 0;
331 spin_lock_irqsave(&prom_lock, flags);
332 ret = prom_nodeops->no_setprop(node, pname, value, size);
334 spin_unlock_irqrestore(&prom_lock, flags);
338 int prom_inst2pkg(int inst)
343 spin_lock_irqsave(&prom_lock, flags);
344 node = (*romvec->pv_v2devops.v2_inst2pkg)(inst);
346 spin_unlock_irqrestore(&prom_lock, flags);
347 if (node == -1) return 0;
351 /* Return 'node' assigned to a particular prom 'path'
352 * FIXME: Should work for v0 as well
354 int prom_pathtoinode(char *path)
358 inst = prom_devopen (path);
359 if (inst == -1) return 0;
360 node = prom_inst2pkg (inst);
361 prom_devclose (inst);
362 if (node == -1) return 0;