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
);
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
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
)
80 return blocking_notifier_chain_register(&rfkill_notifier_list
, nb
);
82 EXPORT_SYMBOL_GPL(register_rfkill_notifier
);
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
91 * Removes a notifier from the rfkill notifier chain.
93 int unregister_rfkill_notifier(struct notifier_block
*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
;
109 if (state
!= RFKILL_STATE_UNBLOCKED
)
110 led_trigger_event(led
, LED_OFF
);
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 blocking_notifier_call_chain(&rfkill_notifier_list
,
129 RFKILL_STATE_CHANGED
,
133 static void update_rfkill_state(struct rfkill
*rfkill
)
135 enum rfkill_state newstate
, oldstate
;
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
);
145 mutex_unlock(&rfkill
->mutex
);
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
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.
161 * Suspended devices are not touched at all, and -EAGAIN is returned.
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.
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.
172 * Caller must have acquired rfkill->mutex.
174 static int rfkill_toggle_radio(struct rfkill
*rfkill
,
175 enum rfkill_state state
,
179 enum rfkill_state oldstate
, newstate
;
181 if (unlikely(rfkill
->dev
.power
.power_state
.event
& PM_EVENT_SLEEP
))
184 oldstate
= rfkill
->state
;
186 if (rfkill
->get_state
&& !force
&&
187 !rfkill
->get_state(rfkill
->data
, &newstate
))
188 rfkill
->state
= newstate
;
191 case RFKILL_STATE_HARD_BLOCKED
:
192 /* typically happens when refreshing hardware state,
193 * such as on resume */
194 state
= RFKILL_STATE_SOFT_BLOCKED
;
196 case RFKILL_STATE_UNBLOCKED
:
197 /* force can't override this, only rfkill_force_state() can */
198 if (rfkill
->state
== RFKILL_STATE_HARD_BLOCKED
)
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 */
208 "rfkill: illegal state %d passed as parameter "
209 "to rfkill_toggle_radio\n", state
);
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
;
220 if (force
|| rfkill
->state
!= oldstate
) {
221 rfkill_led_trigger(rfkill
, rfkill
->state
);
222 notify_rfkill_state_change(rfkill
);
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
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.
237 * Caller must have acquired rfkill_global_mutex.
239 static void __rfkill_switch_all(const enum rfkill_type type
,
240 const enum rfkill_state state
)
242 struct rfkill
*rfkill
;
244 if (WARN((state
>= RFKILL_STATE_MAX
|| type
>= RFKILL_TYPE_MAX
),
246 "rfkill: illegal state %d or type %d "
247 "passed as parameter to __rfkill_switch_all\n",
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
);
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
266 * Acquires rfkill_global_mutex and calls __rfkill_switch_all(@type, @state).
267 * Please refer to __rfkill_switch_all() for details.
269 void rfkill_switch_all(enum rfkill_type type
, enum rfkill_state state
)
271 mutex_lock(&rfkill_global_mutex
);
272 __rfkill_switch_all(type
, state
);
273 mutex_unlock(&rfkill_global_mutex
);
275 EXPORT_SYMBOL(rfkill_switch_all
);
278 * rfkill_epo - emergency power off all transmitters
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.
283 * The global state before the EPO is saved and can be restored later
284 * using rfkill_restore_states().
286 void rfkill_epo(void)
288 struct rfkill
*rfkill
;
291 mutex_lock(&rfkill_global_mutex
);
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
);
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
;
304 mutex_unlock(&rfkill_global_mutex
);
306 EXPORT_SYMBOL_GPL(rfkill_epo
);
309 * rfkill_restore_states - restore global states
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().
315 void rfkill_restore_states(void)
319 mutex_lock(&rfkill_global_mutex
);
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
);
325 EXPORT_SYMBOL_GPL(rfkill_restore_states
);
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.
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.
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.
342 * This function may not be called from an atomic context.
344 int rfkill_force_state(struct rfkill
*rfkill
, enum rfkill_state state
)
346 enum rfkill_state oldstate
;
349 if (WARN((state
>= RFKILL_STATE_MAX
),
351 "rfkill: illegal state %d passed as parameter "
352 "to rfkill_force_state\n", state
))
355 mutex_lock(&rfkill
->mutex
);
357 oldstate
= rfkill
->state
;
358 rfkill
->state
= state
;
360 if (state
!= oldstate
)
361 notify_rfkill_state_change(rfkill
);
363 mutex_unlock(&rfkill
->mutex
);
367 EXPORT_SYMBOL(rfkill_force_state
);
369 static ssize_t
rfkill_name_show(struct device
*dev
,
370 struct device_attribute
*attr
,
373 struct rfkill
*rfkill
= to_rfkill(dev
);
375 return sprintf(buf
, "%s\n", rfkill
->name
);
378 static const char *rfkill_get_type_str(enum rfkill_type type
)
381 case RFKILL_TYPE_WLAN
:
383 case RFKILL_TYPE_BLUETOOTH
:
385 case RFKILL_TYPE_UWB
:
386 return "ultrawideband";
387 case RFKILL_TYPE_WIMAX
:
389 case RFKILL_TYPE_WWAN
:
396 static ssize_t
rfkill_type_show(struct device
*dev
,
397 struct device_attribute
*attr
,
400 struct rfkill
*rfkill
= to_rfkill(dev
);
402 return sprintf(buf
, "%s\n", rfkill_get_type_str(rfkill
->type
));
405 static ssize_t
rfkill_state_show(struct device
*dev
,
406 struct device_attribute
*attr
,
409 struct rfkill
*rfkill
= to_rfkill(dev
);
411 update_rfkill_state(rfkill
);
412 return sprintf(buf
, "%d\n", rfkill
->state
);
415 static ssize_t
rfkill_state_store(struct device
*dev
,
416 struct device_attribute
*attr
,
417 const char *buf
, size_t count
)
419 struct rfkill
*rfkill
= to_rfkill(dev
);
423 if (!capable(CAP_NET_ADMIN
))
426 error
= strict_strtoul(buf
, 0, &state
);
430 /* RFKILL_STATE_HARD_BLOCKED is illegal here... */
431 if (state
!= RFKILL_STATE_UNBLOCKED
&&
432 state
!= RFKILL_STATE_SOFT_BLOCKED
)
435 if (mutex_lock_interruptible(&rfkill
->mutex
))
437 error
= rfkill_toggle_radio(rfkill
, state
, 0);
438 mutex_unlock(&rfkill
->mutex
);
440 return error
? error
: count
;
443 static ssize_t
rfkill_claim_show(struct device
*dev
,
444 struct device_attribute
*attr
,
447 struct rfkill
*rfkill
= to_rfkill(dev
);
449 return sprintf(buf
, "%d\n", rfkill
->user_claim
);
452 static ssize_t
rfkill_claim_store(struct device
*dev
,
453 struct device_attribute
*attr
,
454 const char *buf
, size_t count
)
456 struct rfkill
*rfkill
= to_rfkill(dev
);
457 unsigned long claim_tmp
;
461 if (!capable(CAP_NET_ADMIN
))
464 if (rfkill
->user_claim_unsupported
)
467 error
= strict_strtoul(buf
, 0, &claim_tmp
);
473 * Take the global lock to make sure the kernel is not in
474 * the middle of rfkill_switch_all
476 error
= mutex_lock_interruptible(&rfkill_global_mutex
);
480 if (rfkill
->user_claim
!= claim
) {
482 mutex_lock(&rfkill
->mutex
);
483 rfkill_toggle_radio(rfkill
,
484 rfkill_global_states
[rfkill
->type
].current_state
,
486 mutex_unlock(&rfkill
->mutex
);
488 rfkill
->user_claim
= claim
;
491 mutex_unlock(&rfkill_global_mutex
);
493 return error
? error
: count
;
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
),
504 static void rfkill_release(struct device
*dev
)
506 struct rfkill
*rfkill
= to_rfkill(dev
);
509 module_put(THIS_MODULE
);
513 static int rfkill_suspend(struct device
*dev
, pm_message_t state
)
515 struct rfkill
*rfkill
= to_rfkill(dev
);
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
);
522 mutex_lock(&rfkill
->mutex
);
523 rfkill
->toggle_radio(rfkill
->data
,
524 RFKILL_STATE_SOFT_BLOCKED
);
525 mutex_unlock(&rfkill
->mutex
);
528 dev
->power
.power_state
= state
;
534 static int rfkill_resume(struct device
*dev
)
536 struct rfkill
*rfkill
= to_rfkill(dev
);
538 if (dev
->power
.power_state
.event
!= PM_EVENT_ON
) {
539 mutex_lock(&rfkill
->mutex
);
541 dev
->power
.power_state
.event
= PM_EVENT_ON
;
543 /* restore radio state AND notify everybody */
544 rfkill_toggle_radio(rfkill
, rfkill
->state
, 1);
546 mutex_unlock(&rfkill
->mutex
);
552 #define rfkill_suspend NULL
553 #define rfkill_resume NULL
556 static int rfkill_blocking_uevent_notifier(struct notifier_block
*nb
,
557 unsigned long eventid
,
560 struct rfkill
*rfkill
= (struct rfkill
*)data
;
563 case RFKILL_STATE_CHANGED
:
564 kobject_uevent(&rfkill
->dev
.kobj
, KOBJ_CHANGE
);
573 static struct notifier_block rfkill_blocking_uevent_nb
= {
574 .notifier_call
= rfkill_blocking_uevent_notifier
,
578 static int rfkill_dev_uevent(struct device
*dev
, struct kobj_uevent_env
*env
)
580 struct rfkill
*rfkill
= to_rfkill(dev
);
583 error
= add_uevent_var(env
, "RFKILL_NAME=%s", rfkill
->name
);
586 error
= add_uevent_var(env
, "RFKILL_TYPE=%s",
587 rfkill_get_type_str(rfkill
->type
));
590 error
= add_uevent_var(env
, "RFKILL_STATE=%d", rfkill
->state
);
594 static struct class rfkill_class
= {
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
,
603 static int rfkill_check_duplicity(const struct rfkill
*rfkill
)
606 unsigned long seen
[BITS_TO_LONGS(RFKILL_TYPE_MAX
)];
608 memset(seen
, 0, sizeof(seen
));
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"))
615 set_bit(p
->type
, seen
);
618 /* 0: first switch of its kind */
619 return test_bit(rfkill
->type
, seen
);
622 static int rfkill_add_switch(struct rfkill
*rfkill
)
626 mutex_lock(&rfkill_global_mutex
);
628 error
= rfkill_check_duplicity(rfkill
);
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
;
639 rfkill_toggle_radio(rfkill
,
640 rfkill_global_states
[rfkill
->type
].current_state
,
643 list_add_tail(&rfkill
->node
, &rfkill_list
);
647 mutex_unlock(&rfkill_global_mutex
);
652 static void rfkill_remove_switch(struct rfkill
*rfkill
)
654 mutex_lock(&rfkill_global_mutex
);
655 list_del_init(&rfkill
->node
);
656 mutex_unlock(&rfkill_global_mutex
);
658 mutex_lock(&rfkill
->mutex
);
659 rfkill_toggle_radio(rfkill
, RFKILL_STATE_SOFT_BLOCKED
, 1);
660 mutex_unlock(&rfkill
->mutex
);
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_*)
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().
673 * NOTE: If registration fails the structure shoudl be freed by calling
674 * rfkill_free() otherwise rfkill_unregister() should be used.
676 struct rfkill
* __must_check
rfkill_allocate(struct device
*parent
,
677 enum rfkill_type type
)
679 struct rfkill
*rfkill
;
682 if (WARN((type
>= RFKILL_TYPE_MAX
),
684 "rfkill: illegal type %d passed as parameter "
685 "to rfkill_allocate\n", type
))
688 rfkill
= kzalloc(sizeof(struct rfkill
), GFP_KERNEL
);
692 mutex_init(&rfkill
->mutex
);
693 INIT_LIST_HEAD(&rfkill
->node
);
697 dev
->class = &rfkill_class
;
698 dev
->parent
= parent
;
699 device_initialize(dev
);
701 __module_get(THIS_MODULE
);
705 EXPORT_SYMBOL(rfkill_allocate
);
708 * rfkill_free - Mark rfkill structure for deletion
709 * @rfkill: rfkill structure to be destroyed
711 * Decrements reference count of the rfkill structure so it is destroyed.
712 * Note that rfkill_free() should _not_ be called after rfkill_unregister().
714 void rfkill_free(struct rfkill
*rfkill
)
717 put_device(&rfkill
->dev
);
719 EXPORT_SYMBOL(rfkill_free
);
721 static void rfkill_led_trigger_register(struct rfkill
*rfkill
)
723 #ifdef CONFIG_RFKILL_LEDS
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
);
732 rfkill
->led_trigger
.name
= NULL
;
733 #endif /* CONFIG_RFKILL_LEDS */
736 static void rfkill_led_trigger_unregister(struct rfkill
*rfkill
)
738 #ifdef CONFIG_RFKILL_LEDS
739 if (rfkill
->led_trigger
.name
) {
740 led_trigger_unregister(&rfkill
->led_trigger
);
741 rfkill
->led_trigger
.name
= NULL
;
747 * rfkill_register - Register a rfkill structure.
748 * @rfkill: rfkill structure to be registered
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.
754 int __must_check
rfkill_register(struct rfkill
*rfkill
)
756 static atomic_t rfkill_no
= ATOMIC_INIT(0);
757 struct device
*dev
= &rfkill
->dev
;
760 if (WARN((!rfkill
|| !rfkill
->toggle_radio
||
761 rfkill
->type
>= RFKILL_TYPE_MAX
||
762 rfkill
->state
>= RFKILL_STATE_MAX
),
764 "rfkill: attempt to register a "
765 "badly initialized rfkill struct\n"))
768 snprintf(dev
->bus_id
, sizeof(dev
->bus_id
),
769 "rfkill%ld", (long)atomic_inc_return(&rfkill_no
) - 1);
771 rfkill_led_trigger_register(rfkill
);
773 error
= rfkill_add_switch(rfkill
);
775 rfkill_led_trigger_unregister(rfkill
);
779 error
= device_add(dev
);
781 rfkill_remove_switch(rfkill
);
782 rfkill_led_trigger_unregister(rfkill
);
788 EXPORT_SYMBOL(rfkill_register
);
791 * rfkill_unregister - Unregister a rfkill structure.
792 * @rfkill: rfkill structure to be unregistered
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().
798 void rfkill_unregister(struct rfkill
*rfkill
)
801 device_del(&rfkill
->dev
);
802 rfkill_remove_switch(rfkill
);
803 rfkill_led_trigger_unregister(rfkill
);
804 put_device(&rfkill
->dev
);
806 EXPORT_SYMBOL(rfkill_unregister
);
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
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.
817 * This function is meant to be used by platform drivers for platforms
818 * that can save switch state across power down/reboot.
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
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.
830 * Returns 0 if the new default state was set, or an error if it
833 int rfkill_set_default(enum rfkill_type type
, enum rfkill_state state
)
837 if (WARN((type
>= RFKILL_TYPE_MAX
||
838 (state
!= RFKILL_STATE_SOFT_BLOCKED
&&
839 state
!= RFKILL_STATE_UNBLOCKED
)),
841 "rfkill: illegal state %d or type %d passed as "
842 "parameter to rfkill_set_default\n", state
, type
))
845 mutex_lock(&rfkill_global_mutex
);
847 if (!test_and_set_bit(type
, rfkill_states_lockdflt
)) {
848 rfkill_global_states
[type
].default_state
= state
;
853 mutex_unlock(&rfkill_global_mutex
);
856 EXPORT_SYMBOL_GPL(rfkill_set_default
);
859 * Rfkill module initialization/deinitialization.
861 static int __init
rfkill_init(void)
866 /* RFKILL_STATE_HARD_BLOCKED is illegal here... */
867 if (rfkill_default_state
!= RFKILL_STATE_SOFT_BLOCKED
&&
868 rfkill_default_state
!= RFKILL_STATE_UNBLOCKED
)
871 for (i
= 0; i
< RFKILL_TYPE_MAX
; i
++)
872 rfkill_global_states
[i
].default_state
= rfkill_default_state
;
874 error
= class_register(&rfkill_class
);
876 printk(KERN_ERR
"rfkill: unable to register rfkill class\n");
880 register_rfkill_notifier(&rfkill_blocking_uevent_nb
);
885 static void __exit
rfkill_exit(void)
887 unregister_rfkill_notifier(&rfkill_blocking_uevent_nb
);
888 class_unregister(&rfkill_class
);
891 subsys_initcall(rfkill_init
);
892 module_exit(rfkill_exit
);