1 // SPDX-License-Identifier: GPL-2.0-or-later
3 * Linux/SPARC PROM Configuration Driver
7 * This character device driver allows user programs to access the
8 * PROM device tree. It is compatible with the SunOS /dev/openprom
9 * driver and the NetBSD /dev/openprom driver. The SunOS eeprom
10 * utility works without any modifications.
12 * The driver uses a minor number under the misc device major. The
13 * file read/write mode determines the type of access to the PROM.
14 * Interrupts are disabled whenever the driver calls into the PROM for
19 #include <linux/module.h>
20 #include <linux/kernel.h>
21 #include <linux/errno.h>
22 #include <linux/slab.h>
23 #include <linux/mutex.h>
24 #include <linux/string.h>
25 #include <linux/miscdevice.h>
26 #include <linux/init.h>
28 #include <asm/oplib.h>
30 #include <linux/uaccess.h>
31 #include <asm/openpromio.h>
33 #include <linux/pci.h>
37 MODULE_DESCRIPTION("OPENPROM Configuration Driver");
38 MODULE_LICENSE("GPL");
39 MODULE_VERSION("1.0");
40 MODULE_ALIAS_MISCDEV(SUN_OPENPROM_MINOR);
42 /* Private data kept by the driver for each descriptor. */
43 typedef struct openprom_private_data
45 struct device_node *current_node; /* Current node for SunOS ioctls. */
46 struct device_node *lastnode; /* Last valid node used by BSD ioctls. */
49 /* ID of the PROM node containing all of the EEPROM options. */
50 static DEFINE_MUTEX(openprom_mutex);
51 static struct device_node *options_node;
54 * Copy an openpromio structure into kernel space from user space.
55 * This routine does error checking to make sure that all memory
56 * accesses are within bounds. A pointer to the allocated openpromio
57 * structure will be placed in "*opp_p". Return value is the length
58 * of the user supplied buffer.
60 static int copyin(struct openpromio __user *info, struct openpromio **opp_p)
67 if (get_user(bufsize, &info->oprom_size))
73 /* If the bufsize is too large, just limit it.
74 * Fix from Jason Rappleye.
76 if (bufsize > OPROMMAXPARAM)
77 bufsize = OPROMMAXPARAM;
79 if (!(*opp_p = kzalloc(sizeof(int) + bufsize + 1, GFP_KERNEL)))
82 if (copy_from_user(&(*opp_p)->oprom_array,
83 &info->oprom_array, bufsize)) {
90 static int getstrings(struct openpromio __user *info, struct openpromio **opp_p)
98 if (!(*opp_p = kzalloc(sizeof(int) + OPROMMAXPARAM + 1, GFP_KERNEL)))
101 (*opp_p)->oprom_size = 0;
104 while ((n < 2) && (bufsize < OPROMMAXPARAM)) {
105 if (get_user(c, &info->oprom_array[bufsize])) {
111 (*opp_p)->oprom_array[bufsize++] = c;
121 * Copy an openpromio structure in kernel space back to user space.
123 static int copyout(void __user *info, struct openpromio *opp, int len)
125 if (copy_to_user(info, opp, len))
130 static int opromgetprop(void __user *argp, struct device_node *dp, struct openpromio *op, int bufsize)
136 !(pval = of_get_property(dp, op->oprom_array, &len)) ||
137 len <= 0 || len > bufsize)
138 return copyout(argp, op, sizeof(int));
140 memcpy(op->oprom_array, pval, len);
141 op->oprom_array[len] = '\0';
142 op->oprom_size = len;
144 return copyout(argp, op, sizeof(int) + bufsize);
147 static int opromnxtprop(void __user *argp, struct device_node *dp, struct openpromio *op, int bufsize)
149 struct property *prop;
153 return copyout(argp, op, sizeof(int));
154 if (op->oprom_array[0] == '\0') {
155 prop = dp->properties;
157 return copyout(argp, op, sizeof(int));
158 len = strlen(prop->name);
160 prop = of_find_property(dp, op->oprom_array, NULL);
164 (len = strlen(prop->next->name)) + 1 > bufsize)
165 return copyout(argp, op, sizeof(int));
170 memcpy(op->oprom_array, prop->name, len);
171 op->oprom_array[len] = '\0';
172 op->oprom_size = ++len;
174 return copyout(argp, op, sizeof(int) + bufsize);
177 static int opromsetopt(struct device_node *dp, struct openpromio *op, int bufsize)
179 char *buf = op->oprom_array + strlen(op->oprom_array) + 1;
180 int len = op->oprom_array + bufsize - buf;
182 return of_set_property(options_node, op->oprom_array, buf, len);
185 static int opromnext(void __user *argp, unsigned int cmd, struct device_node *dp, struct openpromio *op, int bufsize, DATA *data)
189 BUILD_BUG_ON(sizeof(phandle) != sizeof(int));
191 if (bufsize < sizeof(phandle))
194 ph = *((int *) op->oprom_array);
196 dp = of_find_node_by_phandle(ph);
214 /* Sibling of node zero is the root node. */
215 if (cmd != OPROMNEXT)
218 dp = of_find_node_by_path("/");
225 data->current_node = dp;
226 *((int *) op->oprom_array) = ph;
227 op->oprom_size = sizeof(phandle);
229 return copyout(argp, op, bufsize + sizeof(int));
232 static int oprompci2node(void __user *argp, struct device_node *dp, struct openpromio *op, int bufsize, DATA *data)
236 if (bufsize >= 2*sizeof(int)) {
238 struct pci_dev *pdev;
239 struct device_node *dp;
241 pdev = pci_get_domain_bus_and_slot(0,
242 ((int *) op->oprom_array)[0],
243 ((int *) op->oprom_array)[1]);
245 dp = pci_device_to_OF_node(pdev);
246 data->current_node = dp;
247 *((int *)op->oprom_array) = dp->phandle;
248 op->oprom_size = sizeof(int);
249 err = copyout(argp, op, bufsize + sizeof(int));
258 static int oprompath2node(void __user *argp, struct device_node *dp, struct openpromio *op, int bufsize, DATA *data)
262 dp = of_find_node_by_path(op->oprom_array);
265 data->current_node = dp;
266 *((int *)op->oprom_array) = ph;
267 op->oprom_size = sizeof(int);
269 return copyout(argp, op, bufsize + sizeof(int));
272 static int opromgetbootargs(void __user *argp, struct openpromio *op, int bufsize)
274 char *buf = saved_command_line;
275 int len = strlen(buf);
280 strcpy(op->oprom_array, buf);
281 op->oprom_size = len;
283 return copyout(argp, op, bufsize + sizeof(int));
287 * SunOS and Solaris /dev/openprom ioctl calls.
289 static long openprom_sunos_ioctl(struct file * file,
290 unsigned int cmd, unsigned long arg,
291 struct device_node *dp)
293 DATA *data = file->private_data;
294 struct openpromio *opp = NULL;
295 int bufsize, error = 0;
297 void __user *argp = (void __user *)arg;
299 if (cmd == OPROMSETOPT)
300 bufsize = getstrings(argp, &opp);
302 bufsize = copyin(argp, &opp);
307 mutex_lock(&openprom_mutex);
312 error = opromgetprop(argp, dp, opp, bufsize);
317 error = opromnxtprop(argp, dp, opp, bufsize);
322 error = opromsetopt(dp, opp, bufsize);
328 error = opromnext(argp, cmd, dp, opp, bufsize, data);
332 error = oprompci2node(argp, dp, opp, bufsize, data);
336 error = oprompath2node(argp, dp, opp, bufsize, data);
339 case OPROMGETBOOTARGS:
340 error = opromgetbootargs(argp, opp, bufsize);
347 printk(KERN_INFO "openprom_sunos_ioctl: unimplemented ioctl\n");
352 printk(KERN_INFO "openprom_sunos_ioctl: cmd 0x%X, arg 0x%lX\n", cmd, arg);
358 mutex_unlock(&openprom_mutex);
363 static struct device_node *get_node(phandle n, DATA *data)
365 struct device_node *dp = of_find_node_by_phandle(n);
373 /* Copy in a whole string from userspace into kernelspace. */
374 static char * copyin_string(char __user *user, size_t len)
376 if ((ssize_t)len < 0 || (ssize_t)(len + 1) < 0)
377 return ERR_PTR(-EINVAL);
379 return memdup_user_nul(user, len);
383 * NetBSD /dev/openprom ioctl calls.
385 static int opiocget(void __user *argp, DATA *data)
388 struct device_node *dp;
393 if (copy_from_user(&op, argp, sizeof(op)))
396 dp = get_node(op.op_nodeid, data);
398 str = copyin_string(op.op_name, op.op_namelen);
402 pval = of_get_property(dp, str, &len);
404 if (!pval || len > op.op_buflen) {
408 if (copy_to_user(argp, &op, sizeof(op)) ||
409 copy_to_user(op.op_buf, pval, len))
417 static int opiocnextprop(void __user *argp, DATA *data)
420 struct device_node *dp;
421 struct property *prop;
425 if (copy_from_user(&op, argp, sizeof(op)))
428 dp = get_node(op.op_nodeid, data);
432 str = copyin_string(op.op_name, op.op_namelen);
436 if (str[0] == '\0') {
437 prop = dp->properties;
439 prop = of_find_property(dp, str, NULL);
450 if (len > op.op_buflen)
453 if (copy_to_user(argp, &op, sizeof(op)))
457 copy_to_user(op.op_buf, prop->value, len))
463 static int opiocset(void __user *argp, DATA *data)
466 struct device_node *dp;
470 if (copy_from_user(&op, argp, sizeof(op)))
473 dp = get_node(op.op_nodeid, data);
477 str = copyin_string(op.op_name, op.op_namelen);
481 tmp = copyin_string(op.op_buf, op.op_buflen);
487 err = of_set_property(dp, str, tmp, op.op_buflen);
495 static int opiocgetnext(unsigned int cmd, void __user *argp)
497 struct device_node *dp;
500 BUILD_BUG_ON(sizeof(phandle) != sizeof(int));
502 if (copy_from_user(&nd, argp, sizeof(phandle)))
506 if (cmd != OPIOCGETNEXT)
508 dp = of_find_node_by_path("/");
510 dp = of_find_node_by_phandle(nd);
513 if (cmd == OPIOCGETNEXT)
521 if (copy_to_user(argp, &nd, sizeof(phandle)))
527 static int openprom_bsd_ioctl(struct file * file,
528 unsigned int cmd, unsigned long arg)
530 DATA *data = file->private_data;
531 void __user *argp = (void __user *)arg;
534 mutex_lock(&openprom_mutex);
537 err = opiocget(argp, data);
541 err = opiocnextprop(argp, data);
545 err = opiocset(argp, data);
548 case OPIOCGETOPTNODE:
549 BUILD_BUG_ON(sizeof(phandle) != sizeof(int));
552 if (copy_to_user(argp, &options_node->phandle, sizeof(phandle)))
558 err = opiocgetnext(cmd, argp);
565 mutex_unlock(&openprom_mutex);
572 * Handoff control to the correct ioctl handler.
574 static long openprom_ioctl(struct file * file,
575 unsigned int cmd, unsigned long arg)
577 DATA *data = file->private_data;
582 if ((file->f_mode & FMODE_READ) == 0)
584 return openprom_sunos_ioctl(file, cmd, arg,
589 if ((file->f_mode & FMODE_WRITE) == 0)
591 return openprom_sunos_ioctl(file, cmd, arg,
598 if ((file->f_mode & FMODE_READ) == 0)
600 return openprom_sunos_ioctl(file, cmd, arg,
606 case OPROMGETBOOTARGS:
610 if ((file->f_mode & FMODE_READ) == 0)
612 return openprom_sunos_ioctl(file, cmd, arg, NULL);
616 case OPIOCGETOPTNODE:
619 if ((file->f_mode & FMODE_READ) == 0)
621 return openprom_bsd_ioctl(file,cmd,arg);
624 if ((file->f_mode & FMODE_WRITE) == 0)
626 return openprom_bsd_ioctl(file,cmd,arg);
633 static long openprom_compat_ioctl(struct file *file, unsigned int cmd,
639 * SunOS/Solaris only, the NetBSD one's have embedded pointers in
640 * the arg which we'd need to clean up...
654 case OPROMGETBOOTARGS:
658 rval = openprom_ioctl(file, cmd, arg);
665 static int openprom_open(struct inode * inode, struct file * file)
669 data = kmalloc(sizeof(DATA), GFP_KERNEL);
673 mutex_lock(&openprom_mutex);
674 data->current_node = of_find_node_by_path("/");
675 data->lastnode = data->current_node;
676 file->private_data = (void *) data;
677 mutex_unlock(&openprom_mutex);
682 static int openprom_release(struct inode * inode, struct file * file)
684 kfree(file->private_data);
688 static const struct file_operations openprom_fops = {
689 .owner = THIS_MODULE,
691 .unlocked_ioctl = openprom_ioctl,
692 .compat_ioctl = openprom_compat_ioctl,
693 .open = openprom_open,
694 .release = openprom_release,
697 static struct miscdevice openprom_dev = {
698 .minor = SUN_OPENPROM_MINOR,
700 .fops = &openprom_fops,
703 static int __init openprom_init(void)
707 err = misc_register(&openprom_dev);
711 options_node = of_get_child_by_name(of_find_node_by_path("/"), "options");
713 misc_deregister(&openprom_dev);
720 static void __exit openprom_cleanup(void)
722 misc_deregister(&openprom_dev);
725 module_init(openprom_init);
726 module_exit(openprom_cleanup);