1 /*********************************************************************
3 * sir_dongle.c: manager for serial dongle protocol drivers
5 * Copyright (c) 2002 Martin Diehl
7 * This program is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU General Public License as
9 * published by the Free Software Foundation; either version 2 of
10 * the License, or (at your option) any later version.
12 ********************************************************************/
14 #include <linux/module.h>
15 #include <linux/kernel.h>
16 #include <linux/init.h>
17 #include <linux/smp_lock.h>
18 #include <linux/kmod.h>
19 #include <linux/mutex.h>
21 #include <net/irda/irda.h>
25 /**************************************************************************
27 * dongle registration and attachment
31 static LIST_HEAD(dongle_list); /* list of registered dongle drivers */
32 static DEFINE_MUTEX(dongle_list_lock); /* protects the list */
34 int irda_register_dongle(struct dongle_driver *new)
36 struct list_head *entry;
37 struct dongle_driver *drv;
39 IRDA_DEBUG(0, "%s : registering dongle \"%s\" (%d).\n",
40 __FUNCTION__, new->driver_name, new->type);
42 mutex_lock(&dongle_list_lock);
43 list_for_each(entry, &dongle_list) {
44 drv = list_entry(entry, struct dongle_driver, dongle_list);
45 if (new->type == drv->type) {
46 mutex_unlock(&dongle_list_lock);
50 list_add(&new->dongle_list, &dongle_list);
51 mutex_unlock(&dongle_list_lock);
54 EXPORT_SYMBOL(irda_register_dongle);
56 int irda_unregister_dongle(struct dongle_driver *drv)
58 mutex_lock(&dongle_list_lock);
59 list_del(&drv->dongle_list);
60 mutex_unlock(&dongle_list_lock);
63 EXPORT_SYMBOL(irda_unregister_dongle);
65 int sirdev_get_dongle(struct sir_dev *dev, IRDA_DONGLE type)
67 struct list_head *entry;
68 const struct dongle_driver *drv = NULL;
72 request_module("irda-dongle-%d", type);
75 if (dev->dongle_drv != NULL)
78 /* serialize access to the list of registered dongles */
79 mutex_lock(&dongle_list_lock);
81 list_for_each(entry, &dongle_list) {
82 drv = list_entry(entry, struct dongle_driver, dongle_list);
83 if (drv->type == type)
91 goto out_unlock; /* no such dongle */
94 /* handling of SMP races with dongle module removal - three cases:
95 * 1) dongle driver was already unregistered - then we haven't found the
96 * requested dongle above and are already out here
97 * 2) the module is already marked deleted but the driver is still
98 * registered - then the try_module_get() below will fail
99 * 3) the try_module_get() below succeeds before the module is marked
100 * deleted - then sys_delete_module() fails and prevents the removal
101 * because the module is in use.
104 if (!try_module_get(drv->owner)) {
106 goto out_unlock; /* rmmod already pending */
108 dev->dongle_drv = drv;
110 if (!drv->open || (err=drv->open(dev))!=0)
111 goto out_reject; /* failed to open driver */
113 mutex_unlock(&dongle_list_lock);
117 dev->dongle_drv = NULL;
118 module_put(drv->owner);
120 mutex_unlock(&dongle_list_lock);
124 int sirdev_put_dongle(struct sir_dev *dev)
126 const struct dongle_driver *drv = dev->dongle_drv;
130 drv->close(dev); /* close this dongle instance */
132 dev->dongle_drv = NULL; /* unlink the dongle driver */
133 module_put(drv->owner);/* decrement driver's module refcount */