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 #include "iwl-trans.h" 68 69 struct iwl_notif_wait_data { 70 struct list_head notif_waits; 71 spinlock_t notif_wait_lock; 72 wait_queue_head_t notif_waitq; 73 }; 74 75 /** 76 * struct iwl_notification_wait - notification wait entry 77 * @list: list head for global list 78 * @fn: function called with the notification 79 * @cmd: command ID 80 * 81 * This structure is not used directly, to wait for a 82 * notification declare it on the stack, and call 83 * iwlagn_init_notification_wait() with appropriate 84 * parameters. Then do whatever will cause the ucode 85 * to notify the driver, and to wait for that then 86 * call iwlagn_wait_notification(). 87 * 88 * Each notification is one-shot. If at some point we 89 * need to support multi-shot notifications (which 90 * can't be allocated on the stack) we need to modify 91 * the code for them. 92 */ 93 struct iwl_notification_wait { 94 struct list_head list; 95 96 void (*fn)(struct iwl_notif_wait_data *notif_data, 97 struct iwl_rx_packet *pkt, void *data); 98 void *fn_data; 99 100 u8 cmd; 101 bool triggered, aborted; 102 }; 103 104 105 /* caller functions */ 106 void iwl_notification_wait_init(struct iwl_notif_wait_data *notif_data); 107 void iwl_notification_wait_notify(struct iwl_notif_wait_data *notif_data, 108 struct iwl_rx_packet *pkt); 109 void iwl_abort_notification_waits(struct iwl_notif_wait_data *notif_data); 110 111 /* user functions */ 112 void __acquires(wait_entry) 113 iwl_init_notification_wait(struct iwl_notif_wait_data *notif_data, 114 struct iwl_notification_wait *wait_entry, 115 u8 cmd, 116 void (*fn)(struct iwl_notif_wait_data *notif_data, 117 struct iwl_rx_packet *pkt, void *data), 118 void *fn_data); 119 120 int __must_check __releases(wait_entry) 121 iwl_wait_notification(struct iwl_notif_wait_data *notif_data, 122 struct iwl_notification_wait *wait_entry, 123 unsigned long timeout); 124 125 void __releases(wait_entry) 126 iwl_remove_notification(struct iwl_notif_wait_data *notif_data, 127 struct iwl_notification_wait *wait_entry); 128 129 #endif /* __iwl_notif_wait_h__ */ 130