summaryrefslogtreecommitdiff
path: root/Software/urfkill.mdwn
blob: ae690f93b2b2a2c38d161915a1086c1448457043 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59


# urfkill

For the laptop and mobile devices users, the management of the radio killswitches is important for the connectivity and power consumption. [[HAL|Software/hal]] used to take care of this job, but it is now [[deprecated|http://lists.freedesktop.org/archives/hal/2008-May/011560.html]]. The urfkill project is created to fill the gap and to provide more flexible configuration for the rfkill-related function keys. 


## Download

The latest release is 0.3.0 and can be downloaded from [[github|https://github.com/downloads/lcp/urfkill/urfkill-0.3.0.tar.xz]]. 

Development happens in [[git|GettingInvolved]].  There is a [[web interface|https://github.com/lcp/urfkill/]] to the repository. 


## Documentation

The documents of the D-Bus API and liburfkill-glib can be found [[here|http://lcp.github.com/urfkill-doc/]]. 


### HowTo

[[How to launch urfkill during system boot|Software/urfkill/HowToLaunch]] 


## Known Issues

* For Lenovo Thinkpad X200, the bluetooth killswitch (hci0) sometimes was soft-blocked after turning on bluetooth.  

Solution: set "force_sync" to true in /etc/urfkill/urfkill.conf 

* The bluetooth killswitches cannot be controlled by urfkilld in Lenovo [[ThinkPad|ThinkPad]] laptops. 

The states of the bluetooth killswitches in [[ThinkPad|ThinkPad]] are maintained by the kernel platform drivers, i.e. thinkpad_acpi, and urfkilld has no way to change it. 

Solution: please leave them alone. 


## Bugs

Please mail to Gary Lin ([[glin@suse.com|mailto:glin@suse.com]]) and Joey Lee ([[jlee@suse.com|mailto:jlee@suse.com]]) or poke me (glin) on #udev/irc.freenode.net 


## Client

* [[rfkiller|https://github.com/lcp/rfkiller]] - a gnome-extension which utilizes urfkill to manage killswitches. 


## TODO

* Provide a policy for the user to setup rfkill control rules when catching WLAN/BT/3G keycodes. 
* Integrate with GUI to provide power consumption function to user, e.g. 
         * Killswitch-Manager 
         * killswitch-applet 
         * python-killswitch 


---

 [[CategoryHalReplacement|CategoryHalReplacement]]