mirror of
https://github.com/torvalds/linux.git
synced 2024-12-03 17:41:22 +00:00
3051946056
The opening comment mark '/**' is used for highlighting the beginning of kernel-doc comments. There are some files in drivers/net/wireless/rsi which follow this syntax in their file headers, i.e. start with '/**' like comments, which causes unexpected warnings from kernel-doc. E.g., running scripts/kernel-doc -none on drivers/net/wireless/rsi/rsi_coex.h causes this warning: "warning: wrong kernel-doc identifier on line: * Copyright (c) 2018 Redpine Signals Inc." Similarly for other files too. Provide a simple fix by replacing such occurrences with general comment format, i.e., "/*", to prevent kernel-doc from parsing it. Signed-off-by: Aditya Srivastava <yashsri421@gmail.com> Reviewed-by: Randy Dunlap <rdunlap@infradead.org> Signed-off-by: Kalle Valo <kvalo@codeaurora.org> Link: https://lore.kernel.org/r/20210315173259.8757-1-yashsri421@gmail.com
93 lines
2.9 KiB
C
93 lines
2.9 KiB
C
/*
|
|
* Copyright (c) 2014 Redpine Signals Inc.
|
|
*
|
|
* Permission to use, copy, modify, and/or distribute this software for any
|
|
* purpose with or without fee is hereby granted, provided that the above
|
|
* copyright notice and this permission notice appear in all copies.
|
|
*
|
|
* THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
|
|
* WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
|
|
* MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
|
|
* ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
|
|
* WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
|
|
* ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
|
|
* OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
|
*/
|
|
|
|
#ifndef __RSI_COMMON_H__
|
|
#define __RSI_COMMON_H__
|
|
|
|
#include <linux/kthread.h>
|
|
|
|
#define EVENT_WAIT_FOREVER 0
|
|
#define FIRMWARE_RSI9113 "rs9113_wlan_qspi.rps"
|
|
#define QUEUE_NOT_FULL 1
|
|
#define QUEUE_FULL 0
|
|
|
|
static inline int rsi_init_event(struct rsi_event *pevent)
|
|
{
|
|
atomic_set(&pevent->event_condition, 1);
|
|
init_waitqueue_head(&pevent->event_queue);
|
|
return 0;
|
|
}
|
|
|
|
static inline int rsi_wait_event(struct rsi_event *event, u32 timeout)
|
|
{
|
|
int status = 0;
|
|
|
|
if (!timeout)
|
|
status = wait_event_interruptible(event->event_queue,
|
|
(atomic_read(&event->event_condition) == 0));
|
|
else
|
|
status = wait_event_interruptible_timeout(event->event_queue,
|
|
(atomic_read(&event->event_condition) == 0),
|
|
timeout);
|
|
return status;
|
|
}
|
|
|
|
static inline void rsi_set_event(struct rsi_event *event)
|
|
{
|
|
atomic_set(&event->event_condition, 0);
|
|
wake_up_interruptible(&event->event_queue);
|
|
}
|
|
|
|
static inline void rsi_reset_event(struct rsi_event *event)
|
|
{
|
|
atomic_set(&event->event_condition, 1);
|
|
}
|
|
|
|
static inline int rsi_create_kthread(struct rsi_common *common,
|
|
struct rsi_thread *thread,
|
|
void *func_ptr,
|
|
u8 *name)
|
|
{
|
|
init_completion(&thread->completion);
|
|
atomic_set(&thread->thread_done, 0);
|
|
thread->task = kthread_run(func_ptr, common, "%s", name);
|
|
if (IS_ERR(thread->task))
|
|
return (int)PTR_ERR(thread->task);
|
|
|
|
return 0;
|
|
}
|
|
|
|
static inline int rsi_kill_thread(struct rsi_thread *handle)
|
|
{
|
|
atomic_inc(&handle->thread_done);
|
|
rsi_set_event(&handle->event);
|
|
|
|
return kthread_stop(handle->task);
|
|
}
|
|
|
|
void rsi_mac80211_detach(struct rsi_hw *hw);
|
|
u16 rsi_get_connected_channel(struct ieee80211_vif *vif);
|
|
struct rsi_hw *rsi_91x_init(u16 oper_mode);
|
|
void rsi_91x_deinit(struct rsi_hw *adapter);
|
|
int rsi_read_pkt(struct rsi_common *common, u8 *rx_pkt, s32 rcv_pkt_len);
|
|
#ifdef CONFIG_PM
|
|
int rsi_config_wowlan(struct rsi_hw *adapter, struct cfg80211_wowlan *wowlan);
|
|
#endif
|
|
struct rsi_sta *rsi_find_sta(struct rsi_common *common, u8 *mac_addr);
|
|
struct ieee80211_vif *rsi_get_vif(struct rsi_hw *adapter, u8 *mac);
|
|
void rsi_roc_timeout(struct timer_list *t);
|
|
#endif
|