rfkill.c 22 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850
  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. #include <linux/kernel.h>
  21. #include <linux/module.h>
  22. #include <linux/init.h>
  23. #include <linux/workqueue.h>
  24. #include <linux/capability.h>
  25. #include <linux/list.h>
  26. #include <linux/mutex.h>
  27. #include <linux/rfkill.h>
  28. /* Get declaration of rfkill_switch_all() to shut up sparse. */
  29. #include "rfkill-input.h"
  30. MODULE_AUTHOR("Ivo van Doorn <IvDoorn@gmail.com>");
  31. MODULE_VERSION("1.0");
  32. MODULE_DESCRIPTION("RF switch support");
  33. MODULE_LICENSE("GPL");
  34. static LIST_HEAD(rfkill_list); /* list of registered rf switches */
  35. static DEFINE_MUTEX(rfkill_global_mutex);
  36. static unsigned int rfkill_default_state = RFKILL_STATE_UNBLOCKED;
  37. module_param_named(default_state, rfkill_default_state, uint, 0444);
  38. MODULE_PARM_DESC(default_state,
  39. "Default initial state for all radio types, 0 = radio off");
  40. struct rfkill_gsw_state {
  41. enum rfkill_state current_state;
  42. enum rfkill_state default_state;
  43. };
  44. static struct rfkill_gsw_state rfkill_global_states[RFKILL_TYPE_MAX];
  45. static unsigned long rfkill_states_lockdflt[BITS_TO_LONGS(RFKILL_TYPE_MAX)];
  46. static bool rfkill_epo_lock_active;
  47. #ifdef CONFIG_RFKILL_LEDS
  48. static void rfkill_led_trigger(struct rfkill *rfkill,
  49. enum rfkill_state state)
  50. {
  51. struct led_trigger *led = &rfkill->led_trigger;
  52. if (!led->name)
  53. return;
  54. if (state != RFKILL_STATE_UNBLOCKED)
  55. led_trigger_event(led, LED_OFF);
  56. else
  57. led_trigger_event(led, LED_FULL);
  58. }
  59. static void rfkill_led_trigger_activate(struct led_classdev *led)
  60. {
  61. struct rfkill *rfkill = container_of(led->trigger,
  62. struct rfkill, led_trigger);
  63. rfkill_led_trigger(rfkill, rfkill->state);
  64. }
  65. #endif /* CONFIG_RFKILL_LEDS */
  66. static void rfkill_uevent(struct rfkill *rfkill)
  67. {
  68. kobject_uevent(&rfkill->dev.kobj, KOBJ_CHANGE);
  69. }
  70. static void update_rfkill_state(struct rfkill *rfkill)
  71. {
  72. enum rfkill_state newstate, oldstate;
  73. if (rfkill->get_state) {
  74. mutex_lock(&rfkill->mutex);
  75. if (!rfkill->get_state(rfkill->data, &newstate)) {
  76. oldstate = rfkill->state;
  77. rfkill->state = newstate;
  78. if (oldstate != newstate)
  79. rfkill_uevent(rfkill);
  80. }
  81. mutex_unlock(&rfkill->mutex);
  82. }
  83. rfkill_led_trigger(rfkill, rfkill->state);
  84. }
  85. /**
  86. * rfkill_toggle_radio - wrapper for toggle_radio hook
  87. * @rfkill: the rfkill struct to use
  88. * @force: calls toggle_radio even if cache says it is not needed,
  89. * and also makes sure notifications of the state will be
  90. * sent even if it didn't change
  91. * @state: the new state to call toggle_radio() with
  92. *
  93. * Calls rfkill->toggle_radio, enforcing the API for toggle_radio
  94. * calls and handling all the red tape such as issuing notifications
  95. * if the call is successful.
  96. *
  97. * Suspended devices are not touched at all, and -EAGAIN is returned.
  98. *
  99. * Note that the @force parameter cannot override a (possibly cached)
  100. * state of RFKILL_STATE_HARD_BLOCKED. Any device making use of
  101. * RFKILL_STATE_HARD_BLOCKED implements either get_state() or
  102. * rfkill_force_state(), so the cache either is bypassed or valid.
  103. *
  104. * Note that we do call toggle_radio for RFKILL_STATE_SOFT_BLOCKED
  105. * even if the radio is in RFKILL_STATE_HARD_BLOCKED state, so as to
  106. * give the driver a hint that it should double-BLOCK the transmitter.
  107. *
  108. * Caller must have acquired rfkill->mutex.
  109. */
  110. static int rfkill_toggle_radio(struct rfkill *rfkill,
  111. enum rfkill_state state,
  112. int force)
  113. {
  114. int retval = 0;
  115. enum rfkill_state oldstate, newstate;
  116. if (unlikely(rfkill->dev.power.power_state.event & PM_EVENT_SLEEP))
  117. return -EBUSY;
  118. oldstate = rfkill->state;
  119. if (rfkill->get_state && !force &&
  120. !rfkill->get_state(rfkill->data, &newstate)) {
  121. rfkill->state = newstate;
  122. }
  123. switch (state) {
  124. case RFKILL_STATE_HARD_BLOCKED:
  125. /* typically happens when refreshing hardware state,
  126. * such as on resume */
  127. state = RFKILL_STATE_SOFT_BLOCKED;
  128. break;
  129. case RFKILL_STATE_UNBLOCKED:
  130. /* force can't override this, only rfkill_force_state() can */
  131. if (rfkill->state == RFKILL_STATE_HARD_BLOCKED)
  132. return -EPERM;
  133. break;
  134. case RFKILL_STATE_SOFT_BLOCKED:
  135. /* nothing to do, we want to give drivers the hint to double
  136. * BLOCK even a transmitter that is already in state
  137. * RFKILL_STATE_HARD_BLOCKED */
  138. break;
  139. default:
  140. WARN(1, KERN_WARNING
  141. "rfkill: illegal state %d passed as parameter "
  142. "to rfkill_toggle_radio\n", state);
  143. return -EINVAL;
  144. }
  145. if (force || state != rfkill->state) {
  146. retval = rfkill->toggle_radio(rfkill->data, state);
  147. /* never allow a HARD->SOFT downgrade! */
  148. if (!retval && rfkill->state != RFKILL_STATE_HARD_BLOCKED)
  149. rfkill->state = state;
  150. }
  151. if (force || rfkill->state != oldstate)
  152. rfkill_uevent(rfkill);
  153. rfkill_led_trigger(rfkill, rfkill->state);
  154. return retval;
  155. }
  156. /**
  157. * __rfkill_switch_all - Toggle state of all switches of given type
  158. * @type: type of interfaces to be affected
  159. * @state: the new state
  160. *
  161. * This function toggles the state of all switches of given type,
  162. * unless a specific switch is claimed by userspace (in which case,
  163. * that switch is left alone) or suspended.
  164. *
  165. * Caller must have acquired rfkill_global_mutex.
  166. */
  167. static void __rfkill_switch_all(const enum rfkill_type type,
  168. const enum rfkill_state state)
  169. {
  170. struct rfkill *rfkill;
  171. if (WARN((state >= RFKILL_STATE_MAX || type >= RFKILL_TYPE_MAX),
  172. KERN_WARNING
  173. "rfkill: illegal state %d or type %d "
  174. "passed as parameter to __rfkill_switch_all\n",
  175. state, type))
  176. return;
  177. rfkill_global_states[type].current_state = state;
  178. list_for_each_entry(rfkill, &rfkill_list, node) {
  179. if (rfkill->type == type) {
  180. mutex_lock(&rfkill->mutex);
  181. rfkill_toggle_radio(rfkill, state, 0);
  182. mutex_unlock(&rfkill->mutex);
  183. rfkill_led_trigger(rfkill, rfkill->state);
  184. }
  185. }
  186. }
  187. /**
  188. * rfkill_switch_all - Toggle state of all switches of given type
  189. * @type: type of interfaces to be affected
  190. * @state: the new state
  191. *
  192. * Acquires rfkill_global_mutex and calls __rfkill_switch_all(@type, @state).
  193. * Please refer to __rfkill_switch_all() for details.
  194. *
  195. * Does nothing if the EPO lock is active.
  196. */
  197. void rfkill_switch_all(enum rfkill_type type, enum rfkill_state state)
  198. {
  199. mutex_lock(&rfkill_global_mutex);
  200. if (!rfkill_epo_lock_active)
  201. __rfkill_switch_all(type, state);
  202. mutex_unlock(&rfkill_global_mutex);
  203. }
  204. EXPORT_SYMBOL(rfkill_switch_all);
  205. /**
  206. * rfkill_epo - emergency power off all transmitters
  207. *
  208. * This kicks all non-suspended rfkill devices to RFKILL_STATE_SOFT_BLOCKED,
  209. * ignoring everything in its path but rfkill_global_mutex and rfkill->mutex.
  210. *
  211. * The global state before the EPO is saved and can be restored later
  212. * using rfkill_restore_states().
  213. */
  214. void rfkill_epo(void)
  215. {
  216. struct rfkill *rfkill;
  217. int i;
  218. mutex_lock(&rfkill_global_mutex);
  219. rfkill_epo_lock_active = true;
  220. list_for_each_entry(rfkill, &rfkill_list, node) {
  221. mutex_lock(&rfkill->mutex);
  222. rfkill_toggle_radio(rfkill, RFKILL_STATE_SOFT_BLOCKED, 1);
  223. mutex_unlock(&rfkill->mutex);
  224. }
  225. for (i = 0; i < RFKILL_TYPE_MAX; i++) {
  226. rfkill_global_states[i].default_state =
  227. rfkill_global_states[i].current_state;
  228. rfkill_global_states[i].current_state =
  229. RFKILL_STATE_SOFT_BLOCKED;
  230. }
  231. mutex_unlock(&rfkill_global_mutex);
  232. rfkill_led_trigger(rfkill, rfkill->state);
  233. }
  234. EXPORT_SYMBOL_GPL(rfkill_epo);
  235. /**
  236. * rfkill_restore_states - restore global states
  237. *
  238. * Restore (and sync switches to) the global state from the
  239. * states in rfkill_default_states. This can undo the effects of
  240. * a call to rfkill_epo().
  241. */
  242. void rfkill_restore_states(void)
  243. {
  244. int i;
  245. mutex_lock(&rfkill_global_mutex);
  246. rfkill_epo_lock_active = false;
  247. for (i = 0; i < RFKILL_TYPE_MAX; i++)
  248. __rfkill_switch_all(i, rfkill_global_states[i].default_state);
  249. mutex_unlock(&rfkill_global_mutex);
  250. }
  251. EXPORT_SYMBOL_GPL(rfkill_restore_states);
  252. /**
  253. * rfkill_remove_epo_lock - unlock state changes
  254. *
  255. * Used by rfkill-input manually unlock state changes, when
  256. * the EPO switch is deactivated.
  257. */
  258. void rfkill_remove_epo_lock(void)
  259. {
  260. mutex_lock(&rfkill_global_mutex);
  261. rfkill_epo_lock_active = false;
  262. mutex_unlock(&rfkill_global_mutex);
  263. }
  264. EXPORT_SYMBOL_GPL(rfkill_remove_epo_lock);
  265. /**
  266. * rfkill_is_epo_lock_active - returns true EPO is active
  267. *
  268. * Returns 0 (false) if there is NOT an active EPO contidion,
  269. * and 1 (true) if there is an active EPO contition, which
  270. * locks all radios in one of the BLOCKED states.
  271. *
  272. * Can be called in atomic context.
  273. */
  274. bool rfkill_is_epo_lock_active(void)
  275. {
  276. return rfkill_epo_lock_active;
  277. }
  278. EXPORT_SYMBOL_GPL(rfkill_is_epo_lock_active);
  279. /**
  280. * rfkill_get_global_state - returns global state for a type
  281. * @type: the type to get the global state of
  282. *
  283. * Returns the current global state for a given wireless
  284. * device type.
  285. */
  286. enum rfkill_state rfkill_get_global_state(const enum rfkill_type type)
  287. {
  288. return rfkill_global_states[type].current_state;
  289. }
  290. EXPORT_SYMBOL_GPL(rfkill_get_global_state);
  291. /**
  292. * rfkill_force_state - Force the internal rfkill radio state
  293. * @rfkill: pointer to the rfkill class to modify.
  294. * @state: the current radio state the class should be forced to.
  295. *
  296. * This function updates the internal state of the radio cached
  297. * by the rfkill class. It should be used when the driver gets
  298. * a notification by the firmware/hardware of the current *real*
  299. * state of the radio rfkill switch.
  300. *
  301. * Devices which are subject to external changes on their rfkill
  302. * state (such as those caused by a hardware rfkill line) MUST
  303. * have their driver arrange to call rfkill_force_state() as soon
  304. * as possible after such a change.
  305. *
  306. * This function may not be called from an atomic context.
  307. */
  308. int rfkill_force_state(struct rfkill *rfkill, enum rfkill_state state)
  309. {
  310. enum rfkill_state oldstate;
  311. BUG_ON(!rfkill);
  312. if (WARN((state >= RFKILL_STATE_MAX),
  313. KERN_WARNING
  314. "rfkill: illegal state %d passed as parameter "
  315. "to rfkill_force_state\n", state))
  316. return -EINVAL;
  317. mutex_lock(&rfkill->mutex);
  318. oldstate = rfkill->state;
  319. rfkill->state = state;
  320. if (state != oldstate)
  321. rfkill_uevent(rfkill);
  322. mutex_unlock(&rfkill->mutex);
  323. rfkill_led_trigger(rfkill, rfkill->state);
  324. return 0;
  325. }
  326. EXPORT_SYMBOL(rfkill_force_state);
  327. static ssize_t rfkill_name_show(struct device *dev,
  328. struct device_attribute *attr,
  329. char *buf)
  330. {
  331. struct rfkill *rfkill = to_rfkill(dev);
  332. return sprintf(buf, "%s\n", rfkill->name);
  333. }
  334. static const char *rfkill_get_type_str(enum rfkill_type type)
  335. {
  336. switch (type) {
  337. case RFKILL_TYPE_WLAN:
  338. return "wlan";
  339. case RFKILL_TYPE_BLUETOOTH:
  340. return "bluetooth";
  341. case RFKILL_TYPE_UWB:
  342. return "ultrawideband";
  343. case RFKILL_TYPE_WIMAX:
  344. return "wimax";
  345. case RFKILL_TYPE_WWAN:
  346. return "wwan";
  347. default:
  348. BUG();
  349. }
  350. }
  351. static ssize_t rfkill_type_show(struct device *dev,
  352. struct device_attribute *attr,
  353. char *buf)
  354. {
  355. struct rfkill *rfkill = to_rfkill(dev);
  356. return sprintf(buf, "%s\n", rfkill_get_type_str(rfkill->type));
  357. }
  358. static ssize_t rfkill_state_show(struct device *dev,
  359. struct device_attribute *attr,
  360. char *buf)
  361. {
  362. struct rfkill *rfkill = to_rfkill(dev);
  363. update_rfkill_state(rfkill);
  364. return sprintf(buf, "%d\n", rfkill->state);
  365. }
  366. static ssize_t rfkill_state_store(struct device *dev,
  367. struct device_attribute *attr,
  368. const char *buf, size_t count)
  369. {
  370. struct rfkill *rfkill = to_rfkill(dev);
  371. unsigned long state;
  372. int error;
  373. if (!capable(CAP_NET_ADMIN))
  374. return -EPERM;
  375. error = strict_strtoul(buf, 0, &state);
  376. if (error)
  377. return error;
  378. /* RFKILL_STATE_HARD_BLOCKED is illegal here... */
  379. if (state != RFKILL_STATE_UNBLOCKED &&
  380. state != RFKILL_STATE_SOFT_BLOCKED)
  381. return -EINVAL;
  382. error = mutex_lock_killable(&rfkill->mutex);
  383. if (error)
  384. return error;
  385. if (!rfkill_epo_lock_active)
  386. error = rfkill_toggle_radio(rfkill, state, 0);
  387. else
  388. error = -EPERM;
  389. mutex_unlock(&rfkill->mutex);
  390. return error ? error : count;
  391. }
  392. static ssize_t rfkill_claim_show(struct device *dev,
  393. struct device_attribute *attr,
  394. char *buf)
  395. {
  396. return sprintf(buf, "%d\n", 0);
  397. }
  398. static ssize_t rfkill_claim_store(struct device *dev,
  399. struct device_attribute *attr,
  400. const char *buf, size_t count)
  401. {
  402. return -EOPNOTSUPP;
  403. }
  404. static struct device_attribute rfkill_dev_attrs[] = {
  405. __ATTR(name, S_IRUGO, rfkill_name_show, NULL),
  406. __ATTR(type, S_IRUGO, rfkill_type_show, NULL),
  407. __ATTR(state, S_IRUGO|S_IWUSR, rfkill_state_show, rfkill_state_store),
  408. __ATTR(claim, S_IRUGO|S_IWUSR, rfkill_claim_show, rfkill_claim_store),
  409. __ATTR_NULL
  410. };
  411. static void rfkill_release(struct device *dev)
  412. {
  413. struct rfkill *rfkill = to_rfkill(dev);
  414. kfree(rfkill);
  415. module_put(THIS_MODULE);
  416. }
  417. #ifdef CONFIG_PM
  418. static int rfkill_suspend(struct device *dev, pm_message_t state)
  419. {
  420. struct rfkill *rfkill = to_rfkill(dev);
  421. /* mark class device as suspended */
  422. if (dev->power.power_state.event != state.event)
  423. dev->power.power_state = state;
  424. /* store state for the resume handler */
  425. rfkill->state_for_resume = rfkill->state;
  426. return 0;
  427. }
  428. static int rfkill_resume(struct device *dev)
  429. {
  430. struct rfkill *rfkill = to_rfkill(dev);
  431. enum rfkill_state newstate;
  432. if (dev->power.power_state.event != PM_EVENT_ON) {
  433. mutex_lock(&rfkill->mutex);
  434. dev->power.power_state.event = PM_EVENT_ON;
  435. /*
  436. * rfkill->state could have been modified before we got
  437. * called, and won't be updated by rfkill_toggle_radio()
  438. * in force mode. Sync it FIRST.
  439. */
  440. if (rfkill->get_state &&
  441. !rfkill->get_state(rfkill->data, &newstate))
  442. rfkill->state = newstate;
  443. /*
  444. * If we are under EPO, kick transmitter offline,
  445. * otherwise restore to pre-suspend state.
  446. *
  447. * Issue a notification in any case
  448. */
  449. rfkill_toggle_radio(rfkill,
  450. rfkill_epo_lock_active ?
  451. RFKILL_STATE_SOFT_BLOCKED :
  452. rfkill->state_for_resume,
  453. 1);
  454. mutex_unlock(&rfkill->mutex);
  455. rfkill_led_trigger(rfkill, rfkill->state);
  456. }
  457. return 0;
  458. }
  459. #else
  460. #define rfkill_suspend NULL
  461. #define rfkill_resume NULL
  462. #endif
  463. static int rfkill_dev_uevent(struct device *dev, struct kobj_uevent_env *env)
  464. {
  465. struct rfkill *rfkill = to_rfkill(dev);
  466. int error;
  467. error = add_uevent_var(env, "RFKILL_NAME=%s", rfkill->name);
  468. if (error)
  469. return error;
  470. error = add_uevent_var(env, "RFKILL_TYPE=%s",
  471. rfkill_get_type_str(rfkill->type));
  472. if (error)
  473. return error;
  474. error = add_uevent_var(env, "RFKILL_STATE=%d", rfkill->state);
  475. return error;
  476. }
  477. static struct class rfkill_class = {
  478. .name = "rfkill",
  479. .dev_release = rfkill_release,
  480. .dev_attrs = rfkill_dev_attrs,
  481. .suspend = rfkill_suspend,
  482. .resume = rfkill_resume,
  483. .dev_uevent = rfkill_dev_uevent,
  484. };
  485. static int rfkill_check_duplicity(const struct rfkill *rfkill)
  486. {
  487. struct rfkill *p;
  488. unsigned long seen[BITS_TO_LONGS(RFKILL_TYPE_MAX)];
  489. memset(seen, 0, sizeof(seen));
  490. list_for_each_entry(p, &rfkill_list, node) {
  491. if (WARN((p == rfkill), KERN_WARNING
  492. "rfkill: illegal attempt to register "
  493. "an already registered rfkill struct\n"))
  494. return -EEXIST;
  495. set_bit(p->type, seen);
  496. }
  497. /* 0: first switch of its kind */
  498. return (test_bit(rfkill->type, seen)) ? 1 : 0;
  499. }
  500. static int rfkill_add_switch(struct rfkill *rfkill)
  501. {
  502. int error;
  503. mutex_lock(&rfkill_global_mutex);
  504. error = rfkill_check_duplicity(rfkill);
  505. if (error < 0)
  506. goto unlock_out;
  507. if (!error) {
  508. /* lock default after first use */
  509. set_bit(rfkill->type, rfkill_states_lockdflt);
  510. rfkill_global_states[rfkill->type].current_state =
  511. rfkill_global_states[rfkill->type].default_state;
  512. }
  513. rfkill_toggle_radio(rfkill,
  514. rfkill_global_states[rfkill->type].current_state,
  515. 0);
  516. list_add_tail(&rfkill->node, &rfkill_list);
  517. error = 0;
  518. unlock_out:
  519. mutex_unlock(&rfkill_global_mutex);
  520. return error;
  521. }
  522. static void rfkill_remove_switch(struct rfkill *rfkill)
  523. {
  524. mutex_lock(&rfkill_global_mutex);
  525. list_del_init(&rfkill->node);
  526. mutex_unlock(&rfkill_global_mutex);
  527. mutex_lock(&rfkill->mutex);
  528. rfkill_toggle_radio(rfkill, RFKILL_STATE_SOFT_BLOCKED, 1);
  529. mutex_unlock(&rfkill->mutex);
  530. }
  531. /**
  532. * rfkill_allocate - allocate memory for rfkill structure.
  533. * @parent: device that has rf switch on it
  534. * @type: type of the switch (RFKILL_TYPE_*)
  535. *
  536. * This function should be called by the network driver when it needs
  537. * rfkill structure. Once the structure is allocated the driver should
  538. * finish its initialization by setting the name, private data, enable_radio
  539. * and disable_radio methods and then register it with rfkill_register().
  540. *
  541. * NOTE: If registration fails the structure shoudl be freed by calling
  542. * rfkill_free() otherwise rfkill_unregister() should be used.
  543. */
  544. struct rfkill * __must_check rfkill_allocate(struct device *parent,
  545. enum rfkill_type type)
  546. {
  547. struct rfkill *rfkill;
  548. struct device *dev;
  549. if (WARN((type >= RFKILL_TYPE_MAX),
  550. KERN_WARNING
  551. "rfkill: illegal type %d passed as parameter "
  552. "to rfkill_allocate\n", type))
  553. return NULL;
  554. rfkill = kzalloc(sizeof(struct rfkill), GFP_KERNEL);
  555. if (!rfkill)
  556. return NULL;
  557. mutex_init(&rfkill->mutex);
  558. INIT_LIST_HEAD(&rfkill->node);
  559. rfkill->type = type;
  560. dev = &rfkill->dev;
  561. dev->class = &rfkill_class;
  562. dev->parent = parent;
  563. device_initialize(dev);
  564. __module_get(THIS_MODULE);
  565. return rfkill;
  566. }
  567. EXPORT_SYMBOL(rfkill_allocate);
  568. /**
  569. * rfkill_free - Mark rfkill structure for deletion
  570. * @rfkill: rfkill structure to be destroyed
  571. *
  572. * Decrements reference count of the rfkill structure so it is destroyed.
  573. * Note that rfkill_free() should _not_ be called after rfkill_unregister().
  574. */
  575. void rfkill_free(struct rfkill *rfkill)
  576. {
  577. if (rfkill)
  578. put_device(&rfkill->dev);
  579. }
  580. EXPORT_SYMBOL(rfkill_free);
  581. static void rfkill_led_trigger_register(struct rfkill *rfkill)
  582. {
  583. #ifdef CONFIG_RFKILL_LEDS
  584. int error;
  585. if (!rfkill->led_trigger.name)
  586. rfkill->led_trigger.name = dev_name(&rfkill->dev);
  587. if (!rfkill->led_trigger.activate)
  588. rfkill->led_trigger.activate = rfkill_led_trigger_activate;
  589. error = led_trigger_register(&rfkill->led_trigger);
  590. if (error)
  591. rfkill->led_trigger.name = NULL;
  592. #endif /* CONFIG_RFKILL_LEDS */
  593. }
  594. static void rfkill_led_trigger_unregister(struct rfkill *rfkill)
  595. {
  596. #ifdef CONFIG_RFKILL_LEDS
  597. if (rfkill->led_trigger.name) {
  598. led_trigger_unregister(&rfkill->led_trigger);
  599. rfkill->led_trigger.name = NULL;
  600. }
  601. #endif
  602. }
  603. /**
  604. * rfkill_register - Register a rfkill structure.
  605. * @rfkill: rfkill structure to be registered
  606. *
  607. * This function should be called by the network driver when the rfkill
  608. * structure needs to be registered. Immediately from registration the
  609. * switch driver should be able to service calls to toggle_radio.
  610. */
  611. int __must_check rfkill_register(struct rfkill *rfkill)
  612. {
  613. static atomic_t rfkill_no = ATOMIC_INIT(0);
  614. struct device *dev = &rfkill->dev;
  615. int error;
  616. if (WARN((!rfkill || !rfkill->toggle_radio ||
  617. rfkill->type >= RFKILL_TYPE_MAX ||
  618. rfkill->state >= RFKILL_STATE_MAX),
  619. KERN_WARNING
  620. "rfkill: attempt to register a "
  621. "badly initialized rfkill struct\n"))
  622. return -EINVAL;
  623. dev_set_name(dev, "rfkill%ld", (long)atomic_inc_return(&rfkill_no) - 1);
  624. rfkill_led_trigger_register(rfkill);
  625. error = rfkill_add_switch(rfkill);
  626. if (error) {
  627. rfkill_led_trigger_unregister(rfkill);
  628. return error;
  629. }
  630. error = device_add(dev);
  631. if (error) {
  632. rfkill_remove_switch(rfkill);
  633. rfkill_led_trigger_unregister(rfkill);
  634. return error;
  635. }
  636. return 0;
  637. }
  638. EXPORT_SYMBOL(rfkill_register);
  639. /**
  640. * rfkill_unregister - Unregister a rfkill structure.
  641. * @rfkill: rfkill structure to be unregistered
  642. *
  643. * This function should be called by the network driver during device
  644. * teardown to destroy rfkill structure. Note that rfkill_free() should
  645. * _not_ be called after rfkill_unregister().
  646. */
  647. void rfkill_unregister(struct rfkill *rfkill)
  648. {
  649. BUG_ON(!rfkill);
  650. device_del(&rfkill->dev);
  651. rfkill_remove_switch(rfkill);
  652. rfkill_led_trigger_unregister(rfkill);
  653. put_device(&rfkill->dev);
  654. }
  655. EXPORT_SYMBOL(rfkill_unregister);
  656. /**
  657. * rfkill_set_default - set initial value for a switch type
  658. * @type - the type of switch to set the default state of
  659. * @state - the new default state for that group of switches
  660. *
  661. * Sets the initial state rfkill should use for a given type.
  662. * The following initial states are allowed: RFKILL_STATE_SOFT_BLOCKED
  663. * and RFKILL_STATE_UNBLOCKED.
  664. *
  665. * This function is meant to be used by platform drivers for platforms
  666. * that can save switch state across power down/reboot.
  667. *
  668. * The default state for each switch type can be changed exactly once.
  669. * After a switch of that type is registered, the default state cannot
  670. * be changed anymore. This guards against multiple drivers it the
  671. * same platform trying to set the initial switch default state, which
  672. * is not allowed.
  673. *
  674. * Returns -EPERM if the state has already been set once or is in use,
  675. * so drivers likely want to either ignore or at most printk(KERN_NOTICE)
  676. * if this function returns -EPERM.
  677. *
  678. * Returns 0 if the new default state was set, or an error if it
  679. * could not be set.
  680. */
  681. int rfkill_set_default(enum rfkill_type type, enum rfkill_state state)
  682. {
  683. int error;
  684. if (WARN((type >= RFKILL_TYPE_MAX ||
  685. (state != RFKILL_STATE_SOFT_BLOCKED &&
  686. state != RFKILL_STATE_UNBLOCKED)),
  687. KERN_WARNING
  688. "rfkill: illegal state %d or type %d passed as "
  689. "parameter to rfkill_set_default\n", state, type))
  690. return -EINVAL;
  691. mutex_lock(&rfkill_global_mutex);
  692. if (!test_and_set_bit(type, rfkill_states_lockdflt)) {
  693. rfkill_global_states[type].default_state = state;
  694. rfkill_global_states[type].current_state = state;
  695. error = 0;
  696. } else
  697. error = -EPERM;
  698. mutex_unlock(&rfkill_global_mutex);
  699. return error;
  700. }
  701. EXPORT_SYMBOL_GPL(rfkill_set_default);
  702. /*
  703. * Rfkill module initialization/deinitialization.
  704. */
  705. static int __init rfkill_init(void)
  706. {
  707. int error;
  708. int i;
  709. /* RFKILL_STATE_HARD_BLOCKED is illegal here... */
  710. if (rfkill_default_state != RFKILL_STATE_SOFT_BLOCKED &&
  711. rfkill_default_state != RFKILL_STATE_UNBLOCKED)
  712. return -EINVAL;
  713. for (i = 0; i < RFKILL_TYPE_MAX; i++)
  714. rfkill_global_states[i].default_state = rfkill_default_state;
  715. error = class_register(&rfkill_class);
  716. if (error) {
  717. printk(KERN_ERR "rfkill: unable to register rfkill class\n");
  718. return error;
  719. }
  720. return 0;
  721. }
  722. static void __exit rfkill_exit(void)
  723. {
  724. class_unregister(&rfkill_class);
  725. }
  726. subsys_initcall(rfkill_init);
  727. module_exit(rfkill_exit);