rfkill: rename rfkill_mutex to rfkill_global_mutex
[linux-2.6/linux-acpi-2.6/ibm-acpi-2.6.git] / net / rfkill / rfkill.c
blob0dedf2d76014dc86ccfad8a23ce4d7eb6580c0a3
1 /*
2 * Copyright (C) 2006 - 2007 Ivo van Doorn
3 * Copyright (C) 2007 Dmitry Torokhov
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.
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.
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.
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>
30 /* Get declaration of rfkill_switch_all() to shut up sparse. */
31 #include "rfkill-input.h"
34 MODULE_AUTHOR("Ivo van Doorn <IvDoorn@gmail.com>");
35 MODULE_VERSION("1.0");
36 MODULE_DESCRIPTION("RF switch support");
37 MODULE_LICENSE("GPL");
39 static LIST_HEAD(rfkill_list); /* list of registered rf switches */
40 static DEFINE_MUTEX(rfkill_global_mutex);
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");
47 struct rfkill_gsw_state {
48 enum rfkill_state current_state;
49 enum rfkill_state default_state;
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)];
55 static BLOCKING_NOTIFIER_HEAD(rfkill_notifier_list);
58 /**
59 * register_rfkill_notifier - Add notifier to rfkill notifier chain
60 * @nb: pointer to the new entry to add to the chain
62 * See blocking_notifier_chain_register() for return value and further
63 * observations.
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.
69 * Notifiers added to this chain are to always return NOTIFY_DONE. This
70 * chain is a blocking notifier chain: notifiers can sleep.
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.
77 int register_rfkill_notifier(struct notifier_block *nb)
79 BUG_ON(!nb);
80 return blocking_notifier_chain_register(&rfkill_notifier_list, nb);
82 EXPORT_SYMBOL_GPL(register_rfkill_notifier);
84 /**
85 * unregister_rfkill_notifier - remove notifier from rfkill notifier chain
86 * @nb: pointer to the entry to remove from the chain
88 * See blocking_notifier_chain_unregister() for return value and further
89 * observations.
91 * Removes a notifier from the rfkill notifier chain.
93 int unregister_rfkill_notifier(struct notifier_block *nb)
95 BUG_ON(!nb);
96 return blocking_notifier_chain_unregister(&rfkill_notifier_list, nb);
98 EXPORT_SYMBOL_GPL(unregister_rfkill_notifier);
101 static void rfkill_led_trigger(struct rfkill *rfkill,
102 enum rfkill_state state)
104 #ifdef CONFIG_RFKILL_LEDS
105 struct led_trigger *led = &rfkill->led_trigger;
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 */
116 #ifdef CONFIG_RFKILL_LEDS
117 static void rfkill_led_trigger_activate(struct led_classdev *led)
119 struct rfkill *rfkill = container_of(led->trigger,
120 struct rfkill, led_trigger);
122 rfkill_led_trigger(rfkill, rfkill->state);
124 #endif /* CONFIG_RFKILL_LEDS */
126 static void notify_rfkill_state_change(struct rfkill *rfkill)
128 rfkill_led_trigger(rfkill, rfkill->state);
129 blocking_notifier_call_chain(&rfkill_notifier_list,
130 RFKILL_STATE_CHANGED,
131 rfkill);
134 static void update_rfkill_state(struct rfkill *rfkill)
136 enum rfkill_state newstate, oldstate;
138 if (rfkill->get_state) {
139 mutex_lock(&rfkill->mutex);
140 if (!rfkill->get_state(rfkill->data, &newstate)) {
141 oldstate = rfkill->state;
142 rfkill->state = newstate;
143 if (oldstate != newstate)
144 notify_rfkill_state_change(rfkill);
146 mutex_unlock(&rfkill->mutex);
151 * rfkill_toggle_radio - wrapper for toggle_radio hook
152 * @rfkill: the rfkill struct to use
153 * @force: calls toggle_radio even if cache says it is not needed,
154 * and also makes sure notifications of the state will be
155 * sent even if it didn't change
156 * @state: the new state to call toggle_radio() with
158 * Calls rfkill->toggle_radio, enforcing the API for toggle_radio
159 * calls and handling all the red tape such as issuing notifications
160 * if the call is successful.
162 * Suspended devices are not touched at all, and -EAGAIN is returned.
164 * Note that the @force parameter cannot override a (possibly cached)
165 * state of RFKILL_STATE_HARD_BLOCKED. Any device making use of
166 * RFKILL_STATE_HARD_BLOCKED implements either get_state() or
167 * rfkill_force_state(), so the cache either is bypassed or valid.
169 * Note that we do call toggle_radio for RFKILL_STATE_SOFT_BLOCKED
170 * even if the radio is in RFKILL_STATE_HARD_BLOCKED state, so as to
171 * give the driver a hint that it should double-BLOCK the transmitter.
173 * Caller must have acquired rfkill->mutex.
175 static int rfkill_toggle_radio(struct rfkill *rfkill,
176 enum rfkill_state state,
177 int force)
179 int retval = 0;
180 enum rfkill_state oldstate, newstate;
182 if (unlikely(rfkill->dev.power.power_state.event & PM_EVENT_SLEEP))
183 return -EBUSY;
185 oldstate = rfkill->state;
187 if (rfkill->get_state && !force &&
188 !rfkill->get_state(rfkill->data, &newstate))
189 rfkill->state = newstate;
191 switch (state) {
192 case RFKILL_STATE_HARD_BLOCKED:
193 /* typically happens when refreshing hardware state,
194 * such as on resume */
195 state = RFKILL_STATE_SOFT_BLOCKED;
196 break;
197 case RFKILL_STATE_UNBLOCKED:
198 /* force can't override this, only rfkill_force_state() can */
199 if (rfkill->state == RFKILL_STATE_HARD_BLOCKED)
200 return -EPERM;
201 break;
202 case RFKILL_STATE_SOFT_BLOCKED:
203 /* nothing to do, we want to give drivers the hint to double
204 * BLOCK even a transmitter that is already in state
205 * RFKILL_STATE_HARD_BLOCKED */
206 break;
207 default:
208 WARN(1, KERN_WARNING
209 "rfkill: illegal state %d passed as parameter "
210 "to rfkill_toggle_radio\n", state);
211 return -EINVAL;
214 if (force || state != rfkill->state) {
215 retval = rfkill->toggle_radio(rfkill->data, state);
216 /* never allow a HARD->SOFT downgrade! */
217 if (!retval && rfkill->state != RFKILL_STATE_HARD_BLOCKED)
218 rfkill->state = state;
221 if (force || rfkill->state != oldstate)
222 notify_rfkill_state_change(rfkill);
224 return retval;
228 * __rfkill_switch_all - Toggle state of all switches of given type
229 * @type: type of interfaces to be affected
230 * @state: the new state
232 * This function toggles the state of all switches of given type,
233 * unless a specific switch is claimed by userspace (in which case,
234 * that switch is left alone) or suspended.
236 * Caller must have acquired rfkill_global_mutex.
238 static void __rfkill_switch_all(const enum rfkill_type type,
239 const enum rfkill_state state)
241 struct rfkill *rfkill;
243 if (WARN((state >= RFKILL_STATE_MAX || type >= RFKILL_TYPE_MAX),
244 KERN_WARNING
245 "rfkill: illegal state %d or type %d "
246 "passed as parameter to __rfkill_switch_all\n",
247 state, type))
248 return;
250 rfkill_global_states[type].current_state = state;
251 list_for_each_entry(rfkill, &rfkill_list, node) {
252 if ((!rfkill->user_claim) && (rfkill->type == type)) {
253 mutex_lock(&rfkill->mutex);
254 rfkill_toggle_radio(rfkill, state, 0);
255 mutex_unlock(&rfkill->mutex);
261 * rfkill_switch_all - Toggle state of all switches of given type
262 * @type: type of interfaces to be affected
263 * @state: the new state
265 * Acquires rfkill_global_mutex and calls __rfkill_switch_all(@type, @state).
266 * Please refer to __rfkill_switch_all() for details.
268 void rfkill_switch_all(enum rfkill_type type, enum rfkill_state state)
270 mutex_lock(&rfkill_global_mutex);
271 __rfkill_switch_all(type, state);
272 mutex_unlock(&rfkill_global_mutex);
274 EXPORT_SYMBOL(rfkill_switch_all);
277 * rfkill_epo - emergency power off all transmitters
279 * This kicks all non-suspended rfkill devices to RFKILL_STATE_SOFT_BLOCKED,
280 * ignoring everything in its path but rfkill_global_mutex and rfkill->mutex.
282 * The global state before the EPO is saved and can be restored later
283 * using rfkill_restore_states().
285 void rfkill_epo(void)
287 struct rfkill *rfkill;
288 int i;
290 mutex_lock(&rfkill_global_mutex);
292 list_for_each_entry(rfkill, &rfkill_list, node) {
293 mutex_lock(&rfkill->mutex);
294 rfkill_toggle_radio(rfkill, RFKILL_STATE_SOFT_BLOCKED, 1);
295 mutex_unlock(&rfkill->mutex);
297 for (i = 0; i < RFKILL_TYPE_MAX; i++) {
298 rfkill_global_states[i].default_state =
299 rfkill_global_states[i].current_state;
300 rfkill_global_states[i].current_state =
301 RFKILL_STATE_SOFT_BLOCKED;
303 mutex_unlock(&rfkill_global_mutex);
305 EXPORT_SYMBOL_GPL(rfkill_epo);
308 * rfkill_restore_states - restore global states
310 * Restore (and sync switches to) the global state from the
311 * states in rfkill_default_states. This can undo the effects of
312 * a call to rfkill_epo().
314 void rfkill_restore_states(void)
316 int i;
318 mutex_lock(&rfkill_global_mutex);
320 for (i = 0; i < RFKILL_TYPE_MAX; i++)
321 __rfkill_switch_all(i, rfkill_global_states[i].default_state);
322 mutex_unlock(&rfkill_global_mutex);
324 EXPORT_SYMBOL_GPL(rfkill_restore_states);
327 * rfkill_force_state - Force the internal rfkill radio state
328 * @rfkill: pointer to the rfkill class to modify.
329 * @state: the current radio state the class should be forced to.
331 * This function updates the internal state of the radio cached
332 * by the rfkill class. It should be used when the driver gets
333 * a notification by the firmware/hardware of the current *real*
334 * state of the radio rfkill switch.
336 * Devices which are subject to external changes on their rfkill
337 * state (such as those caused by a hardware rfkill line) MUST
338 * have their driver arrange to call rfkill_force_state() as soon
339 * as possible after such a change.
341 * This function may not be called from an atomic context.
343 int rfkill_force_state(struct rfkill *rfkill, enum rfkill_state state)
345 enum rfkill_state oldstate;
347 BUG_ON(!rfkill);
348 if (WARN((state >= RFKILL_STATE_MAX),
349 KERN_WARNING
350 "rfkill: illegal state %d passed as parameter "
351 "to rfkill_force_state\n", state))
352 return -EINVAL;
354 mutex_lock(&rfkill->mutex);
356 oldstate = rfkill->state;
357 rfkill->state = state;
359 if (state != oldstate)
360 notify_rfkill_state_change(rfkill);
362 mutex_unlock(&rfkill->mutex);
364 return 0;
366 EXPORT_SYMBOL(rfkill_force_state);
368 static ssize_t rfkill_name_show(struct device *dev,
369 struct device_attribute *attr,
370 char *buf)
372 struct rfkill *rfkill = to_rfkill(dev);
374 return sprintf(buf, "%s\n", rfkill->name);
377 static const char *rfkill_get_type_str(enum rfkill_type type)
379 switch (type) {
380 case RFKILL_TYPE_WLAN:
381 return "wlan";
382 case RFKILL_TYPE_BLUETOOTH:
383 return "bluetooth";
384 case RFKILL_TYPE_UWB:
385 return "ultrawideband";
386 case RFKILL_TYPE_WIMAX:
387 return "wimax";
388 case RFKILL_TYPE_WWAN:
389 return "wwan";
390 default:
391 BUG();
395 static ssize_t rfkill_type_show(struct device *dev,
396 struct device_attribute *attr,
397 char *buf)
399 struct rfkill *rfkill = to_rfkill(dev);
401 return sprintf(buf, "%s\n", rfkill_get_type_str(rfkill->type));
404 static ssize_t rfkill_state_show(struct device *dev,
405 struct device_attribute *attr,
406 char *buf)
408 struct rfkill *rfkill = to_rfkill(dev);
410 update_rfkill_state(rfkill);
411 return sprintf(buf, "%d\n", rfkill->state);
414 static ssize_t rfkill_state_store(struct device *dev,
415 struct device_attribute *attr,
416 const char *buf, size_t count)
418 struct rfkill *rfkill = to_rfkill(dev);
419 unsigned long state;
420 int error;
422 if (!capable(CAP_NET_ADMIN))
423 return -EPERM;
425 error = strict_strtoul(buf, 0, &state);
426 if (error)
427 return error;
429 /* RFKILL_STATE_HARD_BLOCKED is illegal here... */
430 if (state != RFKILL_STATE_UNBLOCKED &&
431 state != RFKILL_STATE_SOFT_BLOCKED)
432 return -EINVAL;
434 if (mutex_lock_interruptible(&rfkill->mutex))
435 return -ERESTARTSYS;
436 error = rfkill_toggle_radio(rfkill, state, 0);
437 mutex_unlock(&rfkill->mutex);
439 return error ? error : count;
442 static ssize_t rfkill_claim_show(struct device *dev,
443 struct device_attribute *attr,
444 char *buf)
446 struct rfkill *rfkill = to_rfkill(dev);
448 return sprintf(buf, "%d\n", rfkill->user_claim);
451 static ssize_t rfkill_claim_store(struct device *dev,
452 struct device_attribute *attr,
453 const char *buf, size_t count)
455 struct rfkill *rfkill = to_rfkill(dev);
456 unsigned long claim_tmp;
457 bool claim;
458 int error;
460 if (!capable(CAP_NET_ADMIN))
461 return -EPERM;
463 if (rfkill->user_claim_unsupported)
464 return -EOPNOTSUPP;
466 error = strict_strtoul(buf, 0, &claim_tmp);
467 if (error)
468 return error;
469 claim = !!claim_tmp;
472 * Take the global lock to make sure the kernel is not in
473 * the middle of rfkill_switch_all
475 error = mutex_lock_interruptible(&rfkill_global_mutex);
476 if (error)
477 return error;
479 if (rfkill->user_claim != claim) {
480 if (!claim) {
481 mutex_lock(&rfkill->mutex);
482 rfkill_toggle_radio(rfkill,
483 rfkill_global_states[rfkill->type].current_state,
485 mutex_unlock(&rfkill->mutex);
487 rfkill->user_claim = claim;
490 mutex_unlock(&rfkill_global_mutex);
492 return error ? error : count;
495 static struct device_attribute rfkill_dev_attrs[] = {
496 __ATTR(name, S_IRUGO, rfkill_name_show, NULL),
497 __ATTR(type, S_IRUGO, rfkill_type_show, NULL),
498 __ATTR(state, S_IRUGO|S_IWUSR, rfkill_state_show, rfkill_state_store),
499 __ATTR(claim, S_IRUGO|S_IWUSR, rfkill_claim_show, rfkill_claim_store),
500 __ATTR_NULL
503 static void rfkill_release(struct device *dev)
505 struct rfkill *rfkill = to_rfkill(dev);
507 kfree(rfkill);
508 module_put(THIS_MODULE);
511 #ifdef CONFIG_PM
512 static int rfkill_suspend(struct device *dev, pm_message_t state)
514 struct rfkill *rfkill = to_rfkill(dev);
516 if (dev->power.power_state.event != state.event) {
517 if (state.event & PM_EVENT_SLEEP) {
518 /* Stop transmitter, keep state, no notifies */
519 update_rfkill_state(rfkill);
521 mutex_lock(&rfkill->mutex);
522 rfkill->toggle_radio(rfkill->data,
523 RFKILL_STATE_SOFT_BLOCKED);
524 mutex_unlock(&rfkill->mutex);
527 dev->power.power_state = state;
530 return 0;
533 static int rfkill_resume(struct device *dev)
535 struct rfkill *rfkill = to_rfkill(dev);
537 if (dev->power.power_state.event != PM_EVENT_ON) {
538 mutex_lock(&rfkill->mutex);
540 dev->power.power_state.event = PM_EVENT_ON;
542 /* restore radio state AND notify everybody */
543 rfkill_toggle_radio(rfkill, rfkill->state, 1);
545 mutex_unlock(&rfkill->mutex);
548 return 0;
550 #else
551 #define rfkill_suspend NULL
552 #define rfkill_resume NULL
553 #endif
555 static int rfkill_blocking_uevent_notifier(struct notifier_block *nb,
556 unsigned long eventid,
557 void *data)
559 struct rfkill *rfkill = (struct rfkill *)data;
561 switch (eventid) {
562 case RFKILL_STATE_CHANGED:
563 kobject_uevent(&rfkill->dev.kobj, KOBJ_CHANGE);
564 break;
565 default:
566 break;
569 return NOTIFY_DONE;
572 static struct notifier_block rfkill_blocking_uevent_nb = {
573 .notifier_call = rfkill_blocking_uevent_notifier,
574 .priority = 0,
577 static int rfkill_dev_uevent(struct device *dev, struct kobj_uevent_env *env)
579 struct rfkill *rfkill = to_rfkill(dev);
580 int error;
582 error = add_uevent_var(env, "RFKILL_NAME=%s", rfkill->name);
583 if (error)
584 return error;
585 error = add_uevent_var(env, "RFKILL_TYPE=%s",
586 rfkill_get_type_str(rfkill->type));
587 if (error)
588 return error;
589 error = add_uevent_var(env, "RFKILL_STATE=%d", rfkill->state);
590 return error;
593 static struct class rfkill_class = {
594 .name = "rfkill",
595 .dev_release = rfkill_release,
596 .dev_attrs = rfkill_dev_attrs,
597 .suspend = rfkill_suspend,
598 .resume = rfkill_resume,
599 .dev_uevent = rfkill_dev_uevent,
602 static int rfkill_check_duplicity(const struct rfkill *rfkill)
604 struct rfkill *p;
605 unsigned long seen[BITS_TO_LONGS(RFKILL_TYPE_MAX)];
607 memset(seen, 0, sizeof(seen));
609 list_for_each_entry(p, &rfkill_list, node) {
610 if (WARN((p == rfkill), KERN_WARNING
611 "rfkill: illegal attempt to register "
612 "an already registered rfkill struct\n"))
613 return -EEXIST;
614 set_bit(p->type, seen);
617 /* 0: first switch of its kind */
618 return test_bit(rfkill->type, seen);
621 static int rfkill_add_switch(struct rfkill *rfkill)
623 int error;
625 mutex_lock(&rfkill_global_mutex);
627 error = rfkill_check_duplicity(rfkill);
628 if (error < 0)
629 goto unlock_out;
631 if (!error) {
632 /* lock default after first use */
633 set_bit(rfkill->type, rfkill_states_lockdflt);
634 rfkill_global_states[rfkill->type].current_state =
635 rfkill_global_states[rfkill->type].default_state;
638 rfkill_toggle_radio(rfkill,
639 rfkill_global_states[rfkill->type].current_state,
642 list_add_tail(&rfkill->node, &rfkill_list);
644 error = 0;
645 unlock_out:
646 mutex_unlock(&rfkill_global_mutex);
648 return error;
651 static void rfkill_remove_switch(struct rfkill *rfkill)
653 mutex_lock(&rfkill_global_mutex);
654 list_del_init(&rfkill->node);
655 mutex_unlock(&rfkill_global_mutex);
657 mutex_lock(&rfkill->mutex);
658 rfkill_toggle_radio(rfkill, RFKILL_STATE_SOFT_BLOCKED, 1);
659 mutex_unlock(&rfkill->mutex);
663 * rfkill_allocate - allocate memory for rfkill structure.
664 * @parent: device that has rf switch on it
665 * @type: type of the switch (RFKILL_TYPE_*)
667 * This function should be called by the network driver when it needs
668 * rfkill structure. Once the structure is allocated the driver should
669 * finish its initialization by setting the name, private data, enable_radio
670 * and disable_radio methods and then register it with rfkill_register().
672 * NOTE: If registration fails the structure shoudl be freed by calling
673 * rfkill_free() otherwise rfkill_unregister() should be used.
675 struct rfkill * __must_check rfkill_allocate(struct device *parent,
676 enum rfkill_type type)
678 struct rfkill *rfkill;
679 struct device *dev;
681 if (WARN((type >= RFKILL_TYPE_MAX),
682 KERN_WARNING
683 "rfkill: illegal type %d passed as parameter "
684 "to rfkill_allocate\n", type))
685 return NULL;
687 rfkill = kzalloc(sizeof(struct rfkill), GFP_KERNEL);
688 if (!rfkill)
689 return NULL;
691 mutex_init(&rfkill->mutex);
692 INIT_LIST_HEAD(&rfkill->node);
693 rfkill->type = type;
695 dev = &rfkill->dev;
696 dev->class = &rfkill_class;
697 dev->parent = parent;
698 device_initialize(dev);
700 __module_get(THIS_MODULE);
702 return rfkill;
704 EXPORT_SYMBOL(rfkill_allocate);
707 * rfkill_free - Mark rfkill structure for deletion
708 * @rfkill: rfkill structure to be destroyed
710 * Decrements reference count of the rfkill structure so it is destroyed.
711 * Note that rfkill_free() should _not_ be called after rfkill_unregister().
713 void rfkill_free(struct rfkill *rfkill)
715 if (rfkill)
716 put_device(&rfkill->dev);
718 EXPORT_SYMBOL(rfkill_free);
720 static void rfkill_led_trigger_register(struct rfkill *rfkill)
722 #ifdef CONFIG_RFKILL_LEDS
723 int error;
725 if (!rfkill->led_trigger.name)
726 rfkill->led_trigger.name = rfkill->dev.bus_id;
727 if (!rfkill->led_trigger.activate)
728 rfkill->led_trigger.activate = rfkill_led_trigger_activate;
729 error = led_trigger_register(&rfkill->led_trigger);
730 if (error)
731 rfkill->led_trigger.name = NULL;
732 #endif /* CONFIG_RFKILL_LEDS */
735 static void rfkill_led_trigger_unregister(struct rfkill *rfkill)
737 #ifdef CONFIG_RFKILL_LEDS
738 if (rfkill->led_trigger.name) {
739 led_trigger_unregister(&rfkill->led_trigger);
740 rfkill->led_trigger.name = NULL;
742 #endif
746 * rfkill_register - Register a rfkill structure.
747 * @rfkill: rfkill structure to be registered
749 * This function should be called by the network driver when the rfkill
750 * structure needs to be registered. Immediately from registration the
751 * switch driver should be able to service calls to toggle_radio.
753 int __must_check rfkill_register(struct rfkill *rfkill)
755 static atomic_t rfkill_no = ATOMIC_INIT(0);
756 struct device *dev = &rfkill->dev;
757 int error;
759 if (WARN((!rfkill || !rfkill->toggle_radio ||
760 rfkill->type >= RFKILL_TYPE_MAX ||
761 rfkill->state >= RFKILL_STATE_MAX),
762 KERN_WARNING
763 "rfkill: attempt to register a "
764 "badly initialized rfkill struct\n"))
765 return -EINVAL;
767 snprintf(dev->bus_id, sizeof(dev->bus_id),
768 "rfkill%ld", (long)atomic_inc_return(&rfkill_no) - 1);
770 rfkill_led_trigger_register(rfkill);
772 error = rfkill_add_switch(rfkill);
773 if (error) {
774 rfkill_led_trigger_unregister(rfkill);
775 return error;
778 error = device_add(dev);
779 if (error) {
780 rfkill_remove_switch(rfkill);
781 rfkill_led_trigger_unregister(rfkill);
782 return error;
785 return 0;
787 EXPORT_SYMBOL(rfkill_register);
790 * rfkill_unregister - Unregister a rfkill structure.
791 * @rfkill: rfkill structure to be unregistered
793 * This function should be called by the network driver during device
794 * teardown to destroy rfkill structure. Note that rfkill_free() should
795 * _not_ be called after rfkill_unregister().
797 void rfkill_unregister(struct rfkill *rfkill)
799 BUG_ON(!rfkill);
800 device_del(&rfkill->dev);
801 rfkill_remove_switch(rfkill);
802 rfkill_led_trigger_unregister(rfkill);
803 put_device(&rfkill->dev);
805 EXPORT_SYMBOL(rfkill_unregister);
808 * rfkill_set_default - set initial value for a switch type
809 * @type - the type of switch to set the default state of
810 * @state - the new default state for that group of switches
812 * Sets the initial state rfkill should use for a given type.
813 * The following initial states are allowed: RFKILL_STATE_SOFT_BLOCKED
814 * and RFKILL_STATE_UNBLOCKED.
816 * This function is meant to be used by platform drivers for platforms
817 * that can save switch state across power down/reboot.
819 * The default state for each switch type can be changed exactly once.
820 * After a switch of that type is registered, the default state cannot
821 * be changed anymore. This guards against multiple drivers it the
822 * same platform trying to set the initial switch default state, which
823 * is not allowed.
825 * Returns -EPERM if the state has already been set once or is in use,
826 * so drivers likely want to either ignore or at most printk(KERN_NOTICE)
827 * if this function returns -EPERM.
829 * Returns 0 if the new default state was set, or an error if it
830 * could not be set.
832 int rfkill_set_default(enum rfkill_type type, enum rfkill_state state)
834 int error;
836 if (WARN((type >= RFKILL_TYPE_MAX ||
837 (state != RFKILL_STATE_SOFT_BLOCKED &&
838 state != RFKILL_STATE_UNBLOCKED)),
839 KERN_WARNING
840 "rfkill: illegal state %d or type %d passed as "
841 "parameter to rfkill_set_default\n", state, type))
842 return -EINVAL;
844 mutex_lock(&rfkill_global_mutex);
846 if (!test_and_set_bit(type, rfkill_states_lockdflt)) {
847 rfkill_global_states[type].default_state = state;
848 error = 0;
849 } else
850 error = -EPERM;
852 mutex_unlock(&rfkill_global_mutex);
853 return error;
855 EXPORT_SYMBOL_GPL(rfkill_set_default);
858 * Rfkill module initialization/deinitialization.
860 static int __init rfkill_init(void)
862 int error;
863 int i;
865 /* RFKILL_STATE_HARD_BLOCKED is illegal here... */
866 if (rfkill_default_state != RFKILL_STATE_SOFT_BLOCKED &&
867 rfkill_default_state != RFKILL_STATE_UNBLOCKED)
868 return -EINVAL;
870 for (i = 0; i < RFKILL_TYPE_MAX; i++)
871 rfkill_global_states[i].default_state = rfkill_default_state;
873 error = class_register(&rfkill_class);
874 if (error) {
875 printk(KERN_ERR "rfkill: unable to register rfkill class\n");
876 return error;
879 register_rfkill_notifier(&rfkill_blocking_uevent_nb);
881 return 0;
884 static void __exit rfkill_exit(void)
886 unregister_rfkill_notifier(&rfkill_blocking_uevent_nb);
887 class_unregister(&rfkill_class);
890 subsys_initcall(rfkill_init);
891 module_exit(rfkill_exit);