+/*
+ * Copyright (c) 2013 Qualcomm Atheros, Inc.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted (subject to the limitations in the
+ * disclaimer below) provided that the following conditions are met:
+ *
+ * * Redistributions of source code must retain the above copyright
+ * notice, this list of conditions and the following disclaimer.
+ *
+ * * Redistributions in binary form must reproduce the above copyright
+ * notice, this list of conditions and the following disclaimer in the
+ * documentation and/or other materials provided with the
+ * distribution.
+ *
+ * * Neither the name of Qualcomm Atheros nor the names of its
+ * contributors may be used to endorse or promote products derived
+ * from this software without specific prior written permission.
+ *
+ * NO EXPRESS OR IMPLIED LICENSES TO ANY PARTY'S PATENT RIGHTS ARE
+ * GRANTED BY THIS LICENSE. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT
+ * HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED
+ * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
+ * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
+ * BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
+ * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
+ * OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ * IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
/**
* @ingroup adf_os_public
* @file adf_os_defer.h
/**
* TODO This implements work queues (worker threads, kernel threads etc.).
- * Note that there is no cancel on a scheduled work. You cannot free a work
+ * Note that there is no cancel on a scheduled work. You cannot free a work
* item if its queued. You cannot know if a work item is queued or not unless
* its running, whence you know its not queued.
*
* so if, say, a module is asked to unload itself, how exactly will it make
- * sure that the work's not queued, for OS'es that dont provide such a
+ * sure that the work's not queued, for OS'es that dont provide such a
* mechanism??
*/
/**
* @brief Representation of a work queue.
- */
+ */
typedef __adf_os_work_t adf_os_work_t;
/**
* @brief Representation of a bottom half.
- */
+ */
typedef __adf_os_bh_t adf_os_bh_t;
/**
* @brief This initiallizes the Bottom half deferred handler
- *
+ *
* @param[in] hdl OS handle
* @param[in] bh bottom instance
* @param[in] func deferred function to run at bottom half interrupt
* context.
* @param[in] arg argument for the deferred function
*/
-static inline void
+static inline void
adf_os_init_bh(adf_os_handle_t hdl, adf_os_bh_t *bh,
adf_os_defer_fn_t func,void *arg)
{
/**
* @brief schedule a bottom half (DPC)
- *
+ *
* @param[in] hdl OS handle
* @param[in] bh bottom instance
*/
-static inline void
+static inline void
adf_os_sched_bh(adf_os_handle_t hdl, adf_os_bh_t *bh)
{
__adf_os_sched_bh(hdl, bh);
/**
* @brief disable the bh (synchronous)
- *
+ *
* @param[in] hdl OS handle
* @param[in] bh bottom instance
*/
-static inline void
+static inline void
adf_os_disable_bh(adf_os_handle_t hdl, adf_os_bh_t *bh)
{
__adf_os_disable_bh(hdl,bh);
/**
* @brief allocate a work/task queue, This runs in non-interrupt
* context, so can be preempted by H/W & S/W intr
- *
+ *
* @param[in] hdl OS handle
* @param[in] work work instance
* @param[in] func deferred function to run at bottom half non-interrupt
* context.
* @param[in] arg argument for the deferred function
*/
-static inline void
+static inline void
adf_os_init_work(adf_os_handle_t hdl, adf_os_work_t *work,
adf_os_defer_fn_t func, void *arg)
{
/**
* @brief Schedule a deferred task on non-interrupt context
- *
+ *
* @param[in] hdl OS handle
* @param[in] work work instance
*/
-static inline void
+static inline void
adf_os_sched_work(adf_os_handle_t hdl, adf_os_work_t *work)
{
__adf_os_sched_work(hdl, work);
*@param[in] hdl OS handle
*@param[in] work work instance
*/
-static inline void
-adf_os_disable_work(adf_os_handle_t hdl, adf_os_work_t *work)
+static inline void
+adf_os_disable_work(adf_os_handle_t hdl, adf_os_work_t *work)
{
__adf_os_disable_work(hdl, work);
}