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 */