diff options
author | Johannes Berg <johannes.berg@intel.com> | 2012-03-06 16:30:58 -0500 |
---|---|---|
committer | John W. Linville <linville@tuxdriver.com> | 2012-03-07 13:56:32 -0500 |
commit | 4bd14dd5f77bbe3c51f50f4e86d3b8960e6a518c (patch) | |
tree | 0dbf32e6fbf047035389a09b7b1124ca769a5551 /drivers/net/wireless/iwlwifi/iwl-notif-wait.h | |
parent | f47208934b2aba432722baeb86a72fcbfd26b593 (diff) |
iwlwifi: abstract out notification wait support
This will be sharable, but needs to live in the
op_mode as it is dependent on command processing.
Make a library out of the notification wait code.
Since I wrote all of the code originally and only
Intel employees changed it, we can also relicense
it to dual BSD/GPL.
Signed-off-by: Johannes Berg <johannes.berg@intel.com>
Signed-off-by: Wey-Yi Guy <wey-yi.w.guy@intel.com>
Signed-off-by: John W. Linville <linville@tuxdriver.com>
Diffstat (limited to 'drivers/net/wireless/iwlwifi/iwl-notif-wait.h')
-rw-r--r-- | drivers/net/wireless/iwlwifi/iwl-notif-wait.h | 130 |
1 files changed, 130 insertions, 0 deletions
diff --git a/drivers/net/wireless/iwlwifi/iwl-notif-wait.h b/drivers/net/wireless/iwlwifi/iwl-notif-wait.h new file mode 100644 index 000000000000..419f1ad65441 --- /dev/null +++ b/drivers/net/wireless/iwlwifi/iwl-notif-wait.h | |||
@@ -0,0 +1,130 @@ | |||
1 | /****************************************************************************** | ||
2 | * | ||
3 | * This file is provided under a dual BSD/GPLv2 license. When using or | ||
4 | * redistributing this file, you may do so under either license. | ||
5 | * | ||
6 | * GPL LICENSE SUMMARY | ||
7 | * | ||
8 | * Copyright(c) 2007 - 2012 Intel Corporation. All rights reserved. | ||
9 | * | ||
10 | * This program is free software; you can redistribute it and/or modify | ||
11 | * it under the terms of version 2 of the GNU General Public License as | ||
12 | * published by the Free Software Foundation. | ||
13 | * | ||
14 | * This program is distributed in the hope that it will be useful, but | ||
15 | * WITHOUT ANY WARRANTY; without even the implied warranty of | ||
16 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | ||
17 | * General Public License for more details. | ||
18 | * | ||
19 | * You should have received a copy of the GNU General Public License | ||
20 | * along with this program; if not, write to the Free Software | ||
21 | * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110, | ||
22 | * USA | ||
23 | * | ||
24 | * The full GNU General Public License is included in this distribution | ||
25 | * in the file called LICENSE.GPL. | ||
26 | * | ||
27 | * Contact Information: | ||
28 | * Intel Linux Wireless <ilw@linux.intel.com> | ||
29 | * Intel Corporation, 5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497 | ||
30 | * | ||
31 | * BSD LICENSE | ||
32 | * | ||
33 | * Copyright(c) 2005 - 2012 Intel Corporation. All rights reserved. | ||
34 | * All rights reserved. | ||
35 | * | ||
36 | * Redistribution and use in source and binary forms, with or without | ||
37 | * modification, are permitted provided that the following conditions | ||
38 | * are met: | ||
39 | * | ||
40 | * * Redistributions of source code must retain the above copyright | ||
41 | * notice, this list of conditions and the following disclaimer. | ||
42 | * * Redistributions in binary form must reproduce the above copyright | ||
43 | * notice, this list of conditions and the following disclaimer in | ||
44 | * distribution. | ||
45 | * * Neither the name Intel Corporation nor the names of its | ||
46 | * contributors may be used to endorse or promote products derived | ||
47 | * from this software without specific prior written permission. | ||
48 | * | ||
49 | * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS | ||
50 | * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT | ||
51 | * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR | ||
52 | * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT | ||
53 | * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, | ||
54 | * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT | ||
55 | * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, | ||
56 | * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY | ||
57 | * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT | ||
58 | * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE | ||
59 | * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | ||
60 | * | ||
61 | *****************************************************************************/ | ||
62 | #ifndef __iwl_notif_wait_h__ | ||
63 | #define __iwl_notif_wait_h__ | ||
64 | |||
65 | #include <linux/wait.h> | ||
66 | |||
67 | /* TODO: remove later */ | ||
68 | #include "iwl-commands.h" | ||
69 | |||
70 | struct iwl_notif_wait_data { | ||
71 | struct list_head notif_waits; | ||
72 | spinlock_t notif_wait_lock; | ||
73 | wait_queue_head_t notif_waitq; | ||
74 | }; | ||
75 | |||
76 | /** | ||
77 | * struct iwl_notification_wait - notification wait entry | ||
78 | * @list: list head for global list | ||
79 | * @fn: function called with the notification | ||
80 | * @cmd: command ID | ||
81 | * | ||
82 | * This structure is not used directly, to wait for a | ||
83 | * notification declare it on the stack, and call | ||
84 | * iwlagn_init_notification_wait() with appropriate | ||
85 | * parameters. Then do whatever will cause the ucode | ||
86 | * to notify the driver, and to wait for that then | ||
87 | * call iwlagn_wait_notification(). | ||
88 | * | ||
89 | * Each notification is one-shot. If at some point we | ||
90 | * need to support multi-shot notifications (which | ||
91 | * can't be allocated on the stack) we need to modify | ||
92 | * the code for them. | ||
93 | */ | ||
94 | struct iwl_notification_wait { | ||
95 | struct list_head list; | ||
96 | |||
97 | void (*fn)(struct iwl_notif_wait_data *notif_data, | ||
98 | struct iwl_rx_packet *pkt, void *data); | ||
99 | void *fn_data; | ||
100 | |||
101 | u8 cmd; | ||
102 | bool triggered, aborted; | ||
103 | }; | ||
104 | |||
105 | |||
106 | /* caller functions */ | ||
107 | void iwl_notification_wait_init(struct iwl_notif_wait_data *notif_data); | ||
108 | void iwl_notification_wait_notify(struct iwl_notif_wait_data *notif_data, | ||
109 | struct iwl_rx_packet *pkt); | ||
110 | void iwl_abort_notification_waits(struct iwl_notif_wait_data *notif_data); | ||
111 | |||
112 | /* user functions */ | ||
113 | void __acquires(wait_entry) | ||
114 | iwl_init_notification_wait(struct iwl_notif_wait_data *notif_data, | ||
115 | struct iwl_notification_wait *wait_entry, | ||
116 | u8 cmd, | ||
117 | void (*fn)(struct iwl_notif_wait_data *notif_data, | ||
118 | struct iwl_rx_packet *pkt, void *data), | ||
119 | void *fn_data); | ||
120 | |||
121 | int __must_check __releases(wait_entry) | ||
122 | iwl_wait_notification(struct iwl_notif_wait_data *notif_data, | ||
123 | struct iwl_notification_wait *wait_entry, | ||
124 | unsigned long timeout); | ||
125 | |||
126 | void __releases(wait_entry) | ||
127 | iwl_remove_notification(struct iwl_notif_wait_data *notif_data, | ||
128 | struct iwl_notification_wait *wait_entry); | ||
129 | |||
130 | #endif /* __iwl_notif_wait_h__ */ | ||