1 // SPDX-License-Identifier: GPL-2.0-or-later
3 * Linux/SPARC PROM Configuration Driver
4 * Copyright (C) 1996 Thomas K. Dyas (tdyas@noc.rutgers.edu)
5 * Copyright (C) 1996 Eddie C. Dost (ecd@skynet.be)
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>
36 MODULE_AUTHOR("Thomas K. Dyas (tdyas@noc.rutgers.edu) and Eddie C. Dost (ecd@skynet.be)");
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
);