lk/linux-kernel-test
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

rfkill: some minor kernel-doc changes for rfkill_toggle_radio

Browse Source 
Improve rfkill_toggle_radio's kernel-doc header a bit.

Signed-off-by: Henrique de Moraes Holschuh <hmh@hmh.eng.br>
Acked-by: Ivo van Doorn <IvDoorn@gmail.com>
Signed-off-by: John W. Linville <linville@tuxdriver.com>
This commit is contained in:
Henrique de Moraes Holschuh
2008-07-03 13:14:56 -03:00
committed by John W. Linville
parent e4abd4d49d
commit 0f687e9aeb
1 changed files with 7 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files

12
net/rfkill/rfkill.c
View File

@@ -130,17 +130,19 @@ static void update_rfkill_state(struct rfkill *rfkill)
/** /**
* rfkill_toggle_radio - wrapper for toggle_radio hook * rfkill_toggle_radio - wrapper for toggle_radio hook
* calls toggle_radio taking into account a lot of "small" *
* details.
* @rfkill: the rfkill struct to use * @rfkill: the rfkill struct to use
* @force: calls toggle_radio even if cache says it is not needed, * @force: calls toggle_radio even if cache says it is not needed,
* and also makes sure notifications of the state will be * and also makes sure notifications of the state will be
* sent even if it didn't change * sent even if it didn't change
* @state: the new state to call toggle_radio() with * @state: the new state to call toggle_radio() with
* *
* This wrappen protects and enforces the API for toggle_radio * Calls rfkill->toggle_radio, enforcing the API for toggle_radio
* calls. Note that @force cannot override a (possibly cached) * calls and handling all the red tape such as issuing notifications
* state of RFKILL_STATE_HARD_BLOCKED. Any device making use of * if the call is successful.
*
* Note that @force cannot override a (possibly cached) state of
* RFKILL_STATE_HARD_BLOCKED. Any device making use of
* RFKILL_STATE_HARD_BLOCKED implements either get_state() or * RFKILL_STATE_HARD_BLOCKED implements either get_state() or
* rfkill_force_state(), so the cache either is bypassed or valid. * rfkill_force_state(), so the cache either is bypassed or valid.
* *