2 * pcmcia_ioctl.c -- ioctl interface for cardmgr and cardctl
4 * This program is free software; you can redistribute it and/or modify
5 * it under the terms of the GNU General Public License version 2 as
6 * published by the Free Software Foundation.
8 * The initial developer of the original code is David A. Hinds
9 * <dahinds@users.sourceforge.net>. Portions created by David A. Hinds
10 * are Copyright (C) 1999 David A. Hinds. All Rights Reserved.
12 * (C) 1999 David A. Hinds
13 * (C) 2003 - 2004 Dominik Brodowski
17 * This file will go away soon.
21 #include <linux/kernel.h>
22 #include <linux/module.h>
23 #include <linux/init.h>
24 #include <linux/major.h>
25 #include <linux/errno.h>
26 #include <linux/ioctl.h>
27 #include <linux/proc_fs.h>
28 #include <linux/poll.h>
29 #include <linux/pci.h>
30 #include <linux/workqueue.h>
32 #define IN_CARD_SERVICES
33 #include <pcmcia/cs_types.h>
34 #include <pcmcia/cs.h>
35 #include <pcmcia/cistpl.h>
36 #include <pcmcia/ds.h>
37 #include <pcmcia/ss.h>
39 #include "cs_internal.h"
40 #include "ds_internal.h"
42 static int major_dev = -1;
45 /* Device user information */
47 #define USER_MAGIC 0x7ea4
48 #define CHECK_USER(u) \
49 (((u) == NULL) || ((u)->user_magic != USER_MAGIC))
51 typedef struct user_info_t {
53 int event_head, event_tail;
54 event_t event[MAX_EVENTS];
55 struct user_info_t *next;
56 struct pcmcia_socket *socket;
61 extern int ds_pc_debug;
62 #define cs_socket_name(skt) ((skt)->dev.class_id)
64 #define ds_dbg(lvl, fmt, arg...) do { \
65 if (ds_pc_debug >= lvl) \
66 printk(KERN_DEBUG "ds: " fmt , ## arg); \
69 #define ds_dbg(lvl, fmt, arg...) do { } while (0)
72 static struct pcmcia_device *get_pcmcia_device(struct pcmcia_socket *s,
73 unsigned int function)
75 struct pcmcia_device *p_dev = NULL;
78 spin_lock_irqsave(&pcmcia_dev_list_lock, flags);
79 list_for_each_entry(p_dev, &s->devices_list, socket_device_list) {
80 if (p_dev->func == function) {
81 spin_unlock_irqrestore(&pcmcia_dev_list_lock, flags);
82 return pcmcia_get_dev(p_dev);
85 spin_unlock_irqrestore(&pcmcia_dev_list_lock, flags);
89 /* backwards-compatible accessing of driver --- by name! */
91 static struct pcmcia_driver *get_pcmcia_driver(dev_info_t *dev_info)
93 struct device_driver *drv;
94 struct pcmcia_driver *p_drv;
96 drv = driver_find((char *) dev_info, &pcmcia_bus_type);
100 p_drv = container_of(drv, struct pcmcia_driver, drv);
106 #ifdef CONFIG_PROC_FS
107 static struct proc_dir_entry *proc_pccard = NULL;
109 static int proc_read_drivers_callback(struct device_driver *driver, void *d)
112 struct pcmcia_driver *p_drv = container_of(driver,
113 struct pcmcia_driver, drv);
115 *p += sprintf(*p, "%-24.24s 1 %d\n", p_drv->drv.name,
116 #ifdef CONFIG_MODULE_UNLOAD
117 (p_drv->owner) ? module_refcount(p_drv->owner) : 1
127 static int proc_read_drivers(char *buf, char **start, off_t pos,
128 int count, int *eof, void *data)
133 rc = bus_for_each_drv(&pcmcia_bus_type, NULL,
134 (void *) &p, proc_read_drivers_callback);
142 /*======================================================================
144 These manage a ring buffer of events pending for one user process
146 ======================================================================*/
149 static int queue_empty(user_info_t *user)
151 return (user->event_head == user->event_tail);
154 static event_t get_queued_event(user_info_t *user)
156 user->event_tail = (user->event_tail+1) % MAX_EVENTS;
157 return user->event[user->event_tail];
160 static void queue_event(user_info_t *user, event_t event)
162 user->event_head = (user->event_head+1) % MAX_EVENTS;
163 if (user->event_head == user->event_tail)
164 user->event_tail = (user->event_tail+1) % MAX_EVENTS;
165 user->event[user->event_head] = event;
168 void handle_event(struct pcmcia_socket *s, event_t event)
171 for (user = s->user; user; user = user->next)
172 queue_event(user, event);
173 wake_up_interruptible(&s->queue);
177 /*======================================================================
179 bind_request() and bind_device() are merged by now. Register_client()
180 is called right at the end of bind_request(), during the driver's
181 ->attach() call. Individual descriptions:
183 bind_request() connects a socket to a particular client driver.
184 It looks up the specified device ID in the list of registered
185 drivers, binds it to the socket, and tries to create an instance
186 of the device. unbind_request() deletes a driver instance.
188 Bind_device() associates a device driver with a particular socket.
189 It is normally called by Driver Services after it has identified
190 a newly inserted card. An instance of that driver will then be
191 eligible to register as a client of this socket.
193 Register_client() uses the dev_info_t handle to match the
194 caller with a socket. The driver must have already been bound
195 to a socket with bind_device() -- in fact, bind_device()
196 allocates the client structure that will be used.
198 ======================================================================*/
200 static int bind_request(struct pcmcia_socket *s, bind_info_t *bind_info)
202 struct pcmcia_driver *p_drv;
203 struct pcmcia_device *p_dev;
207 s = pcmcia_get_socket(s);
211 ds_dbg(2, "bind_request(%d, '%s')\n", s->sock,
212 (char *)bind_info->dev_info);
214 p_drv = get_pcmcia_driver(&bind_info->dev_info);
220 if (!try_module_get(p_drv->owner)) {
225 spin_lock_irqsave(&pcmcia_dev_list_lock, flags);
226 list_for_each_entry(p_dev, &s->devices_list, socket_device_list) {
227 if (p_dev->func == bind_info->function) {
228 if ((p_dev->dev.driver == &p_drv->drv)) {
229 if (p_dev->cardmgr) {
230 /* if there's already a device
231 * registered, and it was registered
232 * by userspace before, we need to
233 * return the "instance". */
234 spin_unlock_irqrestore(&pcmcia_dev_list_lock, flags);
235 bind_info->instance = p_dev;
239 /* the correct driver managed to bind
240 * itself magically to the correct
242 spin_unlock_irqrestore(&pcmcia_dev_list_lock, flags);
243 p_dev->cardmgr = p_drv;
247 } else if (!p_dev->dev.driver) {
248 /* there's already a device available where
249 * no device has been bound to yet. So we don't
250 * need to register a device! */
251 spin_unlock_irqrestore(&pcmcia_dev_list_lock, flags);
256 spin_unlock_irqrestore(&pcmcia_dev_list_lock, flags);
258 p_dev = pcmcia_device_add(s, bind_info->function);
265 p_dev->cardmgr = p_drv;
267 /* if a driver is already running, we can abort */
268 if (p_dev->dev.driver)
272 * Prevent this racing with a card insertion.
274 mutex_lock(&s->skt_mutex);
275 ret = bus_rescan_devices(&pcmcia_bus_type);
276 mutex_unlock(&s->skt_mutex);
280 /* check whether the driver indeed matched. I don't care if this
281 * is racy or not, because it can only happen on cardmgr access
284 if (!(p_dev->dev.driver == &p_drv->drv))
285 p_dev->cardmgr = NULL;
288 module_put(p_drv->owner);
290 put_driver(&p_drv->drv);
292 pcmcia_put_socket(s);
297 #ifdef CONFIG_CARDBUS
299 static struct pci_bus *pcmcia_lookup_bus(struct pcmcia_socket *s)
301 if (!s || !(s->state & SOCKET_CARDBUS))
304 return s->cb_dev->subordinate;
308 static int get_device_info(struct pcmcia_socket *s, bind_info_t *bind_info, int first)
311 struct pcmcia_device *p_dev;
312 struct pcmcia_driver *p_drv;
316 #ifdef CONFIG_CARDBUS
318 * Some unbelievably ugly code to associate the PCI cardbus
319 * device and its driver with the PCMCIA "bind" information.
324 bus = pcmcia_lookup_bus(s);
326 struct list_head *list;
327 struct pci_dev *dev = NULL;
329 list = bus->devices.next;
330 while (list != &bus->devices) {
331 struct pci_dev *pdev = pci_dev_b(list);
339 /* Try to handle "next" here some way? */
341 if (dev && dev->driver) {
342 strlcpy(bind_info->name, dev->driver->name, DEV_NAME_LEN);
343 bind_info->major = 0;
344 bind_info->minor = 0;
345 bind_info->next = NULL;
352 spin_lock_irqsave(&pcmcia_dev_list_lock, flags);
353 list_for_each_entry(p_dev, &s->devices_list, socket_device_list) {
354 if (p_dev->func == bind_info->function) {
355 p_dev = pcmcia_get_dev(p_dev);
361 spin_unlock_irqrestore(&pcmcia_dev_list_lock, flags);
365 spin_unlock_irqrestore(&pcmcia_dev_list_lock, flags);
367 p_drv = to_pcmcia_drv(p_dev->dev.driver);
368 if (p_drv && !p_dev->_locked) {
374 node = p_dev->dev_node;
376 for (node = p_dev->dev_node; node; node = node->next)
377 if (node == bind_info->next)
384 strlcpy(bind_info->name, node->dev_name, DEV_NAME_LEN);
385 bind_info->major = node->major;
386 bind_info->minor = node->minor;
387 bind_info->next = node->next;
390 pcmcia_put_dev(p_dev);
392 } /* get_device_info */
395 static int ds_open(struct inode *inode, struct file *file)
397 socket_t i = iminor(inode);
398 struct pcmcia_socket *s;
400 static int warning_printed = 0;
402 ds_dbg(0, "ds_open(socket %d)\n", i);
404 s = pcmcia_get_socket_by_nr(i);
407 s = pcmcia_get_socket(s);
411 if ((file->f_flags & O_ACCMODE) != O_RDONLY) {
412 if (s->pcmcia_state.busy) {
413 pcmcia_put_socket(s);
417 s->pcmcia_state.busy = 1;
420 user = kmalloc(sizeof(user_info_t), GFP_KERNEL);
422 pcmcia_put_socket(s);
425 user->event_tail = user->event_head = 0;
426 user->next = s->user;
427 user->user_magic = USER_MAGIC;
430 file->private_data = user;
432 if (!warning_printed) {
433 printk(KERN_INFO "pcmcia: Detected deprecated PCMCIA ioctl "
434 "usage from process: %s.\n", current->comm);
435 printk(KERN_INFO "pcmcia: This interface will soon be removed from "
436 "the kernel; please expect breakage unless you upgrade "
438 printk(KERN_INFO "pcmcia: see http://www.kernel.org/pub/linux/"
439 "utils/kernel/pcmcia/pcmcia.html for details.\n");
443 if (s->pcmcia_state.present)
444 queue_event(user, CS_EVENT_CARD_INSERTION);
448 /*====================================================================*/
450 static int ds_release(struct inode *inode, struct file *file)
452 struct pcmcia_socket *s;
453 user_info_t *user, **link;
455 ds_dbg(0, "ds_release(socket %d)\n", iminor(inode));
457 user = file->private_data;
458 if (CHECK_USER(user))
463 /* Unlink user data structure */
464 if ((file->f_flags & O_ACCMODE) != O_RDONLY) {
465 s->pcmcia_state.busy = 0;
467 file->private_data = NULL;
468 for (link = &s->user; *link; link = &(*link)->next)
469 if (*link == user) break;
473 user->user_magic = 0;
475 pcmcia_put_socket(s);
480 /*====================================================================*/
482 static ssize_t ds_read(struct file *file, char __user *buf,
483 size_t count, loff_t *ppos)
485 struct pcmcia_socket *s;
489 ds_dbg(2, "ds_read(socket %d)\n", iminor(file->f_dentry->d_inode));
494 user = file->private_data;
495 if (CHECK_USER(user))
499 if (s->pcmcia_state.dead)
502 ret = wait_event_interruptible(s->queue, !queue_empty(user));
504 ret = put_user(get_queued_event(user), (int __user *)buf) ? -EFAULT : 4;
509 /*====================================================================*/
511 static ssize_t ds_write(struct file *file, const char __user *buf,
512 size_t count, loff_t *ppos)
514 ds_dbg(2, "ds_write(socket %d)\n", iminor(file->f_dentry->d_inode));
518 if ((file->f_flags & O_ACCMODE) == O_RDONLY)
524 /*====================================================================*/
526 /* No kernel lock - fine */
527 static u_int ds_poll(struct file *file, poll_table *wait)
529 struct pcmcia_socket *s;
532 ds_dbg(2, "ds_poll(socket %d)\n", iminor(file->f_dentry->d_inode));
534 user = file->private_data;
535 if (CHECK_USER(user))
539 * We don't check for a dead socket here since that
540 * will send cardmgr into an endless spin.
542 poll_wait(file, &s->queue, wait);
543 if (!queue_empty(user))
544 return POLLIN | POLLRDNORM;
548 /*====================================================================*/
550 extern int pcmcia_adjust_resource_info(adjust_t *adj);
552 static int ds_ioctl(struct inode * inode, struct file * file,
553 u_int cmd, u_long arg)
555 struct pcmcia_socket *s;
556 void __user *uarg = (char __user *)arg;
562 ds_dbg(2, "ds_ioctl(socket %d, %#x, %#lx)\n", iminor(inode), cmd, arg);
564 user = file->private_data;
565 if (CHECK_USER(user))
569 if (s->pcmcia_state.dead)
572 size = (cmd & IOCSIZE_MASK) >> IOCSIZE_SHIFT;
573 if (size > sizeof(ds_ioctl_arg_t)) return -EINVAL;
575 /* Permission check */
576 if (!(cmd & IOC_OUT) && !capable(CAP_SYS_ADMIN))
580 if (!access_ok(VERIFY_READ, uarg, size)) {
581 ds_dbg(3, "ds_ioctl(): verify_read = %d\n", -EFAULT);
586 if (!access_ok(VERIFY_WRITE, uarg, size)) {
587 ds_dbg(3, "ds_ioctl(): verify_write = %d\n", -EFAULT);
591 buf = kmalloc(sizeof(ds_ioctl_arg_t), GFP_KERNEL);
597 if (cmd & IOC_IN) __copy_from_user((char *)buf, uarg, size);
600 case DS_ADJUST_RESOURCE_INFO:
601 ret = pcmcia_adjust_resource_info(&buf->adjust);
603 case DS_GET_CONFIGURATION_INFO:
604 if (buf->config.Function &&
605 (buf->config.Function >= s->functions))
608 struct pcmcia_device *p_dev = get_pcmcia_device(s, buf->config.Function);
609 ret = pccard_get_configuration_info(s, p_dev, &buf->config);
610 pcmcia_put_dev(p_dev);
613 case DS_GET_FIRST_TUPLE:
614 mutex_lock(&s->skt_mutex);
615 pcmcia_validate_mem(s);
616 mutex_unlock(&s->skt_mutex);
617 ret = pccard_get_first_tuple(s, BIND_FN_ALL, &buf->tuple);
619 case DS_GET_NEXT_TUPLE:
620 ret = pccard_get_next_tuple(s, BIND_FN_ALL, &buf->tuple);
622 case DS_GET_TUPLE_DATA:
623 buf->tuple.TupleData = buf->tuple_parse.data;
624 buf->tuple.TupleDataMax = sizeof(buf->tuple_parse.data);
625 ret = pccard_get_tuple_data(s, &buf->tuple);
628 buf->tuple.TupleData = buf->tuple_parse.data;
629 ret = pccard_parse_tuple(&buf->tuple, &buf->tuple_parse.parse);
632 ret = pccard_reset_card(s);
635 if (buf->status.Function &&
636 (buf->status.Function >= s->functions))
639 struct pcmcia_device *p_dev = get_pcmcia_device(s, buf->status.Function);
640 ret = pccard_get_status(s, p_dev, &buf->status);
641 pcmcia_put_dev(p_dev);
644 case DS_VALIDATE_CIS:
645 mutex_lock(&s->skt_mutex);
646 pcmcia_validate_mem(s);
647 mutex_unlock(&s->skt_mutex);
648 ret = pccard_validate_cis(s, BIND_FN_ALL, &buf->cisinfo);
650 case DS_SUSPEND_CARD:
651 ret = pcmcia_suspend_card(s);
654 ret = pcmcia_resume_card(s);
657 err = pcmcia_eject_card(s);
660 err = pcmcia_insert_card(s);
662 case DS_ACCESS_CONFIGURATION_REGISTER:
663 if ((buf->conf_reg.Action == CS_WRITE) && !capable(CAP_SYS_ADMIN)) {
670 if (!(buf->conf_reg.Function &&
671 (buf->conf_reg.Function >= s->functions))) {
672 struct pcmcia_device *p_dev = get_pcmcia_device(s, buf->conf_reg.Function);
674 ret = pcmcia_access_configuration_register(p_dev, &buf->conf_reg);
675 pcmcia_put_dev(p_dev);
679 case DS_GET_FIRST_REGION:
680 case DS_GET_NEXT_REGION:
682 if (!capable(CAP_SYS_ADMIN)) {
686 static int printed = 0;
688 printk(KERN_WARNING "2.6. kernels use pcmciamtd instead of memory_cs.c and do not require special\n");
689 printk(KERN_WARNING "MTD handling any more.\n");
696 case DS_GET_FIRST_WINDOW:
697 ret = pcmcia_get_window(s, &buf->win_info.handle, 0,
698 &buf->win_info.window);
700 case DS_GET_NEXT_WINDOW:
701 ret = pcmcia_get_window(s, &buf->win_info.handle,
702 buf->win_info.handle->index + 1, &buf->win_info.window);
704 case DS_GET_MEM_PAGE:
705 ret = pcmcia_get_mem_page(buf->win_info.handle,
709 ret = pcmcia_replace_cis(s, &buf->cisdump);
711 case DS_BIND_REQUEST:
712 if (!capable(CAP_SYS_ADMIN)) {
716 err = bind_request(s, &buf->bind_info);
718 case DS_GET_DEVICE_INFO:
719 err = get_device_info(s, &buf->bind_info, 1);
721 case DS_GET_NEXT_DEVICE:
722 err = get_device_info(s, &buf->bind_info, 0);
724 case DS_UNBIND_REQUEST:
731 if ((err == 0) && (ret != CS_SUCCESS)) {
732 ds_dbg(2, "ds_ioctl: ret = %d\n", ret);
734 case CS_BAD_SOCKET: case CS_NO_CARD:
735 err = -ENODEV; break;
736 case CS_BAD_ARGS: case CS_BAD_ATTRIBUTE: case CS_BAD_IRQ:
738 err = -EINVAL; break;
741 case CS_OUT_OF_RESOURCE:
742 err = -ENOSPC; break;
743 case CS_NO_MORE_ITEMS:
744 err = -ENODATA; break;
745 case CS_UNSUPPORTED_FUNCTION:
746 err = -ENOSYS; break;
753 if (__copy_to_user(uarg, (char *)buf, size))
762 /*====================================================================*/
764 static struct file_operations ds_fops = {
765 .owner = THIS_MODULE,
767 .release = ds_release,
774 void __init pcmcia_setup_ioctl(void) {
777 /* Set up character device for user mode clients */
778 i = register_chrdev(0, "pcmcia", &ds_fops);
780 printk(KERN_NOTICE "unable to find a free device # for "
781 "Driver Services (error=%d)\n", i);
785 #ifdef CONFIG_PROC_FS
786 proc_pccard = proc_mkdir("pccard", proc_bus);
788 create_proc_read_entry("drivers",0,proc_pccard,proc_read_drivers,NULL);
793 void __exit pcmcia_cleanup_ioctl(void) {
794 #ifdef CONFIG_PROC_FS
796 remove_proc_entry("drivers", proc_pccard);
797 remove_proc_entry("pccard", proc_bus);
801 unregister_chrdev(major_dev, "pcmcia");