git.oblomov.eu Git - linux-2.6/blob - net/rfkill/rfkill.c

   1 /*
   2  * Copyright (C) 2006 - 2007 Ivo van Doorn
   3  * Copyright (C) 2007 Dmitry Torokhov
   4  *
   5  * This program is free software; you can redistribute it and/or modify
   6  * it under the terms of the GNU General Public License as published by
   7  * the Free Software Foundation; either version 2 of the License, or
   8  * (at your option) any later version.
   9  *
  10  * This program is distributed in the hope that it will be useful,
  11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  13  * GNU General Public License for more details.
  14  *
  15  * You should have received a copy of the GNU General Public License
  16  * along with this program; if not, write to the
  17  * Free Software Foundation, Inc.,
  18  * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
  19  */
  20
  21 #include <linux/kernel.h>
  22 #include <linux/module.h>
  23 #include <linux/init.h>
  24 #include <linux/workqueue.h>
  25 #include <linux/capability.h>
  26 #include <linux/list.h>
  27 #include <linux/mutex.h>
  28 #include <linux/rfkill.h>
  29
  30 /* Get declaration of rfkill_switch_all() to shut up sparse. */
  31 #include "rfkill-input.h"
  32
  33
  34 MODULE_AUTHOR("Ivo van Doorn <IvDoorn@gmail.com>");
  35 MODULE_VERSION("1.0");
  36 MODULE_DESCRIPTION("RF switch support");
  37 MODULE_LICENSE("GPL");
  38
  39 static LIST_HEAD(rfkill_list);  /* list of registered rf switches */
  40 static DEFINE_MUTEX(rfkill_global_mutex);
  41
  42 static unsigned int rfkill_default_state = RFKILL_STATE_UNBLOCKED;
  43 module_param_named(default_state, rfkill_default_state, uint, 0444);
  44 MODULE_PARM_DESC(default_state,
  45                  "Default initial state for all radio types, 0 = radio off");
  46
  47 struct rfkill_gsw_state {
  48         enum rfkill_state current_state;
  49         enum rfkill_state default_state;
  50 };
  51
  52 static struct rfkill_gsw_state rfkill_global_states[RFKILL_TYPE_MAX];
  53 static unsigned long rfkill_states_lockdflt[BITS_TO_LONGS(RFKILL_TYPE_MAX)];
  54
  55 static BLOCKING_NOTIFIER_HEAD(rfkill_notifier_list);
  56
  57
  58 /**
  59  * register_rfkill_notifier - Add notifier to rfkill notifier chain
  60  * @nb: pointer to the new entry to add to the chain
  61  *
  62  * See blocking_notifier_chain_register() for return value and further
  63  * observations.
  64  *
  65  * Adds a notifier to the rfkill notifier chain.  The chain will be
  66  * called with a pointer to the relevant rfkill structure as a parameter,
  67  * refer to include/linux/rfkill.h for the possible events.
  68  *
  69  * Notifiers added to this chain are to always return NOTIFY_DONE.  This
  70  * chain is a blocking notifier chain: notifiers can sleep.
  71  *
  72  * Calls to this chain may have been done through a workqueue.  One must
  73  * assume unordered asynchronous behaviour, there is no way to know if
  74  * actions related to the event that generated the notification have been
  75  * carried out already.
  76  */
  77 int register_rfkill_notifier(struct notifier_block *nb)
  78 {
  79         BUG_ON(!nb);
  80         return blocking_notifier_chain_register(&rfkill_notifier_list, nb);
  81 }
  82 EXPORT_SYMBOL_GPL(register_rfkill_notifier);
  83
  84 /**
  85  * unregister_rfkill_notifier - remove notifier from rfkill notifier chain
  86  * @nb: pointer to the entry to remove from the chain
  87  *
  88  * See blocking_notifier_chain_unregister() for return value and further
  89  * observations.
  90  *
  91  * Removes a notifier from the rfkill notifier chain.
  92  */
  93 int unregister_rfkill_notifier(struct notifier_block *nb)
  94 {
  95         BUG_ON(!nb);
  96         return blocking_notifier_chain_unregister(&rfkill_notifier_list, nb);
  97 }
  98 EXPORT_SYMBOL_GPL(unregister_rfkill_notifier);
  99
 100
 101 static void rfkill_led_trigger(struct rfkill *rfkill,
 102                                enum rfkill_state state)
 103 {
 104 #ifdef CONFIG_RFKILL_LEDS
 105         struct led_trigger *led = &rfkill->led_trigger;
 106
 107         if (!led->name)
 108                 return;
 109         if (state != RFKILL_STATE_UNBLOCKED)
 110                 led_trigger_event(led, LED_OFF);
 111         else
 112                 led_trigger_event(led, LED_FULL);
 113 #endif /* CONFIG_RFKILL_LEDS */
 114 }
 115
 116 #ifdef CONFIG_RFKILL_LEDS
 117 static void rfkill_led_trigger_activate(struct led_classdev *led)
 118 {
 119         struct rfkill *rfkill = container_of(led->trigger,
 120                         struct rfkill, led_trigger);
 121
 122         rfkill_led_trigger(rfkill, rfkill->state);
 123 }
 124 #endif /* CONFIG_RFKILL_LEDS */
 125
 126 static void notify_rfkill_state_change(struct rfkill *rfkill)
 127 {
 128         blocking_notifier_call_chain(&rfkill_notifier_list,
 129                         RFKILL_STATE_CHANGED,
 130                         rfkill);
 131 }
 132
 133 static void update_rfkill_state(struct rfkill *rfkill)
 134 {
 135         enum rfkill_state newstate, oldstate;
 136
 137         if (rfkill->get_state) {
 138                 mutex_lock(&rfkill->mutex);
 139                 if (!rfkill->get_state(rfkill->data, &newstate)) {
 140                         oldstate = rfkill->state;
 141                         rfkill->state = newstate;
 142                         if (oldstate != newstate)
 143                                 notify_rfkill_state_change(rfkill);
 144                 }
 145                 mutex_unlock(&rfkill->mutex);
 146         }
 147 }
 148
 149 /**
 150  * rfkill_toggle_radio - wrapper for toggle_radio hook
 151  * @rfkill: the rfkill struct to use
 152  * @force: calls toggle_radio even if cache says it is not needed,
 153  *      and also makes sure notifications of the state will be
 154  *      sent even if it didn't change
 155  * @state: the new state to call toggle_radio() with
 156  *
 157  * Calls rfkill->toggle_radio, enforcing the API for toggle_radio
 158  * calls and handling all the red tape such as issuing notifications
 159  * if the call is successful.
 160  *
 161  * Suspended devices are not touched at all, and -EAGAIN is returned.
 162  *
 163  * Note that the @force parameter cannot override a (possibly cached)
 164  * state of RFKILL_STATE_HARD_BLOCKED.  Any device making use of
 165  * RFKILL_STATE_HARD_BLOCKED implements either get_state() or
 166  * rfkill_force_state(), so the cache either is bypassed or valid.
 167  *
 168  * Note that we do call toggle_radio for RFKILL_STATE_SOFT_BLOCKED
 169  * even if the radio is in RFKILL_STATE_HARD_BLOCKED state, so as to
 170  * give the driver a hint that it should double-BLOCK the transmitter.
 171  *
 172  * Caller must have acquired rfkill->mutex.
 173  */
 174 static int rfkill_toggle_radio(struct rfkill *rfkill,
 175                                 enum rfkill_state state,
 176                                 int force)
 177 {
 178         int retval = 0;
 179         enum rfkill_state oldstate, newstate;
 180
 181         if (unlikely(rfkill->dev.power.power_state.event & PM_EVENT_SLEEP))
 182                 return -EBUSY;
 183
 184         oldstate = rfkill->state;
 185
 186         if (rfkill->get_state && !force &&
 187             !rfkill->get_state(rfkill->data, &newstate))
 188                 rfkill->state = newstate;
 189
 190         switch (state) {
 191         case RFKILL_STATE_HARD_BLOCKED:
 192                 /* typically happens when refreshing hardware state,
 193                  * such as on resume */
 194                 state = RFKILL_STATE_SOFT_BLOCKED;
 195                 break;
 196         case RFKILL_STATE_UNBLOCKED:
 197                 /* force can't override this, only rfkill_force_state() can */
 198                 if (rfkill->state == RFKILL_STATE_HARD_BLOCKED)
 199                         return -EPERM;
 200                 break;
 201         case RFKILL_STATE_SOFT_BLOCKED:
 202                 /* nothing to do, we want to give drivers the hint to double
 203                  * BLOCK even a transmitter that is already in state
 204                  * RFKILL_STATE_HARD_BLOCKED */
 205                 break;
 206         default:
 207                 WARN(1, KERN_WARNING
 208                         "rfkill: illegal state %d passed as parameter "
 209                         "to rfkill_toggle_radio\n", state);
 210                 return -EINVAL;
 211         }
 212
 213         if (force || state != rfkill->state) {
 214                 retval = rfkill->toggle_radio(rfkill->data, state);
 215                 /* never allow a HARD->SOFT downgrade! */
 216                 if (!retval && rfkill->state != RFKILL_STATE_HARD_BLOCKED)
 217                         rfkill->state = state;
 218         }
 219
 220         if (force || rfkill->state != oldstate) {
 221                 rfkill_led_trigger(rfkill, rfkill->state);
 222                 notify_rfkill_state_change(rfkill);
 223         }
 224
 225         return retval;
 226 }
 227
 228 /**
 229  * __rfkill_switch_all - Toggle state of all switches of given type
 230  * @type: type of interfaces to be affected
 231  * @state: the new state
 232  *
 233  * This function toggles the state of all switches of given type,
 234  * unless a specific switch is claimed by userspace (in which case,
 235  * that switch is left alone) or suspended.
 236  *
 237  * Caller must have acquired rfkill_global_mutex.
 238  */
 239 static void __rfkill_switch_all(const enum rfkill_type type,
 240                                 const enum rfkill_state state)
 241 {
 242         struct rfkill *rfkill;
 243
 244         if (WARN((state >= RFKILL_STATE_MAX || type >= RFKILL_TYPE_MAX),
 245                         KERN_WARNING
 246                         "rfkill: illegal state %d or type %d "
 247                         "passed as parameter to __rfkill_switch_all\n",
 248                         state, type))
 249                 return;
 250
 251         rfkill_global_states[type].current_state = state;
 252         list_for_each_entry(rfkill, &rfkill_list, node) {
 253                 if ((!rfkill->user_claim) && (rfkill->type == type)) {
 254                         mutex_lock(&rfkill->mutex);
 255                         rfkill_toggle_radio(rfkill, state, 0);
 256                         mutex_unlock(&rfkill->mutex);
 257                 }
 258         }
 259 }
 260
 261 /**
 262  * rfkill_switch_all - Toggle state of all switches of given type
 263  * @type: type of interfaces to be affected
 264  * @state: the new state
 265  *
 266  * Acquires rfkill_global_mutex and calls __rfkill_switch_all(@type, @state).
 267  * Please refer to __rfkill_switch_all() for details.
 268  */
 269 void rfkill_switch_all(enum rfkill_type type, enum rfkill_state state)
 270 {
 271         mutex_lock(&rfkill_global_mutex);
 272         __rfkill_switch_all(type, state);
 273         mutex_unlock(&rfkill_global_mutex);
 274 }
 275 EXPORT_SYMBOL(rfkill_switch_all);
 276
 277 /**
 278  * rfkill_epo - emergency power off all transmitters
 279  *
 280  * This kicks all non-suspended rfkill devices to RFKILL_STATE_SOFT_BLOCKED,
 281  * ignoring everything in its path but rfkill_global_mutex and rfkill->mutex.
 282  *
 283  * The global state before the EPO is saved and can be restored later
 284  * using rfkill_restore_states().
 285  */
 286 void rfkill_epo(void)
 287 {
 288         struct rfkill *rfkill;
 289         int i;
 290
 291         mutex_lock(&rfkill_global_mutex);
 292
 293         list_for_each_entry(rfkill, &rfkill_list, node) {
 294                 mutex_lock(&rfkill->mutex);
 295                 rfkill_toggle_radio(rfkill, RFKILL_STATE_SOFT_BLOCKED, 1);
 296                 mutex_unlock(&rfkill->mutex);
 297         }
 298         for (i = 0; i < RFKILL_TYPE_MAX; i++) {
 299                 rfkill_global_states[i].default_state =
 300                                 rfkill_global_states[i].current_state;
 301                 rfkill_global_states[i].current_state =
 302                                 RFKILL_STATE_SOFT_BLOCKED;
 303         }
 304         mutex_unlock(&rfkill_global_mutex);
 305 }
 306 EXPORT_SYMBOL_GPL(rfkill_epo);
 307
 308 /**
 309  * rfkill_restore_states - restore global states
 310  *
 311  * Restore (and sync switches to) the global state from the
 312  * states in rfkill_default_states.  This can undo the effects of
 313  * a call to rfkill_epo().
 314  */
 315 void rfkill_restore_states(void)
 316 {
 317         int i;
 318
 319         mutex_lock(&rfkill_global_mutex);
 320
 321         for (i = 0; i < RFKILL_TYPE_MAX; i++)
 322                 __rfkill_switch_all(i, rfkill_global_states[i].default_state);
 323         mutex_unlock(&rfkill_global_mutex);
 324 }
 325 EXPORT_SYMBOL_GPL(rfkill_restore_states);
 326
 327 /**
 328  * rfkill_force_state - Force the internal rfkill radio state
 329  * @rfkill: pointer to the rfkill class to modify.
 330  * @state: the current radio state the class should be forced to.
 331  *
 332  * This function updates the internal state of the radio cached
 333  * by the rfkill class.  It should be used when the driver gets
 334  * a notification by the firmware/hardware of the current *real*
 335  * state of the radio rfkill switch.
 336  *
 337  * Devices which are subject to external changes on their rfkill
 338  * state (such as those caused by a hardware rfkill line) MUST
 339  * have their driver arrange to call rfkill_force_state() as soon
 340  * as possible after such a change.
 341  *
 342  * This function may not be called from an atomic context.
 343  */
 344 int rfkill_force_state(struct rfkill *rfkill, enum rfkill_state state)
 345 {
 346         enum rfkill_state oldstate;
 347
 348         BUG_ON(!rfkill);
 349         if (WARN((state >= RFKILL_STATE_MAX),
 350                         KERN_WARNING
 351                         "rfkill: illegal state %d passed as parameter "
 352                         "to rfkill_force_state\n", state))
 353                 return -EINVAL;
 354
 355         mutex_lock(&rfkill->mutex);
 356
 357         oldstate = rfkill->state;
 358         rfkill->state = state;
 359
 360         if (state != oldstate)
 361                 notify_rfkill_state_change(rfkill);
 362
 363         mutex_unlock(&rfkill->mutex);
 364
 365         return 0;
 366 }
 367 EXPORT_SYMBOL(rfkill_force_state);
 368
 369 static ssize_t rfkill_name_show(struct device *dev,
 370                                 struct device_attribute *attr,
 371                                 char *buf)
 372 {
 373         struct rfkill *rfkill = to_rfkill(dev);
 374
 375         return sprintf(buf, "%s\n", rfkill->name);
 376 }
 377
 378 static const char *rfkill_get_type_str(enum rfkill_type type)
 379 {
 380         switch (type) {
 381         case RFKILL_TYPE_WLAN:
 382                 return "wlan";
 383         case RFKILL_TYPE_BLUETOOTH:
 384                 return "bluetooth";
 385         case RFKILL_TYPE_UWB:
 386                 return "ultrawideband";
 387         case RFKILL_TYPE_WIMAX:
 388                 return "wimax";
 389         case RFKILL_TYPE_WWAN:
 390                 return "wwan";
 391         default:
 392                 BUG();
 393         }
 394 }
 395
 396 static ssize_t rfkill_type_show(struct device *dev,
 397                                 struct device_attribute *attr,
 398                                 char *buf)
 399 {
 400         struct rfkill *rfkill = to_rfkill(dev);
 401
 402         return sprintf(buf, "%s\n", rfkill_get_type_str(rfkill->type));
 403 }
 404
 405 static ssize_t rfkill_state_show(struct device *dev,
 406                                  struct device_attribute *attr,
 407                                  char *buf)
 408 {
 409         struct rfkill *rfkill = to_rfkill(dev);
 410
 411         update_rfkill_state(rfkill);
 412         return sprintf(buf, "%d\n", rfkill->state);
 413 }
 414
 415 static ssize_t rfkill_state_store(struct device *dev,
 416                                   struct device_attribute *attr,
 417                                   const char *buf, size_t count)
 418 {
 419         struct rfkill *rfkill = to_rfkill(dev);
 420         unsigned long state;
 421         int error;
 422
 423         if (!capable(CAP_NET_ADMIN))
 424                 return -EPERM;
 425
 426         error = strict_strtoul(buf, 0, &state);
 427         if (error)
 428                 return error;
 429
 430         /* RFKILL_STATE_HARD_BLOCKED is illegal here... */
 431         if (state != RFKILL_STATE_UNBLOCKED &&
 432             state != RFKILL_STATE_SOFT_BLOCKED)
 433                 return -EINVAL;
 434
 435         if (mutex_lock_interruptible(&rfkill->mutex))
 436                 return -ERESTARTSYS;
 437         error = rfkill_toggle_radio(rfkill, state, 0);
 438         mutex_unlock(&rfkill->mutex);
 439
 440         return error ? error : count;
 441 }
 442
 443 static ssize_t rfkill_claim_show(struct device *dev,
 444                                  struct device_attribute *attr,
 445                                  char *buf)
 446 {
 447         struct rfkill *rfkill = to_rfkill(dev);
 448
 449         return sprintf(buf, "%d\n", rfkill->user_claim);
 450 }
 451
 452 static ssize_t rfkill_claim_store(struct device *dev,
 453                                   struct device_attribute *attr,
 454                                   const char *buf, size_t count)
 455 {
 456         struct rfkill *rfkill = to_rfkill(dev);
 457         unsigned long claim_tmp;
 458         bool claim;
 459         int error;
 460
 461         if (!capable(CAP_NET_ADMIN))
 462                 return -EPERM;
 463
 464         if (rfkill->user_claim_unsupported)
 465                 return -EOPNOTSUPP;
 466
 467         error = strict_strtoul(buf, 0, &claim_tmp);
 468         if (error)
 469                 return error;
 470         claim = !!claim_tmp;
 471
 472         /*
 473          * Take the global lock to make sure the kernel is not in
 474          * the middle of rfkill_switch_all
 475          */
 476         error = mutex_lock_interruptible(&rfkill_global_mutex);
 477         if (error)
 478                 return error;
 479
 480         if (rfkill->user_claim != claim) {
 481                 if (!claim) {
 482                         mutex_lock(&rfkill->mutex);
 483                         rfkill_toggle_radio(rfkill,
 484                                         rfkill_global_states[rfkill->type].current_state,
 485                                         0);
 486                         mutex_unlock(&rfkill->mutex);
 487                 }
 488                 rfkill->user_claim = claim;
 489         }
 490
 491         mutex_unlock(&rfkill_global_mutex);
 492
 493         return error ? error : count;
 494 }
 495
 496 static struct device_attribute rfkill_dev_attrs[] = {
 497         __ATTR(name, S_IRUGO, rfkill_name_show, NULL),
 498         __ATTR(type, S_IRUGO, rfkill_type_show, NULL),
 499         __ATTR(state, S_IRUGO|S_IWUSR, rfkill_state_show, rfkill_state_store),
 500         __ATTR(claim, S_IRUGO|S_IWUSR, rfkill_claim_show, rfkill_claim_store),
 501         __ATTR_NULL
 502 };
 503
 504 static void rfkill_release(struct device *dev)
 505 {
 506         struct rfkill *rfkill = to_rfkill(dev);
 507
 508         kfree(rfkill);
 509         module_put(THIS_MODULE);
 510 }
 511
 512 #ifdef CONFIG_PM
 513 static int rfkill_suspend(struct device *dev, pm_message_t state)
 514 {
 515         struct rfkill *rfkill = to_rfkill(dev);
 516
 517         if (dev->power.power_state.event != state.event) {
 518                 if (state.event & PM_EVENT_SLEEP) {
 519                         /* Stop transmitter, keep state, no notifies */
 520                         update_rfkill_state(rfkill);
 521
 522                         mutex_lock(&rfkill->mutex);
 523                         rfkill->toggle_radio(rfkill->data,
 524                                                 RFKILL_STATE_SOFT_BLOCKED);
 525                         mutex_unlock(&rfkill->mutex);
 526                 }
 527
 528                 dev->power.power_state = state;
 529         }
 530
 531         return 0;
 532 }
 533
 534 static int rfkill_resume(struct device *dev)
 535 {
 536         struct rfkill *rfkill = to_rfkill(dev);
 537
 538         if (dev->power.power_state.event != PM_EVENT_ON) {
 539                 mutex_lock(&rfkill->mutex);
 540
 541                 dev->power.power_state.event = PM_EVENT_ON;
 542
 543                 /* restore radio state AND notify everybody */
 544                 rfkill_toggle_radio(rfkill, rfkill->state, 1);
 545
 546                 mutex_unlock(&rfkill->mutex);
 547         }
 548
 549         return 0;
 550 }
 551 #else
 552 #define rfkill_suspend NULL
 553 #define rfkill_resume NULL
 554 #endif
 555
 556 static int rfkill_blocking_uevent_notifier(struct notifier_block *nb,
 557                                         unsigned long eventid,
 558                                         void *data)
 559 {
 560         struct rfkill *rfkill = (struct rfkill *)data;
 561
 562         switch (eventid) {
 563         case RFKILL_STATE_CHANGED:
 564                 kobject_uevent(&rfkill->dev.kobj, KOBJ_CHANGE);
 565                 break;
 566         default:
 567                 break;
 568         }
 569
 570         return NOTIFY_DONE;
 571 }
 572
 573 static struct notifier_block rfkill_blocking_uevent_nb = {
 574         .notifier_call  = rfkill_blocking_uevent_notifier,
 575         .priority       = 0,
 576 };
 577
 578 static int rfkill_dev_uevent(struct device *dev, struct kobj_uevent_env *env)
 579 {
 580         struct rfkill *rfkill = to_rfkill(dev);
 581         int error;
 582
 583         error = add_uevent_var(env, "RFKILL_NAME=%s", rfkill->name);
 584         if (error)
 585                 return error;
 586         error = add_uevent_var(env, "RFKILL_TYPE=%s",
 587                                 rfkill_get_type_str(rfkill->type));
 588         if (error)
 589                 return error;
 590         error = add_uevent_var(env, "RFKILL_STATE=%d", rfkill->state);
 591         return error;
 592 }
 593
 594 static struct class rfkill_class = {
 595         .name           = "rfkill",
 596         .dev_release    = rfkill_release,
 597         .dev_attrs      = rfkill_dev_attrs,
 598         .suspend        = rfkill_suspend,
 599         .resume         = rfkill_resume,
 600         .dev_uevent     = rfkill_dev_uevent,
 601 };
 602
 603 static int rfkill_check_duplicity(const struct rfkill *rfkill)
 604 {
 605         struct rfkill *p;
 606         unsigned long seen[BITS_TO_LONGS(RFKILL_TYPE_MAX)];
 607
 608         memset(seen, 0, sizeof(seen));
 609
 610         list_for_each_entry(p, &rfkill_list, node) {
 611                 if (WARN((p == rfkill), KERN_WARNING
 612                                 "rfkill: illegal attempt to register "
 613                                 "an already registered rfkill struct\n"))
 614                         return -EEXIST;
 615                 set_bit(p->type, seen);
 616         }
 617
 618         /* 0: first switch of its kind */
 619         return test_bit(rfkill->type, seen);
 620 }
 621
 622 static int rfkill_add_switch(struct rfkill *rfkill)
 623 {
 624         int error;
 625
 626         mutex_lock(&rfkill_global_mutex);
 627
 628         error = rfkill_check_duplicity(rfkill);
 629         if (error < 0)
 630                 goto unlock_out;
 631
 632         if (!error) {
 633                 /* lock default after first use */
 634                 set_bit(rfkill->type, rfkill_states_lockdflt);
 635                 rfkill_global_states[rfkill->type].current_state =
 636                         rfkill_global_states[rfkill->type].default_state;
 637         }
 638
 639         rfkill_toggle_radio(rfkill,
 640                             rfkill_global_states[rfkill->type].current_state,
 641                             0);
 642
 643         list_add_tail(&rfkill->node, &rfkill_list);
 644
 645         error = 0;
 646 unlock_out:
 647         mutex_unlock(&rfkill_global_mutex);
 648
 649         return error;
 650 }
 651
 652 static void rfkill_remove_switch(struct rfkill *rfkill)
 653 {
 654         mutex_lock(&rfkill_global_mutex);
 655         list_del_init(&rfkill->node);
 656         mutex_unlock(&rfkill_global_mutex);
 657
 658         mutex_lock(&rfkill->mutex);
 659         rfkill_toggle_radio(rfkill, RFKILL_STATE_SOFT_BLOCKED, 1);
 660         mutex_unlock(&rfkill->mutex);
 661 }
 662
 663 /**
 664  * rfkill_allocate - allocate memory for rfkill structure.
 665  * @parent: device that has rf switch on it
 666  * @type: type of the switch (RFKILL_TYPE_*)
 667  *
 668  * This function should be called by the network driver when it needs
 669  * rfkill structure.  Once the structure is allocated the driver should
 670  * finish its initialization by setting the name, private data, enable_radio
 671  * and disable_radio methods and then register it with rfkill_register().
 672  *
 673  * NOTE: If registration fails the structure shoudl be freed by calling
 674  * rfkill_free() otherwise rfkill_unregister() should be used.
 675  */
 676 struct rfkill * __must_check rfkill_allocate(struct device *parent,
 677                                              enum rfkill_type type)
 678 {
 679         struct rfkill *rfkill;
 680         struct device *dev;
 681
 682         if (WARN((type >= RFKILL_TYPE_MAX),
 683                         KERN_WARNING
 684                         "rfkill: illegal type %d passed as parameter "
 685                         "to rfkill_allocate\n", type))
 686                 return NULL;
 687
 688         rfkill = kzalloc(sizeof(struct rfkill), GFP_KERNEL);
 689         if (!rfkill)
 690                 return NULL;
 691
 692         mutex_init(&rfkill->mutex);
 693         INIT_LIST_HEAD(&rfkill->node);
 694         rfkill->type = type;
 695
 696         dev = &rfkill->dev;
 697         dev->class = &rfkill_class;
 698         dev->parent = parent;
 699         device_initialize(dev);
 700
 701         __module_get(THIS_MODULE);
 702
 703         return rfkill;
 704 }
 705 EXPORT_SYMBOL(rfkill_allocate);
 706
 707 /**
 708  * rfkill_free - Mark rfkill structure for deletion
 709  * @rfkill: rfkill structure to be destroyed
 710  *
 711  * Decrements reference count of the rfkill structure so it is destroyed.
 712  * Note that rfkill_free() should _not_ be called after rfkill_unregister().
 713  */
 714 void rfkill_free(struct rfkill *rfkill)
 715 {
 716         if (rfkill)
 717                 put_device(&rfkill->dev);
 718 }
 719 EXPORT_SYMBOL(rfkill_free);
 720
 721 static void rfkill_led_trigger_register(struct rfkill *rfkill)
 722 {
 723 #ifdef CONFIG_RFKILL_LEDS
 724         int error;
 725
 726         if (!rfkill->led_trigger.name)
 727                 rfkill->led_trigger.name = rfkill->dev.bus_id;
 728         if (!rfkill->led_trigger.activate)
 729                 rfkill->led_trigger.activate = rfkill_led_trigger_activate;
 730         error = led_trigger_register(&rfkill->led_trigger);
 731         if (error)
 732                 rfkill->led_trigger.name = NULL;
 733 #endif /* CONFIG_RFKILL_LEDS */
 734 }
 735
 736 static void rfkill_led_trigger_unregister(struct rfkill *rfkill)
 737 {
 738 #ifdef CONFIG_RFKILL_LEDS
 739         if (rfkill->led_trigger.name) {
 740                 led_trigger_unregister(&rfkill->led_trigger);
 741                 rfkill->led_trigger.name = NULL;
 742         }
 743 #endif
 744 }
 745
 746 /**
 747  * rfkill_register - Register a rfkill structure.
 748  * @rfkill: rfkill structure to be registered
 749  *
 750  * This function should be called by the network driver when the rfkill
 751  * structure needs to be registered. Immediately from registration the
 752  * switch driver should be able to service calls to toggle_radio.
 753  */
 754 int __must_check rfkill_register(struct rfkill *rfkill)
 755 {
 756         static atomic_t rfkill_no = ATOMIC_INIT(0);
 757         struct device *dev = &rfkill->dev;
 758         int error;
 759
 760         if (WARN((!rfkill || !rfkill->toggle_radio ||
 761                         rfkill->type >= RFKILL_TYPE_MAX ||
 762                         rfkill->state >= RFKILL_STATE_MAX),
 763                         KERN_WARNING
 764                         "rfkill: attempt to register a "
 765                         "badly initialized rfkill struct\n"))
 766                 return -EINVAL;
 767
 768         snprintf(dev->bus_id, sizeof(dev->bus_id),
 769                  "rfkill%ld", (long)atomic_inc_return(&rfkill_no) - 1);
 770
 771         rfkill_led_trigger_register(rfkill);
 772
 773         error = rfkill_add_switch(rfkill);
 774         if (error) {
 775                 rfkill_led_trigger_unregister(rfkill);
 776                 return error;
 777         }
 778
 779         error = device_add(dev);
 780         if (error) {
 781                 rfkill_remove_switch(rfkill);
 782                 rfkill_led_trigger_unregister(rfkill);
 783                 return error;
 784         }
 785
 786         return 0;
 787 }
 788 EXPORT_SYMBOL(rfkill_register);
 789
 790 /**
 791  * rfkill_unregister - Unregister a rfkill structure.
 792  * @rfkill: rfkill structure to be unregistered
 793  *
 794  * This function should be called by the network driver during device
 795  * teardown to destroy rfkill structure. Note that rfkill_free() should
 796  * _not_ be called after rfkill_unregister().
 797  */
 798 void rfkill_unregister(struct rfkill *rfkill)
 799 {
 800         BUG_ON(!rfkill);
 801         device_del(&rfkill->dev);
 802         rfkill_remove_switch(rfkill);
 803         rfkill_led_trigger_unregister(rfkill);
 804         put_device(&rfkill->dev);
 805 }
 806 EXPORT_SYMBOL(rfkill_unregister);
 807
 808 /**
 809  * rfkill_set_default - set initial value for a switch type
 810  * @type - the type of switch to set the default state of
 811  * @state - the new default state for that group of switches
 812  *
 813  * Sets the initial state rfkill should use for a given type.
 814  * The following initial states are allowed: RFKILL_STATE_SOFT_BLOCKED
 815  * and RFKILL_STATE_UNBLOCKED.
 816  *
 817  * This function is meant to be used by platform drivers for platforms
 818  * that can save switch state across power down/reboot.
 819  *
 820  * The default state for each switch type can be changed exactly once.
 821  * After a switch of that type is registered, the default state cannot
 822  * be changed anymore.  This guards against multiple drivers it the
 823  * same platform trying to set the initial switch default state, which
 824  * is not allowed.
 825  *
 826  * Returns -EPERM if the state has already been set once or is in use,
 827  * so drivers likely want to either ignore or at most printk(KERN_NOTICE)
 828  * if this function returns -EPERM.
 829  *
 830  * Returns 0 if the new default state was set, or an error if it
 831  * could not be set.
 832  */
 833 int rfkill_set_default(enum rfkill_type type, enum rfkill_state state)
 834 {
 835         int error;
 836
 837         if (WARN((type >= RFKILL_TYPE_MAX ||
 838                         (state != RFKILL_STATE_SOFT_BLOCKED &&
 839                          state != RFKILL_STATE_UNBLOCKED)),
 840                         KERN_WARNING
 841                         "rfkill: illegal state %d or type %d passed as "
 842                         "parameter to rfkill_set_default\n", state, type))
 843                 return -EINVAL;
 844
 845         mutex_lock(&rfkill_global_mutex);
 846
 847         if (!test_and_set_bit(type, rfkill_states_lockdflt)) {
 848                 rfkill_global_states[type].default_state = state;
 849                 error = 0;
 850         } else
 851                 error = -EPERM;
 852
 853         mutex_unlock(&rfkill_global_mutex);
 854         return error;
 855 }
 856 EXPORT_SYMBOL_GPL(rfkill_set_default);
 857
 858 /*
 859  * Rfkill module initialization/deinitialization.
 860  */
 861 static int __init rfkill_init(void)
 862 {
 863         int error;
 864         int i;
 865
 866         /* RFKILL_STATE_HARD_BLOCKED is illegal here... */
 867         if (rfkill_default_state != RFKILL_STATE_SOFT_BLOCKED &&
 868             rfkill_default_state != RFKILL_STATE_UNBLOCKED)
 869                 return -EINVAL;
 870
 871         for (i = 0; i < RFKILL_TYPE_MAX; i++)
 872                 rfkill_global_states[i].default_state = rfkill_default_state;
 873
 874         error = class_register(&rfkill_class);
 875         if (error) {
 876                 printk(KERN_ERR "rfkill: unable to register rfkill class\n");
 877                 return error;
 878         }
 879
 880         register_rfkill_notifier(&rfkill_blocking_uevent_nb);
 881
 882         return 0;
 883 }
 884
 885 static void __exit rfkill_exit(void)
 886 {
 887         unregister_rfkill_notifier(&rfkill_blocking_uevent_nb);
 888         class_unregister(&rfkill_class);
 889 }
 890
 891 subsys_initcall(rfkill_init);
 892 module_exit(rfkill_exit);