arch/sparc/prom/tree_64.c

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