1 /* 2 * tree.c: Basic device tree traversal/scanning for the Linux 3 * prom library. 4 * 5 * Copyright (C) 1995 David S. Miller (davem@caip.rutgers.edu) 6 * Copyright (C) 1996,1997 Jakub Jelinek (jj@sunsite.mff.cuni.cz) 7 */ 8 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> 14 15 #include <asm/openprom.h> 16 #include <asm/oplib.h> 17 #include <asm/ldc.h> 18 19 /* Return the child of node 'node' or zero if no this node has no 20 * direct descendent. 21 */ 22 inline int __prom_getchild(int node) 23 { 24 return p1275_cmd ("child", P1275_INOUT(1, 1), node); 25 } 26 27 inline int prom_getchild(int node) 28 { 29 int cnode; 30 31 if(node == -1) return 0; 32 cnode = __prom_getchild(node); 33 if(cnode == -1) return 0; 34 return (int)cnode; 35 } 36 EXPORT_SYMBOL(prom_getchild); 37 38 inline int prom_getparent(int node) 39 { 40 int cnode; 41 42 if(node == -1) return 0; 43 cnode = p1275_cmd ("parent", P1275_INOUT(1, 1), node); 44 if(cnode == -1) return 0; 45 return (int)cnode; 46 } 47 48 /* Return the next sibling of node 'node' or zero if no more siblings 49 * at this level of depth in the tree. 50 */ 51 inline int __prom_getsibling(int node) 52 { 53 return p1275_cmd(prom_peer_name, P1275_INOUT(1, 1), node); 54 } 55 56 inline int prom_getsibling(int node) 57 { 58 int sibnode; 59 60 if (node == -1) 61 return 0; 62 sibnode = __prom_getsibling(node); 63 if (sibnode == -1) 64 return 0; 65 66 return sibnode; 67 } 68 EXPORT_SYMBOL(prom_getsibling); 69 70 /* Return the length in bytes of property 'prop' at node 'node'. 71 * Return -1 on error. 72 */ 73 inline int prom_getproplen(int node, const char *prop) 74 { 75 if((!node) || (!prop)) return -1; 76 return p1275_cmd ("getproplen", 77 P1275_ARG(1,P1275_ARG_IN_STRING)| 78 P1275_INOUT(2, 1), 79 node, prop); 80 } 81 EXPORT_SYMBOL(prom_getproplen); 82 83 /* Acquire a property 'prop' at node 'node' and place it in 84 * 'buffer' which has a size of 'bufsize'. If the acquisition 85 * was successful the length will be returned, else -1 is returned. 86 */ 87 inline int prom_getproperty(int node, const char *prop, 88 char *buffer, int bufsize) 89 { 90 int plen; 91 92 plen = prom_getproplen(node, prop); 93 if ((plen > bufsize) || (plen == 0) || (plen == -1)) { 94 return -1; 95 } else { 96 /* Ok, things seem all right. */ 97 return p1275_cmd(prom_getprop_name, 98 P1275_ARG(1,P1275_ARG_IN_STRING)| 99 P1275_ARG(2,P1275_ARG_OUT_BUF)| 100 P1275_INOUT(4, 1), 101 node, prop, buffer, P1275_SIZE(plen)); 102 } 103 } 104 EXPORT_SYMBOL(prom_getproperty); 105 106 /* Acquire an integer property and return its value. Returns -1 107 * on failure. 108 */ 109 inline int prom_getint(int node, const char *prop) 110 { 111 int intprop; 112 113 if(prom_getproperty(node, prop, (char *) &intprop, sizeof(int)) != -1) 114 return intprop; 115 116 return -1; 117 } 118 EXPORT_SYMBOL(prom_getint); 119 120 /* Acquire an integer property, upon error return the passed default 121 * integer. 122 */ 123 124 int prom_getintdefault(int node, const char *property, int deflt) 125 { 126 int retval; 127 128 retval = prom_getint(node, property); 129 if(retval == -1) return deflt; 130 131 return retval; 132 } 133 EXPORT_SYMBOL(prom_getintdefault); 134 135 /* Acquire a boolean property, 1=TRUE 0=FALSE. */ 136 int prom_getbool(int node, const char *prop) 137 { 138 int retval; 139 140 retval = prom_getproplen(node, prop); 141 if(retval == -1) return 0; 142 return 1; 143 } 144 EXPORT_SYMBOL(prom_getbool); 145 146 /* Acquire a property whose value is a string, returns a null 147 * string on error. The char pointer is the user supplied string 148 * buffer. 149 */ 150 void prom_getstring(int node, const char *prop, char *user_buf, int ubuf_size) 151 { 152 int len; 153 154 len = prom_getproperty(node, prop, user_buf, ubuf_size); 155 if(len != -1) return; 156 user_buf[0] = 0; 157 return; 158 } 159 EXPORT_SYMBOL(prom_getstring); 160 161 /* Does the device at node 'node' have name 'name'? 162 * YES = 1 NO = 0 163 */ 164 int prom_nodematch(int node, const char *name) 165 { 166 char namebuf[128]; 167 prom_getproperty(node, "name", namebuf, sizeof(namebuf)); 168 if(strcmp(namebuf, name) == 0) return 1; 169 return 0; 170 } 171 172 /* Search siblings at 'node_start' for a node with name 173 * 'nodename'. Return node if successful, zero if not. 174 */ 175 int prom_searchsiblings(int node_start, const char *nodename) 176 { 177 178 int thisnode, error; 179 char promlib_buf[128]; 180 181 for(thisnode = node_start; thisnode; 182 thisnode=prom_getsibling(thisnode)) { 183 error = prom_getproperty(thisnode, "name", promlib_buf, 184 sizeof(promlib_buf)); 185 /* Should this ever happen? */ 186 if(error == -1) continue; 187 if(strcmp(nodename, promlib_buf)==0) return thisnode; 188 } 189 190 return 0; 191 } 192 EXPORT_SYMBOL(prom_searchsiblings); 193 194 /* Return the first property type for node 'node'. 195 * buffer should be at least 32B in length 196 */ 197 inline char *prom_firstprop(int node, char *buffer) 198 { 199 *buffer = 0; 200 if(node == -1) return buffer; 201 p1275_cmd ("nextprop", P1275_ARG(2,P1275_ARG_OUT_32B)| 202 P1275_INOUT(3, 0), 203 node, (char *) 0x0, buffer); 204 return buffer; 205 } 206 EXPORT_SYMBOL(prom_firstprop); 207 208 /* Return the property type string after property type 'oprop' 209 * at node 'node' . Returns NULL string if no more 210 * property types for this node. 211 */ 212 inline char *prom_nextprop(int node, const char *oprop, char *buffer) 213 { 214 char buf[32]; 215 216 if(node == -1) { 217 *buffer = 0; 218 return buffer; 219 } 220 if (oprop == buffer) { 221 strcpy (buf, oprop); 222 oprop = buf; 223 } 224 p1275_cmd ("nextprop", P1275_ARG(1,P1275_ARG_IN_STRING)| 225 P1275_ARG(2,P1275_ARG_OUT_32B)| 226 P1275_INOUT(3, 0), 227 node, oprop, buffer); 228 return buffer; 229 } 230 EXPORT_SYMBOL(prom_nextprop); 231 232 int 233 prom_finddevice(const char *name) 234 { 235 if (!name) 236 return 0; 237 return p1275_cmd(prom_finddev_name, 238 P1275_ARG(0,P1275_ARG_IN_STRING)| 239 P1275_INOUT(1, 1), 240 name); 241 } 242 EXPORT_SYMBOL(prom_finddevice); 243 244 int prom_node_has_property(int node, const char *prop) 245 { 246 char buf [32]; 247 248 *buf = 0; 249 do { 250 prom_nextprop(node, buf, buf); 251 if(!strcmp(buf, prop)) 252 return 1; 253 } while (*buf); 254 return 0; 255 } 256 EXPORT_SYMBOL(prom_node_has_property); 257 258 /* Set property 'pname' at node 'node' to value 'value' which has a length 259 * of 'size' bytes. Return the number of bytes the prom accepted. 260 */ 261 int 262 prom_setprop(int node, const char *pname, char *value, int size) 263 { 264 if (size == 0) 265 return 0; 266 if ((pname == 0) || (value == 0)) 267 return 0; 268 269 #ifdef CONFIG_SUN_LDOMS 270 if (ldom_domaining_enabled) { 271 ldom_set_var(pname, value); 272 return 0; 273 } 274 #endif 275 return p1275_cmd ("setprop", P1275_ARG(1,P1275_ARG_IN_STRING)| 276 P1275_ARG(2,P1275_ARG_IN_BUF)| 277 P1275_INOUT(4, 1), 278 node, pname, value, P1275_SIZE(size)); 279 } 280 EXPORT_SYMBOL(prom_setprop); 281 282 inline int prom_inst2pkg(int inst) 283 { 284 int node; 285 286 node = p1275_cmd ("instance-to-package", P1275_INOUT(1, 1), inst); 287 if (node == -1) return 0; 288 return node; 289 } 290 291 /* Return 'node' assigned to a particular prom 'path' 292 * FIXME: Should work for v0 as well 293 */ 294 int 295 prom_pathtoinode(const char *path) 296 { 297 int node, inst; 298 299 inst = prom_devopen (path); 300 if (inst == 0) return 0; 301 node = prom_inst2pkg (inst); 302 prom_devclose (inst); 303 if (node == -1) return 0; 304 return node; 305 } 306 307 int prom_ihandle2path(int handle, char *buffer, int bufsize) 308 { 309 return p1275_cmd("instance-to-path", 310 P1275_ARG(1,P1275_ARG_OUT_BUF)| 311 P1275_INOUT(3, 1), 312 handle, buffer, P1275_SIZE(bufsize)); 313 } 314