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